# Z240 ソフトウェア仕様書(Z240-MP4(CT/EA) Firmware ver.1.6 / Z240-CP13 Firmware ver.1.3 共通) | 項目 | 内容 | |---|---| | 製品 | IEEE802.15.4/ZigBee®3.0互換ワイヤレスモジュール Z240-MP4(CT/EA) / Z240-CP13(2.4GHz帯特定小電力データ通信システム) | | Firmware | Z240-MP4(CT/EA) ver.1.6 / Z240-CP13 ver.1.3 | | ドキュメントRev | Rev.1.1.0 | | 発行 | CLEALINK TECHNOLOGY CO., LTD.(株式会社クレアリンクテクノロジー) | | 出典 | https://support.dragon-torch.tech/docs/wannabee/soft_MP4_ver.1.6_CP13_ver.1.3/ | | 関連ドキュメント | Z240-MP4(CT/EA) ver.1.6 ハードウェアデータシート、Z240-CP13 ver.1.3 ハードウェアデータシート、Z240-CP13 ATコマンド仕様書 ver.1.3 | > 本MDはオンラインドキュメントを AI 開発向けに Markdown 化したもの。図は画像のため省略しキャプションのみ記載。表番号・図番号は原文のまま。 > HEXコマンド例中の英語注記(例: `networking status`、`MAC address`)は、原文で直前のHEX値の意味を付記したもので、実際の入出力には含まれない(原文注記)。 --- ## 前書き ### 用語定義(要約) - 提供媒体を問わず「ドキュメント」と称する。製造・販売元・権利者の株式会社クレアリンクテクノロジーを「当社」と記載。 - 対象製品「Z240-MP4 (CT)」「Z240-MP4 (EA)」を「MP4(CT)」「MP4(EA)」、総じて「MP4」、「Z240-CP13」を「CP13」と略記。「モジュール」「通信モジュール」「本製品」とも称する。 - 電波法用語は、2.4GHz帯高度化小電力データ通信システム10mW/MHz以下の範囲に限定した用語で記載。本製品は日本国法令上、利用者に特別の免許・資格を要しない無線装置。 - 「使用者」「利用者」は本製品(搭載機器)を利用する者。厳密には、管理運用者を「使用者」、その下で恩恵を受ける受益者を「利用者」とする。本製品を使った技術的設計・分析・試用・評価を行う者を「設計者」(一般的な電子工学の知見を持つことを想定)。 ### 免責事項(要約) - 現状有姿で提供。商品性・特定目的適合性・非侵害の保証なし。URL等を含め予告なく変更される場合がある。 - 医療機器、軍事機器、自動車・航空機の運転装置など、人命・財産への危害の恐れがある機器での使用は想定していない。安全性・適合性の判断は設計者の責任。 - 責任の範囲は発行者のサポート範囲を超えない。情報の使用に起因する事故、法令、特許権侵害等を保証しない。知的財産の使用は別途のライセンス条項・使用許諾契約による。 - 技術情報・試験結果は、株式会社クレアリンクテクノロジー、量産製造担当の Chengdu Ebyte Electronic Technology Co., LTD.、国内電波法準拠の無線装置認証機関が取得したもの。実際の利用条件で結果は異なる場合がある。 - 記載の商号・商標・登録商標は各所有者に帰属。本文書の著作権は株式会社クレアリンクテクノロジーに帰属。 ### 注意事項 - 内容は製品バージョンアップ等で変更されることがあり、予告なく変更する権利を当社が有する。ガイドとして使用されることを前提に、正確な情報提供に努めるが、完全な無誤謬は保証しない。誤りが発見された場合は公開媒体で開示するが、改訂更新の同時実施は保証しない。最新情報は当社ウェブページで確認すること。 - 日本語ドキュメントは、日本国内の日本人技術者向けに、国内電波法適合製品のサポートのため作成。類似製品・国外販売モジュールには適用されない。型番・電波法の認可を確認すること。 - 当社が提供した(正規販売チャネル含む)製品のみ有効。当社の販売管理対象外の製品は対象外で、問題についてサポート・技術的対応を提供しない。 ### 電波法・無線技術について Z240-MP4(CT/EA)、Z240-CP13 は O-QPSK変調方式をサポートしたデジタルワイヤレス通信モジュール。2.4GHz帯高度化小電力データ通信システムであり、当社が技術認証を受けた事実に基づく適切な使用方法である限り、法的義務や制限は生じない。 ### ZigBee® 商標表記 ZigBee®は Connectivity Standards Alliance(旧 ZigBee Alliance)の登録商標。ZigBee®ロゴ等は許可なく使用できない。「ZigBee」表記は同団体との提携関係を示すものではなく、ZigBee®仕様に基づく機能説明のみを目的とする。 --- ## 【重要】ファームウェア利用許諾契約書への同意について 本契約はお客様と株式会社クレアリンクテクノロジー(弊社)との契約で、本モジュールへ電気的なアクセスを行うことで同意したことになる。使用前に必ず確認し設計に反映すること。ファームウェアの使用方法のサポート等は、当社サポート情報または窓口へ。 ### ファームウェア使用許諾契約書 **1. 使用許諾** お客様は本モジュールを所有する場合に限り本ファームウェアを使用できる。弊社の所有権・知的財産権の権利はお客様に付与・許諾されない。 **2. 制限事項** - 2.1 許可なく、本ファームウェアの一部または全部を第三者に販売、開示、頒布、貸与、レンタル、リース、譲渡、再使用許諾等できない。 - 2.2 許可なく、本ファームウェアの一部または全部を複製、修正、改変、翻訳、翻案、逆アセンブル、逆コンパイルまたはリバース・エンジニアリング等できない。第三者に依頼することもできない。 **3. 免責** - 3.1 入手可能なZigBee®製品や他の通信規格・システムとの完全・全ての接続を保証しない。本ファームウェアはZigBee®プロトコルとの互換性を担保するための部分的な機能を実装したもの。 - 3.2 仕様の不整合や不具合で生じる問題は、お客様の責任で外部制御装置(外部MCUなど)で回避する。 - 3.3 使用または使用不能から生じる、法律的根拠を問わない損害について、弊社は一切責任を負わない。 - 3.4 使用に起因する、お客様と第三者間に生じる事項について、弊社は一切責任を負わない。 **4. 期間** - 4.1 本契約は電気的アクセスの時点で発効し、終了まで有効に存続する。 - 4.2 お客様は所有モジュールを廃棄または譲渡することで契約を終了できる。 - 4.3 違反した場合は直ちに終結し、14日以内にお客様の負担で本ファームウェアおよび複製データ等をすべて破棄または消去する。 **5. 契約の有効性** いずれかの条項が法的拘束力なしとされても、他の部分の有効性には影響しない。 **6. 準拠法** 契約の成立も含め日本法を準拠法とする。 **7. 合意** - 7.1 電気的アクセスの時点で、本契約を読んで理解し合意したことになる。 - 7.2 本契約は、事前の口頭・書面その他の合意に優先する完全かつ唯一の合意である。 - 7.3 本ファームウェアには個別の使用許諾契約を有するものが含まれる場合があり、その部分は個別契約が優先される。 - 7.4 本ファームウェア、マニュアル・ドキュメント類は、予告なく改良、変更する場合がある。 --- # 1 モジュールの紹介 ## 1.1 ZigBee®の概要 ZigBee®テクノロジーは「近距離、容易なネットワーク形成、低消費電力、低レート、低コストの双方向無線通信テクノロジー」。ネットワークには3つの論理デバイスタイプがある。 - **コーディネータ**: ネットワーク全体の起動と構成を担当。チャンネルとPAN IDを選択し、ネットワークキーを生成する。 - **ルータ**: 他デバイスのネットワーク参加を許可し、ルーティングとバッテリー駆動子デバイスの通信支援を行う。 - **エンドデバイス**: ネットワーク構造維持に特別な責任がなく、スリープ可能なバッテリー駆動デバイス。 ## 1.2 製品の特徴 - 役割の切り替え機能 - オンデマンドネットワーキング - ネットワーク自己修復機能 - 超低消費電力(スタンバイ電流2.5μA未満) - データ保持メカニズム(最大4件) - 自動再送信機能(最大2回) - 自動ルーティング機能 - AES128ビット暗号化プロトコル - シリアルポート構成機能 - マルチタイプデータ通信(ブロードキャスト、マルチキャスト、ユニキャスト) - チャンネル変更(11~26) - ネットワークPAN ID変更機能 - シリアルボーレート最大115200 bps対応 - MACアドレスからショートアドレス収集機能 - モジュールリセット機能 - 工場出荷時設定復元機能 > 原文注意: スタンバイ電流「2.5μA未満」は、ハードウェアデータシート記載の低消費電力時電流(MP4: 140μA、CP13: 7μA)と異なる。 ## 1.3 製品ファミリーのサポート | モデル | RFチップ | 周波数(GHz) | 通信速度(kbps) | 送信出力(dBm) | アンテナ形状 | |---|---|---|---|---|---| | Z240-MP4(CT) | CC2530 | 2.4 | 250 | 4 | プリント基板 | | Z240-MP4(EA) | CC2530 | 2.4 | 250 | 4 | IPEX | | Z240-MP4(CT) | EFR32MG1B232F256GM32/QFN32 | 2.4 | 250 | 13 | プリント基板 | > 原文注意: この表は原文のまま。3行目の型番は実際は Z240-CP13(EFR32MG1)と思われる。また CT/EA のアンテナ形状がハードウェアデータシートと逆(CT=IPEX、EA=プリント基板が正)になっている。 --- # 2 ピン機能とシリアルポート通信の紹介 ## 2.1 ピン機能図 Z240-MP4(CT/EA)のピン名称とRFチップ(CC2530)のピン名称の対応は図1、ピン番号・名称・機能は表2のとおり。 **図 1 ピン機能図**(画像) **表 2 ピンの対応一覧** | ピン番号 | モジュール ピン名称 | CC2530 ピン名称 | Input/Output | 機能説明 | |---|---|---|---|---| | 1 | GND | GND | - | 電源基準 | | 2 | VCC | DVDD1/DVDD2/AVDD1/AVDD2/AVDD3/AVDD4/AVDD5/AVDD6 | - | 電源 2.0~3.6Vの範囲 | | 3 | DC | P2_2 | I/O | ファームアップデートに使用。デバッグ・クロック・インタフェース | | 4 | DD | P2_1 | I/O | ファームアップデートに使用。デバッグ・データ・インタフェース | | 5 | NC | P2_0 | - | NC | | 6 | NWK_KEY | P1_7 | I | Active Low入力。入力信号: 100ms≤短時間≤3,000ms、5,000ms≤長時間。ネットワークへの手動参加・離脱・ペアリングに使用。ネットワーク未構成状態: 短時間入力でネットワークに参加または作成。ネットワーク構成状態: 短時間入力でペアリング開始、長時間入力で現在のネットワークを離脱。外部スイッチを直接接続可能 | | 7 | NC | P1_6 | - | NC | | 8 | NC | NC | - | NC | | 9 | NC | NC | - | NC | | 10 | UART_TX | P1_5 | O | TXピン シリアルポート | | 11 | UART_RX | P1_4 | I | RXピン シリアルポート | | 12 | RUN_LED | P1_3 | O | オープンドレイン出力(Active Low)。ネットワークアクセス状態を表示。高速点滅(10Hz): ネットワークに参加中/作成中。低速点滅(2Hz): 参加完了/作成完了 | | 13 | NWK_LED | P1_2 | O | オープンドレイン出力(Active Low)。モジュールのペアリング状態を表示。高速点滅(10Hz): ペアリング相手を検索中。低速点滅(3Hz): ペアリング相手を検出完了 | | 14 | NC | P1_1 | - | NC | | 15 | NC | P1_0 | - | NC | | 16 | NC | P0_7 | - | NC | | 17 | NC | P0_6 | - | NC | | 18 | NC | P0_5 | - | NC | | 19 | NC | P0_4 | - | NC | | 20 | NC | P0_3 | - | NC | | 21 | NC | P0_2 | - | NC | | 22 | NC | P0_1 | - | NC | | 23 | NC | P0_0 | - | NC | | 24 | RESET | RESET_N | I | Active Low入力。リセット端子 | > Z240-CP13(37ピン)のピンアウトは、Z240-CP13 ハードウェアデータシート 表8を参照(PWM0〜2、BAUD_RESET などを持つ)。 ## 2.2 ピン接続の説明 ### 2.2.1 シリアルポート接続について Z240-MP4(CT/EA)を外部MCUからUARTシリアルポートで操作するには、図2のように、外部MCUと本モジュール間をUART(TXD、RXDをクロス接続)に接続し、電源(VCC)とGNDピンを接続する。 **図 2 シリアルポート接続図**(画像) ### 2.2.2 ピン配置について 本モジュールは、UARTシリアルポート通信で、コンフィグレーションおよび通信データの送受信を行う。UART機能を備えた任意の外部MCUに接続できる。Z240-MP4(CT/EA)のP1_4ピンとP1_5ピンは、それぞれ内部SoC通信モデム制御チップの内部シリアルポートのRXピンとTXピンに接続されている。SoCとの接続ピン対応は図3および表3のとおり。 **図 3 Z240-MP4 (CT/EA)**(画像) **表 3 Z240-MP4 (CT/EA)モジュールのピン対応** | 番号 | 名称 | |---|---| | 1 | GND | | 2 | VCC | | 3 | DC | | 4 | DD | | 5 | NC | | 6 | NWK_KEY | | 7 | NC | | 8 | NC | | 9 | NC | | 10 | UART_TX | | 11 | UART_RX | | 12 | RUN_LED | | 13 | NWK_LED | | 14〜23 | NC | | 24 | RESET | --- # 3 ZigBee®プロトコル概要 ZigBee®プロトコルの基本仕様のうち、本モジュールを使用したソフトウェア実装に必要な概要・機能・用語等の定義をまとめる。詳細は ZigBee® Specification 等を参照。 ## 3.1 通信プロトコルスタック ### 3.1.1 ZigBee®のレイヤー構造 IEEE 802.15.4 に基づき、物理層、メディアアクセス層、ネットワーク層、アプリケーション・サポート副層、アプリケーション層で構成される。 ### 3.1.2 IEEE 802.15.4物理層(PHY) 物理層は無線通信のハードウェアインタフェースと信号処理を担当し、データの変調、電波の放射、受信を行う。規格では2.4GHz、868MHz、915MHzが使用可能だが、日本国内では電波法の制約で2.4GHz帯のみ使用可能。本モジュールも2.4GHz帯をサポートする。 - **電波の送受信**: アンテナや無線モジュールなど送受信のためのインタフェースを提供。 - **無線信号データの変調**: IEEE 802.15.4でデジタルデータをアナログ信号に変換し無線波として送信。最大パケット長は127オクテット(PHYペイロード:PSDU)、約250kbps。アドレス情報が8オクテットの場合(送信元・送信先とも16bitショートアドレス)、MACペイロードは最大 127−{2(フレームコントロール)+1(シーケンス番号)+8(アドレス)+2(FCS)} = 114オクテット。本モジュールではさらにZigBee®プロトコルを使用するため、ペイロードはより小さくなり、ハードウェア上の制限もある。 - **周波数帯域の管理**: 使用地域に応じて周波数帯域を使い分ける。 - **通信チャネル管理**: 2.4GHz帯でZigBee®が使用可能な16チャンネルをサポート。 物理層の知識はソフトウェア実装では特に必要ないが、アンテナ・電波放射に関わる試験、無線通信の安定化、他の無線機器との共存のために必要となる。 ### 3.1.3 IEEE 802.15.4メディアアクセス層(MAC) 物理層の上位層で、ネットワーク上のデバイス間データ転送を管理する。データの衝突防止、効率的なチャネルアクセス、パケットのフレーム化、アドレス管理、CSMA/CAの管理を担う。 - **アドレスの管理**: 各デバイスの唯一無二の物理アドレス(MACアドレス)で正確な通信を行う。 - **フレーム化を利用したデータの送受信**: 最適なフレーム形式で送信し、受信側でフレームを再構成する。 - **チャネルアクセスの制御**: CSMA/CA方式で、複数デバイスが同じチャネルを使う場合の競合を回避。 - **チャネル上での衝突回避**: 送信中に他デバイスが同じチャネルを使用している場合、待機時間による調整などを行う。 ### 3.1.4 ZigBee®ネットワーク層(NWK) ネットワーク全体の構築・管理を担い、通信経路の選択とルーティング、ネットワークのスケーリング、デバイスの参加・脱退、アドレス管理を行う。 - **ネットワークトポロジーの選択と管理**: スター型、ツリー型、メッシュ型を構築可能。 - **ルーティング**: メッシュ型では、データが最適な経路で複数ノードを経由するよう選択してルーティングする。 - **ネットワークアドレスの管理**: 各デバイスに16ビットのネットワークアドレスを割り当てる。 - **デバイスの管理**: 新規デバイスの加入と既存デバイスの脱退を管理する。 ネットワーク管理はPAN IDによるネットワークの識別IDで行われ、それに属するか否かで参加/不参加の状態が管理される。ルータは、ネットワーク参加デバイス間のパケットをルーティングメカニズムで転送する。 ### 3.1.5 ZigBee®アプリケーション・サポート副層(APS) 物理層からネットワーク層とアプリケーション層をつなぐAPS副層までが通信規約で規定される。APSはアプリケーションデータの転送をサポートし、アプリケーション間通信の管理、データの暗号化・復号、セッション管理を担う。 - **アプリケーションデータの転送**: ネットワーク層とアプリケーション間でデータを送受信。 - **セッションの管理**: アプリケーション間データ転送時のセッションの確立・終了などを管理。 - **データの暗号化と復号**: セキュリティ機能を担う。 ### 3.1.6 ZigBee®アプリケーション層(APL) ネットワーク上のアプリケーションやサービスを定義する。ユーザが直接操作するデバイス(センサー、アクチュエーター、照明など)の制御や状態監視のためのプロトコル・サービスを提供する。 - **アプリケーションプロファイル**: どのデバイスがどの機能を担当するかを定義。通常は ZCL(ZigBee®クラスタライブラリ)に基づくプロファイルを使用する(例: ZigBee® Home Automation(ZHA)、ZigBee® Light Link(ZLL))。 - **ユーザインタフェース**: デバイスの動作・状態をユーザに知らせ、直接操作を受ける。 - **デバイス間通信**: センサー、アクチュエーター、照明などの状態監視や設定を行う。 ## 3.2 ルーティング ZigBee®には、ホップ数が少なく通信品質の高い経路を選んでフレーム(ZigBee®パケット)を転送するアルゴリズムがあり、メッシュ状ネットワークでも最適なルートでのフレーム転送が自動的に実現される。 ### 3.2.1 経路選択アルゴリズムについて メッシュルーティングは AODV(Ad hoc On-Demand Distance Vector)方式。経路探索時は Route Request(RREQ)コマンドをネットワーク全体にブロードキャストし、宛先デバイスがユニキャストで Route Reply(RREP)を応答して経路が決定する。 - RREQ転送中、デバイス間のリンク品質(RSSI)値が加算されながらリクエストに記録される。RSSIは8段階のコスト値で、リンク品質が高いほどコスト値は低い。RREQ到着時点で経路コストが分かり、最適(低コスト)な経路を選択できる。 - RREQはフラッディングされ可能な限り全転送経路を探索するため、宛先は複数のRREQを受信する。RREQは小さいパケットだが全経路探索のためネットワーク負荷は大きい。 - 宛先デバイスは受信した全RREQから最小パスコストのものを選び、RREPをユニキャストで応答する。各デバイスはRREQ転送中に、RREQの送信元、1つ前の転送デバイス、受信時点の総コスト、シーケンス番号等からなる経路テーブルを形成する。経路上の中継デバイスはRREP受信時、経路テーブルから対応エントリを見つけ、1つ前の転送デバイスへRREPをユニキャストする。 - 経路テーブルは「宛先アドレス」と「ネクストホップ」の組(距離ベクトル)で管理される(例: 宛先R1へはネクストホップR5へ転送)。各デバイスは最終宛先までの全経路を把握せず、次の転送先アドレスのみ把握する。 - 転送エラー時はルートエラー通知が行われ、経路を速やかに再構築できる。これらはファームウェアが自動で行い、アプリケーション/ソフトウェア実装者は経路管理を意識する必要がない。 - 経路中のルータ等の存在が失われ代替経路も探索できないと、ネットワークは分断され、全体が正しく機能しなくなる。 ### 3.2.2 経路再構築の動作について ノード間通信が失敗した場合、経路再構築が動的に行われる。 1. **ルート要求(RREQ)の送信**: 故障や停電でノードが失われた場合、失われたノード経由で通信していたノード(エンドデバイスまたはルータ)が、RREQメッセージをネットワーク内にブロードキャスト(フラッディング)する。受信した全ノードは経路検索の準備を始める。 - RREQの内容: 送信元アドレス(経路検索しているノード)、宛先アドレス(通信先ノード)、経路が見つからないことを示すフラグ、現在の経路情報、転送回数など再転送に関する制限 2. **経路の探索とルート応答(RREP)の送信**: RREQが行きわたると、宛先ノードまたは最適な中継ノードがRREQを受け取る。宛先ノード(エンドデバイスまたは親ルータ)が、最適経路を通じてRREPを送信元へ返送する。 - RREPの内容: 宛先ノードまでの最適な経路情報(パス)、その経路の信頼性やパスコスト(リンク品質、遅延など) 3. **経路の確立**: RREPが送信元に届くと、新しい経路を経路テーブルに追加する。以後のフレーム転送はこの経路を使用する。 4. **経路テーブルの更新**: 新しい経路が確立されると、ネットワーク内の各ルータやエンドデバイスも経路テーブルを更新し、他ノードからのフレームも新しい経路に沿って転送される。 ## 3.3 パケットの送受信とアドレス ネットワーク上で交換するフレーム(ZigBee®パケット)には、正しい通信のための識別符号が含まれる。 ### 3.3.1 アドレスとエンドポイント アドレスには、IEEE 64bitアドレス(ロングアドレス/拡張アドレス)と16bitアドレス(ショートアドレス/ネットワークアドレス)の2種類がある。 - **IEEE 64bitアドレス(IEEE 802.15.4 MACアドレス)**: デバイス固有の識別子。全ZigBee®デバイスが固有の64bitアドレスを持つ。通常は製造元が出荷時に付与するが、評価ボードなど実験・開発用機器には付与されていない場合もある。イーサネットの48bit MACアドレスに相当。本モジュールには固有のIEEE 64bitアドレスが埋め込まれ、書き換えできない。 - **16bitアドレス(ZigBee®ショートアドレス)**: PAN参加時に動的に割り当てられる。同一PAN内では一意である必要があるが、異なるPANでは重複しうる。PAN参加の都度、空いている16bitアドレスが割り当てられる(DHCPを使用するプライベートIPネットワークに近い)。パケット送受信には主にこの16bitアドレスを使う。 **エンドポイント**: TCP(UDP)/IPのポート番号に類似した概念。0〜255が使用でき、0番はZigBee®(ZDO)、255番は全エンドポイントを指す予約番号。アプリケーションは1〜254から任意に選ぶ。1デバイス上で独立した複数のアプリケーションを動作させる仕組み。パケット送信時は宛先エンドポイント番号をあらかじめ指定する必要があり、送信側は自身のエンドポイント番号も送信するため、受信側はどのエンドポイントへ応答すべきか判別できる。 ### 3.3.2 ブロードキャスト ブロードキャストは通常、宛先を16bitアドレス 0xFFFF とする。パケットはコピーされながらネットワーク全体へ送信される。他に 0xFFFD(コーディネータ、ルータ、スリープしていないエンドデバイスが対象)、0xFFFC(コーディネータ、ルータのみ対象)がある。 マルチホップ通信のため、ブロードキャストは全体へ転送される可能性がある。転送を伴わないものを「狭義のブロードキャスト」、転送が起こりうるものを「フラッディング」と区別する場合もある。フラッディングでの転送回数の上限は、送信時に指定する Broadcast Radius(ブロードキャスト半径)で決まる。radius = 1 の場合は周囲のデバイスが受信した時点で終了し転送されない(狭義のブロードキャスト)。宛先指定が不要で便利だが、必要最小限のradiusを設定することがネットワークの安定利用に重要。 ### 3.3.3 Ackと再送 ZigBee®のデータ通信は基本的に、相手へのパケット到達を確認できない(できない前提で使用する)。送信時にAckオプションを指定することで送達確認を受け取れる。MAC層とAPS層の2か所でAck制御が作用する。 - MAC層Ack: 直接届く宛先との間で使用できる。ブロードキャスト以外では、MAC層のAckオプションは必ず有効で送信される。直接送信するデバイスに限り、宛先からAckが戻ったかで送達確認できる。 - APS層Ack: 2ホップ以上離れた宛先には(明示的に)APS層Ackを使用する。メッシュネットワークで数ホップ先の宛先からの送達確認を要求できる。送信時の制御ビットフィールドで「Ack要求」フラグを立てる。 - MAC層でもAPS層でも、宛先からAckが受信できなかった場合は自動的に再送される。電波状態が悪い場面でも確実に届け、送達確認が可能になる。 - 注意: APS層AckもMAC層ではデータとして扱われ、MAC層でのAck制御の対象になる。MAC層でも連鎖的にデータとAck制御が発生し、APS層Ackはメッシュ全体で作用するため、データまたはAck(または両方)で、送信時に経路が確立していない状態になりうる。その場合は経路制御が優先されフラッディングが発生し、Ack制御がない場合の数倍のトラフィックが発生する。 ## 3.4 ZigBee®アプリケーション 異なる種類のZigBee®機器同士が相互に正しく通信できるよう、アプリケーションレベルの互換性を維持する仕様が含まれる。ここで示すプロファイル関連仕様は、ZigBee®や本モジュールの使用に必須の要件ではない。各社提供の、または一般にZigBee®互換として販売されているデバイスと相互通信するために必要な要件で、これを満たすことでZigBee®認証取得やアプリケーションレベルの互換性を担保できる。 ### 3.4.1 プロファイル 「プロファイル」でやり取りするデータの形式・解釈を定義する。パケットがどのプロファイルかを分かるようにして送信する必要がある。 プロファイル番号にはパブリックとプライベートがあり、基本的に自由に決められない(実験・評価用などの例外あり)。パブリックプロファイル番号は Connectivity Standards Alliance が管理し割り当てる(例: Smart Energy Profile = 0x0109、Home Automation Profile = 0x0104)。プライベートプロファイルIDは、CSAから製造者固有プロファイル(MSP)の試験で認定を受け、企業が自由に使用できる一定範囲の番号を割り当てられるもの。 ### 3.4.2 クラスタ クラスタ番号はZigBee®独自で、パケットが運ぶデータの内容・種類を示す識別子。受信側はペイロードを解析する前でもクラスタ番号から中身が分かる。2バイト長で、同一プロファイル内では同じ番号を使えないが、異なるプロファイルでは同じ番号が使われる場合がある。製造者固有プロファイルではアプリケーションが自由にクラスタ番号を決められる。パブリックプロファイルではクラスタ番号やデータ形式がすべて定義済みで、その定義に従って送受信する必要がある。 ### 3.4.3 フレームフォーマット ZigBee® NWKフレーム(NPDU)のフォーマットの概略。ZigBee®パケット部を含むIEEE 802.15.4規定のフレーム全体は図11のように構成され、NWKフレームはその内部にZigBee®パケットの構成要素として内包される。 本モジュールが管理するフレーム内のNWK層等の情報は: - フレームコントロール、アドレッシング、シーケンス情報を含むNWKヘッダ - 各フレームタイプに基づく情報を含む可変長のNWKペイロード - ZigBee®フレームのペイロード保護のため、暗号化などの情報管理を行うSecurityヘッダ で構成され、ZCLプロファイルに基づく実装ではNWKペイロードにAPS層やZCLに基づく情報が格納される。APSヘッダ、ZCLヘッダは全アプリケーションプロファイルとZigBee®クラスタ/コマンドに共通の形式に従う。APSヘッダはフレームのクラスタを宣言し、ZCLヘッダはコマンドを宣言する。ZCLペイロードは一部のクラスタ/コマンドのみに存在し、コマンド固有の形式に従う。一部のコマンドは特定クラスタのみに利用可能だが、一般的なコマンドは全クラスタに使用できる。一般的なコマンドフレームは、個々のクラスタに固有でない属性やその他一般的なタスクの操作に使用される。 NWK層のヘッダ、セキュリティなどの設定や暗号化はファームウェアが自動的に構成・処理するため、ソフトウェア実装者からは隠蔽される。パケットキャプチャ等の機器で観測すれば解析可能。 NWK層レベルのフレームフォーマットはMAC層で伝送される順に左から右へ記述され、最も左のビットが最初に送信される。1オクテットより長いフィールドは、最小番号のビットを含むオクテットから最大番号のビットを含むオクテットの順にMAC層へ渡される。Frame controlフィールドの16ビットの詳細は図14(フレームタイプ、アドレッシング、シーケンス、その他のコントロールフラグ)。詳細は ZigBee® Specification を参照。 ### 3.4.4 ペイロードサイズ ペイロードサイズはIEEE 802.15.4の規定に制限される。最大77バイトのZCLペイロードをサポートする。実際にはAPS、ZCLヘッダ等の使用でさらに制約を受ける。ペイロード長を超えるユニキャストパケット送信時はフラグメントでパケットが分割される。ブロードキャストではフラグメントされず、最大パケット長を超えるとエラーとなり送信されない。 --- # 4 モジュール機能実装手順 ZigBee®デバイスにエンドデバイス、ルータ、コーディネータの各機能を実装する手順概要と、デフォルト機能である透過伝送モードの使用手順を記載する。 ## 4.1 モジュールの準備 工場出荷時設定の状態から開始する手順。各手順の実行時は、UARTシリアルポートにHEXコマンドを入力する外部MCUを接続する。設定が変更されている場合は、工場出荷時設定に戻すHEXコマンドで初期化してから実行する。 ## 4.2 モジュール共通のネットワーク設定 ZigBee®3.0準拠の他デバイスとの通信互換性がある。相互通信には、個々のデバイスを同じPAN(Personal Area Network)に所属させる必要がある。 ### デバイスタイプの設定 | 役割 | HEXコマンド | |---|---| | コーディネータ | `55 04 00 05 00 05` | | ルータ | `55 04 00 05 01 04` | | スリープエンドデバイス | `55 04 00 05 03 06` | | 非スリープ(常時稼働)エンドデバイス | `55 04 00 05 02 07` | 設定反映にはリセット操作が必要: ``` 55 07 00 04 00 FF FF 00 04 ``` ### PAN IDの設定 デフォルトでは16ビット範囲(0xFFFFを除く)でランダムな値が自動決定される。PAN IDを0x1111に指定する例: ``` 55 05 00 08 11 11 08 ``` ### チャンネルリストの設定 2.4GHz帯には16チャンネル(11〜26)がある。チャンネル17(0x11)のみ指定する例: ``` 55 05 00 06 02 11 15 ``` ## 4.3 エンドデバイスの実装手順 ZigBee® HA(Home Automation)プロファイルに適合するエンドデバイス実装例。 ### 1. ネットワーク設定 4.2節を実施する。 ### 2. アプリケーションエンドポイントの設定 #### ① ポートの作成 ZCL仕様に基づき入力クラスタ・出力クラスタを設定する。On/Offスイッチアプリケーションのポート作成例(入力クラスタをID=0x0000、0x0003、0x0006と定義): ``` 55 11 00 40 0D 01 04 01 00 01 03 00 00 03 00 06 00 00 4E ``` #### ② ポートに属性を追加 作成したポートに属性を追加する。同一クラスタID内の属性追加は連続実行し、異なるクラスタIDの前には特別な属性ID(0xFFFD)を指定する。複数のHEXコマンド実行例: ``` 55 0C 00 41 00 00 00 00 00 00 20 01 00 60 55 0C 00 41 00 00 00 00 01 00 20 01 00 61 55 0C 00 41 00 00 00 00 02 00 20 01 00 62 ``` (原文は「以下続く」として以降省略) #### ③ ポートと属性設定の保存 設定内容をFLASHに保存: ``` 55 03 00 42 42 ``` リセット操作を実行: ``` 55 07 00 04 00 FF FF 00 04 ``` ### 3. ネットワーク参加 エンドデバイスをコーディネータが作成したネットワークに参加させる。ネットワーク接続開始: ``` 55 03 00 02 02 ``` ### 4. アプリケーション動作の実装 #### ① 属性値の通知 On/Offスイッチの現在状態をコーディネータへ通知する。 On(=0x01)の書き込み: ``` 55 0D 00 43 01 00 00 06 00 00 00 00 00 01 45 ``` Off(=0x00)の書き込み: ``` 55 0D 00 43 01 00 00 06 00 00 00 00 00 00 44 ``` #### ② 制御コマンド受信時の動作実装 外部MCU側で受信するHEXコマンド(非同期メッセージ)例: Onに設定: ``` 55 0F 82 0F 20 00 00 01 2A 00 06 00 00 00 DB 01 5A ``` Offに設定: ``` 55 0F 82 0F 20 00 00 01 39 00 06 00 00 00 D5 00 46 ``` 受信した制御命令に対し、外部MCUで「属性値の書き込み処理」を実装することで、命令の結果を即時にZigBee®ゲートウェイへ通知する。 ## 4.4 ルータの実装手順 ルータは他ノードが送受信するフレームを中継する。この動作はファームウェア内蔵のルーティング処理で自動的に行われる。 1. **ネットワーク設定**: 4.2節を実施 2. **アプリケーションエンドポイント設定(任意)**: 4.3節を参照 3. **ネットワークに参加**: ネットワーク接続開始 ``` 55 03 00 02 02 ``` ここまででルータ動作が実現でき、ネットワーク参加後に自動的にフレームのルーティング処理が開始される。 4. **アプリケーション動作の実装(任意)**: 4.3節を参照 ## 4.5 コーディネータの実装手順 コーディネータはショートアドレス配布、チャンネル決定、ネットワークキー交換などの機能を持つが、これらはファームウェア内蔵の処理で自動的に行われる。 1. **ネットワーク設定**: 4.2節を実施 2. **アプリケーションエンドポイント設定(任意)**: 4.3節を参照 3. **ネットワークを開始**: ネットワーク作成 ``` 55 03 00 02 02 ``` ここまででPAN IDが一意に定められたコーディネータ動作が実現でき、ネットワークが作成され自動的にコーディネータとしての処理が開始される。 4. **アプリケーション動作の実装(任意)**: 4.3節を参照 ### 5. コーディネータ動作の実装 コーディネータは、作成したネットワークに所属する全ノードを管理する。 #### ① 新規ノードのネットワーク許可のオン/オフ 新規ノード参加許可をオン(180秒間有効): ``` 55 03 00 02 02 ``` 新規ノード参加許可をオフ: ``` 55 03 00 03 03 ``` #### ② ノードのネットワーク参加/離脱状態の管理 参加済みノードのショートアドレスとMACアドレスを外部MCUで記憶する必要がある。ノード参加時またはショートアドレス更新時の通知メッセージ: ``` 55 0E 80 04 C6 DE E2 08 00 4B 12 00 1A 47 02 70 ``` ノードがネットワークから離脱した場合の通知メッセージ: ``` 55 0B 80 06 51 20 9F 0C 00 4B 12 00 3D ``` #### ③ ノードのアプリケーション情報の収集 各ノードのエンドポイントに設定されているアプリケーション情報を取得する。ノードがサポートするポート番号の照会コマンド例: 入力コマンド: ``` 55 05 01 05 3B B1 8E ``` 応答メッセージ: ``` 55 09 80 04 3B B1 0A 00 01 01 04 ``` ノードのポートがサポートするクラスタの照会コマンド例: 入力コマンド: ``` 55 06 01 04 3B B1 01 8E ``` 応答メッセージ: ``` 55 1D 81 04 3B B1 0C 00 01 04 01 00 01 00 06 00 00 01 00 02 00 03 00 04 00 08 FC 03 00 00 03 00 08 FC A5 ``` #### ④ ノードへの制御命令の送信 ノードのアプリケーションエンドポイントへ制御命令を送信する。ZigBee® HA準拠のOn/Offスイッチ制御コマンド例: Offに設定(コマンドID=0x00): ``` 55 0F 02 0F 3B B1 01 B4 00 06 00 00 00 00 00 34 ``` Onに設定(コマンドID=0x01): ``` 55 0F 02 0F 3B B1 01 B4 00 06 00 00 00 00 01 35 ``` On/Offトグル設定(コマンドID=0x02): ``` 55 0F 02 0F 3B B1 01 B4 00 06 00 00 00 00 02 36 ``` 送信成功時の確認メッセージ: ``` 55 0A 8F 02 00 3B B1 01 B4 00 00 B2 ``` 送信失敗時(ステータスコード0xE9)の確認メッセージ: ``` 55 0A 8F 02 00 3B B1 01 B4 00 E9 5B ``` #### ⑤ ノードからの情報通知を受信 センサーデータ等の属性値更新時の通知メッセージ例: ``` 55 17 82 0A 00 F9 D0 01 02 01 08 FC 00 20 CE 02 03 00 10 00 04 00 20 00 8C ``` #### ⑥ ノードの死活監視 参加済みの各ノードの参加状態を定期的に確認する処理を実装する。典型的な実装: - ノードからの属性通知の受信時刻を記憶し、現在時刻と比較 - ノードに応答を要求するZCLコマンドを送信し、応答の有無を確認 属性値読み取りコマンド例: 入力コマンド: ``` 55 11 02 00 00 52 13 01 32 00 08 FC 00 20 00 01 00 00 2F ``` 応答メッセージ: ``` 55 17 82 00 00 52 13 01 32 01 08 FC 00 20 FF 01 00 00 00 23 00 C2 01 00 3B ``` #### ⑦ 収集したノード情報を別システムへ転送 コーディネータが収集・保存しているノード情報をクラウドサーバ等へ転送する。典型的な実装例: - CSVやJSONなどのデータ形式への変換 - アップロード間隔・ルールの決定 - HTTP、MQTTなどのプロトコルでサーバへ送信 - サーバ側でのグラフ化や動作決定 ## 4.6 透過伝送機能 外部MCUからUARTシリアルピンへ直接入出力したバイト列を「ZigBee®のフレームペイロードとして透過的に伝送」できる機能。ZCLポート作成などの設定を省略し、モジュール同士で任意のデータ列を送受信できる。 HEXコマンドモードから透過伝送モードへ切り替えて使用する。切替後のUARTシリアル入力データはZigBee®プロトコルで無線送信され、受信側のUARTシリアルに出力される。 モジュール同士の1対1通信のペアリング手順は2通り: - 対向デバイスのショートアドレスを互いに設定する手動設定手順 - 自動でペア探索を実行させるペアリング機能 透過伝送機能は、ユニキャスト、マルチキャスト、ブロードキャスト通信をサポートする。 ### 4.6.1 ユニキャスト透過伝送 本モジュール2つで1対1の双方向通信を行うパターン。 設定の流れ: 1. 同一ネットワークに参加 → 2. ターゲットアドレスとポートの設定 → 3. UARTシリアルを透過伝送モードに切り替え #### ① 同一のネットワークに参加 両モジュールで次を実施: 4.2節 モジュール共通のネットワーク設定、6.1.2項 ネットワークを開く/ネットワーク接続の開始(コマンドコード0x02)。 #### ② ターゲットアドレスとポートの設定 宛先ノードのショートアドレス(ターゲットアドレス)とポート番号(ターゲットポート)を定義する。モジュールA(ショートアドレス0x000A)、モジュールB(同0x000B)の場合: モジュールA - ターゲットアドレスを0x000Bに設定: ``` 55 08 00 11 00 01 00 0B 00 1B ``` モジュールB - ターゲットアドレスを0x000Aに設定: ``` 55 08 00 11 00 01 00 0A 00 1A ``` モジュールA、B両方 - ターゲットポートを0x01に設定: ``` 55 07 00 11 00 02 00 01 12 ``` ペアリング機能を使用する場合(コーディネータ以外)、NWK_KEYピンにLow信号を入力するか、次のコマンドを実行: モジュールA、B両方: ``` 55 04 00 14 00 14 ``` #### ③ UARTシリアルを透過伝送モードに切り替え 両モジュールに送信: ``` 55 07 00 11 00 03 00 01 13 ``` 切替後、一方のUARTシリアルに任意のバイト列を入力すると他方のUARTシリアルに出力される。HEXコマンドモードに戻すにはASCII文字「+++」(0x2B,0x2B,0x2B)を入力する。 ### 4.6.2 マルチキャスト透過伝送(グループ同報通信) 複数モジュールを1つのグループとして構成し、同一グループのノードのみを対象に通信するパターン。 設定の流れ: 1. 同一ネットワークに参加 → 2. グループの設定 → 3. ターゲットアドレスとポートの設定 → 4. 透過伝送モードに切り替え #### ① 同一のネットワークに参加 両モジュールで 4.2節、6.1.2項(コマンドコード0x02)を実施。 #### ② グループの設定 グループ1に属する全モジュール - グループID 0x0001を追加: ``` 55 06 00 0A 00 01 00 0B ``` グループ2に属する全モジュール - グループID 0x0002を追加: ``` 55 06 00 0A 00 02 00 08 ``` #### ③ ターゲットアドレスとポートの設定 マルチキャストでは、ターゲットアドレスに送信先グループIDを指定し、ターゲットポートに0xFFを指定する。 グループ1の全モジュール - ターゲットアドレスをグループID 0x0001に設定: ``` 55 08 00 11 00 01 00 01 00 11 ``` グループ2の全モジュール - ターゲットアドレスをグループID 0x0002に設定: ``` 55 08 00 11 00 01 00 02 00 12 ``` グループ1、2の全モジュール - ターゲットポートを0xFFに設定: ``` 55 07 00 11 00 02 00 FF EC ``` #### ④ UARTシリアルを透過伝送モードに切り替え 全モジュールに送信: ``` 55 07 00 11 00 03 00 01 13 ``` 切替後、UARTシリアルに任意のバイト列を入力すると、同一グループ内の(送信元自ノードを除く)全モジュールのUARTシリアルに出力される。 **留意点**: マルチキャスト透過伝送では、受信側はAPS層Ack応答を行わず、送信側での再送も行われない。到達確認が必要な場合は、ユーザがアプリケーション層で処理を実装する。ホップ数が大きくなると、同一グループでもパケットが届かない可能性がある。 ### 4.6.3 ブロードキャスト透過伝送 同一ネットワークの全ノードを対象に通信するパターン。 設定の流れ: 1. 同一ネットワークに参加 → 2. ターゲットアドレスとポートの設定 → 3. 透過伝送モードに切り替え #### ① 同一のネットワークに参加 全モジュールで 4.2節、6.1.2項(コマンドコード0x02)を実施。 #### ② ターゲットアドレスとポートの設定 ブロードキャスト用の専用値として、ショートアドレス 0xFFFC、0xFFFD、0xFFFF が使用可能。 ターゲットアドレスを0xFFFFに設定: ``` 55 08 00 11 00 01 FF FF 10 ``` ターゲットポートを0xFFに設定: ``` 55 07 00 11 00 02 00 FF EC ``` #### ③ UARTシリアルを透過伝送モードに切り替え 全モジュールに送信: ``` 55 07 00 11 00 03 00 01 13 ``` 切替後、UARTシリアルに任意のバイト列を入力すると、同一ネットワークの全モジュール(自身を除く)のUARTシリアルに出力される。 **留意点**: ブロードキャスト透過伝送では、マルチキャストと同様、再送やAPS層Ack応答がないため、到達確認はアプリケーション層で実装する。ルーティングの最大ホップ数制限により、対象ノードにパケットが届かない可能性がある。 送信フレームのNWK層のradius値は、ZigBee®仕様の上限値30がデフォルト。radiusの指定は、HEXコマンドモードのZCLコマンド入力パラメータ「送信モード」のbit7(最上位ビット)が該当し、1または30に指定可能。 --- # 5 シリアルポートコマンドのフォーマットと設定モード ## 5.1 シリアルポートコマンドのフォーマット シリアルポートは全二重通信方式。入力・出力を問わず、すべて表4のコマンドフレーム形式で行われ、フレームの整合性を保証する仕組みがある。外部MCUからのコマンドは必ず完全なフレーム構造を持つ必要がある。ZigBee®ネットワーク上では外部から届くメッセージのタイミング・内容が多様で予測が難しいため、モジュールのTXからも随時データが出力されうるが、これらもすべてフレーム構造に則った形式で出力される。 **表 4 コマンドフレーム構造** | 名前 | フレームヘッダ | フレーム長 | フレームロード | |---|---|---|---| | バイト数 | 1 | 1 | 可変長 | - **フレームヘッダ**: コマンドの開始位置。0x55 - **フレーム長**: フレームロードの長さ。最大値は255 - **フレームロード**: シリアルポートフレームの有効データ(チェックコードを含む)。フレーム長と同じバイト数のフレームロードを受信すると、完全なコマンドフレームとして受信完了 ### コマンドモード 入力コマンド、フィードバックメッセージ、非同期メッセージの3つがある。 - **入力コマンド**: 完全なコマンドフレームとしてモジュールに入力されたコマンドフレーム。 - **フィードバックメッセージ**: 入力コマンド受信時に、各コマンドに対応して生成される。原則として、コマンド入力後はフィードバックメッセージを待つ必要がある。連続するコマンドフレームに対してもフォールトトレラントに動作し、複数コマンドを続けて入力しても、それぞれのフィードバックが順次返される(フィードバックが連続出力されることがある)。待ち時間は内蔵SoCの処理時間により最大10秒程度かかる場合がある。 - **非同期メッセージ**: モジュールから外部MCUへ送信されるコマンドのうち、入力コマンドと因果関係がある場合とない場合がある。内部状態やネットワーク状況に依存して発生し、発生タイミングは一定でない。 **表 5 フレームロード構造とシリアルポートコマンド** | 名前 | コマンドタイプ | コマンドコード | コマンドデータ / メッセージデータ | チェックコード | |---|---|---|---|---| | バイト数 | 1 | 1 | 0~252 | 1 | - **コマンドタイプ**: コマンドモードと動作メカニズムによる分類コード。入力コマンド・フィードバックメッセージは0x00~0x7F、非同期メッセージは0x80~0xFF。 - **コマンドコード**: コマンドの個別コード(1バイト)。 - **コマンドデータ/メッセージデータ**: 追加パラメータ(0~252バイト)。 - **チェックコード**: チェックコード部分を除くフレームロードの XOR8 チェックサム(1バイト)。 - **フレームロードサイズ**: コマンドタイプ・コマンドコード・チェックコードを含むため最小3バイト、最大255バイト。 ### シリアル通信の連続処理 モジュールのTX出力は、フィードバックメッセージや非同期メッセージを非常に短時間に連続出力することがある。外部MCUは受信データを「フレームヘッダ」「フレーム長」「フレームロード」の形式に従って解析し、完全なフレームロードを抽出して処理する必要がある。TX出力は表4の形式に則り、チェックコードまで途切れずに出力される。実装例として、次のコマンドが5ミリ秒以内に受信されない場合はタイムアウトと判断し、以後は新たなフレームヘッダからの受信・抽出処理を行う、という実装が可能。 ## 5.2 コマンドとメッセージの種類 **表 6 コマンドおよびメッセージの種類一覧** | コマンド分類 | コマンドタイプ | ディスクリプタ | コマンドタイプ名 | |---|---|---|---| | 入力コマンド / フィードバックメッセージ | 0x00 | TYPE_CFG | ローカル設定コマンド | | | 0x01 | TYPE_ZDO_REQ | ネットワーク管理コマンド | | | 0x02 | TYPE_ZCL_SEND | ZCLコマンド | | 非同期メッセージ | 0x80 | TYPE_NOTIFY | システム通知メッセージ | | | 0x81 | TYPE_ZDO_RSP | ネットワーク管理応答メッセージ | | | 0x82 | TYPE_ZCL_IND | ZCL受信メッセージ | | | 0x8F | TYPE_SEND_CNF | 送信確認メッセージ | ### 「入力コマンド」と「非同期メッセージ」の因果関係 - 非同期メッセージ TYPE_NOTIFY は入力コマンド TYPE_CFG に起因して生成される。ただし TYPE_CFG が必ずしも TYPE_NOTIFY を伴うとは限らない。 - TYPE_ZDO_RSP は TYPE_ZDO_REQ に起因して生成される。ただし TYPE_ZDO_REQ が必ずしも TYPE_ZDO_RSP を伴うとは限らない。 - TYPE_ZCL_IND は TYPE_ZCL_SEND に起因して生成される。ただし TYPE_ZCL_SEND が必ずしも TYPE_ZCL_IND を伴うとは限らない。TYPE_ZCL_IND のパラメータ「コマンドID」が TYPE_ZCL_SEND のコマンドIDと一致する場合、その非同期メッセージは当該入力コマンドに起因して生成されたものと判断できる。 - TYPE_SEND_CNF は、有効な TYPE_ZDO_REQ または TYPE_ZCL_SEND コマンドが入力されるたびに生成される。送信状況を外部MCUに通知し、外部MCUは送信完了を待たずノンブロッキングで処理を継続できる。一時データの保持や送信待ちによる停滞を避けられ、特に複数ターゲットへの連続送信で有用。 - TYPE_ZDO_REQ と TYPE_ZCL_SEND は無線通信を伴うため、無線伝送の遅延や順序の乱れが対応する非同期メッセージに現れることがある。 **図 22 シリアルポートコマンド3レイヤーの応答の概略図**(画像) - シリアルコマンドを入力すると、まず内蔵SoCのMCUで処理される。正常動作時は1〜2ミリ秒程度遅れてフィードバックメッセージが出力される。フィードバックがあることはモジュールが正常動作していることを示す。フィードバック結果は表14 無線送信ステータスのとおり。 - 正常動作時、シリアルコマンドは無線信号に変換されZigBee®通信で送信される。ZigBee®は通信速度が遅いため、ターゲットに届くまでに「遅延2」(図22)が発生する。信号がターゲットに届いたかに関わらず、送信状況を通知する送信確認メッセージが生成される。「遅延2」には送信処理、ルート経由の転送、再送信などが含まれ、最短で数ミリ秒、最長で20秒程度かかる場合がある。送信確認の結果は表14のとおり。 - ターゲットに送信されると、ターゲットは処理結果のメッセージを返す。「遅延3」(図22)には、対向デバイスの信号送信の遅延、およびFLASH読み書き、センサー駆動、周辺機器の動作など対向デバイスの信号処理の遅延が含まれる。このメッセージの結果は表16 ZCLステータスを参照。 ## 5.3 コマンドコード **表 7 ローカル設定コマンド**(コマンドタイプ 0x00) | コマンドコード | ディスクリプタ | コマンド名 | |---|---|---| | 0x00 | CFG_STATUS | 現在のモジュール状態を照会 | | 0x02 | CFG_OPEN_NET | ネットワークを開く/ネットワーク接続を開始 | | 0x03 | CFG_CLOSE_NET | ネットワークをオフにする/ネットワーク接続を停止 | | 0x04 | CFG_RESET | リセット/工場出荷時の状態に戻す | | 0x05 | CFG_NODE_TYPE | モジュールタイプを設定 | | 0x06 | CFG_CHANNEL | チャンネルの照会と設定 | | 0x07 | CFG_GET_PANID | PAN IDの照会 | | 0x08 | CFG_SET_PANID | PAN IDの設定 | | 0x09 | CFG_VIEW_GROUP | モジュールのグループの照会 | | 0x0A | CFG_ADD_GROUP | モジュールをグループに追加 | | 0x0B | CFG_REMOVE_GROUP | モジュールをグループから削除 | | 0x0D | CFG_SET_POWER | 送信出力を設定 | | 0x0F | CFG_TEST | テストモードの実行 | | 0x10 | CFG_READ_ATTR | ローカル属性の照会 | | 0x11 | CFG_WRITE_ATTR | ローカル属性の変更 | | 0x14 | CFG_FIND_BIND | 自動接続の設定 | | 0x16 | CFG_AT_MODE | ATコマンドモードに切り替え | | 0x22 | CFG_GET_ADDRTAB | ネットワーク参加ノードのアドレス照会 | | 0x28 | CFG_EZ_MODE | デバイス情報通知の再送信 | > 原文注意: 表7には 0x18/0x19/0x1A(PWM・拡張PAN ID)や 0x40〜0x44(ZCLポート/属性)が載っていないが、第6章(表25および6.1.x)には存在する。 **表 8 ネットワーク管理コマンド**(コマンドタイプ 0x01) | コマンドコード | ディスクリプタ | コマンド名 | |---|---|---| | 0x00 | ZDO_NWK_ADDR_REQ | デバイスのショートアドレスの照会 | | 0x01 | ZDO_IEEE_ADDR_REQ | デバイスのMACアドレスの照会 | | 0x04 | ZDO_SIMPLE_DESC_REQ | デバイスがサポートするクラスタの照会 | | 0x05 | ZDO_ACTIVE_EP_REQ | デバイスがサポートするポート番号の照会 | | 0x21 | ZDO_BIND_REQ | ノードの常時接続バインディングの設定 | | 0x22 | ZDO_UNBIND_REQ | ノードの常時接続バインディングの解除 | | 0x33 | ZDO_MGMT_BIND_REQ | ノードの常時接続バインディングの照会 | | 0x34 | ZDO_MGMT_LEAVE_REQ | ノードの削除 | **表 9 デバイスの状態管理とデバイス制御(ZCLコマンド)**(コマンドタイプ 0x02) | コマンドコード | ディスクリプタ | コマンド名 | |---|---|---| | 0x00 | ZCL_READ_ATTR_REQ | デバイス属性の照会 | | 0x01 | ZCL_WRTIE_ATTR_REQ | デバイス属性を変更 | | 0x02 | ZCL_READ_REPORT_REQ | 属性のレポート規則の照会 | | 0x03 | ZCL_WRITE_REPORT_REQ | 属性のレポート規則の設定 | | 0x04 | ZCL_DISC_ATTR_REQ | 全ての属性の照会 | | 0x05 | ZCL_DISC_ATTR_EX_REQ | 拡張フィールドを含む全ての属性の照会 | | 0x0F | ZCL_CMD | 制御コマンドの送信 | (ディスクリプタ名 `ZCL_WRTIE_ATTR_REQ` の綴りは原文ママ) **表 10 システム通知メッセージ**(コマンドタイプ 0x80) | コマンドコード | ディスクリプタ | コマンド名 | |---|---|---| | 0x00 | NOTIFY_BOOT | モジュール起動の通知 | | 0x01 | NOTIFY_NET_STATUS | ネットワーク状態変化の通知 | | 0x02 | NOTIFY_NET_OPEN | ネットワーク開始/停止の通知 | | 0x03 | NOTIFY_NODE_JOIN | ノードのネットワーク接続の検出の通知 | | 0x04 | NOTIFY_NODE_ADDR | モジュールのショートアドレス更新の通知 | | 0x05 | NOTIFY_DEVICE_JOIN | デバイス情報の通知 | | 0x06 | NOTIFY_LEAVE | モジュールのオフグリッドの通知 | | 0x10 | NOTIFY_FIND_BIND | 接続の自動確立の通知 | **表 11 ネットワーク管理コマンドの応答メッセージ**(コマンドタイプ 0x81) | コマンドコード | ディスクリプタ | コマンド名 | |---|---|---| | 0x00 | ZDO_NWK_ADDR_RSP | デバイスのショートアドレスの照会 | | 0x01 | ZDO_IEEE_ADDR_RSP | デバイスのMACアドレスの照会 | | 0x04 | ZDO_SIMPLE_DESC_RSP | デバイスがサポートするクラスタの照会 | | 0x05 | ZDO_ACTIVE_EP_RSP | デバイスがサポートするポート番号の照会 | | 0x21 | ZDO_BIND_RSP | ノードの常時接続バインディングの設定 | | 0x22 | ZDO_UNBIND_RSP | ノードの常時接続バインディングの解除 | | 0x33 | ZDO_MGMT_BIND_RSP | ノードの常時接続バインディングの照会 | | 0x34 | ZDO_MGMT_LEAVE_RSP | ノードの削除 | **表 12 ZCLコマンドの受信と制御の応答メッセージ**(コマンドタイプ 0x82) | コマンドコード | ディスクリプタ | コマンド名 | |---|---|---| | 0x00 | ZCL_READ_ATTR_RSP | デバイス属性の照会 | | 0x01 | ZCL_WRTIE_ATTR_RSP | デバイス属性を変更 | | 0x02 | ZCL_READ_REPORT_RSP | 属性のレポート規則の照会 | | 0x03 | ZCL_WRITE_REPORT_RSP | 属性のレポート規則の設定 | | 0x04 | ZCL_DISC_ATTR_RSP | 全ての属性の照会 | | 0x05 | ZCL_DISC_ATTR_EX_RSP | 拡張フィールドを含む全ての属性の照会 | | 0x0A | ZCL_REPORT_IND | 属性のアクティブレポートの受信 | | 0x0B | ZCL_DEFAULT_RSP | デフォルトの応答フレームの受信 | | 0x0F | ZCL_CMD_IND | 制御コマンドの受信 | **表 13 送信確認メッセージ**(コマンドタイプ 0x8F) | コマンドコード | ディスクリプタ | コマンド名 | |---|---|---| | 0x01 | ZDO_SEND_CNF | ネットワーク管理コマンドの送信確認メッセージ | | 0x02 | ZCL_SEND_CNF | ZCLコマンドの送信確認メッセージ | ## 5.4 無線送信ステータス 表14は、フィードバックメッセージおよび送信確認メッセージに含まれ、各種異常の検出に使用される。シリアルポートへの書き込みデータ量がZigBee®通信速度より大きい場合、Bluetooth®やWi-Fi®の高密度環境、ターゲットデバイスの切断などで通信異常が発生しうる。返されたコマンドの異常ステータス値で原因を判断できる。 **表 14 無線送信ステータス**(Ackの応答、一般コマンドフィードバック、独自コマンドフィードバックは、すべてこの表に対応) | ステータス値 | 状態の説明 | |---|---| | 0x00 | Successful operation 操作が成功 | | 0x01 | Operation failed 操作が失敗 | | 0x02 | Parameter error パラメータエラー | | 0x10 | Memory error メモリエラー | | 0x11 | Memory full メモリが一杯 | | 0x12 | The mode does not support このモードはサポートされていない | | 0x1A | The MAC layer has insufficient resources MAC層のリソースが不足 | | 0xC2 | The order is void この命令は無効 | | 0xCD | The target device does not exist ターゲットデバイスが存在しない | | 0xB7 | Target device missed message (with APS Ack on) ターゲットデバイスがメッセージを受信できなかった(APS層Ackが有効時) | | 0xE1 | Channel disturbance チャンネル干渉 | | 0xE9 | Confiscated by the payment of the MAC Ack MAC層Ackが受信できなかった | | 0xF0 | Device hibernation caused a send timeout デバイスのスリープ状態により送信タイムアウトが発生 | | 0xF1 | The sending queue is full 送信キューが一杯 | ## 5.5 ZCL属性データ型 ZCLコマンドでターゲットデバイスの状態を管理する場合、属性に対して「読み取り」「書き込み」「確認」の基本操作を行い、データ型に応じたサイズのデータ値を処理する。 **表 15 ZCL属性データ型** | 分類 | データ型 | ID | バイト数 | 無効値 | レポートアライメント | |---|---|---|---|---|---| | NULL | - | 0x00 | 0 | - | 0 | | 通常データ | data8 | 0x08 | 1 | - | 0 | | | data16 | 0x09 | 2 | - | 0 | | | data24 | 0x0a | 3 | - | 0 | | | data32 | 0x0b | 4 | - | 0 | | | data40 | 0x0c | 5 | - | 0 | | | data48 | 0x0d | 6 | - | 0 | | | data56 | 0x0e | 7 | - | 0 | | | data64 | 0x0f | 8 | - | 0 | | 論理データ | bool | 0x10 | 1 | 0xff | 0 | | バイナリビットデータ | bit8 | 0x18 | 1 | - | 0 | | | bit16 | 0x19 | 2 | - | 0 | | | bit24 | 0x1a | 3 | - | 0 | | | bit32 | 0x1b | 4 | - | 0 | | | bit40 | 0x1c | 5 | - | 0 | | | bit48 | 0x1d | 6 | - | 0 | | | bit56 | 0x1e | 7 | - | 0 | | | bit64 | 0x1f | 8 | - | 0 | | 符号なし整数 | uint8 | 0x20 | 1 | - | 4 | | | uint16 | 0x21 | 2 | - | 4 | | | uint24 | 0x22 | 3 | - | 4 | | | uint32 | 0x23 | 4 | - | 4 | | | uint40 | 0x24 | 5 | - | 8 | | | uint48 | 0x25 | 6 | - | 8 | | | uint56 | 0x26 | 7 | - | 8 | | | uint64 | 0x27 | 8 | - | 8 | | 符号付き整数 | int8 | 0x28 | 1 | - | 4 | | | int16 | 0x29 | 2 | - | 4 | | | int24 | 0x2a | 3 | - | 4 | | | int32 | 0x2b | 4 | - | 4 | | | int40 | 0x2c | 5 | - | 8 | | | int48 | 0x2d | 6 | - | 8 | | | int56 | 0x2e | 7 | - | 8 | | | int64 | 0x2f | 8 | - | 8 | | 列挙型 | enum8 | 0x30 | 1 | 0xff | 0 | | | enum16 | 0x31 | 2 | 0xffff | 0 | | 浮動小数点数 | semi | 0x38 | 2 | - | 4 | | | single | 0x39 | 4 | - | 4 | | | double | 0x3a | 8 | - | 8 | | 文字列 | octstr | 0x41 | 先頭1バイトの値 | 先頭が0xff | 0 | | | string | 0x42 | 先頭1バイトの値 | 先頭が0xff | 0 | | | octstr16 | 0x43 | 先頭2バイトの値 | 先頭が0xffff | 0 | | | string16 | 0x44 | 先頭2バイトの値 | 先頭が0xffff | 0 | | シリアル型 | uint8_array | 0x48 | 2+データの合計サイズ | 先頭が0xffff | 0 | | | struct | 0x4C | 2+データの合計サイズ | 先頭が0xffff | 0 | | 時刻 | ToD | 0xe0 | 4 | 0xffffffff | 4 | | | date | 0xe1 | 4 | 0xffffffff | 4 | | | UTC | 0xe2 | 4 | 0xffffffff | 4 | | ID | clusterID | 0xe8 | 2 | 0xffff | 0 | | | attriID | 0xe9 | 2 | 0xffff | 0 | | | bacOID | 0xea | 4 | 0xffffffff | 0 | | その他のデータ | EUI64 | 0xf0 | 8 | 0xffffffffffffffff | 0 | | | key128 | 0xf1 | 16 | - | 0 | ## 5.6 ZCLエラーステータスコード 表16のZCLエラーステータスコードは、受信したZCLコマンドレスポンスに含まれる。ターゲットデバイスに誤ったコマンドを送信した場合、ターゲットは制御コマンドを受信するが、実行は無効となる。 **表 16 ZCLステータス** | 値 | 説明 | 発生条件 | |---|---|---| | 0x00 | Successful operation 操作が成功 | すべてのコマンド | | 0x01 | Operation failed 操作が失敗 | すべてのコマンド | | 0x7E | The operation is not authorized 操作が許可されていない | 属性の読み取りおよび書き込み時 | | 0x80 | The command is not formed correctly コマンドのフォーマットが不正 | 独自コマンドの送信時 | | 0x81 | This ZCL proprietary command is not supported このZCL独自コマンドはサポートなし | 独自コマンドの送信時 | | 0x82 | This ZCL generic command is not supported このZCL一般コマンドはサポートなし | 一般コマンドの送信時 | | 0x83 | Vendor-defined ZCL proprietary commands are not supported 製造者定義のZCL独自コマンドはサポートなし | 製造者IDを含む独自コマンドの送信時 | | 0x84 | Vendor-definition ZCL generic command is not supported 製造者定義のZCL一般コマンドはサポートなし | 製造者IDを含む一般コマンドの送信時 | | 0x85 | Invalid field 無効なフィールド | 独自コマンドのパラメータがエラー時 | | 0x86 | Unsupported Attribute's サポートされていない属性 | 一般コマンド | | 0x87 | Error input value 入力値のエラー | すべてのコマンド | | 0x88 | Attribute Read-only 属性読み取り専用 | 属性の書き込み時 | | 0x89 | Space is insufficient スペースが不足 | 独自コマンド(保存機能) | | 0x8A | There is a repeat term 重複がある | 独自コマンド(保存機能) | | 0x8B | Don't find 見つからない | 独自コマンド(保存機能) | | 0x8C | The Attribute does not support active reporting 属性はアクティブレポートのサポートなし | アクティブレポートの設定または設定の読み込み時 | | 0x8D | The data type is invalid データ型が無効 | データ型を指定した一般コマンド | | 0x8E | The option is invalid オプションが無効 | 独自コマンド | | 0x8F | The Attribute writes only about it 属性は書き込み専用 | 属性の読み込み時 | | 0x90 | Inconsistent startup status 起動ステータスが不一致 | | | 0x91 | Out Of Band 帯域外 | | | 0x92 | Inconsistent error 不整合エラー | | | 0x93 | Refuse this operation 操作拒否 | | | 0x94 | Overtime タイムアウト | | | 0x95 | Abort 中断 | 無線通信での更新時 | | 0x96 | Invalid image data 無効なイメージデータ | 無線通信での更新時 | | 0x97 | Waiting for data データ待機中 | 無線通信での更新時または他の大きなデータ転送時 | | 0x98 | No image file is available 利用可能なイメージファイルなし | 無線通信での更新時 | | 0x99 | More image data is needed 追加イメージデータ要求 | 無線通信での更新時 | | 0xc0 | Hardware error ハードウェアエラー | | | 0xc1 | Software error ソフトウェアエラー | | | 0xc2 | Calibration error キャリブレーションエラー | | ## 5.7 ZigBee®プロトコルの共通アドレス形式とエンディアン ZigBee®プロトコル仕様ではアドレスをネットワークバイトオーダ(ビッグエンディアン)で指定する。**HEX形式のシリアルポートコマンドでは、すべての入力および出力のアドレス指定形式のデータはリトルエンディアンとする必要がある。** ### 5.7.1 IEEEアドレス(8バイト) MACアドレス。工場出荷時に割り当てられる8バイトのグローバル一意アドレス。 ### 5.7.2 PAN ID(2バイト) コーディネータがネットワーク作成時に2バイトのPAN IDを生成する。デバイスはネットワーク参加時にコーディネータと同じPAN IDを取得し、同じチャンネルで動作する。 ### 5.7.3 ショートアドレス(2バイト) デバイスはネットワーク参加時に2バイトのショートアドレスが割り当てられる。メッシュネットワークでは、正しいルーティングと転送経路確保のため、データ転送にこのショートアドレスを用いる。同一ネットワーク内で各デバイスのIEEEアドレスは対応するショートアドレスと関連付けられる。 ### 5.7.4 ポート ZigBee®デバイスには複数のポートが存在しうる(仮想デバイスに相当)。例: 多口ソケット、複数スイッチ。ZigBee®チップは1つでも、複数エンドポイントのサポートで複数の仮想デバイスを実装する。デバイス制御用のポート番号は1〜240が有効。特別なポート: ネットワーク管理用のポート0(ZDOポート)、Green Powerプロトコル変換用のポート242(GPポート)、ポート255(ブロードキャストポート。全ポートを同時に制御する場合などに使用)。 ### 5.7.5 仮想デバイスSN番号 デバイス管理の利便性のための、ZigBee®プロトコル仕様に基づく管理メカニズム。各デバイスは8バイトのIEEEアドレスを持ち、各仮想デバイスのポート番号はファームウェア上で固定のため、IEEEアドレス+ポート番号を仮想デバイスのSN番号として使用できる。リトルエンディアン表記の形式は「ポート番号」+「IEEEアドレス(リトルエンディアン表記)」。 SN番号は、バインディング設定で送信元・宛先の仮想デバイスを指定するために使用できる。常時接続バインディングの対象はグループにもできるため、対象がグループの場合、ポートは0xFF、IEEEアドレスの0番目と1番目はグループID、残りは0xFFFFになる。 **表 17 仮想デバイスSN** | 種別 | ポート番号 | IEEE[0] | IEEE[1] | IEEE[2] | IEEE[3] | IEEE[4] | IEEE[5] | IEEE[6] | IEEE[7] | |---|---|---|---|---|---|---|---|---|---| | デバイス | 0xXX | 0xXX | 0xXX | 0xXX | 0xXX | 0xXX | 0xXX | 0xXX | 0xXX | | グループ | 0xFF | 0xXX | 0xXX | 0xFF | 0xFF | 0xFF | 0xFF | 0xFF | 0xFF | - 仮想SNのポート番号は0x01~0xF0で、ターゲットが実際の仮想デバイスであることを示す。 - 仮想SNポートが0xFFの場合、ターゲットがグループであることを示す。 - ターゲットがグループの場合、IEEE[0]とIEEE[1]はグループIDを表す。 ## 5.8 ZCL仕様の概要 ZCL仕様はZigBee®プロトコルのアプリケーション層仕様。さまざまなデバイスの識別方法・制御方法、センサー値や照明の明るさ・消灯状態などの制御状態/物理状態の表現方法を定義する。 ### 5.8.1 ポートプロファイル 各ポートは用途を説明する独自のポートプロファイルを持つ。アプリケーション層データを交換するには、2つのエンドポイントが同じプロファイルを持つ必要がある。ZigBee®スマートホーム(Home Automation)は Profile=0x0104 を使用し、本モジュールも他社製デバイスとの相互運用性のため、データ伝送にこのプロファイルを使用する。 ### 5.8.2 デバイスID 各ポートに1つだけ割り当てられ、そのポートに対応する具体的なデバイス種類を定義する。Home Automationプロファイルで一般的なデバイスの例は表18のとおり。 **表 18 デバイスID** | 分類 | デバイスの種類 | デバイスID | |---|---|---| | Generic | On/Off Switch | 0x0000 | | | Level Control Switch | 0x0001 | | | On/Off Output | 0x0002 | | | Level Controllable Output | 0x0003 | | | Scene Selector | 0x0004 | | | Configuration Tool | 0x0005 | | | Remote Control | 0x0006 | | | Combined Interface | 0x0007 | | | Range Extender | 0x0008 | | | Mains Power Outlet | 0x0009 | | | Door Lock | 0x000A | | | Door Lock Control | 0x000B | | | Simple Sensor | 0x000C | | | Consumption Awareness Device | 0x000D | | | Home Gateway | 0x0050 | | | Smart Plug | 0x0051 | | | White Goods | 0x0052 | | Lighting | On/Off Light | 0x0100 | | | Dimmable Light | 0x0101 | | | Color Dimmable Light | 0x0102 | | | On/Off Light Switch | 0x0103 | | | Dimmer Switch | 0x0104 | | | Color Dimmer | 0x0105 | | | Light Sensor | 0x0106 | | | Occupancy Sensor | 0x0107 | | Closures | Shade | 0x0200 | | | Shade Controller | 0x0201 | | | Window Cover | 0x0202 | | | Window Cover control | 0x0203 | | HVAC (Heating, Ventilation, Air Conditioning) | Heating/Cooling Unit | 0x0300 | | | Thermostat | 0x0301 | | | Temperature Sensor | 0x0302 | | | Pump | 0x0303 | | | Pump Controller | 0x0304 | | | Pressure Sensor | 0x0305 | | | Flow Sensor | 0x0306 | | IAS (Intruder Alarm System) | IAS Control and Indicating Equipment | 0x0400 | | | IAS Ancillary Control Equipment | 0x0401 | | | IAS Zone | 0x0402 | | | IAS Warning Device | 0x0403 | ### 5.8.3 クラスタ クラスタはデバイス機能を定義する。ポート(1〜240)は1つ以上のクラスタをサポートでき、特定機能のサポートを示す。通常、1クラスタは複数の物理状態や制御命令を含み、異なるクラスタは異なる機能を表す。各ポートには入力クラスタテーブル(Input Cluster)と出力クラスタテーブル(Output Cluster)がある。入力クラスタは機能を制御・実行する能力(実行側)、出力クラスタは機能を開始する能力(制御側)を示す。 ### 5.8.4 サーバ側とクライアント側 クラスタがポートの入力クラスタテーブルにある場合、そのポートはそのクラスタのサーバ側(機能サービスの提供側/実行側)。出力クラスタテーブルにある場合はクライアント側(利用側/制御側)。ZCLコマンドではコマンド方向を示す必要があり、Server-to-Client(S2C)とClient-to-Server(C2S)に区分される。 ### 5.8.5 製造者コード メーカーが独自のカスタムクラスタを追加する際に使用する。標準クラスタで要件を満たせない場合、メーカーはクラスタ(Cluster ID=0xFC00以降)を独自定義できる。異なるメーカーが同じカスタムクラスタIDを使うクラスタ衝突を防ぐため、カスタムクラスタに製造者コードのフィールドを追加できる。 ### 5.8.6 属性 クラスタ内の実際の状態を表す。サイズは固定で、通常はデバイス内でグローバル変数のように存在する。温度、レベル、オン/オフ状態など現在の状態を表現できる。C言語仕様に準拠した変数型(char、bool、int、浮動小数点、stringなど)で定義でき、各属性には固定のデータ型が割り当てられる(5.5節参照)。各属性には16ビットの属性IDが割り当てられる。各クラスタの実行側と制御側はそれぞれ独自の属性を定義でき、属性IDの再利用や異なるデータ型の使用も可能。 ### 5.8.7 一般コマンド デバイス側の属性へのアクセス・制御に使用する。主な機能は、属性の読み取り、書き込み、固定対象への属性の自動レポート、レポート規則の設定・照会、全属性に関する統計情報の取得。属性を直接制御し、固定サイズの属性値のみ操作できる。属性は通常グローバル変数に対応するため、危険な操作を防ぐ目的から、属性書き換えによるデバイス制御・物理状態変更は一般的ではない。同一クラスタ内の複数属性を同時に扱え、SIMD(Single Instruction Multiple Data)操作に相当する。 ### 5.8.8 制御コマンド 属性を直接操作せず、コマンドIDと付随するコマンドパラメータで対象デバイスを制御するため、一般コマンドより実用的。各クラスタに256種類の制御コマンドを定義でき、コマンド方向の違いを含めて制御側/実行側合計512種類を定義できる。各コマンドには長さの異なるパラメータを付加できる。 制御コマンドは対象デバイスの物理状態へ直接作用できる(例: PWMパルス幅の変更、ロック解除パスワードの付加)。実行側のPWMパルス幅やロック状態の変更は対応する属性へ同期されるため、その後一般コマンドで該当属性にアクセスして制御結果を取得できる。制御コマンドは制御側から実行側へのみ送信できるが、一般コマンドは第三のデバイスから制御側・実行側の両方へ送信できる。 ### 5.8.9 常時接続バインディング ノード上のあるポートを、固定クラスタIDで別のポートへバインドできる。送信元ポート同士はMACアドレスとポート番号で互いを記憶する。完成済みデバイスではMACアドレスとポート番号は変更されないため、対象デバイスがネットワークに参加していなくても設定は有効。ただし正常に通信するには、対象デバイスが送信元デバイスと同じネットワークに参加している必要がある。要件: - 送信元ポートと宛先ポートは同じノード上でも可能(MACアドレスが同じでも可)。 - 送信元と宛先はサーバとクライアントの関係で、かつバインドに使うクラスタが送信元ポートの入力クラスタテーブルまたは出力クラスタテーブルに存在している必要がある。 設定方法は2通り: - **コーディネータによる設定**: ネットワーク管理コマンド(常時接続バインディングの設定・解除・照会)で、自身を含むノードのポートのバインディングを設定・管理する。コマンドの受信対象はバインド元ポート。 - **ノード主導のバインディング**: 自動接続機能で自動的に相手側ポートを検索できる。送信元ポートはデータ伝送モジュール自身のポート1(カスタムクラスタをサポート)で、宛先ポートは他のデータ伝送モジュールのポート1、またはZigBee照明機器(Z240-CP13のPWM制御ポートを含む)を指定できる。 ### 5.8.10 エンディアン ZCLコマンドでは、ターゲットのショートアドレスに加え、クラスタID、製造者コード、属性IDが入力・出力パラメータに含まれ、これらはすべてリトルエンディアン。 ## 5.9 Z240-MP4 (CT/EA)モジュールのデータ構造とデータ送信機能の設定 MP4(CT/EA)にはデータ伝送機能とUART入出力ポートが1つだけで他の周辺制御機能がないため、ZigBee®ポートは1つのみ。 **表 19 ZigBee®プロトコル情報** | 項目 | 値 | |---|---| | エンドポイントID | 1 | | プロファイルID | 0x0104 | | デバイスID | 0x0500 | | 入力クラスタ | 0x0000 (Basic) / 0x0003 (Identify) / 0xFC08 (Data transparent transmission, Manufacture Code=0x2000) | | 出力クラスタ | 0x0003 / 0xFC08 (Data transparent transmission, Manufacture Code=0x2000) | **表 20 透過伝送機能の属性**(クラスタ = 0xFC08、製造者コード = 0x2000) | 属性ID | ディスクリプタ | 名前 | データ型 | 操作 | 初期値 | |---|---|---|---|---|---| | 0x0000 | Baud | ボーレート | uint32 | R | 115200 | | 0x0001 | Target Addr | ターゲットアドレス | uint16 | RW | 0xFFFF | | 0x0002 | Target EP | ターゲットポート | uint8 | RW | 0xFF | | 0x0003 | Send Mode | 透過伝送モード | bool | RW | FALSE | | 0x0004 | LP Level | 低消費電力モード | enum8 | RW | 0 | **表 21 サポートされている制御コマンド** | コマンドID | コマンド方向 | ディスクリプタ | 機能 | |---|---|---|---| | 0x00 | C2S | Set Target | データ送信 | | 0x01 | C2S | Set Target | ターゲットを設定 | | 0x02 | C2S | Set Baud req | ボーレートを設定 | | 0x03 | C2S | Set Low Power | 低消費電力モードを設定 | (コマンドID 0x00 のディスクリプタが「Set Target」でデータ送信となっている点は原文ママ) **透過伝送モードの設定方法** - 本モジュール自体は「ローカル属性の設定」コマンドで、ボーレート、ターゲットアドレス、ターゲットポート、シリアルポートモード、低消費電力モードを設定できる。 - リモートで透過伝送を設定する場合、ZCL書き込み属性コマンドで設定できる透過伝送モードを除き、残りの属性はZCL制御コマンドで書き込む必要がある。ボーレートは 9600、19200、38400、57600、115200 のみ対応で、それ以外は無効。 - リモートコマンドでモジュールを制御する場合、コマンドの製造者コードを 0xFC08 に設定する必要がある(原文ママ。表19/20では 0xFC08 はクラスタID、製造者コードは 0x2000)。 - 設定結果と現在のシリアルポート状態の確認は、本モジュール自体は「ローカル属性の照会」コマンド、リモートデバイスはZCLコマンドで送信ステータスを問い合わせる。 - ローカル/リモート命令で送信モードに対応する属性が1(TRUE)に設定されると透過伝送モードに移行する。 - 一度透過伝送モードに入ると、シリアルポートコマンドは失敗する。終了するには、外部MCUから「+」を3つ一行で送信する。または、リモートデバイスのモジュールへZCL属性書き込み命令を送り、シリアルポートモードに対応する属性を0(FALSE)に変更しても終了できる。 - コマンドモードのモジュールは透過伝送モードのモジュールと通信できる。コマンドモードのモジュールがZCLコマンドモードで透過伝送モードのモジュールへ「Data Send」コマンドを送ると、透過伝送モードのモジュールはペイロード部のデータを出力できる。 - コマンドモードでは、透過伝送モードのオンデマンド、マルチキャスト、ブロードキャストデータを受信し、ZCL受信コマンドフォーマットで出力できる。 **表 22 ターゲットアドレスとターゲットポート設定** | ターゲットアドレス | ターゲットポート | 送信範囲 | |---|---|---| | 0xFFFF | 0以外 | スリープ状態のエンドデバイスを含むすべてのデバイスにブロードキャスト | | 0xFFFD | 0以外 | スリープ状態以外のすべてのデバイスにブロードキャスト | | 0xFFFC | 0以外 | コーディネータとすべてのルータデバイスにブロードキャスト | | 0x0000~0xFFF8 | 1 | ショートアドレスによるオンデマンド透過伝送 | | 0x0001~0xFFF8 | 0 | マルチキャスト | | 0xFFFE | 0xFE | ターゲットを固定したMACアドレスに対しての透過伝送(ターゲットバインディングはコーディネータによる設定が必要) | > 原文注意: 4.6.2/4.6.3 ではマルチキャスト/ブロードキャストのターゲットポートを 0xFF に設定する例を示すが、表22ではマルチキャストのポートは 0。 **表 23 低消費電力モード設定の効果** | 低消費電力モード | ウェイクアップ周期 | |---|---| | 0 | 1秒 | | 1 | 3.3秒 | | 2 | 5秒 | | 3 | なし | **データ透過伝送のフィードバック**: 透過伝送モードでデータ送信時、シリアルポートに結果がフィードバックされる(4バイト以下)。受信した透過伝送データと区別するため、伝送データは5バイト以上を推奨。 | 文字列 | 意味 | |---|---| | `OK` | 送信成功 | | `FAIL` | 送信失敗 | | `ERRO` | 送信エラー(例: 送信バッファ満杯、ネットワーク未接続、オフライン状態) | | `BOOT` | モジュールが起動 | | `OFF` | モジュールがオフライン状態(エンドデバイス、スリープエンドデバイスで発生) | | `NET` | モジュールがオンラインに復帰(エンドデバイス、スリープエンドデバイスで発生) | ## 5.10 スリープエンドデバイスのウェイクアップ スリープ(低消費電力)状態でシリアルポートコマンドを送る場合は、まずウェイクアップフレームを入力する。スリープ中のエンドデバイスは、シリアルポート(RX)が任意の信号(主に立ち下がりエッジ)を受信すると復帰する。ウェイクアップ信号の後、RXは0.5ms~200msの間、正常に動作できる。外部MCUはこの時間内にコマンドまたは透過伝送データを書き込む必要がある。ウェイクアップ方法は3種類: - **遅延方式**: スリープ中のモジュールに、まず単一バイト 0x00 を入力し、その後 1ms〜200ms 以内にHEXコマンド、ATコマンド、または透過伝送データを入力する。 - **連続入力方式**: 同一コマンドを連続して2回入力する。外部MCUを手動操作してHEX/ATコマンドを送る場合に適する。1回目のコマンドはウェイクアップに使われ、完全には受信されずエラーコマンドと認識される。200ms以内に2回目を送る必要がある。透過伝送モードのデータ通信ではエラーチェック機構がなく誤データが送信される可能性があるため不適。 - **挿入方式**: コマンドまたはデータの前に複数バイトの 0x00 を挿入する。HEXコマンドモード、ATコマンドモード、透過伝送モードのいずれにも適する。挿入する 0x00 の数はボーレートで決まり、累計で0.5msに相当させる(表24)。起動0.5ms後にRXが有効になり始めるため、ATモードまたは透過伝送モードでは挿入数を適正に保つ必要がある。 **表 24 ボーレート設定と必要な0x00の挿入数** | シリアルポートのボーレート | 挿入する0x00のバイト数 | |---|---| | 115200 bps | 6 | | 57600 bps | 3 | | 38400 bps | 2 | | 19200 bps | 1 | | 9600 bps | 1 | --- # 6 ユーザ命令セット Z240-MP4(CT/EA)への設定やコマンドには、HEX命令フォーマットを使用する。単純なモジュール間シリアル通信のための透過伝送モードもサポートする(デフォルトはHEX命令フォーマットによるコマンドモード)。 HEXコマンドモードでは、**ローカル属性命令** `55 07 00 11 00 03 00 01 13` で透過伝送モードに入れる。透過伝送モードで「+++」を送信するとHEXコマンドモードに戻る。 **注: 以降の入力コマンドおよびフィードバックメッセージのテキスト表記部分(英語注記など)は、直前のHEX値の意味を付記したもので、実際の入出力には含まれない。実際の入出力にはHEX部分のみを扱うこと。** 以下の各表の列は、MP4 / CP13 = 対応製品、C / R / E = 対応デバイスタイプ(コーディネータ / ルータ / エンドデバイス)、参加済 / 未参加 = ネットワーク参加状態。✓=対応、-=非対応。 **表 25 ローカル設定コマンド**(タイプ 0x00) | コード | コマンド | MP4 | CP13 | C | R | E | 参加済 | 未参加 | |---|---|---|---|---|---|---|---|---| | 0x00 | モジュールの現在ステータスの照会 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | 0x02 | ネットワークを開く/ネットワーク接続の開始 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | 0x03 | ネットワークをオフにする/ネットワーク接続の停止 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | 0x04 | モジュールをリセットする/工場出荷時の設定に戻す | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | 0x05 | デバイスタイプの設定 | ✓ | ✓ | ✓ | ✓ | ✓ | - | ✓ | | 0x06 | チャンネルの照会と使用候補チャンネルの指定 | ✓ | ✓ | ✓ | ✓ | ✓ | - | ✓ | | 0x07 | PAN IDの照会 | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | | 0x08 | PAN IDの設定 | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | | 0x09 | モジュールのグループの照会 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | 0x0A | モジュールのグループ追加 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | 0x0B | モジュールのグループ解除 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | 0x0D | 送信出力の照会/設定 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | 0x0F | テストモードの実行 | ✓ | - | ✓ | ✓ | ✓ | ✓ | ✓ | | 0x10 | ローカル属性の照会 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | 0x11 | ローカル属性の設定 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | 0x14 | 自動接続(ペアリング)の設定 | ✓ | ✓ | ✓/※ | ✓ | ✓ | ✓ | - | | 0x16 | ATコマンドモードに切り替え | - | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | 0x18 | PWM出力のデューティ比の設定 | - | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | 0x19 | PWMマーキングモードの設定 | - | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | 0x1A | 拡張PAN IDによるネットワーク接続のロック | - | ✓ | - | ✓ | ✓ | - | ✓ | | 0x22 | ネットワーク参加ノードのアドレス照会 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | 0x28 | デバイス情報通知の再送信 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | - | | 0x40 | ZCLポートの作成 | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | | 0x41 | ポートに属性の追加 | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | | 0x42 | ポートと属性設定の保存 | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | | 0x43 | 属性値の照会/設定 | ✓ | - | ✓ | ✓ | ✓ | ✓ | ✓ | | 0x44 | ポートと属性の消去 | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | ※CP13非対応(原文注記。本表の「✓/※」の位置は原文のまま。個別コマンドの章では 0x14 は「MP4(C/R/E)、CP13(R/E)」) **表 26 システム通知メッセージ**(タイプ 0x80) | コード | コマンド | MP4 | CP13 | C | R | E | 参加済 | 未参加 | |---|---|---|---|---|---|---|---|---| | 0x00 | モジュール起動の通知 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | 0x01 | ネットワーク状態変化の通知 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | 0x02 | ネットワーク開始/停止通知 | ✓ | ✓ | ✓ | - | - | ✓ | - | | 0x03 | ノードのネットワーク接続の検出 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | - | | 0x04 | モジュールのショートアドレス更新の通知 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | - | | 0x05 | デバイス情報の通知 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | - | | 0x06 | モジュールのオフグリッドの通知 | ✓ | ✓ | ✓ | - | - | ✓ | - | | 0x10 | 接続の自動確立の通知/自動バインディングの接続結果の通知 | ✓ | ✓ | ✓/※ | ✓ | ✓ | ✓ | - | ※CP13非対応(原文注記) **表 27 ネットワーク管理コマンド**(タイプ 0x01) | コード | コマンド | MP4 | CP13 | C | R | E | 参加済 | 未参加 | |---|---|---|---|---|---|---|---|---| | 0x00 | ターゲットデバイスのショートアドレスの照会 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | - | | 0x01 | ターゲットデバイスのMACアドレスの照会 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | - | | 0x04 | ターゲットデバイスがサポートするクラスタの照会 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | - | | 0x05 | ターゲットデバイスがサポートするポート番号の照会 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | - | | 0x21 | ノードの常時接続バインディングの設定 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | - | | 0x22 | ノードの常時接続バインディングの解除 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | - | | 0x33 | ノードの常時接続バインディングの照会 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | - | | 0x34 | ノードの削除 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | - | **表 28 デバイス状態管理とデバイス制御(ZCLコマンド)**(タイプ 0x02) | コード | コマンド | MP4 | CP13 | C | R | E | 参加済 | 未参加 | |---|---|---|---|---|---|---|---|---| | 0x00 | デバイスの属性の照会 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | - | | 0x01 | デバイスの属性の変更 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | - | | 0x02 | 属性のレポート規則の照会 | - | ✓ | ✓ | ✓ | ✓ | ✓ | - | | 0x03 | 属性のレポート規則の設定 | - | ✓ | ✓ | ✓ | ✓ | ✓ | - | | 0x04 | 全てのプロパティの照会 | - | ✓ | ✓ | ✓ | ✓ | ✓ | - | | 0x05 | 拡張フィールドを含む全てのプロパティの照会 | - | ✓ | ✓ | ✓ | ✓ | ✓ | - | | 0x0A | 属性のアクティブレポートの受信 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | - | | 0x0B | デフォルトの応答フレームの受信 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | - | | 0x0F | 制御コマンドの送信/受信 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | - | > 表27・28は原文で、MP4 / CP13 / C / R / E / 参加済 / 未参加 の7値が並ぶ形式。表28の 0x0A 行は原文取得結果で「✓ ✓ ✓ ✓ ✓ - -」「✓ ✓ ✓ - - ✓ -」のように列ごとに異なる場合があるため、厳密な対応可否は実機・原文ページで要確認。 --- ## 6.1 ローカル設定コマンド ローカル設定コマンドは、モジュール自身が保持するパラメータの設定・照会およびネットワーク接続の実行など、ZigBee®ネットワークを構成する上で基礎となる設定・操作に関するコマンド群(コマンドタイプ 0x00)。 > 各コマンドの例示は、原文の画像に色分け(紫=ロード長、赤=コマンドタイプ+コマンドコード、青=チェックコード)がある。チェックコードはチェックコード以外のフレームロードのXOR8。 ### 6.1.1 モジュールの現在ステータスの照会(コマンドコード: 0x00) - 対応デバイス: MP4(C/R/E)、CP13(C/R/E) - 機能: ネットワークステータス、デバイスタイプ、MACアドレス、チャンネル、PAN ID、ショートアドレス、ネットワークキーを含むステータス・パラメータを照会する。他のZigBee®デバイスと通信するにはネットワークステータスが 0x00 である必要がある。 **表 29 入力コマンドのフォーマット** | 名前 | コマンドデータ | |---|---| | NULL | | | バイト数 | 0 | **表 30 フィードバックメッセージのフォーマット** | 名前 | ネットワークステータス | デバイスタイプ | MACアドレス | チャンネル | PAN ID | ショートアドレス | 拡張PAN ID | ネットワークキー | |---|---|---|---|---|---|---|---|---| | バイト数 | 1 | 1 | 8 | 1 | 2 | 2 | 8 | 16 | - **ネットワークステータス**: - 0x00: ネットワーク参加済みで接続済み - 0xFF: ネットワークに未参加 - 0x10: ネットワーク参加済みで未接続(Z240-CP13のみ) - 0x22: ネットワーク参加済みで未接続・親ノードを探索中(Z240-MP4のみ) - 0xA1: ネットワーク参加済みで未接続(Z240-MP4のみ) - **デバイスタイプ**: 0x00 コーディネータ、0x01 ルータ、0x02 非スリープエンドデバイス、0x03 スリープエンドデバイス - **MACアドレス**: モジュールのMACアドレス(工場出荷時に固定) - **チャンネル / PAN ID / ショートアドレス / 拡張PAN ID / ネットワークキー**: 現在値。ネットワーク参加済みの場合のみ存在。 入力コマンド: ``` 55 03 00 00 00 ``` フィードバックメッセージ(ネットワーク接続なし): ``` 55 0D 00 00 FF 00 28 EA E2 1A 00 4B 12 00 9C (FF=ネットワークステータス, 00=デバイスタイプ, 28 EA E2 1A 00 4B 12 00=MACアドレス, 9C=チェックコード) ``` フィードバックメッセージ(ネットワーク接続済み): ``` 55 2A 00 00 00 00 28 EA E2 1A 00 4B 12 00 19 93 61 00 00 28 EA E2 1A 00 4B 12 00 C6 CD 93 B5 2F 37 9E F6 E9 A6 CE 3A 15 33 CF 55 B1 (00=ネットワークステータス, 00=デバイスタイプ, 28 EA E2 1A 00 4B 12 00=MACアドレス, 19=チャンネル, 93 61=PAN ID, 00 00=ショートアドレス, 28 EA E2 1A 00 4B 12 00=拡張PAN ID, C6 CD ... 55=ネットワークキー, B1=チェックコード) ``` ### 6.1.2 ネットワークを開く/ネットワーク接続の開始(コマンドコード: 0x02) - 対応デバイス: MP4(C/R/E)、CP13(C/R/E) - 機能: コーディネータはネットワークを作成し、他デバイスが参加できるようにする(工場出荷時設定ではコーディネータは新しいネットワークを作成する)。ルータ/エンドデバイスはこのネットワークに参加する。 - コーディネータのネットワーク作成直後は、ルータ/エンドデバイスの参加が遅延する場合がある。最終状態は6.2.2項「ネットワーク状態変化の通知」(コマンド0x01)で確認できる。 - ルータがネットワーク接続後にこのコマンドを実行すると、コーディネータの参加許可時間が長くなる可能性がある。 - **ネットワークの作成または参加に失敗した場合は最大5回まで自動再試行する。5回失敗後は手動で再試行が必要。** **表 31 入力コマンドのフォーマット** | 名前 | コマンドデータ | |---|---| | NULL | | | バイト数 | 0 | **表 32 フィードバックメッセージのフォーマット** | 名前 | ステータス | |---|---| | バイト数 | 1 | - **ステータス**: 0x00 操作は成功、0xFF 操作は失敗。このコマンドはソフトスタート後にのみ有効。 入力コマンド: ``` 55 03 00 02 02 ``` フィードバックメッセージ: ``` 55 04 00 02 00 02 (00=ネットワーク作成成功) ``` 非同期フィードバックメッセージ(ネットワーク開始): ``` 55 29 80 01 02 28 EA E2 1A 00 4B 12 00 13 C9 45 00 00 28 EA E2 1A 00 4B 12 00 2A 83 DE 81 59 20 3A 58 92 1A 2C 4B 5E 77 B9 A6 28 (02=network open, 28 EA E2 1A 00 4B 12 00=MACアドレス, 13=チャンネル, C9 45=PAN ID, 00 00=ショートアドレス, 28 EA ... 00=拡張PAN ID, 2A 83 ... A6=ネットワークキー, 28=チェックコード) ``` 非同期フィードバックメッセージ(ネットワーク参加許可ウィンドウ時間): ``` 55 04 80 02 B4 36 (B4=network window time: デフォルト180秒) ``` 注: このコマンド使用時、モジュールの RUN_LED ピンが動作する。ネットワーク未接続でネットワークを探索(エンドデバイス/ルータ)または形成(コーディネータ)中は RUN_LED が速く点滅し、形成/参加が正常に完了後はゆっくり点滅する。既にネットワークが形成済み、または再接続に成功した場合もゆっくり点滅してネットワーク接続状態を示す。 ### 6.1.3 ネットワークをオフにする/ネットワーク接続の停止(コマンドコード: 0x03) - 対応デバイス: MP4(C/R/E)、CP13(C/R/E) - 機能: - コーディネータ/ルータ: コマンド実行後、新規参加ノードに対して参加を拒否する状態(参加許可OFF)になる。既に参加済みのノードには影響しない。 - エンドデバイス: コマンド実行時点でネットワーク参加処理中(参加要求を送信中)の場合に限り、その処理をキャンセルする。参加完了済みの場合は変更なし。 - 実行したデバイスのみが新規参加を拒否する。同一ネットワーク内に本コマンド未実行のコーディネータ/ルータがあると、それらを経由して新規ノードが参加する可能性がある。 **表 33 入力コマンドのフォーマット** | 名前 | コマンドデータ | |---|---| | NULL | | | バイト数 | 0 | **表 34 フィードバックメッセージのフォーマット** | 名前 | ステータス | |---|---| | バイト数 | 1 | - **ステータス**: 0x00 操作は成功、0xFF 操作は失敗 入力コマンド: ``` 55 03 00 03 03 ``` フィードバックメッセージ: ``` 55 04 00 03 00 03 ``` 非同期フィードバックメッセージ(ネットワークを閉じ、ウィンドウ時間をゼロにする): ``` 55 04 80 02 00 82 ``` ### 6.1.4 モジュールをリセットする/工場出荷時の設定に戻す(コマンドコード: 0x04) - 対応デバイス: MP4(C/R/E)、CP13(C/R/E) - 機能: モジュールの再起動、ネットワークからの離脱、または工場出荷時設定への復元を行う。工場出荷時に復元されると、設定されたすべてのパラメータがデフォルト値に戻る。 **表 35 入力コマンドのフォーマット** | 名前 | リセットモード | PAN ID | チャンネル | |---|---|---|---| | バイト数 | 1 | 2 | 1 | - **リセットモード**: 0x00 モジュールの再起動、0x01 ネットワークから離脱、0x02 工場出荷時の設定に戻す - **PAN ID**: 現在のPAN ID。再起動の場合は 0xFFFF を入力可。ネットワーク参加済みで離脱/工場出荷時復元をする場合は現在のPAN IDが必要。未参加の場合は 0xFFFF を指定。 - **チャンネル**: 現在のチャンネル。再起動の場合は 0x00 を入力可。ネットワーク参加済みで離脱/工場出荷時復元をする場合は現在のチャンネルが必要。未参加の場合は 0x00 を指定。 **表 36 フィードバックメッセージのフォーマット** | 名前 | ステータス | |---|---| | バイト数 | 1 | - **ステータス**: 0x00 操作は成功、0xFF 操作は失敗 入力コマンド: ``` 55 07 00 04 00 93 61 19 EF (再起動: モード=00, PAN ID=93 61, チャンネル=19) 55 07 00 04 01 93 61 19 EE (ネットワークから離脱: モード=01) 55 07 00 04 02 93 61 19 ED (工場出荷時の設定に戻す: モード=02) ``` フィードバックメッセージ: ``` 55 04 00 04 00 04 ``` 非同期フィードバックメッセージ(起動通知): ``` 55 0D 80 00 00 14 3B 57 C3 2F 00 4B 12 00 4D (00=デバイスタイプ, 14=ソフトウェアバージョン番号, 3B 57 C3 2F 00 4B 12 00=MACアドレス, 4D=チェックコード) ``` ### 6.1.5 デバイスタイプの設定(コマンドコード: 0x05) - 対応デバイス: MP4(C/R/E)、CP13(C/R/E) - 機能: モジュールをコーディネータ、ルータ、またはエンドデバイス(スリープ/非スリープ)に設定する。**ネットワーク参加前に設定する必要があり、設定後にモジュールを再起動しないとネットワーク参加に失敗する**(プロトコルスタックがデバイスタイプを更新するため)。 **表 37 入力コマンドのフォーマット** | 名前 | デバイスタイプ | |---|---| | バイト数 | 0 (原文表記。実際は1バイト) | - **デバイスタイプ**: 0x00 コーディネータ、0x01 ルータ、0x02 非スリープエンドデバイス、0x03 スリープエンドデバイス **表 38 フィードバックメッセージのフォーマット** | 名前 | ステータス | |---|---| | バイト数 | 1 | - **ステータス**: 0x00 操作は成功、0xFF 操作は失敗 入力コマンド: ``` 55 04 00 05 00 05 (コーディネータ) 55 04 00 05 01 04 (ルータ) 55 04 00 05 02 07 (非スリープエンドデバイス) 55 04 00 05 03 06 (スリープエンドデバイス) ``` フィードバックメッセージ: ``` 55 04 00 05 00 05 (変更成功後、ステータス照会コマンドでデバイスタイプを照会) ``` 備考: - スリープエンドデバイスに設定しても、ネットワーク参加完了まではスリープ状態に入らない。最初の参加成功後はまず1秒周期のウェイクアップ周期に入り1分間継続する。この1分間はコーディネータとエンドデバイス間の情報設定通信の時間で、この間にコーディネータからスリープエンドデバイスをネットワークから離脱させることが可能。1分経過後は、ユーザ設定の低消費電力レベルに応じたスリープ周期へ自動移行する。スリープエンドデバイスをネットワークから削除したい場合は、自動起床のタイミング、またはコマンド/ボタン操作などで強制起床させた状態でのみ離脱処理が可能。 - スリープエンドデバイスがネットワーク参加済みで電源OFF→ONした場合、ネットワーク再接続後に30秒間の待機状態に入る。この30秒は設定情報のやりとりの時間で、「参加直後の1分間の待機動作」と同じ扱い。 ### 6.1.6 チャンネルの照会と使用候補チャンネルの指定(コマンドコード: 0x06) - 対応デバイス: MP4(C/R/E)、CP13(C/R/E) - 機能: 使用可能な候補チャンネルの設定。チャンネルごとに有効/無効を指定できる。ネットワーク作成/参加前に設定する必要がある。デフォルトで7つの候補チャンネル(11, 14, 15, 19, 20, 24, 25)が指定されている。複数チャンネルを有効化/無効化するコマンドで、フィードバックは有効化されたチャンネルを返す。有効化されたチャンネルは使用候補であり、実際に使用するものとして選択されたわけではない。 **表 39 入力コマンドのフォーマット** | 名前 | 操作 | チャンネルリスト | |---|---|---| | バイト数 | 1 | N | - **操作**: 0x00 チャンネルを無効、0x01 チャンネルを有効、0x02 有効チャンネルリストを設定(リストを0にすることは不可)。有効チャンネルの照会は、操作を 0x00 または 0x01 にしてチャンネルリストを省略する。 - **チャンネルリスト**: 無効/有効にするチャンネル。0x0B~0x1A(11-26)が指定可能。操作が 0x00/0x01 の場合は省略可。 **表 40 フィードバックメッセージのフォーマット** | 名前 | ステータス | チャンネルリスト | |---|---|---| | バイト数 | 1 | N | - **ステータス**: 0x00 設定は成功、0xFF 設定は失敗 - **チャンネルリスト**: 現在の有効チャンネルリスト(最大16バイト) 例: ``` 入力(照会): 55 04 00 06 00 06 フィードバック: 55 0B 00 06 00 0B 0E 0F 13 14 18 19 0A (00=成功, 0B 0E 0F 13 14 18 19=チャンネルリスト) 入力(有効化): 55 05 00 06 01 15 12 (15=チャンネル21を有効) フィードバック: 55 0C 00 06 00 0B 0E 0F 13 14 15 18 19 1F 入力(無効化): 55 06 00 06 00 13 14 01 (13 14=チャンネル19,20を無効) フィードバック: 55 09 00 06 00 0B 0E 0F 18 19 0D 入力(上書き): 55 06 00 06 02 11 12 07 (11 12=チャンネル17,18のみを設定) フィードバック: 55 06 00 06 00 11 12 05 ``` ### 6.1.7 PAN IDの照会(コマンドコード: 0x07) - 対応デバイス: MP4(C/R/E)(表25では CP13 非対応) - 機能: PAN IDを照会する。デフォルトの 0xFFFF はランダムモード(PAN ID未割り当て)で、ネットワーク参加後に 0xFFFF 以外の実際のPAN IDが取得できる。PAN IDの設定は、コーディネータのネットワーク作成前、またはデバイスのネットワーク参加前に行う必要がある。 **表 41 入力コマンドのフォーマット** | 名前 | コマンドデータ | |---|---| | NULL | | | バイト数 | 0 | **表 42 フィードバックメッセージのフォーマット** | 名前 | ステータス | PAN ID | |---|---|---| | バイト数 | 1 | 2 | - **ステータス**: 0x00 操作は成功、0xFF 操作は失敗 - **PAN ID**: 現在のPAN ID(ネットワーク参加済みの場合)。ネットワーク未参加の場合は設定値に関わらず 0xFFFE。 入力コマンド: ``` 55 03 00 07 07 ``` フィードバック(ネットワーク接続なし): ``` 55 06 00 07 00 FE FF 06 (FE FF=not networked: 0xFFFE) ``` 注: ネットワーク参加済みでPAN IDが 0xFFFE である場合の結果と同一になる。 フィードバック(ネットワーク接続済み): ``` 55 06 00 07 00 C1 BE 78 (C1 BE=PAN ID) ``` ### 6.1.8 PAN IDの設定(コマンドコード: 0x08) - 対応デバイス: MP4(C/R/E)(表25では CP13 非対応) - 機能: 使用するPAN IDを設定する。ネットワーク作成前/参加前に行う必要がある。0xFFFF を指定するとランダムモードになり、発見されたコーディネータにより自動的にPAN IDが決定される。 **表 43 入力コマンドのフォーマット** | 名前 | PAN ID | |---|---| | バイト数 | 2 | **表 44 フィードバックメッセージのフォーマット** | 名前 | ステータス | |---|---| | バイト数 | 1 | - **ステータス**: 0x00 設定は成功、0xFF 設定は失敗 入力コマンド: ``` 55 05 00 08 98 89 19 (98 89=PAN ID) ``` フィードバックメッセージ: ``` 55 04 00 08 00 08 ``` ### 6.1.9 モジュールのグループの照会(コマンドコード: 0x09) - 対応デバイス: MP4(C/R/E)、CP13(C/R/E) - 機能: モジュールが参加しているグループを照会する。ローカル/リモートで操作可能。グループは透過伝送モードで複数宛先ノードへマルチキャスト送信を行う際に使用する。複数ノードで透過伝送機能のエンドポイントであるポートインデックスを同一グループに参加させる設定により、グループIDを宛先アドレスとして指定できる。 **表 45 入力コマンドのフォーマット** | 名前 | ポートインデックス | |---|---| | バイト数 | 1 | - **ポートインデックス**: モジュールのエンドポイントシリアル番号(ポート番号ではない)。デフォルトの透過伝送ポートは 0x00、0x01 はセカンダリのシリアルポート用に予約、0x02 と 0x03 は PWM、GPIO、ADC 用に予約。 **表 46 フィードバックメッセージのフォーマット** | 名前 | ステータス | グループ数 | グループリスト | |---|---|---|---| | バイト数 | 1 | 1 | 2*N | - **ステータス**: 0x00 操作は成功で後続データあり、0xFF 操作は失敗 - **グループ数**: このポートインデックスに追加されたグループの総数 - **グループリスト**: 追加されたグループIDのリスト 入力コマンド: ``` 55 04 00 09 00 09 (00=ポートインデックス) ``` フィードバックメッセージ(グループなし): ``` 55 05 00 09 00 00 09 (00=query valid, 00=no group) ``` ### 6.1.10 モジュールのグループ追加(コマンドコード: 0x0A) - 対応デバイス: MP4(C/R/E)、CP13(C/R/E) - 機能: モジュール上のポートをグループに追加する。 **表 47 入力コマンドのフォーマット** | 名前 | ポートインデックス | グループID | |---|---|---| | バイト数 | 1 | 2 | **表 48 フィードバックメッセージのフォーマット** | 名前 | ステータス | |---|---| | バイト数 | 1 | - **ステータス**: 0x00 操作は成功、0xFF 操作は失敗 入力コマンド: ``` 55 06 00 0A 00 00 10 1A (00=ポートインデックス, 00 10=グループID) ``` **注: マルチキャスト通信を使用する場合は、ターゲットショートアドレスを追加したグループIDに設定し、ターゲットポートを 0xFF に設定する必要がある。** フィードバックメッセージ: ``` 55 04 00 0A 00 0A ``` > 原文例は `... 00 10 group ID ...` の表記でグループID部の先頭バイト列に揺れがあるため、HEX値は原文を要確認。チェックコード(XOR8)は原文どおり 1A。 ### 6.1.11 モジュールのグループ解除(コマンドコード: 0x0B) - 対応デバイス: MP4(C/R/E)、CP13(C/R/E) - 機能: モジュール上のポートを指定グループから解除する。 **表 49 入力コマンドのフォーマット** | 名前 | ポートインデックス | グループID | |---|---|---| | バイト数 | 1 | 2 | **表 50 フィードバックメッセージのフォーマット** | 名前 | ステータス | |---|---| | バイト数 | 1 | - **ステータス**: 0x00 操作は成功、0x01 このポートはグループに存在しない、0xFF 操作は失敗 入力コマンド: ``` 55 06 00 0B 00 00 10 1B ``` フィードバックメッセージ: ``` 55 04 00 0B 00 0B ``` ### 6.1.12 送信出力の照会/設定(コマンドコード: 0x0D) - 対応デバイス: MP4(C/R/E)、CP13(C/R/E) - 機能: 送信出力の照会/設定。設定可能な強度は 0〜20dBm だが、電波法で規定される送信出力上限が13dBmのため、**必ず13dBm以下に設定して使用すること。** **表 51 入力コマンドのフォーマット** | 名前 | モード | 強度 | |---|---|---| | バイト数 | 1 | 1 | - **モード**: 0x00 現在の送信出力を照会、0x01 送信出力を設定 - **強度**: 送信出力。指定範囲 0x00~0x14(0-20)、単位dBm。モードが 0x00 の場合は不要。 **表 52 フィードバックメッセージのフォーマット** | 名前 | ステータス | 強度 | |---|---|---| | バイト数 | 1 | 1 | - **ステータス**: 0x00 操作は成功、0xFF 操作は失敗 入力コマンド(設定): ``` 55 05 00 0D 01 11 1D (01=設定, 11=出力レベル17) ``` 注: 出力レベルは 0x00~0x14。最大値を超える設定は有効にならず、以前の設定電力が維持される。上位コンピュータの設定範囲は 0x0E~0x14(原文)。(法令上限13dBm=0x0D を超える値の設定は行わないこと。) フィードバックメッセージ: ``` 55 05 00 0D 00 11 1C ``` 入力コマンド(照会): ``` 55 04 00 0D 00 0D ``` フィードバックメッセージ: ``` 55 05 00 0D 00 14 19 (14=電力レベル20) ``` > 原文注意: 例示は 0x11(17dBm)/0x14(20dBm) で、本文の「13dBm以下」の制限と矛盾する例。実運用は法令上限13dBm以下で設定すること。 ### 6.1.13 テストモードの実行(コマンドコード: 0x0F) - 対応デバイス: MP4(C/R/E)のみ - 機能: 送信出力と周波数精度をテストする。電波送信の試験モードとして観測機器に接続して検査する場合や、電波暗室でのアンテナ放射試験などを除き、通常は使用しないこと。使用方法によっては電波法に抵触する場合がある。 **表 53 入力コマンドのフォーマット** | 名前 | チャンネル | 強度 | モード | 時間 | |---|---|---|---|---| | バイト数 | 1 | 1 | 1 | 1 | - **チャンネル**: 0x0B ~ 0x1A(11-26) - **強度**: 0x00 ~ 0x14 - **モード**: 0x00 無変調波、0x01 変調波 - **時間**: 0x00(固定) **表 54 フィードバックメッセージのフォーマット** | 名前 | ステータス | |---|---| | バイト数 | 1 | - **ステータス**: 0x00 操作は成功、0xFF 操作は失敗 入力コマンド: ``` 55 07 00 0F 0B 14 00 00 10 (0B=チャンネル, 14=強度, 00=モード, 00=時間) ``` フィードバックメッセージ: ``` 55 04 00 0F 00 0F ``` 注: テストモードでは常に送信状態になる。終了するにはモジュールのリセットが必要。 ### 6.1.14 ローカル属性の照会(コマンドコード: 0x10) - 対応デバイス: MP4(C/R/E)、CP13(C/R/E) - 機能: ZCL属性パラメータを照会する。 **表 55 入力コマンドのフォーマット** | 名前 | ポートインデックス | 属性ID | |---|---|---| | バイト数 | 1 | 2 | - **ポートインデックス**: ポートインデックス番号。デフォルト値 0x00 - **属性ID**: ZCL属性ID(MP4のローカル属性は5.9節 表20を参照) **表 56 フィードバックメッセージのフォーマット** | 名前 | 実行ステータス | 属性データ | |---|---|---| | バイト数 | 1 | N | - **実行ステータス**: 0x00 操作は成功、0xFF 操作は失敗 - **属性データ**: ZCL属性の値 例: ``` ボーレートの読み取り 入力: 55 06 00 10 00 00 00 10 (00=ポートインデックス, 00 00=属性ID) フィードバック: 55 08 00 10 00 00 C2 01 00 D3 (00=成功, 00 C2 01 00=ボーレート115200[リトルエンディアン]) ターゲットショートアドレスの読み取り 入力: 55 06 00 10 00 00 01 00 11 (属性ID=01 00) フィードバック: 55 06 00 10 00 B2 30 92 (B2 30=ターゲットショートアドレス) 注: 未設定の場合、工場出荷時デフォルトは FF FF。 ターゲットポートの読み取り 入力: 55 06 00 10 00 00 02 00 12 (属性ID=02 00) フィードバック: 55 05 00 10 00 01 11 (01=ターゲットポート) 注: 未設定の場合、工場出荷時デフォルトは FF。 シリアルポートモードの読み取り 入力: 55 06 00 10 00 00 03 00 13 (属性ID=03 00) フィードバック: 55 05 00 10 00 00 10 (00=シリアルポートモード) 低消費電力レベルの読み取り 入力: 55 06 00 10 00 00 04 00 14 (属性ID=04 00) フィードバック: 55 05 00 10 00 01 11 (01=低消費電力レベル) ``` > 注: 原文の例では `port index` と `attribute ID` が各2バイトで記載されているものの、表55ではポートインデックス1バイト+属性ID2バイトである。上記は原文の表記(`55 06 00 10 00 [index] [attrID]`)に従う。厳密なバイト列は原文で要確認。 - **シリアルポートモード**: 0x00 HEXコマンドモード、0x01 透過伝送モード - **低消費電力レベル**: 0x00 1秒サイクルでウェイクアップ、0x01 3.3秒サイクル、0x02 5秒サイクル、0x03 常にスリープ状態 ### 6.1.15 ローカル属性の設定(コマンドコード: 0x11) - 対応デバイス: MP4(C/R/E)、CP13(C/R/E) - 機能: ZCL属性パラメータを設定する。 **表 57 入力コマンドのフォーマット** | 名前 | ポートインデックス | 属性ID | 属性データ | |---|---|---|---| | バイト数 | 1 | 2 | N | **表 58 フィードバックメッセージのフォーマット** | 名前 | 実行ステータス | |---|---| | バイト数 | 1 | - **実行ステータス**: 0x00 操作は成功、0xFF 操作は失敗 例(各設定のフィードバックはいずれも `55 04 00 11 00 11`): ``` シリアルポートのボーレート設定 入力: 55 0A 00 11 00 00 00 00 C2 01 00 D2 (ポートインデックス=00, 属性ID=00 00, ボーレート=00 C2 01 00) ターゲットショートアドレスの設定 入力: 55 08 00 11 00 01 00 B2 30 92 (属性ID=01 00, ターゲットショートアドレス=B2 30) ターゲットポートの設定 入力: 55 07 00 11 00 02 00 01 12 (属性ID=02 00, ターゲットポート=01) シリアルポートモードの設定 入力: 55 07 00 11 00 03 00 01 13 (属性ID=03 00, モード=01 透過伝送) 低消費電力レベルの設定 入力: 55 07 00 11 00 04 00 02 17 (属性ID=04 00, レベル=02) ``` - **シリアルポートモード**: 0x00 HEXコマンドモード、0x01 透過伝送モード **表 59 ボーレート設定コマンド** | 通信ボーレート | ローカル属性設定コマンド | コマンドフィードバック | 備考 | |---|---|---|---| | 9600(0x002580) | 55 0A 00 11 00 00 00 80 25 00 00 B4 | 55 04 00 11 00 11 | ボーレートの設定変更を反映させるには、モジュールの再起動が必要 | | 19200(0x004B00) | 55 0A 00 11 00 00 00 00 4B 00 00 5A | 55 04 00 11 00 11 | | | 38400(0x009600) | 55 0A 00 11 00 00 00 00 96 00 00 87 | 55 04 00 11 00 11 | | | 57600(0x00E100) | 55 0A 00 11 00 00 00 00 E1 00 00 F0 | 55 04 00 11 00 11 | | | 115200(0x01C200) | 55 0A 00 11 00 00 00 00 C2 01 00 D2 | 55 04 00 11 00 11 | | ### 6.1.16 自動接続(ペアリング)の設定(コマンドコード: 0x14) - 対応デバイス: MP4(C/R/E)、CP13(R/E) - 機能: モジュール同士の1対1データ透過伝送の接続を自動的に確立する設定。2つのモジュールで設定すると自動接続できる。新たに自動接続を実行すると、新たに検索・接続した相手の情報で上書きされ、以前の接続情報は削除される。接続結果は非同期メッセージで通知される。 **表 60 入力コマンドのフォーマット** | 名前 | コマンドデータ | |---|---| | NULL | | | バイト数 | 0 | **表 61 フィードバックメッセージのフォーマット** | 名前 | 実行ステータス | |---|---| | バイト数 | 1 | - **実行ステータス**: 0x00 実行は成功、0xFF 実行は失敗 入力コマンド: ``` 55 03 00 14 14 ``` フィードバックメッセージ: ``` 55 04 00 14 00 14 ``` 非同期フィードバックメッセージ(接続結果通知 0x80/0x10): ``` 55 06 80 10 0C A8 01 35 (0C A8=target short address, 01=target port, 35=チェックコード) ``` 非同期フィードバックメッセージ(ZCL受信 0x82/0x0F): ``` 55 10 82 0F 00 0C A8 01 13 01 08 FC 00 20 FC 01 00 13 (00=port index + send mode, 0C A8=target short address, 01=target port, 13=command number, 01=command direction, 08 FC=cluster ID, 00 20=manufacturer code, FC=RSSI, 01=command ID, 00=status, 13=チェックコード) ``` NWK_KEYピン操作による実行時の非同期メッセージ: ``` 55 06 80 10 0C A8 01 35 55 10 82 0F 00 0C A8 01 07 01 08 FC 00 20 FC 01 00 07 ``` 備考: - 自動接続の設定後、ユーザはコマンドでペアリングされた双方を透過伝送モードに移行させることで、双方間のデータ通信を開始できる。 - インジケータライト(NWK_LED): 自動接続先の検索中は素早く点滅(100ms オン/オフ)。デバイスを見つけるとゆっくり点滅(333ms オン/オフ)。対向デバイスとのペアリング完了で消灯する。 ### 6.1.17 ATコマンドモードに切り替え(コマンドコード: 0x16) - 対応デバイス: CP13(C/R/E) - 機能: シリアルポートモードをATコマンドモードに切り替える。ローカル属性のシリアルポートモードの値が TRUE(0x01)になる。切替後、ATコマンドモードで「AT+EXIT」を送信するとHEXコマンドモードに戻る。ATコマンドの仕様は「AT Command Specification Document」(別ドキュメント: Z240-CP13 ATコマンド仕様書)を参照。 **表 62 入力コマンドのフォーマット** | 名前 | コマンドデータ | |---|---| | NULL | | | バイト数 | 0 | **表 63 フィードバックメッセージのフォーマット** | 名前 | 実行ステータス | |---|---| | バイト数 | 1 | - **実行ステータス**: 0x00 実行は成功、0xFF 実行は失敗 入力コマンド: ``` 55 03 00 16 16 ``` フィードバックメッセージ: ``` 55 04 00 16 00 16 ``` ### 6.1.18 PWM出力のデューティ比の設定(コマンドコード: 0x18) - 対応デバイス: CP13(C/R/E) - 注: スリープエンドデバイスでは使用できない。 - 機能: 3系統のPWM出力のデューティ比を0~255の範囲で設定する。 **表 64 入力コマンドのフォーマット** | 名前 | PWM番号 | デューティ比 | |---|---|---| | バイト数 | 1 | 1 | - **PWM番号**: 0x00 ポート2のPWM、0x01 ポート3のPWM、0x02 ポート4のPWM - **デューティ比**: 有効範囲 0~255、各段階値は1/255に相当 > 原文注意: 「ポート2/3/4のPWM」の表記は、CP13ハードウェアデータシート表8の PWM0(No.27)/PWM1(No.28)/PWM2(No.12) との対応が明記されていない。 **表 65 フィードバックメッセージのフォーマット** | 名前 | 実行ステータス | |---|---| | バイト数 | 1 | - **実行ステータス**: 0x00 操作は成功、0xFF 操作は失敗 入力コマンド: ``` 55 05 00 18 00 20 38 (00=PWM番号, 20=デューティ比) ``` フィードバックメッセージ: ``` 55 04 00 18 00 18 ``` ### 6.1.19 PWMマーキングモードの設定(コマンドコード: 0x19) - 対応デバイス: CP13(C/R/E) - 注: スリープエンドデバイスでは使用できない。 - 機能: モジュールをマーキングモードに設定する。持続時間は最大255秒。マーキングモードに入るとPWMが1秒周期で点滅し、自動バインディングされたデバイスに検出されてバインドされる。 **表 66 入力コマンドのフォーマット** | 名前 | PWM番号 | 時間 | |---|---|---| | バイト数 | 1 | 1 | - **PWM番号**: 0x00 ポート2のPWM、0x01 ポート3のPWM、0x02 ポート4のPWM - **時間**: マーキングモードを継続する時間(秒) **表 67 フィードバックメッセージのフォーマット** | 名前 | 実行ステータス | |---|---| | バイト数 | 1 | - **実行ステータス**: 0x00 操作は成功、0xFF 操作は失敗 入力コマンド: ``` 55 05 00 19 00 0A 13 (00=PWM番号, 0A=マーキング時間10秒) ``` フィードバックメッセージ: ``` 55 04 00 19 00 19 ``` ### 6.1.20 拡張PAN IDによるネットワーク接続のロック(コマンドコード: 0x1A) - 対応デバイス: CP13(R/E) - 注: ルータ/エンドデバイスノードで、コーディネータの拡張PAN ID(64bit)でロックすることで、指定ネットワークに参加する。拡張PAN IDがロックされたモジュールは、ネットワーク参加が成功するまで自動的に接続を継続する。 - 機能: ロックされた拡張PAN IDの照会・設定。ルータ/エンドデバイスでこのコマンドによりコーディネータの拡張PAN IDを設定すると、そのコーディネータにのみ追加できる。値をすべて0にすると、ロックは解除される。 **表 68 入力コマンドのフォーマット** | 名前 | 操作モード | 拡張PAN ID | |---|---|---| | バイト数 | 1 | 8 | - **操作モード**: 0x00 ロックされた拡張PAN IDを照会、0x01 ロックする拡張PAN IDを設定 - **拡張PAN ID**: 8バイト。操作モードが設定の場合に有効。 **表 69 フィードバックメッセージのフォーマット** | 名前 | 実行ステータス | 拡張PAN ID | |---|---|---| | バイト数 | 1 | 8 | - **実行ステータス**: 0x00 操作は成功、0xFF 操作は失敗 - **拡張PAN ID**: 現在ロックされている拡張PAN ID。すべて0の場合はロックされていない。操作モードが照会の場合のみ存在。 例: ``` 設定 入力: 55 0C 00 1A 01 62 C4 88 79 9B 3D 18 59 AB フィードバック: 55 04 00 1A 00 1A 照会 入力: 55 04 00 1A 00 1A フィードバック: 55 0C 00 1A 00 62 C4 88 79 9B 3D 18 59 AA ロック解除(すべて0を設定) 入力: 55 0C 00 1A 01 00 00 00 00 00 00 00 00 1B フィードバック: 55 04 00 1A 00 1A 照会(ロック解除後) 入力: 55 04 00 1A 00 1A フィードバック: 55 0C 00 1A 00 00 00 00 00 00 00 00 00 1A ``` ### 6.1.21 ネットワーク参加ノードのアドレス照会(コマンドコード: 0x22) - 対応デバイス: CP13(C/R/E) - 機能: 参加済みノードのMACアドレスとショートアドレスを照会する。1エントリずつ照会可能。メモリ上に記憶できるエントリ数は最大80。電源オフ時のアドレステーブルの保存はサポートされないため、外部MCUでの読み取り・保存を推奨。 **表 70 入力コマンドのフォーマット** | 名前 | アドレス番号 | |---|---| | バイト数 | 2 | - **アドレス番号**: コーディネータが保存しているアドレス番号。有効範囲 0x0000~0x00FE **表 71 フィードバックメッセージのフォーマット** | 名前 | ステータス | アドレス番号 | ノードショートアドレス | ノードMACアドレス | |---|---|---|---|---| | バイト数 | 1 | 2 | 2 | 8 | - **ステータス**: 0x00 ネットワークに参加中、0x02 ネットワークから離脱中、0xFF アドレステーブルにエントリが存在しない - **アドレス番号 / ノードショートアドレス / ノードMACアドレス**: 保存されている値 入力コマンド: ``` 55 05 00 22 00 00 22 (00 00=アドレス番号) ``` フィードバックメッセージ: ``` 55 10 00 22 00 00 00 D8 49 CC 53 AD 2F 00 4B 12 00 F7 (00=ステータス, 00 00=アドレス番号, D8 49=ショートアドレス, CC 53 AD 2F 00 4B 12 00=MACアドレス, F7=チェックコード) ``` ### 6.1.22 デバイス情報通知の再送信(コマンドコード: 0x28) - 対応デバイス: MP4(C/R/E)、CP13(C/R/E) - 機能: 「デバイス情報の通知」(6.2.6項、コマンドコード0x05)は、ノードが最初にネットワークに参加したときにのみ通知される。受信できなかった場合は、ノードに再送信を要求できる。この要求はノードが正常動作している場合にのみ有効。 **表 72 入力コマンドのフォーマット** | 名前 | ノードMACアドレス | |---|---| | バイト数 | 8 | - **ノードMACアドレス**: 通知の再送信を要求するノードのMACアドレス **表 73 フィードバックメッセージのフォーマット** | 名前 | 実行ステータス | |---|---| | バイト数 | 1 | - **実行ステータス**: 0x00 操作は成功(ノードが送信するまで待機)、0xFF 操作は失敗(デバイスが存在しない可能性あり。本モジュールをコーディネータとして使用している場合は、3~6秒間隔で1~2回再試行すると成功する可能性あり) 入力コマンド: ``` 55 0B 00 28 CC 53 AD 2F 00 4B 12 00 6C (CC 53 AD 2F 00 4B 12 00=MACアドレス) ``` フィードバックメッセージ: ``` 55 04 00 28 00 28 ``` ### 6.1.23 ZCLポートの作成(コマンドコード: 0x40) - 対応デバイス: MP4(C/R/E) - 機能: ZCL仕様に準拠するポートを作成する。ZCL属性の追加、ZCLポートの保存、属性のコマンドと組み合わせて使用する。ポート作成後に属性を追加し、別途保存を実行する必要がある。ポートはネットワーク未参加状態で作成する必要がある。すべてのポートがクリアされない限り、保存済みのポート番号を再使用して新しいポートを作成することはできない。 **表 74 入力コマンドのフォーマット** | 名前 | 属性数 | ポート番号 | プロファイルID | デバイスID | 入力クラスタ: 数 | 入力クラスタ: クラスタIDリスト | 出力クラスタ: 数 | 出力クラスタ: クラスタIDリスト | |---|---|---|---|---|---|---|---|---| | バイト数 | 1 | 1 | 2 | 2 | 1 | 2 * N1 | 1 | 2 * N2 | - **属性数**: このポートに必要な属性の数 - **ポート番号**: 作成するデバイスのポート番号 - **プロファイルID**: ZigBee® HAプロファイル準拠の場合は 0x0104 - **デバイスID**: ZCL仕様に従って決まるデバイスの機能タイプ - **入力クラスタリスト / 出力クラスタリスト**: サポートする入力/出力クラスタ(クラスタ数とクラスタIDリスト) **表 75 フィードバックメッセージのフォーマット** | 名前 | 実行ステータス | ポートインデックス | ポート番号 | プロファイルID | デバイスID | 入力クラスタリスト | 出力クラスタリスト | |---|---|---|---|---|---|---|---| | バイト数 | 1 | 1 | 1 | 2 | 2 | 可変長 | 可変長 | > 原文注意: 表75の「実行ステータス」欄に「(計算中)」の注記が残っている。バイト数の並びは原文のまま。 **表 76 クラスタリストのフォーマット** | 名前 | 入力クラスタ: 数 | 入力クラスタ: クラスタIDリスト | 出力クラスタ: 数 | 出力クラスタ: クラスタIDリスト | |---|---|---|---|---| | バイト数 | 1 | 2 * N1 | 1 | 2 * N2 | - **実行ステータス**: 0x00 実行は成功、0xFF 実行は失敗 - **ポートインデックス**: モジュールがポートに割り当てたアドレスインデックス(0~15)。実際にサポートされる最大ポート数はハードウェアリソースで決まる。 - **ポート番号 / プロファイルID / デバイスID / 入力・出力クラスタリスト**: 作成された値 入力コマンド: ``` 55 15 00 40 15 01 04 01 00 01 05 00 00 03 00 04 00 05 00 06 00 00 51 ``` (原文の注記による区切り: `15`=属性数(属性上限)、`01`=ポート番号、`04 01`=プロファイルID、`00 01`=デバイスID(原文表記)、`05`=入力クラスタ数、`00 00 03 00 04 00 05 00 06 00`=入力クラスタ、`00`=出力クラスタ数、`51`=チェックコード) フィードバックメッセージ: ``` 55 16 00 40 00 00 01 04 01 00 01 05 00 00 03 00 04 00 05 00 06 00 00 44 (00=成功, 00=割り当てポートインデックス, 01=ポート番号, 04 01=プロファイルID, 00 01=デバイスID, 05=入力クラスタ数, 00 00 03 00 04 00 05 00 06 00=入力クラスタ, 00=出力クラスタ数, 44=チェックコード) ``` > 原文注意: 本例の「プロファイルID 04 01」はリトルエンディアンで 0x0104(HA)。 ### 6.1.24 ポートに属性の追加(コマンドコード: 0x41) - 対応デバイス: MP4(C/R/E) - 機能: 新しく作成したポートに属性を追加する。属性はポート作成後に追加し、別途保存操作が必要。**属性は、属性ID、製造者コード、クラスタIDを降順にして1データずつ追加する必要がある。** このコマンドによる属性追加は直前に作成したポートに対してのみ有効で、それ以前に作成したポートへの実行は失敗する。 **表 77 入力コマンドのフォーマット** | 名前 | クラスタID | 製造者コード | 属性ID | データ型 | サポート操作 | 属性方向 | |---|---|---|---|---|---|---| | バイト数 | 2 | 2 | 2 | 1 | 1 | 1 | - **クラスタID**: 追加する属性のクラスタID - **製造者コード**: 属性の製造者コード - **属性ID**: 属性の16ビットID - **データ型**: 表15 ZCL属性データ型を参照 - **サポート操作**: bit0 読み取り可能、bit1 書き込み可能、bit2 アクティブレポートをサポート - **属性方向**: 0x00 サーバ側属性、0x01 クライアント側属性 **表 78 フィードバックメッセージのフォーマット** | 名前 | 実行ステータス | 現在のポート番号 | クラスタID | 製造者コード | 既存属性数(N) | 属性リスト | |---|---|---|---|---|---|---| | バイト数 | 1 | 1 | 2 | 2 | 1 | N*4 | **表 79 属性リストフォーマット** | 名前 | 属性ID | データ型 | サポート操作 | |---|---|---|---| | バイト数 | 2 | 1 | 1 | - **実行ステータス**: 0x00 実行は成功、0xFF 実行は失敗 - **現在のポート番号 / クラスタID / 製造者コード**: 追加された属性のもの - **既存属性数**: このクラスタIDと製造者コードで追加された属性の数 - **属性リスト**: 属性ID、データ型(表15)、サポート操作と属性方向(bit0 読み取り可能、bit1 書き込み可能、bit2 アクティブレポートをサポート、bit7 0=サーバ側属性/1=クライアント側属性) 入力コマンド: ``` 55 0C 00 41 00 00 00 00 00 00 20 01 00 60 (00 00=クラスタID, 00 00=製造者コード, 00 00=属性ID, 20=データ型, 01=サポート操作, 00=属性方向, 60=チェックコード) ``` フィードバックメッセージ: ``` 55 0E 00 41 00 01 00 00 00 00 01 00 00 20 01 60 (00=成功, 01=現在のポート, 00 00=クラスタID, 00 00=製造者コード, 01=追加済み属性数, 00 00=属性ID, 20=データ型, 01=サポート操作, 60=チェックコード) ``` ### 6.1.25 ポートと属性設定の保存(コマンドコード: 0x42) - 対応デバイス: MP4(C/R/E) - 機能: 作成済みのポートと、追加された属性をFLASHに保存する。複数ポートが必要な場合は、必要なすべてのポートと属性を作成してから保存する。 **表 80 入力コマンドのフォーマット** | 名前 | コマンドデータ | |---|---| | NULL | | | バイト数 | 0 | **表 81 フィードバックメッセージのフォーマット** | 名前 | 実行ステータス | |---|---| | バイト数 | 1 | - **実行ステータス**: 0x00 保存は成功、0xFF 保存は失敗 入力コマンド: ``` 55 03 00 42 42 ``` フィードバックメッセージ: ``` 55 04 00 42 00 42 ``` ### 6.1.26 属性値の照会/設定(コマンドコード: 0x43) - 対応デバイス: MP4(C/R/E) - 機能: 作成された属性の照会・設定。設定時の有効データ長が、属性作成時のデータ型の長さより長い場合、有効データはデータ型で定義された長さに切り取られる。 **表 82 入力コマンドのフォーマット** | 名前 | 操作 | ポートインデックス | 属性方向 | クラスタID | 製造者コード | 属性ID | データ | |---|---|---|---|---|---|---|---| | バイト数 | 1 | 1 | 1 | 2 | 2 | 2 | 可変長 | - **操作**: 0x00 属性の照会、0x01 属性の設定、0x02 属性の設定とFLASHへ保存(Basicクラスタの8つの属性に対してのみ有効) - **ポートインデックス**: ポート作成時にモジュールに割り当てられたインデックス番号 - **属性方向**: 0x00 サーバ側属性、0x01 クライアント側属性 - **クラスタID / 製造者コード / 属性ID**: 属性定義のもの - **データ**: 属性値。操作が 0x00 の場合は不要。データサイズが属性のデータ型サイズを超える場合、リトルエンディアン形式で制限サイズに切り取られる。 **表 83 フィードバックメッセージのフォーマット** | 名前 | 実行ステータス | データ型 | データ | |---|---|---|---| | バイト数 | 1 | 1 | 可変長 | - **実行ステータス**: 0x00 照会/設定は成功、0xFF 失敗 - **データ型**: 表15を参照 - **データ**: 属性のデータ値 例: ``` 設定 入力: 55 0D 00 43 01 00 00 06 00 00 00 00 00 01 45 (01=操作, 00=ポートインデックス, 00=属性方向, 06 00=クラスタID, 00 00=製造者コード, 00 00=属性ID, 01=データ) フィードバック: 55 04 00 43 00 43 照会 入力: 55 0C 00 43 00 00 00 06 00 00 00 00 00 45 フィードバック: 55 06 00 43 00 10 01 52 (00=成功, 10=データ型(bool), 01=データ) ``` ### 6.1.27 ポートと属性の消去(コマンドコード: 0x44) - 対応デバイス: MP4(C/R/E) - 機能: モジュールに設定されたすべてのポートと属性を消去する。すべて消去されると、透過伝送のみ使用可能なモジュールに戻る。**ネットワークから離脱している状態で実行する必要がある。** ネットワーク参加中は失敗する。 **表 84 入力コマンドのフォーマット** | 名前 | コマンドデータ | |---|---| | NULL | | | バイト数 | 0 | **表 85 フィードバックメッセージのフォーマット** | 名前 | 実行ステータス | |---|---| | バイト数 | 1 | - **実行ステータス**: 0x00 消去は成功、0xFF 消去は失敗 入力コマンド: ``` 55 03 00 44 44 ``` フィードバックメッセージ: ``` 55 04 00 44 00 44 ``` --- ## 6.2 システム通知メッセージ システム通知メッセージは、外部MCUからのコマンド入力とは非同期に発生するメッセージであり、本モジュール自体または同一ネットワーク内ノードの情報を通知するコマンド群です。外部MCUは、このメッセージの受信によってネットワーク状態の変化、更新情報等を取得することが可能です。 > 非同期メッセージのコマンドタイプは 0x80(TYPE_NOTIFY)。各例の色分け凡例(原文): 紫=ペイロード長、赤=コマンドタイプ+コマンドコード、青=チェックコード。 ### 6.2.1 リセット通知(コマンドコード: 0x00) - **対応デバイス**: MP4(C/R/E)、CP13(C/R/E) - **機能**: 本モジュールの電源を入れた時に通知されるメッセージです。このモジュールのMACアドレスが含まれます。 **表86 非同期フィードバックメッセージ** | 名前 | リセットモード | ソフトウェアバージョン番号 | MACアドレス | |---|---|---|---| | バイト数 | 1 | 1 | 8 | - **リセットモード**: 起動方法のモード - 0x00: 電源投入による起動 - 0x01: RESETピンに対するLow信号入力によるリセット起動 - 0x02: コマンド実行によるリセット起動 - **ソフトウェアバージョン番号**: モジュールのソフトウェアバージョン番号 - **MACアドレス**: モジュールのMACアドレス ``` 55 0D 80 00 02 | 14 | 28 | EA E2 1A 00 4B 12 00 | F5 (0x02=reset mode, 0x14=software version(原文表記: 14 software version 28 の並び), MAC address=EA E2 1A 00 4B 12 00 …, F5=checksum) ``` > 原文注意: 原文の例は `55 0D 80 00 02 reset mode 14 software version 28 EA E2 1A 00 4B 12 00 MAC address F5`(注記テキストが埋め込まれた形)。HEX列は `55 0D 80 00 02 14 28 EA E2 1A 00 4B 12 00 F5`。 ### 6.2.2 ネットワークステータス通知(コマンドコード: 0x01) - **対応デバイス**: MP4(C/R/E)、CP13(C/R/E) - **機能**: 本モジュールがネットワーク接続を試行する時に「ネットワーク接続の成功」「ネットワーク接続の失敗」の非同期メッセージが生成されます。 **表87 非同期フィードバックメッセージ** | 名前 | ネットワークステータス | MACアドレス | チャンネル | PAN ID | ショートアドレス | 拡張PAN ID | ネットワークキー | |---|---|---|---|---|---|---|---| | バイト数 | 1 | 8 | 1 | 2 | 2 | 8 | 16 | - **ネットワークステータス**: - 0x00: ネットワーク接続は失敗 - 0x01: ネットワーク接続は成功 - 0x02: ネットワークを開始中 - 0x03: ネットワーク接続は成功したが親ノードが未接続 - **MACアドレス**: モジュールのMACアドレス、工場出荷時に固定 - **チャンネル**: 現在のモジュールのチャンネル、ネットワーク接続が失敗時は0x00 - **PAN ID**: 現在のモジュールのPAN ID、ネットワーク接続が失敗時は0xFFFE - **ショートアドレス**: 現在のモジュールのショートアドレス、ネットワークの接続が失敗時は0xFFFE - **拡張PAN ID**: モジュールの拡張PAN ID、ネットワーク接続が失敗時はすべて0 - **ネットワークキー**: ネットワーク暗号化キー、ネットワーク接続が失敗時はすべて0 ネットワーク接続開始通知(status=0x02): ``` 55 29 80 01 02 C6 B4 E2 0A 00 4B 12 00 14 16 B3 00 00 C6 B4 E2 0A 00 4B 12 00 1B F0 09 64 46 CB 73 77 A7 66 F8 CA 01 B7 80 F6 0E ``` ネットワーク接続成功通知(status=0x01): ``` 55 29 80 01 01 C6 B4 E2 0A 00 4B 12 00 14 16 B3 00 00 C6 B4 E2 0A 00 4B 12 00 1B F0 09 64 46 CB 73 77 A7 66 F8 CA 01 B7 80 F6 0D ``` 内訳: `02/01`=ステータス、`C6 B4 E2 0A 00 4B 12 00`=MAC、`14`=チャンネル、`16 B3`=PAN ID、`00 00`=ショートアドレス、`C6 B4 E2 0A 00 4B 12 00`=拡張PAN ID、`1B F0 … F6`=ネットワークキー(16バイト)、末尾=チェックコード。 ### 6.2.3 ネットワークウィンドウタイム通知(コマンドコード: 0x02) - **対応デバイス**: MP4(C)、CP13(C) - **機能**: コーディネータはネットワークを開始した後、ウィンドウタイム(ネットワークへの接続が許可されている時間)を非同期メッセージで通知します。新しいノードが接続された場合、その新しいノードがコーディネータのウィンドウタイムを延長する可能性があります。さらに、既に接続されているルータとエンドデバイスもネットワーク設定コマンドを使用して、コーディネータのウィンドウタイムを延長することができますが、コーディネータのネットワークが停止している場合、ルータやエンドデバイスはネットワークを開くことができません。このメッセージは、コーディネータがネットワークへのノードの参加の許可をオフにした時にも発行され、その場合のウィンドウタイムは0になります。 **表88 非同期フィードバックメッセージ** | 名前 | ウィンドウタイム | |---|---| | バイト数 | 1 | - **ウィンドウタイム**: コーディネータのネットワーク開始ウィンドウタイム。「0」の場合、ネットワークが停止していることを意味する(最大値は0xB4=180秒) ``` 55 04 80 02 B4 36 ``` (B4 = ウィンドウタイム、デフォルト180秒。36 = チェックコード) ### 6.2.4 ノードのネットワーク接続通知(コマンドコード: 0x03) - **対応デバイス**: MP4(C/R/E)、CP13(C/R/E) - **機能**: ノードがネットワークに接続または再接続されたことが検出されると、エンドデバイスは親ノードに切り替わり、ルータは再同期を行います。これによりネットワークへの再接続が行われます。 **表89 非同期フィードバックメッセージ** | 名前 | MACアドレス | ショートアドレス | 親ノードアドレス | ネットワーク接続モード | |---|---|---|---|---| | バイト数 | 8 | 2 | 2 | 1 | - **MACアドレス**: ネットワーク接続ノードのMACデバイス(原文表記) - **ショートアドレス**: ネットワーク接続ノードのショートアドレス - **親ノードアドレス**: ネットワーク接続ノードの親ノードアドレス、子ノードのエンドデバイスをネットワークから切り離す場合に必要 - **ネットワーク接続モード**: - 0x00: ネットワークへの初回接続 - 0x01: 再接続 - 0x02: 再接続およびキーの再同期 ``` 55 10 80 03 B6 CD BC FE FF 7E E0 E8 25 7B 00 00 00 6D ``` 内訳: `B6 CD BC FE FF 7E E0 E8`=MAC、`25 7B`=ショートアドレス、`00 00`=親ノードアドレス、`00`=接続モード、`6D`=チェックコード。 ### 6.2.5 ノードのアドレス通知(コマンドコード: 0x04) - **対応デバイス**: MP4(C/R/E)、CP13(C/R/E) - **機能**: 本モジュールまたは他のノードがネットワークに接続されると、そのMACアドレスとショートアドレスがコーディネータに通知されます。また、動作中にショートアドレスが変更された場合、このコマンドが通知として使用されます。この通知コマンドを受信した際に、外部MCUは保持しているMACアドレスとショートアドレスのマッピング関係を随時更新する必要があります。これにより、通信相手の識別やデータ管理において正しいアドレス情報が保持されます。 **表90 非同期フィードバックメッセージ** | 名前 | MACアドレス | ショートアドレス | デバイスタイプ | |---|---|---|---| | バイト数 | 8 | 2 | 1 | - **MACアドレス**: ターゲットノードのMACアドレス - **ショートアドレス**: ターゲットノードのショートアドレス - **デバイスタイプ**: 0x01=ルータ、0x02=非スリープエンドデバイス、0x03=スリープエンドデバイス ``` 55 0E 80 04 C6 DE E2 08 00 4B 12 00 1A 47 02 70 ``` 内訳: `C6 DE E2 08 00 4B 12 00`=MAC、`1A 47`=ショートアドレス、`02`=ノードタイプ、`70`=チェックコード。 ### 6.2.6 ノードのポート情報通知(コマンドコード: 0x05) > 注: ノードがネットワークに接続されると自動的にこのメッセージを取得します。また、「デバイス情報通知の再送信」(6.1.22項 デバイス情報通知の再送信(コマンドコード: 0x28))を使用してこのメッセージを取得することも可能です。5秒以内に12以上のノードがネットワークに接続する場合、このメッセージは失われる可能性があります。 - **対応デバイス**: MP4(C/R/E)、CP13(C/R/E) - **機能**: ノードが初めてネットワークにアクセスする際、デバイスID情報や各ポートでサポートされているクラスタ情報など、ノードの周辺機器情報を自動的に取得して通知されます。 **表91 非同期フィードバックメッセージ** | 名前 | 終了フラグ | デバイスSN番号 | ショートアドレス | ポート番号 | プロファイルID | デバイスID | 入力クラスタリスト | 出力クラスタリスト | |---|---|---|---|---|---|---|---|---| | バイト数 | 1 | 9 | 2 | 1 | 2 | 2 | 可変長 | 可変長 | **表92 クラスタリストのフォーマット** | 名前 | 入力クラスタ: 数(N1) | 入力クラスタ: クラスタIDリスト | 出力クラスタ: 数(N2) | 出力クラスタ: クラスタIDリスト | |---|---|---|---|---| | バイト数 | 1 | 2 * N1 | 1 | 2 * N1(原文表記。出力側も2*N2が妥当) | - **終了フラグ**: ポート通知の終了を示すフラグ。1つのノードがネットワークに参加すると、複数のポートの情報が通知される。0x01=ノードのポート情報通知が終了 - **デバイスSN番号**: デバイスの仮想SN番号、「表17 仮想デバイスSN番号」を参照 - **ショートアドレス**: ノードのショートアドレス - **ポート番号**: ノードのポート番号 - **プロファイルID**: ポートのプロファイルID、ZigBee® HAプロファイルに準拠する場合は0x0104 - **デバイスID**: ZCLプロトコル仕様によって決定されるデバイスの機能タイプ - **入力クラスタリスト**: デバイスでサポートされている入力クラスタ、クラスタの数とクラスタIDのリストを含む - **出力クラスタリスト**: デバイスでサポートされている出力クラスタ、クラスタの数とクラスタIDのリストを含む ``` 55 28 80 05 00 01 B6 CD BC FE FF 7E E0 E8 25 7B 01 04 01 50 00 05 00 00 03 00 04 00 07 00 08 FC 04 03 00 06 00 08 00 08 FC 32 55 28 80 05 00 02 B6 CD BC FE FF 7E E0 E8 25 7B 02 04 01 01 01 05 03 00 04 00 05 00 06 00 08 00 00 67 55 28 80 05 00 03 B6 CD BC FE FF 7E E0 E8 25 7B 03 04 01 01 01 05 03 00 04 00 05 00 06 00 08 00 00 67 55 28 80 05 01 04 B6 CD BC FE FF 7E E0 E8 25 7B 04 04 01 01 01 05 03 00 04 00 05 00 06 00 08 00 00 66 ``` > 原文注意: 原文1行目の注記は「termination flag 01(デバイスSN先頭?) … device ID 50 00 device ID 05 input cluster size 00 00 03 00 …」のように注記が埋め込まれている。上記HEXは注記を除去して並べたもの。2〜4行目の終了フラグは00、4行目のみ01(最終ポート)。 ### 6.2.7 ノードのネットワーク離脱通知(コマンドコード: 0x06) - **対応デバイス**: MP4(C)、CP13(C) - **機能**: ネットワークを構成しているノード群のデバイスが自発的に(離脱コマンドまたはモジュールピン入力により)ネットワークから離脱した場合、コーディネータはこの通知を受信します。この通知は本モジュールをコーディネータとして使用している場合に限り受信します。オフグリッド動作時、デバイスは1回の処理で複数回の通知パケットを送信する場合があります。もし、この離脱するノードがコーディネータの通信範囲に存在しない場合、コーディネータはこの通知を受信できませんが、当該ノードはネットワークから離脱できます。 **表93 非同期フィードバックメッセージ** | 名前 | MACアドレス | |---|---| | バイト数 | 8 | - **MACアドレス**: 離脱した(オフグリッド)ノードのMACアドレス ``` 55 0B 80 06 51 20 9F 0C 00 4B 12 00 3D ``` ### 6.2.8 自動接続ステータス通知(コマンドコード: 0x10) - **対応デバイス**: MP4(C/R/E)、CP13(R/E) - **機能**: モジュールの自動接続のステータス通知です。透過伝送機能の自動接続が確立した時、ノードの自動バインディング接続が確立した時に通知されます。 **表94 非同期フィードバックメッセージ** | 名前 | ターゲットショートアドレス | ターゲットポート | クラスタID | |---|---|---|---| | バイト数 | 2 | 1 | 2 | - **ターゲットショートアドレス**: 接続した対向デバイスのショートアドレス - **ターゲットポート**: 接続した対向デバイスのポート番号 - **クラスタID**: 接続を確立したクラスタID。このフィールドはZ240-CP13でのみサポート - 0xFC08: 透過伝送機能の接続を確立 - 0x0006 または 0x0008: 照明機器のATコマンド制御を確立 MP4: ``` 55 06 80 10 0C A8 01 35 ``` CP13: ``` 55 0B 80 10 0A 14 01 08 FC 7B ``` (`0C A8`/`0A 14`=ターゲットショートアドレス、`01`=ターゲットポート、`08 FC`=クラスタID) > 原文注意: CP13例のペイロード長は 0x0B だが実バイト数は 7(0x10 + 2 + 1 + 2 + チェック)と合わない。原文のまま記載。 --- ## 6.3 ネットワーク管理コマンド ネットワーク管理コマンドは、本モジュールが属しているネットワークのデバイスについての情報取得などを行うコマンド群です。本モジュール以外のデバイス情報については、外部MCUからコマンドを入力後にデバイス間で通信が行われ、最終的な結果を非同期メッセージとして受信します。 > HEX例について: 原文は各バイト列に注記("target short address" 等)が埋め込まれている。本MDではHEXのみを示し、内訳を `内訳:` 行に記す。色分け凡例(原文): 紫=ペイロード長、赤=コマンドタイプ+コマンドコード、青=チェックコード。 **統一されたコマンドヘッダフォーマット**: ネットワーク管理コマンドは入力コマンドを送信し、1回目はフィードバックメッセージを受信し、2回目は非同期メッセージ「送信確認メッセージ」を受信し、3回目は非同期メッセージ「ネットワーク管理応答メッセージ」を受信します。メッセージを受信する度に、次のメッセージを受信するか、もしくは受信しないかが決定されます。 **表95 入力コマンドのフォーマット** | 名前 | ショートアドレス | コマンドパラメータ | |---|---|---| | バイト数 | 2 | 可変長 | - **コマンドパラメータ**: コマンドごとにパラメータは異なり、各コマンドのパラメータは後で解析される **表96 フィードバックメッセージのフォーマット** | 名前 | 実行ステータス | コマンド番号 | |---|---|---| | バイト数 | 1 | 1 | - **実行ステータス**: 0x00=実行は成功、続いて送信確認メッセージが生成される。その他の値=実行は失敗、「表14 無線送信ステータス」を参照 - **コマンド番号**: システムによってコマンドに割り当てられた番号、外部MCUはネットワーク管理コマンドの送信と応答の確認で対応する入力コマンドを追跡可能 **表97 送信確認メッセージのフォーマット**(コマンドタイプ 0x8F、コマンドコード 0x01) | 名前 | ショートアドレス | 送信結果 | コマンド番号 | |---|---|---|---| | バイト数 | 2 | 1 | 1 | - **ショートアドレス**: 送信先のショートアドレス - **送信結果**: 無線送信結果、「表14 無線送信ステータス」を参照 - **コマンド番号**: 送信確認メッセージとネットワーク管理応答メッセージで対応する入力コマンドを追跡するためにシステムによって割り当てられた番号 **表98 応答メッセージのフォーマット**(コマンドタイプ 0x81) | 名前 | ショートアドレス | コマンド番号 | 実行結果 | メッセージパラメータ | |---|---|---|---|---| | バイト数 | 2 | 1 | 1 | 可変長 | - **ショートアドレス**: コマンドに応答したデバイスのショートアドレス - **コマンド番号**: 送信時のシステム割り当てと一致し、送信ノードは受信ノードが生成した番号を返す - **実行結果**: 受信したコマンドの実行結果、「unsupported」の場合あり - **メッセージパラメータ**: 実行結果が0x00の場合のみパラメータは有効 **コマンドとメッセージ送受信の説明**: ネットワーク管理コマンドは、外部MCUから送信モジュールに対して発行されます。フィードバックメッセージの機能は、コマンドが正しく入力されたかどうか、およびこのモジュールがメッセージを送信している状態であるかどうかを示すのみです。送信確認は、メッセージが送信されたかどうか、または、ターゲットに送信されたかどうか(途中ではないこと)を示します。受信した応答メッセージは送信側デバイスによる実行の結果です。 ### 6.3.1 ショートアドレスの照会(コマンドコード: 0x00) - **対応デバイス**: MP4(C/R/E)、CP13(C/R/E) - **機能**: MACアドレスに基づいてターゲットノードのショートアドレスを照会します。このコマンドは、フレームヘッダのショートアドレスのフィールドに0xFFFDブロードキャストアドレスを入力する必要があります。0xFFFD以外が指定された場合は、コマンドは失敗します。 **表99 入力コマンドのフォーマット(コマンドパラメータのみ)** | 名前 | MACアドレス | |---|---| | バイト数 | 8 | - **MACアドレス**: ターゲットノードのMACアドレス **表100 応答メッセージのフォーマット(メッセージパラメータのみ)** | 名前 | MACアドレス | 予約バイト | |---|---|---| | バイト数 | 8 | 2 | - **MACアドレス**: ターゲットノードのMACアドレス、ターゲットノードのショートアドレスはコマンドヘッダに含まれる - **予約バイト**: 将来的に使用される可能性があるバイト列、現在は無意味な値 入力コマンド: ``` 55 0D 01 00 FD FF 3D 01 70 0F 00 4B 12 00 19 ``` 内訳: `FD FF`=ブロードキャストアドレス、`3D 01 70 0F 00 4B 12 00`=ターゲットMAC。 フィードバックメッセージ: ``` 55 05 01 00 00 05 04 ``` 内訳: `00`=ステータス、`05`=コマンド番号。 送信確認メッセージ: ``` 55 07 8F 01 FD FF 00 05 89 ``` 応答メッセージ: ``` 55 11 81 00 00 A0 05 00 3D 01 70 0F 00 4B 12 00 B3 00 8D ``` 内訳: `00 A0`=ターゲットショートアドレス、`05`=コマンド番号、`00`=成功、`3D 01 70 0F 00 4B 12 00`=ターゲットMAC、`B3 00`=予約バイト。 > **注**: このコマンドでは、デバイスは自身のショートアドレスの照会を保証していません。 ### 6.3.2 MACアドレスの照会(コマンドコード: 0x01) - **対応デバイス**: MP4(C/R/E)、CP13(C/R/E) - **機能**: ショートアドレスに基づいてターゲットデバイスのMACアドレスを照会します。 **表101 入力コマンドのフォーマット(コマンドパラメータのみ)** | 名前 | NULL | |---|---| | バイト数 | 0 | **表102 応答メッセージのフォーマット(メッセージパラメータのみ)** | 名前 | MACアドレス | 予約バイト | |---|---|---| | バイト数 | 8 | 2 | - **MACアドレス**: ターゲットデバイスのMACアドレス - **予約バイト**: 将来的に使用される可能性があるバイト列、現在は無意味な値 入力コマンド: ``` 55 05 01 01 7B 20 5B ``` 内訳: `7B 20`=ターゲットショートアドレス。 フィードバックメッセージ: ``` 55 05 01 01 00 1A 1A ``` 内訳: `00`=ステータス、`1A`=コマンド番号。 送信確認メッセージ: ``` 55 07 8F 01 7B 20 00 1A CF ``` 応答メッセージ: ``` 55 11 81 01 7B 20 1A 00 3D 01 70 0F 00 4B 12 00 AB 00 70 ``` 内訳: `7B 20`=ターゲットショートアドレス、`1A`=コマンド番号、`00`=成功、`3D 01 70 0F 00 4B 12 00`=ターゲットMAC、`AB 00`=予約バイト。 > **注**: このコマンドでは、デバイスは自身のMACアドレスの照会を保証していません。 ### 6.3.3 ノードのサポートクラスタの照会(コマンドコード: 0x04) - **対応デバイス**: MP4(C/R/E)、CP13(C/R/E) - **機能**: ターゲットデバイスがサポートするクラスタを照会します。 **表103 入力コマンドのフォーマット(コマンドパラメータのみ)** | 名前 | ポート番号 | |---|---| | バイト数 | 1 | - **ポート番号**: ターゲットデバイスのポート番号 **表104 応答メッセージのフォーマット(メッセージパラメータのみ)** | 名前 | ポート番号 | プロファイルID | デバイスID | デバイス情報バージョン | 入力クラスタ: 数(N1) | 入力クラスタ: クラスタID | 出力クラスタ: 数(N2) | 出力クラスタ: クラスタID | |---|---|---|---|---|---|---|---|---| | バイト数 | 1 | 2 | 2 | 1 | 1 | 2 * N1 | 1 | 2 * N2 | - **ポート番号**: ターゲットノードのポート番号 - **プロファイル**: プロファイルID、ZigBee® HAプロファイルに準拠する場合は0x0104 - **デバイスID**: ポートのデバイスタイプID、ターゲットデバイスがサポートする機能を区別するために使用可能 - **デバイス情報バージョン**: デバイス説明情報のバージョン番号、0x00はバージョンv1.0 - **入力クラスタリスト**: ターゲットデバイスでサポートされている入力クラスタ - **出力クラスタリスト**: ターゲットデバイスでサポートされている出力クラスタ **例**: 本Z240-MP4 (CT/EA)モジュールを使用して、PWM機能を備えたZigBee®互換モジュールを照会します。ターゲットデバイスのポート1は透過伝送モード、ポート2はPWM出力。 **ポート1の照会** 入力コマンド(`3B B1`=ターゲットショートアドレス、`01`=ターゲットポート): ``` 55 06 01 04 3B B1 01 8E ``` フィードバックメッセージ(`00`=ステータス、`04`=コマンド番号): ``` 55 05 01 04 00 04 01 ``` 送信確認メッセージ(`00`=ステータス、`04`=コマンド番号): ``` 55 07 8F 01 3B B1 00 04 00 ``` 応答メッセージ: ``` 55 1D 81 04 3B B1 04 00 01 04 01 50 00 00 04 00 00 03 00 07 00 08 FC 03 03 00 06 00 08 00 A5 ``` 内訳: `3B B1`=ターゲットショートアドレス、`04`=コマンド番号、`00`=成功、`01`=ターゲットポート、`04 01`=デバイス概要(プロファイルID 0x0104)、`50 00`=デバイスタイプ(0x0050)、`00`=デバイスバージョン、`04`=入力クラスタ数、`00 00 03 00 07 00 08 FC`=入力クラスタ、`03`=出力クラスタ数、`03 00 06 00 08 00`=出力クラスタ、`A5`=チェックコード。 応答メッセージのデータ解析: ターゲットデバイスのショートアドレスは0xB13B、ポート1はデータ透過伝送、デバイスプロファイルは 0x0104、ZigBee® HAアプリケーションデバイス、デバイスタイプ 0x0050 はデータ送信デバイスです。0x0000、0x0003、0x0007、0xFC08の4つの入力クラスタがあります。最後のクラスタ0xFC08は、デバイスがデータ送信デバイスであることを示します。出力クラスタには0x0003、0x0006、および0x0008があります。0x0006と0x0008は、デバイスがライトの制御命令を出力できることを示します。 **ポート2の照会** 入力コマンド(`02`=ターゲットポート): ``` 55 06 01 04 3B B1 02 8D ``` フィードバックメッセージ(`00`=ステータス、`05`=コマンド番号): ``` 55 05 01 04 00 05 00 ``` 送信確認メッセージ: ``` 55 07 8F 01 3B B1 00 05 01 ``` 応答メッセージ: ``` 55 1D 81 04 3B B1 05 00 02 04 01 01 01 00 06 00 00 03 00 04 00 05 00 06 00 08 00 00 07 ``` 内訳: `3B B1`=ターゲットショートアドレス、`05`=コマンド番号、`00`=成功、`02`=ターゲットポート、`04 01`=デバイス概要、`01 01`=デバイスタイプ(0x0101)、`00`=デバイスバージョン、`06`=入力クラスタ数、`00 00 03 00 04 00 05 00 06 00 08 00`=入力クラスタ、`00`=出力クラスタ数、`07`=チェックコード。 応答メッセージのデータ解析: ターゲットデバイスのショートアドレスは0xB13B、2番ポートはPWM制御、デバイスIDは0x0104でZigBee® HAデバイス、デバイスタイプは0x0101で調光デバイスです。6つの入力クラスタがあり、それぞれ 0x0000、0x0003、0x0004、0x0005、0x0006、0x0008 です。この情報は、このデバイスがPWMをサポートしていることを示します。 > 原文注意: ポート1・ポート2とも、原文HEX例はペイロード長0x1D(29)が示すバイト数と一致しない(注記テキストが埋め込まれているため、上記は注記を除去して復元した並び)。 ### 6.3.4 ノードのポート番号の照会(コマンドコード: 0x05) - **対応デバイス**: MP4(C/R/E)、CP13(C/R/E) - **機能**: ターゲットデバイスがサポートするポート番号を照会します。 **表105 入力コマンドのフォーマット(コマンドパラメータのみ)** | 名前 | NULL | |---|---| | バイト数 | 0 | **表106 応答メッセージのフォーマット(メッセージパラメータのみ)** | 名前 | ポート数 | ポートリスト | |---|---|---| | バイト数 | 1 | N | - **ポート数**: ターゲットデバイスのポートの総数 - **ポートリスト**: ターゲットデバイスのポート番号のリスト **例**: 本Z240-MP4(CT/EA)モジュールを使用して、3つのPWM出力を持つターゲットデバイスを照会する。 入力コマンド(`3B B1`=ターゲットショートアドレス): ``` 55 05 01 05 3B B1 8E ``` フィードバックメッセージ(`00`=ステータス、`06`=コマンド番号): ``` 55 05 01 05 00 06 02 ``` 送信確認メッセージ: ``` 55 07 8F 01 3B B1 00 06 02 ``` 応答メッセージ: ``` 55 0C 81 05 3B B1 06 00 04 01 02 03 04 08 ``` 内訳: `06`=コマンド番号、`00`=成功、`04`=ポート数、`01 02 03 04`=ポートリスト。 データ解析: ターゲットデバイスはPWM出力を備えたデータ伝送モジュールで、データ伝送用に1ポート、PWM制御出力用に3ポートの計4ポートで構成されます。 ### 6.3.5 常時接続バインディングの設定(コマンドコード: 0x21) - **対応デバイス**: MP4(C/R/E)、CP13(C/R/E) - **機能**: ZigBee® バインド方式を使用すると、2つのノード上の各ポートが接続され、バインドされるように設定されます。ノードはMACアドレスとポート番号を通じて互いを記憶し、自身のポートの1つを他のポートに接続することで永続的な接続を確立します。バインディング関係を確立する2つのポートは同じノード上に存在することは可能ですが、2つのポートは制御者と実行者の関係を形成する必要があります。常時接続バインディングでは、相手側のMACアドレスとポート番号を記憶し、自身のポートを使用して相手側をバインドする必要があるため、バインディング管理において仮想SNの概念が追加されます(「5.7.5 仮想デバイスSN番号」を参照)。 **表107 入力コマンドのフォーマット(コマンドパラメータのみ)** | 名前 | 送信元仮想SN | クラスタID | 宛先仮想SN | |---|---|---|---| | バイト数 | 9 | 2 | 9 | - **送信元仮想SN**: 常時接続の送信元デバイスの仮想SN番号。送信元仮想SNは、実際のデバイスに対応している必要がある - **クラスタID**: 常時接続の通信で使用されるクラスタID - **宛先仮想SN**: 宛先デバイスの仮想SN番号、宛先はグループにすることも可能。全て0x00の場合はコーディネータ自身を意味し、この設定により、指定された対象はデータをコーディネータに送信する **表108 応答メッセージのフォーマット(メッセージパラメータのみ)** | 名前 | NULL | |---|---| | バイト数 | 0 | - **メッセージパラメータ**: なし、統一コマンドヘッダの「実行結果」からコマンドの実行結果を判断する 入力コマンド: ``` 55 19 01 21 3D BB 02 B6 CD BC FE FF 7E E0 E8 08 00 02 B1 F1 CD FE FF 7E E0 E8 E4 ``` 内訳: `3D BB`=ターゲットショートアドレス、`02 B6 CD BC FE FF 7E E0 E8`=送信元仮想SN、`08 00`=クラスタID(0x0008)、`02 B1 F1 CD FE FF 7E E0 E8`=宛先仮想SN。 フィードバックメッセージ(`00`=状態、`0C`=コマンド番号): ``` 55 05 01 21 00 0C 2C ``` 送信確認メッセージ: ``` 55 07 8F 01 3D BB 0C 00 04 ``` 応答メッセージ(`0C`=コマンド番号、`00`=ステータス): ``` 55 07 81 21 3D BB 0C 00 2A ``` ### 6.3.6 常時接続バインディングの解除(コマンドコード: 0x22) - **対応デバイス**: MP4(C/R/E)、CP13(C/R/E) - **機能**: 既存の常時接続バインディングを解除します。バインディング解除のためには対象ノードがバインディング情報のレコードを保存している必要があります。 **表109 入力コマンドのフォーマット(コマンドパラメータのみ)** | 名前 | 送信元仮想SN | クラスタID | 宛先仮想SN | |---|---|---|---| | バイト数 | 9 | 2 | 9 | - **送信元仮想SN**: 解除する送信元デバイスの仮想SN番号、常時接続バインディングであるため、対向側のMACアドレスを記憶している必要がある - **クラスタID**: 常時接続通信で使用されるクラスタID - **宛先仮想SN**: 解除する宛先デバイスの仮想SN番号、宛先はグループにすることも可能。全て0x00の場合はコーディネータ自身を意味し、この設定により、指定された対象はデータをコーディネータに送信する **表110 応答メッセージのフォーマット(メッセージパラメータのみ)** | 名前 | NULL | |---|---| | バイト数 | 0 | - **メッセージパラメータ**: なし、統一コマンドヘッダの「実行結果」からコマンドの実行結果を判断する 入力コマンド: ``` 55 19 01 22 3D BB 02 B6 CD BC FE FF 7E E0 E8 08 00 02 B1 F1 CD FE FF 7E E0 E8 E7 ``` フィードバックメッセージ(`0D`=コマンド番号): ``` 55 05 01 22 00 0D 2E ``` 送信確認メッセージ: ``` 55 07 8F 01 3D BB 0D 00 05 ``` 応答メッセージ: ``` 55 07 81 22 3D BB 0D 00 28 ``` ### 6.3.7 常時接続バインディングの照会(コマンドコード: 0x33) - **対応デバイス**: MP4(C/R/E)、CP13(C/R/E) - **機能**: 既存の常時接続バインディングを照会します。すべてのバインディングを1つずつリストにして出力します。 **表111 入力コマンドのフォーマット(コマンドパラメータのみ)** | 名前 | 開始インデックス | |---|---| | バイト数 | 1 | - **開始インデックス**: 常時接続バインディングのレコードの開始番号、複数のレコードが応答に存在することが可能。複数回の照会を実行することで、ノード上のすべての常時接続関係を確認可能 **表112 応答メッセージのフォーマット(メッセージパラメータのみ)** | 名前 | レコード総数 | 開始インデックス | 応答レコード数 | 常時接続バインディングレコード(構造体) | |---|---|---|---|---| | バイト数 | 1 | 1 | 1 | 20*N | 常時接続バインディングレコード(構造体)={送信元仮想SN[9バイト], クラスタID[2バイト], 宛先仮想SN[9バイト]}*N **表113 常時接続バインディングレコードのフォーマット** | 名前 | 送信元仮想SN | クラスタID | 宛先仮想SN | |---|---|---|---| | バイト数 | 9 | 2 | 9 | - **レコード総数**: ノード上で確立されている常時接続バインディングの総数 - **開始インデックス**: 現在返されているレコードの開始番号 - **応答レコード数**: 現在返されているレコードの数 - **送信元仮想SN**: ノード上の送信元ポートへのバインディングを開始する仮想SN番号 - **クラスタID**: バインディングが確立されたクラスタID - **宛先仮想SN**: バインディング先の仮想SN番号、単一デバイスのポートまたはグループを指定可能 入力コマンド(`3D BB`=ターゲットショートアドレス、`00`=開始インデックス): ``` 55 06 01 33 3D BB 00 B4 ``` フィードバックメッセージ(`0A`=コマンド番号): ``` 55 05 01 33 00 0A 38 ``` 送信確認メッセージ: ``` 55 07 8F 01 3D BB 0A 00 02 ``` 応答メッセージ: ``` 55 1E 81 33 3D BB 0A 00 01 00 01 02 B6 CD BC FE FF 7E E0 E8 08 00 02 B1 F1 CD FE FF 7E E0 E8 7C ``` 内訳: `0A`=コマンド番号、`00`=成功、`01`=レコード総数、`00`=開始インデックス、`01`=応答レコード数、続く20バイト=レコード(送信元仮想SN `02 B6 CD BC FE FF 7E E0 E8`、クラスタID `08 00`、宛先仮想SN `02 B1 F1 CD FE FF 7E E0 E8`)。 ### 6.3.8 ネットワークからのデバイス削除(コマンドコード: 0x34) - **対応デバイス**: MP4(C/R/E)、CP13(C/R/E) - **機能**: ネットワークからMACアドレスに基づいて指定されたデバイスを削除します。このコマンドは、コーディネータ、ルータ、エンドデバイスのいずれのノードにおいても実行できますが、削除するノードにコーディネータを指定することはできません。 **注意事項**: 削除対象のノードがエンドデバイスまたはスリープエンドデバイスである場合、該当ノードを削除する際には、その親ノードのショートアドレスを、コマンドヘッダ内の「ショートアドレス」フィールドに指定する必要があります。エンドデバイスの親ノードは動作中に切り替わる場合があるため、その都度取得する必要があります。本ZigBee®互換モジュール(コーディネータを含む)は、エンドデバイスごとの親ノード情報を保持しない仕様であるため、ノードの削除を正しく行うには、外部MCUで親ノード情報を管理・記録しておく必要があります。 **表114 入力コマンドのフォーマット(コマンドパラメータのみ)** | 名前 | MACアドレス | ネットワーク再加入 | 子ノードの消去 | |---|---|---|---| | バイト数 | 8 | 1 | 1 | - **MACアドレス**: 削除するノードのMACアドレス - **ネットワーク再加入**: デフォルトで0x00を入力 - **子ノードの消去**: デフォルトで0x00を入力 **表115 応答メッセージのフォーマット(メッセージパラメータのみ)** | 名前 | NULL | |---|---| | バイト数 | 0 | - **コマンド番号**: システムがコマンドに割り当てる番号 - **実行結果**: 受信したコマンドの実行結果 - **メッセージパラメータ**: なし、統一ヘッダの「実行結果」からコマンドの実行結果を判断する 入力コマンド: ``` 55 0F 01 34 56 F4 30 C5 BC FE FF 7E E0 E8 00 00 A9 ``` 内訳: `56 F4`=ターゲットショートアドレス、`30 C5 BC FE FF 7E E0 E8`=MACアドレス、`00`=ネットワーク再加入、`00`=子ノード消去。 フィードバックメッセージ(`11`=コマンド番号): ``` 55 05 01 34 00 11 24 ``` 送信確認メッセージ: ``` 55 07 8F 01 56 F4 00 11 3D ``` > 原文注意: 原文の送信確認例は「target short address 00 status 11 command number」と注記され、フィールド順がアドレス→コマンド番号→結果と表97(アドレス→送信結果→コマンド番号)で食い違う箇所がある(6.3.5/6.3.6/6.3.7 では「コマンド番号 00 success」の順)。HEXは原文のまま。 応答メッセージ(`11`=コマンド番号、`00`=成功): ``` 55 07 81 34 56 F4 11 00 06 ``` --- ## 6.4 デバイス状態管理とデバイス制御(ZCLコマンド) デバイス状態管理とデバイス制御(ZCLコマンド)とは、本モジュールが属するネットワークのデバイス間で、ZigBee® Cluster Libraryの仕様に基づくZigBee®プロトコル通信を行うためのコマンド群です。 > HEX例について: 原文は各バイト列に注記("port index + send mode" 等)が埋め込まれている。本MDではHEXのみを示し、内訳を `内訳:` 行に記す。色分け凡例(原文): 紫=ペイロード長、赤=コマンドタイプ+コマンドコード、青=チェックコード。ZCLコマンドのコマンドタイプは入力 0x02(TYPE_ZCL_SEND)、非同期応答 0x82(ZCL_IND)、送信確認 0x8F(SEND_CNF、コマンドコード 0x02)。 **統一されたコマンドヘッダフォーマット**: ZCLコマンドは限られた数のコマンドフォーマットを使用して、多様なデバイス内のAttribute(属性)へのアクセスなど、さまざまなデバイスに対しての非常に可変性の高い制御コマンドを組み合わせて実現するよう設計されています。これにはデバイス内の属性へのアクセスやデバイスの制御開始が含まれます。ZCLコマンドには、入力コマンド、フィードバックメッセージ、および2つの非同期メッセージ「送信確認メッセージ」と「ZCL応答メッセージ」が含まれます。デバイスへのアクセスには、ショートアドレス+ポート番号の24ビット仮想アドレスが使用されます。ZCLコマンドは、ユニキャスト、マルチキャスト、ブロードキャストの3つの送信パターンをサポートします。マルチキャストおよびブロードキャストのポートは0xFFです。 **表116 入力コマンドのフォーマット**: コマンドを入力すると、コーディネータからデバイスへのZCL無線コマンドが以下の統一されたヘッダフォーマットで生成されます。 | 名前 | 送信モード | ターゲットショートアドレス | ターゲットポート | フレーム番号 | コマンド方向 | クラスタID | 製造者コード | 応答モード | 拡張データ | |---|---|---|---|---|---|---|---|---|---| | バイト数 | 1 | 2 | 1 | 1 | 1 | 2 | 2 | 1 | 可変長 | > 原文注意: 原文の表116のバイト数行は「1, 2, 1, 1, 1, 2, 2, 1, 可変長」(列数に対し1個ずれて見える)。上記は原文の値を9列+拡張データに割り付けたもの。実例HEX(6.4.2)の長さは「送信モード1+アドレス2+ポート1+フレーム番号1+方向1+クラスタ2+製造者2+応答モード1」で一致する。 - **送信モード**: 下位4ビット(bit[0:3])は送信元ポートインデックス、デフォルトは0。bit6=APS暗号化、bit7=強制送信(ルーティングなし、転送なし) - **ターゲットショートアドレス**: 送信先のショートアドレス、0xFFFC〜0xFFFFはブロードキャスト(0xFFFEは無効なアドレス) - **ターゲットポート**: 送信先のポート番号。0xFFが入力され、ショートアドレスがブロードキャストでない場合はマルチキャストで送信 - **フレーム番号**: 外部MCUが生成したフレーム番号。受信したZCLフレームのフレーム番号とショートアドレスおよびポートが送信フレームと等しい場合、メッセージはターゲットデバイスの応答メッセージとみなす - **コマンド方向**: 0x00=C2S(クライアント→サーバ)、0x01=S2C(サーバ→クライアント) - **クラスタID**: メッセージを送信するクラスタID - **製造者コード**: メッセージを送信する製造者コード。ターゲットデバイスが製造者コードをサポートしている場合のみ有効、デフォルトでは0x0000を入力 - **応答モード**: 0x00=Default Responseで応答、0x01=APS Ackで応答 - **拡張データ**: コマンドごとに異なる拡張データ部分。後のコマンド解析では拡張データ部分を解析対象とする **表117 フィードバックメッセージのフォーマット** | 名前 | 実行ステータス | コマンド番号 | |---|---|---| | バイト数 | 1 | 1 | - **実行ステータス**: 0x00=実行が成功、送信確認メッセージが生成される。その他の値=実行は失敗、「表14 無線送信ステータス」を参照 - **コマンド番号**: システムによって各コマンドに割り当てられる番号、これにより送信確認メッセージやネットワーク管理コマンドの応答時に、ユーザが送信した入力コマンドとの対応関係を追跡できる **表118 送信確認メッセージのフォーマット** | 名前 | 送信モード | ターゲットショートアドレス | ターゲットポート | コマンド番号 | コマンド方向 | 送信結果 | |---|---|---|---|---|---|---| | バイト数 | 1 | 2 | 1 | 1 | 1 | 1 | - **送信モード**: 下位4ビットはポートインデックス、送信時と同じ - **ターゲットショートアドレス**: ターゲットのショートアドレス、送信時と同じ - **ターゲットポート**: ターゲットのポート、送信時と同じ - **コマンド番号**: システムがコマンドに割り当てる番号 - **コマンド方向**: 0x00=クライアント→サーバ、0x01=サーバ→クライアント - **送信結果**: 無線送信結果、「表14 無線送信ステータス」を参照 コーディネータがZCLメッセージを受信すると、次の統一ヘッダフォーマットに変換されます。 **表119 ZCL応答メッセージの受信フォーマット** | 名前 | 受信モード | 送信元ショートアドレス | 送信元ポート | フレーム番号 | コマンド方向 | クラスタID | 製造者コード | 信号強度 | 拡張データ | |---|---|---|---|---|---|---|---|---|---| | バイト数 | 1 | 2 | 1 | 1 | 1 | 2 | 2 | 1 | 可変長 | > 原文注意: 原文の表119バイト数行は「1, 2, 1, 1, 1, 2, 2, 1, 可変長」と記載(表116と同様)。信号強度は実例HEXで1バイト(RSSI)。 - **受信モード**: 下位4ビット(bit[0:3])は受信ポートインデックス。bit4=ブロードキャストまたはグループブロードキャストを受信、bit5=信号強度が有効 - **送信元ショートアドレス**: 送信元デバイスのショートアドレス - **送信元ポート**: 送信元デバイスのポート - **フレーム番号**: 受信したメッセージのフレーム番号。受信したフレーム番号が送信メッセージと一致し、送信元アドレスと送信元ポートも一致する場合、受信メッセージは対応する送信メッセージの応答 - **コマンド方向**: 0x00=クライアント→サーバ、0x01=サーバ→クライアント - **クラスタID**: 受信したメッセージのクラスタID - **製造者コード**: 受信したメッセージの製造者コード、送信元デバイスでサポートされている必要あり - **信号強度**: 受信したメッセージの信号強度 - **拡張データ**: コマンドごとに異なる拡張データ部分。後のコマンド解析では拡張データ部分のみを対象とする ### 6.4.1 ZCLコマンド解析 ZCLコマンド解析では、入力コマンドと受信メッセージの「拡張データ」部分のみを解析します。特定のコマンド間には因果関係があるため、送信と受信の間に因果関係があるコマンドは一律に解析されます。ZCLプロトコルでは、各属性はターゲットデバイスの状態パラメータまたは物理量を表します。関連する状態または物理量は通常、同じクラスタにグループ化されます。属性にアクセスするコマンド(読み取り、書き込み、チェック、レポート)は、同じクラスタ内の複数の属性パラメータを同時に実行できます。 単一のターゲット上に同一属性が複数存在する場合があり、通常は異なるポートに割り当てられます。例としてターゲットデバイスがマルチソケット電源スイッチの場合、各ソケットの開閉ステータスと消費電力には、それぞれ独立したパラメータがあり、同じクラスタIDと属性IDを使用しますが、ターゲットポートが異なります。異なるターゲットポートを設定することにより、対応するターゲットの必要な状態パラメータを取得できます。 **表120 ZCLコマンド解析** | 機能 | コマンドコード | 送信 | 受信 | |---|---|---|---| | デバイスの属性の照会 | 0x00 | ZCL_READ_ATTR_REQ | ZCL_READ_ATTR_RSP | | デバイスの属性の変更 | 0x01 | ZCL_WRTIE_ATTR_REQ | ZCL_WRTIE_ATTR_RSP | | 属性のレポート規則の照会 | 0x02 | ZCL_READ_REPORT_REQ | ZCL_READ_REPORT_RSP | | 属性のレポート規則の設定 | 0x03 | ZCL_WRITE_REPORT_REQ | ZCL_WRITE_REPORT_RSP | | 全ての属性の照会 | 0x04 | ZCL_DISC_ATTR_REQ | ZCL_DISC_ATTR_RSP | | 拡張フィールドを含む全ての属性の照会 | 0x05 | ZCL_DISC_ATTR_EX_REQ | ZCL_DISC_ATTR_EX_RSP | | 属性のアクティブレポートの受信 | 0x0A | なし | ZCL_WRTIE_ATTR_RSP | | デフォルトの応答フレームの受信 | 0x0B | なし | ZCL_DEFAULT_RSP | | 制御コマンドを送信 | 0x0F | ZCL_CMD | なし | | 制御コマンドの受信 | 0x0F | なし | ZCL_CMD_IND | > 原文注意: 識別子 `ZCL_WRTIE_*`(WRITEのスペルミス)は原文のまま。 ### 6.4.2 デバイスの属性の照会(コマンドコード: 0x00) - **対応デバイス**: MP4(C/R/E)、CP13(C/R/E) - **機能**: ZCL属性の状態パラメータを照会します。ポート上の指定されたクラスタから複数の状態パラメータを読み取ることができます。 **表121 入力コマンドのフォーマット(拡張データセクションのみ)** | 名前 | 属性数 | 属性IDリスト | |---|---|---| | バイト数 | 1 | 2*N | - **属性数**: 一度に読み取る属性の数、実際に読み取られる属性数は、この値以下である必要がある - **属性IDリスト**: 属性IDで構成されるuint16配列のリスト **表122 応答メッセージの受信フォーマット(拡張データセクションのみ)** | 名前 | 属性数 | 属性リスト*N: 属性ID | ZCLステータス | データ型 | データ値 | |---|---|---|---|---|---| | バイト数 | 1 | 2 | 1 | 1 | 可変長 | - **属性数**: 読み取られた属性の数。照会コマンドに含まれる一部の属性IDをデバイスがサポートしていない場合、これらの属性は応答メッセージにも含まれない - **属性ID**: 読み取られた属性ID - **ZCLステータス**: 「表16 ZCLステータス」を参照、操作が成功した場合のみ、以下のデータが存在する - **データ型**: 「表15 ZCL属性データ型」を参照 - **データ値**: この属性に対応する状態値、サイズはデータ型の「バイト数」項目によって決定 #### クラスタID 0xFC08 のすべての属性を照会 入力コマンド: ``` 55 19 02 00 00 7B 20 01 A2 00 08 FC 00 20 00 05 00 00 01 00 02 00 03 00 04 00 2F ``` 内訳: `00`=ポートインデックス+送信モード、`7B 20`=ターゲットショートアドレス、`01`=ターゲットポート、`A2`=コマンド(フレーム)番号、`00`=コマンド方向、`08 FC`=クラスタID、`00 20`=製造者コード(原文表記)、`00`=応答モード、`05`=読み取り属性数、`00 00 01 00 02 00 03 00 04 00`=属性IDリスト。 フィードバックメッセージ(`00`=ステータス、`A2`=コマンド番号): ``` 55 05 02 00 00 A2 A0 ``` 送信確認メッセージ(`00`=ポートインデックス+送信モード、`7B 20`=ターゲット、`01`=ポート、`A2`=コマンド番号、`00`=方向、`00`=状態): ``` 55 0A 8F 02 00 7B 20 01 A2 00 00 75 ``` 非同期応答メッセージ: ``` 55 2C 82 00 00 7B 20 01 A2 01 08 FC 00 20 FF 05 00 00 00 23 00 C2 01 00 01 00 00 21 FF FF 02 00 00 20 FF 03 00 00 10 00 04 00 00 30 00 6F ``` 内訳: `00`=ポートインデックス+受信モード、`7B 20`=ターゲット、`01`=ポート、`A2`=コマンド番号、`01`=方向、`08 FC`=クラスタID、`00 20`=製造者コード、`FF`=RSSI、`05`=属性数、以降の属性: | 属性ID | ステータス | データ型 | データ値 | 意味 | |---|---|---|---|---| | 00 00 | 00 | 23 | 00 C2 01 00 | ボーレート | | 01 00 | 00 | 21 | FF FF | ターゲットショートアドレス | | 02 00 | 00 | 20 | FF | ターゲットポート | | 03 00 | 00 | 10 | 00 | モード | | 04 00 | 00 | 30 | 00 | 低消費電力レベル | #### クラスタID 0x0000 のすべての属性を照会 入力コマンド: ``` 55 1F 02 00 00 00 00 01 A1 00 00 00 00 00 00 08 00 00 01 00 02 00 03 00 04 00 05 00 06 00 07 00 AA ``` 内訳: `00`=ポートインデックス+送信モード、`00 00`=ターゲットショートアドレス、`01`=ターゲットポート、`A1`=コマンド番号、`00`=方向、`00 00`=クラスタID、`00 00`=製造者コード、`00`=応答モード、`08`=属性数、`00 00 … 07 00`=属性IDリスト。 > 原文注意: 原文HEXは `00 00 | 01 | A1 | 00 | 00 00 | 00 00 | 00 | 08` の並びで、ペイロード長 0x1F=31 と整合するよう注記を除去して復元(原文では属性リストが `00 00 0100 0200 …` とスペースなし表記)。 フィードバックメッセージ: ``` 55 05 02 00 00 A1 A3 ``` 送信確認メッセージ: ``` 55 0A 8F 02 00 00 00 01 A1 00 00 2D ``` 非同期応答メッセージ: ``` 55 5F 82 00 00 00 00 01 A1 01 00 00 00 00 FF 08 00 00 00 20 01 01 00 00 20 10 02 00 00 20 16 03 00 00 20 01 04 00 00 42 10 77 77 77 2E 45 62 79 74 65 2E 63 6F 6D 20 20 20 05 00 00 42 10 46 57 43 4F 44 45 3D 37 34 30 36 2D 30 2D 31 30 06 00 00 42 08 32 30 32 32 30 35 31 33 07 00 00 30 01 C0 ``` (上記は読みやすさのため改行したもの。実際は連続したバイト列で、末尾 `C0` がチェックコード) | 属性ID | ステータス | データ型 | データ値 | 意味 | |---|---|---|---|---| | 00 00 | 00 | 20 | 01 | ZigBee version | | 01 00 | 00 | 20 | 10 | software version | | 02 00 | 00 | 20 | 16 | protocol version | | 03 00 | 00 | 20 | 01 | hardware version | | 04 00 | 00 | 42 | 長さ10 + `77 77 77 2E 45 62 79 74 65 2E 63 6F 6D 20 20 20` | 製造者名 (vendor name) | | 05 00 | 00 | 42 | 長さ10 + `46 57 43 4F 44 45 3D 37 34 30 36 2D 30 2D 31 30` | 製品モデル (product model) | | 06 00 | 00 | 42 | 長さ08 + `32 30 32 32 30 35 31 33` | 作成日 (compilation date) | | 07 00 | 00 | 30 | 01 | 電源方式 (power supply mode) | 文字列の解釈(原文): - 製造者名: `10`(データ長) `77 77 77 2E 45 62 79 74 65 2E 63 6F 6D 20 20 20` → ASCII `www.Ebyte.com` - 製品モデル: `10`(データ長) `46 57 43 4F 44 45 3D 37 34 30 36 2D 30 2D 31 30` → ASCII `FWCODE=7406-0-10` - 作成日: `08`(データ長) `32 30 32 32 30 34 32 34` → ASCII `20220513` > 原文注意: 作成日の例HEXは `32 30 32 32 30 34 32 34`("20220424")だが、ASCII変換結果は「20220513」と記載(応答メッセージ側は `32 30 32 32 30 35 31 33`=20220513)。 **備考** - ターゲットのショートアドレスが FD FF ブロードキャストモードで読み取られると、コーディネータを除くネットワーク内のすべてのデバイスがフィードバックを返します。ブロードキャストモードを使用してデバイス情報を照会および変更することはお勧めできません。 - 複数の属性をリモートで一度に読み取る場合、入力コマンドのポートインデックス+送信モードに「0x40」を使用してコマンドを送信する必要があります。そうでない場合、読み取りコマンドの送信は失敗します。 - クラスタID 0x0000 の属性は、エンドデバイスによる自身の属性の読み取りをサポートしていませんが、エンドデバイスは他のノードの属性を読み取ることができます。 - ポートインデックス+送信モード: データ通信にZCLコマンドを使用する場合、ユーザはポートインデックス+送信モードに0x40 を使用して送信する必要があります。 ### 6.4.3 デバイスの属性の変更(コマンドコード: 0x01) - **対応デバイス**: MP4(C/R/E)、CP13(C/R/E) - **機能**: ZCL属性の状態パラメータを変更します。一度に複数の属性を変更できますが、属性がターゲットデバイスに存在し書き込み可能である必要があり、データ型がターゲットデバイスのデータ型と同じである必要があります。変更が無効な場合、応答メッセージにて無効な属性が示されます。 **表123 入力コマンドのフォーマット(拡張データセクションのみ)** | 名前 | 属性数 | 属性リスト*N: 属性ID | データ型 | データ値 | |---|---|---|---|---| | バイト数 | 1 | 2 | 1 | 可変長 | - **属性数**: 変更する属性の数 - **属性ID**: 変更する属性ID - **データ型**: 「表15 ZCL属性データ型」を参照 - **データ値**: この属性に対応する状態値、サイズはデータ型の「バイト数」項目によって決定 **表124 応答メッセージの受信フォーマット(拡張データセクションのみ)** | 名前 | エラー数 | 属性リスト*N: 属性ID | ZCLステータス | |---|---|---|---| | バイト数 | 1 | 2 | 1 | - **エラー数**: 変更が無効だった属性の数、値が0の場合はすべて問題なし - **属性ID**: 変更する属性ID - **ZCLステータス**: エラーの原因は「表16 ZCLステータス」を参照 > 以下の例のフィードバックメッセージ・送信確認メッセージは、特記なき限り先頭の例と同じ構造(内訳は6.4.2参照)。 #### クラスタID 0xFC08 のターゲットデバイスのボーレートを変更 入力コマンド: ``` 55 16 02 01 00 78 B8 01 A2 00 08 FC 00 20 00 01 00 00 23 80 25 00 00 33 ``` 内訳: `00`=ポートインデックス+送信モード、`78 B8`=ターゲット、`01`=ポート、`A2`=コマンド番号、`00`=方向、`08 FC`=クラスタID、`00 20`=製造者コード、`00`=応答モード、`01`=属性数、`00 00`=属性ID、`23`=データ型、`80 25 00 00`=ボーレート(0x2580=9600)。 フィードバックメッセージ: ``` 55 05 02 01 00 A2 A1 ``` 送信確認メッセージ: ``` 55 0A 8F 02 00 78 B8 01 A2 00 00 EE ``` 非同期応答メッセージ: ``` 55 12 82 01 00 78 B8 01 A2 01 08 FC 00 20 FF 01 00 00 88 43 ``` 内訳: `FF`=RSSI、`01`=エラー数(属性数)、`00 00`=属性ID、`88`=ステータス(read only)。 > 注: デバイスのボーレートを変更するには、制御コマンド送信を使用して変更する必要があります。 #### クラスタID 0xFC08 のターゲットショートアドレスを変更 入力コマンド(属性ID `01 00`、データ型 `21`、値 `FD FF`): ``` 55 14 02 01 00 78 B8 01 A2 00 08 FC 00 20 00 01 01 00 21 FD FF 97 ``` フィードバックメッセージ: ``` 55 05 02 01 00 A2 A1 ``` 送信確認メッセージ: ``` 55 0A 8F 02 00 78 B8 01 A2 00 00 EE ``` 非同期応答メッセージ(`00`=エラー数、すべて成功): ``` 55 0F 82 01 00 78 B8 01 A2 01 08 FC 00 20 FF 00 CA ``` #### クラスタID 0xFC08 のターゲットポートを変更 入力コマンド(属性ID `02 00`、データ型 `20`、値 `11`): ``` 55 13 02 01 00 78 B8 01 A2 00 08 FC 00 20 00 01 02 00 20 11 86 ``` フィードバックメッセージ: ``` 55 05 02 01 00 A2 A1 ``` 送信確認メッセージ: ``` 55 0A 8F 02 00 78 B8 01 A2 00 00 EE ``` 非同期応答メッセージ: ``` 55 0F 82 01 00 78 B8 01 A2 01 08 FC 00 20 FF 00 CA ``` #### クラスタID 0xFC08 のシリアルポートモードを変更 入力コマンド(属性ID `03 00`、データ型 `10`、値 `01`): ``` 55 13 02 01 00 78 B8 01 A2 00 08 FC 00 20 00 01 03 00 10 01 A7 ``` フィードバックメッセージ: ``` 55 05 02 01 00 A2 A1 ``` 送信確認メッセージ: ``` 55 0A 8F 02 00 78 B8 01 A2 00 00 EE ``` 非同期応答メッセージ: ``` 55 0F 82 01 00 78 B8 01 A2 01 08 FC 00 20 FF 00 CA ``` #### クラスタID 0xFC08 の低消費電力レベルを変更 入力コマンド(属性ID `04 00`、データ型 `30`、値 `01`): ``` 55 13 02 01 00 2B DC 01 A2 00 08 FC 00 20 00 01 04 00 30 01 B7 ``` フィードバックメッセージ: ``` 55 05 02 01 00 A2 A1 ``` 送信確認メッセージ(ターゲット `2B DC`): ``` 55 0A 8F 02 00 2B DC 01 A2 00 00 D9 ``` 非同期応答メッセージ: ``` 55 12 82 01 00 2B DC 01 A2 01 08 FC 00 20 FF 01 04 00 88 70 ``` > 原文注意: 原文の低消費電力レベル変更の非同期応答は「A2 command number 08 FC cluster ID」と方向バイトの注記が欠落(実バイト列は方向 `01` を含む形に復元)。 > 注: 機器の低消費電力レベルは、制御コマンド送信を使用して変更する必要があります。 ### 6.4.4 属性のレポート規則の照会(コマンドコード: 0x02) - **対応デバイス**: CP13(C/R/E) - **機能**: 属性の自動レポート規則を照会します。照会される属性がアクティブレポートをサポートしている必要があります。アクティブレポートをサポートする属性の場合、照会時にZCLステータス成功を返し、かつ有効なレポート規則のパラメータが含まれます。アクティブレポートをサポートする属性については、自動レポートを開始するには、属性が存在するポートと属性のクラスタを受信ノードにバインドする必要があります(6.3.5項 ノードの常時接続バインディングの設定(コマンドコード: 0x21)を参照)。 **表125 入力コマンドのフォーマット(拡張データセクションのみ)** | 名前 | 属性数 | 属性リスト | |---|---|---| | バイト数 | 1 | 2 * N | - **属性数**: 照会する属性の数 - **属性リスト**: 照会する属性IDリスト **表126 応答メッセージの受信フォーマット(拡張データセクションのみ)** | 名前 | 属性数 | 属性ID | ZCLステータス | 最小時間 | 最大時間 | データ型 | 変化量 | |---|---|---|---|---|---|---|---| | バイト数 | 1 | 2 | 1 | 2 | 2 | 1 | 可変長(アライメント済み) | > 属性ID以降は「属性の照会で返る構造体リスト[N]」。原文のバイト数行は「1, 2, 1, 2, 2, 1, 可変長(アライメント済み)」。 - **属性数**: 照会によって返された属性数 - **属性ID**: 返された属性ID - **ZCLステータス**: 「表16 ZCLステータス」を参照、操作が成功した場合のみ、以下のデータが存在する - **最小時間**: この属性の定常的なレポートの最小間隔、単位は秒、属性値の連続的な変動による過剰なレポートを抑制するために使用可能 - **最大時間**: この属性がレポートされる最大間隔、単位は秒、ハートビート周期として使用可能 - **データ型**: 変数値のデータ型、「表15 ZCL属性データ型」を参照 - **変化量**: 属性レポートが発生する変化量、この値を超える属性値の変更があった場合にレポートを送信する。この値は「表15 ZCL属性データ型」の「レポートアライメント」のサイズに従って4バイト単位でデータを整列することが必要 入力コマンド: ``` 55 13 02 02 00 49 8E 01 A1 00 08 FC 00 20 00 02 00 00 03 00 B2 ``` 内訳: `49 8E`=ターゲット、`01`=ポート、`A1`=コマンド番号、`08 FC`=クラスタID、`02`=属性数、`00 00 03 00`=属性IDリスト。 フィードバックメッセージ: ``` 55 05 02 02 00 A1 A1 ``` 送信確認メッセージ: ``` 55 0A 8F 02 00 49 8E 01 A1 00 00 EA ``` 非同期応答メッセージ: ``` 55 23 82 02 00 49 8E 01 A1 01 08 FC 00 20 E7 02 00 00 00 0A 00 B4 00 23 01 00 00 00 03 00 00 0A 00 B4 00 10 82 ``` 内訳: `E7`=RSSI、`02`=属性数、属性1: `00 00`=ID、`00`=成功、`0A 00`=最小時間(10秒)、`B4 00`=最大時間(180秒)、`23`=データ型、`01 00 00 00`=変化量(4バイトアライメント)。属性2: `03 00`=ID、`00`=成功、`0A 00`=最小時間、`B4 00`=最大時間、`10`=データ型(変化量なし)、`82`=チェックコード。 ### 6.4.5 属性のレポート規則の設定(コマンドコード: 0x03) - **対応デバイス**: CP13(C/R/E) - **機能**: 属性の自動レポート規則を変更します。属性の自動レポート周期と、レポートを発生する属性値の変化量を変更できます。「表15 ZCL属性データ型」の「レポートアライメント」項目において、属性タイプに対応する「レポートアライメント」が0の場合、レポート期間の変更のみがサポートされ、属性値の変化の変更はサポートされません。 **表127 入力コマンドのフォーマット(拡張データセクションのみ)** | 名前 | 属性数 | 属性ID | 最小時間 | 最大時間 | データ型 | 変化量 | |---|---|---|---|---|---|---| | バイト数 | 1 | 2 | 2 | 2 | 1 | 可変長(アライメント済み) | > 属性ID以降は「設定する属性レポートの構造体リスト[N]」。原文のバイト数行は「1, 2, 2, 2, 1, 可変長(アライメント済み)」。 - **属性数**: 設定する属性の数 - **属性ID**: 設定する属性ID - **最小時間**: この属性の定常的なレポートの最小間隔、単位は秒、属性値の連続的な変動による過剰なレポートを抑制するために使用可能 - **最大時間**: この属性がレポートされる最大間隔、単位は秒、ハートビート周期として使用可能 - **データ型**: 変数値のデータ型、「表15 ZCL属性データ型」を参照 - **変化量**: 属性レポートが発生する変化量、この値を超える属性値の変更があった場合にレポートを送信する。この値は「表15 ZCL属性データ型」の「レポートアライメント」のサイズに従って4バイト単位でデータを整列することが必要、レポートアライメントが0の場合は不要 **表128 応答メッセージの受信フォーマット(拡張データセクションのみ)** | 名前 | エラー数 | 属性ID | ZCLステータス | |---|---|---|---| | バイト数 | 1 | 2 | 1 | > 属性ID以降は「設定する属性レポートの構造リスト[N]」。 - **エラー数**: 設定が無効となった属性の数。※すべての属性の設定が有効の場合、この値は1 - **属性ID**: 設定が無効となった属性ID。※すべての属性の設定が有効の場合、0xFFFF - **ZCLステータス**: エラーの原因、「表16 ZCLステータス」を参照 入力コマンド: ``` 55 21 02 03 00 49 8E 01 A2 00 08 FC 00 20 00 02 00 00 0A 00 B4 00 23 01 00 00 00 03 00 0A 00 B4 00 10 82 ``` 内訳: 属性1: `00 00`=ID、`0A 00`=最小時間、`B4 00`=最大時間、`23`=データ型、`01 00 00 00`=変化量。属性2: `03 00`=ID、`0A 00`=最小時間、`B4 00`=最大時間、`10`=データ型。 > 原文注意: 原文HEXの末尾は `10 82`(`82`=チェックコード)。ペイロード長 0x21 と整合する並びに復元。 フィードバックメッセージ: ``` 55 05 02 03 00 A2 A3 ``` 送信確認メッセージ: ``` 55 0A 8F 02 00 49 8E 01 A2 00 00 E9 ``` 非同期応答メッセージ: ``` 55 12 82 03 00 49 8E 01 A2 01 08 FC 00 20 E5 01 FF FF 00 D4 ``` 内訳: `E5`=RSSI、`01`=エラー数、`FF FF`=属性ID(全て有効)、`00`=ステータス(成功)。 ### 6.4.6 全ての属性の照会(コマンドコード: 0x04) - **対応デバイス**: CP13(C/R/E) - **機能**: 対象デバイスでサポートされているすべての属性を照会します。属性数の指定によって、複数回のコマンドで照会が可能です。 **表129 入力コマンドのフォーマット(拡張データセクションのみ)** | 名前 | 属性数 | 開始属性ID | |---|---|---| | バイト数 | 1 | 2 | - **属性数**: 照会する属性の数 - **開始属性ID**: 照会を開始する属性ID **表130 応答メッセージの受信フォーマット(拡張データセクションのみ)** | 名前 | エラー数(原文表記) | 属性ID | データ型 | |---|---|---|---| | バイト数 | 1 | 2 | 1 | > 属性ID・データ型は「照会した属性の構造体リスト[N]」。原文の先頭列名は「エラー数」だが、説明は「属性数」(この照会で返された属性の数)。 - **属性数**: この照会で返された属性の数 - **属性ID**: この照会で返された属性ID - **データ型**: 属性IDに対応するデータ型 入力コマンド: ``` 55 11 02 04 00 9B 9C 01 A0 00 08 FC 00 20 00 03 02 00 74 ``` 内訳: `9B 9C`=ターゲット、`01`=ポート、`A0`=コマンド番号、`08 FC`=クラスタID、`03`=属性数、`02 00`=開始属性ID。 フィードバックメッセージ: ``` 55 05 02 04 00 A1 A7 ``` 送信確認メッセージ: ``` 55 0A 8F 02 00 9B 9C 01 A1 00 00 2A ``` 非同期応答メッセージ: ``` 55 18 82 04 00 9B 9C 01 A1 01 08 FC 00 20 D1 03 02 00 20 03 00 10 04 00 30 23 ``` 内訳: `D1`=RSSI、`03`=属性数、`02 00`+`20`、`03 00`+`10`、`04 00`+`30`=(属性ID+データ型)×3。 > 原文注意: 入力コマンドのコマンド番号は `A0`、フィードバック・送信確認・応答では `A1` と記載(原文のまま)。 ### 6.4.7 拡張フィールドを含む全ての属性の照会(コマンドコード: 0x05) - **対応デバイス**: CP13(C/R/E) - **機能**: 対象デバイスでサポートされているすべての属性を確認し、各属性が読み込み、書き込み可能かどうか、およびアクティブレポートをサポートしているかどうかを含む照会結果を返します。 **表131 入力コマンドのフォーマット(拡張データセクションのみ)** | 名前 | 属性数 | 開始属性ID | |---|---|---| | バイト数 | 1 | 2 | - **属性数**: 照会する属性の数 - **開始属性ID**: 照会を開始する属性ID **表132 応答メッセージの受信フォーマット(拡張データセクションのみ)** | 名前 | 属性数 | 属性ID | データ型 | サポート操作 | |---|---|---|---|---| | バイト数 | 1 | 2 | 1 | 1 | > 属性ID・データ型・サポート操作は「照会した属性の構造体リスト[N]」。 - **属性数**: この照会で返された属性の数 - **属性ID**: この照会で返された属性ID - **データ型**: 属性IDに対応するデータ型 - **サポート操作**: bit0=読み取り可能、bit1=書き込み可能、bit2=アクティブレポートをサポート 入力コマンド: ``` 55 11 02 05 00 9B 9C 01 A0 00 08 FC 00 20 00 03 02 00 74 ``` 内訳: `9B 9C`=ターゲット、`01`=ポート、`A0`=コマンド番号、`08 FC`=クラスタID、`00 20`=製造者コード、`03`=属性数、`02 00`=開始属性ID。 フィードバックメッセージ: ``` 55 05 02 05 00 A1 A6 ``` 送信確認メッセージ: ``` 55 0A 8F 02 00 9B 9C 01 A1 00 00 2A ``` 非同期応答メッセージ: ``` 55 18 82 05 00 9B 9C 01 A1 01 08 FC 00 20 D7 03 02 00 20 03 03 00 10 07 04 00 30 05 25 ``` 内訳: `D7`=RSSI、`03`=属性数、`02 00`+`20`+`03`(ID 0x0002、uint8、読み書き=bit0|bit1)、`03 00`+`10`+`07`(ID 0x0003、bool、読み・書き・レポート)、`04 00`+`30`+`05`(ID 0x0004、enum8、読み取り+レポート)。 ### 6.4.8 属性のアクティブレポートの受信(コマンドコード: 0x0A) - **対応デバイス**: MP4(C)、CP13(C) - **機能**: デバイスは、属性値が設定された値を超えた場合、または最大通知周期に達した場合に、自動的に属性情報をレポートします。 **表133 非同期フィードバックメッセージ(拡張データセクションのみ)** | 名前 | 属性数 | 属性ID | データ型 | データ値 | |---|---|---|---|---| | バイト数 | 1 | 2 | 1 | 可変長 | > 属性ID以降は「通知属性データリスト[N]」。 - **属性数**: 受信および通知された属性の数。デバイスが読み取りコマンドに含まれる一部の属性IDをサポートしている場合、返されるコマンドにはこれらの属性は含まれない - **属性ID**: 通知された属性ID、リトルエンディアン表記の16ビット - **データ型**: 「表15 ZCL属性データ型」を参照 - **データ値**: この属性に対応する状態値、サイズはデータ型の「バイト数」項目によって決定 非同期フィードバックメッセージ: ``` 55 17 82 0A 00 F9 D0 01 02 01 08 FC 00 20 CE 02 03 00 10 00 04 00 20 00 8C ``` 内訳: `00`=受信モード、`F9 D0`=送信元ショートアドレス、`01`=送信元ポート、`02`=フレーム番号、`01`=コマンド方向、`08 FC`=クラスタID、`00 20`=製造者コード、`CE`=RSSI、`02`=属性数、`03 00`+`10`+`00`(ID 0x0003、bool、値0)、`04 00`+`20`+`00`(ID 0x0004、uint8、値0)。 ### 6.4.9 デフォルトの応答フレームの受信(コマンドコード: 0x0B) - **対応デバイス**: MP4(C/R/E)、CP13(C/R/E) - **機能**: ターゲットデバイスから返されるデフォルトの応答フレームです。これは、ターゲットデバイスが該当コマンドに対応していない場合、またはデフォルトリクエストを有効にした応答モードで送信した場合に、この応答フレームが返されます。この応答フレームには、送信時のコマンドと対応付けを行うためのフレーム番号が含まれており、このフレーム番号によって、どの入力コマンドに対する応答かを特定することができます。 **表134 非同期フィードバックメッセージ(拡張データセクションのみ)** | 名前 | コマンドID | ZCLステータス | |---|---|---| | バイト数 | 1 | 1 | - **コマンドID**: 対応するコマンドIDを応答、この値は「制御コマンド」に対してのみ意味を持ち、属性ステータスに関する他のコマンドに対しては意味を持たない。属性ステータスのコマンドは「フレーム番号」を通じて追跡される - **ZCLステータス**: 「表16 ZCLステータス」を参照 非同期フィードバックメッセージ: ``` 55 10 82 0B 00 F9 D0 01 0A 01 08 FC 00 20 CE 0E 83 34 ``` 内訳: `00`=受信モード、`F9 D0`=送信元ショートアドレス、`01`=送信元ポート、`0A`=フレーム番号、`01`=方向、`08 FC`=クラスタID、`00 20`=製造者コード、`CE`=RSSI、`0E`=コマンドID、`83`=ZCLステータス(not supported)。 ### 6.4.10 制御コマンドの送信と受信(コマンドコード: 0x0F) - **対応デバイス**: MP4(C/R/E)、CP13(C/R/E) - **機能**: デバイス制御コマンドを送信するとき、各コマンドは可変長のコマンドパラメータを含むことができます。コマンドパラメータは、属性の状態ステータスと比べてより複雑であり、複数の変数、配列、またはデータストリームにすることができます。間違った制御コマンドを間違ったデバイスに送信するか、入力コマンドの「応答モード」を0に設定して送信すると、デフォルトの応答フレームが受信されます。デフォルト応答フレームのコマンドIDとフレーム番号を使用することで、送信された制御コマンドに対応するかどうかを検出できます。 **表135 制御コマンド送信時の入力フォーマット(拡張データセクションのみ)** | 名前 | コマンドID | コマンドパラメータ | |---|---|---| | バイト数 | 1 | 可変長 | - **コマンドID**: 制御コマンドのコマンドID - **コマンドパラメータ**: 制御コマンドに含まれるパラメータ。コマンドパラメータの内容はクラスタ、コマンドID、および製造者コードによって決定 **表136 制御コマンド受信時のメッセージのフォーマット(拡張データセクションのみ)** | 名前 | コマンドID | メッセージパラメータ | |---|---|---| | バイト数 | 1 | 可変長 | - **コマンドID**: 受信した制御コマンドのコマンドID - **メッセージパラメータ**: 受信した制御コマンドに含まれるパラメータ。メッセージパラメータの内容は、クラスタ、コマンドID、および製造コードによって決定 #### 制御コマンドを送信してボーレートを変更 入力コマンド: ``` 55 13 02 0F 00 CB A6 01 AB 00 08 FC 00 20 00 02 80 25 00 00 B9 ``` 内訳: `00`=ポートインデックス+送信モード、`CB A6`=ターゲット、`01`=ポート、`AB`=コマンド番号、`00`=方向、`08 FC`=クラスタID、`00 20`=製造者コード、`00`=応答モード、`02`=コマンドID(Set Baud)、`80 25 00 00`=ボーレート(9600)。 フィードバックメッセージ: ``` 55 05 02 05 00 A1 A6 ``` 送信確認メッセージ: ``` 55 0A 8F 02 00 CB A6 01 AB 00 00 4A ``` 非同期応答メッセージ: ``` 55 14 82 0F 20 CB A6 01 AB 01 08 FC 00 20 FC 02 00 80 25 00 00 E4 ``` 内訳: `20`=受信モード(bit5: 信号強度有効)、`FC`=RSSI、`02`=コマンドID、`00`=成功、`80 25 00 00`=ボーレート。 > 原文注意: 原文のフィードバックメッセージは `55 05 02 05 00 A1 A6`(コマンドコード 0x05、コマンド番号 A1)と記載され、入力のコマンドコード0x0F・コマンド番号ABと一致しない。原文のまま記載。 #### 制御コマンドを送信して低消費電力レベルを変更 入力コマンド: ``` 55 10 02 0F 00 2B DC 01 AA 00 08 FC 00 20 00 03 03 85 ``` 内訳: `2B DC`=ターゲット、`AA`=コマンド番号、`03`=コマンドID(Set LP_Level)、`03`=低消費電力レベル。 フィードバックメッセージ: ``` 55 05 02 0F 00 AB A7 ``` 送信確認メッセージ: ``` 55 0A 8F 02 00 2B DC 01 AA 00 00 D1 ``` 非同期応答メッセージ: ``` 55 10 82 0F 00 2B DC 01 AA 00 08 FC 00 20 FC 03 00 DB ``` > **注**: ボーレートをリモートで変更することは非推奨です(変更が成功しないと問題が発生する可能性があります)。リモートで低消費電力レベルを3に設定すると、遠隔からは操作できなくなります。 > 原文注意: 原文の低消費電力レベル非同期応答の注記は「command number 00 command direction」と方向バイトのみ(フレーム番号が欠落)。上記は注記を除去して並べたもの。 #### 制御命令を送信してデバイスをマーク 入力コマンド: ``` 55 11 02 0F 00 FD FF FF A1 00 03 00 00 00 00 00 00 53 ``` 内訳: `00`=ポートインデックス+送信モード、`FD FF`=ターゲットショートアドレス(ネットワーク上の全デバイスをマーク)、`FF`=ターゲットポート、`A1`=コマンド番号、`00`=方向、`03 00`=クラスタID(IDENTIFY)、`00 00`=製造者コード、`00`=応答モード、`00`=コマンドID(Identify)、`00 00`=マーキング時間。 フィードバックメッセージ: ``` 55 05 02 0F 00 A1 AC ``` 送信確認メッセージ: ``` 55 0A 8F 02 00 FD FF FF A1 00 00 D1 ``` > **注**: IDENTIFYクラスタは、デバイスをマークするために使用されます。デバイスがマークされた状態にある場合、RUN_LEDが点滅し、他のZigBee®デバイスによって検出され、常時接続を確立することもできます。 #### データ送信(透過伝送) 入力コマンド: ``` 55 12 02 0F 00 00 00 01 02 00 08 FC 00 20 00 00 31 32 33 EA ``` 内訳: `00`=ポートインデックス+送信モード、`00 00`=ターゲットショートアドレス(コーディネータ)、`01`=ターゲットポート、`02`=コマンド番号、`00`=方向、`08 FC`=クラスタID、`00 20`=製造者コード、`00`=応答モード、`00`=コマンドID(Uart Send)、`31 32 33`=ペイロード(ASCII "123")。 フィードバックメッセージ: ``` 55 05 02 0F 00 02 0F ``` 送信確認メッセージ: ``` 55 0A 8F 02 00 00 00 01 02 00 00 8E ``` 非同期応答メッセージ: ``` 55 10 82 0B 00 00 00 01 02 01 08 FC 00 20 FF 00 00 A0 ``` 内訳: `00`=受信モード、`00 00`=送信元ショートアドレス、`01`=送信元ポート、`02`=フレーム番号、`01`=方向、`08 FC`=クラスタID、`00 20`=製造者コード、`FF`=RSSI、`00`=コマンドID、`00`=成功。 > 原文注意: 原文の応答例はコマンドコードが `0B`(デフォルト応答)、ペイロード長が 0x10 と記載。注記テキストを除去した並びで復元。 ### 6.4.11 ZCLの属性と制御コマンド #### 6.4.11.1 クラスタ=0x0000 **機能**: このクラスタはデバイスの工場出荷時の情報を定義し、ほぼすべてのデバイスがこのクラスタ(BASICクラスタ)をサポートする必要があります。 **表137 属性リスト**(クラスタ=0x0000、サーバ) | 属性ID | ディスクリプタ | 名前 | データ型 | 操作 | |---|---|---|---|---| | 0x0000 | ZCL Version | ZigBee®エディション | uint8 | 読み取り専用 | | 0x0001 | Application Version | ソフトウェアリリース | uint8 | 読み取り専用 | | 0x0002 | Stack Version | プロトコルのバージョン | uint8 | 読み取り専用 | | 0x0003 | Hardware Version | ハードウェアバージョン | uint8 | 読み取り専用 | | 0x0004 | Manufacturer Name | 製造者名 | string | 読み取り専用 | | 0x0005 | Model Identifier | 製品モデル | string | 読み取り専用 | | 0x0006 | Date Code | 編集日 | string | 読み取り専用 | | 0x0007 | Power Source | 電源モード | enum8 | 読み取り専用 | #### 6.4.11.2 クラスタ=0x0003 **機能**: デバイスを識別するために使用されます。マークされた状態では、デバイスは人間によって検出することができます。また、他のZigBee®デバイスによっても検出され、常時接続を確立することができます(IDENTIFYクラスタ)。 **表138 属性リスト**(クラスタ=0x0003、サーバ) | 属性ID | ディスクリプタ | 名前 | データ型 | 操作 | |---|---|---|---|---| | 0x0000 | Identify Time | マーキング時間 | uint16 | 読み書き可能 | **表139 制御コマンドの送信**(クラスタ=0x0003、クライアント→サーバ) | コマンドID | ディスクリプタ | 名前 | パラメータ | |---|---|---|---| | 0x00 | Identify | デバイスのマーキング | uint16 Identify Time:マーキング時間 | **表140 制御コマンドの受信**(クラスタ=0x0003、サーバ→クライアント) | コマンドID | ディスクリプタ | 名前 | パラメータ | |---|---|---|---| | 0x00 | Identify Query response | デバイスのマーキング結果の応答 | uint16 timeout:残りマーキング時間 | #### 6.4.11.3 クラスタ=0xFC08 **機能**: 透過伝送機能の専用クラスタです。 **表141 属性リスト**(クラスタ=0xFC08、製造者コード=0x2000、サーバ) | 属性ID | ディスクリプタ | 名前 | データ型 | 操作 | |---|---|---|---|---| | 0x0000 | Baud | ボーレート | uint32 | 読み取り専用 | | 0x0001 | target Addr | デフォルトのターゲットショートアドレス | uint16 | 読み書き可能 | | 0x0002 | target EP | デフォルトの宛先ポート | uint8 | 読み書き可能 | | 0x0003 | send Mode | ハードウェアバージョン(原文表記。実際はシリアルポートモード) | bool | 読み書き可能 | | 0x0004 | LP Level | 低消費電力モード | enum8 | 読み取り専用 | ボーレートは 9600、19200、38400、57600、115200 をサポート。 - **シリアルポートモード**: 0=HEXコマンドモード、1=透過伝送モード - **低消費電力モード**: - 0=1秒サイクルでウェイクアップ - 1=3.3秒サイクルでウェイクアップ - 2=5秒サイクルでウェイクアップ - 3=常にスリープ **表142 制御コマンドの送信**(クラスタ=0xFC08、製造者コード=0x2000、クライアント→サーバ) | コマンドID | ディスクリプタ | 名前 | パラメータ | |---|---|---|---| | 0x00 | Uart Send | 透過伝送のデータ送信 | uint8 data[]:送信データ | | 0x01 | Set Dst Addr | デフォルトターゲットの設定 | uint16 dstAddr:ターゲットショートアドレス / uint8 endpoint:ターゲットポート | | 0x02 | Set Baud | ボーレートを設定 | uint32 baud:新しいボーレートを設定、再起動後に有効になる | | 0x03 | Set LP_Level | 低消費電力モードを設定 | uint8 LP_level:低消費電力レベル | ボーレートおよび低消費電力モードは正しい値を設定する必要があるため、属性を直接変更することはできません。 **表143 制御コマンドの受信**(クラスタ=0xFC08、製造者コード=0x2000、サーバ→クライアント) | コマンドID | ディスクリプタ | 名前 | パラメータ | |---|---|---|---| | 0x00 | Uart Notify | 透過伝送のデータ受信 | uint8 data[]:受信データ | | 0x01 | Set Dst Addr Rsp | デフォルトターゲット設定の結果 | uint8 status:ZCLステータス | | 0x02 | Set Baud Rsp | ボーレート設定の結果 | uint8 status:ZCLステータス | | 0x03 | Set LP_Level Rsp | 低電力レベル設定の結果 | uint8 status:ZCLステータス | --- # 7 製品の問い合わせ・サポート **本製品の、営業・技術サポートに関するお問い合わせ** CLEALINK TECHNOLOGY CO., LTD. IoT製品取り扱い・サポート専用サイト「DRAGON TORCH」 - 製品情報サイト: https://dragon-torch.tech/ - 製品サポート: https://support.dragon-torch.tech/ (原文には各サイトのQRコード等の図が2点あり) 技術的なサポートについて、そのすべての対応を保証するものではありません。本ドキュメント記載の内容の範囲を大きく超える内容、もしくは、当社、関係各社の機密などに関する内容、科学的なエビデンスや論拠の乏しい偶発的な内容などについては、回答できない場合もあります。また、暗号処理を含む、当社等の技術的開示を秘匿としている内容などにつきましては、お問い合わせいただいた場合でも回答は控えさせていただきます。 **製品開発元** https://clealink.jp/ 〒619-0237 京都府相楽郡精華町光台1-7 けいはんなプラザ ラボ棟7F 株式会社クレアリンクテクノロジー IoTコンポーネント担当 CLEALINK TECHNOLOGY CO., LTD. IoT components team Keihanna Plaza Labo-wing 7F, 1-7, Hikari-dai, Seika-cho, Souraku-gun, Kyoto, Japan, 6190237 --- # 8 製品の製造について ## 8.1 品質・ISO認証 本製品は、Chengdu Ebyte Electronic Technology Co., LTD.(EBYTE社)、ISO認定工場にて製造されたものです。認証に関わる情報が必要な場合は、株式会社クレアリンクテクノロジーの営業問い合わせ先へお問い合わせください。本製品製造工場は、ISO9001をクリアした品質管理工程の下、製造されています。 ただし、本製品モジュール部以外の実装品や付属品、登録アンテナについては、メーカー各社の製造要件に従って製造されているため、当社において個別に回答することはできかねます。各アンテナメーカー様にご確認ください。 ## 8.2 RoHS認証 製品の製造プロセスは、Pbフリーの製造プロセスを使用しております。採用プロセス、生産ラインにおけるRoHS、RoHS 2.0 指令の準拠検査を行っています。アンテナやモジュール以外の評価基板や関連製品などにおいては、Pbフリーではないものも含まれる可能性があります。それぞれの製品の製造者へご確認ください。 ## 8.3 日本国外でのご利用に関して 本製品の日本国外での使用については、本文書の範囲の使用方法において、対応しておりません。海外での使用をご検討のお客様は、弊社、担当営業まで詳細をお問い合わせください。随時、海外における情報や製品アップデートの提供などをおこなっており、お客様に最適な最新情報を提供させていただきます。 --- # 改訂履歴 | 日付 | 内容 | |---|---| | 2025年8月25日 | 初版 | | 2026年8月31日 | ZCL仕様の概要の説明を追加、ドキュメント全体の誤記を訂正 | **重要事項** 株式会社クレアリンクテクノロジーは、このドキュメントのすべての内容の最終的な解釈および変更の権利を留保します。製品のハードウェアとソフトウェアは継続的に改善されているため、このドキュメントは予告なしに変更されることがあります。その場合、本ドキュメントの最新バージョン、および、リビジョンが優先されます。この製品を使用する設計者は、当社のWebサイト等を通じて、製品の動向に注意し、本製品の最新情報をタイムリーに取得してください。 **Important Notice** CLEALINK TECHNOLOGY CO., LTD. reserve the right of final interpretation and modification of all contents of this document. Since the product hardware and software are continually improved, this document may change without notice. In such cases, the latest version and revision of this document shall take precedence. Designers using this product should pay attention to product trends and obtain the latest information on this product in a timely manner through our website, etc. © CLEALINK TECHNOLOGY CO., LTD.