AWS IoT Greengrass Version 1 は、2023 年 6 月 30 日に延長ライフサイクルフェーズに入りました。詳細については、「AWS IoT Greengrass V1 メンテナンスポリシー」を参照してください。この日付を過ぎる AWS IoT Greengrass V1 と、 は機能、機能強化、バグ修正、セキュリティパッチを提供する更新プログラムをリリースしません。で実行されるデバイスは中断 AWS IoT Greengrass V1 されず、引き続き動作し、クラウドに接続します。に移行する AWS IoT Greengrass Version 2ことを強くお勧めします。これにより、重要な新機能が追加され、追加のプラットフォームのサポートが追加されます。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

IoT イーサネット IP プロトコルアダプタコネクタ

IoT イーサネット IP プロトコルアダプタコネクタは、イーサネットプロトコルや IP プロトコルを使用してローカルデバイスからデータを収集します。このコネクタを使用して、複数のデバイスからデータを収集し、StreamManager メッセージストリームに発行できます。

このコネクタは、IoT SiteWise コネクタや IoT SiteWise ゲートウェイと共に使用することもできます。ゲートウェイは、コネクタの設定を提供する必要があります。詳細については、「IoT SiteWise ユーザーガイド」の「Configure an Ethernet/IP (EIP) source」(イーサネット/IP (EIP) ソースを設定する) を参照してください。

このコネクタには、次のバージョンがあります。

バージョンの変更については、「Changelog」を参照してください。

要件

このコネクタには以下の要件があります。

Version 1 and 2

• AWS IoT Greengrass Core ソフトウェア v1.10.2 以降。

• AWS IoT Greengrass グループで有効なストリームマネージャー。

• Java 8 が Core デバイスにインストールされ、PATH 環境変数に追加されている。

• 最低 256 MB の追加 RAM。これは AWS IoT Greengrass Core で必要なメモリに対する追加要件です。

注記

このコネクタは、次のリージョンでのみ利用できます。

• cn-north-1

• ap-southeast-1

• ap-southeast-2

• eu-central-1

• eu-west-1

• us-east-1

• us-west-2

コネクタパラメータ

このコネクタでは、以下のパラメータがサポートされています。

次は、ProtocolAdapterConfiguration の例です。

{
    "sources": [
        {
            "type": "EIPSource",
            "name": "TestSource",
            "endpoint": {
                "ipAddress": "52.89.2.42",
                "port": 44818
            },
            "destination": {
                "type": "StreamManager",
                "streamName": "MyOutput_Stream",
                "streamBufferSize": 10
            },
            "destinationPathPrefix": "EIPSource_Prefix",
            "propertyGroups": [
                {
                    "name": "DriveTemperatures",
                    "scanMode": {
                        "type": "POLL",
                        "rate": 10000
                    },
                    "tagPathDefinitions": [
                        {
                            "type": "EIPTagPath",
                            "path": "arrayREAL[0]",
                            "dstDataType": "double"
                        }
                    ]
                }
            ]
        }
    ]
}

サンプルコネクタを作成する (AWS CLI)

以下の CLI コマンドを実行すると、IoT イーサネット IP プロトコルアダプタコネクタを含む初期バージョンで ConnectorDefinition を作成します。

aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version 
'{
    "Connectors": [
        {
            "Id": "MyIoTEIPProtocolConnector",
            "ConnectorArn": "arn:aws:greengrass:region::/connectors/IoTEIPProtocolAdaptor/versions/2",
            "Parameters": {
                "ProtocolAdaptorConfiguration": "{ \"sources\": [{ \"type\": \"EIPSource\", \"name\": \"Source1\", \"endpoint\": { \"ipAddress\": \"54.245.77.218\", \"port\": 44818 }, \"destinationPathPrefix\": \"EIPConnector_Prefix\", \"propertyGroups\": [{ \"name\": \"Values\", \"scanMode\": { \"type\": \"POLL\", \"rate\": 2000 }, \"tagPathDefinitions\": [{ \"type\": \"EIPTagPath\", \"path\": \"arrayREAL[0]\", \"dstDataType\": \"double\" }]}]}]}",
                "LocalStoragePath": "/var/MyIoTEIPProtocolConnectorState"
            }
        }
    ]
}'

入力データ

このコネクタは MQTT メッセージを入力データとして受け入れません。

出力データ

このコネクタは、StreamManager にデータを発行します。宛先メッセージストリームを設定する必要があります。出力メッセージは以下の構造になります。

{
    "alias": "string",
    "messages": [
        {
            "name": "string",
            "value": boolean|double|integer|string,
            "timestamp": number,
            "quality": "string"
        }
    ]
}

ライセンス

IoT イーサネット IP プロトコルアダプタコネクタには、以下のサードパーティーのソフトウェアおよびライセンスが含まれています。

このコネクタは、Greengrass Core ソフトウェアライセンス契約に従ってリリースされます。

Changelog

次の表に、コネクタの各バージョンにおける変更点を示します。

Greengrass グループには、一度に 1 つのバージョンのコネクタしか含めることができません。コネクタのバージョンのアップグレードについては、「コネクタのバージョンのアップグレード」を参照してください。

以下も参照してください。