Setting Up a Keywedge Scanner
This page walks you through configuring your keyboard wedge scanner hardware, enabling barcoding in xAssets, and testing that everything works together.
Prerequisites
- A keyboard wedge (USB or PS/2) barcode scanner and its instruction manual (for setup barcodes)
- A computer with xAssets accessible in a web browser
- Configuration-level user access in xAssets (to enable the Barcoding module)
Scanner Hardware Configuration
Most scanners are configured by scanning special setup barcodes printed in the scanner's instruction manual. You enter configuration mode by scanning one barcode, adjust settings by scanning others, and exit by scanning a final barcode. Refer to your scanner's documentation for the specific barcodes.
Common Configuration Options
| Option | Description | xAssets Requirement |
|---|---|---|
| Barcode symbologies | Which barcode types (Code 128, Code 39, QR, etc.) the scanner will read | Enable the types used on your asset labels |
| Prefix character | A character sent before each barcode's data | No prefix |
| Suffix character | A character sent after each barcode's data | Carriage Return (Enter) |
Required Scanner Settings
xAssets requires two specific scanner settings:
| Setting | Required Value | Why |
|---|---|---|
| Prefix character | None (no prefix) | The scanner must not send any characters before the barcode data |
| Suffix character | Carriage Return (Enter) | Tells xAssets that the barcode is complete and triggers the search or field entry |
These are the factory default settings for most keyboard wedge scanners, so your scanner may already be correctly configured.
Enabling Barcoding in xAssets
A keyboard wedge scanner will work for basic text entry (such as the search box) without any xAssets configuration. However, to access the full barcoding features -- including the barcode search dialog, barcode field on asset forms, and barcode audits -- you need to enable the Barcoding module.
Note: Enabling this module may require a barcoding-enabled xAssets license. Contact your xAssets sales or support representative if the option is not available.
Turning on xAssets Barcode Functionality
This requires a Configuration-level user account.
- Go to Settings > Site Settings > Enable/Disable Features.
- Ensure the Barcoding module is enabled.
- Click OK.
- Refresh your browser so that the barcoding menus appear.

Testing the Scanner
Before using the scanner with xAssets, verify that it is sending barcode data correctly.
- Connect the scanner to the computer or mobile device you will use with xAssets.
- Open a plain text editor (such as Notepad on Windows).
- Click in the text editor so it has focus.
- Scan two or more barcodes of the type you will use for your assets.

Expected result: Each barcode appears on its own line in the text editor.
If barcodes appear on the same line (without line breaks between them), the scanner's suffix character is not set to Carriage Return. Reconfigure the scanner using the setup barcodes in your scanner's documentation, setting the suffix to Carriage Return (Enter).
Related Articles
- Keywedge Barcode Scanner Introduction — Introduction to the keywedge barcode scanner guide
- What are Keyboard Wedge Barcode Scanners? — Background on keyboard wedge technology
- Keywedge vs Other Scanner Types — Comparison with other barcode scanner types
- Searching with a Keywedge Scanner — Using a keywedge scanner to search for assets
- Setting Asset Barcodes — Using a keywedge scanner to assign barcodes to assets