This document describes how to use SerialMagic Professional on Windows. It assumes basic knowledge of using Windows.

SerialMagic Pro for Windows (& Power Upgrade)

SerialMagic Professional Edition - Version 5.8.5.3

Windows 8, 7, Vista, 2003, XP, 2000

(SerialMagic is also available on Android, OS X, Windows Mobile, BlackBerry, Symbian S60, PalmOS)

Introduction

SerialMagic Professional will allow you to take serial data from a Bluetooth device or port, or an RS-232 serial port of a Windows

computer and enter it directly into virtually any Windows application that can accept keyboard input, perform special actions

based on the data received, and more.

This document describes how to use SerialMagic Professional on Windows. It assumes basic knowledge of using Windows.

Installation

Install SerialMagic Professional like most Windows applications. You must agree to the software license, and choose an

installation path. The default path is

C:\Program Files\SerialIO.com\SerialMagic Pro

If you have installed SerialMagic before, you may be asked to remove the old version first.

SerialMagic will install shortcuts in the Start menu (under SerialIO.com\SerialMagic Pro) and on the Desktop, either of which can

be used to launch the application.

Registration

Genuine SerialIO.com barcode scanners, such as the Scanfob® 2002 and KDC200, utilize automatic licensing with SerialMagic.

This means that you do not need to purchase the software or enter a registration key when using SerialMagic.

If you did not purchase your barcode scanner from SerialIO, then the SerialMagic

application must be registered to avoid nag screens.

Without registering SerialMagic or using a Genuine SerialIO.com scanner, every

third barcode or RFID reading will be replaced with the text “Unlicensed

SerialMagic”, as seen to the right.

See this guide for instructions on generating a license key:

http://serialio.com/support/FAQ/get_license_key.php

Open SerialMagic, and from the Help menu bar near the top of the application, choose Register SerialMagic.

Find your unique Computer ID found on your installation of SerialMagic from this screen and use it as the Hardware ID for

registration. The key will be generated for use in the bottom field as your License key.

If you have not yet purchased SerialMagic, click the Purchase link (

https://serialio.com//store/index.php?cPath=21_47_51) on the

registration screen to be taken to the SerialIO store where you can buy a license for SerialMagic.

New feature: Register via Web!

If you purchased a barcode scanner from

SerialIO.com, follow the instructions in the

following pages on connecting SerialMagic

to the scanner, and then use the Register via

Web option to complete registration.

Re-open this dialog from the Help toolbar, and

choose “Register SerialMagic.”

TM

Data transfer and application focus

SerialMagic has the ability to send any characters received over the serial port to be sent to another application. Data that is

received into SerialMagic will be sent as keystrokes, so it is important to keep focus in the text entry area of your application

while scanning. If your cursor is not in the proper location, the scans may be lost. If the device connected is a supported batch

scanner (Scanfob® 2002, KeyBatch BR1, KDC, or LaserChamp), then you can use batch processing to write the data to a .CSV

file, or as a backup in addition to the data going to the keyboard cursor.

Power Upgrade

SerialMagic Professional Power Upgrade provides an extra feature to SerialMagic that allows you to take stored data from a batch

mode scanner and upload the scans to your iScanList.com account. From there, they can be sent to an Email address, FTP server,

or SQL database. See Power Upgrade – iScanList.com section of this document for more information.

Power Upgrade also allows you to use the Mobile Grid Mobile Grid built-into SerialMagic. See page 25 for more information.

Drivers

If you are using a BlueSnap USB dongle to connect with a Bluetooth scanner or other Bluetooth device, you will need to install

the drivers for the BlueSnap USB adapter prior to launching SerialMagic. You can download them from the following page:

http://serialio.com/products/adaptors/BlueSnap_USB_DB9F.php

(SerialIO.com > Downloads > BlueSnap drivers)

For help installing the BlueSnap USB, see the following movie on our website:

http://serialio.com/support/Movies/Setup/BlueSnapUSB/bluesnap_project.html

(SerialIO.com > Downloads > BlueSnap drivers > Movie of BlueSnap USB driver installation on Windows)

If you are using a USB-to-serial adapter to connect a LaserChamp cabled scanner (or other serial device), you will need to install

the drivers from this page:

http://serialio.com/products/adaptors/usb_serial_WinDesk.php

(SerialIO.com > Downloads > USB to Serial Adapter > Windows users)

If you plan to use a KDC100, or the KDC200/300 as a cabled scanner, you will need the KDC driver located here:

http://serialio.com/download/Drivers/KDC200/KDC200PortDrives.zip

(SerialIO.com > Downloads > Download Windows software drivers for KDC100 / KDC200 / KDC300)

The installation process is nearly identical to the BlueSnap USB. Watch the movie above for installation help.

You DO NOT need this driver if you will be using the KDC200 or KDC300 in Bluetooth mode.

If you will be using the BatchMagic, (aka OPN-2001), a Scanfob® 2002 (aka OPN-2002), or KeyBatch BR1 (aka OPN-2003)

as a tethered scanner, you will need the BatchMagic/Scanfob/KeyBatch driver located here:

http://serialio.com/download/Drivers/BatchMagic_USB_Drivers_Installer.exe

Adding new Connections

Upon first launch of SerialMagic, the Select How Scanner Will Connect screen should appear.

This screen also occurs when you click the “Add” button in the connection area of SerialMagic, to add a new connection.

Here you will begin the device configuration process. Choose the Connection Type, Scanner type, then click Next.

*For help with removing non-Microsoft Bluetooth drivers, see this link: http://serialio.com/support/LaserChamp/3rdPartyRemove.php

Note about Bluetooth Passkeys

All of the Bluetooth devices that SerialMagic supports should have a Bluetooth passkey of either “0000” (four zeros) or “1234.”*

If you have a device that is considered “Other” by SerialMagic, or you are unsure of your device’s passkey, please contact your

device manufacturer for support.

*The Metrologic MS9535 (VoyagerBT) at one point used the last 4 digits of the Scanner Serial Number as the Bluetooth Passkey.

(This can be found on the back of the scanner, just above the small barcode on the left side.)

Setup for Bluetooth scanner using BlueSnap USB

1) From the Select How Scanner Will Connect screen, select Connect to the remote Bluetooth device using BlueSnap

