In this section we will use the Pinnacle Connect app to connect to and provision your MG100 gateway to work with the Cumulocity IoT platform under your user account. Please follow the steps below.

Provision Your Device

To configure your device, the bootstrap Peer URL, Client ID/PSK ID and PSK must be set. This can be done using the UART console or the mobile app.

  1. Using the UART console, set the lwm2mPeerUrl attribute:

    attr set 215 lwm2m.us.cumulocity.com:5684

  2. Set the lwm2mClientId attribute (replace <ID> with unique ID of your device). For example, on an MG100:

    attr set 214 MG100_<ID>

    Note: This client ID needs to match what was filled out in the registration template CSV file for the device.

  3. Set the bootstrap PSK attribute:

    attr mod 213 <PSK value as hexadecimal digits>

  4. Enable bootstrap support:

    attr set 264 1

  5. To reboot the device and it will attempt the LwM2M bootstrap connection when the firmware runs again:

    kernel reboot cold

Register Device

Note: This is not required for MG100 starter kits. It is only required if adding a new MG100 to an existing account.

First fill out this template for each of your devices, one per row.

  • Columns A,B,C,E,F, and H should all be the same. Pick a unique ID for your device. For MG100/Pinnacle 100, include the IMEI. For BL5340, include the Ethernet MAC address. This unique ID should match the client ID that was set when commissioning your device.
  • Column D is not used, leave the value alone.
  • Column G and I should be different PSK values for better security but can be set to the same value if desired. They can be different by one bit or completely randomized. Column G needs to match the PSK value used when commissioning your device. The format for the PSK in the spreadsheet is a 16 byte value written as hex, for example 5b30484ec1539bed3c99e45b082b2159. Be careful to not include any leading or trailing whitespace.

Navigate to Device Management

Device Management
Device Management

Click Registration on leftmost sidebar, then click the Register device button

Register Device
Register Device

Select Bulk device registration (even if registering a single device)

Bulk Registration
Bulk Registration

Click Select file to upload and select your filled out template file (.CSV)

Upload File
Upload File

After the file uploads, click Reload now to finish the process

Reload Now
Reload Now

Verifying Connectivity

Watch UART console output for the Registration Done message

[00:00:15.756,835] <inf> net_lwm2m_rd_client: Registration Done (EP='29JjiRLgGU’)

On the Cumulocity IoT Device Management site, navigate to the Info page for your device. The Last communication timestamp is listed in the DEVICE STATUS section.

Connectivity Status
Connectivity Status

Now that the gateway is provisioned we will move onto visualizing your sensor data on the Cumulocity IoT platform in the next section of this document.