バーコード認識・OEM組込みの技術パートナー製品選定・サンプル評価のご相談 お問い合わせ
ホーム›技術情報

エンジニアリングガイド / ホストソフトウェア統合

USB HID と CDC: バーコード スキャナ統合ガイド

ホストがバーコード データを受信する方法を選択し、文字、メッセージ境界、デバイス ID、リカバリを検証します。

このページでは

USB バーコード スキャナは、テキスト フィールドに直接入力することも、アプリケーションがポートを開いてデータを受信するのを待つこともできます。どちらも USB を使用しますが、ホスト ソフトウェアは出力を異なる方法で処理します。

OEM デバイスまたは統合プロジェクトの場合は、受信アプリケーションから開始します。 キーボード入力を受け入れるのでしょうか、それともソフトウェアがスキャナ データを収集して処理するのでしょうか? その決定は、キャラクターの処理、開発作業、障害の回復とメンテナンスに影響を与えます。

このガイドでは、USB HID キーボード モードと USB CDC 仮想シリアル通信を比較します。サポートされているモード、構成方法、および制御コマンドを、提供されたハードウェアおよびファームウェアのドキュメントと照合して確認してください。

USB HID キーボードおよび CDC バーコード スキャナのデータ パス (デコードからホスト受信、ビジネス検証まで)
HID キーボードと CDC 統合の概念的なパス。 HID-POS およびベンダー定義の HID には、独自の受信ソフトウェアが必要です。 フルサイズの図を開くフルサイズの図を開く

1. USB HID キーボード モード: キーボード入力パスを通じてスキャン結果を送信します。

HID はヒューマン インターフェース デバイスの略です。 HID キーボードと HID-KBW は、バーコード スキャナーで一般的に使用されるキーボード エミュレーション モードについて説明します。

スキャナは、デコードされたデータをキーボード レポートに変換します。従来のテキスト入力ワークフローでは、オペレーティング システムは結果の入力をフォーカスのあるコントロールにルーティングします。これにより、HID キーボード モードは、すでに入力されたデータを受け入れる既存の ERP 画面、ウェアハウス アプリケーション、または Web フォームの実用的な開始点になります。

を含むバーコードの場合 00012345、ターゲットフィールドはそれらの文字を受け取る可能性があります。設定された Enter サフィックスによりフォームを送信できます。ただし、送信動作と先頭ゼロの保持は、アプリケーションとフィールドの設定によって異なります。スプレッドシートは、受信したテキストを数値に変換し、先頭のゼロを削除できます。

実際のワークフローをテストします。

  • ウィンドウを切り替えるか、別のフィールドを選択して、スキャン結果がどこに送信されるかを確認してください。
  • スキャナのキーボードの国設定をホスト レイアウトと一致させ、句読点と大文字小文字を確認します。
  • 入力方法、キーボードショートカット、連続スキャンを確認します。
  • プロジェクトで必要な非 ASCII テキストまたは GS1 区切り文字を確認します。

キーボード エミュレーションは、任意のバイトの透過的なトランスポートを提供しません。ファームウェア固有の文字出力機能には、独自の検証が必要です。

カスタム アプリケーションは、Windows Raw 入力などのメカニズムを使用して入力デバイスを識別し、専用の受信を実装することもできます。したがって、HID は本質的にスキャナーを区別できない、またはバックグラウンド収集をサポートできないという理由で無視されるべきではありません。これらのワークフローにはソフトウェア開発が必要です。

2. USB CDC: アプリケーションにスキャンデータを受信させます

CDC は USB 通信デバイス クラスです。 CDC-ACM は、仮想シリアル通信の一般的な実装です。互換性のある Windows デバイスは、アプリケーションがバイトを読み取るために開く COM ポートとして表示されます。 Linux では、サポートされている CDC-ACM デバイスは通常次のように表示されます。 /dev/ttyACM*.

