SerialMagic Professional User Guide

Transcription

1 SerialMagic Professional User Guide Setup for Windows 7, 8 & 10

2 Contents Introduction... 4 Data Transfer & Application Focus... 4 Application Setup... 4 Installation... 4 Drivers... 7 Registration... 8 Adding New Connections... 8 Bluetooth Passkey... 8 Connection Types... 9 BlueSnap USB Setup Prerequisites SerialMagic Connects to device Device Connects to SerialMagic Windows Bluetooth Setup Pair via Windows Bluetooth Pair via SerialMagic Professional Cabled Connection Setup WiSnap Setup Manual Setup Options Port Connection Name Device Type Connection Type Configure Port Settings Definitions Main Dialog Window Connection Start/Stop... 14

3 Quit Mobile Grid Bluetooth Status Application settings Setup Scanner Current SMAP Action Profiles Manager Cloud-In-Hand Settings (Cloud Account) Downloaded / Sent to Application Send Next / Send All Tools Setup Remote BlueSnap Show Registered Apps Scanner Settings Virtual Scanner Settings Send File Contents Clear Scanner Memory Download Scans Write TAGs Application Settings Global Action Settings Downloads ODBC RFID Filtering Log Audio Send Command Measure Genie EnduraScan Action Profiles Action Options Pattern Options Action Profile (SMAP) Example... 30

4 Cloud-In-Hand & Mobile Grid Cloud Upload Settings Mobile Grid Settings Troubleshooting Windows adds new COM ports for every new USB device Solution: Remove unused COM ports in Windows Links Related Content Software Drivers Introduction Data Transfer & Application Focus SerialMagic can send any characters received over the serial port 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 2006, 4000n/i, 3002i, KDC or KeyBatch BR2), 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. Application Setup Installation Install SerialMagic Professional like any other Windows application. 1. Download the installer from

5 2. Save it in an easily accessible location on your computer, such as the Downloads folder (this may be done automatically by your browser). 3. Double-Click on the downloaded file to initiate the installation. 4. Click Agree.

6 5. Click Install. 6. Throughout the installation process, SerialMagic Professional will prompt for you to install various drivers. These are optional, but if you do not install the appropriate drivers for your device, you may run into problems later. 7. When the installation has complete, click Close.

7 Drivers You will be prompted to install drivers during the installation of SerialMagic. There are several different prompts for driver installation, each based on our lines of products. You can install only the drivers necessary for the devices you own, or you can install all the drivers by clicking Yes when prompted on each section. If you are using a USB-to-serial adapter to connect a cabled scanner (or other serial device), you will need to install the drivers from this page:

8 Registration Genuine Serialio.com barcode scanners, such as the Scanfob 2006 and KDC200 (plus many more), utilize automatic licensing with SerialMagic. This means that you do not need to purchase the software or enter a registration key when using SerialMagic. See this guide for instructions on generating a license key: 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. Click here to purchase a license for SerialMagic Professional. Adding New Connections Bluetooth Passkey If you are prompted for a Bluetooth passkey and your device was purchased from Serialio, the code is either 0000 or 1234.

9 Connection Types Remote Bluetooth device will Connect to SerialMagic using BlueSnap SerialMagic will connect to the remote Bluetooth device using BlueSnap SerialMagic will connect to the remote Bluetooth device using Windows Bluetooth Cabled connection WiSnap Wi-Fi connection

10 BlueSnap USB Setup Prerequisites The BlueSnap USB is plugged into your PC Appropriate drivers are installed SerialMagic Professional is installed SerialMagic Connects to device 1. Launch SerialMagic Professional 2. From the main window of SerialMagic Professional, click the Add button below the Connections list. 3. From the Select How Scanner Will Connect screen, select SerialMagic will connect to the remote Bluetooth device using BlueSnap USB. 4. Then, click on the image of your scanner and click Next. 5. Select the Bluetooth COM port assigned to your BlueSnap USB. 6. After SerialMagic connects to the BlueSnap USB, it will prompt you to activate the Bluetooth device Click OK. 7. You are now in the discovery phase. This can take up to 30 seconds. 8. When the BlueSnap USB finds your Bluetooth scanner, select it and click Next. 9. SerialMagic will display Input device was setup successfully. 10. The Add New Connection window should display the proper settings with your scanner. Click OK. 11. Click Start to initiate the connection. Device Connects to SerialMagic 1. Launch SerialMagic Professional 2. From the main window of SerialMagic Professional, click the Add button below the Connections list. 3. From the Select How Scanner Will Connect screen, select The remote Bluetooth device will connect to SerialMagic using BlueSnap USB. 4. Then, click on the image of your scanner and click Next. 5. Select the input device location and click Next. 6. Setup the device usage method and select Next.

