Componentes

El HC-05 y el HC-06, honestamente

Un HC-05 o HC-06 es un puerto serie con un celular en el otro extremo. Mokxi modela el UART bit por bit, y el celular es el panel de Bluetooth.

There is no radio between them: the phone is a pane in Mokxi, not a real radio (Bluetooth, simulado). Lo que se modela es la mitad del m贸dulo que un circuito puede ver, el UART, y resulta ser casi todo lo que un sketch hace con uno.

La placa azul peque帽a con el bot贸n al extremo se vende como "Bluetooth para Arduino", y lo que en realidad es no podr铆a ser m谩s simple: un cable de extensi贸n inal谩mbrico para un puerto serie. Los bytes que entran por RXD salen del celular del otro lado; los bytes que env铆a el celular salen por TXD. Eso es todo el dispositivo desde el punto de vista de la placa, y un sketch no puede distinguir entre un HC-05 vinculado y un cable hacia una terminal.

Pines y propiedades

Pin Qu茅 hace
VCC, GND Alimentaci贸n, de 3.6 a 6 V, y tierra. La l贸gica es de 3.3 V.
TXD La salida del m贸dulo: con茅ctala al pin RX de la placa.
RXD La entrada del m贸dulo: con茅ctala al pin TX de la placa.
EN HC-05 only. High puts it in AT mode.
STATE Solo HC-05. En alto mientras hay algo conectado.

El HC-06 solo tiene los primeros cuatro. Ambos tienen baud (9600 por defecto), name (lo que ve el celular) y connected, si hay un celular vinculado al iniciar la ejecuci贸n: activado para el HC-05, desactivado para el HC-06.

D贸nde est谩 el otro extremo

El celular en el panel de Bluetooth. Abre la pesta帽a Bluetooth mientras el circuito se ejecuta: el m贸dulo aparece listado con su nombre. Vinc煤lalo con su PIN (1234 hasta que AT+PSWD o AT+PIN lo cambie; uno incorrecto falla), con茅ctalo, y el panel es una terminal como la app "Serial Bluetooth Terminal". Lo que escribes sale por TXD; lo que el sketch env铆a entra por RXD y aparece debajo.

El panel serie tiene el mismo extremo remoto, bajo el id de componente del m贸dulo, con su propio cuadro de entrada junto a las placas, as铆 que escribir ah铆 tambi茅n es el celular enviando.

Haz clic en el m贸dulo del lienzo para colgar y volver a marcar, igual que Conectar y Desconectar del panel. En el HC-05 STATE lo refleja: en alto mientras hay alguien del otro lado, en bajo mientras no lo hay, y as铆 es como un sketch sabe si est谩 hablando solo.

Lo que no puedes aprender aqu铆 es todo lo que est谩 del otro lado de la antena: alcance de radio, interferencia y los roles de maestro y esclavo. Existen, y no est谩n en este modelo.

Lo que s铆 es real, y es la mitad que falla

Los bytes no se teletransportan. TXD y RXD llevan 8N1 al baud del m贸dulo, bit por bit: un bit de inicio en bajo, ocho bits de datos con el menos significativo primero, un bit de parada en alto.

As铆 que la falla que todo el mundo ha tenido de verdad es reproducible aqu铆 a prop贸sito. Abre las propiedades del m贸dulo, pon baud en 4800 mientras el sketch sigue muestreando a 9600, y el bit de parada cae en medio de un byte: la trama se descarta y el registro se llena de errores de enmarcado. Es el problema de HC-05 m谩s com煤n del mundo y vale la pena provocarlo una vez, a prop贸sito, con los cables frente a ti.

El m贸dulo viene de f谩brica a 9600 baudios en modo de datos, por eso todo tutorial empieza con Serial.begin(9600).

Tres voltios, no cinco

La placa acepta de 3.6 a 6 V en VCC a trav茅s de su propio regulador, y su l贸gica es de 3.3 V. TXD llega hasta 3.3 V, que un AVR lee como un alto con margen de sobra.