USB and select your scanner type before clicking Next.

2) Select the correct COM port for the BlueSnap USB and click Next.

3) SerialMagic will then prompt the user to activate the Bluetooth device so that it may be discovered. Before clicking OK,

make sure that your Bluetooth scanner is in a mode that allows it to be discovered.

4) Click OK to start the Discovery phase; this usually lasts about 30 seconds.

Choose how the scanner will connect

• Connect to the remote Bluetooth device using

BlueSnap USB – Select if using BlueSnap USB

Model 4 Bluetooth adapter.

• Remote Bluetooth device will connect to

SerialMagic using BlueSnap – use this option for

master mode scanners that initiate the connection

using a BlueSnap, as opposed to the computer.

• SerialMagic will connect to the remote Bluetooth

device using Windows Bluetooth – Select if using

a Microsoft Bluetooth stack, or a generic Bluetooth

adapter that uses Microsoft the Microsoft driver.

SerialMagic cannot use other Bluetooth drivers.*

• Remote Bluetooth device will connect to

SerialMagic using Windows Bluetooth – use this

option for master mode scanners that initiate the

connection, as opposed to the computer.

• Cabled connection – Select if connecting the

scanner or other device via a cable connected to

USB or serial port.

• WiSnap WiFi connection – Select if using a

WiSnap serial adapter

Choose scanner type

The available options for scanner type will depend

on the connection type chosen above.

TM

5) SerialMagic will list all available Bluetooth devices in the area. Select your scanner and click Next.

6) Next, enter the scanner's pairing code (see the note on Bluetooth passkeys above), and the BlueSnap USB will pair up

with your device. Once pairing is complete click OK.

7) Once “Input device was setup successfully” appears click Finish to exit the Device Wizard.

8) You will be brought to the SerialMagic main screen. Click “START” to initiate the connection and begin scanning!

A. Select the BlueSnap USB COM port B. Select the Device Type. Leave Connection Type as BlueSnapUSB.

C. Activate the Bluetooth device D. Select the desired scanner

E. Enter the pairing code F. Pairing is complete. Click “Finish” when you see “Input device was setup successfully.

After the devices are paired, SerialMagic will display the main application window. You should see the scanner listed under

Connection. Click Start to begin receiving data!

Remote Bluetooth device will connect to SerialMagic using BlueSnap

1) From the Select How Scanner Will Connect screen, select Remote Bluetooth device will connect to SerialMagic using

BlueSnap. Then select your scanner type and click Next.

TM

2) Select the input device location and then click Next.

3) Setup device usage method and then select Next.

4) After successfully configuring the BlueSnap device, a web link, entitled “Print BlueTooth connection barcodes” becomes

available in the setup wizard. Open the web link.

5) After opening the link, print the custom connection barcode and DO NOT LOSE IT. This barcode is generated

specifically for use with your personal BlueSnap device. Its purpose is to allow Bluetooth hand-scanners to find and

connect to your BlueSnap device. It will not work with any other BlueSnap devices.

TM

6) After printing the barcode, go back to the setup wizard and click Finish.

8) After starting the connection, if it is the first time you are using the scanner, or if the scanner was previously paired with

another Bluetooth device, you will need to put your device into set up mode. When using the Scanfob® 2002, this is done

by scanning the SerialMagic – SPP barcode. This barcode can be found on the second page of the Scanfob® 2002 Setup

Document with SPP and HID setup barcodes

, which can be obtained

here:

http://serialio.com/support/Scanner/Scanfob_2002/Docs/Scanfob-2002-BT-Setup-SPP-HID.pdf

9) Next: scan the custom connection barcode you printed off of the internet. It should look like this:

*Note: You will need to scan this barcode each time you connect the device to the BlueSnap.

** If your device is in batch mode, scanning the connection barcode will initiate the batch upload.

10) To disconnect the device, scan the “Disconnect and Radio Off.” This barcode is normally found on the bottom of the

second page of the Scanfob® 2002 Setup Document with SPP and HID setup barcodes

, which can be obtained

here:

http://serialio.com/support/Scanner/Scanfob_2002/Docs/Scanfob-2002-BT-Setup-SPP-HID.pdf

TM

Setup for Bluetooth scanner using Windows Bluetooth

(Built-in Bluetooth or Generic USB Bluetooth Adapter)

