Connettore adattatore protocollo IP Ethernet IoT - AWS IoT Greengrass

AWS IoT Greengrass Version 1 è entrato nella fase di estensione della vita utile il 30 giugno 2023. Per ulteriori informazioni, consulta la politica AWS IoT Greengrass V1 di manutenzione. Dopo questa data, AWS IoT Greengrass V1 non rilascerà aggiornamenti che forniscano funzionalità, miglioramenti, correzioni di bug o patch di sicurezza. I dispositivi che funzionano AWS IoT Greengrass V1 non subiranno interruzioni e continueranno a funzionare e a connettersi al cloud. Ti consigliamo vivamente di eseguire la migrazione a AWS IoT Greengrass Version 2, che aggiunge nuove importanti funzionalità e supporto per piattaforme aggiuntive.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Connettore adattatore protocollo IP Ethernet IoT

Adattatore protocollo IP Ethernet IoTconnettoreraccoglie dati da dispositivi locali utilizzando il protocollo EtherNet/IP. Puoi utilizzare questo connettore per raccogliere dati da più dispositivi e pubblicarli in unStreamManagerflusso di messaggi.

Puoi anche utilizzare questo connettore con l'IoT SiteWise connettore e gateway IoT SiteWise. Il gateway deve fornire la configurazione per il connettore. Per ulteriori informazioni, consultaConfigurare un'origine EtherNet/IP (EIP)nell'IoT SiteWise Guida per l'utente.

Nota

Questo connettore funzionaNessun containermodalità di isolamento, in modo da poterla distribuire su unAWS IoT Greengrassgruppo in esecuzione in un container Docker.

Questo connettore presenta le versioni seguenti.

Versione

ARN

(consigliato)

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

1

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

Per informazioni sulle modifiche di ogni versione, consulta Changelog.

Requisiti

Questo connettore presenta i seguenti requisiti:

Version 1 and 2
  • AWS IoT GreengrassSoftware core v1.10.2 o versioni successive.

  • Gestore di flusso attivato sulAWS IoT Greengrassgruppo.

  • Java 8 installato sul dispositivo core e aggiunto alPATHVariabile di ambiente.

  • Un minimo di 256 MB di RAM aggiuntiva. Questo requisito è in aggiunta aAWS IoT GreengrassRequisiti di memoria principale.

Nota

Questo connettore è disponibile solo nella seguente regione:

  • cn-north-1

  • ap-southeast-1

  • ap-southeast-2

  • eu-central-1

  • eu-west-1

  • us-east-1

  • us-west-2

Parametri connettore

Questo connettore supporta i seguenti parametri:

LocalStoragePath

La directory sulAWS IoT Greengrasshost che l'IoT SiteWise Il connettore può scrivere dati persistenti in. La directory predefinita è /var/sitewise.

Nome visualizzato nelAWS IoTConsole : Percorso di storage locale

: campo obbligatoriofalse

Tipo: string

Modello valido:^\s*$|\/.

ProtocolAdapterConfiguration

Il set di configurazioni del collettore EtherNet/IP a cui il connettore raccoglie o si connette. Può essere un elenco vuoto.

Nome visualizzato nelAWS IoTConsole : Configurazione degli adattatori

: campo obbligatoriotrue

Type: Una stringa JSON ben formata che definisce il set di configurazioni di feedback supportate.

Di seguito è riportato un esempio diProtocolAdapterConfiguration:

{ "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" } ] } ] } ] }

Esempio di creazione di un connettore (AWS CLI)

Il seguente comando CLI crea unConnectorDefinitioncon una versione iniziale che contiene il connettore IoT Ethernet IP Protocol Adapter.

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

La funzione Lambda in questo connettore ha undi lunga durataCiclo di vita.

Dati di input

Questo connettore non accetta i messaggi MQTT come dati di input.

Dati di output

Questo connettore pubblica i dati inStreamManager. È necessario configurare il flusso di messaggi di destinazione. I messaggi di output sono della struttura seguente:

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

Licenze

Il connettore IoT Ethernet IP Protocol Adapter include il software e le licenze di terze parti indicati di seguito:

Questo connettore viene rilasciato sotto ilAccordo di licenza del software Greengrass Core.

Changelog

La tabella seguente descrive le modifiche apportate a ogni versione del connettore.

Versione

Modifiche

Data

2

Questa versione contiene le correzioni di bug.

23 dicembre 2021

1

Versione iniziale.

15 dicembre 2020

Un gruppo Greengrass può contenere una sola versione del connettore alla volta. Per informazioni sull'aggiornamento di una versione del connettore, consulta Aggiornamento delle versioni dei connettori.

Consultare anche