11 7. After successfully configuring the BlueSnap device, a web link entitled Print Bluetooth connection barcodes becomes available in the setup wizard Open the web link. 8. After opening the link, print the custom connection barcode Do not lose this barcode. This barcode is generated specifically for use with your personal BlueSnap device. It will not work with any other BlueSnap devices. 9. After printing the barcode, go back to the setup wizard and click Finish. 10. On the main activity screen, click Start. 11. With your scanner, scan the SerialMagic SPP control code and make your device discoverable 12. Then, scan the custom connection barcode you printed in step 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. 14. To disconnect the device, scan the Disconnect and Radio Off barcode from your Quick Star Guide. 15. If your device is in batch mode, the device will need to be disconnected before batching can start. Windows Bluetooth Setup Pair via Windows Bluetooth 1. To begin, power on your device s Bluetooth radio This can be done through the Windows operating system or by toggling a physical switch, depending on your device. 2. Click on the Bluetooth icon in the system tray and select Add a Device Alternatively, navigate to the system settings (Control Panel) and then Bluetooth Settings. 3. Windows will automatically begin looking for nearby Bluetooth devices Click on your device and select Pair when it appears in the discovered device list. 4. Right-click the Bluetooth icon in the system tray, select Open Settings, and click on the COM Ports Tab Find the Outgoing COM port for your device and make note of it.

12 Pair via SerialMagic Professional 1. After pairing via Windows Bluetooth, launch SerialMagic Professional 2. From the main window of SerialMagic Professional, click the Add button below the Connections list. 3. From the Select How Scanner Will Connect screen, select SerialMagic will connect to the remote Bluetooth device using Windows Bluetooth. 4. Then, click on the image of your scanner and click Next. 5. Select the Bluetooth COM port assigned to your scanner This is the Outgoing COM port from the steps above. 6. SerialMagic will display Input device was setup successfully. 7. The Add New Connection window should display the proper settings with your scanner. Click OK SerialMagic will return to the main screen. 8. Click Start to initiate the connection. Cabled Connection Setup 1. Launch SerialMagic Professional 2. From the main window of SerialMagic Professional, click the Add button below the Connections list. 3. From the Select How Scanner Will Connect screen, select Cabled Connection. 4. Then, click on the image of your scanner and click Next. 5. Select the Bluetooth COM port assigned to your scanner Click Next. 6. SerialMagic will display Input device was setup successfully. 7. The Add New Connection window should display the proper settings with your scanner Click OK. 8. Click Start to initiate the connection. WiSnap Setup 1. From the Select How Scanner Will Connect screen, select WiSnap Wi-Fi Connection. 2. Select your scanner type (for a generic WiSnap connection, select other ), then click Next.

13 3. When your device appears on the list of nearby devices, select it and click Next If it does not appear, make sure that you have configured the WiSnap properly. 4. Select the device usage In this case, we will select Mobile Grid (recommended) After making your selection, select Next. 5. Confirm the configuration settings and click OK. 6. Initiate the connection with the WiSnap device by clicking Start If Mobile Grid does not start automatically, click on the icon to open it (located just below the Start/Stop button). 7. SerialMagic should now be ready to insert data from the WiSnap device into Mobile Grid Manual Setup Options Port This drop-down 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, plug it back in, and 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 There is a listing of all compatible scanners in the drop-down list.

14 Connection Type There is a listing of all compatible connection types in the drop-down list. Configure Port Settings This option becomes active only after choosing Raw as the Connection Type. Only use this option when your device is not listed. Definitions Main Dialog Window Connection Here you can add, remove, and edit connection settings for various devices. The drop-down menu contains the name and description for the devices that have been defined by the Add feature. Start/Stop Select Start to initialize connection between your computer and other device. SerialMagic will then be ready to receive data. When you click Start, it will change to Stop. Click Stop to cancel the connection between your computer and other device.

