IoT 以太網 IP 協議適配器接口 - AWS IoT Greengrass

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 站點智能網關。網關必須提供連接器的配置。如需詳細資訊,請參閱「」配置以太網/IP (EIP) 源在 IoT 中 SiteWise 使用者指南。

注意

此連接器在沒有容器隔離模式,因此您可以將其部署到AWS IoT Greengrass組在 Docker 容器中執行。

此連接器具有下列版本。

版本

ARN

2 (建議使用)

arn:aws:greengrass:region::/connectors/IoTEIPProtocolAdaptor/versions/2

1

arn:aws:greengrass:region::/connectors/IoTEIPProtocolAdaptor/versions/1

如需版本變更的詳細資訊,請參閱 Changelog

要求

此連接器有下列要求:

Version 1 and 2
  • AWS IoT GreengrassCore 軟體 v1.10.2 或更新版本。

  • 已啟用串流管理員AWS IoT Greengrass組。

  • Java 8 已安裝在核心裝置上並已新增至PATH環境變數。

  • 至少為 256 MB 的額外內存。這項要求是除了AWS IoT Greengrass核心內存要求。

注意

此連接器僅在下列區域中提供使用:

  • cn-north-1

  • ap-southeast-1

  • ap-southeast-2

  • eu-central-1

  • eu-west-1

  • us-east-1

  • us-west-2

連接器參數

此連接器支援下列參數:

LocalStoragePath

上的目錄AWS IoT Greengrass主機的 IoT SiteWise 連接器可以將永續性資料寫入資料。預設目錄為 /var/sitewise

中的顯示名稱AWS IoT主控台:本機儲存路徑

:必要false

類型:string

有效模式:^\s*$|\/.

ProtocolAdapterConfiguration

連接器從中收集數據或連接到的以太網 /IP 收集器配置集。此列表可以是空的清單。

中的顯示名稱AWS IoT主控台:協議轉接器配置

:必要true

類型:格式正確的 JSON 字串,用來定義一組支援的回饋組態。

以下是的範例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 命令會建立ConnectorDefinition的初始版本包含 IoT 以太網 IP 協議轉接器連接器。

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" } } ] }'
注意

此連接器中的 Lambda 函數具有長期生命週期。

輸入資料

此連接器不接受 MQTT 訊息作為輸入資料。

輸出資料

此連接器會將資料發佈至StreamManager。您必須配置目標消息流。輸出訊息的結構如下:

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

授權

IoT 以太網 IP 協議轉接器包含下列第三方軟體/授權:

此連接器在Greengrass Core 軟體授權合約

Changelog

下表描述連接器的每個版本的變更。

版本

改變

Date

2

此版本包含錯誤修正。

2021年12月23 日

1

初始版本。

2020 年 12 月 15 日

Greengrass 組一次只能包含連接器的一個版本。若要取得有關升級連接器版本的資訊,請參閱升級連接器版本

另請參閱