Fitrider protocol

Integration level: params
Protocol used by electric scooters and bicycles manufactured by Fitrider headquartered in China.
flespi parses the Fitrider protocol messages into a JSON object with the fields listed below in the Parameters tab.

In order to connect your Fitrider scooter to flespi:

  1. Create an ACL Token. Fitrider scooters normally publish telemetry messages to the "bike" topic and subscribe to the "device-identificator" topic. You may use this JSON for ACL token creation:
    {"info": "fitrider device","ttl": 31536000,"access": {"acl": [{"uri": "mqtt","actions": ["publish","subscribe"],"topic": "#"}],"type": 2}}
  2. Use the following MQTT details to connect the Fitrider device to the flespi MQTT Broker:
    Host: mqtt.flespi.io
    Port: 1883
    Username: token ID
    Password: first 16 characters of the token key
  3. Create standard token for the fitrider channel. You may use this JSON for standard token creation:
    {"expire": 0,"ttl": 31536000,"info": "fitrider channel","access": {"type": 0}}
  4. Create new channel:
    Protocol: fitrider
    MQTT broker: flespi MQTT broker
    Token: standard token key

If you have trouble connecting your scooters and/or bicycles, contact us.

battery.level
number
percentage
Internal battery level
battery.voltage
number
volts
Internal battery voltage
channel.id
number
ID of channel that received a message
device.firmware.version
string
Firmware revision
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
error.type
number
Protocol-specific error identification number
event.enum
number
Protocol-specific event code
fall.alarm
boolean
Fall alarm event
hardware.version
string
Hardware version
ident
string
Device unique identifier like serial number, IMEI, etc
payload.text
string
Text Payload received from device
peer
string
IP:port from which device connecting to the channel
position.latitude
number
degrees
Latitude coordinate value
position.longitude
number
degrees
Longitude coordinate value
position.speed
number
km/h
Instant speed at position detection moment
position.timestamp
number
seconds
Timestamp when coordinates where calculated
power.on.status
boolean
Power-on device status
protocol.id
number
ID of protocol
server.timestamp
number
seconds
Timestamp when server received a message
timestamp
number
seconds
Message timestamp
total.trip.duration
number
seconds
Total trips duration
trip.duration
number
seconds
Trip duration
trip.mileage
number
km
Distance driven since engine start
vehicle.mileage
number
km
Total calculated mileage