OPN2001

Revision as of 22 August 2013 15:02 by gpotter (Comments | Contribs) | (→OS Change Log)


Wireless OPN2001 Large.jpg
OPN2001

Quick Start for the OPN-2001

Follow the instructions below to get started with the OPN-2001 on your platform.

PC

Using the OPN-2001 with a Windows PC requires you to download and install Opticon's PC USB Drivers Installer, and an application to retrieve the data like the PC Companion Application. Both of these are located in the Downloads section of this page.

Initial Setup

You will only need to do this part once per computer.

  1. Download the "PC USB Drivers Installer" from the Driver Downloads section of this page. Run the installer you downloaded by double-clicking on it. Follow the prompts on your screen until the installation is completed.
  2. Download the OPN-2001 PC Companion Application which is also located in the Software Downloads section of this page.
  3. Open the compressed file, and run the OPN200X Setup.exe. Follow the instructions in the wizard to install the software. When it is finished installing, the PC Companion Application dialog will appear.
  4. Plug the OPN-2001 into your computer. Windows will inform you that it has found new hardware, and that it is installing the drivers for that hardware. Then you will see the status indicator in the application window turn green. From the application window you can download barcodes, change settings, or view and set the date and time on the device.

Scan Barcodes

Collecting data with the OPN-2001 is as simple as pointing and scanning. Scanning barcodes with the big button or "trigger" will store barcodes, while scanning with the small button or "function" will remove barcodes. Below are some tips about scanning and removing barcodes from the device.

  • When the OPN-2001 has a good scan, it will chime, the LED on the device will flash green, and the laser will turn off.
  • When the OPN-2001 deletes a barcode, it will give a different chime than above, and it will flash an Orange LED when it has a good scan.
  • Deleting the same barcode again when there are no more scans of it present will cause the OPN-2001 to chime for about a second. The LED will also flash red.

Download From the OPN-2001

If you haven't done so yet, refer to the Initial Setup instructions above to get all the proper software installed and ready. This part of the guide assumes that you have already successfully setup your computer to communicate with the OPN-2001.

  1. Plug the OPN-2001 into your computer.
  2. Open the OPN-2001 PC Companion Application by navigating to the Start Menu shortcut you created during the Initial Setup. This is usually in Opticon/OPN200X/OPN200X, and it will have an icon that looks like one of our OPN2001's.
  3. Double-check that the "Status" light is green.
  4. Check the box next to "Save to file" if you would like your barcodes to be saved to your computer each time you select "Get Barcodes." By default, the barcodes will be stored in the Documents folder on your computer. To change this, click on the ellipsis(...) button and choose where you would like your barcodes saved.
  5. Click "Get barcodes" to download the barcodes that you just scanned. Double-check that they got saved to your file before proceeding.
  6. Click "Delete barcodes" to erase the barcodes stored on the OPN-2001.

Mac

In order to set up the OPN-2001 on the Mac, we will need to install the Mac Companion Application and configure the OPN-2001 to connect to the Mac.

  1. To install the Mac Companion Application, download the "OPN-2001 MAC Companion Application" under software downloads. Open the resulting folder, and run the installer "Opticon OPN Demo Application.pkg." Follow the prompts until the installation is complete.
  2. Plug the OPN-2001 into the Mac. At this point the OPN-2001 should be recognized as a network interface.
  3. Start up the OPN-2001 Mac Companion Application using the Finder. It will automatically detect the OPN-2001. The connection can be confirmed by the green "Connected" text in the top right corner of the application.

The OPN-2001 and the Mac are now connected and working together.

APIs

There are currently APIs for developing applications to communicate with the OPN2001 on/with the following platforms/technologies:

  • Windows XP / Vista / 7 (32 and 64 bit)
  • ActiveX
  • .NET
  • Mac OS X

OPN2001-2003 comparison


