Astarte Message Hub

A central service that runs on (Linux) devices for collecting and delivering messages from N apps using 1 MQTT connection to Astarte.

Documentation

• Astarte Message Hub Architecture
• Astarte Documentation

Requirements

• protobuf >= 3.15
• Rust version >= 1.59

Configuration

The Astarte Message Hub is configured through message-hub-config.toml in the current working directory, otherwise the system wide /etc/message-hub/config.toml can be used. In alternative, you can specify the path to the configuration file with the -t/--toml cli option.

The format for the configuration file is the following:

```toml

#

Required fields

# realm = "" pairingurl = "" grpcsocket_port = 0 # Required, 0 is only a placeholder

#

Optional fields

# interfacesdirectory = "[INTERFACESDIRECTORY]"

Device id, if not provided it will be retrieved from io.edgehog.Device dbus-service

deviceid = "[DEVICEID]"

Used to register a device and obtain a credentials_secret

pairingtoken = "[PAIRINGTOKEN]"

Credential secret, if not provided the pairing_token is required

credentialssecret = "[CREDENTIALSSECRET]"

Ignore SSL errors, defaults to false

astarteignoressl = false

Path to store persistent data, defaults to "./"

store_directory = "" ```

An example configuration file can be found in the examples direction.

Example

Have a look at the examples for an usage example showing how to send and receive data.