Updating from release 1

This page includes all of the steps necessary to update to the second software release. 
Updates in the virtual machine
Pull changes in the ros_adapter
The ros_adapter node now also publishes position, orientation and velocity data on the /nav/pose and /nav/twist messages. To pull the changes to the node, open a terminal window in your virtual machine and enter the following. 
cd ~/catkin_ws/src/ros_adapter/
git reset --hard
git pull
The IP configuration has been moved to a config file since the previous update. First, open the network settings to find the IPv4 IP address used by your VM. Second, open the file catkin_ws/src/ros_adapter/config/server.yaml. Change the IP address to match the IP used by your VM. 
Clone the ros_client node
The new ros_client node is published to the /force_control topic and expects Generalized force messages which are applied to the vessel in Gemini. Open a terminal window in your virtual machine, and enter the following to clone the node into your catkin workspace.
cd ~/catkin_ws/src/
git clone https://github.com/Njord-The-Autonomous-Ship-Challenge/ros_clients.git
The config file in /catkin_ws/src/ros_clients/config must now be configured with the IP address of the Windows operating system (not the virtual machine). This can be found by typing 'ipconfig' in a Windows terminal. The IPv4 Address will typically begin with 192.168.
Before running the nodes again, remember to build using catkin_make;
cd ~/catkin_ws/
catkin_make
Updates in Gemini-Unity
NOTE: The 'git reset --hard' command will permanently remove any local changes made in the Gemini directory. It is necessary as some of the core code has been restructured. If you have any important local changes, making a backup is recommended before proceeding. Any system specific configurations, such as for some non-English Windows operating systems, must be reapplied.
In a windows terminal, enter the following:
cd Gemini
git reset --hard
git pull
Reconfigure sensor streaming IP address
Navigate to \Gemini\Gemini-Unity\Assets\Gemini\Scripts\EMRSensors\Core\Sensor.cs and change the IP on line 18 to the IPv4 address of your virtual machine.
Import new Unity scene
Download this Unity package which contains a slightly modified preconfigured scene. Boot up the Unity editor and import the package ('Assets -> Import package').
If the 'NjordVessel' object shows a 'Missing Prefab' error when opening the new scene, delete the old vessel from the 'Hierarchy' tab on the left hand side, and drag in the new model found in the NjordVessel folder in the bottom menu. 
Note: Ensure that the vessel object (in the Hierarchy tab) is named 'NjordVessel', not 'NjordVessel(1)'. The force controller is configured to correspond with the asset's name.
Configure the force controller IP address
In the new Unity scene, select the 'NjordVessel' object in the left-hand menu. In the inspector on the right-hand side, one of the of components are called 'Force Control Manager'. Open the dropdown menu and change the Host IP address to your Windows IPv4 address (the same as you specified in the ros_clients config file).

Installation guide - Previous

Running on 2 computers

Next - Usage

Launching the platform

Last modified 6mo ago

Copy link

On this page

Updates in the virtual machine

Updates in Gemini-Unity