Matter

Matter のドライバーの手引き。機器が参加する Wi-Fi と Thread のネットワーク、Bluetooth によるローカルの Fabric へのコミッショニング、機器をペアリングの流れ、ノードの識別、機器から来るタグと、それぞれへの書き込みが何をするか。

Matter のドライバーは、Matter の現場設備を読みます。Matter の標準に適合したスマートなセンサー、プラグ、照明などの機器で、ネットワークへの参加が Wi-Fi でも Thread でもかまいません。ドライバーは両方で 1 つです。ネットワークは入り口にすぎず、機器がそこに入ったあとは、Ganter Lab はどちらもローカルのネットワーク越しに同じように読みます。

Ganter Lab は、自分のローカルの Fabric を持つ Matter のコントローラーとしてふるまいます。機器ごとに 1 度、このコンピューターの Bluetooth Low Energy でコミッショニングし、ドライバーのネットワークのカードに登録されたネットワークの資格情報を渡します。それ以降はローカルのネットワーク越しに話します。Wi-Fi の機器ならお使いのルーターを通じて、Thread の機器ならお使いの Thread の Border Router を通じてです。

機器が Wi-Fi なのか Thread なのかを、Ganter Lab に伝える必要はありません。機器が自分で伝えます。Bluetooth のセッションが開くと、Ganter Lab は機器に何かを書き込む前に、その機器がどちらの種類のネットワークに参加するのかを機器から読み、選んだネットワークがもう一方の種類なら、それを伝えるメッセージを出して止まります。

これは、ふだんの設定の順序をひっくり返します。Matter の機器はホストとポートから始まりません。ペアリングの儀式から始まり、そのあとで保存されるのは、コミッショニングしたノードの安定した識別だけです。

ペアリングの前に必要なものです。

• このコンピューターの Bluetooth Low Energy のアダプター。オンになっていて、Windows が Ganter Lab にその使用を許していること。
• 機器が参加するネットワークを、ネットワークのカードに登録してあること。Wi-Fi の機器なら Wi-Fi の名前とそのパスワード、Thread の機器なら Border Router のある既存の Thread ネットワークと、その完全な有効な運用データセットです。Ganter Lab は機器をお使いのネットワークに参加させます。そのネットワークの資格情報を作り出すことはできません。
• 機器かその箱に印刷されている、その機器のセットアップコード。そして、ペアリングモードにした機器。

ネットワーク

Matter のドライバーのパネルには、ネットワークという題のカードがあります。機器が参加する Wi-Fi と Thread のネットワークで、1 行に 1 つです。ネットワークは最初の機器より前に 1 度だけ登録し、そこにペアリングするすべての機器に使います。同じ Wi-Fi に 2 つ目の照明をペアリングするときには、もう何も聞かれません。このカードは、Connector を構成できるロールにだけ描かれます。ネットワークの秘密を持ち、ペアリングのほかには何にも使わないからです。

カードの見出しには、そのコマンドがこの順に並びます。

表には、ネットワークごとに名前、ネットワークの種類（Wi-Fi ネットワークか Thread ネットワーク）、状態が並びます。状態はペアリングできますか、そのネットワークにまだ足りないものです。名前がまだ書かれていないネットワークは名前のないネットワークと表示されます。

選択したネットワークの項目は、表の下でその場で編集でき、自動で保存されます。下の決まりに合わない値は書き込まれず、項目がその理由を述べます。

Wi-Fi の機器をそもそもペアリングできるかどうかは、2 つのことで決まります。カードは項目の横にその両方を述べます。

• ほとんどの機器は 2.4 GHz のネットワークにしか参加しません。同じ名前を 2.4 GHz と 5 GHz の両方で発信しているルーターなら使えます。5 GHz にしかないネットワークは使えません。
• このコンピューターと機器は、同じローカルのネットワークにいなければなりません。ゲスト用のネットワークや、ルーターで有効にした端末間の分離（クライアントの分離）があると、機器が参加したあとで、このコンピューターが機器を見つけられません。

ネットワークがペアリングに使えるのは、その秘密がこの決まりに合っているあいだだけです。Wi-Fi のネットワークなら正しい名前と正しいパスワード（空を含む）、Thread のネットワークなら正しいデータセットです。

