Aprender

Arduino y el módulo Bluetooth HC-05

Principiante

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
Arduino Uno: chat Bluetooth con un HC-05en vivo0.000 s 0.00x
Escribe 1 en el cuadro del HC-05 del monitor serie
El ejemplo de chat Bluetooth en un ATmega328P simulado. Escribe en el cuadro del HC-05 del monitor serie para hacer de celular.

El HC-05 es la pequeña placa azul de Bluetooth con seis pines. Para tu Arduino es simplemente un puerto serie. Los bytes que el Uno envía salen en el celular. Los bytes que el celular envía llegan al Uno. Eso lo hace una forma fácil de controlar un proyecto desde una app en el celular.

El circuito de arriba es un Arduino Uno con un HC-05 en los pines 2 y 3. Ejecuta el sketch con el que empieza todo tutorial del HC-05, usando la biblioteca SoftwareSerial a 9600 baudios. Presiona Ejecutar y abre el monitor serie. El módulo tiene ahí su propio cuadro, junto al de la placa, y la pestaña Bluetooth es un celular que se vincula con él (PIN 1234). Cualquiera de los dos hace de celular.

Para ser claros en algo: aquí no hay radio. El celular es un panel en Mokxi, no una radio real. Lo que se simula es la parte del HC-05 que tu Uno puede ver, su puerto serie, bit por bit, así que todo lo que tu sketch haga con el módulo funciona igual.

Lo que necesitas

  • Un Arduino Uno
  • Un módulo Bluetooth HC-05
  • Cables jumper
  • En un escritorio real: una resistencia de 1k y una de 2k para el divisor del RXD, y un celular con una app de serie por Bluetooth

Cableado

Componente y pinVa aNota
HC-05 VCC5 VLa placa tiene su propio regulador de 3.3 V
HC-05 GNDGNDTierra compartida
HC-05 TXDPin 2El RX del sketch
HC-05 RXDPin 3El TX del sketch; en hardware real agrega un divisor
HC-05 ENSin conectarSolo para el modo AT, más abajo
HC-05 STATESin conectarEn alto mientras hay un celular conectado

¿Por qué SoftwareSerial?

El Uno tiene un puerto serie por hardware, en los pines 0 y 1. El cable USB y el monitor serie ya lo usan. Así que el HC-05 recibe un segundo puerto hecho por software, en dos pines comunes.

SoftwareSerial hace esto con una interrupción de cambio de pin. Cuando llega el bit de inicio, la interrupción se dispara y la biblioteca cronometra los demás bits con ciclos contados. A 9600 baudios, un bit dura unos 104 microsegundos. En Mokxi el chip ejecuta cada instrucción a su velocidad real, así que el tiempo de la biblioteca es el tiempo real.

Recuerda el orden en el constructor: SoftwareSerial BTSerial(2, 3) significa RX en el pin 2 y TX en el pin 3. El TXD del módulo va al pin RX del Uno, y su RXD va al pin TX del Uno. Transmitir siempre va a recibir.

El sketch, paso a paso

En setup(), ambos puertos arrancan a 9600 baudios, porque un HC-05 viene de fábrica a 9600. El sketch imprime "Bluetooth chat ready at 9600 baud." en el monitor serie y envía un saludo al celular.

En loop(), todo lo que llegue del celular pasa al monitor serie. Todo lo que escribas en el cuadro de la placa va al celular. El sketch también junta cada línea del celular. Una línea que diga 1 enciende el LED del pin 13 y responde "LED on". Una línea que diga 0 lo apaga.

Pruébalo: escribe hello en el cuadro del HC-05 y aparece debajo de la placa. Escribe 1 y el LED del Uno se enciende, y "LED on" aparece debajo del HC-05.

El loop, del ejemplo de chat Bluetooth
void loop() {
  // The phone to the serial monitor.
  if (BTSerial.available()) {
    char c = BTSerial.read();
    Serial.write(c);
    if (c == '\n') {
      command();
    } else if (c != '\r' && length < sizeof(line) - 1) {
      line[length++] = c;
    }
  }
  // The serial monitor to the phone.
  if (Serial.available()) {
    BTSerial.write(Serial.read());
  }
}

Espera la línea completa antes de responder

SoftwareSerial puede escuchar o hablar, pero no ambas cosas a la vez. Mientras envía un byte, las interrupciones están apagadas, así que un byte que llegue en ese momento se pierde. Eso también pasa en un Uno real.

