====== Neptus tips and tricks ======
===== Compiling Neptus in *buntu linux systems =====
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

===== Making a new vehicle type visible to Neptus Console =====
  * 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 DUNE parameters available to Neptus, so they can be changed while the vehicle is active =====
  * 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.
  
===== Add support for custom IMC messages to Neptus =====
TODO