ネットワークを編集すると、次のペアリングで渡すものが変わります。機器がすでに受け取ったものは変わりません。別のネットワークに移す必要がある機器や、ルーターのパスワードが変わった機器は、リセットしてからペアリングし直します。

機器をペアリングの流れ

Matter のドライバーでは、ほかのドライバーが機器を追加を出す場所に、コマンドバーが機器をペアリングを出します。欄の新規…メニューの Matter の項目にも同じものがあります。ペアリングに使えるネットワークが 1 つもないあいだは、描かれたまま淡色で、ツールチップは「先に、機器が参加するネットワークを追加してください。」です。使えるネットワークがあれば、押すと入力欄が開きます。

Matter のドライバーのフォルダーには新しい機器があります（その機器の表、その右クリックメニュー、新規… > Matter > <Folder>）。これは同じフォームを開き、使えるネットワークがないあいだは同じように灰色になり、ペアリングした機器はそのフォルダーに入ります。

入力欄の機器をペアリングは、名前とセットアップコードが埋まり、使えるネットワークがあるまで押せません。ペアリングが走っているあいだ、入力欄はその段階を伝えます。確認（コードとネットワークの秘密を調べます）、探索（Bluetooth で機器を探します）、ペアリング（セットアップコードで認証し、機器がどちらの種類のネットワークに参加するかを読みます）、ネットワークに参加（ネットワークを機器に送り、そのあとローカルのネットワークで機器が応えるまで問い合わせます。状態の行は、そのネットワークが Wi-Fi か Thread かを述べます）、保存（ローカルのネットワーク上の機器と安全なセッションを開き、コミッショニングを完了させて、ノードをローカルの Fabric に記録します）。

キャンセルは、物理的な機器がまだ変更されていないあいだ使えます。コミッショニングが機器を変えてしまったあとは、ボタンが Ganter Lab は安全に終了しようとしていると伝え、半分だけコミッショニングされたノードを放り出すのではなく、記録を最後まで進めます。ペアリングは一度に 1 つです。1 つが進んでいるあいだの 2 つ目の試みは拒否されます。

新しい機器は、参加したネットワークの名前を記録し、自分のネットワークの項目に出します。同じネットワークに次の機器をペアリングするときに聞かれるのは、その名前とセットアップコードだけです。

ペアリングが失敗したとき

ペアリングが失敗したとき、メッセージは原因とすべきことを述べます。

現場設備がすでにコミッショニングされたあとで失敗が届いたときは、メッセージがそう述べ、ノード ID を見せます。そのノードは Fabric に残るので、ネットワークに現れたあとで機器検出から追加できます。その場合、機器をリセットしないでください。何も保存されなかったと述べるメッセージだけが、現場設備に手が付いていないという意味です。

ネットワークに参加できなかったと応えた機器は例外で、残しておく価値のあるものを何も持っていません。Ganter Lab は機器上のペアリングを終わらせ、機器は受け取ったものを捨ててすぐにペアリングモードに戻ります。同時にそのノードを Fabric から外すので、メッセージにはノード ID が付かず、機器検出が応えられないノードを並べることもありません。ネットワークを直して、ペアリングし直してください。ノードを残すのは、まったく応えなかった機器だけです。参加できたかどうかは、ローカルのネットワークに現れるまでわからないからです。

保存されるもの

Wi-Fi のパスワードとデータセットは、診断ログにも、機器のアドレスにも、その Thing Description にも出ません。ネットワークとペアリングは、MCP サーバーを通じてエージェントに提供されません。ペアリングには機器のそばにいる人が要り、ネットワークは秘密を持っているからです。

ノードの識別

ペアリングした機器は、その現場設備の安定した 64 ビットのノード ID に結び付いています。ノード ID は「接続」のカードに、機器の状態の隣に、16 桁の 16 進数として読み取り専用で出ます。編集できる表示名は変えてかまいませんが、ノード ID は変えられません。保存した識別をもう読めない機器は、その場所に再ペアリングが必要と出します。

