Exemple de jauge analogique Bluetooth Arduino Nano ESP32 - Affichage de jauge via tutoriel BLE
Vue d'ensemble
Cet exemple montre un affichage de jauge de style analogique sur l'Arduino Nano ESP32 en utilisant le BLE (Bluetooth Low Energy) via l'application DIYables Bluetooth STEM. Affichez n'importe quelle valeur sur une jauge à cadran avec une plage et une unité configurables sur votre smartphone. Convient aux compteurs de vitesse, jauges de pression, affichages RPM et applications similaires.
Remarque : L'Arduino Nano ESP32 prend en charge le BLE uniquement — le Bluetooth Classique n'est pas pris en charge. L'application Bluetooth DIYables fonctionne sur Android et iOS avec le BLE.
Fonctionnalités
- Affichage de jauge analogique : Jauge à cadran sur votre smartphone
- Plage configurable : Définissez les valeurs minimales et maximales
- Unité personnalisée : Affichez km/h, RPM, PSI ou toute unité personnalisée
- Mises à jour rapides : Jusqu'à 5 mises à jour par seconde (intervalle de 200 ms)
- Requête à la demande : L'application peut demander la valeur actuelle à tout moment
- Support Android et iOS : Le BLE est compatible avec les deux plateformes
- Pas de couplage requis : Le BLE se connecte sans couplage manuel
Matériel nécessaire
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.
Code Arduino Nano ESP32
Étapes rapides
- Nouveau sur l'Arduino Nano ESP32 ? Commencez par le Installation du logiciel Arduino Nano ESP32..
- Connectez l'Arduino Nano ESP32 à votre ordinateur via USB.
- Ouvrez l'Arduino IDE.
- Sélectionnez la carte Arduino Nano ESP32 et le port COM correct.
- Cliquez sur l'icône Bibliothèques dans la barre latérale gauche.
- Recherchez "DIYables Bluetooth" et sélectionnez la bibliothèque Bluetooth DIYables par DIYables.
- Cliquez sur Installer.
- Lorsqu'on vous demande d'installer les dépendances, cliquez sur Tout installer.
Code BLE
- Dans l'Arduino IDE, ouvrez Fichier Exemples DIYables Bluetooth ArduinoBLE_AnalogGauge, ou collez le code dans l'éditeur.
/*
* DIYables Bluetooth Library - ESP32 BLE Analog Gauge Example
* Works with DIYables Bluetooth STEM app on Android and iOS
*
* This example demonstrates the Bluetooth Analog Gauge feature:
* - Display values on an analog meter/gauge
* - Configurable range and unit
* - Perfect for sensor monitoring (speed, pressure, voltage, etc.)
*
* Tutorial: https://diyables.io/bluetooth-app
* Author: DIYables
*/
#include <DIYables_BluetoothServer.h>
#include <DIYables_BluetoothAnalogGauge.h>
#include <platforms/DIYables_Esp32BLE.h>
// BLE Configuration
const char* DEVICE_NAME = "ESP32BLE_Gauge";
const char* SERVICE_UUID = "19B10000-E8F2-537E-4F6C-D104768A1214";
const char* TX_UUID = "19B10001-E8F2-537E-4F6C-D104768A1214";
const char* RX_UUID = "19B10002-E8F2-537E-4F6C-D104768A1214";
// Create Bluetooth instances
DIYables_Esp32BLE bluetooth(DEVICE_NAME, SERVICE_UUID, TX_UUID, RX_UUID);
DIYables_BluetoothServer bluetoothServer(bluetooth);
// Create Analog Gauge app instance (min=0, max=100, unit="km/h")
DIYables_BluetoothAnalogGauge bluetoothGauge(0.0, 100.0, "km/h");
// Variables for gauge value
float currentValue = 0.0;
unsigned long lastUpdate = 0;
const unsigned long UPDATE_INTERVAL = 200; // Update every 200ms
// Optional: Analog input pin for sensor
const int ANALOG_PIN = A0; // ESP32 ADC pin
// Function to read sensor value
float readSensorValue() {
// TODO: Replace with actual sensor reading
// Option 1: Read from analog pin and map to gauge range
// int rawValue = analogRead(ANALOG_PIN);
// return map(rawValue, 0, 4095, 0, 100); // ESP32 has 12-bit ADC
// Option 2: Simulated data (sine wave)
static float phase = 0;
phase += 0.05;
if (phase > 2 * PI) phase = 0;
return 50 + 50 * sin(phase); // Oscillates between 0-100
}
void setup() {
Serial.begin(115200);
delay(1000);
Serial.println("DIYables Bluetooth - ESP32 BLE Analog Gauge Example");
// Initialize Bluetooth server with platform-specific implementation
bluetoothServer.begin();
// Add gauge app to server
bluetoothServer.addApp(&bluetoothGauge);
// Set up connection event callbacks
bluetoothServer.setOnConnected([]() {
Serial.println("Bluetooth connected!");
currentValue = readSensorValue();
bluetoothGauge.send(currentValue);
Serial.print("Initial value sent: ");
Serial.print(currentValue);
Serial.print(" ");
Serial.println(bluetoothGauge.getUnit());
});
bluetoothServer.setOnDisconnected([]() {
Serial.println("Bluetooth disconnected!");
});
bluetoothGauge.onValueRequest([]() {
currentValue = readSensorValue();
bluetoothGauge.send(currentValue);
Serial.print("Value requested - Sent: ");
Serial.print(currentValue);
Serial.print(" ");
Serial.println(bluetoothGauge.getUnit());
});
Serial.println("Waiting for Bluetooth connection...");
Serial.print("Gauge range: ");
Serial.print(bluetoothGauge.getMin());
Serial.print(" - ");
Serial.print(bluetoothGauge.getMax());
Serial.print(" ");
Serial.println(bluetoothGauge.getUnit());
}
void loop() {
bluetoothServer.loop();
if (bluetooth.isConnected() && millis() - lastUpdate >= UPDATE_INTERVAL) {
lastUpdate = millis();
currentValue = readSensorValue();
bluetoothGauge.send(currentValue);
Serial.print("Gauge: ");
Serial.print(currentValue, 1);
Serial.print(" ");
Serial.println(bluetoothGauge.getUnit());
}
delay(10);
}
- Cliquez sur Téléverser pour flasher le sketch sur la carte.
- Ouvrez le Moniteur Série.
- La sortie du Moniteur Série devrait ressembler à :
8
Serial.println("Hello World!");
Message (Enter to send message to 'Arduino Nano ESP32' on 'COM15')
New Line
9600 baud
DIYables Bluetooth - Analog Gauge Example
Waiting for Bluetooth connection...
Application mobile
Remarque : L'application Bluetooth DIYables fonctionne sur Android et iOS avec le BLE. Aucun couplage manuel n'est requis.
- Lancez l'application Bluetooth DIYables.
- Au premier lancement, accordez les autorisations suivantes :
- Appareils à proximité (Android 12+) / Bluetooth (iOS) — requis pour scanner et se connecter aux appareils Bluetooth
- Localisation (Android 11 et versions antérieures uniquement) — requis par les anciennes versions Android pour scanner le BLE
- Assurez-vous que le Bluetooth est activé sur votre appareil.
- Appuyez sur Connecter sur l'écran d'accueil. L'application va scanner les appareils BLE.
- Appuyez sur "Arduino_Gauge" dans les résultats du scan.
- Après la connexion, revenez à l'écran d'accueil et ouvrez l'application Jauge analogique.
Appuyez sur l'icône des paramètres sur l'écran d'accueil pour afficher ou masquer les applications. Consultez le Manuel utilisateur de l'application Bluetooth DIYables pour plus de détails.
- La jauge analogique affiche les valeurs avec un mouvement d'aiguille fluide, simulant un compteur de vitesse.
Regardez maintenant le Moniteur Série dans l'Arduino IDE. Vous verrez :
8
Serial.println("Hello World!");
Message (Enter to send message to 'Arduino Nano ESP32' on 'COM15')
New Line
9600 baud
Bluetooth connected!
Gauge value: 50.00 km/h
Gauge value: 59.76 km/h
Gauge value: 68.78 km/h
Personnalisation créative - Adaptez le code à votre projet
Configurer la plage et l'unité de la jauge
// Compteur de vitesse : 0-200 km/h
DIYables_BluetoothAnalogGauge bluetoothGauge(bluetoothServer, 0.0, 200.0, "km/h");
// Manomètre : 0-100 PSI
DIYables_BluetoothAnalogGauge bluetoothGauge(bluetoothServer, 0.0, 100.0, "PSI");
// Jauge RPM : 0-8000 RPM
DIYables_BluetoothAnalogGauge bluetoothGauge(bluetoothServer, 0.0, 8000.0, "RPM");
// Pourcentage : 0-100%
DIYables_BluetoothAnalogGauge bluetoothGauge(bluetoothServer, 0.0, 100.0, "%");
Envoyer des valeurs à la jauge
// Envoyer une valeur à la jauge
bluetoothGauge.send(75.5);
// Lire depuis un capteur et envoyer
float sensorValue = analogRead(A0) * (100.0 / 1023.0);
bluetoothGauge.send(sensorValue);
Gérer les requêtes de valeur
bluetoothGauge.onValueRequest([]() {
float value = readSensor();
bluetoothGauge.send(value);
Serial.print("Requested: ");
Serial.println(value);
});
Exemples de programmation
Jauge potentiomètre
DIYables_BluetoothAnalogGauge bluetoothGauge(bluetoothServer, 0.0, 100.0, "%");
void loop() {
bluetoothServer.loop();
static unsigned long lastTime = 0;
if (millis() - lastTime >= 200) {
lastTime = millis();
float percent = analogRead(A0) * (100.0 / 1023.0);
bluetoothGauge.send(percent);
}
}
Moniteur de niveau de batterie
DIYables_BluetoothAnalogGauge bluetoothGauge(bluetoothServer, 0.0, 100.0, "%");
float readBatteryLevel() {
float voltage = analogRead(A0) * (5.0 / 1023.0) * 2; // voltage divider
float percent = map(voltage * 100, 300, 420, 0, 100);
return constrain(percent, 0, 100);
}
void loop() {
bluetoothServer.loop();
static unsigned long lastTime = 0;
if (millis() - lastTime >= 1000) {
lastTime = millis();
bluetoothGauge.send(readBatteryLevel());
}
}
Dépannage
Problèmes courants
1. L'appareil n'est pas visible dans l'application
- Confirmez que la carte est alimentée et que le sketch est téléversé
- Vérifiez que le Bluetooth est activé sur votre téléphone
- Sur Android 11 et versions antérieures, activez également les services de localisation
2. La jauge ne se met pas à jour
- Vérifiez que send() est appelé dans la boucle
- Vérifiez le timing de l'intervalle de mise à jour
- Confirmez que bluetoothServer.loop() est appelé à chaque itération
3. La jauge affiche une plage incorrecte
- Vérifiez les valeurs min/max dans le constructeur
- Confirmez que la chaîne d'unité est correcte
- Les valeurs en dehors de la plage configurée seront écrêtées
4. L'aiguille saute de manière erratique
- Appliquez un lissage ou une moyenne aux lectures du capteur
- Réduisez la fréquence de mise à jour si nécessaire
- Vérifiez les entrées analogiques bruitées
5. Le téléversement échoue ou la carte n'est pas reconnue
- Installez le dernier paquet de carte Arduino Nano ESP32 via le Gestionnaire de cartes
- Essayez un câble USB ou un port différent
Idées de projets
- Compteur de vitesse pour voiture RC
- Manomètre pour systèmes pneumatiques
- Indicateur de niveau de batterie
- Jauge RPM pour moteurs
- Indicateur de force du signal
Prochaines étapes
Après avoir terminé l'exemple de jauge analogique Bluetooth, explorez :
- Température Bluetooth — Affichage de jauge spécifique à la température
- Traceur Bluetooth — Visualisez les données au fil du temps
- Curseur Bluetooth — Envoyez des valeurs à l'Arduino
- Applications Bluetooth multiples — Combinez la jauge avec d'autres widgets d'application
Support
Pour une aide supplémentaire :
- Consultez la documentation de référence API
- Visitez les tutoriels DIYables
- Les forums de la communauté Arduino