Overview of Embedded Development
This document provides an overview of the tools used for developing IoT applications on the RIoT Secure Platform.
For detailed instructions, consult the respective section of the documentation.
1. Management Console
The Management Console is a web-based tool used for managing devices and users of an IoT system. The console is the starting point for getting involved with application development on the RIoT Secure Platform.
To login to the Management Console, a user account is needed. Visit the Quick Overview guide to get an account.
2. Device Enrollment
To use an IoT device with the RIoT Secure Platform it must be enrolled; that is, it has to be registered with the OASIS Cloud, and the FUSION Core Firmware has to be installed on the device.
There are two main steps involved in enrolling a device:
-
Register the device with the OASIS Cloud using the Management Console.
-
Install the FUSION Core Firmware on the device, which is done by connecting the device a computer and run a sketch called RIoTInstaller from the Arduino IDE.
Once the device is enrolled, the device no longer needs to be connected to a computer to be updated. Instead firmware updates are performed over-the-air using the Management Console.
Related Documentation
Enrollment Tutorial3. Arduino IDE
The Arduino IDE is used to enroll the device and to develop application firmware for the device.
The device must be enrolled to update the application firmware on the device. Firmware updates are done over-the-air using the Management Console.
Related Documentation
Embedded Development Reference4. Firmware Updates
The application firmare running on a device can be updated using the Management Console or via a command-line tool.
4.1. Firmware Update Using the Management Console
To update the application firmware of a device over-the-air, perform the following steps:
- Begin by exporting the sketch as a compiled binary from the Arduino IDE.
- Then upload the exported sketch as a new firmware using the Management Console.
- Finally, assign the new firmware to the device. The firmware update process with be initiated within 60 seconds. The entire update process takes from 1 to 5 minutes, depending on the firmware size.
4.2. Scripted Firmware Update
Experienced developers can use a command-line tool to update the application firmware in a single step:
- Export the sketch as a compiled binary from the Arduino IDE.
- Run the command-line tool; the firmware update process will begin within 60 seconds.
Related Documentation
REST API Tools5. Accessing Device Data Using the Customer Cloud
The Customer Cloud is a server component created and maintained by the application developer. Typically, this is a web server running e.g. a PHP script that accepts incoming device data.
The customer server will in most cases save the data to a file or a database. Device data can also be sent to other systems for further processing.
Typically, a Web UI would be used to view and manage the device data.