You can setup the Bluetooth connection with the scanner using a generic Bluetooth USB dongle or Bluetooth radio built into a

computer. This process has changed slightly between versions of Windows, so the following screenshots will detail this process

on both Windows 7, and Windows Vista/XP.

To begin, make sure that your Bluetooth radio is powered on, as many laptops have a

switch to disable the Bluetooth radio. Click the Bluetooth icon in the system tray, and

select “Add a Device,” as shown to the right. You can also view or add Bluetooth

devices from the Control Panel > Bluetooth Devices on Windows Vista/XP, or Control

Panel > Devices and Printers on Windows 7.

1) Windows will immediately begin discovering (and keep discovering) Bluetooth devices on this screen. Activate your scanner's Bluetooth, and choose it when it appears. Click Next.

3) Windows will complete the pairing process. Click the link at the bottom of the text on this screen labeled Devices and Printers, so we may find the COM port that was assigned. This will be the COM port used with SerialMagic.

TM

4) Go to the properties of your paired scanner by right-clicking and choosing: Properties or with a double-click.

5) From the properties page seen above on the right, navigate to the Hardware tab and note the name of the COM port in parentheses. This example screenshot shows COM12, however yours may be different.

You can also right-click on the Bluetooth icon in the system tray, choose “Open Settings,” and click on the COM Ports tab. Find the Outgoing COM port for your device.

Once this has been completed, jump to page for the section on configuring SerialMagic to use this COM port.

The following screenshots will assist you with setup on Windows Vista, but the process is very similar to the setup on Windows

XP. If you are using Windows 7, and have paired your scanner with Windows Bluetooth, jump to the next section on setting up

SerialMagic to use with your paired scanner.

2) Windows will search for Bluetooth devices as shown below. Select your device and click Next. If your device does not appear, verify that it's Bluetooth radio is active and discoverable, and click Search Again.

3) Choose the option: “Use the passkey found in the documentation” and enter the pairing code (see the note on Bluetooth passkeys above), then click “Next”. Windows will verify the passkey and complete the pairing process. Click Next.

4) You should see the port numbers assigned to the Bluetooth device. Make note of the “Outgoing COM port:” number, COM30 in the example above.

TM

Once the scanner has been paired with Windows Bluetooth,

launch SerialMagic and complete Setup by the following steps…

SerialMagic will return to the main screen. Click START to initiate the Connection, and start scanning!

1) Begin by adding a new connection (Click

“Add” below the Connections list). From the Select How Scanner Will Connect choose SerialMagic will connect to the remote Bluetooth device using Windows Bluetooth, and select a scanner type.

2) Select the Bluetooth COM port that has been assigned to the scanner. This is the “Outgoing COM port” from the steps above.

4) The Add New Connection window should display the proper settings with your scanner. Click OK.

3) SerialMagic will display “Input device was setup successfully.”

Troubleshooting Windows Bluetooth

Once a Bluetooth dongle has been installed on a Windows XP/Vista system, the “Bluetooth Devices” icon will always appear in the Control Panel. The only way to guarantee that the Bluetooth adapter hardware is still present is by looking in Control Panel > System > Hardware > Device Manager.

If you see the following dialog, it is possible that the Bluetooth radio on the USB Bluetooth dongle has gone away or become unstable. Try removing the dongle from the USB port and then plug it back in. If the Bluetooth radio of the device goes inactive during the setup

process you may see the dialog similar to that shown below. In this case insure the devices Bluetooth radio is active and try again. Note that the default setting for the LaserChamp Bluetooth radio is to turn off after 60 seconds of activity. Press the LaserChamp scan button to keep the scanner Bluetooth radio active.

If SerialMagic is unable to connect to the scanner, double-check that the correct COM Port is selected.

To view the Bluetooth devices assigned to COM ports at any time, from Windows XP or Vista, go to Control Panel > Bluetooth Devices, and click the “COM Ports” tab. The “Outgoing” port will be the port used with SerialMagic.

From Windows 7, you will need to right-click the Bluetooth icon in the system tray and choose “Open Settings” before clicking the “COM Ports” tab. Note the “Outgoing” COM port for use with SerialMagic.

TM

Setup for Cabled Scanner Connection

SerialMagic can be configured for use with a cabled scanner, such as the Scanfob® 2002, KeyBatch BR1, BatchMagic, KDC

scanner, or any device that is set up as a serial device. Many USB devices will install a serial COM port in the system while

connected, granted the proper driver is installed. See the section on drivers to obtain drivers for your device.

1) From the Select How Scanner Will Connect screen, choose Cabled connection and select the Scanfob® 2002, KeyBatch BR1,

BatchMagic, KDC or Other scanner, according to what you will be using.

2) Make sure the device or cable is plugged into the computer, and click Next.

3) Select the COM port that has been allocated to your device. You may be able to tell by the name in parentheses, but if you do not know which COM port to choose, simply remove the USB cable from the machine. The COM port will disappear. The correct COM port will re-appear when you plug it back in.

4) If you selected “Other” as the scanner type from step 1, you will have to specify a device type

5) Wait a few moments while the scanner is setup… If you receive message: “Input device was setup successfully” then click Finish. 6) SerialMagic will return to the main screen, click START to initiate the connection and start scanning data!

A. Select How Scanner Will Connect

