OPN2002

Revision as of 20 July 2011 14:54 by jschurr (Comments | Contribs)
OPN2002img.jpg
OPN2002
OPN2002img3.jpg
OPN2002
opn2002img2.jpg
OPN2002

The OPN2002 is Opticon's most popular Bluetooth scanner. Armed with a variety of connection options and the ability to run customizable embedded applications created with the C-Library Kit, the OPN2002 is an incredibly versatile scanner in the same attractive form factor of the OPN2001.

Concepts and Definitions

  • Fixed PIN: a PIN code that is preset in the OPN2002. Typically the last 4 characters of the OPN2002's Bluetooth name.
  • Dynamic PIN: a PIN code that is determined at pair time by the Bluetooth host.
  • HID: Human Interface Device. In the case of the OPN2002, it's recognized as a Bluetooth HID keyboard, meaning that each character of a scanned barcode is transmitted to the host as a keyboard press. HID devices cannot be used as a master at pair time, but after pairing with a Bluetooth host, can switch roles and become master devices for reconnection purposes.
  • SPP (VCP): Serial Port Profile (Virtual COM Port). In the case of the OPN2002, it sends data serially to a serial port on the Bluetooth host. Software running on the host can read from that serial port to capture the data.
  • Embedded Firmware: The embedded OS and application that is present on the OPN2002, and required for its function.
  • Embedded OS: A binary common to all OPN2002s that enables the OPN2002 to function and exposes an API that the OPN2002's embedded applications utilize to "drive" the device.
  • Embedded Application: A binary produced either by Opticon or by a third party utilizing the C-Library Kit; implements the "user interface" and drives the behavior of the OPN2002.
  • Default Firmware, OS, or Application: Refers to standard Opticon software for the OPN2002, typically installed on the OPN2002 at the factory and present out-of-the-box. The OS version string is always RBGVXXYY, where XX denotes the major revision and YY denotes the minor revision. The application version string is RFGAAABB, where AAA denotes the major revision and BB denotes the minor revision. Occasionally, the first 'A' in RFGAAABB is a letter, denoting the Opticon office responsible for developing the software.

Supported Platforms

The OPN2002 is usable on wide variety of platforms and Bluetooth stacks.

Supported platforms include:

  • Mac OS X (does not work on older mac "powerbook" computers however it works well on all "macbook" computers)
  • iOS 4+ (including iPads running iOS 3.2) (currently HID only)
  • Windows (all flavors)
  • Windows Mobile
  • Linux
  • Android (SPP only)
  • BlackBerry (SPP only)

Note that OpticonRL is available for those platforms that only permit Bluetooth SPP (as well as some that permit both). For example, versions of OpticonRL exist for both Android and BlackBerry. This enables customers to get barcode data into their applications with a minimal amount of effort: OpticonRL transforms received serial data into keyboard presses, in effect "wedging" barcode data into applications.

Technical Specifications

Supported Symbologies

  • 1D Symbologies
    • JAN/UPC/EAN, incl. add-on
    • Codabar/NW-7
    • Code 11
    • Code 39
    • Code 93
    • Code 128
    • GS1-128 (EAN-128)
    • GS1 Databar (RSS)
    • IATA
    • Industrial 2of5
    • Interleaved 2of5
    • ISBN-ISMN-ISSN
    • Matrix 2of5
    • MSI/Plessey
    • S-Code
    • Telepen
    • Tri-Optic
    • UK/Plessey
  • Postal Codes
    • Chinese Post
    • Korean Postal Authority
  • 2D Symbologies
    • PDF417
    • Micro PDF417

Physical Features

Dimensions

62mm x 32mm x 16mm

Weight

29 grams (~1 oz.) total including battery

Laser

Class 2 Laser

Environmental Specifications

Operating Temperature and Humidity

Temperature: 0° to 50° Celsius (32° to 122° Fahrenheight)
Humidity: 20% to 85% RH

Storage Temperature and Humidity

Temperature: -20° to 60° Celsius (-4° to 140° Fahrenheight)
Humidity: 20% to 85% RH

