Zimo protocol

Protocol used by electric scooters manufactured by Lannmarker Zimo headquartered in China.
flespi parses the Zimo protocol messages into a JSON object with the fields listed below in the Parameters tab.

This is a Zimo MQTT Protocol used to communicate with your Zimo scooters fleet.

To connect your scooter using the Zimo protocol, you need to have an zimo channel created first.

Point your scooter to the channel's domain name:port via SMS or configuration tool provided by the vendor.

Then create a device instance for your tracker and use a 15-character IMEI (usually specified on the tracker casing) in the ident field.

Use the Toolbox tab on the device screen to check if the messages are coming.

battery.charging.cycles
number
Number of charges/discharges of the battery
battery.charging.status
boolean
Battery charging status
battery.full
boolean
Battery fully charged
battery.id.serial
string
Battery serial number
battery.level
number
percentage
Internal battery level
battery.state
string
Battery state
bluetooth.mac.address
string
Bluetooth MAC address
buzzer.alarm.status
boolean
Scooter buzzer status on/off
channel.id
number
ID of channel that received a message
charger.insert.event
boolean
Charger is inserted alarm event
device.hardware.state.flag
number
Device hardware state flag
device.id
number
ID of device that received a message
device.name
string
Name of device that received a message
device.type.id
number
ID of device type of device that received a message
driver.id
string
Driver identification card id
ecu.hardware.version.enum
number
Electronic control unit hardware version
ecu.software.version.enum
number
Electronic control unit software version
event.enum
number
Protocol-specific event code
event.seqnum
number
Unique event sequence number
fall.alarm
boolean
Fall alarm event
gsm.mcc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) country code
gsm.mnc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) code
gsm.network.roaming.status
boolean
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) in roaming mode
gsm.signal.level
number
percentage
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal strength level
gsm.sim.iccid
string
Integrated Circuit Card Id of SIM card of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)
hardware.version.enum
number
Hardware version enum
ident
string
Device unique identifier like serial number, IMEI, etc
kickstand.status
boolean
Kickstand status: true - not released, false - released
light.status
boolean
Light status
motion.alarm
boolean
Motion alarm
peer
string
IP:port from which device connecting to the channel
position.fix.type
number
GNSS fix type enum (0 = "not fixed", 1 = "2D", 2 = "3D", null = "unknown")
position.hdop
number
Horizontal dilution of precision
position.latitude
number
degrees
Latitude coordinate value
position.longitude
number
degrees
Longitude coordinate value
position.pdop
number
Position dilution of precision
position.satellites
number
Quantity of satellites used to calculate coordinates for given position information
position.speed
number
km/h
Instant speed at position detection moment
position.speed.limit
number
Speed limit
position.timestamp
number
seconds
Timestamp when coordinates where calculated
position.valid
boolean
Is position information accurate and valid for given timestamp
position.vdop
number
Vertical dilution of precision
power.on.status
boolean
Power-on device status
product.id
string
Product ID
protocol.id
number
ID of protocol
report.reason
number
Transmission reason code
riding.kickstand.alarm
boolean
Scoooter kickstand status 1= lifted, 0 = unlifted
scooter.battery.level
number
percentage
Scooter battery level
scooter.protection.unauthorized.movement
boolean
Scooter unauthorized movement check
server.timestamp
number
seconds
Timestamp when server received a message
software.version.enum
number
Software version enum
timestamp
number
seconds
Message timestamp
total.idle.seconds
number
seconds
Total time that vehicle was in idling state
total.trip.mileage
number
Total trip mileage
trip.duration
number
seconds
Trip duration
trip.mileage
number
km
Distance driven since engine start
trip.status
boolean
Trip status, true if trip started, false - if stopped
update.type
number
Update type
wheel.speed
number
km/h
RPM from motor hall sensor, wheel circumference
Properties
Custom command
custom
Send custom text command to device
command: Command
argument: Argument