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 組一次只能包含連接器的一個版本。若要取得有關升級連接器版本的資訊,請參閱升級連接器版本

另請參閱