Battery

  • Lithium Ion Polymer
  • 3.7V
  • 240mAh

Battery Life

Approximately 7 hours

Charging Time

Approximately 2.5 hours

Data Retention Time

Approximately 72 hours

Scanning

  • Minimum Resolution: 0.127mm (5 mils)
  • Depth of Field (scan distance)
Resolution (in mm) Minimum distance (in mm) Maximum Distance (in mm)
0.127 50 100
0.15 40 120
0.25 40 220
0.5 40 360
1.0 60 570

Bluetooth

  • Version 1.2 Class 2
  • Master and Slave mode support
  • one to one communication only (one host to one client)
  • approximately 10 meters (33 feet) transmit range in ideal conditions
  • Supported Profiles
    • Bluetooth SPP (Serial Port Profile)
    • Bluetooth HID (Human Interface Device)
  • 2.4 GHz Band

Physical Connectors

  • USB: Mini USB B Connector type version 1.1 VCP class
  • Cradle contacts: 4 contacts on the end of the OPN-2002 intended for use with Opticon's CRD2000 series multi cradle. No other usage is supported.

IP Rating

Also known as International Product Rating and IEC 60529

  • IP 42 against solid materials and water (additional resources: http://en.wikipedia.org/wiki/IP_Code)
  • Drop Test: No malfunction has been known to occur with drops of distances 70cm (~2.3 ft.) or less onto a concrete surface.

MTBF

The Mean Time Between Failure of this product is calculated at 10,000 hours when operated within specified parameters

Regulatory Compliance

  • CE
  • FCC
  • VCCI
  • RoHS
  • JIS-C-6802 Class 2
  • IEC 60825-1 Class 2
  • FDA CDRH Class 2

Setup & Configuration

Usage

Upgrading

While there are multiple components to the firmware on an OPN-2002 (Bootloader, OS and Application) the instructions to load them individually or all together are the same. You simply choose the appropriate file(s) during the right part in the process. All files available from Opticon are found in the Downloads section of this page. In addition to the individual files there are also combination files which are all three components bundled together into a single file for easy installation. It is recommended to use these combination files. As the Bootloader and OS files will always be the same you simply choose the combination file for the application you wish to load.

  • Bootloader files are provided by Opticon and always follow the naming convention beginning with RAFV (e.g. RAFV0306.hex).
  • OS files are provided by Opticon and always follow a naming convention beginning with RBGV (e.g. RBGV0217.hex).
  • Application files are provided by Opticon but could also be provided by a reseller, distributor or developed on ones own by using the freely downloadable SDK (See the downloads section). If provided by Opticon the application files will almost always follow a naming convention beginning with RFG (e.g. RFG35314).


  1. Download necessary files.
    • Firmware: This would be either the Bootloader, OS, Application or combination file from the Downloads section.
    • Appload: This is the loader program for the PC that installs the firmware file onto the unit. See the download section.
    • USB Drivers: These drivers are necessary so that Windows will provide a COM port that Appload needs to communicate with the device. Both 32 bit and 64 bit versions are found in the downloads section.
  2. Install USB Drivers (If you need assistance with this please contact Opticon Technical Support by e-mail at support@opticonusa.com or by phone at 1.800.636.0090 x2127).
  3. Install Appload
    • Unzip the file Appload EAGV0142.zip by right-clicking and selecting 'Extract All'
    • double-click the resulting file 'Appload Setup.exe' which will start the install wizard. You may need to select 'next' a few times and are allowed to choose the install folder and whether Appload places an icon on your desktop. You may simply choose the defaults for all options. Appload will launch at the end of the install process.
  4. Connect the OPN-2002 to your PC
  5. Install the firmware
    • Launch Appload (if it is not already running).
    • select 'Settings' > 'Port' > choose the port that says 'Opticon USB Code Reader(1D)'
    • select 'Settings' > 'IrDA Adapter/Cradle type' > 'Not installed'
    • select 'File' > 'Download' > browse to the firmware file downloaded in step 1 and select it.
  6. When complete the OPN-2002 will emit a series of beeps and reboot. When the LED is steady RED (indicating charging) or GREEN (indicating fully charged) the process is complete and you may disconnect your OPN-2002 from the PC. instruction manuals for the various applications are available for download in the Downloads section.

SDK

Of crucial note is that the OPN2002 does not have an SDK for the platforms it supports. Given the fact that it can transmit data serially via Bluetooth SPP or its USB port, or can transmit data as a Bluetooth HID (keyboard) device, SDKs for the various platforms the OPN2002 supports are not required. This is because the manufacturers of those platforms provide APIs for accessing serial ports and managing Bluetooth connections.

When talking about an SDK in relation to the OPN2002, what is referred to is the C-Library Kit. With the C-Library Kit installed, developers are able to create and customize embedded applications for the OPN2002, thus changing and customizing its behavior to better suit their use cases.

FAQ

Whenever I connect my OPN-2002 to my iOS device (iPad, iPhone, etc) the keyboard goes away. How do I get it back without disconnecting the OPN-2002?

The root of this issue is that the virtual keyboard on an iOS device is hard coded to disappear whenever a Bluetooth-HID (keyboard) devices is paired. There are two solutions to this problem.
  • Option one is for software developers. If this is not you skip to option two. It is possible to write software that replaces the virtual keyboard on the iOS device. It is then your option to make the virtual keyboard remain present at all times. Opticon provides sample code for this option and it is freely downloadable at the link below. For assistance integrating this code or any other code with Opticon products please ask about our Developer Support Program.
Virtual Keyboard - iPad: http://www.opticonusa.com/downloads/Software/SDK/iPad/Opticon%20iPad%20keyboard%20EGFS0560.zip
Virtual Keypad - iPhone: http://www.opticonusa.com/downloads/Software/SDK/iPhone/Opticon%20iPhone%20keyboard%20EGFS0570.zip
  • Option two is more simple. Please follow the instructions provided on this page in the Upgrading section for both the Operating System and the Application. When done simply pair your OPN-2002 to your iOS device as normal then scan the barcode +-IOSON-+ found in the document linked below. Now simply tapping the small function key on the OPN-2002 will toggle the virtual keypad up and down. You can still scan with the keyboard both up and down.
iOS barcodes to enable virtual keyboard toggle feature: http://ftp.opticonusa.com/OPN2002/Documents/iOS%20Feature%20Menu%20Codes.pdf

I'm trying to connect the OPN2002 to my Mac in SPP (VCP) mode, but I can't seem to get the pairing to complete.

So Unix machines - which is what a Mac essentially is - have their serial ports implemented in a different way, from what you might be used to with a Windows PC. When a serial device is connected to the Mac, and the kernel is able to map a valid kernel driver to it, a POSIX device file is created under /dev/ for that serial port. After that, programs can read and write to this file, which becomes the same thing as reading and writing from a serial port. Windows uses a similar concept with COM (serial) ports, just implemented slightly differently.
Now, when you connect the OPN2002 to the Mac using Bluetooth VCP (SPP), one of these POSIX device files is created in /dev/. To finish the initial connection, that file must be opened with a program that is able to open device files. To test this yourself, you can use the Terminal program, and run the 'cat' command against the new file that was created under /dev/ while the pairing process was taking place. After that, the initial pairing should complete successfully.

I have the OPN2001 Simulation Application installed on my OPN2002. The OPN2002 seems to behave as an OPN2001 in USB mode, but how do I know if the OPN2002 has stored data or not when using Bluetooth?

Have you tried the csp2GetDSR() function (GetDSR() for the .NET wrapper)? It simulates the RTS signal over Bluetooth VCP; the RTS signal is normally how the OPN2001 signals that it has data to be downloaded. DSR stands for Data-Signal-Ready.

Why doesn't my pairing seem to finish when I try to connect my OPN2002 in SPP mode?

The (outgoing) serial port needs to be opened on the Bluetooth host after pairing is complete if the OPN2002 is connecting as a slave; if the OPN2002 is connecting as a master, the (incoming) serial port on the Bluetooth host must be open prior to the pairing attempt for the pairing to succeed.

Why doesn't the OPN2002 reconnect? I'm paired and everything!

If the OPN2002 is to reconnect in slave mode, the user must make the OPN2002 connectable first. With the OPN2002's standard demo application, this is done by holding the small clear key for 5 seconds. All of the aformentioned is true for both HID and SPP mode; however, SPP has the additional caveat of the Bluetooth host opening its (outgoing) serial port in order for the reconnection to truly finish. In master mode, the user must make the OPN2002 initiate a reconnection to the Bluetooth host (with the standard demo application, by holding the trigger key for 5 seconds); however, SPP has the additional caveat of the Bluetooth host having already opened its (incoming) serial port prior to the reconnection attempt in order for the reconnection to ultimately finish.

I bought one of those cool CRD2000 things, which holds and charges 10 OPN2002s. Can I use that to load software on, or download data from, multiple OPN2002s at once?

Yes. After the release of OS RBGV0207 and Appload version 1.39, it became possible to update the software on multiple OPN2002s in a single CRD2000. It operates in a sequential fashion, moving from one OPN2002 to the next.
If you have an embedded application on the OPN2002 that stores scanned barcode data, you can also download the stored data from multiple OPN2002s using Opticon's NetO32 program - assuming each OPN2002 has a unique terminal ID set.

Will my COM port change if I reconnect my scanner in SPP mode, but I already have a pairing established between the two devices?

It depends. Are you reconnecting the OPN2002 as a master or a slave? If you're reconnecting the OPN2002 in the same mode you first paired it to the host with, you'll use that same serial port you opened on the host when the pairing took place. If you're reconnecting in the other mode, it will be with a separate serial port.

Is there a way to make the OPN2002 connectable but not discoverable?

Uh-uh. (They both occur when you hold down the little clear key; the context in which you use it will determine if the OPN2002 is ultimately connectable or discoverable. For example, if you've previously paired the OPN2002 with a host device, and you want that same host to reconnect to the OPN2002, holding down the clear key makes it connectable in this context; if you want to connect the OPN2002 to a different host device, holding down the clear key makes it discoverable in that context.)

Can I send commands to my OPN2002 over Bluetooth SPP?

Sure. With the OPN2002's default firmware (OS and application), you can send Universal Menu Book commands, in the format <ESC><COMMAND><CR>. E.g. <ESC>Z1<CR> returns the software version. You can also customize the OPN2002's embedded application to support whatever commands and/or protocol you define.

Can I connect to the OPN2002 when it's not discoverable?

No; a Bluetooth device must be discoverable and/or connectable to be connected to. With default firmware, the clear key serves to toggle making the OPN2002 discoverable AND connectable simultaneously; given the limited number of buttons on the device, this is necessary.

Why doesn't the OPN2002 have an "Eject key" function, like the Apple Bluetooth keyboard, to quickly toggle the iPad/iPhone/iPod system soft keyboard?

This feature has been added to RBGV0216, and can be enabled by scanning the IOSON menu label that comes with the iOS demo application. See the Downloads section above.

Am I able to change the defaults of the OPN2002's embedded application and the OPN2002 itself?

Yes. You can either customize the embedded application to set new defaults for the application, the scan engine, or the device itself, by customizing the embedded application's source code, recompiling it, and loading the resultant binary on the OPN2002 (requires the C-Library Kit; or you can use the Universal Menu Book to configure certain options and have them "memorized" (saved to flash).

Can I customize, or provide my own handlers, for certain Universal Menu Book codes?

Yes; check out the ExecuteMenuLabel() function in the C-Library Kit's help file.

I can't pair to a PC using the WIDCOMM stack when my OPN2002 is in HID mode. Help!

What's happening here is that the WIDCOMM stack is presuming that it will dynamically determine the PIN code the OPN2002 should supply during pair time. If your OPN2002 is set to use a predefined, fixed PIN code, then the pairing process will error out. Setting the OPN2002 to use a dynamic PIN code will fix the problem and enable you to pair the OPN2002 to your PC.

OS Release Log

Note: Not all possible versions are represented. Changes omitted affect only factory testing and provisioning and do not affect end users or system integrators.

Version Date Changes
2.20 (RBGV0220) 02/22/11 - Updates to eliminate a specific firmware crash bug.
2.19 (RBGV0219) 02/16/11 - Updates to improve recovery abilities in the event of a firmware crash.
- Added features for use in waking remote devices from sleep state.
2.18 (RBGV0218) 12/22/10 - Updates to improve reliability.
2.17 (RBGV0217) 11/19/10 - Increased security and dependability with flash functions.
- Ensure deep sleep mode cannot be entered accidentally.
- Remain discoverable after connected or upon failed pairing attempt.
- Fixed an occasional reset upon initial Bluetooth connection.
2.16 (RBGV0216) 10/26/10 - Added check of Bluetooth link quality before sending data in SPP mode
- Added support for iPad/iPhone/iPod soft keyboard display while connected
2.15 (RBGV0215) 07/02/10 - Added provisions to prevent losing Bluetooth pairings in the event of complete power loss
- Updated decoders
- Fixed reconnection problems with iPad 3G
2.14 (RBGV0214) 04/22/10 - Implemented RTS/CTS/DTR/DSR functionality for compatibility with OPN2001 SDK
2.12 (RBGV0212) 03/29/10 - Fixed Bluetooth HID bugs
- Added features necessary for compatibility with the OPN2001 Simulation Application
2.09 (RBGV0209) 02/03/10 - Fixed reconnection issues with Macintosh computers and BlackBerry devices
2.07 (RBGV0207) 12/08/09 - Fixed bugs in autopowerdown (sleep) feature
- Fixed bugs in NetO transport protocol
- Added support for CRD2000 cradle
2.06 (RBGV0206) 11/03/09 - First official release

Troubleshooting

LED indicators

  • Flashing RED: OS not installed or corrupt
  • Flashing ORANGE: Application not installed or corrupt, potentially caused by low battery as well
  • Flashing Blue (dependent on application): In Bluetooth pairing mode (master or slave)
  • Flashing Blue slowly (dependent on application): actively paired with a device and connected
  • Solid RED: Charging
  • Solid GREEN: Fully charged

Won't Scan

There could be multiple causes for this. Listen for tones or watch the LED's when scanning. If the scanner behaves as if no barcode were present at all the most likely problem is either that the barcode is of poor quality and so cannot be scanner or perhaps that the symbology of the barcode is simply not enabled in the reader. To enable symbologies on the OPN-2002 see chapter 3 of Opticon's Universal Menu Book. If the device beeps in on odd manner and the LED flickers orange it is likely that the OPN-2002 is simply not paired with another device or the device is not reachable at that time. Return the device to range, wake up both devices and try again.

OPN-2002 won't respond

If your OPN-2002 appears completely dead please connect it to a dedicated power source (USB cable to a PC or powered USB hub) and leave it sit for at least a few hours. It is a known quirk of all Lithium Ion batteries that if they are let drain too far they can take increasingly long times to recover to a normal operating state. Please ensure that you are charging your OPN daily.
If your device is still unresponsive connect it to a PC and check Device Manager to see if a COM port is created for the device in the 'Ports' subsection of Device Manager.

Links

Downloads


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

Documents

Document Description Download
Quick Start Guide - Generic This is the first step for someone setting up the OPN 2002 for the first time via Bluetooth. Be certain to pay attention to which page of instructions you follow. Page 1 is for Bluetooth Serial Ports and Page 2 is for Bluetooth HID Keyboards. If uncertain which one to use, use page 2. Download
Quick Start Guide - iPhone/iPad This Quick Start Guide is ideal for those who will be pairing their OPN-2002 with an Apple iPad or iPhone. Minimum firmware version for iPhone/iPad virtual keyboard toggle feature requires firmware RBGV0216 or later. See the Upgrade instructions on this page for details on how to update your unit. Download
User Manual: Bluetooth Demo This is the user manual for the standard Bluetooth demo application, which is pre-loaded on all OPN2002s prior to shipping. Contains setup instructions and some configuration barcodes, including barcodes to toggle the iOS (iPhone/iPad/iPod) system soft keyboard show/hide feature on and off. Download
User Manual: Storage Demo This is the user manual for the standard storage demo, which is designed to demonstrate the OPN2002's storage (batch) capabilities. This demo does not provide Bluetooth functionality, and is meant mostly to demonstrate how to store barcodes for customers that want to create their own customized, embedded application. Download
User Manual: OPN2001 Simulation Application This manual describes the usage of the OPN2001 Simulation Application, an embedded application published by Opticon for the OPN2002, that enables the OPN2002 to behave as an OPN2001 with regard to user behavior and PC interaction. Windows and Mac software specifically written for the OPN2001 is required to transfer or receive data from an OPN2002 running this application. Download
DataSheet Technical details at a glance. Download
Specification Manual This document provides detailed specifications for the OPN2002. For advanced users and system integrators only. Download
iOS toggle Menu Codes This document contains the two barcodes necessary to enable/disable the keyboard toggle feature when paired with Apple iOS devices (iPhone, iPad, etc.). Download
Universal Menu Book This document contains the majority of Opticon's configuration barcodes necessary to configure the device to your specific needs. Download


Software

Software Description Download
Appload Appload is Opticon's multi-purpose utility for installing firmware onto devices such as the OPN2002. Currently Windows only. Download
Firmware: Bootloader This is the lowest level of firmware. Download
Firmware: OS One of two pieces of firmware required for the proper functioning of the OPN2002. Appload (see above) is required for loading the OS onto the OPN2002. Download
Firmware: Bluetooth Demo This standard demo application provides Bluetooth functionality and data transfer for both HID and SPP modes, as well as easy toggling of the iOS (iPhone/iPad/iPod) system soft keyboard. Batch storage is not supported. This application is pre-loaded on all OPN2002s prior to shipping. Appload (see above) is required for loading this application onto the OPN2002. Download
Firmware: Storage Demo This standard demo application provides batch storage of scanned barcodes. As this demo does not enable Bluetooth pairing or data transmission, all data must be transferred to a host (typically a Windows PC) via USB. Appload (see above) is required for loading this application onto the OPN2002. Download
Firmware: OPN2001 Simulation Application This OPN2002 application enables the OPN2002 to behave as an OPN2001 with regard to user behavior and PC interaction. Windows and Mac software specifically written for the OPN2001 is required to transfer or receive data from an OPN2002 running this application. Appload (see above) is required for loading this application onto the OPN2002. Download
Firmware: Bluetooth & Storage Demo This OPN-2002 application is also the firmware running in our OPR-3301 hand held Bluetooth scanner. This application combines the ability of the Bluetooth Demo to scan on demand as well as operate in a batch mode. Download
Firmware: Combination - Standard Bluetooth Application This single file is the Bootloader, OS and Standard Bluetooth Demo packaged into a single file for easy upgrading. Updated February 16, 2011. Download
Firmware: Combination - OPN2001 Emulator Software This combination file is the standard Bootloader and OS combined with the OPN2001 Emulator software. Note that you will need the OPN2001 PC Demo software installed on the PC you wish to use with your scanner. Download
Firmware: Combination - Storage Demo This combination file is the standard bootloader and OS combined with the OPN2002 Storage Batch demo application. Bluetooth functionality does not work when this firmware is installed. Download
Firmware: Combination - Bluetooth & Storage Demo This combination file is the standard Bootloader and OS with the OPR3301 Standard Demo which enables Bluetooth scanning and transmission with an optional batch mode for when the device is out of range. Note that this memorization capability must be enabled specifically via the Universal Menu Book options in Chapter 2 for batch mode to work. Download
OPN2001 PC Companion Application When the OPN2002 is running the OPN2001 emulation software it will additionally require this PC application to retrieve data from the scanner. Works in both USB and Bluetooth modes if the OPN2002 is paired with the PC where this software is running. Download
SDK: C-Library Kit The OPN2002 SDK is called the C-Library Kit. Embedded applications are written in C and are compiled with the WinARM GCC compiler. The compiler, source files, API information, libraries, sample code, and examples are provided in the download. Download


Drivers

Platform Description Download
All In One Installer Package 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