Feature OPN2001 Standard Demo firmware OPN2001 HID firmware OPN2003 Standard application (OPN2001 emulator) OPN2003 Batch Demo application
Can the scanned data include a prefix and suffix? If yes, can the Prefix and the Suffix be more than one character (String)? This is not an option with the current firmware, however prefixes or suffixes could be added with custom developed PC side software. Currently return or tab are the only available suffixes, however other prefixes or suffixes could be added with custom developed PC side software. Yes, and yes up to 4 direct input entries. Please refer to page U85 of the universal menu book linked below for more information on prefixes, suffixes preambles, and postambles. http://www.opticonusa.com/pdf/Manuals/Universal_Menu_Book.pdf This is not an option with the current firmware, however prefixes or suffixes could be added with custom developed PC side software.
Does the scanner have an internal serial number that can be output as part of the scanned data? Yes, although we currently only have one PC side application that will put the serial number in the file with the scanned data, the "OPN2001 Data Downloader" application. No See "OPN-2001 Standard Demo firmware" Yes, this is a configurable option. Data is transferred using the NETO32 program or a custom program using the NETO protocol.
Can the scanner be setup to include scanned data time stamp? Yes, using most of our PC side applications including the "OPN2001 Data Downloader" application. Yes See "OPN-2001 Standard Demo firmware" Data stored as Database file (multiple scans of same barcode increases quantity rather than adding new lines to the file, also this means the time stamp only exists for the most recent scan of the specific barcode)

FAQ

My OPN-2001 has suddenly stopped beeping when I scan barcodes. Is it broken?

It's possible that the beeper has been disabled using the beeper toggle feature. The beeper can be disabled or enabled without using a computer if you hold the large key for more than 10 seconds. To re-enable a disabled beeper, try holding this key for about 10 seconds. The OPN will sound a tone when the beeper is re-enabled.

I'm trying to integrate the OPN2001 ActiveX control with my Silverlight application, but when I try to create the opnCtl object, I get an exception. What's going on?

The OPN2001 ActiveX control doesn't expose an Automation API, which is why the exception occurs. See the MSDN article about using Automation here.

How can I communicate with the OPN2001 in my Java application?

You could utilize the native OPN2001 library via JNI, making a JNI wrapper for the exposed functions.

Will applications written for the OPN2001 work with the OPN2002 or OPN2003?

Yes, if the OPN2001 simulation application - a piece of firmware for the OPN2002 and OPN2003 - is installed. The application simulates the behavior and protocol of the OPN2001, making it compatible with your OPN2001 applications.

Is the serial protocol of the OPN2001 available?

No, we don't release that information. The recommended and authorized way of communicating with the OPN2001 is via its various APIs.

Is there a way to recover the saved data from an OPN2001 after the clear command has been sent?

Unfortunately no - the OPN2001 firmware erases the flash sectors where the data was stored upon executing the clear command. Make sure that the data has actually downloaded before you issue the clear command!

Is polling optional or required?

Polling is really meant to automatically detect when the OPN2001 has data, and then download it via a callback function. As such, it's not explicitly required.

The OPN-2001 is a small handheld wireless barcode reader capable of storing up to 10,000 barcodes at a time.

Factory Reset

To factory reset the OPN-2001 please follow the below instructions.

  • Ensure the OPN-2001 has sufficient charge (at the least the laser should come on with a trigger press when the unit is unplugged)
  • Disconnect the OPN-2001 from any USB connections
  • Press and hold both buttons (scan and clear) for 10 seconds
At the end of the time you will hear a single tone indicating successful reset. While holding the keys the LED will flash RED (If it flashes any other color you are not holding both buttons firmly enough).
Note: It is possible to disable the factory reset option of the OPN-2001 with the SDK (and subsequently our Standard PC Demo Application). If this is disabled this feature will not work until re-enabled.

Firmware

The OPN-2001 currently has two firmware versions available. The main OS functions as a batch mode scanner and requires the use of the Companion Applications. The Alternate OS supports the functions of the main OS, plus it is also capable of acting in USB-HID (keyboard) mode.

Loading Firmware

The Firmware of the OPN-2001 can be upgraded (or reloaded in the case of a corrupt firmware) with the following instructions. You can also follow these instructions to load our Alternate OS which gives the device the ability to act as a USB-HID device.

  1. Download and install the USB Drivers.
  2. Download and install Appload.
  3. Download your preferred version of the firmware for the OPN-2001. If you are installing the Alternate OS, please download the Firmware: OS - Alternate. Otherwise, use the Firmware: OS.
  4. Connect the OPN-2001 to the PC
  5. Launch Appload
  6. In Appload select 'Settings' > 'Port' > 'Opticon USB Code Reader(1D) (COMx)'
  7. In Appload select 'Settings' > 'IrDA Adapter/Cradle type' > 'Not installed'
  8. In Appload select 'File' > 'Download' and browse to the firmware file (e.g. RBBV0140.hex) and click 'open'
    The download will take approximately 30 seconds at which time you will see the message 'Download successfully completed'

USB-HID with the Alternate OS

