Raspberry Pi IDE Java Development
The Raspberry Pi is an
incredible device for building embedded
Java
applications but, despite being able to run an IDE on the Pi it really
pushes things to the limit. It's much better to use a PC or
laptop to develop the code and then deploy and test on the Pi.
What I thought I'd do in this blog entry was to run through the steps
necessary to set up NetBeans on a
PC for Java code development, with automatic deployment to the
Raspberry Pi as part of the build process.
I will assume that your starting point is a Raspberry Pi with an SD
card that has one of the latest Raspbian
images on it. This is good because this now includes the JDK 7 as
part of the distro, so no need to download and install a separate
JDK. I will also assume that you have installed the JDK and
NetBeans on your PC. These can be downloaded here.
There are numerous approaches you can take to this including mounting
the file system from the Raspberry Pi remotely on your development
machine. I tried this and I found that NetBeans got rather upset
if the file system disappeared either through network interruption or
the Raspberry Pi being turned off. The following method uses
copying over SSH, which will fail more gracefully if the Pi is not
responding.
Step 1: Enable SSH on the Raspberry Pi
To run the Java applications you create you will need to start Java on
the Raspberry Pi with the appropriate class name, classpath and
parameters. For non-JavaFX applications you can either do this
from the Raspberry Pi desktop or, if you do not have a monitor
connected through a remote command line. To execute the remote
command line you need to enable SSH (a secure shell login over the
network) and connect using an application like PuTTY.
You can enable SSH when you first boot the Raspberry Pi, as the
raspi-config program runs automatically. You can also run it at
any time afterwards by running the command: sudo
raspi-config
This will bring up a menu of options. Select '8 Advanced Options'
and on the next screen select 'A$ SSH'. Select 'Enable' and the
task is complete.
Step 2: Configure Raspberry Pi Networking
By default, the Raspbian distribution configures the ethernet
connection to use DHCP rather than a static IP address. You can
continue to use DHCP if you want, but to avoid having to potentially
change settings whenever you reboot the Pi using a static IP address is
simpler.
To configure this on the Pi you need to edit the /etc/network/interfaces
file. You will need to do this as root using the sudo command, so
something like sudo
vi /etc/network/interfaces. In this file you will see this
line: iface eth0
inet dhcp
This needs to be changed to the following: iface eth0
inet static
address 10.0.0.2
gateway 10.0.0.254
netmask 255.255.255.0
You will need to change the values in red to an appropriate IP address
and to match the address of your gateway.
Step 3: Create a Public-Private Key Pair On Your Development Machine
How you do this will depend on which Operating system you are using:
Mac OSX or Linux
Run the command: ssh-keygen -t
rsa
Press ENTER/RETURN to accept the default destination for saving the
key. We do not need a passphrase so simply press ENTER/RETURN for
an empty one and once more to confirm.
The key will be created in the file .ssh/id_rsa.pub
in your home directory.
Display the contents of this file using the cat command: cat
~/.ssh/id_rsa.pub
Open a window, SSH to the Raspberry Pi and login. Change
directory to .ssh
and edit the authorized_keys
file (don't worry if the file does not exist).
Copy and
paste the
contents of the id_rsa.pub
file to the authorized_keys
file and save it.
Windows
Since Windows is not a UNIX derivative operating system it does not
include the necessary key generating software by default. To
generate the key I used puttygen.exe
which is available from the same site that provides the PuTTY
application, here.
Download this and run it on your Windows machine. Follow the
instructions to generate a key. I remove the key comment, but you
can leave that if you want.
Click "Save private key", confirm that you don't want to use a
passphrase and select a filename and location for the key.
Copy the public key from the part of the window marked, "Public key for
pasting into OpenSSH authorized_keys file". Use PuTTY to connect
to the Raspberry Pi and login. Change directory to .ssh and
edit the authorized_keys
file (don't worry if this does not exist).
Paste the key
information at the end of this file and save it.
Logout and then start PuTTY again. This time we need to create a
saved session using the private key. Type in the IP address of
the Raspberry Pi in the "Hostname (or IP address)" field and expand
"SSH" under the "Connection" category. Select "Auth" (see the
screen shot below).
Click the "Browse" button under "Private key file for authentication"
and select the file you saved from puttygen.
Go back to the "Session" category and enter a short name in the saved
sessions field, as shown below. Click "Save" to save the session.
Step 4: Test The Configuration
You should now have the ability to use scp
(Mac/Linux) or pscp.exe
(Windows) to
copy files from your development machine to the Raspberry
Pi without needing to authenticate by typing in a password (so we can
automate the process in NetBeans). It's a good idea to test this
using something like: scp /tmp/foo
[email protected]:/tmp
on Linux or Mac or pscp.exe foo
pi@raspi:/tmp
on Windows (Note that we use the saved configuration name instead of
the IP address or hostname so the public key is picked up). pscp.exe is another tool available from the creators of PuTTY.
Step 5: Configure the NetBeans Build Script
Start NetBeans and create a new project (or open an existing one that
you want to deploy automatically to the Raspberry Pi).
Select the Files tab in the explorer window and expand your
project. You will see a build.xml
file. Double click this
to edit it.
This file will mostly be comments. At the end (but within the </project>
tag) add the XML for <target
name="-post-jar">, shown below
Here's the code again in case you want to use cut-and-paste: <target name="-post-jar">
<echo level="info" message="Copying dist
directory to remote Pi"/>
<exec executable="scp" dir="${basedir}">
<arg line="-r"/>
<arg value="dist"/>
<arg
value="
[email protected]:NetBeans/CopyTest"/>
</exec>
</target>
For Windows it will be slightly different: <target name="-post-jar">
<echo level="info" message="Copying dist
directory to remote Pi"/>
<exec executable="C:\pi\putty\pscp.exe" dir="${basedir}">
<arg line="-r"/>
<arg value="dist"/>
<arg
value="pi@raspi:NetBeans/CopyTest"/>
</exec>
</target>
You will also need to ensure that pscp.exe is
in your PATH
(or specify
a fully qualified pathname).
From now on when you clean and build the project the dist
directory will automatically be copied to the Raspberry Pi ready for
testing.
