IoT tool reference

Supplementary information is available to help you to use and develop the IoT tool.

Simulating devices in the IoT tool
You can set up simulated devices in the IoT tool to test and demonstrate features for the latest versions of Maximo Monitor device types.
IoT tool overview
The IoT tool acts as an IoT device message broker for device registration, IoT data management, and IoT device management. You can use the tool to connect and control IoT devices. The tool provides secure communication to and from your devices by using MQTT and TLS.
Connecting devices
You can connect devices to the IoT tool.
Device Management protocol
Managed devices are defined as devices that contain a device management agent. A device management agent is a set of logic that allows the device to interact with the IoT tool Device Management service by using the Device Management Protocol. Managed devices can perform device management operations that include location updates, firmware downloads and updates, restarts, and factory resets.
Device model
The device model describes the metadata and management characteristics of a device and is stored in the IoT tool device database, the master source of device information.
Working with interfaces
Devices might provide similar data output, but they can vary in make, model, and version and can output data in different formats.
Communicating with applications (MQTT)
MQTT is the primary protocol that devices, gateways, and applications use to communicate with the IoT tool. Client libraries, information, and samples are provided to help you to connect and integrate your IoT tool applications.
Using notification rules and actions
After you have modeled and activated your device twin and sent some data, you can use rules and actions to automatically respond to changes in the state of your devices in close to real time.
Mapping expression language
You can use the mapping expression language to manipulate and combine data, and to format the results of any queries that you might run on your processed data.
Connecting to an external Db2 by using CLI
You can connect Monitor to an external Db2 database by using the IBM Maximo Application Suite Command Line Interface (CLI) utility
Monitoring client connectivity
The IoT tool collects and stores information about client activity such as when a device connects, disconnects, or sends messages. Use the client connection state API to query the activity of one or many device clients.
Data store connectors
With data store connectors, you can connect your IoT tool organization to IBM services that provide both long and short-term storage solutions.
Db2 Warehouse requirements
To store IoT data from your connected devices in Db2® Warehouse, your environment must meet the following requirements:
Security
As a cloud-hosted service the IoT embeds security as an important aspect of its architecture.
Managing groups
Users with the administrator role can use the IoT tool groups to grant members and API keys access to specific devices.
Role-based or resource-level access control for the IoT tool
For Maximo Application Suite 8.8 and 8.9, you can configure either role-based or resource-level access control for the IoT tool.
Application API
Use the following API endpoint URLs to access the IoT tool APIs. The API endpoint URL consists of a host URL and a base URL. The base URL for each REST API is listed with the API docs, and is typically api/v0002/. Several APIs are available for developing code for devices, gateways, and applications that connect to the IoT tool.
Messaging API
Use the HTTP Messaging API to send events from devices to the IoT tool.
SDKs
Use the official IoT tool SDKs to simplify device, gateway, and application development.
Using reference samples
You can use the IoT tool reference samples as starting points to start your device development.
Tutorial: Adding data from physical devices
Complete the steps to add devices to the IoT tool. Use REST APIs to send events from these devices to the IoT tool. Later, you create summary and device dashboards to monitor the device data.

Parent topic: Reference