SDK v0.1 · read-only

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 provisional value (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