RXD es el pin que importa en un banco de trabajo real: no tolera 5 V, por eso todo tutorial pone un divisor en la l铆nea de transmisi贸n de la placa. Nada en Mokxi puede da帽arse, as铆 que el circuito de la galer铆a no lo lleva, pero TXD de verdad solo llega a 3.3 V aqu铆, as铆 que un circuito que lo compare contra el riel de 5 V se comporta como el real. Agrega el divisor en el hardware.

Dos pines y un UART de hardware

Un Uno tiene un UART de hardware y es del monitor serie, as铆 que el m贸dulo recibe uno por software, que es lo que es SoftwareSerial y la raz贸n de que exista. El sketch de los tutoriales compila y funciona tal cual:

#include <SoftwareSerial.h>
SoftwareSerial BTSerial(2, 3);   // RX, TX: the module's TXD into 2
void setup() { Serial.begin(9600); BTSerial.begin(9600); }
void loop() {
  if (BTSerial.available()) Serial.write(BTSerial.read());
  if (Serial.available()) BTSerial.write(Serial.read());
}

SoftwareSerial.h es propio del runtime, escrito para Mokxi, con las llamadas de la biblioteca de Arduino y su mecanismo: una interrupci贸n de cambio de pin detecta el bit de inicio, y bucles contados cronometran los dem谩s bits, con las interrupciones desactivadas durante el byte. El modelo del ATmega328P ejecuta cada instrucci贸n con el conteo de ciclos de su hoja de datos, as铆 que el tiempo es el del chip. Est谩 probado con este m贸dulo a 9600, 38400 y 57600 baudios en una placa de 16 MHz, a 9600 y 38400 en el Pro Mini de 8 MHz, y con el m贸dulo 4% r谩pido o lento. Tres comportamientos de la biblioteca real se mantienen, y todos importan con este m贸dulo:

  • Semi d煤plex. Mientras el sketch env铆a un byte, las interrupciones est谩n desactivadas, as铆 que un byte que llegue en ese momento se pierde. Contesta el celular despu茅s de que termine su l铆nea, no a mitad de ella.
  • Un puerto escucha a la vez. Con dos puertos SoftwareSerial, solo el que llam贸 listen() por 煤ltima vez recibe. El b煤fer de recepci贸n es de 64 bytes y guarda 63, y overflow() avisa cu谩ndo se llen贸.
  • 38400 baudios es justo en 8 MHz. En el Pro Mini de 8 MHz cada byte a 38400 mantiene las interrupciones desactivadas cerca del 95% de su tiempo, as铆 que cuando la interrupci贸n del temporizador de millis() cae sobre un bit de inicio, ese byte puede llegar mal. En una prueba de 24 l铆neas de 31 bytes, 23 llegaron completas. Usa 9600 o 19200 en una placa de 8 MHz cuando cada byte importe.

El mismo header funciona en la Nano, la Pro Mini, la Mega (recepci贸n en 10 a 15, 50 a 53 y A8 a A15), la Leonardo y la Pro Micro (recepci贸n en 8 a 11 y 14 a 16), la ESP8266, la ESP32 y la ESP32-S3. En las placas ESP es al estilo EspSoftwareSerial: cada flanco se cronometra en una interrupci贸n, as铆 que varios puertos reciben a la vez.

El sketch btlamp en cambio saca un byte a mano a 1200 baudios, para que todo 茅l sea visible en treinta l铆neas.

Modo AT

EN (marcado KEY en algunas placas) en alto pone el m贸dulo en modo de comandos: los bytes en RXD son comandos para el m贸dulo mismo y no tr谩fico hacia el otro extremo, y las respuestas salen por TXD. El subconjunto que responde aqu铆 es el que usa una lecci贸n:

