Versions Compared

Old Version 4

changes.mady.by.user user-2e16f

Saved on

compared with

New Version 5

changes.mady.by.user user-2e16f

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

If you select this option in the Setup Tab of the LCC, the behaviour of the whole deployment fundamentally changes. Your software is no longer deployed locally, on your device, but on the NUCs (HLCs) which are used in the Lab. Your system must be set up similarly to the main Lab PC for this option to actually work. 

Requirements

Use the main PC

The main Lab PC (IP: 192.168.1.249) must be running (with an Apache Server), ideally before the NUCs are turned on.

Setting up the NUCs correctly

The NUCs need to be set up properly. They also need to have an automatically starting task running, which looks for new versions of the required files. This crontab task relies on lab_autostart.bash. 

Info
titleInfo on lab_autostart.bash

This file can also be found in the software repository (./high_level_controller/autostart). It is the only file that currently is not automatically updated on the NUC. Thus, if you change it, you need to re-upload it on the devices for the guest user. The path is described here.

The script is responsible for setting up the environment on the NUCs (e.g. downloading current versions of the cpm library, middleware etc.) so that programs can be deployed on the machines similarly to local deployment.

Provide all required packages

You need to do this before turning the NUCs on.

...

Info

The HLCs use a startup script that takes the cpm library, Middleware etc. from an Apache server located on the Lab's main PC. The according files are updated every single time that these components are built. If you changed them during the lab run / if they are missing, please rebuild them and restart the NUCs/HLCs, so that they get the new software.

This decision was made to reduce upload traffic when files are uploaded to the HLCs during a lab run.

Make sure that all your files are uploaded correctly

Your folder structure must match the recommended folder structure (usage of ~/dev/...) for both the cpm library and the software repository. If your script/program relies on this data, then you should always refer to other programs using paths relative from ~ (so do not use /home/username explicitly). Cpm library and middleware can be found in the same folders on the NUCs. Required environment variables, e.g. for DDS, are set by default, so you do not need to take care of that.

...

Info
titleMatlab example of using the init-script:
clc
script_directoy = fileparts([mfilename('fullpath') '.m']);
cd(script_directoy)

% Initialize data readers/writers...
init_script_path = fullfile('../', '/init_script.m');
assert(isfile(init_script_path), 'Missing file "%s".', init_script_path);
addpath(fileparts(init_script_path));
[matlabParticipant, stateReader, trajectoryWriter, systemTriggerReader, readyStatusWriter, trigger_stop] = init_script(matlabDomainID);
cd(script_directoy)

General information

Mapping of vehicle IDs

Vehicle IDs are matched to available NUC IPs in an ascending order (IP ...211 → ID 1, IP ...215 → ID 4), depending on the vehicle IDs you have selected.

You cannot simulate more vehicles remotely than NUCs are available - each NUC is always responsible for one vehilce only. Any further vehicle is simulated on your local device.

Using IDL-Datatypes and the cpm library

The location of the cpm library is always set using LD_LIBRARY_PATH in the local terminal - you do not need to take care of this in your program, as long as you have linked the library properly in your build script.

Integrated error checking

IDL-Datatype for error checking

The following data type is used to check for NUC-crashes.

...

  • source_id: This field can be used to obtain the ID of the NUC that sent the message
  • script_running: True if a tmux session for the script is currently running. These sessions are started on the NUC when Deploy Remote is used, after the upload has finished. Usually, when a program crashes, the tmux session is stopped as well, thus this value can be used as an indicator to check if the script crashed.
  • middleware_running: True if a tmux session for the middleware is running. Similar to script_running.

Online-indicators for NUCs

The UI indicates how many NUCs are online. The UI shows you how many NUCs are currently online (matching might take up to a minute after the NUCs have been booted and your program has started.) 

...

  • You are using the wrong domain ID (DDS) for the LCC. If LCC and NUCs are not within the same DDS domain, they cannot discover each other. Please check which ID you need to use.
  • Packages are missing on the NUCs. In this case, upload packages are missing on the main PC or the NUCs have not been set up correctly (e.g. the autostart task, see requirements)
  • The NUCs or your PC are not connected to the same network
  • You are not using the main Lab PC (which is recommended for remote deployment)
  • The NUCs crashed

Crash checks for your programs

As soon as you actually deploy your programs, and after the scripts have been uploaded, the LCC also starts checking if their corresponding tmux sessions (middleware and script) are still running.

...