Hardware Troubleshooting

Introduction

This guide helps you solve common hardware problems in Shipedge Warehouse Pro. If you’re having issues with Bluetooth scanners, internet connection, camera, or storage, follow the solutions below to get back to work quickly.

Most hardware problems have simple fixes. Start with the basic solutions first, then try more advanced steps if needed.

Bluetooth Scanner Problems

Scanner Won’t Connect

Problem: Your Bluetooth scanner doesn’t connect to your device.

Solutions:

1. Check Bluetooth is enabled

   Go to your device Settings → Bluetooth and make sure Bluetooth is turned on.

2. Check scanner is powered on

   Make sure your scanner has battery power and is turned on. Check the scanner’s LED indicator.

3. Pair the scanner

   In device Settings → Bluetooth, find your scanner in the list and tap it to pair. Wait for “Paired” status.

4. Restart the app

   Close Shipedge Warehouse Pro completely and reopen it. The app will try to connect to your scanner.

5. Check scanner distance

   Make sure the scanner is within 10 meters (30 feet) of your device. Move closer if needed.

Lost Connection to Scanner

Problem: You see a message saying “Lost connection to scanner” or the scanner stops working during use.

Solutions:

1. Wait for reconnect dialog

   The app shows a dialog asking “Reconnect Device [scanner name]?”. Tap Yes to reconnect automatically.

2. Manual reconnect

   If the dialog doesn’t appear:

   • Go to the login screen
   • Tap the Bluetooth status indicator
   • The app will try to reconnect

3. Check scanner battery

   Low battery can cause disconnections. Charge or replace the scanner’s battery.

4. Restart Bluetooth

   Turn Bluetooth off and on again in device Settings. Then restart the app.

5. Re-pair the scanner

   Unpair the scanner in device Settings → Bluetooth, then pair it again.

Scanner Reads But Data Doesn’t Appear

Problem: The scanner beeps and seems to work, but scanned data doesn’t show in the app.

Solutions:

• Make sure you’re in the correct screen where scanning is expected
• Check that the input field has focus (tap on it if needed)
• Try scanning again - sometimes the first scan after connection needs a retry
• Check scanner settings - make sure it’s set to send data via Bluetooth, not store-only mode
• Restart the app if the problem continues

Scanner Connection Keeps Dropping

Problem: The scanner connects but disconnects frequently.

Solutions:

• Check distance: Keep scanner within 3-5 meters (10-15 feet) of device
• Remove interference: Move away from WiFi routers, microwaves, or other Bluetooth devices
• Check battery: Low battery causes unstable connections
• Update firmware: Check if your scanner has firmware updates available
• Try different device: Test with another Android device to see if it’s device-specific

Internet Connection Problems

Cannot Connect to Database Server

Problem: You see “Cannot connect to database server” or network errors.

Solutions:

1. Check internet connection

   Open a web browser on your device and try to load a website. If it doesn’t load, you don’t have internet.

2. Check WiFi or mobile data

   • WiFi: Make sure WiFi is connected and has internet access
   • Mobile data: Check that mobile data is enabled and you have signal

3. Restart network connection

   Turn WiFi or mobile data off, wait 5 seconds, then turn it back on.

4. Check warehouse server

   Make sure your warehouse server is online. Contact your administrator if needed.

5. Restart the app

   Close and reopen Shipedge Warehouse Pro. The app will try to reconnect.

Network Error Window Appears

Problem: You see a network error window when trying to use features that need internet.

Solutions:

• Tap OK on the error window
• Check your internet connection (WiFi or mobile data)
• Make sure you’re not in airplane mode
• Try again after ensuring internet is working
• Contact IT support if the problem continues

Slow or Unstable Connection

Problem: The app works but is very slow or times out frequently.

Solutions:

• Move closer to WiFi router: Weak WiFi signal causes slow connections
• Check data usage: Mobile data might be throttled if you’ve used too much
• Close other apps: Other apps using internet can slow down Shipedge Warehouse Pro
• Restart device: Sometimes a device restart fixes connection issues
• Check server status: Warehouse server might be experiencing high load

Camera Problems

Camera Won’t Open

Problem: Nothing happens when you tap the camera button.

Solutions:

1. Check camera permission

   Go to Settings → Apps → Shipedge Warehouse Pro → Permissions. Make sure Camera permission is enabled.

2. Check if camera is in use

   Close other apps that might be using the camera (other camera apps, video calls, etc.).

3. Restart the app

   Close Shipedge Warehouse Pro completely and reopen it.

4. Restart device

   If the problem continues, restart your Android device.

5. Check device camera

   Try opening your device’s built-in camera app. If it doesn’t work, there’s a device problem, not an app problem.

Photos Not Saving

Problem: You take photos but they don’t appear or save.

Solutions:

• Check storage permission: Go to Settings → Apps → Shipedge Warehouse Pro → Permissions. Enable Storage permission.
• Check available space: Make sure your device has at least 100 MB free storage.
• Check external storage: Make sure external storage is available and mounted (not in USB mode).
• Restart app: Close and reopen the app, then try taking a photo again.

Camera Permission Denied

Problem: You see a message asking for camera permission repeatedly.

Solutions:

• Go to device Settings → Apps → Shipedge Warehouse Pro → Permissions
• Enable Camera permission
• Enable Storage permission (needed to save photos)
• Return to the app and try again
• If permissions are grayed out, you may need to reset app preferences (Settings → Apps → Reset App Preferences)

Storage Problems

Storage Full Error

Problem: You see errors about storage being full.

Solutions:

1. Check available storage

   Go to Settings → Storage to see how much space is available.

2. Free up space

   • Delete old photos from the /shipedge/ folder
   • Uninstall unused apps
   • Clear app cache: Settings → Apps → Shipedge Warehouse Pro → Storage → Clear Cache
   • Move photos to cloud storage or computer

3. Delete old app data (if safe)

   Settings → Apps → Shipedge Warehouse Pro → Storage → Clear Data (warning: this removes all app settings)

External Storage Not Available

Problem: You see errors about external storage not being available.

Solutions:

• Check USB mode: If device is connected to computer via USB, disconnect it or change USB mode to “File Transfer” instead of “Charging only”
• Check storage is mounted: Go to Settings → Storage and make sure external storage shows as mounted
• Restart device: Sometimes a restart fixes storage mounting issues
• Check SD card: If using SD card, make sure it’s properly inserted and formatted

Device Performance Issues

App Runs Slowly

Problem: The app is slow or freezes frequently.

Solutions:

• Close other apps: Swipe away other apps from recent apps to free up memory
• Restart device: A device restart clears memory and can fix performance issues
• Clear app cache: Settings → Apps → Shipedge Warehouse Pro → Storage → Clear Cache
• Check available storage: Low storage can slow down the device
• Update app: Make sure you’re using the latest version of Shipedge Warehouse Pro

App Crashes or Closes Unexpectedly

Problem: The app closes without warning.

Solutions:

• Restart the app: Close and reopen Shipedge Warehouse Pro
• Restart device: Restart your Android device
• Clear app cache: Settings → Apps → Shipedge Warehouse Pro → Storage → Clear Cache
• Update app: Install the latest version from Google Play Store
• Check device storage: Low storage can cause crashes
• Report the issue: Note what you were doing when it crashed and report to support

💡 Prevention Tips

Keep devices charged

Charge scanners and devices regularly. Low battery causes connection problems and unexpected shutdowns.

Maintain storage space

Keep at least 500 MB free on your device. Low storage causes performance issues and prevents saving data.

Update regularly

Keep the app and your Android device updated. Updates fix bugs and improve stability.

Check connections first

Verify internet and Bluetooth connections before starting work. This prevents interruptions during operations.

When to Contact Support

Contact your administrator or Shipedge support if:

• Problems continue after trying all solutions above
• Multiple devices have the same problem
• You see error messages you don’t recognize
• Hardware appears damaged (scanner, device, etc.)
• You need help with warehouse server configuration
• Problems prevent you from completing work

Information to provide when contacting support:

• Device model and Android version
• App version (check in app settings or About)
• What you were doing when the problem occurred
• Exact error messages (take screenshots if possible)
• Steps you’ve already tried
• How often the problem happens

Related Documentation

• Bluetooth Scanner Setup: Set up your scanner properly
• Camera Usage: Learn how to use the camera feature
• Device Setup: Initial device configuration
• Getting Help: Additional support resources