コンテンツにスキップ
SMI Developer Center

開発者センターを始める

SMI 開発者センターは、SM Instruments の音響カメラ製品群(BATCAM FX、BATCAM FX2)と FX Viewer アプリケーションの連携および開発に必要な技術文書を一箇所で提供します。データストリーミングプロトコル、パラメータ制御、ファームウェア、外部システム統合方法を製品別に整理し、音響・振動データを自社のアプリケーションやワークフローに統合しようとする開発者を支援します。

何を作れますか?

開発者センターの文書によって、次のような統合を実装できます。

  • リアルタイムオーバーレイ映像アプリケーション — BATCAM FX の RTSP 原本映像と、WebSocket/Protobuf で受信したビームフォーミングデータ(1200 個の Float 配列)を合成し、自社のアプリケーションでオーバーレイ映像を生成します。 BATCAM FX 概要

  • REST API ベースの装置制御・監視 — アカウント、ネットワーク、ファームウェア、イベント、ビームフォーミングの設定をコードから直接制御します。 FX API プレイグラウンド · FX2 API プレイグラウンド

  • ROS 2 システム統合 — BATCAM FX は v1.0.3b 開発ファームウェア以降、ROS 2(Humble Hawksbill)ベースのデータ送信をサポートします。 FX ROS システム統合の概要

  • 工場自動化(PLC・SCADA・HMI)連携 — FX Viewer の Modbus TCP サーバーでビームパワー・アラーム状態を監視し、しきい値など一部の設定を外部から制御します。 FX Viewer Modbus 連携

製品・インターフェース選択ガイド

ご使用中の製品と連携方式に応じて、下の表から該当する文書トラックへ移動してください。

製品インターフェースこのような作業に使用文書
BATCAM FXRTSP + WebSocket/Protobufリアルタイム映像・ビームフォーミングデータの受信、オーバーレイ合成BATCAM FX 概要
BATCAM FXREST API (HTTP Basic 認証)アカウント・装置設定・イベント・ビームフォーミング・ROS Domain の制御FX API プレイグラウンド
BATCAM FXROS 2ROS 2 ベースのシステムでの音響データ受信FX ROS システム統合
BATCAM FX2デバイスマネージャー (Web UI)ブラウザーでの装置設定・状態管理FX2 デバイスを始める · メニュー案内
BATCAM FX2REST API (Basic/Bearer 認証)認証・装置設定・ビームフォーミング・イベント・マイク・システムの制御FX2 API プレイグラウンド
BATCAM FX2WebSocket/Protobufストリームデータの受信・デコード (Python サンプルを含む)Python Protobuf サンプル
BATCAM FX2ONVIFONVIF 対応デバイスマネージャーでの装置検索・リアルタイム映像取得ONVIF サポート
BATCAM FX2FX Cloudクラウドでのアカウント作成・QR コードによるデバイス連携・リアルタイム映像の確認会員登録 · デバイス連携
FX ViewerModbus TCPPLC・SCADA・HMI でのビームパワー・アラームの監視および制御Modbus 連携マニュアル

製品別の文書トラック

  • BATCAM FX 開発文書 — データフローの概要を皮切りに、ビームフォーミング・オーバーレイパラメータ、Listening Point 座標、ROS 2 統合、ファームウェアアップデート(Web/シェル)とリリースノート、AI ベースの PRPD 分類器の文書を提供します。

  • BATCAM FX2 開発文書 — 初期接続・パスワード変更を皮切りに、デバイスマネージャーの各メニュー(ビームフォーミング、カメラ、マイク、イベント、人工知能など)、FX Cloud、ONVIF、Python Protobuf サンプル、リリースノートの文書を提供します。

  • FX Viewer 開発文書 — FX Viewer アプリケーションの Modbus TCP 連携マニュアル(レジスタマップ、Python サンプル、トラブルシューティング)を提供します。

クイックスタート: 初回接続の確認

装置と開発 PC を同じネットワークに接続したうえで、1 回のリクエストで装置との通信を確認できます。

BATCAM FX2

  1. 装置と PC をイーサネットで接続します。工場出荷時の初期値はイーサネット #1 192.168.0.80、イーサネット #2 192.168.0.81 です。PC の IP を同じ帯域(192.168.0.x)に設定してください。

  2. 認証なしで呼び出せるヘルスチェックエンドポイントで通信を確認します。

Terminal window
curl http://192.168.0.80/ping

期待される応答:

{"error": 0, "result": "pong"}
  1. ブラウザーで http://192.168.0.80 にアクセスし、デバイスマネージャーにログインします。既定のアカウントは admin/1234 であり、初回接続時には必ず新しいパスワードに変更する必要があります。詳細な手順は FX2 デバイスを始めるを参照してください。

BATCAM FX

BATCAM FX のすべての REST エンドポイントは HTTP Basic 認証が必要です。装置には既定で admin、user の 2 つのアカウントがあらかじめ設定されており、出荷時の初期パスワードは必ず変更してからご使用ください。機器情報の照会によって、接続とファームウェアバージョンを確認できます。

Terminal window
curl -u admin:<password> http://<装置 IP>/setting/status

期待される応答:

{
  "error": 0,
  "result": {
    "hardware_id": "3287162925128",
    "sbrio_version": "1.0.14",
    "firmware_version": "v0.0.1"
  }
}

💡 参考: オーバーレイ・ROS 関連の一部のエンドポイントは、ファームウェア 1.0.3 以上でのみ提供されます。リアルタイムデータの受信は REST ではなく RTSP + WebSocket/Protobuf の経路を使用します — BATCAM FX 概要を参照してください。

API リファレンス (プレイグラウンド)

両製品の REST API は、開発者センターに統合された API プレイグラウンドで確認できます。各エンドポイントのパラメータ、リクエスト/レスポンスのスキーマと例をブラウザーからそのまま探索してください。

  • BATCAM FX API — 装置が直接サービングする組み込み REST API。アカウント(auth)、装置設定(ネットワーク・ファームウェア・再起動・機器情報)、イベント、ビームフォーミング(設定・結果・オーバーレイ)、ROS Domain ID のエンドポイントを扱います。

  • BATCAM FX2 API — 認証、装置設定、ビームフォーミング、イベントトリガー・ログ、マイク(選択・キャリブレーション)、システム(監視・初期化)のエンドポイントを扱います。

BATCAM FX2 は装置からライブの OpenAPI 仕様も提供します: GET http://{device_ip}/api-docs/json

💡 参考: WebSocket/Protobuf のリアルタイムストリーミングは REST 仕様に含まれません。 BATCAM FX 概要と Python Protobuf サンプルを参照してください。

開発者リソース

C# 連携サンプル、Protobuf スキーマ(fx-stream-protocol)、公式ソフトウェアのダウンロードなどの外部リソースは 開発者リソース ページにまとめられています。