Démarrage rapide
À la fin de ce guide, vous aurez un module rbAmp qui lit tension et courant sur votre microcontrôleur, avec des valeurs transmises à Home Assistant (via ESPHome) ou à votre propre croquis Arduino.
Ce que vous obtiendrez en 15 minutes
Matériel nécessaire
- 1× module rbAmp (par ex. Basic UI1 avec pince CT SCT-013)
- 1× carte de développement ESP32 (ou Arduino Uno, ou Raspberry Pi)
- 4× fils de liaison (VCC, GND, SDA, SCL)
- 1× pince de courant SCT-013 — pour BASIC vous apportez la vôtre et sélectionnez son calibre en logiciel ; les modules STD sont livrés appairés en usine avec leurs capteurs
- Câble USB pour la programmation
Travailler sur la tension secteur est dangereux. Coupez toujours l'alimentation secteur avant d'installer des prises de tension. En cas de doute, faites appel à un électricien qualifié.
Câblage
Le brochage, la règle des pull-ups et les limites de longueur de câble sont regroupés en un seul endroit : Connexion matérielle. Raccordez VCC, GND, SDA et SCL comme indiqué là-bas, puis revenez au chemin dont vous avez besoin ci-dessous.
Choisissez votre parcours
:::choose-your-path
- ESPHome (Home Assistant) : Aller à la configuration ESPHome ↓
- IDE Arduino : Aller à la configuration Arduino ↓
- Raspberry Pi (Python) : Aller à la configuration RPi ↓ :::
Configuration ESPHome
Le composant ESPHome dispose de son propre démarrage rapide avec un YAML minimal, la commande de test et la sortie attendue : Démarrage rapide ESPHome. Pour le côté Home Assistant, voir Home Assistant.
Installation sur Arduino
Installation de la bibliothèque, premier croquis et ce que le moniteur série doit afficher : Démarrage rapide Arduino. Carte et câblage propres aux hôtes Arduino : Matériel Arduino.
Installation sur Raspberry Pi
Installation, premier script et sortie attendue : Bibliothèque Python — Vue d'ensemble, puis Exemples.
Vérification
Après la configuration, vous devriez voir :
- Tension : ~230 V (ou ~120 V selon la région)
- Courant : 0 A au départ (pas de charge sur la pince CT)
- Quand vous allumez un appareil connu (par ex. une lampe de 100 W) : le courant monte en pic à ~0.4 A
Étapes suivantes
- Consultez le guide de connexion matérielle pour une installation permanente
- Consultez la référence API pour le détail au niveau des registres
- Explorez les exemples de plateformes pour des intégrations réelles
Solutions rapides de dépannage
Si vous ne voyez que des zéros ou des erreurs NAK :
- Vérifiez le câblage I²C (SDA/SCL non inversés)
- Vérifier les pull-ups (4.7 kΩ sur SDA et SCL)
- Lancez un scanner I²C pour confirmer l'adresse
0x50
Pour un dépannage plus poussé, voir Dépannage.