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.
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 GPIO Raspberry Pi
Avertissement
Ce connecteur est passé à la phase de durée de vie prolongée et AWS IoT Greengrass ne publiera pas de mises à jour fournissant des fonctionnalités, des améliorations aux fonctionnalités existantes, des correctifs de sécurité ou des corrections de bogues. Pour de plus amples informations, veuillez consulter AWS IoT Greengrass Version 1 politique de maintenance.
Le connecteur GPIO du Raspberry Pi contrôle les broches d'entrée/sortie à usage général (GPIO) d'un périphérique principal du Raspberry Pi.
Ce connecteur interroge les broches d'entrée à un intervalle spécifié et publie les changements d'état dans des rubriques MQTT. Il accepte également les demandes de lecture et d'écriture sous forme de messages MQTT provenant de fonctions Lambda définies par l'utilisateur. Les demandes d'écriture sont utilisées pour régler la broche sur haute ou basse tension.
Le connecteur fournit des paramètres que vous utilisez pour désigner des broches d'entrée et de sortie. Ce comportement est configuré avant le déploiement de groupe. Il ne peut pas être modifié au moment de l'exécution.
Les broches d'entrée peuvent être utilisées pour recevoir des données à partir des appareils périphériques.
Les broches de sortie peuvent être utilisées pour contrôler les périphériques ou envoyer des données aux périphériques.
Vous pouvez utiliser ce connecteur pour de nombreux scénarios, tels que :
contrôler des feux vert, orange et rouge d'un feu de circulation.
contrôler un ventilateur (relié à un relais électrique) basé sur les données provenant d'un capteur d'humidité.
alerter des employés dans un magasin lorsque les clients appuient sur un bouton.
utiliser un commutateur de lumière intelligent pour contrôler d'autres appareils IoT.
Note
Ce connecteur n'est pas adapté aux applications qui ont des besoins en temps réel. Des événements de courte durée peuvent être manqués.
Ce connecteur est disponible dans 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 :
Séquence de broches GPIO
Le connecteur GPIO du Raspberry Pi référence les broches GPIO selon le schéma de numérotation du système sur puce (SoC) sous-jacent, et non selon la disposition physique des broches GPIO. L'ordre physique des broches peut varier dans les versions du Raspberry Pi. Pour plus d'informations, consultez la section GPIO
Le connecteur ne peut pas valider que les broches d'entrée et de sortie que vous configurez se mappent correctement au matériel sous-jacent de votre Raspberry Pi. Si la configuration de broche n'est pas valide, le connecteur renvoie une erreur d'exécution lorsqu'il essaie de démarrer sur le périphérique. Pour résoudre ce problème, reconfigurez le connecteur puis redéployez.
Note
Assurez-vous que les périphériques des broches GPIO sont correctement connectés pour empêcher les dommages des composants.
Paramètres du connecteur
Ce connecteur fournit les paramètres suivants :
InputGpios-
Une liste séparée par des virgules de numéros de broches GPIO à configurer en tant qu'entrées. Vous pouvez également ajouter
Upour définir une résistance de tirage de la broche ouDpour définir la résistance de rappel. Exemple:"5,6U,7D".Nom affiché dans la AWS IoT console : broches GPIO d'entrée
Obligatoire :
false. Vous devez spécifier les broches d'entrée, de sortie ou les deux.Type :
stringSchéma valide :
^$|^[0-9]+[UD]?(,[0-9]+[UD]?)*$ InputPollPeriod-
Intervalle (en millisecondes) entre chaque opération d'interrogation, qui vérifie les broches GPIO d'entrée pour les changements d'état. La valeur minimale est de 1.
Cette valeur dépend de votre scénario et des types d'appareils qui sont interrogés. Par exemple, une valeur
50doit être suffisamment rapide pour détecter une pression de bouton.Nom affiché dans la AWS IoT console : Période d'interrogation GPIO d'entrée
Nécessaire :
falseType :
stringSchéma valide :
^$|^[1-9][0-9]*$ OutputGpios-
Une liste séparée par des virgules de nombres de broches GPIO à configurer en tant que sorties. Vous pouvez ajouter
Hpour régler sur un état haut (1) ouLpour régler sur un état faible (0). Exemple:"8H,9,27L".Nom affiché dans la AWS IoT console : broches GPIO de sortie
Obligatoire :
false. Vous devez spécifier les broches d'entrée, de sortie ou les deux.Type :
stringSchéma valide :
^$|^[0-9]+[HL]?(,[0-9]+[HL]?)*$ GpioMem-ResourceId-
ID de la ressource de l'appareil local qui représente
/dev/gpiomem.Note
Ce connecteur bénéficie d'un accès en lecture/écriture à la ressource.
Nom d'affichage dans la AWS IoT console : Ressource for /dev/gpiomem device
Nécessaire :
trueType :
stringSchéma valide :
.+
Exemple de création de connecteur (AWS CLI)
La commande CLI suivante crée un ConnectorDefinition avec une version initiale contenant le connecteur Raspberry Pi GPIO.
aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{ "Connectors": [ { "Id": "MyRaspberryPiGPIOConnector", "ConnectorArn": "arn:aws:greengrass:region::/connectors/RaspberryPiGPIO/versions/3", "Parameters": { "GpioMem-ResourceId": "my-gpio-resource", "InputGpios": "5,6U,7D", "InputPollPeriod": 50, "OutputGpios": "8H,9,27L" } } ] }'
Note
La fonction Lambda de ce connecteur a un cycle de vie prolongé.
Dans la AWS IoT Greengrass console, vous pouvez ajouter un connecteur depuis la page Connecteurs du groupe. Pour de plus amples informations, veuillez consulter Mise en route avec les connecteurs Greengrass (console).
Données d'entrée
Ce connecteur accepte les demandes de lecture ou d'écriture pour les broches GPIO sur deux rubriques MQTT.
-
Lire les demandes dans la rubrique
gpio/+/+/read. -
Écrire les demandes dans la rubrique
gpio/+/+/write.
Pour publier dans ces rubriques, remplacez respectivement les caractères génériques + par le nom d'objet principal et le nombre de broches cibles. Par exemple :
gpio/core-thing-name/gpio-number/read
Note
Actuellement, lorsque vous créez un abonnement qui utilise le connecteur GPIO du Raspberry Pi, vous devez spécifier une valeur pour au moins l'un des caractères génériques + de la rubrique.
- Filtre de rubriques :
gpio/+/+/read -
Utilisez cette rubrique pour demander au connecteur de lire l'état de la broche GPIO spécifiée dans la rubrique.
Le connecteur publie la réponse dans la rubrique de sortie correspondante (par exemple,
gpio/).core-thing-name/gpio-number/state- Propriétés des messages
-
Aucune. Les messages qui sont envoyés dans cette rubrique sont ignorés.
- Filtre de rubriques :
gpio/+/+/write -
Utilisez cette rubrique pour envoyer des demandes d'écriture à une broche GPIO. Cela demande au connecteur de régler la broche GPIO spécifiée dans la rubrique sur faible ou haute tension.
0règle la broche sur faible tension.1règle la broche sur haute tension.
Le connecteur publie la réponse dans la rubrique
/statede sortie correspondante (par exemple,gpio/).core-thing-name/gpio-number/state- Propriétés des messages
-
Valeur
0ou1, sous forme d'un nombre entier ou d'une chaîne. - Exemple d'entrée
-
0
Données de sortie
Ce connecteur publie des données dans deux rubriques :
-
Changements d'états hauts ou faibles dans la rubrique
gpio/+/+/state. -
Erreurs dans la rubrique
gpio/+/error.
- Filtre de rubriques :
gpio/+/+/state -
Utilisez cette rubrique pour écouter les changements d'état sur les broches d'entrée et les réponses pour les demandes de lecture. Le connecteur renvoie la chaîne
"0"si la broche est dans un état faible ou"1"s'il est dans un état haut.Lorsqu'il publie dans cette rubrique, le connecteur remplace respectivement les caractères génériques
+par le nom d'objet principal et la broche cible. Par exemple :gpio/core-thing-name/gpio-number/stateNote
Actuellement, lorsque vous créez un abonnement qui utilise le connecteur GPIO du Raspberry Pi, vous devez spécifier une valeur pour au moins l'un des caractères génériques + de la rubrique.
- Exemple de sortie
-
0
- Filtre de rubriques :
gpio/+/error -
Utilisez cette rubrique pour écouter les erreurs. Le connecteur publie dans cette rubrique suite à une demande non valide (par exemple, lorsqu'un changement d'état est demandé sur une broche d'entrée).
Lorsqu'il publie dans cette rubrique, le connecteur remplace respectivement le caractère générique
+par le nom d'objet principal.- Exemple de sortie
-
{ "topic": "gpio/my-core-thing/22/write", "error": "Invalid GPIO operation", "long_description": "GPIO 22 is configured as an INPUT GPIO. Write operations are not permitted." }
Exemple d'utilisation
Suivez les étapes de haut niveau suivantes pour configurer un exemple de fonction Lambda en Python 3.7 que vous pouvez utiliser pour tester le connecteur.
Note
-
Si vous utilisez d'autres environnements d'exécution Python, vous pouvez créer un lien symbolique entre Python3.x et Python 3.7.
-
Les rubriques Démarrer avec les connecteurs (console) et Démarrer avec les connecteurs (CLI) contiennent des étapes détaillées qui vous montrent comment configurer et déployer un exemple de connecteur Twilio Notifications.
Veillez à répondre aux conditions requises pour le connecteur.
-
Créez et publiez une fonction Lambda qui envoie des données d'entrée au connecteur.
Enregistrez l'exemple de code en tant que fichier PY. Téléchargez et décompressez le SDK AWS IoT Greengrass de base pour Python. Ensuite, créez un package zip contenant le fichier PY et le dossier
greengrasssdkau niveau racine. Ce package zip est le package de déploiement vers lequel vous effectuez le téléchargement AWS Lambda.Après avoir créé la fonction Lambda de Python 3.7, publiez une version de la fonction et créez un alias.
-
Configurez votre groupe Greengrass.
-
Ajoutez la fonction Lambda par son alias (recommandé). Configurez le cycle de vie Lambda comme étant de longue durée (ou dans
"Pinned": truela CLI). -
Ajoutez la ressource de périphérique locale requise et accordez un accès en lecture/écriture à la fonction Lambda.
-
Ajoutez le connecteur et configurez ses paramètres.
-
Ajoutez des abonnements qui permettent au connecteur de recevoir des données d'entrée et d'envoyer des données de sortie sur des filtres de rubrique pris en charge.
Définissez la fonction Lambda comme source, le connecteur comme cible et utilisez un filtre de rubrique d'entrée compatible.
Définissez le connecteur en tant que source, AWS IoT Core en tant que cible et utilisez un filtre de rubrique de sortie pris en charge. Vous utilisez cet abonnement pour afficher les messages d'état dans la AWS IoT console.
-
-
Déployez le groupe.
-
Dans la AWS IoT console, sur la page Test, abonnez-vous à la rubrique des données de sortie pour consulter les messages d'état du connecteur. L'exemple de fonction Lambda a une longue durée de vie et commence à envoyer des messages immédiatement après le déploiement du groupe.
Lorsque vous avez terminé les tests, vous pouvez définir le cycle de vie Lambda à la demande (ou
"Pinned": falsedans la CLI) et déployer le groupe. Cela empêche la fonction d'envoyer des messages.
exemple
L'exemple suivant de fonction Lambda envoie un message d'entrée au connecteur. Cet exemple envoie des demandes de lecture pour un ensemble de pins GPIO d'entrée. Il indique comment construire des rubriques à l'aide du nom de l'objet principale et du nombre de broches.
import greengrasssdk import json import os iot_client = greengrasssdk.client('iot-data') INPUT_GPIOS = [6, 17, 22] thingName = os.environ['AWS_IOT_THING_NAME'] def get_read_topic(gpio_num): return '/'.join(['gpio', thingName, str(gpio_num), 'read']) def get_write_topic(gpio_num): return '/'.join(['gpio', thingName, str(gpio_num), 'write']) def send_message_to_connector(topic, message=''): iot_client.publish(topic=topic, payload=str(message)) def set_gpio_state(gpio, state): send_message_to_connector(get_write_topic(gpio), str(state)) def read_gpio_state(gpio): send_message_to_connector(get_read_topic(gpio)) def publish_basic_message(): for i in INPUT_GPIOS: read_gpio_state(i) publish_basic_message() def lambda_handler(event, context): return
Licences
Le connecteur Raspberry Pi GPIO ; inclut les logiciels/licences tiers suivants :
Ce connecteur est publié dans le cadre du contrat de licence logicielle Greengrass Core
Journal des modifications
Le tableau suivant décrit les modifications apportées à chaque version du connecteur.
Version |
Modifications |
|---|---|
3 |
Mise à niveau de l'environnement d'exécution Lambda vers Python 3.7, ce qui modifie les exigences d'exécution. |
2 |
L'ARN du connecteur a été mis à jour pour Région AWS le support. |
1 |
Première version. |
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.