Bluetooth Scanner Setup

Bluetooth scanners let you scan barcodes quickly without typing. This guide shows you how to pair, connect, and use a Bluetooth scanner with Shipedge Warehouse Pro.

Before You Start

Make sure your Bluetooth scanner is charged and in pairing mode. You’ll need to pair it with your Android device first before connecting it in the app.

Why Use a Bluetooth Scanner?

Faster Scanning

Scan barcodes instantly without manual entry. Much faster than typing codes.

Fewer Errors

Eliminates typing mistakes. Scanned codes are always accurate.

Better Productivity

Complete warehouse operations faster with quick barcode scanning.

Hands-Free Operation

Keep your device in a holder while scanning. More comfortable for long shifts.

Prerequisites

Before connecting a Bluetooth scanner:

Device Requirements:

• Android device with Bluetooth capability
• Bluetooth enabled on your device
• Scanner already paired with your device (via Android Bluetooth settings)

Scanner Requirements:

• Bluetooth-enabled barcode scanner
• Scanner charged and powered on
• Scanner in pairing mode (if not already paired)

App Requirements:

• Shipedge Warehouse Pro installed
• Bluetooth permission granted to the app
• Signed in to the app

Pairing Your Scanner (Android Settings)

Before connecting in the app, pair your scanner with your Android device:

1. Enable Bluetooth

   On your Android device:

   • Go to Settings > Bluetooth
   • Turn Bluetooth ON if it’s off

2. Put Scanner in Pairing Mode

   Follow your scanner’s instructions to enter pairing mode:

   • Usually involves holding a button for several seconds
   • Scanner LED may blink to indicate pairing mode
   • Check scanner manual for specific steps

3. Pair the Scanner

   In Android Bluetooth settings:

   • Tap Pair new device or Scan for devices
   • Wait for your scanner to appear in the list
   • Tap your scanner’s name when it appears
   • Enter pairing code if prompted (usually “0000” or “1234”)
   • Wait for “Paired” status

4. Verify Pairing

   Confirm the scanner shows as “Paired” in Bluetooth settings before proceeding.

Pairing First

The app only connects to scanners that are already paired with your device. You must complete pairing in Android settings before connecting in the app.

Connecting Scanner in the App

You can connect your Bluetooth scanner from two locations:

Method 1: From Login Screen

1. Open Login Screen

   Launch Shipedge Warehouse Pro. The login screen appears.

2. Tap Bluetooth Status

   Tap the Bluetooth status icon or text on the login screen. This opens Bluetooth connection options.

3. Enable Bluetooth (if needed)

   If Bluetooth is off:

   • You’ll see a prompt to enable Bluetooth
   • Tap Allow or OK to enable
   • Bluetooth settings open automatically

4. Select Your Scanner

   After Bluetooth is enabled:

   • A dialog shows “List devices paired”
   • You’ll see all paired Bluetooth devices
   • Each device shows as: Device Name : MAC Address
   • Tap your scanner from the list

5. Wait for Connection

   The app connects to your scanner:

   • Connection dialog closes automatically
   • Status updates to show “Paired to [Scanner Name]”
   • Status text turns green
   • Bluetooth icon updates to show connected state

6. Verify Connection

   Check that:

   • Status shows scanner name
   • Status text is green
   • Bluetooth icon indicates connected

Method 2: From Main Menu

1. Access Main Menu

   Sign in and reach the main menu (AppMenu).

2. Open Menu Options

   Tap the three-dot menu icon (overflow menu) in the top-right corner.

3. Select Scanner

   Tap “Scanner” from the menu options.

4. Follow Connection Steps

   Follow steps 3-6 from Method 1 above to complete the connection.

Using Your Scanner

Once connected, your scanner works automatically:

How It Works:

• Scan any barcode with your scanner
• Data appears in the active input field automatically
• No need to tap fields or type manually
• Works in any screen where text input is available

Where Scanner Works:

• Login screen (for access codes)
• Product scanning fields
• Bin location fields
• Barcode input fields throughout the app
• Any text input that accepts barcode data

Scanner Behavior:

• Scanned data replaces field content
• Works like typing, but faster
• Automatically submits on Enter (if field supports it)
• Works with all warehouse operations

Scanner Status Indicators

The app shows Bluetooth connection status:

Connected Status:

• Text: “Paired to [Scanner Name]” (green text)
• Icon: Bluetooth icon shows connected state
• Location: Login screen or main menu

Disconnected Status:

• Text: Shows “OFF” or no connection message
• Icon: Bluetooth icon shows disconnected state
• Behavior: Manual input required

Connection Errors:

• If connection fails, status doesn’t update
• Try disconnecting and reconnecting
• Verify scanner is powered on and in range

Disconnecting Your Scanner

To disconnect your Bluetooth scanner:

From Main Menu:

1. Tap the three-dot menu icon
2. Select “Manual” from options
3. Scanner disconnects
4. Status changes to “OFF”
5. Use device keyboard for input

From Login Screen:

• Tap Bluetooth status icon
• Select a different device or disconnect
• Status updates accordingly

💡 Best Practices

Keep Scanner Charged

Charge your scanner regularly. Low battery can cause connection issues and slow scanning.

Stay in Range

Keep scanner within Bluetooth range (typically 10 meters/30 feet). Moving too far causes disconnection.

Pair Before Connecting

Always pair your scanner in Android settings first. The app only connects to already-paired devices.

One Scanner at a Time

Connect only one scanner at a time. Multiple connections can cause conflicts.

Test Connection

Test your scanner after connecting by scanning a barcode. Verify data appears in input fields.

Keep Scanner Clean

Clean scanner lens regularly. Dirty lenses can cause scanning failures or slow reads.

Troubleshooting Connection Issues

Scanner Doesn’t Appear in List

Problem: Scanner not shown in “List devices paired” dialog

Solutions:

• Verify scanner is paired in Android Bluetooth settings first
• Check scanner is powered on
• Ensure scanner is within Bluetooth range
• Try unpairing and re-pairing the scanner
• Restart Bluetooth on your device

Connection Fails

Problem: Tap scanner but connection doesn’t establish

Solutions:

• Verify scanner is powered on
• Check scanner battery level
• Ensure scanner is within range (10 meters/30 feet)
• Try disconnecting and reconnecting
• Restart Bluetooth on your device
• Unpair and re-pair the scanner

Scanner Disconnects Frequently

Problem: Scanner connects but disconnects often

Solutions:

• Check scanner battery level (low battery causes disconnects)
• Stay within Bluetooth range
• Avoid obstacles between device and scanner
• Check for interference from other Bluetooth devices
• Restart both device and scanner

Data Not Appearing

Problem: Scanner connects but scanned data doesn’t appear

Solutions:

• Verify scanner is actually connected (check status)
• Ensure you’re scanning into an active input field
• Tap the input field to focus it before scanning
• Check scanner is reading barcodes correctly (test with another app)
• Try disconnecting and reconnecting

”Se desconecto” Message

Problem: See “Se desconecto” (disconnected) message

Solutions:

• Scanner lost connection unexpectedly
• Reconnect using connection steps above
• Check scanner battery and range
• Verify scanner is still paired in Android settings

Bluetooth Permission Denied

Problem: App can’t access Bluetooth

Solutions:

• Go to Settings > Apps > Shipedge Warehouse pro > Permissions
• Enable Bluetooth permission
• On Android 6.0+, enable Location permission (required for Bluetooth scanning)
• Restart the app after granting permissions

Scanner Works in Other Apps But Not This One

Problem: Scanner connects but doesn’t work in Shipedge Warehouse Pro

Solutions:

• Verify connection status shows scanner name
• Check that MySocket.statusBt is “ON” (connection active)
• Ensure you’re scanning into an active input field
• Try disconnecting and reconnecting in the app
• Restart the app

Technical Details

Connection Process:

• Uses Android Bluetooth API
• Connects via RFCOMM socket
• UUID: 00001101-0000-1000-8000-00805F9B34FB (SPP - Serial Port Profile)
• Creates BluetoothSocket for communication

Data Reading:

• Datasource class handles data input
• InputReader thread reads from socket input stream
• Consumer thread processes scanned data
• Data validated before being used

Connection Classes:

• ConnectDevice.java - Establishes Bluetooth connection
• MySocket.java - Manages socket state (statusBt: “ON” or “OFF”)
• Datasource.java - Handles data reading and processing

Status Management:

• MySocket.statusBt - Global connection status
• Datasource.statusActivity - Activity status for scanner
• Connection persists across app screens
• Disconnects when app closes or scanner goes out of range

Permissions Required:

• BLUETOOTH - Basic Bluetooth access
• BLUETOOTH_ADMIN - Bluetooth administration
• BLUETOOTH_CONNECT - Connect to Bluetooth devices (Android 12+)
• ACCESS_FINE_LOCATION - Required for Bluetooth scanning (Android 6.0+)

Connection Locations:

• Login screen (ReplenishmentActivity) - verifyBT() method
• Main menu (AppMenu) - Menu option “Scanner”
• Both use same selectDevice() logic

---

Next: Explore warehouse operations like Replenishment or Picking with your scanner connected