Por eso el sketch responde solo después de que termine la línea del celular. Si respondiera a mitad de una línea, el resto de la línea se perdería. Cuando agregues tus propios comandos, sigue la misma regla.

Comandos AT

Un HC-05 tiene un segundo modo para cambiar su configuración, llamado modo AT. Mantén el pin EN en alto (en algunas placas se llama KEY) y el módulo deja de pasar datos. En su lugar, responde comandos. En modo AT el módulo siempre habla a 38400 baudios, sin importar la velocidad de datos.

El sketch de abajo es el sketch AT de siempre. Conecta EN al pin 9, ejecútalo y escribe comandos en el cuadro de la placa. AT responde OK. AT+VERSION? responde +VERSION:3.0-20170601. AT+NAME=Robot cambia el nombre del módulo, y AT+NAME? lee el nombre de vuelta. AT+UART? te dice la velocidad de datos, 9600 como viene de fábrica.

En un módulo real, configura tu monitor serie para enviar tanto CR como LF ("Ambos NL y CR" en el IDE de Arduino). El módulo necesita ambos. El monitor de Mokxi envía un salto de línea, y el modelo también lo acepta.

El sketch de modo AT (EN en el pin 9)
#include <SoftwareSerial.h>

SoftwareSerial BTSerial(2, 3); // RX, TX

void setup() {
  pinMode(9, OUTPUT);
  digitalWrite(9, HIGH);   // EN high: AT mode
  Serial.begin(9600);
  Serial.println("Enter AT commands:");
  BTSerial.begin(38400);   // AT mode is always 38400
}

void loop() {
  if (BTSerial.available()) Serial.write(BTSerial.read());
  if (Serial.available()) BTSerial.write(Serial.read());
}

Abrir este sketch en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.

Pruébalo en el editor

Haz clic en el HC-05 y cambia su propiedad de baudios a 38400, luego ejecuta de nuevo. El sketch sigue escuchando a 9600, así que lo que escribes como celular se convierte en basura. Este es el problema de HC-05 más común que existe. Pon el módulo y el sketch a la misma velocidad y vuelve a funcionar.

Agrega un segundo comando, como "2" para un zumbador en el pin 8. O conecta STATE al pin 4 e imprime un mensaje cuando el celular cuelga. Haz clic en el módulo del lienzo para colgar y marcar de nuevo.

Errores comunes

TX a TX. El TXD del módulo debe ir al pin RX del Uno, que es el primer número en SoftwareSerial(2, 3).

Dos velocidades distintas. El BTSerial.begin() del sketch debe coincidir con el módulo: 9600 de fábrica, o 38400 en modo AT.

Usar los pines 0 y 1. Pertenecen al puerto serie USB. El módulo peleará con la carga del sketch y con el monitor serie.

Omitir el divisor en hardware real. El pin RXD del HC-05 acepta 3.3 V. Un divisor con resistencias de 1k y 2k en la línea TX del Uno lo mantiene a salvo.

Abre este circuito en el editor. Arduino Uno: chat por Bluetooth con un HC-05, cableado tal como funciona arriba en esta página. Cambia un componente o un valor y ejecuta de nuevo.

Abrir el circuito

Preguntas

¿Qué pines usa un HC-05 en un Arduino Uno?

Cualquier dos pines digitales con SoftwareSerial. Los pines 2 y 3 son la elección habitual: TXD al pin 2 (RX) y RXD al pin 3 (TX), con VCC a 5 V y GND a GND. Evita los pines 0 y 1, que usa el puerto USB.

¿Qué velocidad en baudios usa el HC-05?

9600 baudios para datos, de fábrica. En modo AT siempre se comunica a 38400 baudios. Puedes cambiar la velocidad de datos con un comando como AT+UART=38400,0,0.

¿Por qué mi HC-05 imprime caracteres extraños?

El sketch y el módulo están a velocidades distintas. Haz que BTSerial.begin() coincida con el módulo. Arriba puedes provocarlo a propósito cambiando la propiedad de baudios del módulo.

¿Puedo conectar un celular real a Mokxi?

No. No hay radio Bluetooth en Mokxi. La pestaña de Bluetooth hace el papel del celular, y también el recuadro del HC-05 en el monitor serie. El lado serie, los tiempos de SoftwareSerial y los comandos AT están modelados, así que tu sketch funciona igual en hardware real.

Ármalo en la vida real

Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.