This is an old revision of the document!
Setting Up a Raspberry Pi (RPi) for MIX
These steps assume you have installed MIStudio on your development system already. This can be a trial or non-trial installation.
In the step below “Setup the MIX Runtime Directory” you will be transferring all the files from this installation's MIStudioSuite/MIX directory to the “mixruntime” directory on the pi.
Make Sure JDK 8 is Installed
ssh into your Raspberry Pi system and check the java version:
java -version
you should see that it runs by printing a version 1.8.xxxxxx
openjdk version "1.8.0_222" ....
if you do not see that it is installed, or if it is not version 8, you will need to install JDK 8. You can install openjdk or corretto, or other other jdk builds as long as they are compatible with JDK 8.
Install the Serial Port Drivers
The serial port library will need to be installed. See http://angryelectron.com/rxtx-on-raspbian/ for more details.
sudo apt-get install librxtx-java
this installs so's into /usr/lib/jni and RXTX jar into /usr/share/java, which is the expected location for the MIX software.
Setup the MIX Runtime Directory
The MIX runtime should run as a dedicated “mix” user with a secure password, but you can test MIX using the default user for your system, for example, for user “pi”.
To test as user “pi” make a directory called “mixruntime” in the pi home directory.
ftp the contents of the MIX directory on your development system to this “mixruntime” directory on the pi.
Setup MIX
The mixruntime directory on the pi should have a subdirctory called “scripts”. Copy the runmix.sh file from the scripts directory into the main mixruntime directory. Likewise, there is a log4j directory. Copy the log4j.console.xml file from the log4j directory into the main mixruntime directory.
cp ./scripts/runmix.sh . cp ./log4j/log4j.console.xml .
Make the file “runmix.sh” executable.
chmod 711 runmix.sh
Run MIX
In the console window use runmix.sh to start MIX.
If MIX starts up correctly it will be waiting for a deployment connection from MIStudio, or for a web browser connection.
If you see errors, you can use the error information as a guild to understanding the problem.
If you are not deploying trial builds from MIStudio, you will see a pre-license key the first time you run MIX with a project. To license MIX (for non-trial deployments), follow the instructions Runtime Setup