Skip to content

2018-09-24

Latest
Compare
Choose a tag to compare
released this 24 Sep 14:41
· 2 commits to master since this release
c8d8185

M18QxIotMonitor 2018-09-23 Release Note

Overview

This release incorporates two changes:

  1. An issue that occurs when connecting to M2X has been found. This issue relates to the API key that is used when creating and accessing M2X devices regarding which key is provided on as the “-d” argument to iot_monitor that has been resolved.

  2. GPS data is now collected from the SK2 and sent as part of the reporting data during the Quick Start mode of operation.

Details

NOTE: The following information pertains to interactions between iot_monitor quick start and a M2X account. It does not necessarily reflect the operation of the AT&T Asset Management Operations Center (AMOC) Dashboard.

NOTE: M2X includes a ‘serial number’ field in the device information. The iot_monitor expects this field will be populated with the ICCID of the SIM card being used to access the device and this is the value that is used when iot_monitor creates a device. If you manually create a device and expect to use iot_monitor, please ensure the ICCID is used as the serial number.

  1. M2X Issue. The M2X key that is supplied to iot_monitor to access M2X varies depending on the activity to perform. When creating a new device, the MASTER KEY must be used and when accessing an existing device, the PRIMARY API KEY + DEVICE ID must be used (if the MASTER KEY is provided for an existing device, the program will automatically switch to the PRIMARY API KEY/DEVICE ID). The software fix adds support to verify the API KEY provided and takes appropriate action based on the supplied key. The following cases are handled:

    a) If the MASTER KEY is provided, the iot_monitor looks for an existing device based on the serial number (the serial number is automatically created based on the ICCID of the SIM card that is used when creating the device). If a matching serial number is found, the API KEY is switch to the PRIMARY API KEY automatically and the devices DEVICE ID is used. If no matching serial number is found, the iot_monitor program creates a new device using the ICCID of the SIM being used

    b) If the PRIMARY API KEY is provided as the API key, the program verifies that a DEVICE ID was provided. If no DEVICE ID was provided, the program terminates because both are required to access an existing device.

    c) If the PRIMARY API KEY and DEVICE ID is provided, the program verifies its existence, and proceeds. If the device doesn’t exist, the program exits because you must use the MASTER KEY to create a device.

  2. GPS Data Addition

In Quick Start mode, the iot_monitor will automatically create 5 data streams (ADC, TEMP, XVALUE, YVALUE, ZVALUE) to send collected data to. Additionally, the SK2 will now enable the GPS module and send current GPS coordinates to M2X location.

Release version number Release date
v1.11 Sept 24, 2018 @ 14:30:00