シナリオ: TargetおよびcontentRootを使用した間接デバイス・データのルーティング

IoTドメインに各デジタル・ツイン・モデルを作成するには、oci iot digital-twin-model createコマンドを使用します。

ゲートウェイ・モデルの作成

oci iot digital-twin-model create --iot-domain-id <iot-domain-OCID> --spec file://gateway-model.json

HVACモデルの作成

oci iot digital-twin-model create --iot-domain-id <iot-domain-OCID> --spec file://hvac-model.json

コンプレッサ・モデルの作成

oci iot digital-twin-model create --iot-domain-id <iot-domain-OCID> --spec file://compressor-model.json

サンプル・モデル・ファイルgateway-model.json、hvac-model.jsonおよびcompressor-model.jsonを使用します。

CreateDigitalTwinModel操作を実行して、IoTドメインにデジタル・ツイン・モデルを作成します。

APIをコールするときに、ダウンロード可能なデジタル・ツイン・モデル・ファイルに表示されるものと同じDTDLペイロードを使用します。

IoTドメインに各アダプタを作成するには、oci iot digital-twin-adapter createコマンドを使用します。

ゲートウェイ・アダプタの作成

このコマンドを使用して、ゲートウェイのデジタル・ツイン・モデルを関連付け、エンベロープおよびルート・ファイルを指定します。

oci iot digital-twin-adapter create \
  --iot-domain-id <iot-domain-OCID> \
  --digital-twin-model-spec-uri "dtmi:com:oracle:example:icd:contentroot:gateway;1" \
  --inbound-envelope file://gateway-envelope.json \
  --inbound-routes file://gateway-routes.json

{
  "referenceEndpoint": "/gateway/gateway-reference",
  "referencePayload": {
    "dataFormat": "JSON",
    "data": {
      "time": 1773768299143534,
      "cpuUtil": 30,
      "memUtil": 25,
      "diskUtil": 20,
      "firmware": "Oracle Linux 9.1"
    }
  },
  "envelopeMapping": {
    "timeObserved": "$.time"
  }
}

[
  {
    "condition": "${endpoint(1) == \"hvac\"}",
    "contentRoot": "$.data",
    "target": "${endpoint(2)}"
  },
  {
    "condition": "${endpoint(1) == \"compressor\"}",
    "contentRoot": "$.telemetry",
    "target": "${endpoint(2)}"
  },
  {
    "condition": "*",
    "payloadMapping": {
      "$.cpuUtilization": "$.cpuUtil",
      "$.memoryUtilization": "$.memUtil",
      "$.storageUtilization": "$.diskUtil",
      "$.firmwareVersion": "$.firmware"
    }
  }
]

HVACアダプタを作成します

oci iot digital-twin-adapter create \
  --iot-domain-id <iot-domain-OCID> \
  --digital-twin-model-spec-uri "dtmi:com:oracle:example:icd:contentroot:hvac;1" \
  --inbound-envelope file://hvac-envelope.json \
  --inbound-routes file://hvac-routes.json

{
  "referenceEndpoint": "/hvac/icd-case1-reference",
  "referencePayload": {
    "dataFormat": "JSON",
    "data": {
      "time": 1773768299143535,
      "temperature": 75,
      "humidity": 65
    }
  },
  "envelopeMapping": {
    "timeObserved": "$.time"
  }
}

[
  {
    "condition": "*",
    "payloadMapping": {
      "$.temperature": "$.temperature",
      "$.humidity": "$.humidity"
    }
  }
]

コンプレッサ・アダプタの作成

oci iot digital-twin-adapter create \
  --iot-domain-id <iot-domain-OCID> \
  --digital-twin-model-spec-uri "dtmi:com:oracle:example:icd:contentroot:compressor;1" \
  --inbound-envelope file://compressor-envelope.json \
  --inbound-routes file://compressor-routes.json

{
  "referenceEndpoint": "/compressor/icd-case2-reference",
  "referencePayload": {
    "dataFormat": "JSON",
    "data": {
      "time": 1773768299143536,
      "pressure": 101,
      "vibration": 0.42
    }
  },
  "envelopeMapping": {
    "timeObserved": "$.time"
  }
}