この受信パスは、フォーカスされたテキスト フィールドには依存しません。アプリケーションは受信データをバッファリングし、生のログを保持し、完全なメッセージを抽出して、結果をビジネス システムに渡すことができます。

COM ポートだけでは、デバイスが CDC を使用していることを証明することはできません。 USB からシリアルへのコンバーターやベンダー固有のドライバーも仮想ポートを公開できます。マニュアル、USB ディスクリプタ、ドライバー情報を確認してください。

ドライバーの要件は、オペレーティング システムとデバイスの実装によって異なります。 Windows はその組み込みを使用できます Usbser.sys ただし、「USB COM」というラベルが付いたすべての製品が一律にドライバー不要になるわけではありません。 Linux の統合には、権限とデバイスノードの管理も含まれます。 Android には、USB ホスト機能、アプリケーションの許可、および互換性のある通信実装が必要です。

3. バイトストリームを受信し、完全なバーコードメッセージを抽出します。

シリアル ポートの読み取りまたは受信コールバックには、1 つのスキャン結果の一部、複数の完全な結果、または両方の混合が含まれる場合があります。アプリケーションは、構成されたプロトコルに従ってメッセージ境界を識別する必要があります。

以下はプログラミング例であり、デバイスの測定ではありません。各結果は 16 進数で表される CR LF で終わると仮定します。 0D 0A、ペイロードにはその区切り文字を含めることはできません。 2つの結果、 00012345 そして ABCD、3 回の読み取りで到着する可能性があります。

Read 1: 30 30 30 31
Read 2: 32 33 34 35 0D 0A 41 42
Read 3: 43 44 0D 0A

After buffering and framing:
Result 1: 00012345
Result 2: ABCD

それぞれの読み取りを 1 つのバーコードとして扱うと、レコードが切り捨てられたり結合されたりすることになります。バイトをバッファリングし、完全なメッセージを抽出し、タイムアウト、過剰な長さ、切断後の残留データを処理します。

CR LF は、可能なフレーム規則の 1 つにすぎません。 QR ペイロードには改行が含まれる場合がありますが、GS1 データには ASCII 29 区切り文字 (0x1D)。実際のペイロードとデバイス プロトコルに応じて、区切り文字、長さフィールド、エスケープ、または別のフレーミング方法を選択します。

文字エンコーディングにも明示的な合意が必要です。 CDC は、すべての QR ペイロードを UTF-8 に自動的に変換するわけではありません。構成された出力エンコーディングを使用して、受信したバイトをデコードします。破損したテキストを調査するときは、転送の問題と表示の問題を個別に調査できるように、16 進数のログを保存してください。

4. アプリケーションに関する受信方法を選択します

水平にスクロールしてすべての列を表示します。矢印キーを使用してテーブルにフォーカスします。

ホストアプリケーション周りの受信方法を選択します
プロジェクトの要件 出発点 何を確認するか
既存のソフトウェアはキーボード入力を受け入れます HIDキーボードモード フォーカス、キーボード レイアウト、文字、プレフィックス、サフィックス、フィールドの書式設定
カスタム Windows または Linux ソフトウェアが取得を管理 CDC または確認済みの仮想シリアル実装 ドライバー、エンコード、フレーミング、権限、およびリカバリ
複数のスキャナが別々のステーションにサービスを提供する アーキテクチャに応じた CDC、専用 HID または Raw 入力 信頼性の高いデバイスの識別とバインド
Android または組み込みホスト 最初にホストとアプリケーションの機能を確認する USB ホストのサポート、電源、権限、互換性
ソフトウェアはデコードをトリガーするかパラメータを変更する必要があります デバイス制御プロトコルを確認してください サポートされているコマンド、応答、およびファームウェア

VID/PID はデバイス タイプの選択に役立ちます。同じモデルの複数のインスタンスを区別するには、シリアル番号、物理ポートの場所、または検証されたバインディング ルールも必要になる場合があります。すべてのデバイスが一意のシリアル番号を公開している、または COM 番号が永続的な識別子のままであると想定しないでください。

