Getting Started

enebular-edge-agentでは、enebularのeditorを使い、フローを作成しデプロイできます。editorは、Web上のeditorでもenebular editorでも構いません。(enebular editorを使う際はdesktop modeでフローを起動してください)

本ドキュメントは、enebular-edge-agent用のリファレンスボードであるRAVENを使用したenebular-edge-agentのチュートリアルです。

「LED点滅のフローをenebular-edge-agentにデプロイし、enebularからログを確認する」手順をステップバイステップで行います。(所要時間30分)

RAVENに搭載された部品など、RAVEN の説明については、本ドキュメントの RAVEN のページを参照してください。

Introductionに従い、enebular のアカウントとプロジェクトは予め作成しておいてください。

※現在、無線LANの設定はWindowsOSからしか行うことができません。

Table of Contents

  1. 無線LANの設定
  2. フローの作成
  3. フローのデプロイ
  4. 実行ログの確認

無線LANの設定

  1. デバイスとPCをUSBケーブルで接続してください
  2. enebular Reference Board Configuration Tool(以下: eRB Config. Tool)をこちらからダウンロードし、インストールします
  3. デバイスを Setting Mode で起動します。起動時にUSER SWを押したままの状態にします(RESET SWを押した直後にUSER SWを押したままにするとUSER LEDが赤く点灯し、Setting Modeで起動します)
    • USER SW、RESET SW、USER LEDの場所については、RAVEN 各部説明を確認してください
  4. eRB Config. Tool でSSIDとパスワードを設定します(詳しくはConfigurationのページを参照してください)
  5. 設定が完了したら、デバイスを再起動してください
  6. 起動時にRAVENが無線LANへの接続を試みている間、USER LEDが点滅(0.1秒間隔)を繰り返します ※1
    • RAVENが無線LANの接続に成功するとUSER LEDが消灯します
    • USER LEDが点滅を続ける場合、RAVENは無線LANに接続できていません。次のことを確認してください
      • お使いの無線LAN環境が利用可能なことを確認してください
      • RAVENへのSSIDとパスワードの設定が正しいことを確認してください

※1 enebular-edge-agent 1.3.0 以降の場合の動きです。それ以前バージョンの場合はUSER LEDは消灯したままです。enebular-edge-agentのバージョンを知る方法はこちらを参照してください。

フローの作成

プロジェクトの画面から、新規アセットをtype:flowで作成します。 GettingStarted-create-asset

[Edit Flow] を押してフローエディタを開きます。 GettingStarted-create-editFlow

右上の「Ξ」からメニューを開き、「読み込み」>「クリップボード」を選択します。 GettingStarted-import-menu

フローを張り付けるテキストボックスが表示されますので、下記JSONデータをコピー&ペーストし、「読み込み」ボタンを押します。

[{"id":"5c08cdab.fe76c4","type":"inject","z":"90d9de00.d40e1","name":"","topic":"","payload":"","payloadType":"date","repeat":"3","crontab":"","once":false,"onceDelay":0.1,"x":110,"y":100,"wires":[["4c620395.fa935c"]]},{"id":"4c620395.fa935c","type":"switch","z":"90d9de00.d40e1","name":"","property":"led","propertyType":"flow","rules":[{"t":"true"},{"t":"else"}],"checkall":"true","repair":false,"outputs":2,"x":250,"y":100,"wires":[["9610c50d.5df558"],["36f9ebd9.df86c4"]]},{"id":"9610c50d.5df558","type":"digitalout","z":"90d9de00.d40e1","board":"RAVEN","pin":"ULED","value":"false","si":false,"name":"","x":420,"y":60,"wires":[["730feba8.5a1a24"]]},{"id":"36f9ebd9.df86c4","type":"digitalout","z":"90d9de00.d40e1","board":"RAVEN","pin":"ULED","value":"true","si":false,"name":"","x":420,"y":140,"wires":[["39806cf9.b31c54"]]},{"id":"730feba8.5a1a24","type":"change","z":"90d9de00.d40e1","name":"","rules":[{"t":"set","p":"led","pt":"flow","to":"false","tot":"bool"}],"action":"","property":"","from":"","to":"","reg":false,"x":590,"y":60,"wires":[[]]},{"id":"39806cf9.b31c54","type":"change","z":"90d9de00.d40e1","name":"","rules":[{"t":"set","p":"led","pt":"flow","to":"true","tot":"bool"}],"action":"","property":"","from":"","to":"","reg":false,"x":590,"y":140,"wires":[[]]}]

※フローのインポートをせず、0からフローの作成をしたい場合はページ下部のAppendixのフローの作成を参照してください。

GettingStarted-import-paste

フローが読み込まれるので、任意の位置でクリックして、フローを配置してください。右上のデプロイを押します。 GettingStarted-import-done

editorでは、USER LEDの点滅を確認できないので、フローはダミーの動きをしています。

