Exemplo de Slider Bluetooth para Arduino Nano ESP32 - Tutorial de Controle com Slider Duplo via BLE
Visão Geral
Este exemplo oferece controles com slider duplo no Arduino Nano ESP32 usando BLE (Bluetooth Low Energy) por meio do aplicativo DIYables Bluetooth STEM. Controle dois valores independentes, com faixa e passo configuráveis, a partir de um smartphone. Adequado para brilho de LED, velocidade de motor, posicionamento de servo e qualquer aplicação que exija uma entrada numérica ajustável.
Observação: O Arduino Nano ESP32 suporta apenas BLE — o Bluetooth Clássico não é suportado. O DIYables Bluetooth App funciona em Android e iOS com BLE.
Recursos
- Sliders Duplos: Dois controles de slider independentes
- Faixa Configurável: Defina os valores mínimo, máximo e de passo
- Atualizações em Tempo Real: Os valores do slider são transmitidos na hora quando mudam
- Pronto para PWM: Mapeie os valores do slider diretamente para a saída PWM
- Suporte a Android e iOS: O BLE é compatível com as duas plataformas
- Sem Necessidade de Pareamento: O BLE conecta sem pareamento manual
- Baixo Consumo: O BLE consome menos energia que o Bluetooth Clássico
Hardware Necessário
Or you can buy the following kits:
| 1 | × | DIYables Sensor Kit (18 sensors/displays) |
Divulgação: Alguns dos links desta seção são links de afiliado da Amazon. Podemos receber uma comissão pelas compras feitas por meio desses links, sem custo adicional para você. Agradecemos o seu apoio.
Código Arduino Nano ESP32
Passos Rápidos
- Novo no Arduino Nano ESP32? Comece pelo guia de primeiros passos do Arduino Nano ESP32.
- Conecte o Arduino Nano ESP32 ao seu computador via USB.
- Abra a Arduino IDE.
- Selecione a placa Arduino Nano ESP32 e a porta COM correta.
- Clique no ícone Libraries na barra lateral esquerda.
- Pesquise por "DIYables Bluetooth" e selecione a biblioteca DIYables Bluetooth da DIYables.
- Clique em Install.
- Quando for solicitado a instalar as dependências, clique em Install All.
Código BLE
- Na Arduino IDE, abra File Examples DIYables Bluetooth ArduinoBLE_Slider, ou cole o código no editor.
/*
* DIYables Bluetooth Library - ESP32 BLE Slider Example
* Works with DIYables Bluetooth STEM app on Android and iOS
*
* This example demonstrates the Bluetooth Slider feature:
* - Control values using sliders (0-100)
* - Support for dual sliders
* - Configurable range and step
*
* Tutorial: https://diyables.io/bluetooth-app
* Author: DIYables
*/
#include <DIYables_BluetoothServer.h>
#include <DIYables_BluetoothSlider.h>
#include <platforms/DIYables_Esp32BLE.h>
// BLE Configuration
const char* DEVICE_NAME = "ESP32BLE_Slider";
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 Slider app instance (min=0, max=100, step=1)
DIYables_BluetoothSlider bluetoothSlider(0, 100, 1);
// Variables to store current slider values
int currentSlider1 = 0;
int currentSlider2 = 0;
// PWM output pins
const int PWM_PIN_1 = D6;
const int PWM_PIN_2 = D7;
void setup() {
Serial.begin(115200);
delay(1000);
Serial.println("DIYables Bluetooth - ESP32 BLE Slider Example");
// Initialize PWM pins
pinMode(PWM_PIN_1, OUTPUT);
pinMode(PWM_PIN_2, OUTPUT);
// Initialize Bluetooth server with platform-specific implementation
bluetoothServer.begin();
// Add slider app to server
bluetoothServer.addApp(&bluetoothSlider);
// Set up connection event callbacks
bluetoothServer.setOnConnected([]() {
Serial.println("Bluetooth connected!");
bluetoothSlider.send(currentSlider1, currentSlider2);
});
bluetoothServer.setOnDisconnected([]() {
Serial.println("Bluetooth disconnected!");
});
// Set up slider callback for value changes
bluetoothSlider.onSliderValue([](int slider1, int slider2) {
currentSlider1 = slider1;
currentSlider2 = slider2;
Serial.print("Slider 1: ");
Serial.print(slider1);
Serial.print(", Slider 2: ");
Serial.println(slider2);
// Map slider values (0-100) to PWM range (0-255)
int pwm1 = map(slider1, 0, 100, 0, 255);
int pwm2 = map(slider2, 0, 100, 0, 255);
analogWrite(PWM_PIN_1, pwm1);
analogWrite(PWM_PIN_2, pwm2);
// TODO: Add your control logic here
});
bluetoothSlider.onGetConfig([]() {
bluetoothSlider.send(currentSlider1, currentSlider2);
Serial.print("App requested values - Sent: Slider1=");
Serial.print(currentSlider1);
Serial.print(", Slider2=");
Serial.println(currentSlider2);
});
Serial.println("Waiting for Bluetooth connection...");
}
void loop() {
bluetoothServer.loop();
delay(10);
}
- Clique em Upload para gravar o sketch na placa.
- Abra o Serial Monitor.
- A saída do Serial Monitor deve ficar assim:
8
Serial.println("Hello World!");
Message (Enter to send message to 'Arduino Nano ESP32' on 'COM15')
New Line
9600 baud
DIYables Bluetooth - Slider Example
Waiting for Bluetooth connection...
Aplicativo Móvel
Observação: O DIYables Bluetooth App funciona em Android e iOS com BLE. Não é necessário fazer pareamento manual.
- Abra o DIYables Bluetooth App.
- Na primeira abertura, conceda as seguintes permissões:
- Dispositivos Próximos (Android 12+) / Bluetooth (iOS) — necessário para procurar e conectar a dispositivos Bluetooth
- Localização (somente Android 11 e anteriores) — exigida pelas versões mais antigas do Android para procurar dispositivos BLE
- Verifique se o Bluetooth está ativado no seu dispositivo.
- Toque em Connect na tela inicial. O aplicativo vai procurar dispositivos BLE.
- Toque em "Arduino_Slider" nos resultados da busca.
- Depois de conectar, volte à tela inicial e abra o aplicativo Slider.
Toque no ícone de configurações na tela inicial para mostrar ou ocultar aplicativos. Veja o Manual do Usuário do DIYables Bluetooth App para mais detalhes.
- Arraste os sliders para mudar os valores.
Agora volte ao Serial Monitor na Arduino IDE. Você verá:
8
Serial.println("Hello World!");
Message (Enter to send message to 'Arduino Nano ESP32' on 'COM15')
New Line
9600 baud
Bluetooth connected!
Slider 1: 50, Slider 2: 0
Slider 1: 75, Slider 2: 0
Slider 1: 100, Slider 2: 25
- Ajuste os sliders e observe os valores serem atualizados em tempo real no Serial Monitor.
Personalização Criativa - Adapte o Código ao Seu Projeto
Configurar a Faixa do Slider
// Constructor: DIYables_BluetoothSlider(min, max, step)
DIYables_BluetoothSlider bluetoothSlider(0, 100, 1);
// Change range at runtime
bluetoothSlider.setRange(0, 255);
// Change step size
bluetoothSlider.setStep(5); // Coarser control
// Read configuration
int minVal = bluetoothSlider.getMin();
int maxVal = bluetoothSlider.getMax();
int step = bluetoothSlider.getStep();
Tratar Mudanças do Slider
bluetoothSlider.onSliderValue([](int slider1, int slider2) {
currentSlider1 = slider1;
currentSlider2 = slider2;
Serial.print("Slider 1: ");
Serial.print(slider1);
Serial.print(", Slider 2: ");
Serial.println(slider2);
// Map to PWM and control output
int pwm1 = map(slider1, 0, 100, 0, 255);
analogWrite(PWM_PIN_1, pwm1);
});
Enviar os Valores Atuais ao Aplicativo
bluetoothSlider.onGetConfig([]() {
bluetoothSlider.send(currentSlider1, currentSlider2);
});
// Or send anytime:
bluetoothSlider.send(50, 75); // Set both sliders
Tratar Eventos de Conexão
bluetoothServer.setOnConnected([]() {
Serial.println("Bluetooth connected!");
bluetoothSlider.send(currentSlider1, currentSlider2);
});
bluetoothServer.setOnDisconnected([]() {
Serial.println("Bluetooth disconnected!");
});
Exemplos de Programação
Controle de Brilho de LED
const int LED_PIN_1 = 9;
const int LED_PIN_2 = 10;
bluetoothSlider.onSliderValue([](int slider1, int slider2) {
int brightness1 = map(slider1, 0, 100, 0, 255);
int brightness2 = map(slider2, 0, 100, 0, 255);
analogWrite(LED_PIN_1, brightness1);
analogWrite(LED_PIN_2, brightness2);
Serial.print("LED 1: ");
Serial.print(brightness1);
Serial.print(", LED 2: ");
Serial.println(brightness2);
});
Controle de Servo
#include <Servo.h>
Servo servo1, servo2;
void setup() {
servo1.attach(9);
servo2.attach(10);
bluetoothSlider.onSliderValue([](int slider1, int slider2) {
int angle1 = map(slider1, 0, 100, 0, 180);
int angle2 = map(slider2, 0, 100, 0, 180);
servo1.write(angle1);
servo2.write(angle2);
Serial.print("Servo 1: ");
Serial.print(angle1);
Serial.print("°, Servo 2: ");
Serial.print(angle2);
Serial.println("°");
});
}
Velocidade do Motor com Direção
const int MOTOR_SPEED_PIN = 9;
const int MOTOR_DIR_PIN = 8;
bluetoothSlider.onSliderValue([](int slider1, int slider2) {
// Slider 1: speed (0-100%)
// Slider 2: direction threshold (below 50 = reverse, above 50 = forward)
int speed = map(slider1, 0, 100, 0, 255);
bool forward = (slider2 >= 50);
analogWrite(MOTOR_SPEED_PIN, speed);
digitalWrite(MOTOR_DIR_PIN, forward ? HIGH : LOW);
Serial.print("Speed: ");
Serial.print(slider1);
Serial.print("%, Direction: ");
Serial.println(forward ? "Forward" : "Reverse");
});
Técnicas Avançadas de Programação
Slider com Zona Morta
bluetoothSlider.onSliderValue([](int slider1, int slider2) {
// Add dead zone around center (45-55 = stop)
if (slider1 >= 45 && slider1 <= 55) {
Serial.println("Center - stopped");
analogWrite(MOTOR_PIN, 0);
} else {
int speed = map(slider1, 0, 100, 0, 255);
analogWrite(MOTOR_PIN, speed);
}
});
Limitação de Taxa
unsigned long lastSliderAction = 0;
const unsigned long SLIDER_COOLDOWN = 50; // 50ms minimum
bluetoothSlider.onSliderValue([](int slider1, int slider2) {
if (millis() - lastSliderAction >= SLIDER_COOLDOWN) {
lastSliderAction = millis();
// Process slider value
analogWrite(PWM_PIN, map(slider1, 0, 100, 0, 255));
}
});
Solução de Problemas
Problemas Comuns
1. Dispositivo não aparece no aplicativo
- Confirme que a placa está ligada e que o sketch foi carregado
- Verifique se o Bluetooth está ativado no seu celular
- No Android 11 e anteriores, ative também os serviços de localização
- Tente reiniciar o Bluetooth no seu celular
2. As mudanças do slider não são recebidas
- Verifique o status da conexão Bluetooth no aplicativo
- Confirme que o callback onSliderValue está registrado corretamente
- Verifique o Serial Monitor em busca de mensagens de erro
3. A saída PWM não funciona
- Confirme que o pino suporta PWM
- Verifique as conexões da ligação
- Teste antes com um sketch simples de analogWrite
4. O slider volta para 0 ao reconectar
- Implemente o callback onGetConfig para enviar os valores guardados ao reconectar
- Mantenha os valores do slider em variáveis entre as conexões
5. A conexão cai com frequência
- Reduza a distância até o Arduino
- Verifique se há interferência de outros dispositivos BLE
- Garanta uma alimentação USB estável
6. O upload falha ou a placa não é reconhecida
- Instale o pacote de placa Arduino Nano ESP32 mais recente pelo Board Manager
- Tente outro cabo ou outra porta USB
- Pressione o botão de reset antes de fazer o upload
Ideias de Projetos
Controle de Iluminação
- Controlador de brilho para dois LEDs
- Misturador de cores para LED RGB (use dois sliders para matiz/saturação)
- Brilho e temperatura de cor de fita LED
- Dimmer de iluminação de palco
Controle de Motores
- Controlador de velocidade de motor DC
- Posicionamento de dois servos
- Suporte pan-tilt para câmera
- Velocidade das rodas de um robô
Áudio
- Controle de volume
- Frequência e duração de tons
- Bandas de equalizador
Próximos Passos
Depois de concluir o exemplo do Bluetooth Slider, explore:
- Bluetooth Joystick — Controle direcional 2D
- Bluetooth Rotator — Controle angular/rotacional
- Bluetooth Temperature — Exibição de medidor de temperatura
- Multiple Bluetooth Apps — Combine o slider com outros widgets do aplicativo
Suporte
Para obter mais ajuda:
- Consulte a documentação de referência da API
- Visite os tutoriais da DIYables
- Fóruns da comunidade Arduino