機器のパネルには、読み取り専用のネットワークの項目もあります。ペアリングしたときに機器が参加したネットワークの名前です。それを記録しなかったバージョンでペアリングした機器は、何も記録されていないと述べます。この項目は記録であって設定ではありません。ネットワークのカードでそのネットワークを編集しても削除しても、機器には何も変わりません。

識別がノード ID であるおかげで、Matter の機器は互いに独立した接続の状態を保ちます。1 つのノードを無効にしても、削除しても、失っても、ほかのノードが使えなくなることはありません。そして機器を削除しても、手放すのはその安全なセッションの占有だけで、現場設備がローカルの Fabric から消えることはありません。

機器検出

Matter のドライバーの機器検出は、このアプリケーションのローカルの Fabric にすでに参加しているノードを並べ、それぞれから、そのノードが公開する値を読みます。値を読むために各ノードと安全なセッションを開くので、ネットワークにいないノードも、セッションが開けなかったあとで、値のないまま一覧に残ります。機器検出の候補はノードの識別を持ち、セットアップの秘密は持ちません。機器検出の全体の流れは機器検出で説明しています。

設定済みの機器の値は、名前ではなく、出力、クラスター、属性でそのタグと比べます。名前を変えたタグも数に入り、同じ値が二度追加されることはありません。

機器自身のページでも、離れずに同じことができます。「タグ」のカードの見出しにあるタグ検出はそのノードだけを読み、まだタグがない値をチェック済みで一覧にし、タグにして追加を添えます（機器のタグを検出するを参照）。

タグ

Matter の機器のタグは機器そのものから来ます。そのためにクラスターや属性の番号を入力する人はいません。うまく終わったペアリングは、そのままタグへ進みます。操作ログ帯には「Matter 機器「キッチンの照明」をペアリングしました。」と出て、ページは Matter のドライバーに開いて新しい機器を機器の表で強調表示し、その機器だけのスキャンがすぐに走ります。ペアリングが作った機器は、公開する値をすべてチェック付きにして検出した機器に現れ、スキャンは「「キッチンの照明」でタグにする値にチェックを入れてから、「タグにして追加」を押してください。」で終わります。要らないもののチェックを外してタグにして追加を押すと、操作ログ帯には「「キッチンの照明」にタグを 5 件追加しました。」と出ます。まだ応答していない機器は何も報告しません：「「キッチンの照明」からはまだ値の報告がありません。機器がオンラインになってから、もう一度機器検出を実行してください。」同じカードは、そのあとの機器検出のたびに、機器にまだタグのない値とともに戻ってきます。

タグにして追加は、Connector の構成の権限を持つロールにだけ描かれます。スキャンやペアリングが走っているあいだ、ステーションが変更を拒んでいるあいだ、何もチェックされていないあいだ（「追加する値に 1 つ以上チェックを入れてください。」）は、理由をツールチップにしてグレーのままです。機器がすでに出力、クラスター、属性を読んでいる値は二度と追加されません。チェックした値がすべてすでにあるときは何も保存されません：「チェックした値にはどれも「キッチンの照明」のタグがすでにあるため、何も追加しませんでした。」機器のほかのタグがすでに持っている名前には、明るさ (2) のように後ろに番号が付きます。

スキャンは、機器が公開するものを、Matter の仕様が並べるとおりに読みます。

スキャンが何を、どんな名前で出すか：

書き込めるとして出したタグは、読み書きのアクセスで届きます。ほかはすべて読み取りのみで届きます。

ドライバーが知っている値

ドライバーは、Matter の仕様から取った表を 1 つ持っています。名前で知っている値と、それぞれの変わり方の表です。値の変わり方は 3 つのうちのどれかです。ドライバーが送るコマンドで変わる（機器は受け付けるコマンドの中にそれを挙げていなければなりません）、仕様が書き込めるとしていて機器が挙げている属性そのものへの書き込みで変わる、または機器が報告するだけの値で、まったく変わらない、のどれかです。

仕様は温度、湿度、圧力を固定の単位で送ります。1/100 ℃、1/100 %、1/10 キロパスカルです。機器検出はこれらの値を最初から °C、%、kPa で出します。タグはスケールの段階に係数（温度と湿度は 0.01、圧力は 0.1）と単位を持って届くので、機器が 2150 を送れば 21.5 °C と読めます。書き込みは値が出ていく前にその段階を逆にかけるので、21.5 と書いた設定値は 2150 として機器に届きます。照度は対数（10000 × log10(lux) + 1）なので、どの係数でも変換できず、機器が送る数値のまま読めます。そのほかの値も、機器が送るまま読めます。

