intermediate
OKAI
ZK Tool
IoT

Using ZK Tool to Debug OKAI Fleet Scooter / Bike IoT

Reboot OKAI IoT modules and retrieve modem logs from ZK Tool for troubleshooting offline scooters and e-bikes.

Levy Fleets TeamJune 25, 20266 min read

Using ZK Tool to Debug OKAI Fleet Scooter / Bike IoT

Use this guide when an OKAI scooter or e-bike does not reconnect after server configuration, or when Levy support asks for modem logs.

Tools Needed

  • Windows PC.
  • ZK Tool / ZK Series Manage Tool.
  • OKAI IoT USB debugging cable.
  • Physical access to the IoT module.
  • Vehicle number, IMEI, and SIM ICCID.

Connect to the Device

  1. Make sure the vehicle is powered.
  2. Connect the IoT module to the Windows PC with the USB debugging cable.
  3. Open ZK Tool.
  4. Select the correct COM port.
  5. Enter the vehicle's per-device IoT/AT password from IoT Credentials on its vehicle page. This is the COMWizard connection password, not a separate desktop login.
  6. Click Try to Connect and continue only after COMWizard reports Check Password Success.
  7. Press Ctrl + L to open RawComView.

Do not guess the COMWizard password

If Check Password fails, verify that the vehicle number or IMEI matches the module on the bench and use that vehicle's exact IoT Credentials value. A generic fallback can belong to a different module and will be rejected.

Reboot the IoT Device

Send the reboot command from RawComView:

OKAI device-restart AT command — partner content

Sign in with your active Levy Fleets account to view.

After sending:

  1. Watch RawComView for reboot messages.
  2. Listen for the restart sound if audio is enabled.
  3. Wait 2 to 10 minutes for cellular reconnect.
  4. Check the vehicle in Levy Fleets.

Retrieve Modem Logs

If the device does not reconnect, collect modem logs.

  1. Stay connected in RawComView.
  2. Start UART modem logging with the ZK Tool AT+UARTLOG command path.
  3. Wait 5 to 10 minutes so the modem has time to attempt registration and server connection.
  4. Save the log text file from ZK Tool.
  5. Stop UART modem logging before disconnecting.
  6. Send the log file to Levy support with the vehicle number, IMEI, SIM ICCID, location, and test time.

Logs can contain operational identifiers

Treat modem logs as partner/internal support artifacts. Do not paste full modem logs into public tickets or public documentation.

Troubleshooting ZK Tool Connection

SymptomWhat to check
Password errorConfirm the device's per-vehicle IoT password in Levy Fleets.
Device wake-up failureConfirm the IoT cable is fully seated and the vehicle has power.
No COM port appearsInstall or reinstall the Prolific PL2303 USB serial driver.
ZK Tool crashesClose other serial tools, reconnect the cable, and reopen ZK Tool.
Connected to previous deviceRe-select the COM port through the COM wizard after switching devices.

After Debugging

Return the IoT to normal mode before putting the vehicle back into service. If the IoT remains in TEST mode, the vehicle may not behave correctly in a live rental deployment.

Running a fleet on this hardware?

Levy Fleets runs scooters, e-bikes, mopeds and golf carts on the IoT hardware you already have, with integration pages for 29 vendors including Segway, Okai, Omni, Queclink, Invers and Comodule. Keyless unlock, geofencing, rider payments and rider support are included, and the Managed plan is a share of revenue with no per-vehicle software fee.