Jump to main content
Introduction to Device Cloud
Device Cloud includes device-side and platform-side components.
Where to Find Information
Supported Features and Operating Systems
Device Cloud includes the Device Cloud platform and the Device Cloud agent for selected operating systems.
Device Cloud Platform Architecture
Applications, thing definitions, and things are the basis of the Device Cloud platform architecture.
Device Cloud Connectivity
Applications on the device communicate with Device Cloud using the TR-50 protocol over Message Queue Telemetry Transport (MQTT) secured with TLS 1.2.
Device Cloud Agent
The agent on the device supports an SDK to build IoT applications and provides a device manager application.
Logging in to Device Cloud
After you complete the account registration process, you are ready to log in to Device Cloud.
Quick Start for Linux Overview
The instructions in this document enable you to install the agent on a Linux device, run the device manager application to perform basic device management, and run a sample application that sends data from your device to Device Cloud.
Installing the Agent on Your Linux Device
You use the Python package manager, pip, to install the agent and the required dependencies on your device.
Setting Up the Device Cloud Definitions in Linux
The setup-cloud-deps.py program creates and updates the required applications and thing definitions in Device Cloud for the device manager and sample applications.
Generating the Device Manager Connection Configuration File in Linux
The connection configuration file specifies the information to enable an application to connect to Device Cloud.
Running the Device Manager Application in Linux
The device manager application provides basic device management for the device on which the application runs.
Sending Data to Device Cloud from Your Device in Linux
You can run the iot-simple-telemetry.py application to send data from your device to Device Cloud.
What to Do Next
Now that you have started transmitting data successfully, you can continue exploring Device Cloud and start developing your own applications.
Troubleshooting Installation Issues with the Python Agent
Variations in Python environments and the release of Python you use may result in issues when you install the Python agent or when you run applications.
Quick Start for Windows Overview
The instructions in this document enable you to install the agent on a Windows device, run the device manager application to perform basic device management, and run a sample application that sends data from your device to Device Cloud.
Installing the Agent on Your Windows Device
You use the Python package manager, pip, to install the agent and the required dependencies on your device.
Setting Up the Device Cloud Definitions in Windows
The setup-cloud-deps.py program creates and updates the required applications and thing definitions in Device Cloud for the device manager and sample applications.
Generating the Device Manager Connection Configuration File in Windows
The connection configuration file specifies the information to enable an application to connect to Device Cloud.
Running the Device Manager Application in Windows
The device manager application provides basic device management for the device on which the application runs.
Sending Data to Device Cloud from Your Device in Windows
You can run the iot-simple-telemetry.py application to send data from your device to Device Cloud.
What to Do Next
Now that you have started transmitting data successfully, you can continue exploring Device Cloud and start developing your own applications.
Troubleshooting Installation Issues with the Python Agent
Variations in Python environments and the release of Python you use may result in issues when you install the Python agent or when you run applications.
Quick Start for VxWorks 7 Overview
In this Quick Start, you will install and run the device manager on a VxWorks device, start a sample application that transmits data, and view the data transmission from the Device Cloud Management Portal.
Configure VxWorks with Device Cloud Support
Use a VSB and VIP project to configure VxWorks with Device Cloud support, which must include writable storage.
Build the Sample Application
Build the sample telemetry application as a user mode (RTP) or kernel mode (DKM) application.
Create Configuration Files
Look up the device manager and telemetry application tokens in the Management Portal, and create the configuration files for the device manager and for the device's connection with the Device Cloud.
Copy Files to Device Storage
Boot your device. Copy your configuration files, CA certificates file, telemetry application, and any other files required by your system to device storage media.
Get Device ID and Start Application
Get the device ID from the device_id file, then start the telemetry application.
Use Management Portal to View Data Transmission
Log onto the Device Cloud, find your device, and view the data that is being transmitted by the telemetry application from the device.
What to Do Next
Now that you have started transmitting data successfully, you can continue exploring Device Cloud and start developing your own applications.
Overview
Device Cloud includes the Device Cloud platform and the Device Cloud agent.
Changes in This Release
This release introduces secure tunnel access through HTTP and HTTPS in addition to SSH, Telnet, VNC, and RDP to devices connected to Device Cloud. It also enhances support for campaigns and triggers.
Host and Target Requirements
Host and target support for Device Cloud agent and user interfaces are based on the capabilities and tools of the operating environments.
Usage Caveats
Support Resources
provides a variety of services, including training courses and contact with customer support engineers, along with a website containing the latest advisories, FAQ lists, known problem lists, and other information resources.
Introduction to the Device Cloud Winter 2017 Release
The Winter 2017 release introduces a new platform architecture and changes to the agent to adapt to the new platform.
Device Cloud Management Interface
In the Winter 2017 release, the browser-based user interfaces have been replaced and are accessed through a single URL, which is based on your geographic region.
Device Cloud Platform
The Winter 2017 release provides functionality equivalent to that of the previous the platform.
Device Cloud Agent
The agent functionality has been divided into a library/SDK and supporting applications, including a device manager.
Terminology
Earlier releases of Device Cloud and the Winter 2017 release use different terms for similar concepts.
Application Development
Application Initialization
Thing Data
Location Data
Methods
File Transfer
Application Connection Configuration Files
Sample Applications
Device Manager
Troubleshooting Installation Issues with the Python Agent
Variations in Python environments and the release of Python you use may result in issues when you install the Python agent or when you run applications.
Introduction to the Management Portal
The Management Portal is the browser-based user interface that is part of Device Cloud.
Logging in to the Management Portal
Log in to the Management Portal to perform administrative tasks and to access developer tools.
Navigating the Management Portal
The Home page shows recently viewed things, API usage for the previous 30 days, recent event logs, and a pie chart that displays a quick overview of connected things and status.
Updating Your User Profile
You can change your profile details and customize the appearance and behavior of the Management Portal.
User Management
Organizations
Notification Groups
Dashboards
Reference - Dashboard Widgets
Applications
Thing Definitions
Things
Method Aliases
Files
Viewing Event Logs
You can view the list of events for all things and users in an organization.
Service API Tools
Triggers
Reference - Cloud Trigger Events
Reference - Cloud Trigger Actions
Campaigns
Geofences
Third-Party Services
Field Formats and Limitations
The following table provides the limitation of the fields used in the Management Portal.
Introduction to the Device Cloud Service API
Device Cloud provides a set of APIs that are used to enable devices to connect to Device Cloud and enables mobile and desktop applications to interact with the data available in Device Cloud.
TR50 Message Format
To use the API command interface, you must format the messages you send according to the TR50 protocol specification, which defines a JSON object format that can be processed by numerous applications.
REST Interface
Device Cloud provides a RESTful interface to enable you to write applications that send TR50 commands.
Data Types and Limits
The values for some data types used in the Device Cloud must be within a specific range.
Device Cloud Authentication
Before sending any commands to Device Cloud, the client must authenticate its connection.
HTTP Interface
Device Cloud provides a HTTP interface to enable you create applications that use HTTP (or HTTPS) to send commands either by calling the TR50 endpoint or by using the simple REST API.
MQTT Interface
Device Cloud Service Interface
Applications use the TR50-compliant Device Cloud APIs to interface with Device Cloud.
Activity Log Service
Alarm Service
App Service
Attribute Service
Campaign Service
Configuration Service
Counter Service
Diag Service
Email Service
Export Service
File Service
Geofence Service
Locale Service
Location Service
Log Service
Mailbox Service
Method Service
Notification Service
Org Service
Property Service
Role Service
Search Service
Session Service
Thing Service
Thing Definition Service
Third Party Services
Trigger Service
Usage Service
User Service
Introduction to Secure Device Onboard
The Intel Secure Device Onboarding (SDO) service enables SDO-compliant devices to securely register with Device Cloud based on preprovisioned identity information in the device hardware.
Uploading an Update Package for Onboarding
The update package contains the files and installation instructions that enable a device to connect to Device Cloud during the onboarding process.
Obtaining the Public Key
To enable the manufacturer to provide the ownership receipt file, you must provide the public key.
Uploading Your Digital Ownership Receipt to Device Cloud
To enable your devices to receiving onboarding information, you must upload your ownership receipt to Device Cloud.
Assigning an Update Package for Onboarding to a Device
To enable an SDO-compliant device to connect to Device Cloud, it must be associated with an update package for onboarding that contains the Device Cloud agent and other required files.
Introduction to Remote Device Access
You can access a device remotely from Device Cloud through applications on the LaunchPad.
Device Configuration for Device Console Access
To enable remote access to a device through the Device Console link on the LaunchPad, you must configure both the device and the device manager.
Logging in to the Device through the Device Console
You open a remote login session over Telnet through the Device Console link on the LaunchPad.
Device Configuration for Remote Tunnel Access
To enable remote access to a device through the Remote Access link on the LaunchPad, you must configure both the device and the device manager.
Creating a Secure Tunnel for an SSH Connection
You can connect to a device through a secure tunnel using an SSH client application, including a file transfer client such as WinSCP.
Creating a Secure Tunnel for a Telnet Connection
You can connect to a device through a secure tunnel using a Telnet client application on Windows, Mac OS X, and Linux operating systems.
Creating a Secure Tunnel for a VNC Connection
You can connect to a device through a secure tunnel using a VNC client application on Windows, Mac OS X and Linux operating systems..
Creating a Secure Tunnel for a RDP Connection
You can connect to a device through a secure tunnel using a Remote Desktop Protocol (RDP) client application on Windows, Mac OS X, and Linux operating systems.
Installing the Plugin Application
You can install the plugin on multiple operating systems. LaunchPad detects the operating system on which your web browser runs, and enables you download the plugin specific to that operating system.
Creating Filters to Manage your Devices
You can create filters to customize your searches to help you connect to a device.
Third-Party Tool Configuration for Remote Tunnel Access
Some clients require specific settings when connecting to a device through a secure tunnel.
Troubleshooting Remote Access
Problems connecting to the device are often caused by a mismatch between the client application running on the host and the configuration on the device.