MENU
    ParticleIOの統合
    • 03 Nov 2023
    • 1 読む分
    • 寄稿者

    ParticleIOの統合


    記事の要約

    TulipとParticleIOデバイスを簡単に接続

    Particleのコミュニティ統合(同じガイド)はこちら:Particle <> Tulip Community Integration

    セットアップ

    Tulipマシンエンドポイントの設定

    Tulipでマシンを作成するには、以下が必要です。

    API CredentialsSettings --> API Tokensで、マシンと属性を読み書きできるAPIトークンを作成します。image.png

    マシン・タイプShop Floor --> Machines --> Machine Types に進み、新しいマシン・タイプを作成する。ParticleIOから公開されたイベントを反映するためにマシン属性を作成します。注:データ型は文字列でなければなりません。
    image.png

    設定の下で、マシン属性をTulip Machine APIにマッピングし、MachineIdとAttributeIdに注意してください。image.png

    統合を有効にする

    Particle Console必要な事前設定をすべて行ったので、Particle ConsoleでTulipの統合を有効にする準備ができました。

    サイドバー()の統合アイコンをクリックするか、このリンクから統合ハブを開きます。製品の統合を有効にしたい場合は、目的の製品の統合ハブにアクセスする必要があります。サイドバーの製品アイコン()をクリックして製品を見つけ、製品コンテキストで統合アイコン()をクリックします。

    統合ハブに移動したら、[新規統合]ボタンをクリックします。利用可能な統合のリストから、"Webhook "をクリックします。

    次のステップは、Webhookの設定です。以下のフィールドに入力します:

    • イベント名:イベントをTulip Machineに公開するトリガーとなるイベント名。ファームウェアでParticle.publish()を呼び出す際のイベント名です。
    • URL:Tulip Machine APIの完全なURL 例: https://[instance].tulip.co/api/v3/attributes/report
    • リクエストタイプ:TulipサーバーはPOSTを期待しているので、それが選択されていることを確認してください。
    • リクエストフォーマット:デフォルトはWeb Formですが、JSONを送信しますので、JSONに変更してください。

    詳細設定エリアをクリックして、カスタムJSONフォーマットを入力する必要があります。以下のように入力します:

    { "attributes":[ { "machineId":"machineID", "attributeId":"attributeID", "value":"{{particle_event_value}}" } ] } 認証 最後に、以下のように入力する必要があります。

    認証最後に、apiキーとシークレットを使ってTulipを認証します。下のスクリーンショットがその例です。tulip_api_auth.jpg

    この場合、Basic Authを使用します。

    "Create Webhook "をクリックします。これで、ParticleクラウドにMachineAPI経由でTulipにデータをストリーミングするよう指示することに成功しました!

    次にファームウェアを作成します!

    ファームウェア

    Particleクラウドで統合が有効になったので、Tulipにデータをストリーミングするために必要な最後のステップは、対象のイベントを公開するファームウェアでデバイスをフラッシュすることです。Particle Web IDE、Local IDE、またはファームウェア開発に使用しているIDEのいずれかにアクセスしてください。

    すでにファームウェア・アプリケーションに取り組んでいる場合は、上記のGoogle Cloud Platformとの統合を有効にするために使用したイベントと一致するイベント名を持つParticle.publish()が含まれていることを確認してください。ファームウェアのサンプルが必要な場合は、以下のコードをファームウェア・アプリに貼り付けてください:

    void setup() { } }.

    void loop() {

    void setup() { } void loop() { // ランダムなデータ String data = String((rand()%100)+1); // インテグレーションのトリガー Particle.publish("temperature", data, PRIVATE); // 6秒間待つ delay(6000); } ``` 上記のコードは6秒ごとにイベントを発行し、そこで乱数が生成され、webookイベントに発行されます。

    Particleデバイスへの統合をトリガーするParticle.publish()でファームウェアをフラッシュしてください。

    おめでとうございます!これで統合がエンドツーエンドで動作するようになりました。デバイスがターゲットイベントのパブリッシュを開始すると、Particleクラウドにシグナルが送られ、イベントの内容がTulipインスタンスにストリーミングされます。

    データがTulipに届いていることを確認する

    データがTulipに正常にパブリッシュされていることを確認するには、Shop Floor --> Machinesエリアでマシンの更新を表示できます。

    image.png

    注意: 属性は文字列形式にして、後で変換する必要があります。

    使用例

    Boron404xのようなParticleIOボードの使用は、Wi-Fiが貧弱で、携帯電話の方がデバイス接続のための回避策が早い場合に最適です。使用例には以下が含まれます: * 材料追跡 * 機械監視 * リアルタイムの品質更新


    この記事は役に立ちましたか?