|
|
# FlockLab How-To's
|
|
|
|
|
|
<br />
|
|
|
|
|
|
## How to assign node IDs
|
|
|
|
|
|
Chances are that you need a unique node ID for each target device. One way to get such an ID is by defining the symbol `FLOCKLAB_NODE_ID` in your code:
|
|
|
```
|
|
|
// must be global
|
|
|
uint16_t FLOCKLAB_NODE_ID = 0xbeef; // any value is ok, will be overwritten by FlockLab
|
|
|
volatile uint16_t node_id; // must be volatile
|
|
|
|
|
|
// somewhere in the code
|
|
|
node_id = FLOCKLAB_NODE_ID;
|
|
|
```
|
|
|
FlockLab will then automatically change (by binary patching) this value to the target ID (if specified, otherwise the observer ID is used) before uploading the image to the targets .
|
|
|
Note that some compilers might still remove the symbol `FLOCKLAB_NODE_ID`. To make sure it still exists in the final binary, you can use `objdump` to display the symbol table:
|
|
|
```
|
|
|
objdump -t [elf_file] | grep FLOCKLAB
|
|
|
```
|
|
|
If you want to assign a specific node ID to each target, you can do this by using the `targetIds` field in the [XML configuration file](Man/XmlConfig#target-configuration).
|
|
|
Note that assigning node IDs is only supported if you submit your target images in the file format ELF. For Intel hex files, binary patching is currently not supported.
|
|
|
|
|
|
<br />
|
|
|
|
|
|
|
|
|
## How to embed target image files into the XML config file
|
|
|
|
|
|
Before embedding the target image into the XML file, it must be encoded in base64 format. There are several tools available to do this. If you work on a Linux machine, you can use [this script](https://gitlab.ethz.ch/tec/public/flocklab/flocklab/-/blob/master/tools/scripts/embed_image.sh) to convert and embed the image into the XML file:
|
|
|
|
|
|
```
|
|
|
./embed_image.sh [target_image] [xml_config_file]
|
|
|
```
|
|
|
|
|
|
<br />
|
|
|
|
|
|
## How to assign a different target image to each observer
|
|
|
|
|
|
As documented on the [XML configuration help page](https://gitlab.ethz.ch/tec/public/flocklab/flocklab/-/wikis/Man/XmlConfig), it is possible to include several `<targetConf>` blocks in the XML config file. Assigning a separate target image to an observer is straight forward as shown in the following example:
|
|
|
```
|
|
|
<targetConf>
|
|
|
<obsIds>2</obsIds>
|
|
|
<embeddedImageId>Image_1</embeddedImageId>
|
|
|
</targetConf>
|
|
|
<targetConf>
|
|
|
<obsIds>4 5 6</obsIds>
|
|
|
<embeddedImageId>Image_2</embeddedImageId>
|
|
|
</targetConf>
|
|
|
```
|
|
|
|
|
|
<br />
|
|
|
|
|
|
## How to connect to and interact with a target via the serial port (UART) during the test
|
|
|
|
|
|
In order to use the serial proxy service, you need to include the element `<remoteIp>` in the XML config. Note that the field can be left blank, in which case the server will automatically use the IP address of the client that uploads the test configuration (IPv4 required!). Once the test has started, you can connect to the target, e.g. via the command line tool `ncat`:
|
|
|
```
|
|
|
ncat serial.flocklab.ethz.ch 50110
|
|
|
```
|
|
|
The port number defines which observer you access (port number = 50100 + observer ID). In the example above, you would connect to observer 10.
|
|
|
Alternative command line tools for `ncat` are e.g. `nc`, `netcat` or `socat`.
|
|
|
|
|
|
<br />
|
|
|
|
|
|
## How to forward a debug session to your IDE (including SWV / SWO features)
|
|
|
|
|
|
Live debugging of target devices with an ARM MCU is supported via a GDB server. In order to start a GDB server on a specific observer, you need to include the following lines in your XML config file:
|
|
|
```
|
|
|
<debugConf>
|
|
|
<obsIds>02</obsIds>
|
|
|
<gdbPort>2331</gdbPort>
|
|
|
</debugConf>
|
|
|
```
|
|
|
Note that the port must be 2331 due to firewall restrictions.
|
|
|
Once the test has started (and an additional delay of 10 seconds has elapsed), you can connect to the debug server from your IDE. For this, you need to adjust the debug configuration in your IDE: instead of connecting to the localhost, you need to enter the URL of the observer. The observer URLs are as follows:
|
|
|
|
|
|
| observer IDs | URL |
|
|
|
|----------------|----------------------------|
|
|
|
| 01 - 12 | fl-XX.ethz.ch |
|
|
|
| 15, 17, 25 | fl-XX.flocklab-dyn.ethz.ch |
|
|
|
|
|
|
The exact settings and steps necessary to connect to a remote GDB server depends on the IDE you are using.
|
|
|
The SWO output (SWV feature) is available on port 2332. |