Arduino UNO Q - Relais
Ce tutoriel vous montre comment utiliser un relais avec Arduino UNO Q pour contrôler des appareils fonctionnant sous haute tension ou fort courant, tels que des rubans LED, des ventilateurs, des ampoules, des serrures électromagnétiques et des actionneurs linéaires. Vous apprendrez :
- Comment fonctionne un relais
- Comment connecter un relais à un appareil haute tension
- Comment connecter Arduino UNO Q au relais
- Comment contrôler le relais depuis Linux via le Bridge
- Comment contrôler le relais à distance via Telegram

WARNING
Lorsque vous travaillez sur des projets connectés au secteur électrique, il est essentiel d'avoir les connaissances appropriées pour éviter les chocs électriques. La sécurité est très importante. Si vous n'êtes pas complètement sûr de ce que vous faites, veuillez ne pas tenter de le faire. Cherchez plutôt l'aide d'une personne expérimentée.
Nous recommandons d'utiliser un appareil DC (jusqu'à 24V) pour les tests, même si certains relais peuvent fonctionner avec des appareils DC et AC.
Matériel Requis
Ou vous pouvez acheter les kits suivants:
| 1 | × | Kit de Capteurs DIYables (18 capteurs/écrans) |
À Propos du Relais
Un relais est un interrupteur programmable contrôlé par un microcontrôleur (comme Arduino UNO Q). Il vous permet d'allumer ou d'éteindre automatiquement des appareils haute tension.
Brochage du Relais

Un relais a deux groupes de broches :
Groupe d'entrée (basse tension, se connecte à Arduino UNO Q) :
- Broche DC- : Connectez à GND (0V).
- Broche DC+ : Connectez à VCC (5V).
- Broche IN : Signal de contrôle depuis Arduino UNO Q.
Groupe de sortie (haute tension, se connecte à votre appareil) :
- Broche COM : Broche commune, utilisée en mode normalement ouvert et normalement fermé.
- Broche NO : Broche Normalement Ouverte — utilisée en mode normalement ouvert.
- Broche NC : Broche Normalement Fermée — utilisée en mode normalement fermé.
Comment Ça Fonctionne
Pour les débutants, utilisez le mode déclenchement par niveau HIGH + Normalement Ouvert (NO) :
- Quand la broche IN reçoit HIGH → le relais ferme le circuit COM–NO → l'appareil s'allume.
- Quand la broche IN reçoit LOW → le relais ouvre le circuit COM–NO → l'appareil s'éteint.
※ Note:
Différents fabricants peuvent disposer les broches du module relais différemment. Vérifiez toujours et suivez les étiquettes sur votre carte relais.
Comment Connecter l'Appareil Haute Tension

Schéma de Câblage

Cette image a été créée avec Fritzing. Cliquez pour agrandir l'image.
Code MCU
L'Arduino UNO Q possède deux processeurs : le MCU STM32 (gère le contrôle matériel en temps réel) et le MPU Qualcomm (exécute Debian Linux). Dans cette section, seul le MCU STM32 est programmé — le côté Linux reste inactif. Une section ultérieure montrera comment les deux processeurs fonctionnent ensemble.
Le code ci-dessous active et désactive le relais toutes les 500 ms :
Étapes Rapides
- Première fois avec Arduino UNO Q ? Suivez le tutoriel Démarrer avec Arduino UNO Q pour préparer votre environnement de développement avant de continuer.
- Câbler les composants : Connectez IN du relais → broche 9, DC+ → 5V, DC- → GND.
- Connecter : Branchez l'Arduino UNO Q à votre ordinateur avec un câble USB-C.
- Ouvrir Arduino App Lab : Lancez Arduino App Lab et attendez qu'il détecte votre Arduino UNO Q.
- Créer une nouvelle application : Cliquez sur le bouton Create New App.

- Donnez un nom à l'application, par exemple : DIYables_Relay
- Cliquez sur Create pour confirmer.
- Vous verrez un ensemble de dossiers et de fichiers générés dans votre nouvelle application.

- Trouvez le fichier sketch/sketch.ino — c'est là que vous collerez le sketch MCU.
- Install the library: Click the Add sketch library button (the open book icon with a + sign) in the left sidebar.

- Search for Arduino_RouterBridge created by Arduino and click the Install button.
- Téléverser : Cliquez sur le bouton Run dans Arduino App Lab pour compiler et téléverser vers le STM32.