There is a firmware variant for the OPN2001 that allows it to operate in either classic mode or in a USB-HID (keyboard) mode.

How to Configure the OPN2001 in HID Mode

To acquire the features of the Alternate OS you must first load the Alternate OS firmware file and configure the OPN2001.

  • Download the Alternate OS firmware file from the software downloads table at the bottom of this page.
  • Using the Alternate OS file, follow the firmware loading instructions in the section of this page titled Loading Firmware.
  • Print the page linked here and scan the Keyboard Mode barcode.

How to Switch between HID Mode and Classic Mode

  • Download the Alternate OS firmware file from the software downloads table at the bottom of this page.
  • Using the Alternate OS file, follow the firmware loading instructions in the section of this page titled Loading Firmware.
  • Print the page linked here.
  • Scan the "Batch Mode" barcode to configure the OPN2001 in Classic Mode.
  • Scan the "HID Mode" barcode to configure the OPN2001 in HID Mode.

About Classic Mode

Classic mode is identical in every way to the main OPN2001 firmware.

About Keyboard Mode

USB-HID (keyboard) mode allows the scanner to function as a batch scanner when disconnected from the computer and a real-time scanner when connected.

  • Real Time- To use the OPN2001 scanner as a real time scanner, configure it in HID mode, plug it into the computer and scan barcodes.
  • Batch- When disconnected it will store barcodes. You can then bring it back to the PC, and plug it in to retrieve the data. When the trigger is pressed the first time after reconnecting to a PC it will transmit all data off of the unit and onto the PC wherever the cursor happens to be (Excel, Notepad, etc).

Other Features

The newest revision of this firmware added some functionality. Users can now choose to transmit time stamps, and barcode IDs (barcode symbology). They can also switch between a "return" suffix, and a "tab" suffix.

If you would like to time stamp your barcode scans, or transmit the Barcode symbology(Code ID), you can do this by following the procedure below
  1. Print the barcode sheet at this link.
  2. To enable or disable either the time stamp or transmission of the barcode ID, scan the SET barcode, then the Enable or Disable barcode for either option, then the END barcode. These options are disabled by default.

By default, the OPN-2001 transmits an "Enter" key press after every barcode. To change this to a tab, or to change back to return, print this barcode sheet and scan SET, then the "Suffix for All Codes" barcode, followed by either the "Enter" or the "Tab" barcode, and finally END.

Development

SDK for OPN200x Host Applications

There are currently APIs for developing applications to communicate with the OPN2001 on/with the following platforms/technologies: Windows XP / Vista / 7 (32 and 64 bit) ActiveX .NET Mac OS X The OPN PC SDK contains nearly everything you would need to develop your own host application to interface with the OPN-2001, OPN2003, or OPN2004. Sample code and documentation are included, however compilers are not included. Please use a compiler appropriate for the operating system you are developing for: Windows, or Macintosh OS X.

OS Change Log

  • RBBV0106: First official release
  • RBBV0107: Fix USB problems : "Set configuration" command with value 0 not handled correctly, sometimes OPN2001 returns a STALL response when PC tries to send data.
  • RBBV0108: Fix : after connecting scanner to PC scanner thinks that it received much data, after sending "EX" command in factory mode, scanner does not reset itself. Implement watchdog timer.
  • RBBV0109: Fix : crashes during Flash write/erase actions due to enabled interrupts.
  • RBBV0110: Fix : In factory mode scanner cannot exit laser adjustment mode anymore.
  • RBBV0111: Fix : Code 39 CD was not transmitted by default, software did not work on older OPN2001 models.
  • RBBV0112: Fix : Scanner reset when transmitting a large amount of data (Watchdog)
  • RBBV0113: Scan barcodes, while connected to the PC.
  • RBBV0114: Clear data with special barcode
  • RBBV0115: Add support for decoding RSS-14, RSS Limited, and RSS Expanded bar codes.
  • RBBV0116: Fix telepen numeric bug '00' and Code 128 checksum bug '00'
  • RBBV0117: Fix length options, set UPC-E1 default to disabled.
  • RBBV0118: Added : option to reject a bar code which was read before, enable/disable buzzer option, battery low indicator.
  • RBBV0119: Fix : crash when RTC mode is changed
  • RBBV0120: Changed : send RTS low or RTS high command only in case RTS level changes.
  • RBBV0121: Fix : resend RTS message over USB bus upon command. Updated : improve negative label reading.
  • RBBV0122: Fix : Xmit Code-39 CD option, scan-direction menu XAP, XAQ. Updated : remove Codabar/Code-39 FPD, support Code-39 gap-check options X%K,X%L,true linker support, Support Code-128 menu labels
  • RBBV0123: Fix : Code39 gap check (X%L) caused the OPN to crash. Changed: default for ‘Transmit C39 CD’, ‘Transmit I2of5 CD’, ‘Addon wait time’ is now 2.
  • RBBV0124: Fix : Flash erase/write routine
  • RBBV0125: Fix : RSS bug that caused Application Identifier to be removed twice. Updated code 39 decoder. OPN-2001 parameter document/manual is updated!
  • RBBV0127: Code-128 not TX CD in front of EAN-128
  • RBBV0128: Fix : 'Convert EAN8 to EAN13 type' default should be 'disabled'
  • RBBV0129: Added : Implement request to be able to set buzzer volume even lower
  • RBBV0131: Added : Aiming mode.
  • RBBV0131a: Added beam limit mode, readback of Gfk mode (parameter 0x50), parameter for narrow beam (0x05), parameter for aim time (0x13). Check on PZN (Pharma-Zentral-Nummer) barcodes. Reduced the laser output in aiming mode
  • RBBV0132a: Implement parallel label reading
  • RBBV0133: Added Codablock-F
  • RBBV0135a: Fix Code 128 Check digit bug.
  • RBBV0140: Fixed a potential crash bug when syncing time with a PC, Added support of 'Send Time' command in Appload (for production purposes)