B. Select proper COM port

C. If you chose Other as your scanner type from step 1, you will need to specify a device type and connection type.

A. Select Cabled connection and the scanner type.

D. SerialMagic may take a moment to set up the scanner.

Setup WiSnap using WiFi

SerialMagic can be configured for use with a WiSnap dongle.

1) From the Select How Scanner Will Connect screen, select WiSnap WiFi connection, select your scanner type (for a generic WiSnap connection, select “other”), then click Next.

It is recommended to use the Device Wizard to add most devices. If connecting a device using a BlueSnap USB Bluetooth adapter, a LaserChamp II Cabled scanner, or OPN-2001 scanner, using the Device Wizard is the only way to guarantee proper configuration. The other option is the “Manual Setup”, where you can manually select the Port, Device Type, and Connection Type from the drop-down lists. You may also configure port settings, such as baud rate, etc. using the Configure Port Settings button.

TM

2) If your WiSnap device has been properly configured to operate on your WiFi network, it should appear in the list of nearby WiSnap devices. When your device appears on the list, select it and then hit Next.

* If your device does not display, it may not have been properly configured to operate on your WiFi Network. More information on this

process can be found here: http://serialio.com/support/WiSnap/index.php

4) Confirm the configuration settings and hit OK.

5) Start the connection with the WiSnap Device.

TM

7) SerialMagic should now be ready to insert data into the Mobile Grid using a WiSnap device.

Manual Setup

Port

This dropdown menu will contain a listing of COM ports. If you are using a USB device, SerialMagic can auto-detect which port it is using. Simply unplug the device, and plug it back in, SerialMagic will detect and choose that port automatically.

Connection Name

Here you can give a name to the connection, such as “Mike’s scanner,” “Bluetooth #3” etc.

Device Type

Choices are: Scanfob® 2002, KeyBatch BR1, BatchMagic 2001, Restock SS BT-M2, KDC100, KDC200, KDC300, BlueSnap, CS3070, LaserChamp – Rov – Flic, CHS7, IDChamp, MS9535, MS1633, Pneu-Logic Probe, SF51, Other, and Virtual Scanner

Connection Type

Choices are: Raw, LaserChamp - ROV - Flic Cabled, LaserChamp - ROV - Flic Roaming, BlueSnap USB, BlueSnap-Slave, BlueSnap RS-232 or CSR, Windows Bluetooth – SerialMagic connects, Windows Bluetooth – Device connects, Scanfob® Scanner USB, and KDC-USB

Configure Port Settings

This option becomes active only after choosing “Raw” as the Connection Type. You will need to use this option only if your device is not listed, and considered “Other.”

SerialMagic Main Dialog Window

The SerialMagic main dialog is where the commonly used controls are accessed.

Connection

Here you can Add, Remove, and Edit connection settings for various devices. The drop-down menu contains the Name/Description of all devices that have been defined by the “Add” feature.

Start

Select Start to initialize connection between your computer and other device, SerialMagic will then be ready to receive data.

Quit

Use this option to exit SerialMagic.

Bluetooth Status

This applies when the “Connection Type” is Bluetooth. A status message and traffic light representing the connection status will appear here (red light means disconnected, green light means connected and ready).

Application Settings – See Application Settings section below.

Setup Scanner

This option becomes active once SerialMagic is started and connected to your device. The Setup Scanner process ensures that your scanner has the proper configuration to work with SerialMagic. Some scanners require the use of Setup Scanner, such as the Socket CHS7.

Current SMAP:

Displays the SMAP that is currently active in SerialMagic. When SerialMagic is in Byte mode this status will reflect the state by showing “OFF, using Byte mode.” SMAPs may be disabled in Application Settings.

Action Profiles Manager

The Action Profiles Manager contains all of the SerialMagic Action Profiles. See SerialMagic Action Profiles (SMAPs) section.

iScanList.com Settings

iScanList.com is the Power Upgrade feature of SerialMagic, that can send a .CSV file containing scans to a specified email address, FTP server, or SQL database.

This feature is only available if you have the Power Upgrade version, and an iScanList.com account. See the iScanList.com Settings Section at the end of this document.

Downloaded / Sent to Application

When “Buffered Download” is enabled, Downloaded will show the total of scans downloaded from the scanner, and Sent to Application will increment every time a scan is sent to your target application.

Send Next / Send All

Use these buttons to send the next buffered scan, or all buffered scans, to your target application (instead of using the Hot Keys). If using these buttons, the active SerialMagic Action Profile must have a “Focus” action otherwise your scans will not be delivered.

TM

Tools

Send File Contents

Use this option to send the contents of a file from the host machine to the connected device. This option is only available if the “Device Type” is set to “BlueSnap” or “Other.”

Clear Scanner Memory

Use this option to manually clear scanner memory from a supported batch scanner (LaserChamp II, BatchMagic, KDC-series).

Alternatively, have SerialMagic clear scanner memory automatically after a batch download with Application Settings > Downloads > “Auto-Clear Scans.”

Laser Champ BT Timers

Use this option to set the timers values associated with the Bluetooth connection with the Laser Champ scanner.

CONNECT Timer- time before Bluetooth connection is turned off.

SLEEP Timer – If scans are in the LaserChamp’s memory while it is sleeping, it will wake up and connect when this timer expires to send the batch of scan data.

