8000 Improved the documentation about the Brick installation process · ev3dev-lang-java/docs@058ac46 · GitHub
[go: up one dir, main page]

Skip to content

Commit 058ac46

Browse files
committed
Improved the documentation about the Brick installation process
1 parent da67f2b commit 058ac46

File tree

1 file changed

+73
-13
lines changed

1 file changed

+73
-13
lines changed

src/main/asciidoc/getting_started/brick.adoc

Lines changed: 73 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -100,7 +100,7 @@ Now, you have Linux in your Brick!
100100
## Java Virtual Machine
101101

102102
Java programs need a JVM (Java Virtual Machine) installed in the Brick.
103-
Depending of the Hardware and the Debian version, you will have different options.
103+
Depending of the Hardware and the Debian version, you will have different options to install it.
104104

105105
### EV3 Brick
106106

@@ -111,22 +111,38 @@ Available JVM:
111111
- Oracle JRE 8 for Debian Jessie
112112
- Open JDK 10 for Debian Stretch
113113
114+
Using this project, the developer has 3 alternatives to install a JVM:
115+
116+
- Manual
117+
- Using the project Installer
118+
- Using Gradle tasks from Template Project which interacts with Installer
119+
120+
But not all alternatives are enabled for all cases.
121+
114122
#### Debian Jessie
115123

116-
##### Manual way
124+
##### Manual
117125

118-
To install Oracle JRE 8 in the brick you need to download from [here](http://www.oracle.com/technetwork/java/embedded/downloads/javase/javaseemeddedev3-1982511.html)
126+
On Debian Jessie + EV3 Brick the JVM available to use is Oracle JRE 8.
127+
To install this JVM in the Brick you need to download from [here](http://www.oracle.com/technetwork/java/embedded/downloads/javase/javaseemeddedev3-1982511.html)
119128
and later, copy the file `ejdk-8-fcs-b132-linux-arm-sflt-03_mar_2014.tar.gz` to your brick using the command `scp`.
120129

121-
Example:
130+
*Example:*
122131

123132
```
124133
scp "./ejdk-8-fcs-b132-linux-arm-sflt-03_mar_2014.tar.gz" "robot@192.168.1.85:/home/robot"
125134
```
126135

127-
Once, you have the file on the brick, you can continue the Java installation with the installer or do yourself manually.
136+
Once, you have the file on the Brick, you can continue the Java installation with the installer or do yourself manually.
137+
138+
If you continue installing the JVM in a manual way, you will have to execute the following statements in a Terminal:
128139

129-
https://github.com/ev3dev-lang-java/installer/master
140+
```
141+
sudo tar -zxvf "/home/robot/ejdk-8-fcs-b132-linux-arm-sflt-03_mar_2014.tar.gz" -C /opt
142+
sudo update-alternatives --install /usr/bin/java java /opt/ejdk1.8.0/linux_arm_sflt/jre/bin/java 8
143+
```
144+
145+
Now, you have Java on your EV3 Brick
130146

131147
##### Installer
132148

@@ -140,20 +156,60 @@ sudo ./installer.sh help
140156
sudo ./installer.sh java
141157
```
142158

143-
#### Manual way
159+
##### Gradle Template project
160+
161+
This option is not available for Debian Jessie
162+
163+
#### Debian Stretch
164+
165+
In Debian Jessie, we could build OpenJDK 10 for EV3 so the Java installation experience is improved so much.
166+
167+
##### Manual way
144168

145169
```
146-
sudo tar -zxvf "/home/robot/ejdk-8-fcs-b132-linux-arm-sflt-03_mar_2014.tar.gz" -C /opt
147-
sudo update-alternatives --install /usr/bin/java java /opt/ejdk1.8.0/linux_arm_sflt/jre/bin/java 1
170+
wget -N https://github.com/ev3dev-lang-java/openjdk-ev3/releases/download/v0.5.0/jri10-ev3.tar.gz
171+
sudo tar -zxvf jri10-ev3.tar.gz -C /opt
172+
mv /opt/jri-ev3/ /opt/jri-10-build-050
173+
update-alternatives --install /usr/bin/java java /opt/jri-10-build-050/bin/java 10
148174
```
149175

150-
Now, you have Java on your EV3 Brick
176+
##### Installer
177+
178+
```
179+
cd /home/robot
180+
mkdir installer
181+
cd installer
182+
wget -N https://raw.githubusercontent.com/ev3dev-lang-java/installer/master/installer.sh
183+
chmod +x installer.sh
184+
sudo ./installer.sh help
185+
sudo ./installer.sh java
186+
```
187+
188+
##### Gradle Template project
189+
190+
Execute the Tasks:
191+
192+
- getInstaller
193+
- installJava
194+
- javaVersion
151195
152196
### BrickPi 3 / BrickPi+ / PiStorms
153197

154-
Using the installer, it is possible to automate everything:
198+
Bricks using Raspberry Pi hardware has more CPU/Memory capacity and it is possible to install from Debian Packages.
199+
200+
At the moment, the unique support is on Debian Jessie.
201+
202+
#### Debian Jessie
203+
204+
##### Manual
155205

156-
https://github.com/ev3dev-lang-java/installer
206+
apt-key adv --recv-key --keyserver keyserver.ubuntu.com EEA14886
207+
echo "deb http://ppa.launchpad.net/webupd8team/java/ubuntu trusty main" | sudo tee -a /etc/apt/sources.list
208+
echo "deb-src http://ppa.launchpad.net/webupd8team/java/ubuntu trusty main" | sudo tee -a /etc/apt/sources.list
209+
sudo apt-get update
210+
sudo apt-get install oracle-java8-installer
211+
212+
##### Installer
157213

158214
```
159215
cd /home/robot
@@ -165,6 +221,10 @@ sudo ./installer.sh help
165221
sudo ./installer.sh
166222
```
167223

224+
##### Gradle Template project
225+
226+
This option is not available yet.
227+
168228
### Test your installation
169229

170230
Once you have your bricks with the JVM, test the installation is easy.
@@ -174,7 +234,7 @@ With the remote connection opened type:
174234
java -version
175235
```
176236

177-
Now, your Brick is ready to receive your Java programs.
237+
Now, your Brick is ready to run your Java programs.
178238

179239
++++
180240

0 commit comments

Comments
 (0)
0