¿Hay que descargar o instalar algo?
En Chrome o Edge, no: la página usa la Web Serial API integrada en el navegador, sin cliente de escritorio ni extensión. En Firefox 151 y posteriores primero instalas el complemento de permisos del sitio que te pide; es el mecanismo de permisos del navegador, no un driver serie. En cualquier caso necesitas el driver del chip serie: si aparece un puerto COM en el Administrador de dispositivos, el driver funciona; si no, descárgalo de la web del fabricante del chip.
¿Qué navegadores funcionan? ¿Se puede usar en el móvil?
Chrome, Edge y Opera de escritorio (Chrome 89 y posteriores) se conectan directamente. Firefox 151 y posteriores de escritorio también funciona después de instalar el complemento de permisos del sitio que te pide. Safari e iOS no admiten Web Serial. Chrome para Android 138+ solo expone puertos serie Bluetooth (RFCOMM); el serie USB por cable requiere Chrome 148+ en Android 17, y además el propio teléfono tiene que exponer puertos serie por cable. Donde la página no puede conectarse lo indica, y el dispositivo demo sigue funcionando.
¿Se sube algún dato serie a un servidor?
No. Tu navegador lee y escribe en el puerto directamente, y la herramienta nunca envía a nuestros servidores los bytes que envías o recibes. El historial de envío y la configuración se guardan en tu propio navegador.
La lista de puertos sale vacía después de hacer clic en Elegir puerto y conectar. ¿Qué hago?
El sistema operativo no ha detectado ningún dispositivo serie. Comprueba que el cable transmite datos y no solo alimentación, y que la placa está alimentada. En Windows debería aparecer un puerto COM en el Administrador de dispositivos; si no aparece, instala el driver del chip (CH340, CP2102, etc.).
¿Por qué no se abre el puerto?
El navegador informa de cualquier fallo con el mismo mensaje, Failed to open serial port., así que la causa hay que encontrarla por descarte. Una causa habitual es que otro programa tenga ocupado el puerto: cierra otras herramientas serie, el monitor serie del Arduino IDE, un IDE que esté depurando u otra pestaña con esta herramienta. En Linux tu usuario debe pertenecer al grupo dialout (uucp en Arch). Comprueba también que el dispositivo sigue conectado y prueba una velocidad estándar: algunos drivers rechazan las poco habituales.
¿Cómo arreglo el texto chino ilegible?
Fíjate primero en las letras latinas y los dígitos. Si se ven bien y solo el chino sale ilegible, es un desajuste de codificación; un caso habitual es un dispositivo que envía GBK. La herramienta lo detecta, te ofrece cambiar y vuelve a mostrar lo ya recibido. Si las letras y los dígitos también salen ilegibles, la velocidad en baudios u otro ajuste no coincide con el dispositivo.
¿Cómo envío HEX? ¿Qué formatos se aceptan?
Cambia el modo de envío a HEX y escribe 01 03 00 0A, 0x01,0x03 o 0103000A, en mayúsculas o minúsculas. Los caracteres no válidos, como G, y las cantidades impares de dígitos se señalan, nunca se omiten, y los bytes que se van a escribir aparecen en vista previa bajo la entrada.
¿Cómo añado un CRC de Modbus y por qué va primero el byte bajo?
Pon Añadir suma de verificación en CRC-16/MODBUS y escribe solo la dirección, el código de función y los datos; el CRC se añade al final. Modbus RTU envía el CRC con el byte bajo primero: 0xCDC5 sale como C5 CD.
¿Por qué una trama se parte en dos líneas o varias tramas se juntan en una?
La vista HEX separa las tramas según el tiempo de silencio entre llegadas, 50 ms por defecto. Si el dispositivo hace una pausa más larga en mitad de una trama, la trama se parte; si las tramas llegan más seguidas, se juntan. Ajusta el intervalo de trama por encima de la pausa dentro de la trama y por debajo del hueco entre tramas.
¿Qué son DTR y RTS, y por qué se reinició mi placa al conectar?
DTR y RTS son dos líneas de control serie que muchas placas conectan a su circuito de reinicio. Cuando Chrome abre un puerto pone ambas líneas en activo — un detalle de implementación, no parte del estándar —, así que las placas que se reinician con DTR, como el Arduino Uno, suelen reiniciarse una vez al conectar, y una página web no puede evitarlo. En el circuito de autoprogramación habitual del ESP32, el chip funciona con normalidad mientras ambas líneas están activas y solo se mantiene en reset cuando RTS está activo y DTR no. Usa los interruptores después de conectar; si un ESP32 se queda en silencio, comprueba que no hayas desactivado solo DTR.
¿Puedo abrir el mismo puerto en otra herramienta serie a la vez?
En Windows, no: un puerto COM solo puede estar abierto en un programa a la vez. En Linux y macOS depende de si el primer programa pidió acceso exclusivo. Si lo pidió, abrir el puerto aquí falla; si no, ambos programas lo abren y se reparten los datos entrantes, lo que parece una pérdida de bytes. Usa un programa cada vez.
¿Se admiten velocidades en baudios personalizadas?
Sí. La última opción de la lista es Personalizada, donde puedes escribir cualquier velocidad, por ejemplo 74880, la velocidad a la que imprime la ROM de arranque del ESP8266. El navegador pasa el valor tal cual; que funcione depende del chip USB-serie y de su driver. Algunos lo redondean a la velocidad admitida más cercana y, en algunos sistemas, el puerto entonces no se abre.
¿Qué es el dispositivo demo?
Un microcontrolador simulado integrado en la página, para no necesitar hardware. Al conectar imprime un mensaje de arranque en GBK — una demostración lista del aviso de codificación — y luego informa de una temperatura cada 2 segundos. Responde OK a AT y ERROR a los demás comandos AT. Responde a una lectura Modbus de función 03 dirigida al esclavo 1 con un CRC correcto; como un esclavo real, se queda callado si el CRC es incorrecto o si la trama va a otra dirección. Todo lo demás lo devuelve en eco.