15 Quit Use this option to exit SerialMagic. Mobile Grid The Mobile Grid button will open Mobile Grid view. See the Mobile Grid section for more information. 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 the 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. Use this feature to update date/time information. 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 can be enabled/disabled in Application Settings. Action Profiles Manager The Action Profiles Manager contains all the SerialMagic Action Profiles. See the SerialMagic Action Profiles (SMAPs) section for more information. Cloud-In-Hand Settings (Cloud Account) Cloud-In-Hand.com is the feature of SerialMagic that can send a.csv file containing scans to a specified address, FTP server, or SQL database. This feature is only available if you have a Cloud-In-Hand account. See the Cloud-In-Hand Settings section at the end of this document for more information. 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.

16 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. Tools 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 is too cumbersome. To use this feature: You must have a BlueSnap USB The target BlueSnap module must be in slave mode You must add a connection for the BlueSnap module using the BlueSnap USB Once the connection is added, do not click Start. Instead, choose Setup Remote BlueSnap from the Tools menu.

17 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 supported scanner s settings to be configured by SerialMagic, such as buzzer settings, constant read mode and Bluetooth discovery time. Virtual Scanner Settings The Virtual Scanner feature allows you to test SerialMagic s functionality without needing to have scanner hardware. You can configure up to three manual scans that will simulate the receipt of a scanned barcode when the defined Hot-Key combination is pressed on your keyboard. To configure the use of Virtual Scanner, you must select the Device Type of Virtual Scanner. Start SerialMagic normally. Every time you press the defined Hot-Key, SerialMagic will send the simulated data to your defined output (CSV file, Action Profile, Mobile Grid ) Send File Contents This option allows you to send the contents of the selected file on the open port. This option is limited to use with sending something like a routing file to another widget (such as a CNC machine) via SerialMagic. Clear Scanner Memory Use this option to manually clear scanner memory from a supported batch scanner. Alternatively, you can configure SerialMagic to clear the scanner s memory automatically after a batch download by navigating to Application Settings Downloads Auto-Clear Scans. Download Scans Se this option to manually send saved scans from a batch mode compatible scanner, such as a Scanfob 2006 a KeyBatch BR2, or KDC. SerialMagic must be configured to work in batch mode for this option to function properly. Write TAGs This option will allow you to write the EPC value on a UHF tag

18 Application Settings Global Start SerialMagic when Windows is started SerialMagic will be registered to start every time Windows is started. Auto-reconnect SerialMagic will attempt to automatically reconnect to any Bluetooth device that was connected and lost that connection, through incidental or purposeful methods (dropped connection or user disabled Bluetooth). This negates the need to Stop and Start SerialMagic if connection to a device was lost. 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 This provides an option to setup SerialMagic when the Start button is clicked. When not selected, SerialMagic will start immediately. This delay can be handy when working with scanners such as the

19 KeyBatch BR2. When there are scans in the scanner memory, SerialMagic can begin to download scans immediately and this delay allows the user time 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 Enabling this feature will allow developers to communicate web applications with Serial, Bluetooth, or Wi-Fi devices. Please note that your host needs to be internet routed. Consult your network administrator for help properly routing port 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 the Downloads options such as Read scanner using batch mode and Write CSV files because Action Profiles are fully processed before the file is written. Action Settings Byte Mode This is an 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 (Carriage Return), which 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. o If your scanner type is Other, you will need to set these options manually, so check your product s documentation. 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.

20 Inter-character Posting Delay This specifies the delay between characters when posting to the keyboard buffer. It is useful for slow machines or slow applications. Delay time is in milliseconds, so 1000 = 1 second. ISBN Conversion When this is selected, SerialMagic will provide the 10 digit ISBN number to the program when an EAN-13 Bookland code is scanned. The scanner must be configured by scanning the following codes: Disable Supplemental Codes and Aim Identifiers Enable. These codes can be found at Serialio.com. Use Action Profile (SerialMagic Action Profiles SMAPs) This option enables or disables the use of SerialMagic Action Profiles, which are very powerful automations that can occur with each barcode scan or data packet input. Downloads Buffered Download When this option is enabled, 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. Hot Keys Choose specific Hot Keys to Send Next or Send All buffered scan(s). Default Hot Keys are Ctrl+F11 and Ctrl+F12.

