プロダクトは、同じタイプの複数のデバイスで構成されます。ほとんどの場合、これらのデバイスは同じ機能を持ちます。たとえば、ハードウェアプロダクトモデルを表すプロダクトを作成し、そのプロダクトモデルのデバイスを作成できます。デバイスを IoT Platform に接続する前に、IoT Platform コンソールでプロダクトを作成する必要があります。このトピックでは、プロダクトの作成方法について説明します。
前提条件
IoT Platform が有効化されていること。
Enterprise Edition インスタンスでプロダクトを作成する場合は、まず Enterprise Edition インスタンスを購入する必要があります。詳細については、「Enterprise Edition インスタンスの購入」をご参照ください。
インスタンスの詳細については、「IoT Platform インスタンスの概要」をご参照ください。
手順
IoT Platform コンソールにログインします。
IoT Platform コンソールの左上隅で、IoT Platform インスタンスが存在するリージョンを選択します。
[概要] ページで、管理するインスタンスを見つけ、インスタンス ID またはインスタンス名をクリックします。
左側のナビゲーションウィンドウで、 を選択し、[プロダクトの作成] をクリックします。
プロンプトに従ってパラメーターを設定し、[OK] をクリックします。
パラメーター
説明
プロダクト名
プロダクトの名前。プロダクト名は Alibaba Cloud アカウント内で一意である必要があります。たとえば、プロダクトモデルをプロダクト名として入力できます。名前は 4～30 文字で、文字、数字、アンダースコア (_)、ハイフン (-)、アットマーク (@)、および括弧 () を使用できます。
ノードタイプ
プロダクト内のデバイスのタイプ。有効な値:
直結デバイス: デバイスは IoT Platform に直接接続できます。これらのデバイスにはサブデバイスをアタッチできませんが、ゲートウェイにサブデバイスとしてアタッチできます。
ゲートウェイサブデバイス: デバイスは IoT Platform に直接接続できず、ゲートウェイを使用して IoT Platform に接続する必要があります。ゲートウェイとサブデバイスの詳細については、「ゲートウェイとサブデバイス」をご参照ください。
ゲートウェイデバイス: デバイスは IoT Platform に直接接続でき、サブデバイスをアタッチできます。ゲートウェイを使用してサブデバイスを管理できます。サブデバイスのトポロジ関係を維持し、トポロジ関係を IoT Platform に同期できます。
ゲートウェイ接続プロトコル
このパラメーターは、[ノードタイプ] パラメーターを [ゲートウェイサブデバイス] に設定した場合にのみ使用できます。このパラメーターは、サブデバイスとゲートウェイ間の通信プロトコルを指定します。有効な値:
カスタム: Modbus、OPC UA、ZigBee、BLE ではないオープンソースまたは独自プロトコル。
Modbus: Modbus プロトコル。
OPC UA: OPC UA プロトコル。
ZigBee: ZigBee プロトコル。
BLE: BLE プロトコル。
ネットワーク接続方法
直結デバイスまたはゲートウェイのネットワーク接続方法。有効な値:
Wi-Fi
セルラー (2G/3G/4G/5G)
イーサネット
その他
データタイプ
アップストリームおよびダウンストリームデータの形式。有効な値:
ICA 標準データフォーマット (Alink JSON): JSON ベースの Alink プロトコルは、デバイスと IoT Platform 間の通信を確立するために IoT Platform によって提供されます。
カスタム: カスタムシリアルデータ形式を使用する場合は、このパラメーターを [カスタム] に設定します。
コンソールで データ解析スクリプトを送信して、アップストリームのカスタム形式データを Alink JSON データに変換し、ダウンストリームの Alink JSON データをカスタム形式データに解析する必要があります。これにより、デバイスは IoT Platform と通信できます。
チェックサムタイプ
デバイスが Thing Specification Language (TSL) データを IoT Platform に送信した後、IoT Platform は指定された検証タイプに基づいてデータを検証します。
プロダクトの [データタイプ] パラメーターが [カスタム] に設定されている場合、このプロダクトのデバイスが Thing Specification Language (TSL) データを使用して IoT Platform と通信するとき、IoT Platform はまずデータ解析スクリプトを呼び出して、レポートされたカスタム形式データを Alink JSON 形式に変換し、その後データ検証を実行します。
簡易検証: デバイスから送信されたデータの identifier フィールドと dataType フィールドのみが検証されます。他のフィールドのデータは検証なしで転送されます。
検証されたデータは、IoT Platform コンソールの [デバイス詳細] ページの [TSL データ] タブに表示されます。検証に失敗したデータは表示されません。
検証に失敗したデータは、転送されたデータの checkFailedData パラメーターで表示できます。詳細については、「データ形式」をご参照ください。
検証なし: デバイスから送信されたすべてのデータは検証なしで転送されます。デバイスからレポートされたデータは検証されず、すべてのデータが転送されます。
TSL モデルの使用上の注意:
- TSL プロパティの送信: プロパティデータは、IoT Platform コンソール の [デバイス詳細]
- TSL サービスの呼び出し: すべてのサービスで非同期呼び出しメソッドが使用されます。
- TSL イベントの送信: すべてのイベントのタイプは Info です。
認証モード
IoT Platform に接続されているデバイスを認証するために使用されるメソッド。プロダクトの作成後、このパラメーターの値を変更することはできません。有効な値:
DeviceSecret: デバイスに対して IoT Platform によって生成された DeviceSecret は、デバイス検証署名を取得するために使用されます。
DeviceSecret を使用した署名計算の詳細については、「MQTT-TLS 接続通信」をご参照ください。
ID²: IoT Device ID (ID²) サービスは、デバイスと IoT Platform の相互 ID 検証機能を提供します。このサービスは、iTLS を介して軽量のセキュアトンネルを確立し、データセキュリティを確保します。
重要日本 (東京) リージョンの Enterprise Edition インスタンス のみが ID² ベース認証をサポートします。
ID² 認証を使用するには、ID² サービスを購入する必要があります。
[ネットワーク接続方法] パラメーターが LoRaWAN に設定されているプロダクトは、ID² ベース認証をサポートしていません。
プロダクトの説明
プロダクトの説明。説明は 1～100 文字である必要があります。
結果
プロダクトが作成されると、 ページに移動します。[プロダクトの作成] ページで、プロンプトに従って [デバイスの追加]、[機能の定義]、[デバイスの設定] を行うことができます。
次のステップ
プロダクト機能の定義
[プロダクト] ページで、設定するプロダクトに対応する [操作] 列の [表示] をクリックします。
プロダクト詳細ページで、タブをクリックしてビジネス要件に基づいてプロダクトを設定します。
プロダクト情報
プロダクト情報を表示します。[プロダクト情報] の右側にある [編集] をクリックできます。[プロダクト情報の編集] ダイアログボックスで、[プロダクト名] または [プロダクトの説明] パラメーターを変更します。
プロダクトタグを表示します。デフォルトでは、タグは表示されません。プロダクトを識別するためにタグを追加できます。詳細については、「プロダクトタグの追加」をご参照ください。
Topic カテゴリ
[基本通信の Topic]、[TSL 通信の Topic]、[Topic カテゴリ] タブで、IoT Platform に存在する Topic カテゴリを表示します。詳細については、「Topic カテゴリ」をご参照ください。
カスタム Topic カテゴリを追加することもできます。詳細については、「カスタム Topic カテゴリの追加」をご参照ください。
機能の定義
TSL 通信を容易にするために、TSL モデルのプロパティ、イベント、およびサービスを設定できます。詳細については、次のトピックをご参照ください。
詳細については、「TSL モデルとは」をご参照ください。
詳細については、「TSL 機能の追加」をご参照ください。
詳細については、「TSL 機能の一括追加」をご参照ください。
メッセージ解析
プロダクトの [データタイプ] パラメーターが [カスタム] に設定されている場合は、データを解析するためのスクリプトを作成する必要があります。詳細については、次のトピックをご参照ください。
詳細については、「メッセージ解析スクリプトの送信」をご参照ください。
詳細については、「TSL データを解析するスクリプトの送信」をご参照ください。
詳細については、「データ解析の概要」をご参照ください。
サーバー側サブスクリプション
サーバー側サブスクリプションを作成して、プロダクトのデバイスから送信されたデータを転送できます。詳細については、「AMQP サーバー側サブスクリプションの設定」をご参照ください。
デバイス開発
デバイスを設定して IoT Platform に接続するには、デバイスの登録、[デバイスの接続]、[デバイス接続ステータスの確認]、そして [デバイスの量産] の手順を実行します。詳細については、「デバイス開発」をご参照ください。
デバイス登録
次の図は、デバイスの作成方法を示しています。詳細については、「デバイスの作成」をご参照ください。
デバイス接続
IoT Platform は、複数のプログラミング言語で Link SDK を提供しています。詳細については、「デバイス接続の概要」をご参照ください。
接続の確認
デバイスが IoT Platform に接続されているかどうかを確認します。デバイスがオンライン状態の場合、IoT Platform のメッセージングおよび通信機能を使用して、デバイスとの間でメッセージを送受信できます。詳細については、次のトピックをご参照ください。
詳細については、「AMQP サーバー側サブスクリプションの設定」をご参照ください。
詳細については、「データ転送の設定」をご参照ください。
詳細については、「サーバー側 API 呼び出し Pub」をご参照ください。
デバイスの量産
複数のデバイスを同時に追加し、デバイスに証明書を書き込みます。詳細については、次のトピックをご参照ください。
詳細については、「一度に複数のデバイスを作成する」をご参照ください。
詳細については、「メーカーの生産ラインでデバイス証明書を書き込む」をご参照ください。
詳細については、「デバイスメーカーのクラウドサーバーからデバイス証明書を取得する」をご参照ください。
(オプション) プロダクトの公開
[プロダクト詳細] ページで、右上隅の [公開] をクリックしてプロダクトを公開します。
プロダクトを公開する前に、プロダクトのすべてのパラメーターが設定され、デバイスが設定およびデバッグされていることを確認してください。
プロダクトが公開されると、プロダクトは [公開済み] 状態になります。
[公開済み] 状態のプロダクトは変更または削除できません。
その他の操作
プロダクトの公開操作をキャンセルします。[プロダクト詳細] ページで、右上隅にある [公開をキャンセル] をクリックし、[OK] をクリックします。
公開されていないプロダクトを削除します。[プロダクト] ページに戻ります。プロダクトリストで削除するプロダクトを見つけ、[操作] 列の [削除] をクリックし、[OK] をクリックします。
警告プロダクトに関連するすべてのデータが削除されます。プロダクトのデバイスが IoT Platform に接続されている場合、すべてのサービスが利用できなくなり、顧客のビジネスが中断されます。注意して進めてください。
プロダクトを削除する前に、そのプロダクトのすべてのデバイスを削除する必要があります。詳細については、「デバイスを削除する」をご参照ください。
プロダクトデータをバックアップします。[プロダクト] ページに戻り、プロダクトリストの上にある [プロダクトデータのバックアップ] をクリックして ページに移動します。対象のプロダクトを選択して、データバックアップを有効にできます。詳細については、「プロダクトをバックアップする」をご参照ください。
