LoRa Adapter

The LoRa protocol (or more precise LoRaWAN: Long Range Wide Area Network) is a wireless protocol well suited for constrained devices. Due to its power saving implementation is fits well for use-cases where battery capacity is a limited resource.

The Bosch IoT Hub supports forwarding of telemetry messages received from a LoRa Network Server Gateway to a business application as well as sending back messages from the business application to the LoRa Network Server Gateway.

Supported LoRa networks

Network provider Endpoint HTTP Method
Actility https://lora.bosch-iot-hub.com/actility POST
Kerlink https://lora.bosch-iot-hub.com/kerlink/rxmessage POST
The Things Network (TTN) https://lora.bosch-iot-hub.com/ttn POST
Objenious https://lora.bosch-iot-hub.com/objenious POST
Everynet https://lora.bosch-iot-hub.com/everynet POST
Proximus https://lora.bosch-iot-hub.com/proxismus POST

LoRa application properties

The following list shows the AMQP 1.0 message application properties which are available for messages received through the LoRa adapter:

Property Name Description
JMS_AMQP_CONTENT_TYPE application/json
device_id The identifier of the device which sent the message.
orig_adapter The identifier of the LoRa protocol adapter: hono-lora.
orig_address The relative uri path the device pushed its data to.
orig_lora_provider The identifier of the LoRa network provider.

LoRa payload format

Incoming LoRa messages are forwarded as application/json payload. The LoRa payload is stored in the payload field as Base64 encoded value.

{"payload":"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAIw=="}

How to get started using the LoRa Adapter

  1. The LoRa Adapter is currently only available in the Starter and Standard Plan (see Features and Service Plans). Therefore you need to make sure that you have subscribed to a payed service plan. Otherwise you will get a 403 FORBIDDEN error even-though the supplied credentials are correct.

  2. Register a device and credentials for the LoRa Network Server Gateway with the Bosch IoT Hub.

  3. Register sensors with the Bosch IoT Hub. The device-id must correspond with the LoRa end-device identifier DevEUI send by the sensor and the LoRa Network Server Gateway. Keep in mind to include the via property with the device-id of the previously registered LoRa Network Server Gateway. This is necessary to link the authentication. The LoRa Network Server Gateway will then be allowed to send messages on behalf of the sensors. Registering credentials for the sensors is not required - authentication will be performed using the credentials of the LoRa Network Server Gateway.

  4. Next setup and install the LoRa Network Server Gateway as described by the network provider. For the HTTPS endpoint and the HTTP method to use please refer to the table above. For Basic Auth the credentials of the LoRa Network Server Gateway have to be used.