Our Choosing an Integration Strategy article covers the different ways to receive device data.
Some users wish to make use of the Azure IoT Hub to receive data.
The OEM Server supports this via the use of the HTTP Connector (option 3 in the integration strategy article)
Typical IoT Hub Requirements
These requirements can vary and the user must check on their side.
This is not an exhaustive list, just what we have accommodated in the past.
- Data sent in the form of an HTTP POST
- application/json header
- Header containing the hub name.
- Per device authentication tokens
- Posting to specific URLs based upon the device serial.
Contact your DM support representative to have a connector set up.
In it's simplest form, DM simply sets the connector up to send a HTTP POST to a provide URL each time the device uploads data to OEM server - it will be forwarded on.
The server should respond with HTTP OK (200)
Additional fields, features can be configured to facilitate sending data to the IoT Hub including:
[SERIAL] - Device Serial
[CUSTOM1], [CUSTOM2], [CUSTOM3] - these values can be loaded in to the OEM Database against device serials via the OEM API (contact DM support for API documentation)
Multiple headers can be sent with the POST.
Thus for example data can be sent in the following format,
The serial of the specific device is sent in the URL.
Header1 - application/json
Header2 - Authorization:[CUSTOM1] (perhaps this is a per device authorisation token. The correct token will be retrieved and sent with the POST.
Please contact DM Support with your hub requirements.
It is often useful to provide a sample post that is successful and we can replicate this in the connector set up.