21 Timestamp Format This allows you to change the way the date/time stamps are recorded in batch mode. 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 for further instructions on this process. 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 life after the scans have been received. Auto-clear Scans When enabled, SerialMagic will clear the scans from the scanner once they are downloaded. Alternatively, if this option is disabled, you can clear the scanner manually from the main window by navigating to Tools Clear Scanner Memory. Confirm Clear Scans This requires Auto-clear scans and will bring up a prompt asking 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 Scans to DB Choosing this option will download scans to your ODBC database. See the ODBC section for configuration. Test DB Clicking this button will take you to the ODBC tab to configure and test your ODBC configuration settings. See the ODBC section for more information. 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.

22 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 are 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. ODBC This option will allow you send saved scans to a MySQL ODBC database instead of writing to a CSV file or sending scans into an open application. You will have to have the correct permissions to write to the database, as well as have the drivers set as your User DSN and System DSN. Connection Manager The name of the database you will be writing to. If you have the correct drivers installed for your database, the dropdown menu should populate automatically.

23 Table Name The table in the above database that stored scans will be entered into. Scan Field The field that scans will be entered into. Timestamp Field The field that any timestamp/date-stamp information will be entered into. User Data Field The field that User data will be entered into. Device ID The field where your device identifier will be entered into. Test DB Test the configuration of the information entered above to make sure SerialMagic can write to these tables/fields correctly. Open ODBC Manager Will open the ODBC Data Source manager application. This section assumes some knowledge of MySQL and ODBC architecture. RFID

24 Read Tag User Data This check box enables the option to read user data from your RFID tags. You can also set the number of bytes to read from your RFID tags. Posting Format This option indicates the data format when using RFID. The options are: HEX, ASCII, DEC. Set Scanfob BB2 UHF/HF to send user data in ASCII (uncheck to send HEX) This check box is used to configure SerialMagic to interpret RFID tags as ASCII or HEX. ScanfobHF Mode Choose which mode data will be sent in. The options in the drop-down menu are 14444A (for tags like ICODE2) and (for tags like MIFARE). The Scanfob NFC-HF BB2 supports read and write for ISO tags but only supports CSN read for ISO 14444A tags. TAG Type (GEN2) Select which TAG type your RFID tags use. The options in the drop-down menu are $:EPC and EPC. Filtering Ignore Duplicates When selected, barcodes scanned multiple times will be ignored. Only the first instance of that barcode being scanned is recorded. See as New Row after (sec): Allows duplicate scans to be processed, but only if they are scanned the defined number of seconds apart. Log Logging is used to troubleshoot causes of errors in SerialMagic. Technical Support may ask you to enable logging. Enabled This check box turns on/off logging. 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 This will allow you to set the name and location of the log file.

25 Clear Log This option will delete the existing log file. This is useful if there is potentially unimportant data stored in the log and the issue you are seeing can be recreated reliably. Simply clear the log, reproduce the issue, then use the Send Log option to send Serialio a log file. Send Log This option will send the log file to Serialio. Call Technical Support for assistance sending logs, as you will need a password to send the log in, as well as make a technician aware that a log is being sent. Audio Audio on connect This audio file will be played whenever SerialMagic becomes connected to a device (you can leave at the default or use a custom audio file). Audio on disconnect This audio file will play whenever SerialMagic becomes disconnected from a device (you can leave at the default or use a custom audio file). Audio on delete This audio file will play to notify that scans have been deleted from the scanner. Audio on scan This audio file will play when you scan a barcode. SerialMagic must be configured in Packet Mode from the Action Settings tab for the audio file to play.

26 Send Command Hotkey This option 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 that incoming data. Measure Time This option allows you to set the amount of time, in milliseconds, between data posting. Default is 2000ms.

27 Settle Time When Settle Time is defined, the data changes that occur will only be reported after the input has not changed for this period of time. EnduraScan EnduraScan is a wireless technology allowing longer battery life of a 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 mobile device and the peripheral. Timed Auto-Stop (TAS) When checked, EnduraScan will disconnect the Bluetooth connection after the chosen time. Scanner BT off When checked, EnduraScan will turn the scanner s Bluetooth off when the Bluetooth connection is closed. The Left and Right arrows will allow you to scroll between tabs that are not shown on the screen. Action Profiles To customize SerialMagic to fit your workflow and utilize features only in SerialMagic Professional, you can use the SerialMagic Action Profiles. As long as the Application setting Use Action Profile is checked, you can click on the Action Profiles Manager in the main SerialMagic window. If you right-click anywhere in the Profiles dialog box, 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 Opens a prompt like 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.