Setup Remote BlueSnap

Select this option to remotely configure a BlueSnap module. This feature is handy when using a serial cable and terminal application to configure the BlueSnap is not an option, or too

cumbersome. The BlueSnap USB module is required for SerialMagic to use this feature, and the target BlueSnap module must be in slave mode.

You must first define the connection by Connection > Add. Your device type should be BlueSnap, and connection type BlueSnap USB.

Once the connection is added, do not start SerialMagic, but instead choose Setup Remote BlueSnap from the Tools menu. SerialMagic will remind you that the BlueSnap to be configured must be in slave mode.

Virtual Scanner Settings

The Virtual Scanner feature allows you to test SerialMagic Professional’s functionality without needing to have scanner hardware.

With this option, you can configure up to 3 scans (entered manually) that will simulate the receipt of a scanned barcode when the defined Hot-Key combination is hit on your keyboard.

To configure use of Virtual Scanner, you must select the Device Type of “Virtual Scanner.” Once you’ve configured the Virtual Scanner Settings, you can START SerialMagic as normal. While SerialMagic is running, every time the Virtual Scanner Hot-Key is pressed, a simulated scan will be sent and posted from your configuration. This includes Action Profiles, which are outlined later in this document.

Show Registered Apps

This option will show a dialog displaying applications that have been registered with SerialMagic’s Direct Data API.

Scanner Settings

This option allows for the BatchMagic (OPN-2001) settings to be configured by

SerialMagic, such as disabling or enabling the scanner’s beep when a barcode is scanned.

Setup Pneu-Logic Probe

Select this option to configure your BT probe. BT probe must be connected and SerialMagic started to select menu feature. Use Tread Calibration and Pressure Calibration to configure the default settings for the BT probe.

Application Settings

Status bar

The Status bar at the bottom of this screen will warn you if settings changed on the current tab have affected settings on other tabs.

Global

Start SerialMagic when Windows is started

SerialMagic will be registered to start every time Windows is started.

Minimize to System Tray

SerialMagic will minimize to the System Tray instead of the Task Bar.

Post Direct Data

Enable this option to use SerialMagic with the Direct Data API (sends data directly to other applications, not by simulating keystrokes).

Delay on Start

Provides an option to setup SerialMagic when Start button is clicked. When not selected, SerialMagic will start immediately. This delay can be handy when working with scanners such as the LaserChamp. When there are scans in the scanner memory, SerialMagic can begin to download scans immediately, and this delay allows the user a user-defined delay to focus the target application.

SerialMagic Socket

Developers running a localhost now have the ability to establish a socket connection by way of a specified TCP/IP using port 27015. Enabling this feature will allow developers to communicate web applications with Serial, Bluetooth or WiFi devices. Please note that your host needs to be internet routed. Consult your network administrator for help properly routing port 27015 to your host machine.

Default Action Profile Path

This is the default location where your SerialMagic Action Profiles are stored.

Post to file

This option will write all data received from the scanner to a file specified at this location. This has the benefit over Downloads options such as “Read scanner using batch mode,” and “Write CSV files,” because Action Profiles are fully processed before the file is written.

TM

Action Settings

Enable Translation

This is a global filter that can be used to change a single value in the input stream to another value. Substitution values must be ASCII codes entered in Hexadecimal.

Inter-character Posting Delay

Delay between characters when posting to the keyboard buffer (useful for slow machines or sending to slow applications). Delay time is in milliseconds, so 1000 = 1 second.

ISBN Conversion

When this is selected, SerialMagic Professional will provide the 10 digit ISBN number to the program when an EAN-13 Bookland code is scanned. The LaserChamp or Flic scanner must be configured by scanning the following codes:

DISABLE SUPPLEMENTAL CODES and AIM IDENTIFIERS ENABLE

(These codes can be found at Serialio.com > Support > LaserChamp/Flic Support Pages)

Use Action Profile (SerialMagic Action Profiles – SMAs)

This option enables or disables the use of SerialMagic Action Profiles, which are very powerful functions that can occur with each barcode scan or data packet input. Menu options can be with selected, patterns can be search for, data can be ignored, and other functionality. (See SMA section for more information.)

RFID post data format

Indicates the data format when using RFID. The options are: HEX, ASCII, DEC

Byte Mode

Advanced mode that will not packetize the data, instead sending it byte-by-byte. SMAP’s cannot be used in this mode.

Packet Mode

This is the standard mode and is required for SMAP support.

Start Flag

The Start Flag is a byte that comes before the data, to tell SerialMagic where the data begins.

Action Byte

Default is CR, this is the “End Flag” used by SerialMagic to identify the end of a packet of data.

Regarding Start flag and Action byte: different scanners send different formats of data, but SerialMagic will automatically set these options based on the scanner that is being used. If your scanner type is “Other,” you will need to set these options manually, so check your product’s documentation.

Downloads

Read scanner using batch mode

This option will allow SerialMagic to read from the scanner’s batch memory, and enable all other batch mode options. There may be additional steps necessary to put your scanner into batch mode. Check your scanner’s documentation.

Show count before download

This option will show a dialog containing the number of scans in memory before they are downloaded.

Power off scanner Bluetooth after download

This option can shut off the scanner’s Bluetooth radio to conserve battery after the scans have been received.

