製品管理
ページガイド
使用の入口と推奨フロー
- デバイス管理 → 製品管理に移動し、まず製品分類、デバイスタイプ、伝送プロトコル、通信プロトコル、認証方式を確認します。
- 製品を新規追加してから製品詳細に入り、デバイス能力に応じてモノモデル、Modbus、SIP、サブ製品、アプリ設定、コンフィギュレーションアプリを設定します。
- 設定完了後に製品を公開し、デバイス管理に移動してデバイスを新規追加またはインポートします。
- デバイスオンライン後、製品とモノモデルのページに戻り、データ、指令、イベント、ルール、アラームがすべて正常に連携するかを再確認します。
1. 製品管理の紹介
製品はデバイスの集合であり、通常は同タイプ・同モデルの物理デバイスの記述です。 本ページで 製品 に関する機能を理解できます。
1.1. 概要
製品は、同じデバイスの伝送プロトコル、通信プロトコル、モノモデル、modbus 設定を一括管理する能力を備えています。同じデバイスは同じ製品に所属し、デバイスの統一管理を実現します。製品をベースにシーン連携やコンフィギュレーション画面なども設定できます。
1.2. 製品の設定項目
| 設定項目 | 説明 |
|---|---|
| 製品名 | 必須、製品名、カスタム |
| 製品分類 | 必須、単一選択ドロップダウン。製品分類メニューで設定し、複数の製品を 1 つの分類にまとめられます |
| デバイスタイプ | 必須、単一選択ドロップダウン。監視の場合は監視デバイスを直接選択。その他のデバイスタイプはゲートウェイとサブデバイスのドキュメント（中国語）を参照 |
| 通信プロトコル | 必須、単一選択ドロップダウン。デバイスの送信データのエンコード/デコード。適切なものを選択する必要があり、既存のプロトコルはプロトコル管理メニューを参照 |
| 伝送プロトコル | 必須、単一選択ドロップダウン。デバイスが IoT プラットフォームに接続する方式。適切なものを選択する必要があります |
| ファームウェアタイプ | 必須、単一選択ドロップダウン。適切なものを選択。デバイス OTA アップグレードドキュメント（中国語）を参照 |
| ネットワーク接続方式 | オプション、単一選択ドロップダウン。ラベルのようなもので、デバイスのネットワーク接続方式に応じて選択 |
| プライベート製品 | スイッチ。プライベートに設定すると下位組織は閲覧できません |
| デバイス認証 | スイッチ。デバイス認証機能。デフォルトは無効。製品でデバイス認証コードを有効にした場合、デバイスに認証コードを割り当てる必要があり、デバイス認証時に使用します |
| 認証方式 | 必須、デバイス接続の認証方式、単一選択ドロップダウン。デバイス接続の各プロトコル別デバイス接続ドキュメントを参照可能 |
| 位置特定方式 | 必須、単一選択ドロップダウン 自動位置特定：デバイス認証時にプラットフォームがデバイスの位置を自動取得。 デバイス位置特定：デバイスが /info/post トピックで緯度経度の住所情報を自発的に送信。 カスタム位置：デバイス詳細で緯度経度の住所情報を自分で設定 |
| 製品番号 | システムが自動生成 |
| 認証アカウント | 必須、新規追加時にシステムが自動生成、変更可能 |
| 認証パスワード | 必須、新規追加時にシステムが自動生成、変更可能 |
| 認証キー | 必須、新規追加時にシステムが自動生成、変更可能 |
| 製品画像 | オプション、変更可能 |
| 備考情報 | 任意入力フィールド |
1.3. 製品リスト
1.3.1. 新規追加
「+ 新規追加」ボタンをクリックして製品の新規追加ウィンドウを開き、OK をクリックすると、リストにその製品が表示されます
提示
注意：製品のデバイスタイプでゲートウェイデバイスを選択し、通信プロトコルで ModbusRtu プロトコル、Modbus转Json解析协议-华普物联、ModbusTcp プロトコル、JSON ゲートウェイ解析プロトコルを選択すると、サブ製品設定ボタンが表示されます。選択するとサブ製品を直接インポートできます。具体的な設定方法はゲートウェイとサブデバイスのドキュメント（中国語）を参照してください
1.3.2. コピー
「コピー」ボタンをクリックして製品選択ウィンドウを開き、対応する製品を選択して OK をクリックすると、完全に同じ製品をコピーできます 
1.3.3. インポート
「インポート」ボタンをクリックして製品のインポートウィンドウを開き、まず json テンプレートファイルをダウンロードし、json ファイルを編集してからファイルをアップロードし、最後に OK をクリックすればインポートできます
1.3.4. 上位組織の製品を表示
チェックを入れると上位組織の製品が検索結果に表示されますが、編集はサポートされません
1.4. 製品詳細
製品詳細ページには基本情報、製品モデル、Modbus 設定、デバイス認証、コンフィギュレーションアプリ、アプリ設定などが含まれます
提示
注意：サブ製品、ポーリングタスク、アプリ設定を除き、その他の機能は先に製品を公開取り消ししてからでないと編集できません
1.4.1. 基本情報
基本情報の一部を変更できます
1.4.2. 製品モデル
モノモデルはクラウドにおけるデバイスの記述で、属性、機能、イベント、タグの 4 つの観点で実際のデバイスを定義します
- モノモデルファイルのインポート：クリックすると一括インポートウィンドウに入り、まず製品モノモデルのインポートテンプレートファイルをダウンロードし、編集後にファイルをアップロードし、最後に OK をクリックすればインポートできます
- 汎用モノモデルのインポート：クリックすると汎用モノモデルのインポートウィンドウに入り、適切な汎用モノモデルを選択し、最後にインポートをクリックします
- モノモデルの表示：クリックするとモノモデルウィンドウに入り、モノモデル全体のデータ構造を確認できます
1.4.3. アプリ設定
モバイル端末のステータスモード画面はカスタマイズをサポートしています。製品アプリ設定で設定をクリックし、設定画面で要件に応じて画面をカスタマイズし、設定後に有効化をクリックします
1.4.4. デバイス認証
オプション機能。有効にすると主にデバイス認証に使用され、デバイスに認証コードを割り当てる必要があります
1.4.5. SIP 設定
SIP プロトコルの設定項目で、国家標準 GB28181 プロトコル（公共安全ビデオ監視ネットワークシステムの国家標準）に対応します。主な役割は、この製品（通常はカメラなどのビデオデバイス）が SIP プロトコルを通じて GB28181 のビデオ監視プラットフォームに接続できるようにし、デバイス登録、ビデオストリーム伝送、デバイス制御などの機能を実現することです
1.4.6. サブ製品
ゲートウェイデバイスタイプでは、一部の通信プロトコルでサブ製品の設定をサポートします
- 新規追加：クリックすると製品選択ウィンドウに入り、対応するサブ製品を選択し、最後に OK をクリックしてバインドします
- アドレス設定：クリックするとサブ製品のデフォルトのサブデバイスアドレスを編集できます。重複はできません
1.4.7. Modbus 設定
製品プロトコルが Modbus 関連プロトコル の場合に設定が必要です。modbus デバイスにおけるゲートウェイ自身の属性またはゲートウェイのサブデバイスの設定です。具体的な設定方法はゲートウェイとサブデバイスのドキュメント（中国語）を参照してください
1.4.8. ポーリングタスク
Modbus 関連プロトコルでは、データを能動的に収集するためにポーリングタスクの設定が必要です。製品 Modbus 設定-ゲートウェイ/サブデバイス設定-収集方式でクラウドポーリングにチェックを入れる必要があり、デバイス新規作成時にデバイスが継承します
1.4.9. 指令送信
製品の通信プロトコルで ModbusTcp プロトコルを選択した場合、いくつかの指令を設定します。デバイス新規作成時にデバイスが継承し、デバイス側で送信をクリックできます
1.4.10. コンフィギュレーションアプリ
製品に対してコンフィギュレーション画面を設計します。その製品配下のデバイスはすべてこのコンフィギュレーション画面を表示でき、デバイスの送信データをリアルタイム表示したり指令を送信したりできます
1.5. 製品の公開
新規作成した製品はデフォルトで未公開状態です。製品詳細を参照して製品定義を完了後、「製品を公開」ボタンをクリックして有効化すると、その製品に対応するデバイスを作成できます
提示
注意：製品が未公開状態の場合、デバイス認証は失敗します
1.6. マルチテナント
テナント分離。上位組織は下位組織の製品を使用・編集できます。下位組織は上位組織の製品を閲覧・使用できますが編集はできません。
1.7. 設定の判断表
製品作成時に最も誤選択しやすいのはデバイスタイプ、通信プロトコル、伝送プロトコル、認証方式です。以下の表で先に判断してから製品を作成することをお勧めします。
| シーン | デバイスタイプ | 伝送プロトコル | 通信プロトコル | 説明 |
|---|---|---|---|---|
| 一般的な MQTT センサー | 直接接続デバイス | MQTT | JSON 解析またはカスタムプロトコル | 最も一般的な接続方式。クイックスタートに適する |
| HTTP 能動送信デバイス | 直接接続デバイス | HTTP | JSON 解析またはカスタムプロトコル | 低頻度送信、HTTP 能力を既に持つデバイスに適する |
| TCP プライベートプロトコルデバイス | 直接接続デバイス | TCP | カスタムプロトコル | サーバー側のエンコード/デコード適応が必要 |
| Modbus RTU ゲートウェイ | ゲートウェイデバイス | 現場のリンクに応じて選択 | ModbusRtu またはゲートウェイプロトコル | サブ製品、レジスタ、ポーリングタスクの設定が必要 |
| Modbus TCP デバイス | 直接接続デバイスまたはゲートウェイデバイス | Modbus TCP | ModbusTcp プロトコル | デバイスがクライアントとサーバーのどちらかを明確にする必要 |
| GB28181 カメラ | 監視デバイス | SIP/GB28181 | SIP/ビデオプロトコル | SIP とストリーミングメディアサービスの設定が必要 |
| 車載位置情報端末 | 直接接続デバイス | TCP/JT808 | JT808 プロトコル | 端末の電話番号とデバイス番号のマッピング計画が必要 |
公開前の受け入れチェックリスト
製品を公開する前に項目ごとに確認することをお勧めします：
| チェック項目 | 正常な状態 |
|---|---|
| 製品の基本情報 | 製品名、分類、デバイスタイプ、プロトコル、認証方式が確認済み |
| モノモデル | 属性、機能、イベントの識別子が一意で、データ型が正しい |
| 認証情報 | MQTT/HTTP/TCP のアカウント、パスワード、キーが生成済み |
| デバイス認証 | 認証を有効にしている場合、認証コードの割り当て方法が準備済み |
| Modbus 設定 | レジスタ、スレーブアドレス、ファンクションコード、ポーリングタスクが確認済み |
| サブ製品 | ゲートウェイ製品に管理が必要なサブ製品がバインド済み |
| SIP 設定 | ビデオ製品に SIP 情報とストリーミングメディアサービスが設定済み |
| アプリ設定 | モバイル端末のステータスモードまたはコンフィギュレーションアプリが必要に応じて有効化済み |
| 公開状態 | 製品の最終ステータスが公開済み |
よくある質問
製品の公開に失敗する
必須フィールドが完全か、モノモデル識別子が重複していないか、プロトコル設定が欠落していないかを確認してください。一部の設定は先に公開を取り消してからでないと変更できません。
デバイス認証に失敗する
まず製品が公開済みかを確認し、デバイス端で使用している製品 ID、デバイス番号、認証アカウント、認証パスワードが現在の製品と一致しているかを確認してください。
デバイスが送信したのにページにデータが表示されない
モノモデル識別子が送信メッセージの id と完全に一致しているか、データ型が一致しているか、製品を公開してからデバイスを作成したかを確認してください。
下位組織に製品が表示されない
製品がプライベート製品かどうか、組織のデータ権限、現在のロール権限、上位組織の製品を表示にチェックが入っているかを確認してください。
二次開発の入口
| タイプ | パスまたはインターフェース | 説明 |
|---|---|---|
| Vue3 ページ | vue3/src/views/iot/product | 製品リスト、製品詳細、製品モデル、アプリ設定 |
| Vue3 API | vue3/src/api/iot | 製品、モデル、プロトコルなどのインターフェースカプセル化 |
| バックエンドインターフェース | /iot/product | 製品管理インターフェース |
| バックエンドインターフェース | /iot/model | 製品モノモデルインターフェース |
| バックエンドインターフェース | /iot/protocol | プロトコル管理インターフェース |
| プロトコルモジュール | springboot/fastbee-protocol | デバイスプロトコルのエンコード/デコード |
| 業務モジュール | springboot/fastbee-open-api | 製品関連 Controller |
| SQL スクリプト | springboot/sql | 製品、モノモデル、プロトコル関連のテーブル構造とアップグレードスクリプト |
関連ドキュメント
- 製品からデバイスまでの完全なクローズドループ（中国語）
- 汎用モノモデル（中国語）
- デバイス管理（中国語）
- MQTT プロトコルデバイス接続
- デバイス接続トラブルシューティングチェックリスト（中国語）