Differences

This shows you the differences between two versions of the page.

--- neptus_tips_and_tricks [2019/10/07 10:29] – created nikolal
+++ neptus_tips_and_tricks [2022/09/19 11:34] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== 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
+  * Duplicate one of ''%%.nvcl%%'' files and edit it to fit the new vehicle.
-  * Most importantly, make a new console file to add in the ''%%.nvcl%%'' file
+  * 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 DUNE parameters available to Neptus, so they can be changed while on the fly =====
+  * 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
@@ Line 12: / Line 45: @@
   * Example:
-  ./dune -c otter/basic -p Hardware -X .
+  ./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