Auto-clear scans

When enabled, SerialMagic will clear the scans from the scanner once downloaded. Alternatively, if this option is disabled, you can clear the scanner manually from the main window with Tools > Clear Scanner Memory.

Confirm clear scans

Requires “Auto-clear scans,” and will bring up a prompt asking you if you are sure that you want to clear the scanner’s memory.

Notify scans deleted

Requires “Auto-clear scans,” and will prompt you that the scans have been cleared.

Write CSV Files

Check this option to write the batch of scans into a CSV file.

Include CSV header

This option will add the corresponding headers to each column of the CSV file, when writing to CSV files.

Put SN

Check this option to have the Serial Number of the scanner written to the CSV file.

Put Timestamp

Check this option to have SerialMagic post the timestamp of the scan into the CSV file.

Set Scanner Clock

Check this option to synchronize the scanner’s internal clock to the current system time each time the scans is downloaded (recommended).

CSV File Path

Each time scanner data is downloaded, SerialMagic will generate a new CSV file containing scan data in this directory.

Append CSV file

Select this option to have SerialMagic continuously add all scan data to a single CSV file.

Buffered Download

SerialMagic will store all scans until a specified Hot Key is pressed, which will send the next scan or all of the scans at once. Best used with Batch mode.

Hot Keys

Choose specific Hot Keys to “Send Next” or “Send All” buffered scan(s). Default Hot Keys are Ctrl+F11, and Ctrl+F12.

Supported Batch Scanners Only

The following options are only supported if using a Scanfob® 2002, KeyBatch BR1, BatchMagic (OPN-2001) scanner, LaserChamp II or KDC scanner.

Timestamp Format

Allows you to change the way that date/time stamps are recorded in batch mode.

TM

EnduraScan™

EnduraScan™ is a wireless technology allowing longer battery life of the mobile device. When enabled, EnduraScan™ Auto-Stop will disconnect the Bluetooth connection after the selected time if there has been no data transfer activity between the handheld and peripheral.

Timed Auto-Stop (TAS)

When checked EnduraScan™ will disconnect the Bluetooth connection after the chosen time.

Scanner BT off

When checked will EnduraScan™ will turn the scanner's Bluetooth off, when the Bluetooth connection is closed.

Audio

Audio on connect

This audio file will be played whenever SerialMagic becomes connected to a device (you can leave default, or use custom audio file).

Audio on disconnect

This audio file will play whenever SerialMagic becomes disconnected from a device (you can leave default, or use custom audio file).

Audio on delete

This audio file will play to notify that scans have been deleted from the scanner.

Log

Enabled

Logging is used to troubleshoot causes of errors in SerialMagic. Technical Support may ask you to enable logging, which is this option.

Maximum size

The maximum size, in kilobytes, for the log file. Default is 2 megabytes (2048 KB), but can also be set to zero (0) for no size limit.

File name

File name and location of the log file.

Send Command

Hotkey

This defines the Hotkey that is pressed to send the command data specified. The Send Command feature is designed for use with devices that require a command to be sent before they respond with data, such as a digital scale.

Command Data

This defines the data that will be sent to the device when the Hotkey is pressed.

Append CR

Check this option to add a CR (carriage return) after the command data.

Data as HEX

Check this option to send the Command Data in HEX format.

Measure Genie™

Enabled

When enabled, the Measure Genie will look at incoming data and only report changes to incoming data.

Measure Time

Amount of time, in milliseconds between each data posting. Default: 2000 ms.

Settle Time

Filtering

Ignore Duplicates

Barcodes scanned multiple times will be ignored.

See as New Row after (sec):

TM

SerialMagic Action Profiles (SMAPs)

To customize SerialMagic to fit your workflow and utilize features only in SerialMagic Pro, you can use the SerialMagic Action Profiles. As long as Application setting “Use Action Profile” is checked, you can click on the Action Profiles Manager in the main SerialMagic window.

If you right-click in this area, you can choose from the following options:

Add Profile – Opens a prompt for a name and description for your new Action Profile.

Load Profile – Allows you to browse for an .msma file, which contains a SerialMagic Action Profile.

Remove Profile – Removes the selected profile from the Action Profiles Manager. This will not remove the .msma file from your computer. Edit Profile – Edit the name or description of this profile.

Copy Profile – Opens a prompt similar to the Add or Edit Profile options, but will copy the selected profile’s contents into the newly created profile.

Set to Active – Allows the user the option of setting the selected profile to active.

On – Applies to “Default: Global Actions”, only. When “Default: Global Actions” is “On” these actions will be run every scan. These are useful for scanning special barcodes to change the current SMAP, and other such functions.

When you select a profile, you will notice the Actions tab appears. If you switch to this area, you will see a list of Actions or Patterns that SerialMagic will execute in order from top to bottom. By right-clicking, you can Add, Edit, Delete, and arrange (Move Up and Down) Actions and Patterns.

Action options:

Data-In

Inserts the unmodified scanned data,

Key

Enters the selected keystroke selected from the drop-down menu. To simulate modifier keys, select the appropriate checkboxes.

Text

Enters the desired string of text.

Delay

This action delays SerialMagic from performing additional actions, for a specified amount of time, in milliseconds.

Date/Time

Places a timestamp with different formatting options.

Focus

