Pelion Device Management SDK for JavaScript

The Pelion Device Management SDK provides a simplified interface to the Pelion Device Management APIs by exposing functionality using conventions and paradigms familiar to JavaScript developers.

Prerequisite

Node.js > v10.16.0 (lts), which includes npm.

Installation

The SDK is distributed using npm. To install the package in your project:

$ npm install mbed-cloud-sdk

/node_modules/mbed-cloud-sdk now contains:

bundles - minified browser scripts.
lib - Node.js modules.
lib-es6 - ESNext modules.
types - Typescript types.

Consuming in a Typescript project

To consume the SDK in a typescript project you must have the following declared in your tsconfig.json file.

{
    "compilerOptions": {
        "target": "es5", // es5 is the minimum but anything higher will be ok.
        "module": "commonjs", // commonjs will work for all targets es5 or above
        "moduleResolution": "node", // If module is es2015 or higher, then this is needed.
        "lib": [
            "dom",
            "es5",
            "es2015.promise",
            "es2015.symbol.wellknown",
            "es2015.core"
        ], // These are the library files required to build the SDK.
    }
}

API keys

Before using the SDK, you need to obtain an API key for use with Pelion Device Management.

You can generate this through the Pelion Device Management management console.

Configuration

The SDKs support setting parameters through environment variables and .env (also known as dotenv) files. Values can also be provided to the constructor of each module.

Configuration parameters

MBED_CLOUD_SDK_API_KEY

The user's API key for accessing this instance of Pelion Device Management.

MBED_CLOUD_SDK_HOST

The fully qualified url of the host serving the Pelion Device Management api (scheme, hostname, port, base path). The schema and hostname are required. For example:

https://api.us-east-1.mbedcloud.com
https://my-deployment.net/mbed-api/

Usage in Node.js (CommonJS modules)

To use a specific repository in Node.js:

Import the repository from mbed-cloud-sdk.
Create a new instance of the repository.

For example, to list the first 10 devices:

import { DeviceRepository } from "mbed-cloud-sdk";

// create an instance of a device repository
const deviceList = new DeviceRepository()
    // List the first 10 devices in your Pelion DM account
    .list({ maxResults: 10 });

for await (const device of deviceList) {
    console.log(`Hello device ${device.name}`);
}

To use the top level SDK instance in Node.js:

Import the SDK from mbed-cloud-sdk.
Create a new instance of the SDK.

For example, to list the first 10 devices:

import { SDK } from "mbed-cloud-sdk";

// create an instance of the Pelion Device Management SDK
const deviceList = new SDK()
    .foundation()
    .deviceRepository()
    // List the first 10 devices in your Pelion DM account
    .list({ maxResults: 10 });

for await (const device of deviceList) {
    console.log(`Hello device ${device.name}`);
}

Usage in browser (RequireJS/AMD modules, Vanilla JS/SPAs)

The files in the bundles folder are standalone modules following the UMD specification, so you should be able to use them without any further installation or modification.

Include the JavaScript bundle you need on your page from the bundles folder. For example:

<script src="<pelion-dm-sdk>/bundles/sdk.min.js"></script>

<script src="<pelion-dm-sdk>/bundles/foundation/device.min.js"></script>

If you are using VanillaJS, the bundles are then accessible through the global Mbed.Cloud namespace. For example, to list all connected devices:

var sdk = new Mbed.Cloud.SDK({
    apiKey,
});

sdk.foundation()
    .deviceRepository()
    // List the first 10 devices in your Pelion DM account
    .list({ maxResults: 10 })
    .all()
    .then(deviceList => console.log(deviceList));

Otherwise, you should be able to load the bundles by using an AMD framework such as RequireJS.

Warning: It is not advisable to embed your API key into distributed code such as client-side web pages. For production scenarios, developers may want to consider using Node.js for all API calls or to proxy client-side code requests to inject the API key. You can find an example proxy server in the examples folder.

Examples

Please refer to the examples folder for some node and web examples.

Documentation