Safety
v0.1 only reads. It does not write the ECU, read the full ROM, or clear fault codes.
v0.1 is read-only (level 1). The SDK sends only these frames: the wake pulse, StartComm, liveness, StartDiag, the ECM-ID read, live table reads, and the three fault-code reads. It has no function that writes, erases or changes anything in the ECU, and it does not read the full ROM. Clearing fault codes is not included, because it also resets learned values.
The SDK can only send the read frames listed in the spec: an allowlist is
enforced at the single write point, and any other frame is refused
(FRAME_NOT_ALLOWED) before it reaches the cable. On connect it sends a
standard "tester present" keep-alive frame (7E 06 01 01 00 7A, a liveness
probe in spec/kline.json), which does not change ECU memory. Writing, erasing
and clearing fault codes are not possible through this SDK.
- A value that is not there is absent, never 0. Show "—".
- A
provisionalvalue (for example some battery readings) must not drive a decision on its own. Ask the rider to confirm it. - Fault codes are beta. Only Keihin boxes are decoded. Show them as a hint and keep the "unreadable" result honest.
- Live tables answer only after StartDiag. A box that is silent after wake is "no answer", not "broken".
The only network call is the optional model lookup (smongrotApi), which
sends just the ECM-ID. Live data and fault codes never touch the network.
Levels 2–3 (coming later) add full read and ECU write. They run only through the smongrot SMR board, with a server-signed ticket for each write and every safety gate on the board. They are not part of this SDK.
Next: Quickstart: JavaScript