Switch the focus to a target window. For easy window selection, drag and drop the crosshair onto your desired application.

Open

Opens a desired application. Use the folder icon to browse to your target executable.

Clip

Clip data from start and/or end of scan or packet. The FIND option will use the chosen characters from the FIND Pattern to clip the contents of the data, instead of a fixed amount of characters.

Post-Data

Post data that has been modified, by a Clip action, for example.

Post-Part

Post the range of data specified from Byte X to Byte Y (each character in the sequence is 1 Byte). Or use specified “FIND value” as marker for Start or End of desired data (must use the “FIND” SMA prior if using “FIND value” as marker).

Prompt-Num / Post-Num

Display a prompt asking for number input. The Message field allows you to customize the prompt with a message, and enabling the location option will let you position the prompt, using pixel coordinates (top-left is 0 x 0). Call the Post-Num action later on to post the input from the prompt.

WEB

Launches default web browser to specified URL prefix, followed by barcode data, with optional URL suffix. Example: http://restock.com/mobile/findupc.php?w=1&upc=(Barcode)

Done

Stop SerialMagic from processing any further actions in the profile.

Exit

Stop SerialMagic from processing any further actions on the selected list. If the list returns to another list processing may resume in the list that is returned to.

SET-ACTIVE-SMAP

TM

POST-SCAN-TIMESTAMP

Use this action to post the timestamp of the scan to the keyboard cursor. Only available with OPN-series scanners (Scanfob® 2002 and BatchMagic) or KDC-series scanners (KDC100, KDC200, KDC300)

PROMPT-READ-SCAN / POST-SCAN

This action will prompt the user with a message, and allow the user to scan a barcode into the prompt. Describe the type of scan by

“Identifying” it (example: Part Number, Serial Number, etc.) then later you can use SCAN action to post that type of scan. The POST-SCAN Action requires an SMAP to be chosen and will be performed after the data is posted.

SET DATA / GET-DATA / REMOVE DATA

These three actions work as a data storage mechanism. If for example, you wanted to capture a Part Number of an item, and save it to be posted at another time, use the “SET-DATA” action to “Save” the data, with “Marker” set to “Part Number.” To retrieve the data from memory, simply use the “GET-DATA” “Part Number” action, and then to post the data, use the “POST-DATA” action. To remove the stored value for “Part Number” use “REMOVE-DATA”: “Part Number”.

DEVICE-ID-POST

This action has two options to post a unique identifier for the scanner that sent the data. The first option, Friendly name, will post the serial number for the scanner in a format similar to what you see as the connection name the main window of SerialMagic. The other option, BT address, will post the hexadecimal MAC address from the Bluetooth device that sent the data.

SCANNER-SN-POST

This action posts the Serial Number of the device initiating the scan. Pattern options:

MATCH-BYTE - Looks for a particular hex value in the data. Choose an ASCII character and SerialMagic will pick the matching ASCII hex

value.

MATCH - Looks for a certain set of characters at the specified position in the data.

LENGTH – Allows matching based on the total length of data packet, and can optionally require match of data. DO-WHEN-SCAN-COUNT - Provides actions based on the number of scans received, example “Every 3 Scans do…” FIND - Searches incoming data for a specified character or string of characters.

SerialMagic Action Profile (SMAP) Example

This example will create 3 columns in a spreadsheet based on the length of the input data. Suppose for example barcodes are being scanned and you want Part Number, Quantity, and a date stamp. The Part Numbers are 6 or more digits and the Quantity is less than 6 digits. The screens following show the proper settings are added to the Edit Action Profile dialog.

-First, go to “Action Profile Settings” from the main screen -Right-click and select “Add Profile”

-Give the profile a name and description, as shown in the following screen.

Click OK, and Save the new profile. Next, highlight the profile, and click on the Actions tab. Right-click and choose “Add Pattern.”

For this profile, we will choose “greater than or equal to” and enter “6” in the field, and click OK. Then select the Length Pattern and you will see an Actions tab appear at top.

Switch to the Actions tab, then right-click and select “Add Action”. First add a “Data-In” action. Then, add a HOME keystroke by selecting Key from the first drop-down menu, and HOME from the second drop-down menu. Repeat this again for the ENTER key. These two keys will ensure that we are in the first column of a blank row in our spreadsheet.

TM

At this point in the profile, once a barcode over 6 digits is scanned, we will be at the first column of a blank row. Now we can insert the data into this cell.

To insert the scanned data, we will use the action: DATA-IN. Right-click, and again, choose Add Action. Select Data-In, and click OK. Now we want to move into the next column, and the tab key does just that. Add another Key Action with the selected key being TAB. Your complete pattern should look like this:

Click on the Pattern tab to see the main list of Actions again. Create another LENGTH pattern with “less than 6”. When a barcode of less than 6 digits (quantity scan) is scanned, we want SerialMagic to put in that data, tab to the next column, and insert a datestamp. This would use the

Actions Data-In, Key: Tab, and finally the desired date/time format.

Then save the SMA profile and when barcodes of 6 or more digits are scanned, they will be entered into the first column, and barcodes that are under 6 digits will be posted following a date stamp in next two columns.

Mobile Grid and iScanList.com (Power Upgrade Only)

If you have a BatchMagic (OPN-2001) or Scanfob® 2002 (OPN-2002), and you want to use batch mode to upload

