Arduino UNO Q - Capteur Ultrasonique Contrôle la LED
Dans ce tutoriel, vous apprendrez à utiliser un capteur ultrasonique pour contrôler une LED en fonction de la distance d'un objet :
- Lorsqu'un objet est proche du capteur, la LED s'allume.
- Lorsque l'objet s'éloigne, la LED s'éteint.
Matériel Requis
Ou vous pouvez acheter les kits suivants:
| 1 | × | Kit de Capteurs DIYables (18 capteurs/écrans) |
Divulgation : Certains des liens fournis dans cette section sont des liens affiliés Amazon. Nous pouvons recevoir une commission pour tout achat effectué via ces liens, sans coût supplémentaire pour vous. Nous vous remercions de votre soutien.
Note d'achat: Pour simplifier le processus de câblage, nous recommandons d'utiliser le LED Module, qui est livré avec une résistance intégrée.
À Propos de la LED et du Capteur Ultrasonique
Apprenez-en plus sur la LED et les capteurs ultrasoniques dans les tutoriels ci-dessous :
Schéma de Câblage
Cette image a été créée avec Fritzing. Cliquez pour agrandir l'image.
Code MCU
L'Arduino UNO Q dispose 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.
/*
* Ce code Arduino UNO Q a été développé par newbiely.fr
* Ce code Arduino UNO Q est mis à disposition du public sans aucune restriction.
* Pour des instructions complètes et des schémas de câblage, veuillez visiter:
* https://newbiely.fr/tutorials/arduino-uno-q/arduino-uno-q-ultrasonic-sensor-led
*/
#define TRIG_PIN 8 // The Arduino UNO Q pin connected to the ultrasonic sensor's TRIG pin
#define ECHO_PIN 7 // The Arduino UNO Q pin connected to the ultrasonic sensor's ECHO pin
#define LED_PIN 3 // The Arduino UNO Q pin connected to the LED's pin
#define DISTANCE_THRESHOLD 50 // centimeters
float duration_us, distance_cm;
void setup() {
pinMode(TRIG_PIN, OUTPUT);
pinMode(ECHO_PIN, INPUT);
pinMode(LED_PIN, OUTPUT);
}
void loop() {
// generate 10-microsecond pulse to TRIG pin
digitalWrite(TRIG_PIN, HIGH);
delayMicroseconds(10);
digitalWrite(TRIG_PIN, LOW);
// measure duration of pulse from ECHO pin
duration_us = pulseIn(ECHO_PIN, HIGH);
// calculate the distance
distance_cm = 0.017 * duration_us;
if (distance_cm < DISTANCE_THRESHOLD)
digitalWrite(LED_PIN, HIGH); // turn on LED
else
digitalWrite(LED_PIN, LOW); // turn off LED
delay(500);
}
Étapes Rapides
- Première utilisation de l'Arduino UNO Q ? Suivez le tutoriel Démarrer avec Arduino UNO Q pour préparer votre environnement de développement avant de continuer.
- Câblez les composants : Connectez TRIG → broche 8, ECHO → broche 7, LED (avec résistance 220 Ω) → broche 3.
- Connectez : Branchez l'Arduino UNO Q à votre ordinateur avec un câble USB-C.
- Ouvrez Arduino App Lab : Lancez Arduino App Lab et attendez qu'il détecte votre Arduino UNO Q.
- Créez une nouvelle application : Cliquez sur le bouton Créer une nouvelle application.
- Donnez un nom à l'application, par exemple : DIYables_UltrasonicLED
- Cliquez sur Créer pour confirmer.
- Vous verrez un ensemble de dossiers et fichiers générés dans votre nouvelle application.
- Trouvez le fichier sketch/sketch.ino — c'est là que vous collerez le code MCU.
Collez le code : Copiez le code MCU ci-dessus et collez-le dans le fichier sketch. Gardez les autres fichiers par défaut.
- 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.
Bricks
No bricks added...
Sketch Libraries
No sketch libra...
Files
python
sketch
.gitignore
README.md
app.yaml
sketch.ino
- Téléversez : Cliquez sur le bouton Exécuter dans Arduino App Lab pour compiler et téléverser vers le STM32.
- Testez : Approchez votre main du capteur — la LED s'allume lorsque vous passez à moins de 50 cm.
※ Note:
Ce code est à des fins pédagogiques. Le capteur ultrasonique est sensible au bruit. Pour une utilisation en production, appliquez le filtre anti-bruit du tutoriel Capteur Ultrasonique.
Programmation Bridge Linux + MCU
L'Arduino UNO Q dispose 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 via RPC grâce à la bibliothèque Arduino_RouterBridge — jamais via des ports série bruts.
- Le capteur ultrasonique et la LED sont connectés au MCU (STM32) — TRIG sur la broche 8, ECHO sur la broche 7, LED sur la broche 3.
- Le MPU ne peut pas les contrôler directement — il appelle Bridge.call("check_distance") sur le MCU, qui mesure la distance et active la LED en conséquence.
- Le MPU dispose du Wi-Fi — car le MPU exécute Debian Linux complet avec Wi-Fi, il peut utiliser Telegram et boucler la vérification automatiquement.
- Communication : Bridge.call() du côté Linux invoque Bridge.provide_safe() du côté MCU (car digitalWrite() est une API matérielle)
- ⚠️ Réservé : /dev/ttyHS1 (Linux) et Serial1 (MCU) sont utilisés par l'Arduino Router — ne les ouvrez jamais directement
En résumé : Python appelle la vérification → le MCU mesure la distance → le MCU active la LED et affiche sur le Monitor.
Code MCU — contrôle LED capteur ultrasonique avec Bridge et sortie Monitor :
/*
* Ce code Arduino UNO Q a été développé par newbiely.fr
* Ce code Arduino UNO Q est mis à disposition du public sans aucune restriction.
* Pour des instructions complètes et des schémas de câblage, veuillez visiter:
* https://newbiely.fr/tutorials/arduino-uno-q/arduino-uno-q-ultrasonic-sensor-led
*/
#include "Arduino_RouterBridge.h"
#define TRIG_PIN 8
#define ECHO_PIN 7
#define LED_PIN 3
#define DISTANCE_THRESHOLD 50
void check_distance() {
digitalWrite(TRIG_PIN, HIGH);
delayMicroseconds(10);
digitalWrite(TRIG_PIN, LOW);
float duration_us = pulseIn(ECHO_PIN, HIGH);
float distance_cm = 0.017 * duration_us;
bool led_on = distance_cm < DISTANCE_THRESHOLD;
digitalWrite(LED_PIN, led_on ? HIGH : LOW);
Monitor.print("Distance: ");
Monitor.print(distance_cm);
Monitor.print(" cm -> LED: ");
Monitor.println(led_on ? "ON" : "OFF");
}
void setup() {
Bridge.begin();
Monitor.begin();
pinMode(TRIG_PIN, OUTPUT);
pinMode(ECHO_PIN, INPUT);
pinMode(LED_PIN, OUTPUT);
digitalWrite(LED_PIN, LOW);
Bridge.provide_safe("check_distance", check_distance);
Monitor.println("Ultrasonic Sensor LED Bridge ready");
}
void loop() {}
Script Python (Arduino App Lab) — lancer la boucle de vérification de distance depuis Linux :
/*
* Ce code Arduino UNO Q a été développé par newbiely.fr
* Ce code Arduino UNO Q est mis à disposition du public sans aucune restriction.
* Pour des instructions complètes et des schémas de câblage, veuillez visiter:
* https://newbiely.fr/tutorials/arduino-uno-q/arduino-uno-q-ultrasonic-sensor-led
*/
from arduino.app_utils import *
import time
def loop():
Bridge.call("check_distance")
time.sleep(0.5)
App.run(user_loop=loop)
- 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 du côté Linux.
- ⚠️ Avertissement : N'ouvrez jamais directement /dev/ttyHS1 (sous Linux) ni n'utilisez Serial1 (sur MCU) dans votre code — ils sont réservés par l'Arduino Router et y accéder brisera le Bridge.
Étapes Rapides
- Téléversez 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 Exécuter.
- Ajoutez le script Python : Collez le code Python ci-dessus dans l'onglet Python de la même application.
- Exécutez l'application : Cliquez sur Exécuter — Python appelle check_distance toutes les 500 ms ; le MCU mesure la distance et contrôle la LED.
- Vérifiez la console : Ouvrez l'onglet Console → sous-onglet MCU Monitor pour voir la distance et l'état de la LED.
Sortie Console App Lab
sketch.ino
1#include "Arduino_RouterBridge.h"
Serial Monitor
Python
Ultrasonic Sensor LED Bridge ready
Distance: 65.2 cm -> LED: OFF
Distance: 32.1 cm -> LED: ON
Distance: 14.3 cm -> LED: ON
Distance: 78.9 cm -> LED: OFF
Intégration Telegram
Surveillez le capteur ultrasonique et l'état de la LED à distance via Telegram.
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é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 la surveillance ultrasonique LED :
/*
* Ce code Arduino UNO Q a été développé par newbiely.fr
* Ce code Arduino UNO Q est mis à disposition du public sans aucune restriction.
* Pour des instructions complètes et des schémas de câblage, veuillez visiter:
* https://newbiely.fr/tutorials/arduino-uno-q/arduino-uno-q-ultrasonic-sensor-led
*/
from arduino.app_utils import *
import requests
import time
BOT_TOKEN = "YOUR_BOT_TOKEN"
API_URL = f"https://api.telegram.org/bot{BOT_TOKEN}"
last_update_id = 0
def send_message(chat_id, text):
requests.post(f"{API_URL}/sendMessage", json={"chat_id": chat_id, "text": text})
def get_updates():
global last_update_id
resp = requests.get(f"{API_URL}/getUpdates", params={"offset": last_update_id + 1, "timeout": 5})
return resp.json().get("result", [])
def loop():
global last_update_id
Bridge.call("check_distance") # continuously control LED based on distance
updates = get_updates()
for update in updates:
last_update_id = update["update_id"]
msg = update.get("message", {})
chat_id = msg.get("chat", {}).get("id")
text = msg.get("text", "").strip()
if text == "/read":
status = Bridge.call("check_distance")
send_message(chat_id, status)
else:
send_message(chat_id, "Commands:\n/read — check distance and LED state")
time.sleep(0.5)
App.run(user_loop=loop)
- Remarque : Remplacez YOUR_BOT_TOKEN par le token obtenu auprès de @BotFather sur Telegram.
- Le bot vérifie continuellement la distance et contrôle la LED tout en écoutant les commandes Telegram.
- Envoyez /read pour demander la confirmation que l'état a été enregistré dans le MCU Monitor.
Étapes Rapides
- Téléversez le sketch MCU : Utilisez le sketch MCU Bridge de la section précédente (téléversez-le d'abord si ce n'est pas déjà fait).
- Collez le script Telegram : Copiez le code Python ci-dessus dans l'onglet Python de votre application dans Arduino App Lab.
- Configurez votre token : Remplacez YOUR_BOT_TOKEN dans le script par votre vrai token de bot.
- Exécutez l'application : Cliquez sur Exécuter — le bot commence à contrôler la LED et à écouter les messages Telegram.
- Testez : Envoyez /read — le bot répond avec la distance actuelle et l'état de la LED.
Sortie Console App Lab
sketch.ino
1#include "Arduino_RouterBridge.h"
Serial Monitor
Python
[2026-04-29 12:00:01] Telegram: /read
[2026-04-29 12:00:01] Distance: 29.4 cm -> LED: ON
Telegram
12:45
Welcome to Telegram!
ArduinoBot
10:19
Chatting with Arduino...
BotFather
Yesterday
Your bot has been created.
ArduinoBot
bot
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
- Lumière d'avertissement de proximité : Faire clignoter une LED lorsqu'un objet se rapproche (combiner avec des seuils de distance)
- Veilleuse automatique : Allumer une LED lorsque quelqu'un s'approche d'un capteur la nuit
- Indicateur d'obstacle : Utiliser la LED pour indiquer quand un robot est trop proche d'un mur
- Alerte de sécurité enfant : Fixer sur un tiroir ou une armoire — la LED s'allume lorsque quelqu'un y accède
- Déclencheur de luminosité d'affichage : Activer un rétroéclairage lorsqu'un utilisateur est détecté à proximité
Relevez le Défi
- Facile : Changez DISTANCE_THRESHOLD de 50 cm à 20 cm et observez la différence
- Moyen : Ajoutez plusieurs seuils — clignotement lent à 50 cm, clignotement rapide à 30 cm, allumage permanent à 15 cm
- Avancé : Envoyez la valeur réelle de la distance (en cm) directement à l'utilisateur Telegram sous forme de message