Downloads


Notice
The downloading and use of any Opticon software implies consent with Opticon's End User License Agreement.

Documents

Document Description Download
Data Sheet Technical details and at-a-glance information about the OPN-2001 Download
Quick Start Guide A brief and to the point set of setup instructions for the OPN-2001 Download
User Manual A more detailed usage manual for the OPN-2001 Download
Settings for HID Firmware (Alternate OS) A page of custom settings barcodes exclusive to the alternate firmware RBB3640x Download
Specification Manual A more detailed manual full of technical specifications for the OPN-2001 (recommended for advanced users and integrators only) Download
Universal Menu Book This document contains the command barcodes to configure most of Opticon's scanners. Not all features are supported on the OPN-2001. Note that the defaults section (page U6) is necessary to switch between Classic and HID modes on the OPN2001 Alternate OS. Download
Quick Access Barcode Sheet This document contains the barcodes for switch between USB-VCP (Classic) and HID modes on the OPN2001 Alternate OS. Download

Software

Software Description Download
Appload Appload is Opticon's multi-purpose utility for installing firmware onto devices such as the OPN2001. Currently Windows only. Download
Firmware: OS This is the main firmware for the OPN-2001. Download
Firmware:OS - Alternate This firmware variant can operate in two modes. First, it will operate in Classic mode which is identical in every way to the main OPN2001 firmware. Second, it will operate as a USB-HID (keyboard) batch or real-time scanner. When disconnected it will store barcodes and then when the trigger is pressed the first time after reconnecting to a PC it will simply download all data off of the unit and onto the PC wherever the cursor happens to be (Excel, Notepad, etc). Download
OPN Companion Application The OPN-2001 (and any OPN200x running the OPN2001 emulator firmware) requires the use of a PC side application to pull and receive the scanned barcode data. While a free SDK is available to customize such an application this is Opticon's free standard application. Download
OPN Companion Application - Source Code The Visual Studio source code for the above PC Companion Application. Download
Macintosh OS X Companion Application Similar to the PC companion application this software is a free application provided by Opticon in order to get some out of the box functionality with your OPN-2001 on a Macintosh computer running OS X. Download
SDK This SDK contains nearly everything you would need to develop your own PC application to interface with the OPN-2001. Sample code and documentation included. Compilers not included. Use a compiler appropriate to your platform (Windows or Macintosh OS X) Download

Drivers

Platform Description Download
PC USB Drivers Installer USB-to-serial drivers installer package for both 32 and 64 bit versions of Windows XP (32 bit only), Vista, and 7. This package contains two drivers. The first driver is for the OPN-200x as well as many of Opticon's other products. The second driver is for Opticon's cradles and a few other products. You can choose any of the drivers to install on the first screen of the installer program. Download
Macintosh User Mode Driver This driver is not required for Macintosh end users. This driver file is intended for system developers to include in their application package. See the SDK linked above for documentation and usage instructions. Download