※ページ下部のAppendixにフローの解説を書いています。興味のある方はご一読ください。

フローのデプロイ

このステップを実行する際はあらかじめ、RAVENのUSBポートに給電を行い、電源をonにしてください。
RAVENのUSBポートの場所については、RAVEN 各部説明を確認してください。

デプロイするフローの画面を開き、「DeployFlow」を押します。(previewが表示されていない場合は、ページをリロードしてください。) GettingStarted-deploy-button

RAVENの申し込み時に希望したコネクション名を探して選択します。(コネクション名を指定しなかった場合、コネクション名は raven となっています)
該当するコネクションがどれか分からない場合は、 [email protected] まで連絡をお願いします。

GettingStarted-deploy-connection

RAVEN裏面のバーコードに印字されている20桁の製造番号と一致するデバイスを、Endpoint Nameから探してください。 チェックボックスにマークを付け、Deployボタンを押します。

GettingStarted-deploy-connection

デプロイが完了し、RAVENのUSER LEDの点滅が始まります。 GettingStarted-deploy-done

実行ログの確認

※ ログ、ステータスを確認するには、ライセンスが登録されている必要があります。詳しくは、LicenseManagerを参照してください。

enebular-edge-agentは実行ログをenebular.comから確認することができます。 ログは、RAVENの起動後30秒で最初に送信し、以降5分毎に送信します。

Projectの画面からDevice Listを選択します。 GettingStarted-logs-project

コネクションを選択します。
GettingStarted-logs-connection

デバイスの一覧が表示されます。ログを見たいデバイスのアイコンを選択します。
GettingStarted-logs-deciceList

実行ログが表示されます。 GettingStarted-logs-done

詳しくは、Logsを参照してください。

Well Done!

LED点滅のフローをenebular-edge-agentにデプロイし、enebularからログを確認することができました。

enebular-edge-agentと市販のセンサーを組み合わせることで簡単なIoTデバイスをだれでも作ることができます。 使用できるノードに制限があるので、Nodesのページを参考にして、フローを作成してみてください。

Appendix

デプロイしたフローの解説

GettingStarted-import-done

このフローは5秒周期で起動します。

digitaloutノードでは、設定されている先のUSER LEDが現在点いているか、そうでいないのか判断できません。 ここでchangeノードで設定のできる、Flow Contextを使用しています。 Flow Contextはノード間でやりとりされる msg とは異なり、フローの処理が終了しても値が残り続けます。

よって、digitaloutノードで、USER LEDを点灯及び消灯させたのち、後続のchangeノードで現在処理したUSER LEDの状態を保存ということをフロー一度の起動で行っています。 次に起動したときに、前回のUSER LEDの状態がFlow Contextに代入されているので、前回と逆の処理をするようフローが実行されます。

フローの作成

すでにenebularにプロジェクトが作成されていることとします。

※このチュートリアルはインポートで使用したフローの作成手順を紹介しています。

  1. 新規アセットをtype:flowで作成します。 GettingStarted-create-asset

  2. [Edit Flow] を押してフローエディタを開きます。 GettingStarted-create-editFlow

  3. 下記画像を参考にしてノードを配置してください。 GettingStarted-create-putNodes 下記のノードを使用しています。digitaloutノードはEEAカテゴリーの中にあります。

    • inject
    • switch
    • digitalout 2つ
    • change 2つ
  4. injectノード①は「繰り返し」を指定した時間間隔にし、「時間間隔」を3秒としてください。「完了」を押します。 GettingStarted-create-inject

  5. switchノード②は「プロパティ」をflow.ledとし、条件1をis trueにします。 GettingStarted-create-switch

  6. 左下の +追加 を押して、条件を追加します。条件2をその他としてください。「完了」を押します。 GettingStarted-create-switchAddRule

  7. digitaloutノード③は「Board」をRAVENにし、「Pin」をUSER LED、「Value」をfalseとしてください。「完了」を押します。 GettingStarted-create-digitalout1

  8. changeノード④はflow.ledに「真偽」> falseを代入という設定にしてください。「完了」を押します。 GettingStarted-create-change1

  9. digitaloutノード⑤は「Board」をRAVENにし、「Pin」をUSER LED、「Value」をtrueとしてください。「完了」を押します。 GettingStarted-create-digitalout2

  10. changeノード⑥はflow.ledに「真偽」> falseを代入という設定にしてください。「完了」を押します。 GettingStarted-create-change2

  11. switchノード②の右側に口が一つ追加されているので、digitaloutノード⑤のつなぎ先をそちらに変更し、右上のデプロイを押します。 GettingStarted-create-switchOut

enebular-edge-agentにデプロイするフローが作成できました。フローのデプロイからチュートリアルを続けてください。 editorでは、USER LEDの点滅を確認できないので、フローはダミーの動きをしています。

results matching ""

    No results matching ""