Gateway Mode

The goal of Bosch IoT Hub is to enable IoT solution developers to connect devices through various protocols to their back-end applications. In some scenarios for communication with Bosch IoT Hub a gateway mode can be used. With gateway mode, only the gateway, which is an ordinary device within the device registry, needs to authenticate with Bosch IoT Hub. The actual device just needs to be registered within device registry including a link to its gateway. Credentials for the actual device are not required.

Scenarios for Gateway Mode

Devices using non-IP based protocols

Some devices use non-IP based protocols, e.g. WPAN (wireless personal area network) based protocols like Bluetooth®, ZigBee or Z-Wave for reasons such as power or cost-savings. However, the transport protocol to communicate with Bosch IoT Hub needs to be IP-based. To implement such scenarios, IoT solution developers need to utilize some sort of gateway that translates non-IP based protocols to IP-based protocols. These gateways need to be able to send device data on behalf of the actual devices as outlined in the graphic below.

Bosch IoT Hub Gateway Mode Gateway Mode communication flow for non-IP based protocols

Integration with third-party network provider

Devices with limited battery capacity using LPWAN (low power wide area network) based technologies like SigFox or LoRa. Network providers of such technologies provide a backend system to interact with LPWAN devices. To transfer the data from such devices to the Cloud the integration with third-party network provider is required. For this purpose the third-party network server, e.g. LoRa network server acting as a gateway device in Bosch IoT Hub and the actual LoRa devices communicate via this gateway. Registering credentials for the actual LoRa-devices is not required - authentication will be performed using the credentials of the LoRa Network Server Gateway. 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.

Devices using proprietary or unsupported protocols and connecting via protocol gateway

For various reasons, there are devices that can not communicate via standard protocols and therefore they use proprietary protocols and proprietary protocol adapter. Such proprietary protocol adapter serves as a gateway that translates proprietary protocols to standard protocols like HTTP, AMQP1.0 and MQTT. Bosch IoT Hub supports the integration with such protocol gateways.

Bosch IoT Hub supports above listed scenarios in two modes: single gateway mode and multiple gateways mode.

Single and Multiple Gateway Modes

Single Gateway Mode

In this mode all devices communicate only via one gateway as outlined in the graphic below.

Bosch IoT Hub Gateway Mode Single Gateway Mode communication flow

To operate devices in Single Gateway Mode, the actual device needs to be linked to its gateway. To achieve this, the via property must be set to the device-id of the gateway on device registration. See Suite API Docs: Device Registry for details. The linked gateway is an ordinary device with credentials within device registry.

Multiple Gateways Mode

In this mode all devices can be connected to Bosch IoT Hub via many gateways as outlined in the graphic below. This mode can be used in case a protocol gateway is scaled to multiple instances and each instance of the protocol gateway is modeled in Bosch IoT Hub as a separate gateway device or when the actual devices are connected via different gateways (e.g. eBike is connected via Bluetooth with Smartphones of different family members and each Smartphone is modeled in Bosch IoT Hub as a separate gateway).

Bosch IoT Hub Gateway Mode Multiple Gateway Mode communication flow

To operate devices in Multiple Gateway Mode, all gateways need to be grouped and the actual device needs to be linked to this gateway-group. To achieve this the via property must be set to the gateway-group-id on device registration. More details can be found in the sub-chapter below.

Gateway Group

The gateway-devices can be grouped in Bosch IoT Hub. With this feature no update of actual devices is needed when a new instance of protocol gateway is launched. It is enough just to add a new gateway-device to the gateway-group and all actual devices connected via this gateway-group are updated with a new gateway-device. To achieve this, the gateway-devices need to be created on device registration. After that these gateway-devices need to be grouped. The gateway-groups are modeled in Bosch IoT Hub as devices. As a last step the via property of the actual devices must be set to the gateway-group-id on device registration. See Suite API Docs: Device Registry for details.

The necessary steps for configuration of gateway-group are provided below:

1. Configuration of gateway-devices

{
  "device-id": "Gateway-Device-1",
  "enabled": true
}

{
  "device-id": "Gateway-Device-2",
  "enabled": true
}

2. Configuration of gateway group

{
  "device-id": "Gateway-Group",
  "enabled": true,
  "devices": [
      "Gateway-Device-1",
      "Gateway-Device-2"
  ]
}

3. Configuration of devices

{
  "device-id": "Device-1",
  "enabled": true,
  "via": "Gateway-Group"
}

{
  "device-id": "Device-2",
  "enabled": true,
  "via": "Gateway-Group"
}

Supported Protocol Adapters

The following protocol adapters support Gateway Mode: