Setting Up and Configuring Scanner

Built-in Camera

This method is the simplest but the least performant of all, so if you plan on scanning a lot of barcodes regularly, we recommend that you consider other methods described below.

To scan a barcode with your device’s camera, simply tap the Scan button in the mobile app. This button will appear on all screens where barcode scanning is applicable.

If a different scanning method is used, the Scan button becomes unnecessary and can be disabled in Admin → Settings → Select Scanner to avoid confusion.

Scanning barcodes with camera requires the Barcode Scanner app to be installed on the device, otherwise you will be prompted to install it after pressing the Scan button.

[Back to top]

Bluetooth Scanner

You can use a wireless Bluetooth barcode scanner with your mobile device for barcode scanning inside the HandiFox app.

The scanner must first be paired with the mobile device (per the scanner’s manual). Once the scanner is paired, open HandiFox app and go to Admin → Settings → Select Scanner. Tap Scan Bluetooth and wait for the search to complete, then select your scanner from the list.

You can also enter scanner’s Bluetooth address manually in case automatic discovery fails (this address can be viewed in the Bluetooth section of Android settings, in the properties of the paired scanner).

If the scanner will not pull items up but type the barcode in any field on the mobile application instead, it means the keyboard mode or output needs to be disabled

Only scanners capable of SPP mode will work with HandiFox as advertised. Check the System Requirements for recommended models.

[Back to top]

Devices with Built-in Scanner

HandiFox supports certain devices with built-in laser scanners. Visit this page to see all the devices supported. On Motorola devices, additional configuring is required to start using the scanner in HandiFox. Please contact us for details.

If the scanner will not pull items up but type the barcode in any field on the mobile application instead, it means the keyboard mode or output needs to be disabled

Creating a DataWedge Profile (for Zebra Devices)

Zebra devices require a DataWedge Profile to be set up to ensure the correct functioning and integration with HandiFox.

DataWedge Setup for HandiFox
Creating a New Profile
First, find the DataWedge app on your device and open it.
You will see a list with some pre-made DataWedge profiles. Each profile tells DataWedge to do something specific with the data coming from the scanner (product codes, etc).
You need to create another profile that you will point to HandiFox. To do that, press the Menu key and select New Profile.
The profile name doesn’t really matter, but let’s call it HandiFox for clarity. Now you should see another profile on the list, named HandiFox. Tap on it to go into its settings.
Under Applications, tap Associated apps.
On this screen, press the Menu key and select New app/activity.
You will see a list of all packages installed on your device. Find and select the package that has the HandiFox icon and is named com.tecomgroup.handifox.
In the next list, select the asterisk (*) at the top. You should end up with a record that looks like this: Press the Back button to return from the associations list back into the profile settings.
Keystroke Output
Keystroke output must be disabled for this profile. Find this section and uncheck the checkbox next to «Enabled».
Intent Output
Intent output must be enabled for this profile, so make sure the checkbox next to «Enabled» is checked.
Next, tap on Intent Action.
You will see a prompt to enter an intent action name. enter: com.motorolasolutions.emdk.handifox.recvr Make absolutely sure you’ve entered this name correctly and there are no spaces or line breaks in front, after or in the middle of this name. After entering this name, tap OK.
Tap on Intent Delivery and select «Broadcast intent». This is it for the DataWedge profile. Press the Back button to leave the profile settings.

[Back to top]

Scanner Settings in HandiFox

1. Open your HandiFox app and go to Admin → Settings → Select Scanner.
2. Uncheck «Use camera to scan barcodes». This will hide the Scan button inside HandiFox and avoid confusion, since you will instead use the built-in scanner and activate it via a hardware trigger or button.
   • Just in case, double-check that it says «DataWedge» in the text field under Scanner. This means HandiFox is detecting DataWedge on your device and will expect input from it.
3. When done, tap Save.
   

Troubleshooting

Click here to troubleshoot some known problems that may arise when testing if your scanner works in HandiFox.

[Back to top]

Testing Scanner

The best way to test if your scanner now works with HandiFox is in Inventory → Item List. On this screen, try to scan any barcode you can find around you. It doesn’t have to be one of your products.

If everything is set up and working correctly, the outcome must be one of the two:

• If the barcode you scanned is assigned to one of your products in HandiFox, the Item List will be instantly scrolled to that product, and the item will be highlighted.
• If this barcode is not assigned to any of your items, you will see a warning: «Cannot find scanned item with barcode XXXXXXX».

Either one of these results means scanning in your HandiFox app is working as intended.

[Back to top]