USB バーコード スキャナは、テキスト フィールドに直接入力することも、アプリケーションがポートを開いてデータを受信するのを待つこともできます。どちらも USB を使用しますが、ホスト ソフトウェアは出力を異なる方法で処理します。
OEM デバイスまたは統合プロジェクトの場合は、受信アプリケーションから開始します。 キーボード入力を受け入れるのでしょうか、それともソフトウェアがスキャナ データを収集して処理するのでしょうか? その決定は、キャラクターの処理、開発作業、障害の回復とメンテナンスに影響を与えます。
このガイドでは、USB HID キーボード モードと USB CDC 仮想シリアル通信を比較します。サポートされているモード、構成方法、および制御コマンドを、提供されたハードウェアおよびファームウェアのドキュメントと照合して確認してください。
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 つの結果を記録します。
- デコード成功: スキャナはペイロードを取得し、その設定に従って出力します。
- ホスト受信を完了します。 受信者は、正しい長さ、エンコーディング、および境界を持つ期待されたコンテンツを取得します。
- ビジネス受付: アプリケーションはフォーマット、作業指示書、または承認のチェックを完了し、結果を記録します。
各ビープ音とインジケーターの意味については、マニュアルを参照してください。スキャナーの成功信号は、製造実行システム (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 とのインターフェース構成について話し合う サンプル受け入れ手順を定義する前に。
技術参考資料
- Xinlong F31/F41/F53 工業用シリーズ設定マニュアル、USB 通信セクション。 F42-NFC 開発ドキュメント。納品された製品およびファームウェアへの適用性を確認します。
- Microsoft: USB シリアル ドライバー (Usbser.sys)
- Microsoft: Raw 入力について
- Android 開発者: USB ホストの概要
- Linux カーネル: USB ACM ドライバー