Exemple de tableau Bluetooth Arduino Nano ESP32 - Affichage de données structurées via tutoriel BLE
Vue d'ensemble
Cet exemple implémente un affichage de données structurées sur l'Arduino Nano ESP32 en utilisant le BLE (Bluetooth Low Energy) via l'application DIYables Bluetooth STEM. Affichez les lectures de capteurs, l'état du système et toutes les données dans un format tableau propre sur un smartphone, avec des lignes nommées et des mises à jour de valeurs en temps réel. Convient aux tableaux de bord, à la surveillance système et aux affichages multi-capteurs.
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
- Lignes nommées : Définissez des lignes avec des étiquettes (ex. : "Température", "Humidité")
- Mises à jour en temps réel : Envoyez efficacement les mises à jour de valeurs individuelles
- Synchronisation de structure : Envoyez automatiquement la structure du tableau à la connexion
- Données flexibles : Affichez n'importe quelle chaîne ou donnée numérique
- Jusqu'à 20 lignes : Support pour plusieurs champs de données
- 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_Table, ou collez le code dans l'éditeur.
/*
* DIYables Bluetooth Library - ESP32 BLE Table Example
* Works with DIYables Bluetooth STEM app on Android and iOS
*
* This example demonstrates the Bluetooth Table feature:
* - Display structured data in a two-column table
* - Real-time value updates for each row
* - Perfect for sensor dashboards and status displays
*
* Tutorial: https://diyables.io/bluetooth-app
* Author: DIYables
*/
#include <DIYables_BluetoothServer.h>
#include <DIYables_BluetoothTable.h>
#include <platforms/DIYables_Esp32BLE.h>
// BLE Configuration
const char* DEVICE_NAME = "ESP32BLE_Table";
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 Table app instance
DIYables_BluetoothTable bluetoothTable;
// Variables for demo data
unsigned long lastUpdate = 0;
const unsigned long UPDATE_INTERVAL = 1000;
int counter = 0;
void setup() {
Serial.begin(115200);
delay(1000);
Serial.println("DIYables Bluetooth - ESP32 BLE Table Example");
// Initialize Bluetooth server with platform-specific implementation
bluetoothServer.begin();
// Add table app to server
bluetoothServer.addApp(&bluetoothTable);
// Define table structure
bluetoothTable.addRow("Temperature");
bluetoothTable.addRow("Humidity");
bluetoothTable.addRow("Pressure");
bluetoothTable.addRow("Counter");
bluetoothTable.addRow("Uptime");
bluetoothTable.addRow("Free Heap");
bluetoothTable.addRow("Status");
Serial.print("Table rows defined: ");
Serial.println(bluetoothTable.getRowCount());
// Set up connection event callbacks
bluetoothServer.setOnConnected([]() {
Serial.println("Bluetooth connected!");
bluetoothTable.sendTableStructure();
updateTableValues();
});
bluetoothServer.setOnDisconnected([]() {
Serial.println("Bluetooth disconnected!");
});
bluetoothTable.onDataRequest([]() {
Serial.println("App requested table data");
bluetoothTable.sendTableStructure();
updateTableValues();
});
Serial.println("Waiting for Bluetooth connection...");
}
void updateTableValues() {
float temperature = 20.0 + random(0, 100) / 10.0;
bluetoothTable.sendValueUpdate("Temperature", String(temperature, 1) + " °C");
int humidity = 40 + random(0, 21);
bluetoothTable.sendValueUpdate("Humidity", String(humidity) + " %");
int pressure = 1000 + random(0, 21);
bluetoothTable.sendValueUpdate("Pressure", String(pressure) + " hPa");
bluetoothTable.sendValueUpdate("Counter", String(counter));
counter++;
unsigned long uptime = millis() / 1000;
String uptimeStr = String(uptime / 3600) + "h " +
String((uptime % 3600) / 60) + "m " +
String(uptime % 60) + "s";
bluetoothTable.sendValueUpdate("Uptime", uptimeStr);
bluetoothTable.sendValueUpdate("Free Heap", String(ESP.getFreeHeap()) + " bytes");
bluetoothTable.sendValueUpdate("Status", counter % 2 == 0 ? "Running" : "Active");
Serial.println("Table values updated");
}
void loop() {
bluetoothServer.loop();
if (bluetooth.isConnected() && millis() - lastUpdate >= UPDATE_INTERVAL) {
lastUpdate = millis();
updateTableValues();
}
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 - Table 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_Table" dans les résultats du scan.
- Après la connexion, revenez à l'écran d'accueil et ouvrez l'application Tableau.
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.
- Un tableau affiche les lignes Température, Humidité, Pression, Compteur, Durée de fonctionnement, Mémoire libre et Statut — toutes se mettant à jour en temps réel.
Regardez maintenant le Moniteur Série. La sortie affichera :
8
Serial.println("Hello World!");
Message (Enter to send message to 'Arduino Nano ESP32' on 'COM15')
New Line
9600 baud
Bluetooth connected!
Sending table updates...
Temperature: 25.30 °C
Humidity: 55.70 %
Personnalisation créative - Adaptez le code à votre projet
Définir la structure du tableau
// Add rows during setup
bluetoothTable.addRow("Temperature", "-- °C");
bluetoothTable.addRow("Humidity", "-- %");
bluetoothTable.addRow("Pressure", "-- hPa");
bluetoothTable.addRow("Status", "Initializing...");
Mettre à jour les valeurs
// Update by row name
bluetoothTable.sendValueUpdate("Temperature", "25.5 °C");
bluetoothTable.sendValueUpdate("Status", "Running");
// Update by row index (0-based)
bluetoothTable.sendValueUpdate(0, "25.5 °C");
bluetoothTable.sendValueUpdate(3, "Running");
Envoyer la structure du tableau
// Re-send the full table structure to the app
bluetoothTable.sendTableStructure();
// Handle data request from app
bluetoothTable.onDataRequest([]() {
bluetoothTable.sendTableStructure();
});
Exemples de programmation
Tableau de bord de station météo
DIYables_BluetoothTable bluetoothTable(bluetoothServer);
void setup() {
bluetoothTable.addRow("Temperature", "-- °C");
bluetoothTable.addRow("Humidity", "-- %");
bluetoothTable.addRow("Pressure", "-- hPa");
bluetoothTable.addRow("Wind Speed", "-- m/s");
bluetoothTable.addRow("Rain", "None");
bluetoothTable.onDataRequest([]() {
bluetoothTable.sendTableStructure();
});
}
void loop() {
bluetoothServer.loop();
static unsigned long lastTime = 0;
if (millis() - lastTime >= 2000) {
lastTime = millis();
bluetoothTable.sendValueUpdate("Temperature", String(readTemp(), 1) + " °C");
bluetoothTable.sendValueUpdate("Humidity", String(readHumidity(), 1) + " %");
bluetoothTable.sendValueUpdate("Pressure", String(readPressure(), 0) + " hPa");
}
}
Moniteur d'état du système
void setup() {
bluetoothTable.addRow("Uptime", "0s");
bluetoothTable.addRow("Free RAM", "-- bytes");
bluetoothTable.addRow("WiFi RSSI", "-- dBm");
bluetoothTable.addRow("IP Address", "N/A");
bluetoothTable.addRow("Status", "Starting...");
}
void loop() {
bluetoothServer.loop();
static unsigned long lastTime = 0;
if (millis() - lastTime >= 1000) {
lastTime = millis();
unsigned long uptime = millis() / 1000;
String uptimeStr = String(uptime / 3600) + "h " + String((uptime % 3600) / 60) + "m " + String(uptime % 60) + "s";
bluetoothTable.sendValueUpdate("Uptime", uptimeStr);
bluetoothTable.sendValueUpdate("Status", "Running");
}
}
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. Le tableau est vide ou les lignes ne s'affichent pas
- Assurez-vous que addRow() est appelé dans setup() avant la connexion
- Implémentez le callback onDataRequest pour renvoyer la structure
- Vérifiez que sendTableStructure() est appelé
3. Les valeurs ne se mettent pas à jour
- Vérifiez que sendValueUpdate() est appelé dans la boucle
- Vérifiez que le nom de ligne correspond exactement (sensible à la casse)
- Assurez-vous que bluetoothServer.loop() est appelé à chaque itération de boucle
4. Les noms de lignes ne correspondent pas
- Les noms de lignes sont sensibles à la casse — "Temperature" ≠ "temperature"
- Utilisez l'index de ligne (basé sur 0) comme alternative aux noms de lignes
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
- Tableau de bord de station météo
- Moniteur de ressources système
- Affichage de données multi-capteurs
- Panneau de configuration d'appareil
- Tableau de statut d'appareils IoT
Prochaines étapes
Après avoir terminé l'exemple de tableau Bluetooth, explorez :
- Traceur Bluetooth — Visualisation graphique des données
- Moniteur Bluetooth — Interaction basée sur du texte
- Température Bluetooth — Affichage de type jauge
- Applications Bluetooth multiples — Combinez le tableau 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