Avis de fin de support : le 7 octobre 2026, AWS le support de. AWS IoT Greengrass Version 1 Après le 7 octobre 2026, vous ne pourrez plus accéder aux AWS IoT Greengrass V1 ressources. Pour plus d'informations, rendez-vous sur [Migrer depuis AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).
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.
# Modbus-TCP Connecteur d'adaptateur de protocole
Le [connecteur Modbus-TCP ](connectors.md) Protocol Adapter collecte les données des appareils locaux via le protocole ModbusTCP et les publie dans les flux sélectionnés`StreamManager`.
Vous pouvez également utiliser ce connecteur avec le SiteWise connecteur IoT et votre SiteWise passerelle IoT. Votre passerelle doit fournir la configuration du connecteur. Pour plus d'informations, voir [Configurer une source Modbus TCP](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-modbus-source.html) dans le guide de l' SiteWise utilisateur de l'IoT.
**Note**
Ce connecteur s'exécute en mode [sans isolation de conteneur](lambda-group-config.md#no-container-mode). Vous pouvez donc le déployer dans un AWS IoT Greengrass groupe exécuté dans un conteneur Docker.
Ce connecteur est disponible dans les versions suivantes.
| Version | ARN |
| --- | --- |
| 3 | `arn:aws:greengrass:{{region}}::/connectors/ModbusTCPConnector/versions/3` |
| 2 | `arn:aws:greengrass:{{region}}::/connectors/ModbusTCPConnector/versions/2` |
| 1 | `arn:aws:greengrass:{{region}}::/connectors/ModbusTCPConnector/versions/1` |
Pour obtenir des informations sur les changements apportés aux versions, veuillez consulter le [Journal des modifications](#modbus-tcp-connector-changelog).
## Exigences
Ce connecteur possède les critères suivants :
------
#### [ Version 1 - 3 ]
+ AWS IoT Greengrass Logiciel de base v1.10.2 ou version ultérieure.
+ Le gestionnaire de flux est activé sur le AWS IoT Greengrass groupe.
+ Java 8 installé sur le périphérique principal et ajouté à la variable d'`PATH`environnement.
**Note**
Ce connecteur est uniquement disponible dans les régions suivantes :
ap-southeast-1
ap-southeast-2
eu-central-1
eu-west-1
us-east-1
us-west-2
cn-north-1
------
## Paramètres du connecteur
Ce connecteur prend en charge les paramètres suivants :
`LocalStoragePath`
Le répertoire de l' AWS IoT Greengrass hôte dans lequel le SiteWise connecteur IoT peut écrire des données persistantes. Le répertoire par défaut est `/var/sitewise`.
Nom affiché dans la AWS IoT console : **chemin de stockage local**
Nécessaire : `false`
Type : `string`
Schéma valide : `^\s*$|\/.`
`MaximumBufferSize`
Taille maximale en Go pour l'utilisation des SiteWise disques IoT. La taille par défaut est de 10 Go.
Nom affiché dans la AWS IoT console : **taille maximale de la mémoire tampon du disque**
Nécessaire : `false`
Type : `string`
Schéma valide : `^\s*$|[0-9]+`
`CapabilityConfiguration`
Ensemble de configurations de collecteurs Modbus TCP à partir desquelles le connecteur collecte les données et auxquelles il se connecte.
Afficher le nom dans la AWS IoT console : **CapabilityConfiguration**
Nécessaire : `false`
Type : chaîne JSON bien formée qui définit l'ensemble des configurations de feedback prises en charge.
Voici un exemple de `CapabilityConfiguration` :
```
{
"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 d'un connecteur (AWS CLI)
La commande CLI suivante crée un `ConnectorDefinition` avec une version initiale contenant 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 a un cycle de [vie](lambda-functions.md#lambda-lifecycle) prolongé.
## 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 sur`StreamManager`. 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 composants tiers suivants software/licensing :
+ [Modbus Petri numérique](https://github.com/digitalpetri/modbus)
Ce connecteur est publié dans le cadre du contrat de [licence logicielle Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).
## Journal des modifications
Le tableau suivant décrit les modifications apportées à chaque version du connecteur.
| Version | Modifications | Date |
| --- | --- | --- |
| 3 (recommandé) | Cette version contient des corrections de bogues. | 22 décembre 2021 |
| 2 | Ajout de la prise en charge des chaînes sources codées en ASCII, UTF8 et ISO8859. | 24 mai 2021 |
| 1 | Première version. | 15 décembre 2020 |
Un groupe Greengrass ne peut contenir qu'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](connectors.md#upgrade-connector-versions).
## Consultez aussi
+ [Intégrer à des services et protocoles à l'aide de connecteurs Greengrass](connectors.md)
+ [Mise en route avec les connecteurs Greengrass (console)](connectors-console.md)
+ [Démarrage avec les connecteurs Greengrass (CLI)](connectors-cli.md)