DiXiM Home Network SDK の特徴

UPnP Stackはイベントドリブンで動作します。イベントはNetworkとTimerから発生します。またアプリケーションからの関数コールによってもUPnP Stackに対する処理が発生します。 上位層のコンポーネントは、下位層に対してコールバック関数を登録し、イベントが発生した場合にその通知を受け処理します。 例えばネットワークにパケットが到着した場合、Network Task Managerがそれを検出し、SSDPであればSSDP Listenerがそれを処理し、HTTPであればHTTP Serverがそれを処理します。

SSDPパケットが、Control Pointが送信したSSDP Searchであれば、DeviceのDescription Managerがコールバックを受け、レスポンスを返します。 >SSDPパケットが、Deviceが送信したSSDP Searchのレスポンスであれば、Control PointのDevice Managerがコールバックを受け、処理します。
このようにイベント処理は下位層から上位層に向かってコールバックされていきます。
NetworkとTimerからのイベント処理はすべてシングルスレッドで行われます。

Device Managerは、SSDPの受信とDevice Descriptionの取得により、ネットワーク内に存在するデバイスの一覧を管理します。フィルターを設定することにより、Control Pointが興味を持っているタイプのデバイスのみ管理することができます。Control Pointは、それぞれのデバイスが持つサービスに対して、SOAPリクエストを行います。サービスに対してサブスクライブすることで、サービスの状態が変わった場合にイベントを受け取ることができます。

Event Managerは、サービスに対するイベントのサブスクリプションの状態を管理します。Event Managerはサブスクリプションの期限が切れる前に、自動的にそのサブスクリプションをリニューアルします。ネットワークケーブルの抜き差しや、AutoIPからDHCPへの変更など、何らかの要因でControl Pointが使用しているネットワークの状態が変更されることがあります。ネットワーク状態の変更はNetwork Interface Monitorにより監視されており、変更があった場合はDevice ManagerやEvent Managerに通知され、適切な処理が自動的に行われます。

Deviceがどのような種類のデバイスでどのようなサービスを提供するかをデバイスディスクリプションドキュメントに記述します。これはXMLフォーマットのファイルでDescription Managerによって管理されます。 Control PointからSSDP Searchによる検索が行われた場合、デバイスはこのデバイスディスクリプションの内容に応じて応答を返します。またDevice起動時、および一定周期毎にSSDP aliveを送信し、Device終了時にSSDP byebyeを送信します。 HTTP ServerにはUPnP Service、Description Service、Document Serviceがあります。ユーザーはUPnP ServiceやDocument Serviceに独自のサービスを登録することが可能です。 Description Serviceは、SSDPのLocationに記述されているURLに対して要求があった場合に、デバイスディスクリプションドキュメントを返すサービスです。DiXiM SDKではデバイスディスクリプションにサービスのための設定情報を記述可能ですが、これらはDescription Serviceによって取り除かれた状態で配信されます。

Document Serviceには、特定のURLに対する要求を処理し応答を返すHTTPサービスを登録することができます。デフォルトでは特定のフォルダ以下のファイルを配信するサービスがDocument Serviceの一つとして実装されています。デバイスアイコンの配信にはこのサービスが用いられます。ブラウザベースのデバイスの設定ツールなども Document Serviceを用いて実装可能です。このDescription ServiceもDocument Serviceの一つとして実装されています。
UPnP Serviceには、SOAPリクエストを処理するサービスを登録することができます。通常Deviceの開発はこのUPnP Serviceを開発することが中心になります。 Document ServiceもUPnP Serviceも登録する場合はデバイスディスクリプションドキュメントに記述する必要があります。 Event Managerは、サービスに対してイベントをSubscribeしているControl Pointの管理を行います。 各Serviceは、状態が変わった場合にEvent Managerに通知することで、イベントをSubscribeしている各Control Pointにイベントが送信されます。