@jjlmoya/utils-hardware 1.24.0 → 1.26.0

package/src/tool/webUsbSerialMonitor/i18n/it.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-seriale-webusb';
+const title = 'Monitor Seriale WebUSB';
+const description = 'Collegati all\'hardware seriale USB dal browser, leggi l\'output del terminale in tempo reale, invia comandi ed esegui il debug di schede Arduino, ESP32, RP2040 e maker senza installare un terminale desktop.';
+
+const faqData = [
+  {
+    question: 'Questo monitor seriale funziona con schede Arduino, ESP32 e Raspberry Pi Pico?',
+    answer: 'Sì, quando la scheda espone un\'interfaccia seriale USB supportata da Web Serial e il browser è basato su Chromium. Gli adattatori comuni Arduino, ESP32, RP2040, CH340, CP210x e FTDI di solito funzionano dopo che l\'utente concede l\'autorizzazione.',
+  },
+  {
+    question: 'Perché si chiama WebUSB se utilizza Web Serial?',
+    answer: 'La maggior parte delle schede maker si connette via USB, ma l\'accesso al terminale del browser è fornito dall\'API Web Serial. WebUSB è di livello inferiore e non è l\'astrazione giusta per un semplice terminale in stile UART.',
+  },
+  {
+    question: 'Un sito web può accedere ai miei dispositivi seriali senza permesso?',
+    answer: 'No. Il browser richiede un clic dell\'utente e un selettore dispositivi nativo prima che un sito possa aprire una porta seriale. Questo strumento non memorizza i log del terminale né gli identificatori dei dispositivi.',
+  },
+  {
+    question: 'Quale browser dovrei usare per un terminale seriale web?',
+    answer: 'Usa Chrome, Edge o un altro browser basato su Chromium su HTTPS o localhost. Firefox, Safari e molti browser iOS non espongono l\'API Web Serial.',
+  },
+  {
+    question: 'Quale baud rate dovrei scegliere?',
+    answer: 'Scegli il baud rate configurato nel tuo firmware. Gli esempi Arduino usano spesso 9600 o 115200, mentre log più veloci, bootloader e flussi di sensori ad alta velocità possono usare 230400, 460800 o 921600.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Collega il dispositivo seriale USB',
+    text: 'Collega la scheda o l\'adattatore e chiudi qualsiasi altro terminale seriale che potrebbe avere la porta già aperta.',
+  },
+  {
+    name: 'Seleziona il baud rate',
+    text: 'Scegli lo stesso baud rate usato dal firmware, come 115200 per molti sketch Arduino, ESP32 e RP2040.',
+  },
+  {
+    name: 'Concedi l\'autorizzazione del browser',
+    text: 'Premi Connetti, scegli il dispositivo seriale nel selettore del browser e consenti alla pagina di aprire la porta.',
+  },
+  {
+    name: 'Leggi e invia dati del terminale',
+    text: 'Osserva i log in arrivo nel terminale, invia comandi con terminazioni di riga CRLF opzionali e cancella o metti in pausa l\'output in tempo reale quando necessario.',
+  },
+];
+
+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: 'it',
+};
+
+export const content: ToolLocaleContent<WebUsbSerialMonitorUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  bibliography,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Monitor Seriale Online per Hardware USB Maker',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Questo monitor seriale del browser apre una porta seriale USB direttamente da Chrome o Edge, quindi trasmette testo da microcontrollori, ponti USB UART, schede di sviluppo, bootloader, dispositivi di test, sensori e hardware di laboratorio. È progettato per diagnostica rapida quando hai bisogno di una console seriale ma non vuoi installare un IDE desktop o un\'applicazione terminale.',
+    },
+    {
+      type: 'message',
+      title: 'Limite di autorizzazione del browser',
+      html: 'La pagina non può enumerare o aprire silenziosamente i tuoi dispositivi seriali. L\'accesso inizia solo dopo aver premuto Connetti e scelto una porta nel selettore del browser. I dati del terminale rimangono nella scheda corrente a meno che tu non li copi.',
+    },
+    {
+      type: 'stats',
+      items: [
+        { value: '9600-921600', label: 'preset baud comuni' },
+        { value: 'CRLF', label: 'terminazione comando opzionale' },
+        { value: 'locale', label: 'sessione terminale' },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Quando un Terminale Seriale Web è Utile',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        'Controllare i messaggi di avvio da Arduino, ESP32, ESP8266, RP2040, STM32 o firmware personalizzato.',
+        'Inviare comandi AT a modem, GPS, LoRa, Wi-Fi, Bluetooth o moduli cellulari tramite un adattatore USB UART.',
+        'Leggere l\'output dei sensori da un banco di prova di fabbrica, laboratorio scolastico, controller robotico o prototipo da banco.',
+        'Verificare che driver bridge seriale USB, cavo, alimentazione della scheda e baud rate del firmware funzionino tutti insieme.',
+        'Raccogliere un rapido log degli errori prima di segnalare un bug o richiedere supporto hardware.',
+      ],
+    },
+    {
+      type: 'comparative',
+      items: [
+        {
+          title: 'Monitor seriale web',
+          description: 'Ideale per supporto rapido, istruzioni in classe, diagnostica sul campo e flussi di lavoro maker dove aprire un URL è più veloce che installare un IDE.',
+        },
+        {
+          title: 'Terminale desktop',
+          description: 'Migliore per protocolli binari, sessioni di acquisizione lunghe, scripting, controllo di flusso hardware, macro e ambienti in cui le API del browser sono bloccate.',
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Lista di Controllo Baud Rate e Terminazione di Riga',
+      level: 3,
+    },
+    {
+      type: 'table',
+      headers: ['Impostazione', 'Scelta tipica', 'Cosa non funziona quando è sbagliato'],
+      rows: [
+        ['Baud rate', '115200 per molte schede moderne, 9600 per esempi più vecchi.', 'Il testo leggibile diventa simboli casuali o non appare alcun log utile.'],
+        ['Terminazione di riga', 'CRLF per molti parser di comandi, nessuna terminazione per protocolli a caratteri grezzi.', 'I comandi vengono ignorati perché il firmware attende un terminatore.'],
+        ['Accesso esclusivo alla porta', 'Chiudi Arduino Serial Monitor, PuTTY, screen, minicom o strumenti del produttore.', 'Il selettore del browser apre la porta ma la lettura o scrittura fallisce.'],
+        ['Contesto sicuro', 'HTTPS o localhost.', 'L\'API Serial è assente anche in un browser supportato.'],
+      ],
+    },
+    {
+      type: 'diagnostic',
+      variant: 'warning',
+      title: 'Nessun output seriale?',
+      html: 'Conferma che la scheda sia alimentata e che il cavo USB supporti i dati, non solo la ricarica. Prova 9600, 57600 e 115200 se non conosci il baud rate del firmware. Premi reset dopo la connessione perché molte schede stampano i log di avvio solo all\'avvio. Chiudi altri software che potrebbero ancora possedere la porta seriale e installa il driver del sistema operativo per CH340, CP210x, FTDI o il produttore della scheda se il dispositivo non appare mai.',
+    },
+    {
+      type: 'title',
+      text: 'Privacy, Sicurezza e Limiti',
+      level: 3,
+    },
+    {
+      type: 'proscons',
+      title: 'Punti di forza e limiti di Web Serial',
+      items: [
+        {
+          pro: 'Nessuna installazione desktop per diagnostica di testo seriale di base.',
+          con: 'Richiede un browser basato su Chromium e un contesto sicuro.',
+        },
+        {
+          pro: 'Il selettore del browser limita l\'accesso alla porta specifica che scegli.',
+          con: 'Non destinato ad analizzatori di protocolli binari o acquisizioni lunghe non presidiate.',
+        },
+        {
+          pro: 'Funziona bene per log di testo, prompt dei comandi e controlli rapidi dell\'hardware.',
+          con: 'Alcune policy aziendali, browser mobili e sistemi operativi bloccano Web Serial.',
+        },
+      ],
+    },
+  ],
+  ui: {
+    unsupportedTitle: 'Web Serial non è disponibile',
+    unsupportedBody: 'Usa Chrome o Edge su HTTPS o localhost e assicurati che il tuo dispositivo esponga un\'interfaccia seriale USB.',
+    secureContext: 'Web Serial richiede HTTPS o localhost. Ricarica questa pagina da un\'origine sicura e riprova.',
+    statusIdle: 'Scegli un baud rate, quindi connetti un dispositivo seriale USB',
+    statusPermission: 'In attesa del selettore porta seriale del browser',
+    statusOpening: 'Apertura porta seriale',
+    statusConnected: 'Porta seriale connessa',
+    statusDisconnected: 'Porta seriale disconnessa',
+    statusError: 'Connessione seriale fallita',
+    connect: 'Connetti Seriale',
+    disconnect: 'Disconnetti',
+    send: 'Invia',
+    clear: 'Cancella',
+    pause: 'Pausa',
+    resume: 'Riprendi',
+    baudRate: 'Baud rate',
+    newline: 'Aggiungi CRLF',
+    inputPlaceholder: 'Digita un comando, poi premi Invio',
+    portFallback: 'Nessuna porta selezionata',
+    portLabel: 'Identità porta',
+    connectedDeviceLabel: 'Dispositivo connesso',
+    deviceNameFallback: 'Dispositivo seriale USB',
+    transportLabel: 'Collegamento Web Serial',
+    bytesLabel: 'Byte',
+    linesLabel: 'Righe',
+    privacyTitle: 'Accesso controllato',
+    privacyBody: 'Il browser espone solo il dispositivo seriale che selezioni. I log rimangono in questa scheda a meno che tu non li copi.',
+    emptyLog: 'L\'output del terminale apparirà qui dopo aver connesso un dispositivo seriale.',
+    copied: 'Copiato',
+    copyLog: 'Copia',
+    presetSlow: '9600',
+    presetArduino: '115200',
+    presetFast: '921600',
+    terminalLabel: 'Terminale in diretta',
+    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/ja.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: 'ja',
+};
+
+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、Bluetooth、またはセルラーモジュールへの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: 'コマンドを入力し、Enterを押してください',
+    portFallback: 'ポートが選択されていません',
+    portLabel: 'ポートID',
+    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: ' 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',
+  },
+};