- Tester : Vous devriez entendre le relais cliquer toutes les 500 ms.
Programmation Bridge Linux + MCU
L'Arduino UNO Q possède deux processeurs qui fonctionnent ensemble : le MPU (Qualcomm, exécute Debian Linux) et le MCU (STM32, exécute Zephyr OS avec votre sketch Arduino). Ils communiquent en utilisant RPC via la bibliothèque Arduino_RouterBridge — jamais via des ports série bruts.
- Le relais est connecté au MCU (STM32) — IN du relais sur la broche 9.
- Le MPU ne peut pas contrôler le relais directement — il appelle Bridge.call("relay_on") ou Bridge.call("relay_off") sur le MCU, qui règle la broche du relais en conséquence.
- Le MPU dispose du Wi-Fi — parce que le MPU exécute Debian Linux complet avec Wi-Fi, il peut accepter des commandes Telegram pour contrôler le relais à distance.
- Communication : Bridge.call() côté Linux invoque Bridge.provide_safe() côté MCU (car digitalWrite() est utilisé pour contrôler le relais)
- ⚠️ Réservé : /dev/ttyHS1 (Linux) et Serial1 (MCU) sont utilisés par l'Arduino Router — ne les ouvrez jamais directement
En résumé : Le MPU envoie une commande relais → le MCU règle la broche du relais → l'appareil s'allume/s'éteint.
Sketch MCU — contrôle du relais avec Bridge :
Script Python (Arduino App Lab) — basculer le relais on/off toutes les 0,5 secondes :
- Remarque : Assurez-vous que Bridge.begin() est appelé dans le sketch MCU et que le sketch est téléversé avant d'exécuter le script Python côté Linux.
- ⚠️ Avertissement : N'ouvrez jamais directement /dev/ttyHS1 (sur Linux) ou n'utilisez pas Serial1 (sur MCU) dans votre code — ils sont réservés par l'Arduino Router et y accéder cassera le Bridge.
Étapes Rapides
- Téléverser le sketch MCU : Ouvrez Arduino App Lab, créez une nouvelle application, collez le sketch MCU Bridge dans sketch/sketch.ino, installez la bibliothèque Arduino_RouterBridge, et cliquez sur Run.
- Ajouter le script Python : Collez le code Python ci-dessus dans l'onglet Python de la même application.
- Exécuter l'application : Cliquez sur Run — Python bascule le relais toutes les 500 ms.
- Vérifier la console : Ouvrez l'onglet Console → le sous-onglet MCU Monitor pour voir l'état du relais.
Sortie Console d'App Lab
Intégration Telegram
Contrôlez le relais à distance via Telegram avec les commandes /on et /off.
Si vous n'avez pas encore de bot Telegram, consultez Arduino UNO Q - Bot Telegram pour obtenir votre token de bot avant de continuer.
Sketch MCU : Conservez le même sketch MCU de la section Bridge précédente — aucune modification n'est nécessaire. Assurez-vous qu'il est déjà téléversé et en cours d'exécution sur le STM32 avant de continuer.
Script Python (Arduino App Lab) — bot Telegram pour contrôler le relais :
- Remarque : Remplacez YOUR_BOT_TOKEN par le token obtenu depuis @BotFather sur Telegram.
- Envoyez /on pour activer le relais ; /off pour le désactiver.
Étapes Rapides
- Téléverser le sketch MCU : Utilisez le sketch MCU Bridge de la section précédente (téléversez-le d'abord s'il ne l'est pas déjà).
- Coller le script Telegram : Copiez le code Python ci-dessus dans l'onglet Python de votre application dans Arduino App Lab.
- Définir votre token : Remplacez YOUR_BOT_TOKEN dans le script par votre vrai token de bot.
- Exécuter l'application : Cliquez sur Run — le bot commence à écouter les messages Telegram.
- Tester : Envoyez /on et /off pour contrôler le relais.
Sortie Console d'App Lab
ArduinoBot
Intégration d'OpenClaw
Vous pouvez adapter OpenClaw à ce tutoriel en vous référant aux instructions du tutoriel Arduino UNO Q - OpenClaw.
Idées d'Applications/Projets
- Contrôle d'appareils à distance : Allumez et éteignez lumières, ventilateurs ou chauffages via Telegram depuis n'importe où
- Commutation programmée : Utilisez le module datetime de Python pour allumer/éteindre des appareils à des heures spécifiques
- Système de sécurité : Déclenchez un relais de sirène ou d'alarme lorsque votre Raspberry Pi détecte un intrus
- Contrôle de pompe à eau : Allumez et éteignez une pompe à eau pour l'irrigation depuis votre téléphone
Défiez-Vous
- Facile : Changez l'intervalle de basculement de 500 ms à 2 secondes
- Moyen : Ajoutez une commande /toggle qui fait basculer le relais dans l'état opposé
- Avancé : Enregistrez chaque changement d'état du relais avec un horodatage dans un fichier sur le MPU