Diseño de protocolos de dispositivo sobre BLE y USB
EN BREVE: Ponga el protocolo del dispositivo por escrito antes de construir cualquiera de los dos lados: correspondencia con el transporte, formato de trama, tipos de mensaje, versiones, códigos de error y timeouts. Mantenga el protocolo de aplicación independiente de BLE o USB para poder probarlo por un cable serie. Una especificación compartida y un banco de pruebas en el host permiten que los equipos de firmware y de app trabajen en paralelo y detecten desacuerdos pronto.
1.0 Dónde fallan los protocolos de dispositivo
La mayoría de los problemas de protocolo no tienen que ver con BLE o USB en sí. Vienen de una interfaz que nunca se puso por escrito. El ingeniero de firmware elige una disposición de bytes, el desarrollador de la app la deduce de un log y los dos lados se van separando. Para la segunda versión de firmware nadie sabe qué lado tiene razón, una actualización rompe la versión de la app que ya está en la tienda y la corrección exige una publicación coordinada en ambos lados.
La especificación cubre transportes, trama, tabla de mensajes, tabla de errores y timeouts. Escríbala antes de la primera captura con sniffer, no después.
2.0 Capas
Separamos el protocolo en capas para poder probar cada una por su cuenta:
| Capa | Responsabilidad | Cambia cuando |
|---|---|---|
| Transporte | Mover bytes: características BLE GATT, USB CDC-ACM, informes USB HID, UART | Cambia el hardware o el sistema operativo |
| Tramas | Límites de mensaje, longitud, comprobación de integridad, número de secuencia | Rara vez |
| Mensajes | Tipos de comando y respuesta, codificación del payload, códigos de error | Hay funciones nuevas |
| Aplicación | Lo que hace el dispositivo con un comando | Cambia el comportamiento del producto |
Las capas de tramas y de mensajes no deberían saber qué transporte hay debajo. Así el mismo protocolo puede ir por UART en el banco, por un adaptador USB-serie en la prueba de producción y por BLE en el producto.
3.0 Elección del transporte
| Necesidad | BLE | USB CDC-ACM (serie virtual) | USB HID |
|---|---|---|---|
| Inalámbrico hacia un teléfono | Encaje natural | No aplica | No aplica |
| Sin driver en sistemas de escritorio | Necesita la pila Bluetooth del sistema | Driver incluido en Windows 10 y posteriores, macOS y Linux | Sin driver |
| Acceso desde el navegador | Web Bluetooth donde esté soportado | Web Serial donde esté soportado | WebHID donde esté soportado |
| Caudal | Limitado por el intervalo de conexión y la MTU | Mayor | Limitado por el tamaño de informe y el sondeo |
| Consumo | Diseñado para bajo consumo | El dispositivo puede tomar alimentación del bus mientras está conectado | Igual que CDC |
El soporte de Web Bluetooth, Web Serial y WebHID varía según el navegador y la plataforma; compruebe el estado actual en los navegadores de sus usuarios antes de depender de ellos. Muchos productos usan ambos: BLE para la app del teléfono y USB para configuración, prueba en fábrica y recuperación.
3.1 Correspondencia con BLE GATT
Dos enfoques habituales:
- Un atributo por valor. Cada ajuste o lectura es una característica propia. Fácil de inspeccionar con herramientas BLE genéricas, pero añadir funciones obliga a cambiar la tabla GATT, y las actualizaciones de varios campos no son atómicas.
- Canal de mensajes. Una característica para escrituras del host al dispositivo y otra para notificaciones del dispositivo al host, que transportan mensajes en tramas. Un solo protocolo para todas las funciones; la tabla GATT no cambia.
Cuando el dispositivo expone más de unos pocos valores usamos un canal de mensajes, y dejamos los servicios estándar (Device Information, Battery) como atributos para que las herramientas genéricas sigan funcionando. Los servicios propios necesitan UUID de 128 bits; los estándar figuran en la lista Assigned Numbers del Bluetooth SIG.
El caudal y la latencia dependen de los parámetros de conexión y de la ATT MTU negociada, que controla más el teléfono que el dispositivo. Diseñe el protocolo para que un mensaje pueda repartirse en varias notificaciones y reensamblarse, y no dé por hecha una MTU concreta.
3.2 Correspondencia con USB
CDC-ACM aparece en el host como un puerto serie y encaja con un protocolo de flujo de bytes con tramas. HID ofrece informes de tamaño fijo y funciona sin drivers, lo que ayuda en PC corporativos bloqueados; en ese caso la capa de tramas reparte los mensajes en varios informes. El USB-IF publica las especificaciones de ambas clases.
4.0 La trama
El formato de trama del que partimos:
| Campo | Tamaño | Notas |
|---|---|---|
| Marca de inicio o prefijo de longitud | 1–2 bytes | Prefijo de longitud en BLE/HID; delimitación tipo COBS o SLIP en flujos de bytes |
| Versión de protocolo | 1 byte | Versión mayor del formato de trama |
| Número de secuencia | 1–2 bytes | Empareja respuestas con peticiones; detecta pérdidas |
| Tipo de mensaje | 1–2 bytes | Comando, respuesta, evento, error |
| Longitud del payload | 2 bytes | Explícita, aunque el transporte también lleve longitud |
| Payload | variable | Codificación elegida en cada proyecto (estructuras fijas, TLV, CBOR, protobuf) |
| Comprobación de integridad | 2–4 bytes | CRC en flujos de bytes; puede omitirse si el transporte ya comprueba |
La codificación del payload es un compromiso entre tamaño de código en el dispositivo y flexibilidad. Las estructuras fijas little-endian son las más pequeñas y las más difíciles de evolucionar. TLV o CBOR permiten añadir campos opcionales sin romper lectores antiguos.
5.0 Versiones y compatibilidad
Ponga la regla de compatibilidad por escrito. La nuestra:
- El dispositivo informa de su versión de protocolo y de sus indicadores de funciones en respuesta a un comando «hello» o «get info», cuya forma nunca cambia.
- Los campos nuevos se añaden como opcionales. Los lectores ignoran los campos que no entienden.
- Eliminar un campo o cambiar su significado exige una nueva versión mayor, y la app mantiene el soporte de la versión mayor anterior durante un periodo documentado.
- Las notas de versión del firmware y de la app indican qué versiones de protocolo admiten.
6.0 Errores, timeouts y estado
Cada comando recibe exactamente una respuesta: éxito con datos o un código de error de una tabla documentada. Las clases de error típicas son trama mal formada, comando desconocido, parámetro no válido, ocupado, no permitido en el estado actual y fallo interno. La tabla va en la especificación, no solo en el código.
Los timeouts también forman parte del protocolo. Indique el tiempo máximo de respuesta por clase de comando, qué hace el host ante un timeout (reintentar con el mismo número de secuencia o abandonar) y cuánto espera el dispositivo el resto de un mensaje de varias partes antes de descartarlo.
Las operaciones largas, como una actualización de firmware o una calibración, deberían responder de inmediato con «aceptado» e informar del progreso mediante eventos, en lugar de bloquear la respuesta.
7.0 Consideraciones de seguridad
El emparejamiento y el bonding de BLE protegen el enlace, pero no deciden qué puede hacer un interlocutor autenticado. Enumere qué comandos cambian el estado, cuáles necesitan una sesión autorizada y cuáles pueden exponerse sin riesgo a cualquier host conectado. Los comandos de fábrica y de depuración deberían quedar desactivados o bloqueados en el firmware de producción, y la especificación debería decir cómo.
8.0 Banco de pruebas
Escribimos una pequeña herramienta en el host, en Python salvo que el proyecto exija otra cosa, que habla el protocolo por un puerto serie. Cumple tres funciones: permite al ingeniero de firmware probar comandos antes de que exista la app, ejecuta en CI pruebas de regresión con scripts contra una placa en el banco y da al equipo de la app una implementación de referencia con la que comparar. Hacer fuzzing del analizador de tramas con entradas mal formadas desde la misma herramienta saca a la luz un tipo de cuelgue que el uso normal nunca alcanza.
9.0 Entrega
- Especificación del protocolo: transportes, trama, tabla de mensajes, tabla de errores, timeouts, reglas de versión.
- Tabla GATT o descriptores USB.
- Herramienta de prueba en el host y sus scripts.
- Una sesión de ejemplo capturada para cada comando.
La página Firmware embebido describe el lado del dispositivo de este trabajo, y Web, nube y gestión de dispositivos trata las apps y los back ends que hablan con dispositivos. Para revisar un protocolo existente, empiece por el formulario Hablar de un proyecto.
Referencias
- Bluetooth Core Specification: https://www.bluetooth.com/specifications/specs/core-specification/
- Bluetooth Assigned Numbers: https://www.bluetooth.com/specifications/assigned-numbers/
- USB Class Definitions for Communication Devices 1.2: https://www.usb.org/document-library/class-definitions-communication-devices-12
- USB Device Class Definition for HID: https://www.usb.org/hid
Preguntas frecuentes
¿Perfil BLE estándar o servicio propio?
Use un servicio estándar cuando encaje con los datos, como Battery o Device Information, porque las herramientas genéricas y los sistemas operativos lo entienden. Las funciones propias del producto necesitan un servicio propio. Un único servicio de tipo canal de mensajes mantiene estable esa parte propia a medida que se añaden funciones.
¿Qué codificación de payload conviene elegir?
Decida según el presupuesto de flash y RAM del dispositivo y la frecuencia con que espera que cambie el protocolo. Las estructuras fijas sirven para conjuntos de comandos pequeños y estables. TLV o CBOR cuestan más código, pero permiten añadir campos sin romper apps antiguas.
¿Cómo seguimos dando servicio a apps antiguas tras una actualización de firmware?
El comando de consulta de versión no cambia nunca, los campos nuevos se añaden como opcionales y los lectores ignoran los campos desconocidos. Los cambios incompatibles van a una nueva versión mayor, y la anterior se mantiene durante un periodo que se anota en las notas de versión de ambos lados.
¿El mismo protocolo puede funcionar sobre BLE y USB?
Para eso se mantienen las tramas y los mensajes independientes del transporte. Solo cambia el adaptador de transporte. Así las herramientas de prueba en fábrica y de recuperación pueden usar un cable mientras la app del producto usa BLE.
¿Cuándo hay que escribir el protocolo?
Antes de que el trabajo de firmware y app empiece en serio. Un primer borrador puede ser corto: transportes, trama, cinco o seis comandos y la tabla de errores. A partir de ahí cambia mediante revisiones, no mediante depuración.