ParticleIOの統合

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

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

セットアップ

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

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

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

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

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

統合を有効にする

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を認証します。下のスクリーンショットがその例です。

この場合、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エリアでマシンの更新を表示できます。

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

使用例

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