Connecteur adaptateur de protocole IP IoT Ethernet - AWS IoT Greengrass

AWS IoT Greengrass Version 1 est entré dans la phase de durée de vie prolongée le 30 juin 2023. Pour plus d'informations, consultez la politique de AWS IoT Greengrass V1 maintenance. Après cette date, AWS IoT Greengrass V1 ne publiera pas de mises à jour fournissant des fonctionnalités, des améliorations, des corrections de bogues ou des correctifs de sécurité. Les appareils qui fonctionnent AWS IoT Greengrass V1 sous tension ne seront pas perturbés et continueront à fonctionner et à se connecter au cloud. Nous vous recommandons vivement de migrer vers AWS IoT Greengrass Version 2, qui ajoute de nouvelles fonctionnalités importantes et prend en charge des plateformes supplémentaires.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Connecteur adaptateur de protocole IP IoT Ethernet

L'adaptateur de protocole IP Ethernet IoTconnecteurcollecte des données à partir d'appareils locaux à l'aide du protocole EtherNet/IP. Vous pouvez utiliser ce connecteur pour collecter des données à partir de plusieurs appareils et les publier sur unStreamManagerflux de messages.

Vous pouvez également utiliser ce connecteur avec l'IoT SiteWise connecteur et votre passerelle IoT SiteWise. Votre passerelle doit fournir la configuration du connecteur. Pour de plus amples informations, veuillez consulterConfiguration d'une source EtherNet/IP (EIP)dans l'IoT SiteWise guide de l'utilisateur.

Note

Ce connecteur fonctionne dansAucun conteneurmode d'isolation, pour que vous puissiez le déployer sur unAWS IoT Greengrassgroupe exécuté dans un conteneur Docker.

Ce connecteur a les versions suivantes.

Version

ARN

2 (recommandé)

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

1

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

Pour obtenir des informations sur les changements apportés aux versions, veuillez consulter le Journal des modifications.

Prérequis

Ce connecteur possède les critères suivants :

Version 1 and 2
  • AWS IoT GreengrassLogiciel principal v1.10.2 ou version ultérieure.

  • Gestionnaire de flux activé sur l'ongletAWS IoT Greengrass.

  • Java 8 installé sur l'appareil principal et ajouté au modulePATHvariable d'environnement.

  • Un minimum de 256 Mo de RAM supplémentaire. Cette exigence s'ajoute àAWS IoT GreengrassExigences en mémoire de base.

Note

Ce connecteur est disponible dans les régions suivantes :

  • cn-north-1

  • ap-southeast-1

  • ap-southeast-2

  • eu-central-1

  • eu-west-1

  • us-east-1

  • us-west-2

Paramètres du connecteur

Ce connecteur prend en charge les paramètres suivants :

LocalStoragePath

Le répertoire sur leAWS IoT Greengrasshôte que l'IoT SiteWise peut écrire des données persistantes dans. Le répertoire par défaut est /var/sitewise.

Nom d'affichage dans l'ongletAWS IoTConsole  : Stockage local chemin d'accès

Obligatoirefalse

Type: string

Modèle valide :^\s*$|\/.

ProtocolAdapterConfiguration

Ensemble de configurations de collecteurs EtherNet/IP à partir desquels le connecteur collecte des données ou se connecte. Cela peut être une liste vide.

Nom d'affichage dans l'ongletAWS IoTConsole  : Configuration de l'adaptateur de protocole

Obligatoiretrue

Type : Chaîne JSON bien formée qui définit l'ensemble des configurations de commentaires prises en charge.

Voici un exemple deProtocolAdapterConfiguration :

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

Exemple de création de connecteur (AWS CLI)

La commande d'interface de ligne de commande suivante crée un élémentConnectorDefinitionavec une version initiale qui contient le connecteur 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" } } ] }'
Note

La fonction Lambda de ce connecteur possède unlongue duréeCycle de vie.

Données d'entrée

Ce connecteur n'accepte pas les messages MQTT comme données d'entrée.

Données de sortie

Ce connecteur publie des données dansStreamManager. Vous devez configurer le flux de messages de destination. Les messages de sortie ont la structure suivante :

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

Licences

Le connecteur IoT Ethernet IP Protocol Adapter inclut les logiciels et licences tiers suivants :

Ce connecteur est libéré sous leContrat de licence du logiciel Greengrass Core.

Journal des modifications

Le tableau suivant décrit les modifications apportées à chaque version du connecteur.

Version

Modifications

Date

2

Cette version contient des correctifs de bogues.

23 décembre 2021

1

Première version.

15 décembre 2020

Un groupe Greengrass peut contenir une seule version du connecteur à la fois. Pour de plus amples informations sur la mise à niveau d'une version de connecteur, veuillez consulter Mise à niveau des versions du connecteur.

Consulter aussi