ターゲット スキャナ、ファームウェア、アプリケーションを使用してパフォーマンスをテストする必要があります。 HID 出力ペーシングとホスト処理は結果に影響を与える可能性があります。インターフェース名だけでは、どちらのモードが高速であるかはわかりません。同様に、仮想ポートに設定されたボーレートは USB バス速度ではありません。その設定が内部デバイスの動作に影響するかどうかは、ファームウェアによって異なります。

5. デコード、受信、ビジネス受諾を個別に検証する

デコードが成功することは、ワークフローの 1 つの段階です。 3 つの結果を記録します。

  1. デコード成功: スキャナはペイロードを取得し、その設定に従って出力します。
  2. ホスト受信を完了します。 受信者は、正しい長さ、エンコーディング、および境界を持つ期待されたコンテンツを取得します。
  3. ビジネス受付: アプリケーションはフォーマット、作業指示書、または承認のチェックを完了し、結果を記録します。

各ビープ音とインジケーターの意味については、マニュアルを参照してください。スキャナーの成功信号は、製造実行システム (MES) が記録を保存したこと、またはアクセス制御アプリケーションがエントリを承認したことを証明するものではありません。

ホスト トリガー コマンド、パラメータ変更、およびビジネス確認応答には、デバイス プロトコルでのサポートが必要です。 CDC 自体はこれらのビジネス機能を定義しません。

繰り返されるデータにはアプリケーション コンテキストも必要です。別のスキャン、連続読み取り、または重複したソフトウェア処理により、同じコードが表示される場合があります。有効な繰り返しスキャンが維持されるように、ワークフローに基づいて重複排除、再試行、再接続の動作を設計します。

6. 提供された Xinlong スキャナ構成を検証します。

Xinlong の F42-NFC 開発ドキュメントでは、HID-KBW、USB CDC、および HID-POS が区別されています。 F31/F41/F53 工業用シリーズ設定マニュアルでは、HID キーボード、CDC 仮想シリアル、および HID-POS モードについても個別に説明されています。

を評価するときは、これらの区別を使用してください。 F42-NFC バーコードと NFC モジュール または議論する F31-BW統合。付属のサンプルの正確なモデル、ハードウェア リビジョン、ファームウェア、選択したモード、および該当するマニュアルを確認してください。複数のモードのサポートは、ファームウェアのバージョン間で同時出力や同一のデフォルトを確立しません。

HID-POS は、HID レポートと関連するアプリケーション プロトコルを使用します。受信ソフトウェアをキーボード ワークフローとは別に評価します。

サンプルを受け入れるために、以下をカバーする実際のバーコードと予想される出力を準備します。

  • 先頭のゼロ、大文字と小文字の混合、句読点、長いペイロード、および必要な非 ASCII または GS1 データ。
  • 連続スキャン、繰り返しコード、および 2 台の接続されたスキャナ。
  • ウィンドウの変更、入力方法、キーボード パスのフィールドの書式設定。
  • ポートの取り外し、占有ポート、アプリケーションの再起動、およびポート パスのシステムのスリープ/再開。

デバイス モード、オペレーティング システム、受信した生データ、ビジネス結果を記録します。レコードが欠落している場合、これらのログはスキャナ出力、ホスト受信、アプリケーション処理の間の障害を特定するのに役立ちます。

のために OEM バーコード スキャン エンジン プロジェクト、ホスト システム、受信ソフトウェア、代表的なバーコード サンプル、および必要な制御機能を共有します。 Xinlong IoT とのインターフェース構成について話し合う サンプル受け入れ手順を定義する前に。

技術参考資料

製品選定・実ワーク評価のご相談

コードの種類と寸法、読取距離、対象物の材質、接続先機器をお知らせください。用途と実ワークに合わせた評価方法をご案内します。

このフォームからお問い合わせを送信できます。* は必須項目です。送信処理にはWeb3Formsを利用します。

メールでのお問い合わせ: lixuan@xinlongiot.com

個人情報の取扱い