[
  {
    "condition": "*",
    "payloadMapping": {
      "$.pressure": "$.pressure",
      "$.vibration": "$.vibration"
    }
  }
]

CLIからのファイルの参照の詳細は、「複雑な入力のためのJSONファイルの使用」を参照してください。

CreateDigitalTwinAdapter操作を実行して、IoTドメインにデジタル・ツイン・アダプタを作成します。

ダウンロード可能なファイルに示されているものと同じインバウンド・エンベロープおよびインバウンド・ルート・ペイロードを使用します。

oci iot digital-twin-instance createコマンドを使用して、最初にゲートウェイを作成してから、間接的に接続された2つのデバイス・インスタンスを作成します。

ゲートウェイ・インスタンスの作成

oci iot digital-twin-instance create \
  --iot-domain-id <iot-domain-OCID> \
  --connectivity-type GATEWAY \
  --display-name "Gateway Content Root" \
  --auth-id <certificate-or-secret-OCID> \
  --digital-twin-adapter-id <gateway-adapter-OCID> \
  --external-key gateway1

間接的に接続されたHVACインスタンスの作成

oci iot digital-twin-instance create \
  --iot-domain-id <iot-domain-OCID> \
  --connectivity-type INDIRECT \
  --display-name "HVAC Content Root Case 1" \
  --gateways '["<gateway-instance-OCID>"]' \
  --digital-twin-adapter-id <hvac-adapter-OCID> \
  --external-key hvac1

間接的に接続されたコンプレッサ・インスタンスの作成

oci iot digital-twin-instance create \
  --iot-domain-id <iot-domain-OCID> \
  --connectivity-type INDIRECT \
  --display-name "Compressor Content Root Case 2" \
  --gateways '["<gateway-instance-OCID>"]' \
  --digital-twin-adapter-id <compressor-adapter-OCID> \
  --external-key compressor1

CreateDigitalTwinInstance操作を実行して、ゲートウェイ・インスタンスと2つの間接的に接続されたインスタンスを作成します。

間接的に接続されたインスタンスを作成する場合は、リクエストにゲートウェイ・アソシエーションが含まれていることを確認してください。

これらのメッセージを使用して、各ルートが構成済のcontentRootを強制的に適用することを確認します。選択したネストされたオブジェクトが欠落しているため、これらのテスト・メッセージは拒否されます。

$.dataではなく $.telemetryでHVACメッセージを送信します:

mqttx pub \
  -h '<domain-short-id>.device.iot.<region>.oci.oraclecloud.com' \
  -p 8883 \
  -l mqtts \
  -t 'hvac/hvac1' \
  -m '{
    "time": 1773768299143537,
    "telemetry": {
      "temperature": 76,
      "humidity": 66
    }
  }' \
  -u gateway1 \
  -P '<secret-contents>'

$.telemetryのかわりに$.dataを使用して圧縮プログラム・メッセージを送信します:

mqttx pub \
  -h '<domain-short-id>.device.iot.<region>.oci.oraclecloud.com' \
  -p 8883 \
  -l mqtts \
  -t 'compressor/compressor1' \
  -m '{
    "time": 1773768299143538,
    "data": {
      "pressure": 102,
      "vibration": 0.52
    }
  }' \
  -u gateway1 \
  -P '<secret-contents>'

oci iot digital-twin-instance get-contentコマンドを使用して、マップされたフィールドを確認します。

ゲートウェイ・フィールドの検証: cpuUtilization、memoryUtilization、storageUtilizationおよびfirmwareVersion。

oci iot digital-twin-instance get-content --digital-twin-instance-id <gateway-instance-OCID>

HVACフィールドの検証: temperatureおよびhumidity。

oci iot digital-twin-instance get-content --digital-twin-instance-id <hvac-instance-OCID>

コンプレッサー・フィールドの検証: pressureおよびvibration。

oci iot digital-twin-instance get-content --digital-twin-instance-id <compressor-instance-OCID>

GetDigitalTwinInstanceContent操作を実行して、デジタル・ツイン・インスタンスからコンテンツを取得します。