28 Action Options Data-In Inserts the unmodified scanned data. Key Enters the chosen 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 the start and/or end of a 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 a marker for Start or End of desired data (you must have used the FIND SMA previously if you are using FIND value as your marker). Prompt-Num / Post-Num Display a prompt asking for a 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.

29 WEB Launches your default web browser to a specified URL prefix, followed by barcode data, with optional URL suffix. Example: 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 Use this action to Set Active another SMAP. POST-SCAN-TIMESTAMP Use this action to post the timestamp of the scan to the keyboard curser location. Only available with OPNseries scanners (Scanfob 2006, 4000 and 3002i, as well as KeyBatch BR2) or KDC-series scanners (KDC100, 200, 300, etc.). 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 (Part Number, Serial Number, etc.) then later you can use the POST-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, 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 in 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.

30 Pattern Options MATCH-BYTE Looks for a defined 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 the data packet and can optionally require the matching 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. 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. 1. Go to Action Profile Settings from the main screen. 2. Right-click and select Add Profile. 3. Give the profile a name and description, as shown in the following screen.

31 3.1. Name the profile something that will allow you to select this profile in the future without confusion Add a description to expand upon the name and provide more detailed information about what this SMAP does. 4. Click OK and save the new profile. 5. Highlight the profile and click on the Actions tab. 6. Right-click and choose Add Pattern. For this profile, you will choose greater than or equal to and enter 6 in the field. Click OK. 7. Select the Length Pattern and you will see an Actions tab appear at the top. 8. Switch to the Actions tab, then right-click and select Add Action. 9. Add a HOME keystroke by selecting Key from the first drop-down menu and HOME from the second drop-down menu These two keys will ensure that you are in the first column of a blank row in our spreadsheet.

32 10. 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. 11. To insert the scanned data, we will use the action: DATA-IN. 12. Right-click, and again, choose Add Action. 13. Select Data-In and click OK. 14. Now we want to move into the next column using the TAB key on your keyboard. 15. Add another Key Action with the selected key being TAB. 16. Click on the Pattern tab to see the main list of Actions again. 17. 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 date-stamp. This would use the Action Data-In, Key: Tab, and finally the desired date/time format. Save the SMA profile and when barcodes of 6 or more digits are scanned, they will be entered into the first column. Barcodes that are under 6 digits will be posted following a date stamp in the next two columns.

33 Cloud-In-Hand & Mobile Grid Cloud Upload Settings 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. This option enables uploading of batched scans directly to Cloud-In- Hand immediately after connecting. SerialMagic and the scanner must be put into batch mode for this feature to operate correctly. Open Uploaded Grid in Browser View grid in a web browser after uploading. Mobile Grid Settings Auto-Width Automatically adjusts column sizes to fit the data inside of the cells.

34 Show Grid when SerialMagic Starts Automatically shows the Mobile Grid when SerialMagic is started. Show Grid when SerialMagic is in Focus If SerialMagic becomes the active application, the Grid will be shown. Auto-Save Allows you to set a time interval 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 as active in SerialMagic Action Profiles. Edit Columns Add, remove, or change the column headers. Cloud-In-Hand Settings Change the username or password for your Cloud-In-Hand.com account. CSV File Store Path Sets the default directory location for storing CSV files. Troubleshooting Windows adds new COM ports for every new USB device Some software only works with smaller COM port numbers. This means that when a USB to RS-232 adapter is added as COM 44, the software may not function as expected because it has a maximum COM port value of 9. Solution: Remove unused COM ports in Windows Open a Command Prompt as administrator and start the Device Manager from that command prompt. 1. Right-click the Windows Start button at the bottom left corner of your screen.

35 1.1. Click on Command Prompt (Admin) 2. Enter the command: set devmgr show nonpresent devices=1 3. Enter the command: start devmgmt.msc 4. In the dialog that opens, select Show hidden devices in the view menu Expand the section on COM ports and all the COM ports that have ever been created will be displayed the non-present ones being in grey You can remove COM ports you no longer use by right-clicking on that device and choosing Uninstall.

36 Links Related Content SerialMagic Professional support page Software SerialMagic Professional download for Windows SerialMagic Professional for Mac Drivers Scanfob & KeyBatch BR2 drivers for Windows BlueSnap drivers for Windows USB to RS-232 adapter drivers KDC scanner drivers