デバイスを IoT Platform に接続する前に、IoT Platform コンソールでプロダクトとデバイスを作成し、デバイス証明書を取得する必要があります。デバイス証明書には、ProductKey、DeviceName、DeviceSecret が含まれます。
前提条件
Enterprise Edition インスタンスが必要です。詳細については、「Enterprise Edition インスタンスの作成」をご参照ください。
背景
-
プロダクトは、同じ特徴を共有するデバイスのコレクションです。プロダクトごとにデバイスを管理できます。たとえば、TSL モデルの定義やTopic のカスタマイズが可能です。
-
各物理デバイスは、IoT Platform 上でデバイス ID を持つ必要があります。IoT Platform によって発行されたデバイス証明書 (ProductKey、DeviceName、DeviceSecret) を物理デバイスにプロビジョニングする必要があります。この証明書は、デバイスがプラットフォームに接続する際にデバイスを認証します。詳細については、「デバイス証明書の取得」をご参照ください。
このトピックでは、IoT Platform で家庭用サーモスタットのプロダクトを作成し、TSL モデルを定義し、デバイスを追加して、デバイス証明書を取得する方法について説明します。
手順
-
IoT Platform コンソールの [概要] タブで、[IoT テスト環境] インスタンスをクリックします。
-
左側のナビゲーションペインで、を選択し、[製品の作成]をクリックします。
-
[製品の作成] ページでパラメーターを設定し、[OK] をクリックします。
この例では、[製品名] を Home Thermostat に設定します。その他のパラメーターにはデフォルト値を使用します。たとえば、ノードタイプは直結デバイス、接続方式はWi-Fi、データフォーマットはICA 標準データフォーマット (Alink JSON)、データ検証レベルは緩和、認証方式はDeviceSecret です。
-
[製品の作成] ページで、[モノの仕様言語 (TSL) モデルを定義] をクリックします。
プロダクトの TSL モデルを定義すると、物理的なプロダクトがプロパティ、サービス、イベントで構成されるデータモデルに抽象化されます。このモデルにより、IoT Platform でのデバイス管理とデータインタラクションが簡素化されます。
-
[機能定義] タブで [下書きを編集] をクリックし、次の手順に従って Home Thermostat 製品の温度および湿度プロパティを定義します。
-
[デフォルトモジュール] で、[カスタム機能を追加] をクリックして温度および湿度プロパティを設定します。
温度プロパティについては、機能タイプをプロパティに、機能名を温度に、識別子をtemperature に、データ型をdouble に、値の範囲を-20~60 に、ステップを0.1 に、単位をCelsius/°C に、アクセスモードを読み取り/書き込みに設定し、湿度プロパティについては、機能名を湿度に、識別子をhumidity に、データ型をint32 に、値の範囲を0~100 に、ステップを1 に、単位をPercentage/% に、アクセスモードを読み取り/書き込みに設定します。
-
[機能定義] の下の [下書きの編集] ページの左下隅にある [パブリッシュ] をクリックします。[TSL モデルを公開しますか?] ダイアログボックスが表示されます。
-
[現在のバージョンとオンラインバージョンの差異を確認しました] チェックボックスを選択します。
-
[OK] をクリックして TSL モデルを公開します。
-
-
[製品詳細] ページで、[デバイス] タブをクリックします。
-
[デバイス] タブで、[デバイスの追加] をクリックします。表示されたダイアログボックスで、Device1 などのデバイス名を入力し、[OK] をクリックします。
デバイスが作成されると、[追加済み] ダイアログボックスが表示されます。[デバイス証明書のコピー] をクリックします。
または、[表示] をクリックして [デバイス詳細] ページを開きます。このページで、DeviceSecret の横にある [表示] をクリックします。
デバイス証明書には、ProductKey、DeviceName、DeviceSecret が含まれます。デバイスは、この認証情報を使用して IoT Platform と通信します。
重要デバイス証明書は、ご利用のデバイスを IoT Platform に接続するために必須です。証明書情報をコピーし、安全な場所に保管してください。
パラメーター
説明
ProductKey
デバイスが属するプロダクトの ProductKey です。ProductKey は、IoT Platform によってプロダクトに発行される GUID です。
DeviceName
デバイスの DeviceName で、プロダクト内でのデバイスの一意の識別子です。DeviceName と ProductKey の組み合わせがデバイス識別子として使用されます。IoT Platform は、このデバイス識別子に基づいてデバイスを認証し、通信します。
DeviceSecret
デバイスの DeviceSecret で、デバイスの認証と暗号化のために IoT Platform によって発行されます。DeviceSecret は DeviceName と組み合わせて使用する必要があります。