@jjlmoya/utils-hardware 1.24.0 → 1.26.0

package/src/tool/webUsbSerialMonitor/i18n/en.ts

@@ -0,0 +1,241 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { WebUsbSerialMonitorUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'web-usb-serial-monitor';
+const title = 'WebUSB Serial Monitor';
+const description = 'Connect to USB serial hardware from the browser, read live terminal output, send commands, and debug Arduino, ESP32, RP2040, and maker boards without installing a desktop terminal.';
+
+const faqData = [
+  {
+    question: 'Does this serial monitor work with Arduino, ESP32, and Raspberry Pi Pico boards?',
+    answer: 'Yes, when the board exposes a USB serial interface supported by Web Serial and the browser is Chromium-based. Common Arduino, ESP32, RP2040, CH340, CP210x, and FTDI adapters usually work after the user grants permission.',
+  },
+  {
+    question: 'Why is this called WebUSB if it uses Web Serial?',
+    answer: 'Most maker boards connect over USB, but browser terminal access is provided by the Web Serial API. WebUSB is lower-level and is not the right abstraction for a simple UART-style terminal.',
+  },
+  {
+    question: 'Can a website access my serial devices without permission?',
+    answer: 'No. The browser requires a user click and a native device picker before a site can open a serial port. This tool does not store terminal logs or device identifiers.',
+  },
+  {
+    question: 'Which browser should I use for a web serial terminal?',
+    answer: 'Use Chrome, Edge, or another Chromium-based browser over HTTPS or localhost. Firefox, Safari, and many iOS browsers do not expose the Web Serial API.',
+  },
+  {
+    question: 'What baud rate should I choose?',
+    answer: 'Choose the baud rate configured in your firmware. Arduino examples often use 9600 or 115200, while faster logs, bootloaders, and high-rate sensor streams may use 230400, 460800, or 921600.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Connect the USB serial device',
+    text: 'Plug in the board or adapter and close any other serial terminal that may already have the port open.',
+  },
+  {
+    name: 'Select the baud rate',
+    text: 'Pick the same baud rate used by the firmware, such as 115200 for many Arduino, ESP32, and RP2040 sketches.',
+  },
+  {
+    name: 'Grant browser permission',
+    text: 'Press Connect, choose the serial device in the browser picker, and allow the page to open the port.',
+  },
+  {
+    name: 'Read and send terminal data',
+    text: 'Watch incoming logs in the terminal, send commands with optional CRLF line endings, and clear or pause the live output when needed.',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'DeveloperApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
+  inLanguage: 'en',
+};
+
+export const content: ToolLocaleContent<WebUsbSerialMonitorUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  bibliography,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Online Serial Monitor for USB Maker Hardware',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'This browser serial monitor opens a USB serial port directly from Chrome or Edge, then streams text from microcontrollers, USB UART bridges, development boards, bootloaders, test fixtures, sensors, and lab hardware. It is designed for quick diagnostics when you need a serial console but do not want to install a desktop IDE or terminal application.',
+    },
+    {
+      type: 'message',
+      title: 'Browser permission boundary',
+      html: 'The page cannot silently enumerate or open your serial devices. Access starts only after you press Connect and choose a port in the browser picker. Terminal data stays in the current tab unless you copy it yourself.',
+    },
+    {
+      type: 'stats',
+      items: [
+        { value: '9600-921600', label: 'common baud presets' },
+        { value: 'CRLF', label: 'optional command ending' },
+        { value: 'local', label: 'terminal session' },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'When a Web Serial Terminal Is Useful',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        'Checking boot messages from Arduino, ESP32, ESP8266, RP2040, STM32, or custom firmware.',
+        'Sending AT commands to modem, GPS, LoRa, Wi-Fi, Bluetooth, or cellular modules through a USB UART adapter.',
+        'Reading sensor output from a factory test jig, classroom lab, robotics controller, or bench prototype.',
+        'Verifying that a USB serial bridge driver, cable, board power, and firmware baud rate are all working together.',
+        'Collecting a quick error log before filing a bug or asking for hardware support.',
+      ],
+    },
+    {
+      type: 'comparative',
+      items: [
+        {
+          title: 'Web serial monitor',
+          description: 'Best for quick support, classroom instructions, field diagnostics, and maker workflows where opening a URL is faster than installing an IDE.',
+        },
+        {
+          title: 'Desktop terminal',
+          description: 'Better for binary protocols, long capture sessions, scripting, hardware flow control, macros, and environments where browser APIs are blocked.',
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Baud Rate and Line Ending Checklist',
+      level: 3,
+    },
+    {
+      type: 'table',
+      headers: ['Setting', 'Typical choice', 'What goes wrong when it is wrong'],
+      rows: [
+        ['Baud rate', '115200 for many modern boards, 9600 for older examples.', 'Readable text turns into random symbols or no useful log appears.'],
+        ['Line ending', 'CRLF for many command parsers, no ending for raw character protocols.', 'Commands are ignored because the firmware is waiting for a terminator.'],
+        ['Exclusive port access', 'Close Arduino Serial Monitor, PuTTY, screen, minicom, or vendor tools.', 'The browser picker opens the port but reading or writing fails.'],
+        ['Secure context', 'HTTPS or localhost.', 'The Serial API is missing even in a supported browser.'],
+      ],
+    },
+    {
+      type: 'diagnostic',
+      variant: 'warning',
+      title: 'No serial output?',
+      html: 'Confirm the board is powered and the USB cable supports data, not charging only. Try 9600, 57600, and 115200 if you do not know the firmware baud rate. Press reset after connecting because many boards print boot logs only during startup. Close other software that may still own the serial port, and install the operating system driver for CH340, CP210x, FTDI, or the board vendor if the device never appears.',
+    },
+    {
+      type: 'title',
+      text: 'Privacy, Security, and Limits',
+      level: 3,
+    },
+    {
+      type: 'proscons',
+      title: 'Web Serial strengths and limits',
+      items: [
+        {
+          pro: 'No desktop installation for basic serial text diagnostics.',
+          con: 'Requires a Chromium-based browser and a secure context.',
+        },
+        {
+          pro: 'Browser picker limits access to the specific port you choose.',
+          con: 'Not intended for binary protocol analyzers or long unattended captures.',
+        },
+        {
+          pro: 'Works well for text logs, command prompts, and quick hardware checks.',
+          con: 'Some corporate policies, mobile browsers, and operating systems block Web Serial.',
+        },
+      ],
+    },
+  ],
+  ui: {
+    unsupportedTitle: 'Web Serial is not available',
+    unsupportedBody: 'Use Chrome or Edge over HTTPS or localhost, and make sure your device exposes a USB serial interface.',
+    secureContext: 'Web Serial requires HTTPS or localhost. Reload this page from a secure origin and try again.',
+    statusIdle: 'Choose a baud rate, then connect a USB serial device',
+    statusPermission: 'Waiting for the browser serial port picker',
+    statusOpening: 'Opening serial port',
+    statusConnected: 'Serial port connected',
+    statusDisconnected: 'Serial port disconnected',
+    statusError: 'Serial connection failed',
+    connect: 'Connect Serial',
+    disconnect: 'Disconnect',
+    send: 'Send',
+    clear: 'Clear',
+    pause: 'Pause',
+    resume: 'Resume',
+    baudRate: 'Baud rate',
+    newline: 'Append CRLF',
+    inputPlaceholder: 'Type a command, then press Enter',
+    portFallback: 'No port selected',
+    portLabel: 'Port identity',
+    connectedDeviceLabel: 'Connected device',
+    deviceNameFallback: 'USB serial device',
+    transportLabel: 'Web Serial link',
+    bytesLabel: 'Bytes',
+    linesLabel: 'Lines',
+    privacyTitle: 'Permission gated',
+    privacyBody: 'The browser only exposes the serial device you select. Logs stay in this tab unless you copy them.',
+    emptyLog: 'Terminal output will appear here after you connect a serial device.',
+    copied: 'Copied',
+    copyLog: 'Copy',
+    presetSlow: '9600',
+    presetArduino: '115200',
+    presetFast: '921600',
+    terminalLabel: 'Live terminal',
+    unknownUsbId: 'N/A',
+    logDirectionRx: 'rx',
+    logDirectionTx: 'tx',
+    logDirectionSys: 'sys',
+    vidPrefix: 'VID ',
+    pidSeparator: ' / PID ',
+    baudUnit: ' baud',
+    vendorFtdi: 'FTDI USB Serial',
+    vendorSilabs: 'Silicon Labs CP210x',
+    vendorCh340: 'CH340 USB Serial',
+    vendorArduinoUsb: 'Arduino USB Serial',
+    vendorAdafruit: 'Adafruit USB Serial',
+    vendorRp2040: 'Raspberry Pi RP2040',
+    vendorEspressif: 'Espressif USB Serial',
+    vendorOpenSource: 'Open source USB Serial',
+  },
+};

package/src/tool/webUsbSerialMonitor/i18n/es.ts

@@ -0,0 +1,241 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { WebUsbSerialMonitorUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'monitor-serie-webusb';
+const title = 'Monitor Serie WebUSB';
+const description = 'Conéctate a hardware serie USB desde el navegador, lee la salida del terminal en vivo, envía comandos y depura placas Arduino, ESP32, RP2040 y maker sin instalar un terminal de escritorio.';
+
+const faqData = [
+  {
+    question: '¿Funciona este monitor serie con placas Arduino, ESP32 y Raspberry Pi Pico?',
+    answer: 'Sí, cuando la placa expone una interfaz serie USB compatible con Web Serial y el navegador está basado en Chromium. Los adaptadores comunes Arduino, ESP32, RP2040, CH340, CP210x y FTDI suelen funcionar después de que el usuario concede permiso.',
+  },
+  {
+    question: '¿Por qué se llama WebUSB si utiliza Web Serial?',
+    answer: 'La mayoría de las placas maker se conectan por USB, pero el acceso al terminal del navegador lo proporciona la API Web Serial. WebUSB es de más bajo nivel y no es la abstracción adecuada para un terminal simple estilo UART.',
+  },
+  {
+    question: '¿Puede un sitio web acceder a mis dispositivos serie sin permiso?',
+    answer: 'No. El navegador requiere un clic del usuario y un selector nativo de dispositivos antes de que un sitio pueda abrir un puerto serie. Esta herramienta no almacena registros del terminal ni identificadores de dispositivos.',
+  },
+  {
+    question: '¿Qué navegador debo usar para un terminal serie web?',
+    answer: 'Usa Chrome, Edge u otro navegador basado en Chromium mediante HTTPS o localhost. Firefox, Safari y muchos navegadores iOS no exponen la API Web Serial.',
+  },
+  {
+    question: '¿Qué velocidad de baudios debo elegir?',
+    answer: 'Elige la velocidad de baudios configurada en tu firmware. Los ejemplos de Arduino suelen usar 9600 o 115200, mientras que registros más rápidos, bootloaders y flujos de sensores de alta velocidad pueden usar 230400, 460800 o 921600.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Conecta el dispositivo serie USB',
+    text: 'Enchufa la placa o adaptador y cierra cualquier otro terminal serie que pueda tener el puerto abierto.',
+  },
+  {
+    name: 'Selecciona la velocidad de baudios',
+    text: 'Elige la misma velocidad de baudios que usa el firmware, como 115200 para muchos sketches de Arduino, ESP32 y RP2040.',
+  },
+  {
+    name: 'Concede permiso al navegador',
+    text: 'Pulsa Conectar, elige el dispositivo serie en el selector del navegador y permite que la página abra el puerto.',
+  },
+  {
+    name: 'Lee y envía datos del terminal',
+    text: 'Observa los registros entrantes en el terminal, envía comandos con terminaciones de línea CRLF opcionales y limpia o pausa la salida en vivo cuando sea necesario.',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'DeveloperApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
+  inLanguage: 'es',
+};
+
+export const content: ToolLocaleContent<WebUsbSerialMonitorUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  bibliography,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Monitor Serie Online para Hardware USB Maker',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Este monitor serie de navegador abre un puerto serie USB directamente desde Chrome o Edge, luego transmite texto desde microcontroladores, puentes USB UART, placas de desarrollo, bootloaders, dispositivos de prueba, sensores y hardware de laboratorio. Está diseñado para diagnósticos rápidos cuando necesitas una consola serie pero no quieres instalar un IDE de escritorio o una aplicación de terminal.',
+    },
+    {
+      type: 'message',
+      title: 'Límite de permiso del navegador',
+      html: 'La página no puede enumerar ni abrir silenciosamente tus dispositivos serie. El acceso comienza solo después de que pulses Conectar y elijas un puerto en el selector del navegador. Los datos del terminal permanecen en la pestaña actual a menos que los copies tú mismo.',
+    },
+    {
+      type: 'stats',
+      items: [
+        { value: '9600-921600', label: 'preajustes de baudios comunes' },
+        { value: 'CRLF', label: 'terminación de comando opcional' },
+        { value: 'local', label: 'sesión de terminal' },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Cuándo es Útil un Terminal Serie Web',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        'Verificar mensajes de arranque de Arduino, ESP32, ESP8266, RP2040, STM32 o firmware personalizado.',
+        'Enviar comandos AT a módems, GPS, LoRa, Wi-Fi, Bluetooth o módulos celulares a través de un adaptador USB UART.',
+        'Leer la salida de sensores de un banco de pruebas de fábrica, laboratorio escolar, controlador robótico o prototipo de banco.',
+        'Verificar que un controlador de puente serie USB, cable, alimentación de la placa y velocidad de baudios del firmware funcionen juntos.',
+        'Recopilar un registro de errores rápido antes de presentar un bug o solicitar soporte de hardware.',
+      ],
+    },
+    {
+      type: 'comparative',
+      items: [
+        {
+          title: 'Monitor serie web',
+          description: 'Ideal para soporte rápido, instrucciones en clase, diagnósticos de campo y flujos de trabajo maker donde abrir una URL es más rápido que instalar un IDE.',
+        },
+        {
+          title: 'Terminal de escritorio',
+          description: 'Mejor para protocolos binarios, sesiones largas de captura, scripting, control de flujo por hardware, macros y entornos donde las APIs del navegador están bloqueadas.',
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Lista de Verificación de Baudios y Fin de Línea',
+      level: 3,
+    },
+    {
+      type: 'table',
+      headers: ['Configuración', 'Elección típica', 'Qué falla cuando es incorrecto'],
+      rows: [
+        ['Velocidad de baudios', '115200 para muchas placas modernas, 9600 para ejemplos antiguos.', 'El texto legible se convierte en símbolos aleatorios o no aparece ningún registro útil.'],
+        ['Fin de línea', 'CRLF para muchos analizadores de comandos, sin terminación para protocolos de caracteres sin procesar.', 'Los comandos se ignoran porque el firmware espera un terminador.'],
+        ['Acceso exclusivo al puerto', 'Cierra Arduino Serial Monitor, PuTTY, screen, minicom o herramientas del fabricante.', 'El selector del navegador abre el puerto pero la lectura o escritura falla.'],
+        ['Contexto seguro', 'HTTPS o localhost.', 'La API Serial falta incluso en un navegador compatible.'],
+      ],
+    },
+    {
+      type: 'diagnostic',
+      variant: 'warning',
+      title: '¿Sin salida serie?',
+      html: 'Confirma que la placa está alimentada y que el cable USB admite datos, no solo carga. Prueba 9600, 57600 y 115200 si no conoces la velocidad de baudios del firmware. Pulsa reset después de conectar porque muchas placas imprimen registros de arranque solo durante el inicio. Cierra otro software que pueda tener el puerto serie abierto e instala el controlador del sistema operativo para CH340, CP210x, FTDI o el fabricante de la placa si el dispositivo nunca aparece.',
+    },
+    {
+      type: 'title',
+      text: 'Privacidad, Seguridad y Límites',
+      level: 3,
+    },
+    {
+      type: 'proscons',
+      title: 'Fortalezas y límites de Web Serial',
+      items: [
+        {
+          pro: 'Sin instalación de escritorio para diagnósticos básicos de texto serie.',
+          con: 'Requiere un navegador basado en Chromium y un contexto seguro.',
+        },
+        {
+          pro: 'El selector del navegador limita el acceso al puerto específico que elijas.',
+          con: 'No está destinado a analizadores de protocolos binarios o capturas largas sin supervisión.',
+        },
+        {
+          pro: 'Funciona bien para registros de texto, líneas de comandos y verificaciones rápidas de hardware.',
+          con: 'Algunas políticas corporativas, navegadores móviles y sistemas operativos bloquean Web Serial.',
+        },
+      ],
+    },
+  ],
+  ui: {
+    unsupportedTitle: 'Web Serial no está disponible',
+    unsupportedBody: 'Usa Chrome o Edge mediante HTTPS o localhost y asegúrate de que tu dispositivo exponga una interfaz serie USB.',
+    secureContext: 'Web Serial requiere HTTPS o localhost. Recarga esta página desde un origen seguro e inténtalo de nuevo.',
+    statusIdle: 'Elige una velocidad de baudios y conecta un dispositivo serie USB',
+    statusPermission: 'Esperando el selector de puerto serie del navegador',
+    statusOpening: 'Abriendo puerto serie',
+    statusConnected: 'Puerto serie conectado',
+    statusDisconnected: 'Puerto serie desconectado',
+    statusError: 'Conexión serie fallida',
+    connect: 'Conectar Serie',
+    disconnect: 'Desconectar',
+    send: 'Enviar',
+    clear: 'Limpiar',
+    pause: 'Pausa',
+    resume: 'Reanudar',
+    baudRate: 'Baudios',
+    newline: 'Añadir CRLF',
+    inputPlaceholder: 'Escribe un comando y pulsa Enter',
+    portFallback: 'Sin puerto seleccionado',
+    portLabel: 'Identidad del puerto',
+    connectedDeviceLabel: 'Dispositivo conectado',
+    deviceNameFallback: 'Dispositivo serie USB',
+    transportLabel: 'Enlace Web Serial',
+    bytesLabel: 'Bytes',
+    linesLabel: 'Líneas',
+    privacyTitle: 'Acceso controlado',
+    privacyBody: 'El navegador solo expone el dispositivo serie que seleccionas. Los registros permanecen en esta pestaña a menos que los copies.',
+    emptyLog: 'La salida del terminal aparecerá aquí después de conectar un dispositivo serie.',
+    copied: 'Copiado',
+    copyLog: 'Copiar',
+    presetSlow: '9600',
+    presetArduino: '115200',
+    presetFast: '921600',
+    terminalLabel: 'Terminal en vivo',
+    unknownUsbId: 'N/A',
+    logDirectionRx: 'rx',
+    logDirectionTx: 'tx',
+    logDirectionSys: 'sys',
+    vidPrefix: 'VID ',
+    pidSeparator: ' / PID ',
+    baudUnit: ' baudios',
+    vendorFtdi: 'FTDI USB Serial',
+    vendorSilabs: 'Silicon Labs CP210x',
+    vendorCh340: 'CH340 USB Serial',
+    vendorArduinoUsb: 'Arduino USB Serial',
+    vendorAdafruit: 'Adafruit USB Serial',
+    vendorRp2040: 'Raspberry Pi RP2040',
+    vendorEspressif: 'Espressif USB Serial',
+    vendorOpenSource: 'Open Source USB Serial',
+  },
+};