注意
Pelion社のDevice Managementサービスは、IZUMA NETWORKSに買収されました。
https://www.izumanetworks.com/press/releases/10-4-22/
この記事は、旧Pelion Device Managementサービス上でのみ動作確認を行った時の内容なので、現在のサービスでは動作しない可能性があります。ご了承ください。
この記事では、ウェブアプリからPelion Device Managementサービスを使用する方法を説明します。接続されたデバイスの管理や、デバイス上のセンサーからデータを取得することが出来ます。
Pelion Device Management については、以下の記事もご覧ください。
Pelion Device Management を使う【導入編】
https://qiita.com/toyowata/items/5a9b1427399aff17d501
Pelion Device Management REST API
Pelion Device Management は、各種外部サービスやアプリケーションとREST APIを通じて柔軟に接続できるインターフェースを提供しています。
提供するデバイス接続サービス、ファクトリープロビジョニングサービス、ファームウェアアップデートサービスは全てREST APIを通じて使用することが可能です。
REST API の使用例
REST API は、cURL コマンドで簡単に動作を確認することができます。ここでは、入力を簡略化するために環境変数に必要な情報を設定して試してみます。
APIキーの生成方法は、こちらを参照してください。
$ export MY_API_KEY="Authorization: Bearer ak_xxxxxxxxxxxxxx” # 自分のアカウントのAPIキー
デバイスのリスト表示
$ curl https://api.us-east-1.mbedcloud.com/v3/devices/ -H "${MY_API_KEY}" | python -m json.tool
登録されているデバイスの表示
$ curl https://api.us-east-1.mbedcloud.com/v3/devices?filter=state__eq=registered -H "${MY_API_KEY}" | python -m json.tool
各種統計情報の表示例
$ curl -X GET -H "${MY_API_KEY}" "https://api.us-east-1.mbedcloud.com/v3/metrics?include=transactions,total_count&start=20180301&end=20180405&interval=1d" | python -m json.tool
この様にコマンドラインから簡単にデバイス情報を取得できるAPIが用意されています。
さらにインタラクティブにAPI動作を確認する
上記の例では、単一のHTTPリクエストを使ってレスポンスから情報を得るだけですが、実際にはNotificationチャネルを張って、デバイスからのレスポンスを非同期で受け取るAPIが多く使用されます。
ウェブブラウザ上からこれらのService APIを使って、Pelion Device Managementサービスに接続されたデバイスのリソースにアクセスしたり、デバイスを管理機能を確認することが出来ます。
以下のページでService APIの動作を確認することができます。
https://toyowata.github.io/Pelion-device-e2e-example/
このページのソースコードは、こちらです。
https://github.com/toyowata/Pelion-device-e2e-example/tree/gh-pages
ウェブアプリのサンプルコード
Service APIを使用したウェブアプリのサンプルも用意されています。このウェブアプリでは、デバイスの一覧表示と各種情報、センサーからのデータをグラフ化して表示しています。
【データ表示の例】
このページのソースコードは、こちらです。
https://github.com/ARMmbed/pelion-quick-start-web-app
以上です。
その他の情報
Pelion Device Managementを使う【導入編】
https://qiita.com/toyowata/items/5a9b1427399aff17d501