@jjlmoya/utils-hardware 1.25.0 → 1.27.0

package/src/tool/webUsbSerialMonitor/i18n/tr.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-seri-monitor';
+const title = 'WebUSB Seri Monitör';
+const description = 'Tarayıcıdan USB seri donanıma bağlanın, canlı terminal çıktısını okuyun, komutlar gönderin ve Arduino, ESP32, RP2040 ve maker kartlarını masaüstü terminali kurmadan hata ayıklayın.';
+
+const faqData = [
+  {
+    question: 'Bu seri monitör Arduino, ESP32 ve Raspberry Pi Pico kartlarıyla çalışır mı?',
+    answer: 'Evet, kart Web Serial tarafından desteklenen bir USB seri arabirimi sunduğunda ve tarayıcı Chromium tabanlı olduğunda çalışır. Yaygın Arduino, ESP32, RP2040, CH340, CP210x ve FTDI adaptörleri genellikle kullanıcı izin verdikten sonra çalışır.',
+  },
+  {
+    question: 'Web Serial kullanıyorsa neden WebUSB olarak adlandırılıyor?',
+    answer: 'Çoğu maker kartı USB üzerinden bağlanır, ancak tarayıcı terminal erişimi Web Serial API tarafından sağlanır. WebUSB daha düşük seviyelidir ve basit bir UART tarzı terminal için doğru soyutlama değildir.',
+  },
+  {
+    question: 'Bir web sitesi izinsiz olarak seri cihazlarıma erişebilir mi?',
+    answer: 'Hayır. Tarayıcı, bir site seri portu açmadan önce kullanıcı tıklaması ve yerel cihaz seçici gerektirir. Bu araç terminal günlüklerini veya cihaz tanımlayıcılarını saklamaz.',
+  },
+  {
+    question: 'Web seri terminali için hangi tarayıcıyı kullanmalıyım?',
+    answer: 'HTTPS veya localhost üzerinden Chrome, Edge veya başka bir Chromium tabanlı tarayıcı kullanın. Firefox, Safari ve birçok iOS tarayıcısı Web Serial API\'yi sunmaz.',
+  },
+  {
+    question: 'Hangi baud hızını seçmeliyim?',
+    answer: 'Firmware\'inizde yapılandırılan baud hızını seçin. Arduino örnekleri genellikle 9600 veya 115200 kullanırken, daha hızlı günlükler, bootloader\'lar ve yüksek hızlı sensör akışları 230400, 460800 veya 921600 kullanabilir.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'USB seri cihazı bağlayın',
+    text: 'Kartı veya adaptörü takın ve portu zaten açmış olabilecek diğer seri terminalleri kapatın.',
+  },
+  {
+    name: 'Baud hızını seçin',
+    text: 'Birçok Arduino, ESP32 ve RP2040 taslağı için 115200 gibi, firmware tarafından kullanılan aynı baud hızını seçin.',
+  },
+  {
+    name: 'Tarayıcı izni verin',
+    text: 'Bağlan\'a basın, tarayıcı seçicide seri cihazı seçin ve sayfanın portu açmasına izin verin.',
+  },
+  {
+    name: 'Terminal verilerini okuyun ve gönderin',
+    text: 'Terminalde gelen günlükleri izleyin, isteğe bağlı CRLF satır sonlarıyla komutlar gönderin ve gerektiğinde canlı çıktıyı temizleyin veya duraklatın.',
+  },
+];
+
+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: 'tr',
+};
+
+export const content: ToolLocaleContent<WebUsbSerialMonitorUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  bibliography,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'USB Maker Donanımı için Çevrimiçi Seri Monitör',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Bu tarayıcı seri monitörü, doğrudan Chrome veya Edge\'den bir USB seri portu açar, ardından mikrodenetleyicilerden, USB UART köprülerinden, geliştirme kartlarından, bootloader\'lardan, test düzeneklerinden, sensörlerden ve laboratuvar donanımından metin akışı sağlar. Bir masaüstü IDE veya terminal uygulaması kurmak istemediğinizde seri konsola ihtiyaç duyduğunuz hızlı teşhisler için tasarlanmıştır.',
+    },
+    {
+      type: 'message',
+      title: 'Tarayıcı izin sınırı',
+      html: 'Sayfa, seri cihazlarınızı sessizce listeleyemez veya açamaz. Erişim yalnızca Bağlan\'a basıp tarayıcı seçicide bir port seçtikten sonra başlar. Terminal verileri, siz kendiniz kopyalamadıkça geçerli sekmede kalır.',
+    },
+    {
+      type: 'stats',
+      items: [
+        { value: '9600-921600', label: 'yaygın baud ön ayarları' },
+        { value: 'CRLF', label: 'isteğe bağlı komut sonlandırma' },
+        { value: 'yerel', label: 'terminal oturumu' },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Web Seri Terminali Ne Zaman Kullanışlıdır',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        'Arduino, ESP32, ESP8266, RP2040, STM32 veya özel firmware\'den önyükleme mesajlarını kontrol etme.',
+        'Bir USB UART adaptörü aracılığıyla modem, GPS, LoRa, Wi-Fi, Bluetooth veya hücresel modüllere AT komutları gönderme.',
+        'Fabrika test düzeneği, sınıf laboratuvarı, robotik kontrolör veya tezgah prototipinden sensör çıktısı okuma.',
+        'Bir USB seri köprü sürücüsünün, kablonun, kart gücünün ve firmware baud hızının hep birlikte çalıştığını doğrulama.',
+        'Bir hata bildirmeden veya donanım desteği istemeden önce hızlı bir hata günlüğü toplama.',
+      ],
+    },
+    {
+      type: 'comparative',
+      items: [
+        {
+          title: 'Web seri monitör',
+          description: 'Hızlı destek, sınıf talimatları, saha teşhisleri ve URL açmanın IDE kurmaktan daha hızlı olduğu maker iş akışları için en iyisidir.',
+        },
+        {
+          title: 'Masaüstü terminali',
+          description: 'İkili protokoller, uzun yakalama oturumları, betikleme, donanım akış kontrolü, makrolar ve tarayıcı API\'lerinin engellendiği ortamlar için daha iyidir.',
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Baud Hızı ve Satır Sonu Kontrol Listesi',
+      level: 3,
+    },
+    {
+      type: 'table',
+      headers: ['Ayar', 'Tipik seçim', 'Yanlış olduğunda ne ters gider'],
+      rows: [
+        ['Baud hızı', 'Birçok modern kart için 115200, eski örnekler için 9600.', 'Okunabilir metin rastgele sembollere dönüşür veya hiçbir yararlı günlük görünmez.'],
+        ['Satır sonu', 'Birçok komut ayrıştırıcı için CRLF, ham karakter protokolleri için sonlandırma yok.', 'Firmware bir sonlandırıcı beklediği için komutlar yok sayılır.'],
+        ['Özel port erişimi', 'Arduino Serial Monitor, PuTTY, screen, minicom veya satıcı araçlarını kapatın.', 'Tarayıcı seçici portu açar ancak okuma veya yazma başarısız olur.'],
+        ['Güvenli bağlam', 'HTTPS veya localhost.', 'Desteklenen bir tarayıcıda bile Serial API eksiktir.'],
+      ],
+    },
+    {
+      type: 'diagnostic',
+      variant: 'warning',
+      title: 'Seri çıktı yok mu?',
+      html: 'Kartın güç aldığını ve USB kablosunun yalnızca şarj değil veri desteklediğini doğrulayın. Firmware baud hızını bilmiyorsanız 9600, 57600 ve 115200\'ü deneyin. Birçok kart yalnızca başlangıçta önyükleme günlükleri yazdırdığı için bağlandıktan sonra sıfırlamaya basın. Seri portu hâlâ elinde tutuyor olabilecek diğer yazılımları kapatın ve cihaz hiç görünmüyorsa CH340, CP210x, FTDI veya kart satıcısı için işletim sistemi sürücüsünü yükleyin.',
+    },
+    {
+      type: 'title',
+      text: 'Gizlilik, Güvenlik ve Sınırlamalar',
+      level: 3,
+    },
+    {
+      type: 'proscons',
+      title: 'Web Serial güçlü yönleri ve sınırlamaları',
+      items: [
+        {
+          pro: 'Temel seri metin teşhisi için masaüstü kurulumu gerekmez.',
+          con: 'Chromium tabanlı bir tarayıcı ve güvenli bir bağlam gerektirir.',
+        },
+        {
+          pro: 'Tarayıcı seçici, seçtiğiniz belirli porta erişimi sınırlar.',
+          con: 'İkili protokol analizörleri veya uzun süreli gözetimsiz yakalamalar için tasarlanmamıştır.',
+        },
+        {
+          pro: 'Metin günlükleri, komut istemleri ve hızlı donanım kontrolleri için iyi çalışır.',
+          con: 'Bazı kurumsal politikalar, mobil tarayıcılar ve işletim sistemleri Web Serial\'i engeller.',
+        },
+      ],
+    },
+  ],
+  ui: {
+    unsupportedTitle: 'Web Serial kullanılamıyor',
+    unsupportedBody: 'HTTPS veya localhost üzerinden Chrome veya Edge kullanın ve cihazınızın bir USB seri arabirimi sunduğundan emin olun.',
+    secureContext: 'Web Serial, HTTPS veya localhost gerektirir. Bu sayfayı güvenli bir kaynaktan yeniden yükleyip tekrar deneyin.',
+    statusIdle: 'Bir baud hızı seçin, ardından bir USB seri cihazı bağlayın',
+    statusPermission: 'Tarayıcı seri port seçici bekleniyor',
+    statusOpening: 'Seri port açılıyor',
+    statusConnected: 'Seri port bağlandı',
+    statusDisconnected: 'Seri port bağlantısı kesildi',
+    statusError: 'Seri bağlantı başarısız',
+    connect: 'Seri Bağlan',
+    disconnect: 'Bağlantıyı Kes',
+    send: 'Gönder',
+    clear: 'Temizle',
+    pause: 'Duraklat',
+    resume: 'Devam Et',
+    baudRate: 'Baud hızı',
+    newline: 'CRLF Ekle',
+    inputPlaceholder: 'Bir komut yazın, ardından Enter\'a basın',
+    portFallback: 'Port seçilmedi',
+    portLabel: 'Port kimliği',
+    connectedDeviceLabel: 'Bağlı cihaz',
+    deviceNameFallback: 'USB seri cihaz',
+    transportLabel: 'Web Serial bağlantısı',
+    bytesLabel: 'Bayt',
+    linesLabel: 'Satır',
+    privacyTitle: 'İzin kontrollü',
+    privacyBody: 'Tarayıcı yalnızca seçtiğiniz seri cihazı gösterir. Günlükler siz kopyalamadıkça bu sekmede kalır.',
+    emptyLog: 'Bir seri cihaz bağladıktan sonra terminal çıktısı burada görünecektir.',
+    copied: 'Kopyalandı',
+    copyLog: 'Kopyala',
+    presetSlow: '9600',
+    presetArduino: '115200',
+    presetFast: '921600',
+    terminalLabel: 'Canlı 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/zh.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 串口监视器';
+const description = '从浏览器连接 USB 串口硬件，读取实时终端输出，发送命令，无需安装桌面终端即可调试 Arduino、ESP32、RP2040 和创客板。';
+
+const faqData = [
+  {
+    question: '这个串口监视器支持 Arduino、ESP32 和 Raspberry Pi Pico 板吗？',
+    answer: '是的，当板卡提供 Web Serial 支持的 USB 串口接口，且浏览器基于 Chromium 时即可使用。常见的 Arduino、ESP32、RP2040、CH340、CP210x 和 FTDI 适配器在用户授予权限后通常可以正常工作。',
+  },
+  {
+    question: '为什么使用 Web Serial 却叫 WebUSB？',
+    answer: '大多数创客板通过 USB 连接，但浏览器终端访问由 Web Serial API 提供。WebUSB 是更低层的接口，不适合简单的 UART 风格终端。',
+  },
+  {
+    question: '网站可以在未经许可的情况下访问我的串口设备吗？',
+    answer: '不可以。浏览器要求用户点击并通过原生设备选择器选择设备后，网站才能打开串口。此工具不会存储终端日志或设备标识符。',
+  },
+  {
+    question: '我应该使用哪个浏览器进行 Web 串口终端连接？',
+    answer: '通过 HTTPS 或 localhost 使用 Chrome、Edge 或其他基于 Chromium 的浏览器。Firefox、Safari 和许多 iOS 浏览器不支持 Web Serial API。',
+  },
+  {
+    question: '我应该选择哪个波特率？',
+    answer: '选择固件中配置的波特率。Arduino 示例通常使用 9600 或 115200，而更快的日志、引导加载程序和高频传感器数据流可能使用 230400、460800 或 921600。',
+  },
+];
+
+const howToData = [
+  {
+    name: '连接 USB 串口设备',
+    text: '插入板卡或适配器，关闭可能已经占用该端口的其他串口终端。',
+  },
+  {
+    name: '选择波特率',
+    text: '选择与固件相同的波特率，例如许多 Arduino、ESP32 和 RP2040 示例使用 115200。',
+  },
+  {
+    name: '授予浏览器权限',
+    text: '点击连接，在浏览器选择器中选择串口设备，允许页面打开端口。',
+  },
+  {
+    name: '读取和发送终端数据',
+    text: '在终端中查看传入的日志，发送带有可选 CRLF 行尾的命令，并在需要时清除或暂停实时输出。',
+  },
+];
+
+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: 'zh',
+};
+
+export const content: ToolLocaleContent<WebUsbSerialMonitorUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  bibliography,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'USB 创客硬件在线串口监视器',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '此浏览器串口监视器直接从 Chrome 或 Edge 打开 USB 串口，然后从微控制器、USB UART 桥接器、开发板、引导加载程序、测试夹具、传感器和实验室硬件流式传输文本。专为需要串口控制台但不想安装桌面 IDE 或终端应用程序时的快速诊断而设计。',
+    },
+    {
+      type: 'message',
+      title: '浏览器权限边界',
+      html: '页面无法静默枚举或打开您的串口设备。只有在您点击连接并在浏览器选择器中选择端口后，访问才会开始。终端数据保留在当前标签页中，除非您自行复制。',
+    },
+    {
+      type: 'stats',
+      items: [
+        { value: '9600-921600', label: '常用波特率预设' },
+        { value: 'CRLF', label: '可选命令结尾' },
+        { value: '本地', label: '终端会话' },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Web 串口终端的适用场景',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        '检查 Arduino、ESP32、ESP8266、RP2040、STM32 或自定义固件的启动消息。',
+        '通过 USB UART 适配器向调制解调器、GPS、LoRa、Wi-Fi、蓝牙或蜂窝模块发送 AT 命令。',
+        '从工厂测试夹具、教室实验室、机器人控制器或台式原型读取传感器输出。',
+        '验证 USB 串口桥接驱动程序、线缆、板卡电源和固件波特率是否协同工作。',
+        '在提交错误报告或请求硬件支持之前收集快速错误日志。',
+      ],
+    },
+    {
+      type: 'comparative',
+      items: [
+        {
+          title: 'Web 串口监视器',
+          description: '最适合快速支持、课堂教学、现场诊断以及打开 URL 比安装 IDE 更快的创客工作流程。',
+        },
+        {
+          title: '桌面终端',
+          description: '更适合二进制协议、长时间捕获会话、脚本编写、硬件流控制、宏以及浏览器 API 被屏蔽的环境。',
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: '波特率和行尾检查清单',
+      level: 3,
+    },
+    {
+      type: 'table',
+      headers: ['设置', '典型选择', '错误时会出现的问题'],
+      rows: [
+        ['波特率', '许多现代板卡为 115200，旧示例为 9600。', '可读文本变成随机符号，或没有有用的日志出现。'],
+        ['行尾', '许多命令解析器使用 CRLF，原始字符协议无需结尾。', '命令被忽略，因为固件正在等待终止符。'],
+        ['独占端口访问', '关闭 Arduino 串口监视器、PuTTY、screen、minicom 或厂商工具。', '浏览器选择器打开端口，但读取或写入失败。'],
+        ['安全上下文', 'HTTPS 或 localhost。', '即使在受支持的浏览器中，串口 API 也缺失。'],
+      ],
+    },
+    {
+      type: 'diagnostic',
+      variant: 'warning',
+      title: '没有串口输出？',
+      html: '确认板卡已通电且 USB 线缆支持数据传输而不仅仅是充电。如果不知道固件波特率，请尝试 9600、57600 和 115200。连接后按复位键，因为许多板卡仅在启动时输出启动日志。关闭可能仍占用串口的其他软件，如果设备始终不出现，请安装 CH340、CP210x、FTDI 或板卡厂商的操作系统驱动程序。',
+    },
+    {
+      type: 'title',
+      text: '隐私、安全和限制',
+      level: 3,
+    },
+    {
+      type: 'proscons',
+      title: 'Web Serial 的优势和限制',
+      items: [
+        {
+          pro: '无需桌面安装即可进行基本串口文本诊断。',
+          con: '需要基于 Chromium 的浏览器和安全上下文。',
+        },
+        {
+          pro: '浏览器选择器限制仅访问您选择的特定端口。',
+          con: '不适用于二进制协议分析器或长时间无人值守的捕获。',
+        },
+        {
+          pro: '适用于文本日志、命令提示符和快速硬件检查。',
+          con: '某些企业策略、移动浏览器和操作系统会阻止 Web Serial。',
+        },
+      ],
+    },
+  ],
+  ui: {
+    unsupportedTitle: 'Web Serial 不可用',
+    unsupportedBody: '通过 HTTPS 或 localhost 使用 Chrome 或 Edge，并确保您的设备提供 USB 串口接口。',
+    secureContext: 'Web Serial 需要 HTTPS 或 localhost。请从安全来源重新加载此页面并重试。',
+    statusIdle: '选择波特率，然后连接 USB 串口设备',
+    statusPermission: '等待浏览器串口选择器',
+    statusOpening: '正在打开串口',
+    statusConnected: '串口已连接',
+    statusDisconnected: '串口已断开',
+    statusError: '串口连接失败',
+    connect: '连接串口',
+    disconnect: '断开连接',
+    send: '发送',
+    clear: '清除',
+    pause: '暂停',
+    resume: '继续',
+    baudRate: '波特率',
+    newline: '追加 CRLF',
+    inputPlaceholder: '输入命令，然后按回车键',
+    portFallback: '未选择端口',
+    portLabel: '端口标识',
+    connectedDeviceLabel: '已连接设备',
+    deviceNameFallback: 'USB 串口设备',
+    transportLabel: 'Web Serial 链路',
+    bytesLabel: '字节',
+    linesLabel: '行',
+    privacyTitle: '权限控制',
+    privacyBody: '浏览器仅公开您选择的串口设备。日志保留在此标签页中，除非您自行复制。',
+    emptyLog: '连接串口设备后，终端输出将显示在此处。',
+    copied: '已复制',
+    copyLog: '复制',
+    presetSlow: '9600',
+    presetArduino: '115200',
+    presetFast: '921600',
+    terminalLabel: '实时终端',
+    unknownUsbId: 'N/A',
+    logDirectionRx: 'rx',
+    logDirectionTx: 'tx',
+    logDirectionSys: 'sys',
+    vidPrefix: 'VID ',
+    pidSeparator: ' / PID ',
+    baudUnit: ' 波特',
+    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/index.ts

@@ -0,0 +1,12 @@
+import { webUsbSerialMonitor } from './entry';
+import type { ToolDefinition } from '../../types';
+
+export * from './entry';
+
+export const WEB_USB_SERIAL_MONITOR_TOOL: ToolDefinition = {
+  entry: webUsbSerialMonitor,
+  Component: () => import('./component.astro'),
+  SEOComponent: () => import('./seo.astro'),
+  BibliographyComponent: () => import('./bibliography.astro'),
+};
+

package/src/tool/webUsbSerialMonitor/logic.ts

@@ -0,0 +1,44 @@
+export interface SerialPortInfo {
+  usbVendorId?: number;
+  usbProductId?: number;
+}
+
+export interface SerialLineInput {
+  text: string;
+  appendNewline: boolean;
+}
+
+export interface SerialPortLabelInput {
+  info: SerialPortInfo;
+  fallback: string;
+  unknownUsbId?: string;
+  vidPrefix?: string;
+  pidSeparator?: string;
+}
+
+export const commonBaudRates = [9600, 19200, 38400, 57600, 115200, 230400, 460800, 921600];
+
+export function formatUsbId(value: number | undefined, unknownUsbId = 'N/A'): string {
+  if (typeof value !== 'number') return unknownUsbId;
+  return `0x${value.toString(16).toUpperCase().padStart(4, '0')}`;
+}
+
+export function buildSerialPortLabel(input: SerialPortLabelInput): string {
+  const unknownUsbId = input.unknownUsbId ?? 'N/A';
+  const vidPrefix = input.vidPrefix ?? 'VID ';
+  const pidSeparator = input.pidSeparator ?? ' / PID ';
+  const vendor = formatUsbId(input.info.usbVendorId, unknownUsbId);
+  const product = formatUsbId(input.info.usbProductId, unknownUsbId);
+  if (vendor === unknownUsbId && product === unknownUsbId) return input.fallback;
+  return `${vidPrefix}${vendor}${pidSeparator}${product}`;
+}
+
+export function encodeSerialLine(input: SerialLineInput): string {
+  const normalized = input.text.replace(/\r?\n/g, '');
+  return input.appendNewline ? `${normalized}\r\n` : normalized;
+}
+
+export function decodeSerialChunk(bytes: Uint8Array): string {
+  return new TextDecoder().decode(bytes);
+}
+

package/src/tool/webUsbSerialMonitor/seo.astro

@@ -0,0 +1,16 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { webUsbSerialMonitor } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'en' } = Astro.props;
+const content = await webUsbSerialMonitor.i18n[locale]?.();
+if (!content) return null;
+---
+
+{content.seo?.length > 0 && <SEORenderer content={{ locale, sections: content.seo }} />}
+

package/src/tool/webUsbSerialMonitor/ui.ts

@@ -0,0 +1,51 @@
+export interface WebUsbSerialMonitorUI extends Record<string, string> {
+  unsupportedTitle: string;
+  unsupportedBody: string;
+  secureContext: string;
+  statusIdle: string;
+  statusPermission: string;
+  statusOpening: string;
+  statusConnected: string;
+  statusDisconnected: string;
+  statusError: string;
+  connect: string;
+  disconnect: string;
+  send: string;
+  clear: string;
+  pause: string;
+  resume: string;
+  baudRate: string;
+  newline: string;
+  inputPlaceholder: string;
+  portFallback: string;
+  portLabel: string;
+  connectedDeviceLabel: string;
+  deviceNameFallback: string;
+  transportLabel: string;
+  bytesLabel: string;
+  linesLabel: string;
+  privacyTitle: string;
+  privacyBody: string;
+  emptyLog: string;
+  copied: string;
+  copyLog: string;
+  presetSlow: string;
+  presetArduino: string;
+  presetFast: string;
+  terminalLabel: string;
+  unknownUsbId: string;
+  logDirectionRx: string;
+  logDirectionTx: string;
+  logDirectionSys: string;
+  vidPrefix: string;
+  pidSeparator: string;
+  baudUnit: string;
+  vendorFtdi: string;
+  vendorSilabs: string;
+  vendorCh340: string;
+  vendorArduinoUsb: string;
+  vendorAdafruit: string;
+  vendorRp2040: string;
+  vendorEspressif: string;
+  vendorOpenSource: string;
+}