Home

This is Reverse Engineered (copied) from QRing. I can only test on my Colmi R03, but this API has specificiations likely meant for all Colmi smart devices.

For any changes, feel free to submit a PR at the Github repository for this website.

All requests in this documentation are named accordingly: In Bluetooth terms, Requests are sent by the Master and Responses are sent by the Slave.

Getting Started

  • Use a computer with BLE support (usually build into the WiFi card) or purchase a USB adapter (example).
  • Download a BLE library like SimpleBLE (This one supports C/C++/Python/Rust/Android)
  • (Optionally) Capture some live data using Android's Blueooth Snoop feature
  • Using your BLE library of choice:
    • Scan for your Colmi device
    • Connect
    • Subscribe to the Notify characteristic(s) listed in Commands/Big Data
    • Start sending commands via the Write characteristic(s)