Back to Resources
Technical GuideZIMO Vehicles

Using the BLE App to Configure ZIMO Scooters and Bikes

A comprehensive guide to connecting, configuring, and managing your ZIMO fleet vehicles using the BLE Debugger mobile application.

1. App Installation (Android)

The BLE Debugger app is required to configure ZIMO scooters and e-bikes via Bluetooth. This app allows you to connect directly to the vehicle's IOT module for configuration and diagnostics.

Download the App

The BLE Debugger app can be downloaded from the ZIMO distribution server. Contact your Levy Fleets representative for the current download link and password.

Required Permissions

After installation, grant the following permissions for the app to function properly:

Location Access

Required for Bluetooth scanning on Android

Storage Access

For saving log files and firmware updates

Bluetooth Connectivity

Essential for communicating with the IOT module

Background Running (Optional)

Helps maintain stable Bluetooth connection during configuration

2. Connecting via Bluetooth

Scanning for Devices

  1. Open the BLE Debugger app
  2. Pull down on the screen to scan for nearby devices
  3. Wait a few seconds for the scan to complete
  4. Look for devices named "Scootor" (note the spelling)
  5. The device will show its MAC address and signal strength (dBm)

Important Notes

  • • Ensure Bluetooth is enabled on your phone
  • • Stay within 10 meters of the vehicle
  • • ZIMO devices appear as "Scootor" with a darker background color
  • • Unknown devices appear as "UnKnow"

Setting the Secret Key

Each IOT module has a 16-character security key configured at the factory. You must enter this key to establish a secure connection.

  1. Tap "Connect" next to your device
  2. You'll enter the Debug Scooter page
  3. Tap "SET SECRET" in the top right
  4. Enter your 16-character BLE key
  5. Tap "Save"
  6. Return to the Devices page and tap "Connect" again

Successful Connection

After connecting successfully, you'll see device information in the Input window:

  • • IOT Version (e.g., V1.40)
  • • ECU Version (e.g., V1.07)
  • • Product ID
  • • IMEI number
  • • ICCID (SIM card identifier)

3. Server Configuration

After inserting a SIM card, you need to configure the IOT module to connect to your fleet management server. Access this by tapping the menu (three dots) and selecting "Set IP".

Configuration Parameters

ParameterDescriptionExample
NameMQTT topic nameKW
IP AddressServer IP or domain name (max 24 bytes)47.254.79.66
PortMQTT server port1883
APNAccess Point Name from your SIM providerJTM2M
MQTT UserServer authentication username (max 32 bytes)admin
MQTT PasswordServer authentication password (max 24 bytes)public
Net UserSIM network username (usually blank)
Net PasswordSIM network password (usually blank)

After Configuration

  1. 1. Tap "Setting" to send the configuration to the IOT module
  2. 2. Send a "Reboot" command for changes to take effect
  3. 3. Use "Read" to verify the settings were saved correctly

4. Commands Reference

The Commands panel provides direct control over vehicle functions. Tap the "Commands" button to access all available controls.

Power Controls

Power-ON

Powers on the scooter. Buzzer will beep (or voice plays), headlight and taillight turn on.

Power-OFF

Powers off the scooter. Buzzer beeps, lights turn off.

Light Controls

Turn on the Light

Configure time duration and flash mode:

ModeBehavior
0Keep light on (solid)
1Flash slowly
2Flash fast (mode 1)
3Flash fast (mode 2)

Set Time to 0 to keep light on indefinitely.

Turn off the Light

Turns off the headlight immediately.

Alarm Controls

Alarm-ON

Activates the buzzer with configurable modes:

  • Mode 0: Continuous alarm
  • Mode 1-3: Various beep patterns

Only works on models with buzzers.

Alarm-OFF

Turns off the buzzer.

Motor Lock Controls

Lock-Motor

Activates EABS (Electronic Anti-lock Braking System) to lock the motor. Remains locked until unlock command is received.

Unlock-Motor

Removes EABS lock. Scooter returns to previous operational state.

Ride Mode Settings

Configure riding behavior through the Set Ride Mode panel:

Ride Modes
  • ECO: Energy-efficient mode
  • D: Standard driving mode
  • S: Sport/performance mode
Additional Options
  • Speed Limit: 8-30 km/h
  • Idle Light: ON/OFF when stationary
  • Dual Driver: Enable both motors
  • Rear Light Always On: Toggle
  • Kickstand Alarm: Toggle

Information Commands

Read Battery Info

Returns detailed battery status:

• Battery Status• Total Capacity (mAh)• State of Charge (%)• Voltage (V)• Current (A)• Temperature (C)• Remaining Capacity• Cycle Count

Read Scooter Info

Returns vehicle telemetry:

• Trip Time• Trip Distance• Current Speed• ECU Temperature• Motor Temperature• Total Distance• IOT Battery (%)• Vehicle Battery (%)

Version

Returns IOT Version, ECU Version, and Product ID.

System Commands

Sleep Mode

Open/Close sleep mode. In sleep, only Bluetooth remains active to conserve power. Wake by closing sleep mode or charging.

Battery Lock

Lock/Unlock the battery compartment cover. Only works on models with battery cover locks.

Reboot

Restarts the IOT device. Required after configuration changes.

Factory Reset

Restores all parameters to factory defaults. Requires reboot to take effect.

Log-ON / Log-OFF

Enable/disable diagnostic log output. Always send LOG-OFF when not actively debugging.

5. Firmware Updates

Important: Before Updating

The scooter must be powered OFF before performing firmware updates. Only the IOT module should be active (connected via Bluetooth).

Update Process

  1. Set Target Version

    Click "Upgrade IOT" or "Upgrade ECU" button. Enter the version number (digits after decimal point only).

    Example: To update from V6.39 to V6.40, enter "40"

  2. Download Firmware

    Click "Confirm" to download the firmware from the server.

  3. Confirm Update

    A dialog will show current and target versions. Click "CONFIRM" to proceed.

  4. Wait for Completion

    The update takes approximately 60 seconds. The IOT will automatically reboot.

  5. Reconnect

    After reboot, manually reconnect via Bluetooth to verify the update.

ECU Updates

The process for updating ECU firmware is identical to IOT updates. Use the "Upgrade ECU" button instead.

6. Diagnostics & Log Files

Log files are essential for troubleshooting connectivity issues, diagnosing hardware problems, and providing information to technical support.

Capturing Logs

  1. Tap "Commands" and select "Log-ON"
  2. Wait 1-2 minutes to capture diagnostic data
  3. Tap the menu (three dots) and select "Save log"
  4. Optionally tap "Upload Log" to send to support
  5. Send "Log-OFF" when finished

Log File Location

Log files are saved at:

/Android/data/net.com.share.scooter.ble/files/log

RGB LED Status Indicators

(Available on certain models only)

StateLED ColorMeaning
Power ON (Solid)GreenBattery ≥ 50%
YellowBattery ≥ 20%
RedBattery < 20%
BlueSleep Mode
Power OFF (Flashing)BlueNot connected to server
GreenConnected to server
RedHardware fault
YellowFirmware updating

Need Help?

If you encounter issues configuring your ZIMO vehicles or need assistance with fleet setup, our technical support team is here to help.