OMNI OC33

OC33 GPS Bike Lock is an IoT-enabled smart lock with a built-in cable, designed for shared and rental e-bike schemes. Features include real-time GPS/GLONASS/Beidou/Wi-Fi positioning, 2G/4G/BLE/RFID communication, QR code auto unlocking, IPX7 waterproof rating, 6400/8000mAh battery, voice alarming, sensor detection, and OTA upgrades.

Make your OMNI OC33 devices a part of any infrastructure by connecting them via flespi telematics hub. Manage the device settings using flespi device management platform. Learn how to configure OMNI OC33 with flespi.

Protocol: omni Manufacturer: Omni Change log: omni

Usage specifics

Parameters (62)

Settings (7)

Commands (1)

AI Assistant

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 OC33",
    "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'

Explore REST API Show more ways to consume data How to connect my OMNI OC33 to flespi

How to send commands to OMNI OC33?

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

Name

Type

Unit

Description

Sources

battery.charging.status

boolean

Battery charging status

Instruction type H0,
Instruction type S6

battery.level

number

percentage

Internal battery level

Instruction type H0,
Instruction type Q0,
Instruction type S5,
Instruction type S6

battery.lock.status

boolean

Battery lock locked/unlocked status

Instruction type L6

battery.low.alarm

boolean

Battery low alarm event

Instruction type W0

battery.serial

string

Scooter battery serial number

Instruction type L6

battery.voltage

number

volts

Internal battery voltage

Instruction type H0,
Instruction type Q0,
Instruction type S5,
Instruction type S6

ble.beacons

array

Standard parameter names used: *id* - beacon identification string. Usually it is beacon's UUID or MAC-address *local_name* - Beacons's Local Name *rssi* - BLE signal level. Units = dBm *battery.voltage* - Beacon's battery voltage. Units = volts *battery.level* - Beacon's battery level. Units = percentage *temperature* - Beacon's temperature. Units = celsius

Instruction type B0

bms.serial.number

string

BMS (Battery Management System) serial number

Instruction type M1

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

Instruction type M1

device.type.id

number

ID of device type of device that received a message

disassemble.alarm.status

boolean

Illegal disassembling alarm event status

Instruction type W0

ecu.error.code

string

ECU error code

Instruction type E0,
Instruction type E1

error.type

number

Protocol-specific error identification number

Instruction type H0,
Instruction type S5,
Instruction type S6

error.type.description

string

Protocol-specific error error description string

Error type 1,
Error type 10,
Error type 11,
Error type 13,
Error type 3,
Error type 4,
Error type 6

event.enum

number

Protocol-specific event code

Instruction type S1,
Instruction type W0,
Instruction type W1

external.equipment.state

number

External equipment state

Instruction type L5

external.equipment.type

number

External equipment type

Instruction type L5

fall.alarm.status

boolean

Fall alarm status

Instruction type W0

gsm.cellid

number

Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID

Instruction type S6

gsm.lac

number

Mobile network (GSM, 3G, 4G, LTE, 5G, ...) location area code

Instruction type S6

gsm.mcc

number

Mobile network (GSM, 3G, 4G, LTE, 5G, ...) country code

Instruction type Q0,
Instruction type S6

gsm.mnc

number

Mobile network (GSM, 3G, 4G, LTE, 5G, ...) code

Instruction type Q0,
Instruction type S6

gsm.operator.code

string

Mobile network (GSM, 3G, 4G, LTE, 5G, ...) operator code, which is MCC joined with MNC

Instruction type Q0

gsm.signal.level

number

percentage

Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal strength level

Instruction type H0,
Instruction type Q0,
Instruction type S5,
Instruction type S6

ident

string

Device unique identifier like serial number, IMEI, etc

illegal.movement.alarm

boolean

Illegal movement alarm event

Instruction type W0

indication.mode

string

Position indication mode A - autonomous, D - differential, E - estimate, N - invalid data

Instruction type D0,
Instruction type D1

lock.status

boolean

Lock status

Instruction type H0,
Instruction type L0,
Instruction type L1,
Instruction type S5,
Instruction type S6

message.type

string

Message type

movement.event

boolean

Movement detected

Instruction type W0

payload.text

string

Text Payload received from device

Instruction type K0,
Instruction type U0,
Instruction type U1,
Instruction type U2,
Instruction type U3,
Instruction type Z0

peer

string

IP:port from which device connecting to the channel

position.altitude

number

meters

Altitude value for position

Instruction type D0,
Instruction type D1

position.hdop

number

Horizontal dilution of precision

Instruction type D0,
Instruction type D1

position.latitude

number

degrees

Latitude coordinate value

Instruction type D0,
Instruction type D1

position.longitude

number

degrees

Longitude coordinate value

Instruction type D0,
Instruction type D1

position.satellites

number

Quantity of satellites used to calculate coordinates for given position information

Instruction type D0,
Instruction type D1,
Instruction type S5

position.speed

number

km/h

Instant speed at position detection moment

Instruction type S6

position.valid

boolean

Is position information accurate and valid for given timestamp

Instruction type D0,
Instruction type D1

protocol.id

number

ID of protocol

reboot.event

boolean

Device reboot event

Instruction type Q38

remaining.range

number

Current remaining range

Instruction type S6

report.reason

number

Transmission reason code

Instruction type C0

rfid.card.type

string

RFID card type

Instruction type C0

rfid.code

string

Hexadecimal code of connected RFID

Instruction type C0

server.timestamp

number

seconds

Timestamp when server received a message

software.version

string

Software version string

Instruction type Q0,
Instruction type U0

speed.mode

number

Current mode of scooter 1:low speed 2:medium speed 3:high speed

Instruction type S6

timestamp

number

seconds

Message timestamp

Instruction type B0,
Instruction type D0,
Instruction type D1,
Instruction type L0,
Instruction type L1,
Instruction type Q38

total.mileage

number

Total mileage

Instruction type S6

trip.duration

number

seconds

Trip duration

Instruction type L1

trip.mileage

number

Distance driven since engine start

Instruction type S6

unlock.timestamp

number

seconds

Bike unlock instruction received timestamp

Instruction type L1

upgrade.status.name

string

Upgrade status

Instruction type U6

upgrade.type

string

Upgrade type

Instruction type U6

vehicle.state

string

Vehicle state, such as moving, idling, parked etc

Instruction type S6

vendor.code

string

Vendor identification string code

wifi.mac.address

string

WiFi MAC address

Instruction type D2

wifi.signal.strength

number

WiFi signal strength, RSSI

Instruction type D2

Title

Name

Description

Properties

Manage administrator card number

id: Card number

D1 Positioning tracking commands

d1_ogb1

upload_interval: Upload positioning interval

K0 BLE communication key

k0_ogb1

value: BLE Key

L0 Unlock instruction

user_id: User ID

reset_riding_time: Reset riding time

S1 Restart

s1_ogb1

S5 Access to Lock Information

s5_ogb1

S8 bike search instructions

ring_times: Ring times

Title

Name

Description

Properties

Custom command Examples

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"}

OMNI OC33

Here’s the like of JSON you get

How to consume this nice JSON

How to send commands to OMNI OC33?

You can also

Modify messages

Aggregate data

More devices from Omni (6)