comando respuesta
AT OK
AT+VERSION? +VERSION:3.0-20170601 y luego OK
AT+NAME? +NAME:<name> y luego OK
AT+NAME=<text> OK, y el nombre cambia
AT+UART? +UART:<baud>,0,0 y luego OK
AT+UART=<baud>,0,0 OK, y la velocidad cambia
AT+ADDR? +ADDR:98d3:31:fb1234 y luego OK
AT+ROLE?, AT+ROLE=<0..2> +ROLE:<n> y luego OK; OK
AT+CMODE?, AT+CMODE=<0..1> +CMODE:<n> y luego OK; OK
AT+PSWD?, AT+PSWD=<pin> +PSWD:<pin> y luego OK; OK
cualquier otro valor ERROR:(0)

El modo AT habla a 38400 baudios, sin importar la velocidad de datos configurada, como lo hace el m贸dulo real en modo de comandos. As铆 que el sketch AT de los tutoriales, con BTSerial.begin(38400) y EN en alto desde un pin, funciona tal cual. Un sketch que se quede en 9600 no recibe nada coherente de vuelta, que es el error de modo AT m谩s com煤n. AT+UART= cambia la velocidad de datos, que surte efecto cuando EN vuelve a bajar. El rol y el modo de conexi贸n se guardan y se leen de vuelta, y no cambian nada m谩s, porque no hay radio que cambiar. El PIN es el que el celular del panel de Bluetooth debe escribir para vincularse.

El m贸dulo real quiere que cada comando termine con CR LF ("Ambos NL & CR" en el monitor serie del IDE de Arduino). Este tambi茅n acepta un LF solo, que es lo que env铆a el monitor serie de Mokxi.

El HC-06

El hermano solo esclavo del HC-05, en la placa de cuatro pines: VCC, GND, TXD y RXD, sin EN y sin STATE. Viene fuera de la bolsa sin nada conectado, y mientras no haya nada conectado, todo lo que llegue a RXD es un comando AT, a la velocidad de datos, en el dialecto antiguo de "linvor": sin final de l铆nea, y el m贸dulo responde cuando la l铆nea queda en silencio durante un d茅cimo de segundo, tambi茅n sin final de l铆nea. Elige "Sin final de l铆nea".

comando respuesta
AT OK
AT+VERSION OKlinvorV1.8
AT+NAME<name> OKsetname, y el panel muestra el nombre nuevo
AT+PIN<four digits> OKsetPIN, y la vinculaci贸n pide el PIN nuevo
AT+BAUD<1 to C> OK<rate> a la velocidad antigua, y luego la nueva: 4 es 9600, 8 es 115200
cualquier otro valor nada en absoluto

Una vez que el celular se conecta, esos mismos bytes son tr谩fico, como en el real.

Lo que no est谩 modelado

La radio y todo lo que cuelga de ella: lo que har铆a el rol, AT+BIND, AT+INQ y el descubrimiento al que pertenecen. La diferencia entre entrar en modo AT al encender y despu茅s: aqu铆 EN en alto es modo AT a 38400 en ambos casos. El bot贸n del extremo de la placa, que en uno real es la otra forma de entrar en modo AT. El control de flujo, que el header no expone. Cualquier trama que no sea 8N1. Y el retardo entre un byte que llega al m贸dulo y el que sale del otro extremo: aqu铆 es instant谩neo, donde un enlace real tarda decenas de milisegundos y fluct煤a.

Los circuitos para abrir

Chat por Bluetooth: el sketch del tutorial tal como est谩, SoftwareSerial en los pines 2 y 3 a 9600. Escribe como el celular en la caja del m贸dulo; env铆a 1 o 0 para el LED.

L谩mpara por Bluetooth: escribe on, off, blink o status al m贸dulo en el panel serie y la l谩mpara responde, con STATE conectado para que el sketch pueda avisarte cuando nadie escucha.

V茅elo en acci贸n

El tutorial Arduino HC-05 Bluetooth recorre el cableado, el sketch de chat y los comandos AT.

Two projects take commands from the module's box the way a phone app sends them: the Bluetooth RC car drives a 2WD car on an L298N from F, B, L, R and S, and Bluetooth home automation toggles four relays from 1 to 4.