Node-RED・Home Assistant・自作スクリプトを保全管理システムにAPI連携

HTTP APIが適している場面

FreeMaintが自らデコードするデバイスは、Shellyの電力メーターとMilesightの2種類のLoRaWANセンサーなど、ごく一部です。それ以外はすべてHTTP APIを通じて取り込み、これで産業現場の大部分をカバーできます。Node-REDが読み取るModbusの電力アナライザー、Home Assistantのセンサー、ポイントを出力するビル管理システム、すでにカウンターを公開しているPLC、専用ゲートウェイで読み取る振動センサーなどです。

FreeMaintはModbus、MQTT、BACnet、OPC UAを直接は扱いません。これは意図的な設計です。すでにネットワーク上にあるゲートウェイがプロトコルとレジスタマップを把握しており、FreeMaintに必要なのは値だけだからです。レジスタをJSONに変換するNode-REDのフローや短いスクリプトは、通常数行で書けます。

• Modbus RTUまたはTCPのデバイスを読み取るNode-REDのフロー
• センサー値を転送するHome Assistantのオートメーション
• Data to Server機能を備えたTeltonikaルーター
• PLCやビル管理システムのゲートウェイ
• 小型PCやRaspberry Pi上のスクリプト

リクエストの形式

リクエストは、接続の作成時にFreeMaintが表示するURLへのPOSTで、2つのヘッダーを付けます。アクセスキーを含むAuthorizationと、application/jsonを指定したContent-Typeです。本文にはitemsを列挙します。各itemはデバイス識別子、任意の表示名と時刻、そしてポイントで構成されます。ポイントはpowerやenergy_totalのようなキーと値を持ち、可能であれば単位と物理量、カウンターの場合は積算型の種別も指定します。

データが受け付けられるとFreeMaintは202を返し、数秒以内に保存します。形式に誤りのあるリクエストには問題箇所を示した400を返すため、設定を誤ったゲートウェイも数週間後に発覚するのではなく、数分で修正できます。各接続は1分あたり最大120リクエストを受け付け、それを超えるとFreeMaintは429を返すので、送信側のシステムは時間をおいて再試行してください。

自社システムからの稼働時間とエネルギー

PLCがすでに稼働時間をカウントしているなら、カウンターを積算値として送信し、そのチャネルを資産の稼働時間メーターに紐づけてください。予防保全計画がそれをもとに起動します。電力や電流しか報告しない場合は、そのチャネルからFreeMaintに稼働時間を計算させることができます。エネルギーについては、チャネルをエネルギーメーターに紐づけると、FreeMaintが15分ごとにコストとCO2付きの計測値を記録します。

プランと上限

HTTP APIはFreeMaint Connectの一部で、Businessプラン（月額 $99、会社単位の定額）に含まれ、有効なチャネルは100までです。Enterpriseプランでは5,000まで含まれます。無効なチャネルは数えず、すでに受信したデータはすべてのプランで引き続き閲覧できます。作業指示、資産、部品など、FreeMaintのその他のデータの読み書きには、BusinessプランのGraphQL APIと、Starterプランから使える署名付きの送信Webhookも用意されています。