Arduino UNO Q - Le Potentiomètre Contrôle la Luminosité d'une LED
Ce tutoriel montre comment utiliser un potentiomètre pour contrôler la luminosité d'une LED avec Arduino UNO Q. En tournant le bouton du potentiomètre, la luminosité de la LED change en temps réel.
※ Note:
Différence ADC de l'Arduino UNO Q : Le MCU STM32 de l'Arduino UNO Q dispose d'un ADC 12 bits (valeurs 0–4095), et non 10 bits (0–1023). Mappez les valeurs ADC de 0–4095 vers une luminosité 0–255 lors de l'utilisation de analogWrite().
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 du Potentiomètre et de la LED
Si vous êtes nouveau avec le potentiomètre ou la LED, consultez d'abord ces tutoriels :
Schéma de Câblage
Cette image a été créée avec Fritzing. Cliquez pour agrandir l'image.
Comment Programmer
- Lire la valeur ADC depuis la broche A0 (12 bits sur Arduino UNO Q, 0–4095) :
int adc_value = analogRead(A0);
- Mapper la valeur ADC vers la luminosité PWM (0–255) :
int brightness = map(adc_value, 0, 4095, 0, 255);
- Écrire la luminosité sur la broche LED via PWM :
analogWrite(LED_PIN, brightness);
Code MCU — Le Potentiomètre Contrôle la Luminosité d'une LED
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.
/*
* 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-potentiometer-fade-led
*/
#define LED_PIN 3 // pin connected to LED
#define POTENTIOMETER_PIN A0 // pin connected to potentiometer
void setup() {
pinMode(LED_PIN, OUTPUT);
}
void loop() {
// Read ADC value from potentiometer (12-bit: 0-4095 on Arduino UNO Q)
int adc_value = analogRead(POTENTIOMETER_PIN);
// Map ADC value to brightness (0-255 for PWM)
int brightness = map(adc_value, 0, 4095, 0, 255);
// Set LED brightness
analogWrite(LED_PIN, brightness);
delay(100);
}
É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 la sortie du potentiomètre à A0, GND à GND, VCC à 3,3V. Connectez la LED (avec résistance 220 Ω) à la broche 3 selon le schéma de câblage.
- 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_PotLED
- 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.
Coller le sketch : Copiez le code MCU ci-dessus et collez-le dans le fichier sketch. Laissez 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éverser : Cliquez sur le bouton Run dans Arduino App Lab pour compiler et téléverser vers le STM32.
- Tourner le bouton du potentiomètre — la luminosité de la LED devrait changer progressivement en temps réel.
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 potentiomètre et la LED sont connectés au MCU (STM32) — la sortie du potentiomètre est câblée à la broche analogique A0 et la LED à une broche de sortie capable de PWM. Le MCU lit continuellement les valeurs ADC et met à jour la luminosité de la LED dans loop().
- Le MPU ne peut pas lire le potentiomètre ou contrôler la LED directement — il doit demander la luminosité actuelle au MCU via Bridge.call().
- Le MPU dispose du Wi-Fi — parce que le MPU exécute Debian Linux complet avec Wi-Fi, il peut signaler le niveau de luminosité via Telegram à la demande.
- Communication : Bridge.call() côté Linux invoque les fonctions Bridge.provide() côté MCU
- ⚠️ 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 demande la luminosité → le MCU lit l'ADC et convertit → le MCU rapporte les valeurs ADC et luminosité → le MPU enregistre ou transmet.
Sketch MCU — potentiomètre-LED 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-potentiometer-fade-led
*/
#include "Arduino_RouterBridge.h"
#define LED_PIN 3
#define POTENTIOMETER_PIN A0
void get_brightness() {
int adc_value = analogRead(POTENTIOMETER_PIN);
int brightness = map(adc_value, 0, 4095, 0, 255);
Monitor.print("ADC: ");
Monitor.print(adc_value);
Monitor.print(", Brightness: ");
Monitor.println(brightness);
}
void setup() {
pinMode(LED_PIN, OUTPUT);
Bridge.begin();
Monitor.begin();
Bridge.provide("get_brightness", get_brightness);
Monitor.println("Potentiometer-LED Bridge ready");
}
void loop() {
int adc_value = analogRead(POTENTIOMETER_PIN);
int brightness = map(adc_value, 0, 4095, 0, 255);
analogWrite(LED_PIN, brightness);
delay(50);
}
Script Python (Arduino App Lab) — interroger la luminosité 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-potentiometer-fade-led
*/
from arduino.app_utils import *
import time
def loop():
while True:
Bridge.call("get_brightness")
time.sleep(1)
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 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 ci-dessus 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 — le côté Python interroge le niveau de luminosité chaque seconde.
- Tourner le bouton du potentiomètre et observez la LED s'allumer et s'assombrir.
- Vérifier la console : Ouvrez l'onglet Console → le sous-onglet MCU Monitor pour voir les valeurs ADC et luminosité enregistrées.
Sortie Console d'App Lab
sketch.ino
1#include "Arduino_RouterBridge.h"
Serial Monitor
Python
Potentiometer-LED Bridge ready
ADC: 0, Brightness: 0
ADC: 820, Brightness: 51
ADC: 2048, Brightness: 127
ADC: 3275, Brightness: 204
ADC: 4095, Brightness: 255
Intégration Telegram
Vérifiez le niveau de luminosité actuel à distance depuis n'importe où 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'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 le niveau de luminosité :
/*
* 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-potentiometer-fade-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
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 == "/brightness":
reading = Bridge.call("get_brightness")
send_message(chat_id, reading)
else:
send_message(chat_id, "Commands:\n/brightness — read current LED brightness level (ADC and PWM value)")
time.sleep(1)
App.run(user_loop=loop)
- Remarque : Remplacez YOUR_BOT_TOKEN par le token obtenu depuis @BotFather sur Telegram.
- Envoyez /brightness pour vérifier les valeurs ADC et luminosité actuelles.
É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 : Tournez le potentiomètre, envoyez /brightness — le bot répond avec la valeur ADC et la luminosité PWM.
Sortie Console d'App Lab
sketch.ino
1#include "Arduino_RouterBridge.h"
Serial Monitor
Python
[2026-04-29 12:00:01] Telegram: /brightness
[2026-04-29 12:00:01] ADC: 1234, Brightness: 77
[2026-04-29 12:03:20] Telegram: /brightness
[2026-04-29 12:03:20] ADC: 3072, Brightness: 191
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
- Gradateur intelligent : Utilisez un potentiomètre comme contrôle de luminosité physique pour une lumière — surveillez le niveau via Telegram
- Indicateur de volume : Affichez le "niveau de volume" actuel mappé depuis le potentiomètre sur un moniteur distant
- Contrôleur de lumière ambiante : Liez la position du potentiomètre à la luminosité d'un ruban LED blanc chaud
- Panneau de dérogation manuelle : Utilisez le potentiomètre pour déroger manuellement à un calendrier de luminosité automatisé
- Cadran de retour visuel : Mappez le potentiomètre à un tableau de LED qui affiche la progression ou le niveau
Défiez-Vous
- Facile : Ajoutez une deuxième LED qui varie en sens inverse (quand LED 1 est lumineuse, LED 2 est sombre)
- Moyen : Exposez la valeur ADC et le pourcentage (0–100) via des callbacks Bridge séparés
- Avancé : Créez un bot Telegram qui enregistre les lectures de luminosité à intervalle fixe et envoie un résumé quotidien