directly to iScanList.com, please see our free ScanListMagic application located here:

http://serialio.com/products/ScanListMagic/iScanList_ISL.php

The Scanfob® 2002 (OPN-2002) can also be placed into Batch Mode by scanning the appropriate control barcodes.

The control barcodes can be obtained from the Scanfob® 2002 (OPN-2002) support page:

http://serialio.com/support/Scanner/Scanfob_2002/index.php

under the section “Print the barcodes for setting scanner

batch mode options.”

The Mobile Grid feature can be used as a simple spreadsheet for data entry and collection from a scanner, and will

upload directly to iScanList.com.

To begin using the Mobile Grid, click on the spreadsheet icon below the Start button.

Once in the Grid, you’re ready to begin scanning! (Assuming SerialMagic is Started and connected)

By default, the grid will move down to a new row after each scan. You may configure an Action Profile to suit your

needs.

You will be asked for iScanList Upload Settings. Enter your username and password for iScanList.com. New users can

register for a free account here:

https://iscanlist.com/signup.php

The List Name Prefix will be the beginning of the name of the grids uploaded, and is useful for easily seeing which

device the grid came from.

iScanList.com settings

Mobile Grid Main Screen

Opens the Mobile Grid Manager Inserts a row into the grid

Removes the selected row from the grid Saves the current grid

Saves the current grid as a CSV file Uploads current grid to iScanList.com

User: Enter your username.

Password: Enter your password

List Name Prefix: Add a prefix to the beginning of the upload file.

Enable Direct Upload: Used in conjunction with batch mode. Enables uploading

of batched scans directly to iScanList immediately after connecting. SerialMagic

and the scanner must be put into Batched mode in order for this feature to operate

correctly.

TM

Mobile Grid Manager

The first icon at the top showing many sheets is the Mobile Grid Manager, which displays the grids you have created or

are editing. In addition, using the icons at the bottom of the Manager will allow you to change settings, choose a grid

to edit, remove grids, delete an uploaded grid, or upload a grid.

Mobile Grid Settings

Edit columns

Auto-Width: Automatically adjusts column sizes to fit the data inside of the cells.

Show grid on SM start: Automatically shows the Mobile Grid when SerialMagic is started. Show grid when SM in focus: If SerialMagic becomes the active application, the Grid will be shown.

Auto-save: Allows you to choose a time period to automatically save the Grid. Save grid on Scan: Saves grid after each scan.

Update Qty column for same scan: Updates the item quantity when the same item is scanned. If this option is enabled, be sure to rename a column to “Qty” by clicking on the “Edit columns” button. Additionally, be sure to enable an action profile that does not automatically hit enter. An example profile is automatically provided. To enable it, set the “Combine Quantities Example 1” Action profile to active in SerialMagic Action Profiles. Edit columns: Add, remove, or change the column headers.

iScanList settings: Change username or password for iScanList.com CSV file store path: Sets the default directory location for storing CSV files

Add a column, will prompt for the new column name. Remove the selected column.

Edit selected column name.

Move column up or down, affecting the order of the columns in the grid. Mobile Grid Settings

Edit selected grid

Delete selected grid

Delete uploaded grid Upload selected grid.

Appendix A

Important Notes on LaserChamp Cabled Setup

If you have a LaserChamp II scanner, these settings are automatically set during the “Scanner Setup” process.

**Notes do not apply to Bluetooth scanners**

**If you unplug the scanner and plan to use the scanner in “Roaming Mode” make sure your target application is open, and the

keyboard cursor is in the correct location before you plug in the scanner to download! **

Proper Scanner Configuration

If you have an original LaserChamp (NOT LaserChamp II), “Flic,” “NCR Realscan,” or other Microvision 1

st

Generation scanner,

you will need to print out and scan the following barcodes for the scanner to work properly with SerialMagic.

ACK-NAK ENABLE SEQUENCE NUMBERS ON

Using USB Adapter cable w/ HID

If you purchased a USB Adapter cable w/ HID, which connects the scanner directly to USB by a single cable (NOT a serial cable + USB-serial adapter cable) then please see the following link for setting up your LaserChamp original or LaserChamp II “ROV.”

http://www.microvision.com/barcode/resources/documents/USBPnPCableQuickStartGuide.pdf

Note that if you are using this cable with SerialMagic, set the cable to “VCOM” mode, make note the port number, and configure the scanner accordingly.

You will also need to download and install the appropriate drivers, found here: http://www.microvision.com/barcode/support/drivers.html

(Microvision.com > Barcode Scanners > Support > USB Drivers)

Scanning Books with LaserChamp for applications such as Readerware

The LaserChamp and Flic scanners in factory mode will, by default, produce two barcodes when a book ISBN number is scanned. The scanner must be configured to “combine barcodes” in order to produce a single barcode for the ISBN as is required by applications such as Readerware. Scanning code below will do this. Note: Readerware does not require ISBN conversion option above.

LaserChamp II code LaserChamp I code

Combine Barcodes ENABLE Combine Barcodes ENABLE

Scanfob®, LaserChamp and SerialMagic are trademarks of SerialIO, LLC Contact Us!

If you have questions or comments please contact us. [email protected]

(Barcodes must be scanned from printed copy, scanning from the computer monitor will not work.)