OMNI YXZ-855P

OMNI YXZ-855P is an aluminum electric scooter for sharing. The scooter features a triple brake system (e-brake + disc brake + foot brake), 18650 mAh Li-ion battery, 8.5 inch solid tires, patented front & rear suspensions, max speed of 25 km/h (15.5 mph), 40-60 km on one charge.

Usage specifics
Parameters (53)
Settings (10)
Commands (1)
OMNI YXZ-855P
Flespi parses telemetry data from your OMNI YXZ-855P into a standardized JSON and lets you send commands to OMNI YXZ-855P via API.

Here’s the like of JSON you get

{
    "ident": "352625333222111",
    "position.altitude": 273.61,
    "position.hdop": 0.7,
    "position.latitude": 49.069782,
    "position.longitude": 28.632826,
    "position.satellites": 18,
    "server.timestamp": 1650636570.426424,
    "timestamp": 1650636570.426424,
    "device.type.id": "OMNI YXZ-855P",
    "channel.id": 1111,
    "protocol.id": "omni"
    "engine.ignition.status": true
    ...
}

How to consume this nice JSON

The easiest way is to make a REST API request like this
curl -X GET  --header 'Authorization: FlespiToken XXX' 'https://flespi.io/gw/devices/<device id>/messages'

How to send commands to OMNI YXZ-855P?

You can send a specific command. Show all commands
You can use pre-defined settings to send instructions more conveniently. Show all settings

You can also

Modify messages

Add or remove parameters, inject data from LBS and reverse-geocoding services, etc.
Learn what plugins can do

Aggregate data

Determine trips and stops, catch events, detect geofence ins/outs, and more.
Learn about flespi analytics capabilities
battery.charging.status
boolean
Battery charging status
battery.level
number
percentage
Internal battery level
battery.lock.status
boolean
Battery lock locked/unlocked status
battery.low.alarm
boolean
Battery low alarm event
battery.serial
string
Scooter battery serial number
battery.voltage
number
volts
Internal battery voltage
bms.serial.number
string
BMS (Battery Management System) serial number
channel.id
number
ID of channel that received a message
device.id
number
ID of device that received a message
device.name
string
Name of device that received a message
device.serial.number
string
Device serial number
device.type.id
number
ID of device type of device that received a message
disassemble.alarm.status
boolean
Illegal disassembling alarm event status
ecu.error.code
string
ECU error code
error.type
number
Protocol-specific error identification number
error.type.description
string
Protocol-specific error error description string
event.enum
number
Protocol-specific event code
external.equipment.state
number
External equipment state
external.equipment.type
number
External equipment type
fall.alarm.status
boolean
Fall alarm status
gsm.mcc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) country code
gsm.mnc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) code
gsm.operator.code
string
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) operator code, which is MCC joined with MNC
gsm.signal.level
number
percentage
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal strength level
ident
string
Device unique identifier like serial number, IMEI, etc
illegal.movement.alarm
boolean
Illegal movement alarm event
indication.mode
string
Position indication mode: A - autonomous, D - differential, E - estimate, N - invalid data
lock.status
boolean
Lock status
message.type
string
Message type
movement.event
boolean
Movement detected
payload.text
string
Text Payload received from device
peer
string
IP:port from which device connecting to the channel
position.altitude
number
meters
Altitude value for position
position.hdop
number
Horizontal dilution of precision
position.latitude
number
degrees
Latitude coordinate value
position.longitude
number
degrees
Longitude coordinate value
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.valid
boolean
Is position information accurate and valid for given timestamp
protocol.id
number
ID of protocol
reboot.event
boolean
Device reboot event
remaining.range
number
km
Current remaining range
report.reason
number
Transmission reason code
rfid.card.type
string
RFID card type
rfid.code
string
Hexadecimal code of connected RFID
server.timestamp
number
seconds
Timestamp when server received a message
software.version
string
Software version string
timestamp
number
seconds
Message timestamp
trip.duration
number
seconds
Trip duration
trip.mileage
number
km
Distance driven since engine start
unlock.timestamp
number
seconds
Bike unlock instruction received timestamp
vehicle.state
string
Vehicle state, such as moving, idling, parked etc
vendor.code
string
Vendor identification string code
Properties
D0 Get positioning instructions, single time
d0
D1 Positioning tracking commands
d1
upload_interval: Upload positioning interval
R0 Unlocking/Lock operation request command
r0
Send R0 command (timestamp appended automatically). After device response L0 or L1 command will be sent by server automatically.
lock: Lock/Unlock
user_id: User ID
key_time: Key effective time
S1 Event notification command
s1
event_code: Event code
S2 LED Control
s2
enable: Enable
S4 Scooter setting instruction 2
s4
Note: The following settings are saved after power down.
startup_mode: Startup mode setting
cruise_control: Cruise control setting
low_speed_limit: Low speed mode speed limit value
high_speed_limit: High speed mode speed limit value
inch_speed_display: Inch speed display
medium_speed_limit: Medium speed mode speed limit value
key_switch_headlight: Key switch headlight
button_switching_speed_mode: Button switching speed mode
S5 IoT device settings
s5
Note: The following settings are saved after power down.
acc_sens: Accelerometer sensitivity
upload_s6: Status for upload scooter info (S6)
heartbeat_interval: Heartbeat upload interval
s6_upload_interval: Scooter information (S6) upload interval
S6 Obtain scooter information
s6
Send S6 command: ask scooter for telemetry inforamtion.
S7 Scooter setting instruction 1
s7
Note: The following setting information is not saved after power-off, and the default value is restored after restarting or unlocking.
mode: Mode setting
headlight_switch: Headlight switch
throttle_response: Throttle response
taillights_flashing: Taillights flashing
V0 Beep playback commands
v0
play_content: Play content
Properties
Custom command
custom
Send custom command to device. Format for R0 and L0 commands : 0xFFFF*SCOS,OM,{ident},{instruction_type},{payload},# Format for other commands with payload: 0xFFFF*SCOS,OM,{ident},{instruction_type},{payload}# Format for commands with no payload: 0xFFFF*SCOS,OM,{ident},{instruction_type}# Note: The following settings are saved after power down.
payload: Comma separated list of parameters to send as payload
instruction_type: 2 letter instruction type
D0 - Get position instruction
{"instruction_type":"D0"}
I0 - Get the SIM card ICCID number
{"instruction_type":"I0"}
S6 - Obtain scooter information command
{"instruction_type":"S6"}
D1 Upload positioning interval 60 seconds
{"payload":"60","instruction_type":"D1"}
R0 Unlocking/Lock operation request command
{"payload":"0,20,1234","instruction_type":"R0"}
V0 Beep playback commands: 2: Find a scooter alert
{"payload":"2","instruction_type":"V0"}
L0 Unlocking command, e.g. 255 value received as key in R0 command
{"payload":"255,1234","instruction_type":"L0"}
S7 Scooter setting instruction 1 command: headlight switch ON, mode high speed, throttle ignore, taillights flashing shut down
{"payload":"1,3,0,1","instruction_type":"S7"}