sakura.io体験ハンズオン 20180228
•
0 gefällt mir•3,488 views
※本資料は2018/02/28更新のものとなります。最新版へのリンクは以下スライドの説明をご確認ください。 https://www.slideshare.net/sakura_pr/sakuraio-handson/ 各地で開催されているさくらインターネットが提供するIoTプラットフォーム「sakura.io」のハンズオンでの資料となります。 本資料ではIoTデバイスのプロトタイピングを想定した「マイコンおよびプログラムの構築」「sakura.ioの設定」「Webサービス連携」の手順をスライドでご覧いただけます。 サービス詳細は以下をご確認ください。 https://sakura.io/
Empfohlen
Weitere ähnliche Inhalte
Was ist angesagt?
Was ist angesagt? (20)
Ähnlich wie sakura.io体験ハンズオン 20180228
Ähnlich wie sakura.io体験ハンズオン 20180228 (20)
Mehr von さくらインターネット株式会社
Mehr von さくらインターネット株式会社 (20)
Kürzlich hochgeladen
Kürzlich hochgeladen (8)
sakura.io体験ハンズオン 20180228
- 1. sakura.io 体験ハンズオン 2018/2/28 (C) Copyright 1996-2018 SAKURA Internet Inc さくらインターネット株式会社 IoT Platform Team
- 2. 2 はじめに
- 3. 本ワークショップの目的 3 1. 本ハンズオンはsakura.ioを使用し、組込み系エンジニアおよび Web/アプリ開発系のエンジニアがご自身のスキルセットを 大きく超えることなく、Internet of Things(IoT)に挑戦できることを 体験いただくものです。 2. そのため各章内で技術的な詳細は極力省略しております。 3. 今回は1人1つワークショップキットをご用意しておりますが、 組込みやWeb/アプリ開発に詳しい方がいらっしゃいましたら、 ご不明点を積極的にフォローしあって進めていただければと思います。
- 4. 本内容で使用するツール、機材、参考情報まとめ sakura.ioコントロールパネル https://secure.sakura.ad.jp/iot/ Arduino https://www.arduino.cc/en/Main/Software Arduinoサンプル用スケッチ（basic-HDC1000-with-LED.ino） https://github.com/sakuraio/handson-sample/blob/master/arduino/basic-HDC1000-with-LED.ino さくらのクラウドコントロールパネル https://secure.sakura.ad.jp/cloud/ Node-REDサンプル用スケッチ（basic-graph-and-control-with-tweet.json） https://github.com/sakuraio/handson-sample/blob/master/node-red/basic-graph-and-control-with-tweet.json ［参考］sakura.ioサービスサイト https://sakura.io/ ［参考］sakura.io開発者向けページ https://sakura.io/developer/ ［参考］sakura.ioモジュール＆オプションのご購入 https://sakura.io/product/ ［参考］その他物品のご購入（秋月電子通商） ・温湿度センサ（SHT31） http://akizukidenshi.com/catalog/g/gK-12125/ ・抵抗内蔵LED http://akizukidenshi.com/catalog/g/gI-06245/ ・ジャンパコード http://akizukidenshi.com/catalog/g/gC-05159/ ・Arduino Uno Rev3 http://akizukidenshi.com/catalog/g/gM-07385/ ・ACアダプター http://akizukidenshi.com/catalog/g/gM-07772/ ・ブレッドボード http://akizukidenshi.com/catalog/g/gP-05294/ 4
- 6. Agenda 6 1. Webサービス連携（さくらのクラウド） ₋ Node-REDサーバ用インスタンスの作成 2. sakura.ioの設定 ₋ プロジェクトの作成 ₋ sakura.ioモジュールの登録 ₋ 連携サービスの設定 3. マイコンおよびプログラムの構築 ₋ マイコン（Arduino）による開発環境の準備 ₋ 温湿度センサおよびsakura.ioモジュールの繋ぎ込み ₋ 試験用プログラムの流し込み ₋ 【参考】デバイスから送信されたデータの確認 4. Webサービス連携（さくらのクラウド） ₋ Node-REDでWebSocketを利用したデータ連携フロー作成 ₋ 動作確認
- 9. さくらのクラウド コントロールパネル ログイン（さくらインターネット会員） 9 さくらのクラウドコントロールパネル（ https://secure.sakura.ad.jp/cloud/ ）にログインします。 ［ さくらインターネット会員としてログイン： ］に会員ID、パスワードを入力してログインできます。 会員IDをお持ちでない場合はご契約のサービスがない場合でも、さくらインターネット会員登録 （ https://secure.sakura.ad.jp/signup3/member-register/input.html ）から作成いただくことができ ます。
- 10. 【参考】会員IDの作成 10 会員IDをお持ちでない場合はご契約のサービスがない場合でも、さくらインターネット会員登録 （ https://secure.sakura.ad.jp/signup3/member-register/input.html ）から作成いただけます。 会員登録が完了すると、指定したメールアドレスに support@sakura.ad.jp より以下のメールが 送信されます。会員IDおよびパスワードは重要な情報となりますので、漏れないよう大事に保管ください。 Title：会員登録完了のお知らせ [XXX00000] ─────────────────────────────────── このメッセージはさくらインターネット会員登録フォームより 自動送信されています。このメールに心当たりのない場合は support@sakura.ad.jpまでご連絡ください。 ─────────────────────────────────── さくらインターネット株式会社 様 (ご担当者: さくら 太郎 様) この度は、さくらインターネットに会員登録いただきまして誠に ありがとうございます。 以下の通り会員登録を受付ましたので、ご連絡させていただきます。 ============================================================= ◎ 会員登録情報 会員ID ： XXX00000 ご契約者名 ： さくらインターネット株式会社 様 (ご担当者: さくら 太郎 様) 電子メール ： XXX@XXX.XX.XX ============================================================= ～～～以下省略～～～
- 11. さくらのクラウド コントロールパネル ログイン 11 さくらインターネット会員としてログインするとアカウントの選択を求められるため、利用するアカウント を選択します。アカウントを作成していない場合は上記［ アカウント ］タブからアカウントとユーザを作 成する必要があります。
- 12. 【参考】さくらのクラウド コントロールパネル ログイン（アカウント作成） 12 ［ アカウント ］タブから【 アカウントの作成 】をクリックすると、アカウントの作成画面に遷移します。 各種同意、および必要な情報を入力いただいたうえで作成をクリックいただくと該当のアカウントおよび ユーザーが作成されます。
- 13. 【参考】さくらのクラウド コントロールパネル ログイン（さくらのクラウドユーザ） 13 ユーザが作成されている場合、ユーザとしてログインすることも可能です。 さくらのクラウドコントロールパネル（ https://secure.sakura.ad.jp/cloud/ ）にログインします。 「さくらのクラウドユーザとしてログイン：」に前述のユーザコード、会員ID、パスワードを入力します。 ユーザコードは会員IDの管理者によって作成、割り当てされるものとなります。
- 17. Node-REDサーバの作成 17 ［ 1.サーバプラン ］では仮想サーバに割り当てるCPUとメモリの量を指定します。 仮想コアは【 1 】を、メモリは【 1GB 】を、それぞれ選択します。 選択/入力 任意 選択/入力 必須
- 18. Node-REDサーバの作成 18 ［ 2.ディスク ］では使用するディスクの種類やサイズ、インストールイメージを選択します。 アーカイブ選択のみ【 CentOS 7.x 64bit #xxxxxxxxxxxx 】を選択し、後はデフォルトとします。 選択/入力 任意 選択/入力 必須
- 19. Node-REDサーバの作成 19 ［ 3.NIC ］ではネットワークに関する設定を指定します。 今回はすべてデフォルトの値を使用しますので変更は不要です。 選択/入力 任意 選択/入力 必須
- 20. Node-REDサーバの作成 20 ［ 4.ディスクの修正 ］ではOSに関する設定値を指定します。今回はサーバ設定は行わないため、今回は特 にパスワードを設定しません。ホスト名は自動生成されますが、必要に応じて【任意の名前】を入力します。 公開鍵は今回のハンズオンでは使用しないため、デフォルトの【 なし 】を使用します。 選択/入力 任意 選択/入力 必須 空欄 空欄
- 21. Node-REDサーバの作成 21 ［ スタートアップスクリプト ］で【 shell 】を選択のうえ、［ 配置するスタートアップスクリプト ］から 【 [public] Node-RED #xxxxxxxxxxx 】を選択します。オプションの［ WebUIポート番号 ］欄には 【 80 】を入力します。［ ログインID ］および［ ログインパスワード ］には任意の値を指定してください。 ログインIDとログインパスワードは後ほど使いますのでメモをしておいてください。 選択/入力 任意 選択/入力 必須 80 自分の名前等 パスワード ※ 実際に運用する際は、大文字小文字数字記号などを 織り交ぜたパスワードを指定してください。
- 22. Node-REDサーバの作成 22 ［ 5.シンプル監視 ］はさくらのクラウドで提供する死活監視のサービスとなります。 本件では使用しないため、デフォルトのチェックなしで進めます。 選択/入力 任意 選択/入力 必須
- 23. Node-REDサーバの作成 23 ［ 6.サーバの情報 ］はコントロールパネル上で管理するための情報を記述する項目となります。 未記入の場合は自動で生成されますが、必要に応じて名前に判別がつくような任意の値を入力します。 選択/入力 任意 選択/入力 必須
- 24. Node-REDサーバの作成 24 ［ 7.その他のオプション ］および［ 作成数 ］はすべてデフォルトの値を使用します。 内容を確認し、問題がなければ右下の【 作成 】をクリックします。 選択/入力 任意 選択/入力 必須
- 26. Node-REDサーバの作成 26 サーバ作成のステータスが成功に遷移した時点でサーバのIPアドレスを確認することができます。 コントロールパネル左側ペインの【 サーバ 】をクリックすると作成済みサーバの一覧が表示されますので、 最右部の【 ▼ 】をクリックするか、該当サーバの行の右クリックから【 IPアドレスをコピー 】を クリックすると該当サーバのIPアドレスをコピーすることができます。 Node-REDサーバのIPアドレスは後ほど使いますので、作成が完成したらメモしてください。 ***.***.***.*** ***-****-*****
- 28. 28 sakura.ioの設定
- 30. sakura.io コントロールパネル ログイン 30 sakura.io コントロールパネル（ https://secure.sakura.ad.jp/iot/ ）にログインします。 Google等でサービスサイト（ https://sakura.io/ ）にアクセスし、右上の【ログイン】をクリックします。
- 32. プロジェクトC プロジェクトB sakura.ioコントロールパネルにおける考え方 32 sakura.ioでは【プロジェクト】という単位で大枠を構成し、プロジェクト内に複数の【モジュール】、 【連携サービス】を紐付けていきます。 【データストア】や簡易位置情報、ファイル配信といった 【オプションサービス】はプロジェクトに対して一つもしくは1セット設定することができます。 プロジェクトA モジュール1 uAAAAAAAAAA モジュール2 uBBBBBBBBBB モジュール3 uCCCCCCCCCC データストア Light/Standard/… 簡易位置情報 ON/OFF 連携サービス1 WebSocket 連携サービス2 Outgoing Webhook ファイル配信 File1/File2/… 連携サービス3 AWS IoT プロジェクトに対して 複数紐付け可能 プロジェクトに対して 単一（1セット）設定可能 プロジェクトに対して 複数紐付け可能
- 33. 約款への同意 33 初めてコントロールパネルにログインした場合、各種約款への同意を求められます。 内容をご確認いただいたうえで、［ 同意する ］をクリックするとコントロールパネルにアクセスできます。
- 35. プロジェクトの作成 35 新規プロジェクトの作成画面に遷移します。 ［ 名称 ］欄に任意の名前を入力し、【 追加 】をクリックします。 自分の名前を入れて作成して、メモしてください
- 38. モジュールの登録 38 モジュールの追加に成功すると［ モジュールを追加しました ］というダイアログが表示されます。 ［ ホームへ戻る ］ボタンをクリックしてホームに戻ります。 ID/PASSが正しくない、もしくは既に登録されているモジュールを追加しようとした場合は 内容とともに［ モジュールの追加に失敗しました ］というダイアログが表示されます。 登録が成功した場合 登録が失敗した場合 u*********** 登録用ID / 登録用パスワードのいずれかに誤りがあります、再度ご確認ください 別の会員IDに登録されています、過去登録した会員IDにログインし解除ください
- 41. 連携サービスの設定（WebSocket） 41 WebSocketの作成には特に設定事項はありません。 ［ 名前 ］欄に任意の名前を入力し、【 作成 】ボタンをクリックします。
- 46. 今回のワークショップでご提供するもの 46 ジャンパーコードsakura.ioモジュール（アンテナ付） +Arduino用シールド＆Arduino Uno Rev3 USB2.0 ケーブル（A-B） 12W級 9V-1.3A ACアダプタ ブレッドボード 人感センサ （SB412A） 照度センサ （GL5537-2） 温湿度センサ （HDC1000 or SHT31） 各種抵抗 ※必要に応じてご提供 タクトスイッチ ※必要に応じてご提供 抵抗入りLED ※必要に応じてご提供 本日は使用しません
- 47. Arduino IDEのセットアップ 47 https://www.arduino.cc/en/Main/Softwareから開発環境（Arduino IDE）を入手します。 2018/2/27時点での最新版は［ 1.8.5 ］となります。 環境がWindowsの場合は【 Windows Installer 】、Macの場合は【 Mac OS X 10.7 Lion or newer 】を 選択します。
- 48. Arduino IDEのセットアップ 48 該当の金額を選択するか（寄付する場合）、もしくは【 JUST DOWNLOAD 】にてダウンロードします。
- 50. sakura.ioモジュールの取り付け 50 ArduinoシールドをArduino Unoのピン穴と合致するようにはめ込みます。(ハンズオンでは接続済み) Arduino IDEを起動し、Arduino UnoにACアダプタとUSBケーブルを図のように接続します。 コンセントへ パソコンへ （USB Type-A）
- 51. Arduino IDEのセットアップ 51 上部メニューバーからボードと、シリアルポートを設定します。 ボード:［ ツール ］→［ ボード:”XXX” ］から【 Arduino/Genuino Uno 】を選択します。 シリアルポート:［ ツール ］→［ シリアルポート ］から【 COMx (Arduino/Genuino Uno) 】を選択します。 Mac環境の場合はCOMポートではなく、【 /dev/… (Arduino/Genuino Uno) 】を選択します。 ボードの選択 シリアルポートの選択
- 52. マイコン（Arduino）の準備 52 ［ ファイル ］→［ スケッチ例 ］→［ 01.Basics ］→［ Blink ］を選択し、Blinkスケッチを表示します。 【 】をクリックしてスケッチをマイコンに書き込み、該当のLEDが点滅状態になることを確認します。 何らかの問題があった場合、スケッチ下部にオレンジ色のエラーが表示されます。
- 53. ライブラリの取得（温湿度センサ-HDC1000利用の場合） 53 ［ スケッチ ］→［ ライブラリをインクルード ］→［ ライブラリを管理... ］をクリックし、 右上検索窓から【 hdc1000 】を検索すると、［ HDC1000 by Yuichi Tateno ］がヒットします。 【 インストール 】をクリックすると該当ライブラリが取り込まれ、［ INSTALLED ］が表示されます。 ※本作業はセンサにHDC1000を利用している場合のみ実施します。
- 54. ライブラリの取得（温湿度センサ-SHT31利用の場合） 54 ［ スケッチ ］→［ ライブラリをインクルード ］→［ ライブラリを管理... ］をクリックし、 右上検索窓から【 SHT31 】を検索すると、［ Adafruit SHT31 Library by Adafruit ］がヒットします。 インストールをクリックすると該当ライブラリが取り込まれ、［ INSTALLED ］が表示されます。 ※本作業はセンサにSHT31を利用している場合のみ実施します。
- 55. ライブラリの取得（SakuraIO） 55 ［ スケッチ ］→［ ライブラリをインクルード ］→［ ライブラリを管理... ］をクリックし、 右上検索窓から【 sakuraio 】を検索すると、［ SakuraIO by SAKURA Internet Inc. ］がヒットします。 最新のVer.を選択のうえ【 インストール 】をクリックすると該当ライブラリが取り込まれ、 ［ INSTALLED ］が表示されます。
- 56. FirmwareUpdate.ino 56 ［ ファイル ］→［ スケッチ例 ］→［ SakuraIO ］→［ FirmwareUpdate ］を選択し、【 】クリックで 該当のスケッチを書き込みます。［ ツール ］→［ シリアルモニタ ］もしくは【 】クリックで アップデート状況を確認します。現在のVersion情報と比較し、新しいファームウェアが提供されている 場合にはアップデートを実行します。 新しいファームウェアが存在する場合 最新のファームウェアが適用されている場合 ※PCからの給電が不安定/不足している場合は ［ Update Failure ］ と表示され、アップデートが 失敗する場合があります。その場合、電源アダプタを接続し、再度スケッチを書き込みます。
- 61. 温湿度センサ（HDC1000/SHT31）の繋ぎ込み 61 図に従い温湿度センサの向きに注意して配線します。（実際にはArduinoシールドに対して配線します） ブレッドボード側は色で明示された位置であれば、自由に接続しても問題ありません。 温湿度センサ側のRDY/ADRピンは今回は使用しないため、何も配線しません。 ＜凡例＞ D5 SDA SCL D6 GND D7 3.3V RDY/ADR GND SCL SDA 3.3V GND GND GND Digital 6 Digital 5 Digital 7 ※本作業はセンサにHDC1000を利用している場合のみ実施します。
- 62. 温湿度センサの動作確認（温湿度センサ-HDC1000利用の場合） 62 ［ ファイル ］→［ スケッチ例 ］→［ HDC1000 ］→［ hdc1000 ］を選択し、【 】クリックで 該当スケッチを書き込みます。その後［ ツール ］→［ シリアルモニタ ］もしくは【 】クリックで Temp＆Humi情報が取得できることを確認します。 ※問題があった場合、オレンジ色のエラーが表示されます。 ※本作業はセンサにHDC1000を利用している場合のみ実施します。
- 63. ［ ファイル ］→［ 新規ファイル ］で新しいスケッチを表示し、下記URLの内容をスケッチにコピー＆ ペーストします。 【 】をクリックし、［ ツール ］→［ シリアルモニタ ］もしくは【 】クリックで シリアル値、Temp、Humi情報に加え、シリアル値と送信キュー情報が取得できることを確認します。 【 https://github.com/sakuraio/handson-sample/blob/master/arduino/basic-HDC1000-with-LED.ino 】 試験用プログラムの流し込み（温湿度センサ-HDC1000利用の場合） 63 ※問題があった場合、オレンジ色のエラーが表示されます。 ※本作業はセンサにHDC1000を利用している場合のみ実施します。
- 64. 試験用プログラムの流し込み（温湿度センサ-HDC1000利用の場合） 64 キーボードで【 Ctrl + A 】ですべてを選択 →【 Ctrl +C 】でコピーします Githubの該当するサンプルスケッチページで【 Raw 】をクリックし、 キーボードで【 Ctrl + A 】ですべてを選択して、【 Ctrl +C 】でコピーします。
- 65. ［ ファイル ］→［ 新規ファイル ］で新しいスケッチを表示し、下記URLの内容をスケッチにコピー＆ ペーストします。 【 】をクリックし、［ ツール ］→［ シリアルモニタ ］もしくは【 】クリックで シリアル値、Temp、Humi情報に加え、シリアル値と送信キュー情報が取得できることを確認します。 【 https://github.com/sakuraio/handson-sample/blob/master/arduino/basic-SHT31-with-LED.ino 】 試験用プログラムの流し込み（温湿度センサ-SHT31利用の場合） 65 ※問題があった場合、オレンジ色のエラーが表示されます。 ※本作業はセンサにSHT31を利用している場合のみ実施します。
- 66. 試験用プログラムの流し込み（温湿度センサ-HDC1000利用の場合） 66 キーボードで【 Ctrl + A 】ですべてを選択 →【 Ctrl +C 】でコピーします Githubの該当するサンプルスケッチページで【 Raw 】をクリックし、 キーボードで【 Ctrl + A 】ですべてを選択して、【 Ctrl +C 】でコピーします。
- 68. 【参考】デバイスから送信されたデータの確認 68 サービス連携の編集画面の下部にデバイスから送信されたデータがリアルタイムで表示されます。 簡易表示モードではモジュールから受け取ったデータを以下のように確認できます。 u*********** → 温度 → 湿度 → カウント 値 モジュール： データを送信した モジュールのID チャンネル データが格納された チャンネル番号 時刻： データがモジュールのキューに 格納された時刻のタイムスタンプ 値： 送信された値 型： データの型式 u*********** u*********** u*********** u*********** u***********
- 69. 【参考】デバイスから送信されたデータの確認 69 ［ 詳細表示モードに切り替え ］をクリックすると詳細表示モードに遷移します。 モジュールは同一ですが、データの内容によりタイプやペイロードが異なります。 チャンネルごとの最終到着データ： 各チャンネルに届いた最終の Valueを表示 クリックでログ 出力を開始/停止 タイプ： プラットフォームからの内容に応じて、 いくつかの種類に分かれる ・channels ：モジュールからのデータ ・connection ：接続の開始/終了 ・location ：簡易位置情報 ・keepalive ：WebSocketセッション確認 ペイロードには受け取った データのpayload部が表示 時刻： 詳細表示モードではプラット フォームで該当のメッセージ を受け取ったタイムスタンプ u*********** u*********** u***********
- 72. Node-REDサーバの作成 72 Webブラウザで【 http://<サーバのIPアドレス>:<指定したWeb UIポート番号>/ 】にアクセスします。 サーバ作成時にオプションの［ Node-REDのWebUIポート］に【 80 】を指定した場合はポート番号を 省略することができます。 なおサーバを示す行を右クリックもしくは行最右部にある 【 ▼ 】 をクリックすることで簡単にIPアドレス をコピーすることができます。 ***.***.***.*** ***-****-***** ************
- 73. Node-REDサーバにログイン 73 自分の名前等 パスワード アクセスに成功すると、認証画面が表示されます。［ Username ］欄と［ Password ］欄それぞれに、 サーバを作成した際に指定した【 Node-REDのログインID 】と【 Node-REDのログインパスワード】を 入力し、【 ログイン 】をクリックします。
- 76. Node-RED WebSocketノードの作成 76 まずはWebSocketからのデータを受け取るノードを追加します。 ノードパレットの入力から［ websocket ］ノードをシートにドラッグ&ドロップします。
- 77. Node-RED WebSocketノードの作成 77 ドラッグ&ドロップされたWebSocketノードをダブルクリックし、設定画面に移ります。 種類は【 接続 】、名前は【 sakuraio-websocket 】（任意の名前）を入力のうえ、URLは 【 新規にwebsocket-clientを追加... 】を選択した状態で、URLの行にある【 】をクリックします。 sakuraio-websocket
- 78. Node-RED WebSocketノードの作成 78 ［ URL ］欄には、sakura.ioのコンパネからのWebSocketの［ URL ］欄の情報をペーストします。 ［ TLS設定 ］は、デフォルトで選択されている【 新規にtls-configを追加... 】のまま、［ 送信/受信 ］ はデフォルトで定義されている【 ペイロードを送信/受信 】を選択し、【 追加 】をクリックします。
- 79. Node-RED WebSocketノードの作成 79 指定する［ URL ］の値は、コンパネの連携サービスで確認できる赤枠部分となります。 赤枠部分の情報をコピーして、WebSocketノードのURL部分にペーストします。 URLの末尾と、Tokenは同一の文字列となりますので、Token情報は不要です。 ************************************ ************************************
- 80. ************* Node-RED WebSocketノードの作成 80 【 完了 】 をクリックするとwebsocket inノードへ設定が反映され、不備がない場合は右隅の三角マークが 消えます。これでWebSocketノードへの設定が反映されましたが、この時点ではsakura.ioからデータは 入ってきていません。続いてはデータを表示するためのDebugノードを作成します。
- 81. Node-RED Debugノードの作成 81 次に、ノードパレットの出力から［ debug ］ノードをシートにドラッグ&ドロップします。 Debugノードは自動で［ msg.payload ］に名前が変わります。特に設定は不要です。
- 83. Node-RED フローのデプロイ 83 各ノードを接続し、準備が完了したら、右上部の 【 デプロイ 】 をクリックします。 デプロイが完了するとデプロイボタンがグレーアウトされ、設定した内容を元に処理が開始されます。 併せて、debugノードからの情報を確認するため、コンソールの 【 デバッグ 】 タブをクリックします。
- 85. Node-RED フローサンプルの紹介 85 次にサンプルのフローを利用するために、必要なノードをサーバに追加します。Node-RED右上の ［ メニュー（ ）］から【 パレットの管理 】を選択し、【 ノードを追加 】タブの検索窓から 【 node-red-dashboard 】でヒットしたノードを追加します。確認に対しては【 追加 】を選択します。
- 86. コピーしたJSONをペースト Node-RED フローサンプルの紹介 86 サンプルのフローをシート上に展開します。Node-RED右上の［ メニュー（ ）］から ［ 読み込み ］→【 クリップボード 】を選択し、下記URLの内容をペーストのうえ、【 読み込み 】 をクリックすると、記載されたJSONの内容に基づき、シートに新たにフローが作成されます。 【 https://github.com/sakuraio/handson-sample/blob/master/node-red/basic-graph-and-control-with-tweet.json 】
- 87. Node-RED フローサンプルの紹介 87 Githubの該当するサンプルフローページで【 Raw 】をクリックし、 キーボードで【 Ctrl + A 】ですべてを選択して、【 Ctrl +C 】でコピーします。 キーボードで【 Ctrl + A 】ですべてを選択 →【 Ctrl +C 】でコピーします
- 88. Node-RED フローサンプルの紹介 88 用意されたフローはほぼ構成は済んでおり、以下の2ヶ所のみを設定、デプロイすることで動作します。 最下部に［ デバイスの制御 ］のサンプルフローもありますが、こちらの設定は後述いたします。 Websocketノード（sakuraio_in） ： 種類を【 接続 】、URLは先程指定したものを再度設定 twitterノード（Tweet） ： Twitterのアカウント認証＆指定 ※オプション 文字列として受け取った JSONデータの変換 モジュールからの データのみを通過 温度（ch0）データだけを抽出 湿度（ch1）データだけを抽出 /ui/ にグラフとして可視化 文章を生成（実行後10分待機） ../ui/ でグラフとして可視化 【オプション】Twitterアカウントを設定 WebSocketを再度設定
- 89. Node-RED フローサンプルの紹介（GUI表示＆Twitter連携 - WebSocket設定） 89 作成されたWebSocket inノードをダブルクリックし、設定画面に移ります。先程の手順と同様、 種類は【 接続 】、名前は【 任意の名称 】を入力します。 なお、URLは過去設定したものがある場合、ドロップダウンで指定することができます。 全て設定したら【 完了 】をクリックします。 先ほど設定したものを選択します wss://api.sakura.io/ws/v1/*******
- 90. Node-RED フローサンプルの紹介（GUI表示＆Twitter連携 – Twitter設定） 90 Twitterノードを設定のうえデプロイすると、［ メッセージ化 ］ノードに記載された文章中にその時 取得した温度センサの情報が埋め込まれた状態で該当Twitterアカウントにメッセージが投稿されます。 ［ メッセージ化 ］ノードの内容を書き換えることで任意の文章に変更することができます。 こちらを省略する場合はTweetノードをクリックのうえ、Deleteを押して削除してください。 ********** ********** ********** Node-REDデバッグタブでの表示 Twitter投稿内容
- 91. Node-RED フローサンプルの紹介（GUI表示＆Twitter連携 – Twitter設定） 91 Tweetノードをダブルクリックし、［ Twitter ID ］行の【 】マークをクリックし、 案内されるTwitterアカウント認証画面に進みます。
- 92. Node-RED フローサンプルの紹介（GUI表示＆Twitter連携 – Twitter設定） 92 認証画面は利用しているブラウザでログインしているかどうかで画面遷移が異なります。 それぞれ必要な項目を入力 or 確認したうえで【 連携アプリを認証 】をクリックすると ［ Authorised ］の表記とともに認証された旨表示されますので、案内に従いウィンドウを閉じます。 まだログインしていない場合 既にログインしている場合
- 93. Node-RED フローサンプルの紹介（GUI表示＆Twitter連携 – Twitter設定） 93 認証が成功しているとTwitter ID欄に認証したアカウントのIDが入力されています。 問題なければ 【 追加 】 および 【 完了 】 をクリックし、設定を完了します。 フローをデプロイするとTwitterへの連携が実行されます。 ******** ********
- 94. Node-RED フローサンプルの紹介（GUI表示＆Twitter連携） 94 【 http://<IPアドレス>:<指定したWeb UIポート番号>/ui/ 】にアクセスするか、［ dashboard ］の 【 】をクリックすると、取得した情報に応じてリアルタイムに変化するグラフやゲージを確認すること ができます。また、［ dashboard ］の【 Theme 】をクリックすると、UIのカラーリングを変更できます。
- 96. Node-RED フローサンプルの紹介（デバイス制御 – モジュールIDの指定） 96 サンプルを読み込んだだけではボタン押下によるLED制御は実行されません。 これは生成されるJSONデータに組んだデバイスのモジュールIDが指定されていないためとなります。 次にfunctionノードを設定し、対象となるデバイスにWebSocket経由で制御信号が送信されるようにします。 JSONデータに埋め込む モジュールIDを定義 デプロイ時に自動実行 制御用JSONデータ生成 （変数context.global.xxxにセット）
- 97. Node-RED フローサンプルの紹介（デバイス制御 – モジュールIDの指定） 97 作成されたfunctionノード（moduleID_set）をダブルクリックし、設定画面に移ります。 コード2行目の【 %%moduleID%% 】をsakura.ioのコントロールパネルで確認できる モジュールID（uから始まる12桁の文字列）に変更し、【 完了 】をクリックします。
- 98. Node-RED フローサンプルの紹介（デバイス制御 – モジュールIDの指定） 98 【 %%moduleID%% 】 から差し替える値は、先程sakura.ioのコントロールパネルでプロジェクトに 表示されていたuから始まる12桁の文字列となります。 u********** *
- 99. Node-RED フローサンプルの紹介（デバイス制御 – モジュールIDの指定） 99 最後にWebSocket outノードを設定し、対象となるsakura.ioのWebSocketに制御信号が埋め込まれた JSONデータが送信されるようにします。 各ノードの実行（テスト用） 該当WebSocket URLに JSONデータを送信 ../ui/ でボタンとして表示
- 100. Node-RED フローサンプルの紹介（デバイス制御 – モジュールIDの指定） 100 作成されたWebSocket outノードをダブルクリックし、設定画面に移ります。先程の手順と同様、 種類は【 接続 】、名前は【 任意の名称 】を入力します。 URLは過去設定したものがある場合、ドロップダウンで指定することができます。 全て設定したら【 完了 】をクリックします。 wss://api.sakura.io/ws/v1/********
- 102. 102 参考 サンプルスケッチ
- 103. 【参考】AlphaCompat.ino 103 さくらのIoT Platform α にて提供していたスケッチ（SakuraAlpha_I2C.ino）を置き換えた プログラムです。一定間隔でカウント値を0,1,2のチャンネルに書き込み、送信します。
- 105. 【参考】Shell.ino 105 構文 【version】現在のファームウェアバージョンを表示する 出力結果 version >version v1.0.0-161109-c566dba 備考
- 108. 【参考】Shell.ino 108 構文 【sqi】モジュールの電波強度を確認する 出力結果 sqi >sqi 5 備考 電波強度は5を最大として強度に伴い数値が下がり、0は圏外であることを示します。
- 110. 【参考】Shell.ino 110 構文 【update】ファームウェアのアップデートを実行する 出力結果 update >update Current Version: v1.0.0-161109-c566dba Unlock Starting update Waiting for update . 備考
- 112. 【参考】Shell.ino 112 構文 【enqueue】送信キューにデータを格納する 出力結果 enqueue <ch> <type> <value> >enqueue 0 i 123 > 備考 シリアルモニタに実行結果は表示されません。 enqueueコマンドを実行すると登録したデータは送信キューに貯められます。 送信キューは最大で32個まで蓄積され、超過したキューは貯められず破棄されます。
- 114. 【参考】Shell.ino 114 構文 【size】送信/受信キューに貯められたデータ数を確認する 出力結果 size >size Tx Queue Avail: 32 Queued: 0 Rx Queue Avail: 32 Queued: 0 備考 Tx Queue は送信キュー、Rx Queue は受信キューを表します。 Availは利用可能数、Queuedは貯められているキューの数を表します。
- 120. 120 参考 DataStore API
- 121. 【参考】連携サービスの設定（DataStore API） 121 sakura.ioでは、蓄積データの活用として 【 DataStore API 】 を提供します。 追加サービスの選択画面で ［ DataStore API ］ をクリックします。
- 122. 【参考】連携サービスの設定（DataStore API） 122 追加サービスの選択画面で［ DataStore API ］をクリックします。 ［名前］は任意の名称を入力し、［ 作成 ］をクリックします。
- 123. 【参考】連携サービスの設定（DataStore API） 123 作成した連携サービスをクリックすると【 Token 】を確認することができます。 Tokenをコピーし、コンパネ右上の［ DataStore v1 Document ］をクリックします。 ****************************************
- 124. 【参考】連携サービスの設定（DataStore API） /channels の取得 124 ［ /channels ］は蓄積されたデータをチャンネル単位で取得します。単体のデータを複数の形式 （入力時の形式［ value ］、数値［ value_num ］、文字列［ value_str ］）で格納しているため、 単体でも価値のあるデータが活用しやすい形式となっています。 ［ /channels ］は該当URL（ https://api.sakura.io/datastore/v1/docs/ ）にて、 前述の【 Token 】情報、および以下のパラメータを指定することで任意の情報を取得できます。 【module】：モジュールのモジュールID 【size】：一度に取得するデータの数 【order】：昇順（ASC）と降順（DESC）指定 【cursor】：※後述※ 【after/before】：指定日時の以前と以後指定 【channel】：取得するチャンネル指定
- 125. 【参考】連携サービスの設定（DataStore API） /channels の取得 125 { "meta": { “count”: <取得した件数>, “cursor”: “<sizeで指定した件数を超えた場合に、次のレスポンスを取得するためのカーソル>”, “match”: <ヒットした件数> }, "results": [ { “channel”: <データが格納されているチャンネル>, “datetime”: “<データがモジュールのキューに格納された時間>”, “id”: “<送信されたデータのID>", “module”: “<データが送信されたモジュールのID>", “type”: “<送信されたデータの型式>", “value”: <typeで指定された型式でのデータ>, “value_num”: <number形式でのデータ>, “value_str”: “<string形式でのデータ>" }, { "channel": … ＃以下[channel］単位のデータがcount数分列挙 指定された条件を元に【 Try it out! 】をクリックすると、［ Response Body ］欄に条件に応じた データが返されます。またクリック後に返される［ Request URL ］から同様のデータを取得できます。
- 126. 【type】：取得するRMのtype指定 【参考】連携サービスの設定（DataStore API） /messages の取得 126 ［ /messages ］は蓄積されたデータをRM単位で取得します。RMに含まれる複数チャンネルの データの関係性が重要な場合に活用しやすい形式です。（鍵の「解錠者ID」と「入退室フラグ」等） また、［ /messages ］にはモジュールの接続および切断の情報も含まれています。 ［ /messages ］は該当URL（ https://api.sakura.io/datastore/v1/docs/ ）にて 以下のパラメータを指定することで任意の情報を取得できます。 【module】：モジュールのモジュールID 【size】：一度に取得するデータの数 【order】：昇順（ASC）と降順（DESC）指定 【cursor】：※後述※ 【after/before】：指定日時の以前と以後指定
- 127. 【参考】連携サービスの設定（DataStore API） /messages の取得 127 { "meta": { "count": <取得した件数>, "cursor": “<sizeで指定した件数を超えた場合に、次のレスポンスを取得するためのカーソル>”, "match": <ヒットした件数> }, "results": [ { “datetime”: “<対象のRMをプラットフォーム側で受信した時間>”, "id": “<格納されたRMのID>", "module": “<データが送信されたモジュールのID>", "payload": { "channels": [ { "channel": <データが格納されているチャンネル>, "type": “<送信されたデータの型式>", "value": <typeで指定された型式でのデータ> } ］ }, "type": "channels" }, { “datetime”: … ＃以下[message］単位のデータ 指定された条件を元に【 Try it out! 】をクリックすると、［ Response Body ］欄に条件に応じた データが返されます。またクリック後に返される［ Request URL ］から同様のデータを取得できます。
- 128. 128 最後に
- 129. 最後に ～sakura.io～ 129 ハンズオンに使用したsakura.ioモジュールは必要に応じて登録を解除します。 接続ステータス横の歯車マークをクリックします。 u***********
- 132. 最後に ～sakura.io～ 132 モジュールの登録が解除され、表示から削除されました。 次は連携サービスとともにプロジェクトを削除します。 プロジェクト右上の［削除］マークをクリックします。
- 134. 最後に ～さくらのクラウド～ 134 グローバルIPアドレスを持つサーバは攻撃対象になりますので、作成いただいたサーバは削除します。 サーバがまだ起動している場合、さくらのクラウドで対象サーバのチェックを入れ、 ［電源操作］から【 シャットダウン 】をクリックします。 ***.***.***.***
- 135. 最後に ～さくらのクラウド～ 135 シャットダウン対象を確認のうえ【 シャットダウン 】をクリックします。 再度ダイアログにて確認が表示されますので【 実行 】をクリックします。 ***.***.***.***************
- 136. 最後に ～さくらのクラウド～ 136 シャットダウンが正常に実行されると、チェックボックス横のラインが「緑→赤→灰」と遷移します。 ラインが灰色に変化したら、再度対象となるサーバにチェックを入れ、【 削除 】をクリックします。
- 137. 最後に ～さくらのクラウド～ 137 今回は［接続されたディスク］についても削除しますのでチェックを入れ、【 削除 】をクリックします。 ダイアログが表示されますので【 実行 】をクリックします。 ************ ***.***.***.*** ************
- 138. 最後に ～さくらのクラウド～ 138 削除の工程が表示されます。全てのステータスが成功となれば削除は完了です。 ********** ************ ***.***.***.***
- 141. モジュールを購入する 家に帰って同じ事をやるためには 141 さくらの会員IDを登録する モジュールは以下のURLから購入出来ます。 https://sakura.io/product/ ［参考］その他物品のご購入（秋月電子通商） ・温湿度センサ（SHT31） http://akizukidenshi.com/catalog/g/gK-12125/ ・抵抗内蔵LED http://akizukidenshi.com/catalog/g/gI-06245/ ・ジャンパコード http://akizukidenshi.com/catalog/g/gC-05159/ ・Arduino Uno Rev3 http://akizukidenshi.com/catalog/g/gM-07385/ ・ACアダプター http://akizukidenshi.com/catalog/g/gM-07772/ ・ブレッドボード http://akizukidenshi.com/catalog/g/gP-05294/ https://sakura.io/ にアクセスし、【会員登録はこちら】から、 会員IDを作成します。 コントロールパネルへアクセスする 以下のURLからアクセスします。 さくらのクラウド https://cloud.sakura.ad.jp/ sakura.io https://sakura.io 開発者向けドキュメント さらに詳しく、取扱説明書やデータ シートなどは、開発者向けドキュメン トを参考にしてください。 https://sakura.io/developer/
- 142. 最後に 142 さくらインターネットでは、「さくらクラブ」としてハンズオン等の イベントをともに開催いただける仲間（部員）を募集しています。 （テーマはIoTに限らずクラウドやVPS、スタートアップ系ネタもOK！） ご興味があれば、Come and join us & Feel free to contact me! 連絡先 ： sakura-club@sakura.ad.jp さくらクラブ ： http://www.slideshare.net/MasayaHayashi/lt20151224
- 143. 143 そこに、さくら