Scaleway Elements IoT Hub - Networks

IoT Hub Networks - Overview

Networks allow your devices, ranging from embedded systems to server software, to exchange messages with your IoT Hub.

There are currently 3 network types:

• The MQTT network type, which uses the MQTT protocol.
• The Sigfox network type, which allows your Sigfox devices to communicate with your Hub.
• The Rest network type, which allows any http client to communicate with your Hub.

Other network types are planned for future versions of the Hub.

The Default Network (MQTT)

The default network, which is automatically created with your Hub, is a MQTT network. Being the default network, you can’t delete it, and we do not allow the creation of other MQTT networks.

To connect to this network:

1 . Create a device if haven’t already.

2 . Configure your device / client to connect through the Network, using the following parameters

• Host: The network endpoint.
• Port and protocol: See the table below.
• Client ID: The Device ID from the device you created earlier. Note: If you cannot put the value in the client ID, you may put it in the username field.
• If your client asks for a password, just pass in an empty string.

There are 4 ports you may use depending on how you configured your device, and which protocol you wish to use.

If you have configured your device to fore mTLS (deny insecure connections), you’ll also need to provide the certificate that was given to you at the first step.

3 . Connect and exchange messages.

There’s only one default network so there’s no need for prefixing.

The Sigfox Network Type

The Sigfox Network type allows devices communicating with the Sigfox protocol to exchange messages with the IoT Hub. Sigfox will collect messages from your devices, and relay them to your IoT Hub.

The Sigfox network doesn’t support downlink messages yet. This will be available soon.

Setting-up a Sigfox Network

To setup a Sigfox Network, you’ll need to have a Sigfox account . If you don’t have an account, you may have a look at this page to get started.

1 . On your hub’s page in the Scaleway console, click on the Networks tab.

2 . On the Networks tab, click on the Add network button (the green +) to open the network creation form.

3 . Fill-in the different fields.

• Enter a name for your Network.
• Choose Sigfox as the type of Network you want to create.
• Choose a topic prefix your Network should publish to. You may leave this empty. All the messages published to this network will have their topics prefixed with this value.

4 . Click ‘Create Network’

The last page will show a summary of the network you just created, and 2 key parameters:

• The Network endpoint.
• The Network secret. Be careful, this secret will only be shown once !

Keep this information, we’ll need it in a few minutes.

Configuring the Sigfox backend

Now you have successfully created your Sigfox network, it’s time to configure the Sigfox callbacks to relay messages to your Iot Hub.

1 . Login the Sigfox backend here

2 . Go the DEVICE TYPE tab

3 . Click on the CALLBACKS entry in the left menu

4 . Select the Custom callback option

5 . Fill-in the form like the image below.

Let’s go through each field:

• Type: DATA UPLINK because we do not support BIDIR callback (but we will soon, stay tuned)
• Channel: URL.
• Custom payload config: Leave it empty.
• Url pattern: Put the network endpoint in this field, for example https://sigfox.iot.fr-par.scw.cloud.
• Url method: POST.
• Send SNI: Check this box.
• Headers: In this section, we need to define three headers. Do not worry if you only see a single line, once you click on it a new empty line will appear.

• Choose a Content type and Body that fits your needs. In the example above we chose to send a JSON payload.

Wrapping-up

In this example, if the device id is A1234B, the sensor payload is ABCDEF01, the topic header is {device}/payload, and the Network prefix is myapp, then a message will be received on the myapp/A1234B/payload topic, containing the following payload:

{
	"data": "ABCDEF01",
	"id": "A1234B"
}

The Rest Network Type

The Rest Network type allows any HTTP client to send messages to the IoT Hub.

The Rest network only allows publishing messages.

Setting-up a Rest Network

1 . On your hub’s page in the Scaleway console, click on the Networks tab.

2 . On the Networks tab, click on the Add network button (the green +) to open the network creation form.

3 . Fill-in the different fields.

• Enter a name for your Network.
• Choose Rest as the type of Network you want to create.
• Choose a topic prefix your Network should publish to. You may leave this empty. All the messages published to this network will have their topics prefixed with this value.

4 . Click ‘Create Network’

The last page will show a summary of the network you just created, and 2 key parameters:

• The Network endpoint.
• The Network secret. Be careful, this secret will only be shown once !

Keep this information, we’ll need it in a few minutes.

Using the Rest Network

You can use any HTTP client to publish a message through Rest Network. Required headers are:

• X-Secret: put here the network secret that was given when you created the network on your Hub
• X-Topic: choose here the topic that suits your needs

Here is an example using curl:

> curl -XPOST -H "X-Secret: <network-secret>" -H "X-Topic: <topic>" -d <payload> <network-endpoint>

using following values:

• <network-secret>: Put here the network secret that was given when you created the network on your Hub
• <network-endpoint>: Put here the network endpoint that was given when you created the network on your Hub
• <topic>: Choose here the topic that suits your needs. This topic will be prefixed with the network topic.
• <payload>: Put here the payload you want to publish (a JSON string as example)

Learn more about Scaleway IoT Hub, discover how to add Devices to the hub, check the IoT Hub metrics or get started in a few clicks with the IoT Hub Kickstarts.