This document describes the types of devices nRF Cloud supports, and how they appear in API responses.
Bluetooth Low Energy devices
Beacons are partially supported. You can add them to your account through a gateway and interact with them through the nRF Cloud web portal. They are not stored in cloud databases or appear in JSON responses when calling nRF Cloud REST API endpoints.
Internet Protocol devices
Internet Protocol (IP) devices are provisioned on nRF Cloud. Provisioned devices have an IP address. Bluetooth LE devices or beacons, however, are not cloud provisioned and do not have an IP address.
The two main types of IP devices are gateways and generic devices.
Gateways are IP devices that support connections to Bluetooth LE peripherals.
Phone gateways are not intended for use in production, but only for small-scale development. Phone gateways use AWS Cognito for authentication, not X.509 certificates.
The nRF Cloud team provides an open-source nRF Cloud Gateway application, available for Android and iPhone. Using this app, you can create a gateway for your nRF Cloud account and connect Bluetooth LE devices.
The phone must be awake for the application to work as expected. On the app's Account page, enable Stay awake (iPhone) or Background mode (Android).
If the gateway indicates in the web portal that it is not connected, try closing and restarting the app. The Account page is also where you can see the gateway ID, which helps you identify it in the nRF Cloud web portal or in REST API responses.
Nordic Semiconductor does not currently offer LTE gateway hardware.
An account device has MQTT permissions to monitor the message traffic of all devices associated with your account. You can use the certificate for this device to connect to the nRF Cloud MQTT broker and monitor device traffic for debugging purposes, or set up your own MQTT message bridge.
You can create an account device using the
A software device is a software application that runs an MQTT client. An example of this is the nRF Device Simulator. The device simulator simulates a generic device by default and appears as
"type": "Generic" in the JSON responses. The simulator is not limited to generic types and you can modify it to simulate any other supported device types.
You can run IoT devices on any type of hardware that supports an MQTT client, such as the Raspberry Pi. The type depends on your implementation for the device type.
nRF Cloud supports custom devices built using Nordic Semiconductor chips and is not limited to development kits.
In addition to generic and gateway devices, nRF Cloud supports the
subType property, also known as
thingType. For more details about the use of this property, read the documentation for the