2.1.2. FIWARE System Handle¶

This repository contains the source code of the Integration Service System Handle for the FIWARE middleware protocol, widely used in the robotics field.

The main purpose of the FIWARE System Handle is that of establishing a connection between a FIWARE’s Context Broker and an application running over a different middleware implementation. This is the classic use-case for Integration Service.

2.1.2.1. Dependencies¶

The dependencies of the FIWARE System Handle are:

2.1.2.2. Configuration¶

Regarding the FIWARE System Handle, there are several specific parameters which must be configured for the FIWARE middleware. These parameters are mandatory, and are suboptions of the main five sections:

systems: The system type must be fiware. In addition to the type and types-from fields, the FIWARE System Handle accepts some specific configuration fields:
```
systems:
   fiware:
       type: fiware
       host: localhost
       port: 1026
```
port: The specific port where the FIWARE’s Context Broker will listen for incoming connections. This field is required.
host: The IP address of the FIWARE’s Context Broker. This field is required.

2.1.2.3. Examples¶

There is one example that you can find in this documentation in which the FIWARE System Handle is employed in the communication process:

FIWARE - ROS 2 bridge

2.1.2.4. Compilation flags¶

Besides the Global compilation flags available for the whole Integration Service product suite, there are some specific flags which apply only to the FIWARE System Handle. They are listed below:

BUILD_FIWARE_TESTS: Allows to specifically compile the FIWARE System Handle unitary and integration tests. It is useful to avoid compiling each System Handle’section test suite present in the colcon workspace, which is what would happen if using the BUILD_TESTS flag, with the objective of minimizing building time. To use it, after making sure that the FIWARE System Handle is present in your colcon workspace, execute the following command:
```
~/is_ws$ colcon build --cmake-args -DBUILD_FIWARE_TESTS=ON
```