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 Modbus-TCP
L'adaptateur de protocole Modbus-TCPconnecteurcollecte des données à partir d'appareils locaux via le protocole ModBustCP et les publie sur le site sélectionnéStreamManager
flux.
Vous pouvez également utiliser ce connecteur avec l'IoT SiteWise connecteur et votre IoT SiteWise passerelle. Votre passerelle doit fournir la configuration du connecteur. Pour de plus amples informations, veuillez consulterConfigurer une source Modbus TCPdans 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 possède les versions suivantes.
Version |
ARN |
---|---|
3 |
|
2 |
|
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 :
Paramètres du connecteur
Ce connecteur prend en charge les paramètres suivants :
LocalStoragePath
-
Le répertoire duAWS 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'AWS IoTConsole : Chemin de stockage local
Obligatoire
false
Type:
string
Modèle valide :
^\s*$|\/.
MaximumBufferSize
-
Taille maximale en Go pour l'IoT SiteWise utilisation du disque. La taille par défaut est de 10 Go.
Nom d'affichage dans l'AWS IoTConsole : Taille maximale du tampon de disque
Obligatoire
false
Type:
string
Modèle valide :
^\s*$|[0-9]+
CapabilityConfiguration
-
Ensemble de configurations de collecteurs Modbus TCP à partir desquelle le connecteur collecte des données et se connecte.
Nom d'affichage dans l'AWS IoTConsole : CapabilityConfiguration
Obligatoire
false
Type : Chaîne JSON bien formée qui définit l'ensemble des configurations de commentaire prises en charge.
Voici un exemple deCapabilityConfiguration
:
{ "sources": [ { "type": "ModBusTCPSource", "name": "SourceName1", "measurementDataStreamPrefix": "SourceName1_Prefix", "destination": { "type": "StreamManager", "streamName": "SiteWise_Stream_1", "streamBufferSize": 8 }, "endpoint": { "ipAddress": "127.0.0.1", "port": 8081, "unitId": 1 }, "propertyGroups": [ { "name": "GroupName", "tagPathDefinitions": [ { "type": "ModBusTCPAddress", "tag": "TT-001", "address": "30001", "size": 2, "srcDataType": "float", "transformation": "byteWordSwap", "dstDataType": "double" } ], "scanMode": { "type": "POLL", "rate": 100 } } ] } ] }
Exemple de création de connecteur (AWS CLI)
La commande CLI suivante crée unConnectorDefinition
avec une version initiale qui contient le connecteur Modbus-TCP Protocol Adapter.
aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version ' { "Connectors": [ { "Id": "MyModbusTCPConnector", "ConnectorArn": "arn:aws:greengrass:
region
::/connectors/ModbusTCP/versions/3", "Parameters": { "capability_configuration": "{\"version\":1,\"namespace\":\"iotsitewise:modbuscollector:1\",\"configuration\":\"{\"sources\":[{\"type\":\"ModBusTCPSource\",\"name\":\"SourceName1\",\"measurementDataStreamPrefix\":\"\",\"endpoint\":{\"ipAddress\":\"127.0.0.1\",\"port\":8081,\"unitId\":1},\"propertyGroups\":[{\"name\":\"PropertyGroupName\",\"tagPathDefinitions\":[{\"type\":\"ModBusTCPAddress\",\"tag\":\"TT-001\",\"address\":\"30001\",\"size\":2,\"srcDataType\":\"hexdump\",\"transformation\":\"noSwap\",\"dstDataType\":\"string\"}],\"scanMode\":{\"rate\":200,\"type\":\"POLL\"}}],\"destination\":{\"type\":\"StreamManager\",\"streamName\":\"SiteWise_Stream\",\"streamBufferSize\":10},\"minimumInterRequestDuration\":200}]}\"}" } } ] }'
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 Modbus-TCP Protocol Adapter inclut les logiciels et licences tiers suivants :
Petri numérique
Modbus
Ce connecteur est libéré sous leContrat de licence du logiciel Greengrass Core
Journal des modifications
Le tableau suivante décrit les modifications apportées à chaque version du connecteur.
Version |
Modifications |
Date |
---|---|---|
3 (recommandé) |
Cette version contient des correctifs de bogues. |
22 décembre 2021 |
2 |
Ajout de la prise en charge des chaînes source codées ASCII, UTF8 et ISO8859. |
24 mai 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.