Neptus tips and tricks

The Neptus Wiki describes how to do this, but it does not work for *buntu linux systems. The problem is that Neptus wants Java runtime 8, while *buntu automatically chooses Java runtime 11.

• Install requirements

sudo apt-get install git openjdk-8-jdk ant

• Clone Neptus github repository

git clone​ ​https://github.com/LSTS/neptus.git​ $lststools

• Set JAVA_HOME by opening /etc/bash.bashrc and adding:

export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64

• Set default java to use openjdk8:

sudo update-java-alternatives --set java-1.8.0-openjdk-amd64

• Compile Neptus

cd $lststools/neptus && ant

• Open Neptus

cd $lststools/neptus && ./neptus.sh auv

• Alternative for Ubuntu 20.04 (MRA not properly working with previous method): Use Oracle Java

sudo add-apt-repository ppa:ts.sch.gr/ppa
sudo apt-get update
sudo apt-get install oracle-java8-installer

• In the Neptus folder, go to vehicles-defs/
• Duplicate one of .nvcl files and edit it to fit the new vehicle.
• The IMC id <imc-id>2c:60</imc-id> must be made to correspond with the vehicles ID, configured in DUNE ini-file section [IMC Addresses]. If this is not done correctly, the vehicle will not appear in console.
• Make a new console file to add in the .nvcl file This can also be done by opening one of the included consoles and using save as to dublicate. The important part here is to set main vehicle to your new vehicle.

• Make parameter file from DUNE

./dune -c inifile -p Profile -X location_for_parameterfile

• Example:

./dune -c otter/ntnu-otter-02 -p Hardware -X .

This results in a file ntnu-otter-02.en_US.xml being created in the folder dune was run from (or in location_for_parameterfile). This XML is then moved to neptus/conf/params. After running neptus, ctrl+1 and “Access Developer Parameters”, the parameters are now available for editing while running.

TODO