ドアロック、X と Y の座標による色、シーン、グループ、Toggle コマンドは表にありません。Matter の機器には自分のコマンドもありません。変更はすべて、そのタグのどれかへの書き込みです。

値を書き込む

アクセスが読み書きの Matter のタグは、書き込まれると機器を変えます。「現在の値」のカード、ダッシュボードの操作部品、Logic、エージェントのどこからでもです。書き込みはどのドライバーとも同じく機器の待ち行列に入り、機器の読み出しと順番に進み、その答えは機器自身の答えです。ドライバーは表から Matter のコマンドか属性への書き込みを選び、コマンドを選ぶ人はいません。書き込めたと数えるのは機器の SUCCESS だけです。それ以外はすべて、理由を添えて拒否されます。

拒否された書き込みが、書き込めたと伝えられることはなく、現場設備に届かなかったと伝えられることもありません。タグのページでは、機器が拒否したときは状態の行に「現場設備が書き込みを拒否しました：CONSTRAINT_ERROR, 0x87。」と出ます。何かを送る前に決まった拒否では、状態の代わりに理由が入ります。答えが来なかったときは「書き込みを確認できませんでした：現場設備が時間内に応答しませんでした。」と出ます。「書き込みに失敗しました：現場設備に届きませんでした。」は、接続していない機器のためのものです。理由は書き込みと一緒にも運ばれ、その書き込みのログの行が状態の意味とともに示し、エージェントの tag_write がそれを返します。

手で作るタグ

スキャンが出せる形で機器が公開していない、まれな値のために、Matter の機器のタグを追加が、手で埋めるタグを作ります。その「信号源」のカードは 3 つの欄を 1 行に並べ、その下のアドレスの予告がそれを 10 進で <endpoint>/<cluster>/<attribute> と組み立てます（1/8/0 は 1 つ目の出力の明るさです）。クラスターを選ぶまでタグは保存されず、パネルはこう伝えます：「このタグが読み取るクラスターを選んでください。クラスターがないと、機器には何も問い合わせません。」

タグの名前は自由です。タグに名前を付けるだけで、機器の何も選びません。データ型は Boolean、Int32、UInt32、Float、Double、String から選び、宣言した型で表せない読み取り値は、代わりの数値ではなくエラーとして読めます。値は機器が送るまま届きます。手で作った温度、湿度、圧力のタグは、スケールの段階に上の表の係数と単位を入れるまで、1/100 や 1/10 の単位で読めます。

アクセスの欄は、ドライバーの表が値を変えられる点にだけ書き込みを出します。そうでない点には読み取りのみを出し、その下に理由を示します。

出力、クラスター、属性を編集してタグがドライバーの書き込めない値を指すと、そのアクセスは読み取りのみに戻ります。機器検出が出したタグは、機器検出が与えたアクセスを保ちます。機器がどのコマンドを受け付けるかを尋ねるのは機器検出だけだからです。機器が挙げなかった値は読み取りのみのままで、欄は書き込みも出します。

以前のバージョンが保存したタグ

以前のバージョンは、Matter のタグのクラスターをタグの名前だけで示し、アドレスは <endpoint>/<attribute> でした。このバージョンが初めて起動すると、名前が Matter のカタログのクラスターである Matter の機器のタグ（最後のコロンのあとの部分を、前後の空白を除き、大文字と小文字を区別せずに見ます）は、そのクラスターを受け取り、それまで読んでいたのとまったく同じ値を読み続けます。名前はそのまま残り、アドレスの予告は <endpoint>/<cluster>/<attribute> を示すようになります。名前がどのクラスターにも合わなかったタグは、何も読んだことがありません。クラスターのないまま残り、読み出しはそう伝える理由とともに拒否され、そのページがクラスターを求めます。変換されたタグは、それまでのアクセスである読み取りのみを保ちます。それらのバージョンが出していたのはそれだけでした。書き込むには読み書きを選んでください。上の表の値で使えます。