IoT Gateway Configuration

Directory structure

Please see default directory structure below for daemon installation.

/etc/thingsboard-gateway/config                   - Configuration folder.
    tb_gateway.yaml                               - Main configuration file for Gateway.
    logs.conf                                     - Configuration file for logging.
    modbus.json                                   - Modbus connector configuration.
    mqtt.json                                     - MQTT connector configuration.
    ble.json                                      - BLE connector configuration.
    opcua.json                                    - OPC-UA connector configuration.
    request.json                                  - Request connector configuration.
    can.json                                      - CAN connector configuration. 
    ... 
/var/lib/thingsboard_gateway/extensions           - Folder for custom connectors/converters.                      
    modbus                                        - Folder for Modbus custom connectors/converters.
    mqtt                                          - Folder for MQTT custom connectors/converters.
        __init__.py                               - Default python package file, needed for correct imports.
        custom_uplink_mqtt_converter.py           - Custom Mqtt converter example.
    ...
    opcua                                         - Folder for OPC-UA custom connectors/converters.
    ble                                           - Folder for BLE custom connectors/converters.
    request                                       - Folder for Request custom connectors/converters.
    can                                           - Folder for CAN custom connectors/converters.
/var/log/thingsboard-gateway                      - Logs folder
    connector.log                                 - Connector logs.
    service.log                                   - Main gateway service logs.
    storage.log                                   - Storage logs.
    tb_connection.log                             - Logs for connection to the ThingsBoard instance.

General configuration file

The main configuration file that is used for connection to ThingsBoard platform instance and enable/disable connectors. This configuration points to ThingsBoard instance demo.thingsboard.io and uses memory file storage configured to store maximum of 100,000 records. There are 4 different connectors active. If you like to use only one of them - just remove all other connectors.

Example of main configuration file. Press to show.

Sections in config file

• thingsboard– Configuration for connecting to ThingsBoard platform.
  • security – Configuration for type of encryption and authorization.
• storage – Configuration for local storage of incoming data from devices.
• connectors – Array of Connectors and their configuration to use.

  Connection to ThingsBoard

  | Parameter | Default value | Description | | :—- | :—- | :—- | | thingsboard | | Configuration for connection to server. | | host | 127.0.0.1 | Hostname or ip address of ThingsBoard server. | | port | 1883 | Port of mqtt service on ThingsBoard server. |

Subsection “security”

There are 3 variants of security subsection:

One type of security configuration is accessToken, to get it you should login into your ThingsBoard platform instance, go to DEVICE tab, press the plus icon, fill the values and check the “Is gateway” option, open this device and press the “COPY ACCESS TOKEN” button and replace default with your value

Security subsection in configuration file will look like this:

...
  security:
    accessToken: PUT_YOUR_GW_ACCESS_TOKEN_HERE
...

In table below described parameters to configure authorization of IoT gateway on ThingsBoard platform.

Security subsection in configuration file will look like this:

security:
    accessToken: PUT_YOUR_GW_ACCESS_TOKEN_HERE
    caCert: /etc/thingsboard-gateway/mqttserver.pub.pem

In table below described parameters to configure authorization of IoT gateway on ThingsBoard platform.

Security subsection in configuration file will look like this:

security:
    privateKey: /etc/thingsboard-gateway/privateKey.pem
    caCert: /etc/thingsboard-gateway/ca.pem
    cert: /etc/thingsboard-gateway/certificate.pem

Storage configuration

Configs in storage subsection provides configuration for saving incoming data before it will be send to ThingsBoard platform.
There are 2 variants for this section: memory or file.

1. Memory storage - Received data saving to the RAM memory.
2. File storage - Received data saving to the hard drive. |
   Memory storage
   (recommended if there is not enough disk space)
   |
   File storage
   (recommended for more persistent)
   | | —- | —- |

| * – If receive data when storage has already counted, described in this parameter, new data will lose.
Storage section of configuration file will look like:``` storage: type: memory read_records_count: 10 max_records_count: 1000

 |
| :--- |
| | **Parameter** | **Default value** | **Description** |
| :--- | :--- | :--- |
| type | **file** | Storage type (Saving data to hard drive) |
| data_folder_path | **./data/** | Path to folder, that will contains data (Relative or Absolute). |
| max_file_count | **5** | Maximum count of file that will be saved. |
| max_read_records_count * | **6** | Count of messages to get from storage and send to ThingsBoard. |
| max_records_per_file | **14** | Maximum count of records that will be stored in one file. |
* – If receive data when storage has already counted, described in this parameter, new data will lose.<br />Storage section of configuration file will look like:

storage type: file data_folder_path: ./data/ max_file_count: 5 max_read_records_count: 6 max_records_per_file: 14

 |
| :--- |
<a name="connectors-configuration"></a>
#### Connectors configuration
Configs in connectors section configuration for connecting to devices by implemented protocols. Config for every connector in this section must have parameters as in table below:
| **Parameter** | **Default value** | **Description** |
| :--- | :--- | :--- |
| name | **MQTT Broker Connector** | Name of connector to broker. |
| type | **mqtt** | Type of connector, must be like a name of folder, contained configuration file. |
| configuration | **mqtt.json** | Name of the file with configuration in config folder.* |
* – Folder with this configuration file.<br />Section connectors in your configuration file may differ from shown below, but they should have structure like this:
```yaml
connectors:
  -
    name: MQTT Broker Connector
    type: mqtt
    configuration: mqtt.json
  -
    name: Modbus Connector
    type: modbus
    configuration: modbus.json
  -
    name: Modbus Connector
    type: modbus
    configuration: modbus_serial.json
  -
    name: OPC-UA Connector
    type: opcua
    configuration: opcua.json
  -
    name: BLE Connector
    type: ble
    configuration: ble.json
  -
    name: CAN Connector
    type: can
    configuration: can.json
  -
    name: Custom Serial Connector
    type: serial
    configuration: custom_serial.json
    class: CustomSerialConnector

Note: You can use several similar connectors at same time, but you should provide different names and configuration files to them.
If you need different type of connector, you can implement it using customization guide or email us: info@thingsboard.io.