# smongrot SDK > อ่านอย่างเดียว (level 1) สำหรับวินิจฉัย ECU รถจักรยานยนต์ Honda ผ่านสาย K-Line: ตัวตนของ ECU, live data ของเครื่องยนต์, และรหัสข้อผิดพลาดที่เก็บไว้ (beta) มีสเปกที่เครื่องอ่านได้พร้อม golden test vector และมี SDK ภาษา JavaScript (npm `@smongrot/sdk`) กับ Dart (pub `smongrot_sdk`) สัญญาอนุญาต MIT รุ่น v0.1 แหล่งความจริงคือสเปก JSON จะถือว่า implementation ถูกต้องก็ต่อเมื่อผ่าน vector ทุกชุดใน `vectors/` ## กฎที่ implementation ต้องทำตาม - K-Line 10400 baud 8N1 ตัด TX echo ทุกครั้งที่อ่านกลับ (spec/kline.json `echo_strip`) - Checksum = (0x100 − (sum mod 256)) mod 256 และ mask ให้เหลือ 8 บิตเสมอ (ถ้าบอดี้รวมกันได้ 0x100 ค่า checksum คือ 0x00) ห้ามใช้ผลบวกธรรมดา - Wake = LOW 70 ms จับเวลาแบบ atomic บน adapter แล้ว idle 130 ms ลอง wake + StartComm + liveness ใหม่ได้สูงสุด 4 ครั้ง - ส่ง StartDiag `72 05 71 00 18` ก่อนอ่านตาราง live data ทุกครั้ง - ใช้ข้อมูล reply ได้เฉพาะ frame `02 L ` อันสุดท้ายที่ checksum ถูกต้อง reply ที่สั้นกว่า `data_len` ของตารางถือว่าไม่มีข้อมูล - ค่าที่หายไปหรือเป็น sentinel คือ "absent" ไม่ใช่ 0 ค่าที่อยู่นอกช่วงคือ "invalid" และห้ามใช้ค่าจากแหล่ง fallback มาแทน - เก็บที่มาของทุกค่าไว้ (bench / field / reference / provisional) อย่าซ่อน "provisional" - รหัสข้อผิดพลาดเป็น beta: ถอดรหัสเฉพาะกล่อง Keihin สิ่งที่ parse ไม่ได้คือ "unreadable" ห้ามเดา - Level 1 ไม่ส่ง frame ที่เขียน ที่ลบ หรือที่เปลี่ยนสถานะ (ไม่มีการล้าง DTC) ห้ามเรียกเครือข่ายจากตัวถอดรหัส - ชื่อรุ่นไม่บังคับ มาจาก `GET https://api.smongrot.com/v1/ecu/identify?ecm=<10 hex>` ด้วย API key ฟรี ถ้าค้นไม่สำเร็จ จะได้ model เป็น null และไม่ทำให้ identify, live data หรือรหัสข้อผิดพลาดพัง ## แพลตฟอร์ม (v0.1) - ใช้สายอย่างเดียว: Chrome / Edge บนเดสก์ท็อป (WebSerial), Node (`serialport`), Flutter เดสก์ท็อป (`smongrot_sdk_libserialport`), Android USB-OTG (`smongrot_sdk_usb_serial`) - ยังไม่มี: iOS (บน iOS ไม่มี USB serial) และบอร์ด SMR แบบ Bluetooth ทั้งคู่มาใน v0.2 ## สเปก - [spec/kline.json](https://developers.smongrot.com/spec/kline.json): สาย, wake, session, checksum, การตัด echo, จังหวะเวลา - [spec/live.json](https://developers.smongrot.com/spec/live.json): โปรไฟล์ live data, การดึงค่า, กติกาของค่า, การตรวจจับ - [spec/dtc.json](https://developers.smongrot.com/spec/dtc.json): อ่านและถอดรหัสรหัสข้อผิดพลาด (beta) - [spec/board-ble.json](https://developers.smongrot.com/spec/board-ble.json): BLE ของบอร์ด SMR เฉพาะคำสั่ง level 1 (การรองรับบอร์ดอยู่ใน v0.2) - JSON Schema: [common.schema.json](https://developers.smongrot.com/spec/schema/common.schema.json), [kline.schema.json](https://developers.smongrot.com/spec/schema/kline.schema.json), [live.schema.json](https://developers.smongrot.com/spec/schema/live.schema.json), [dtc.schema.json](https://developers.smongrot.com/spec/schema/dtc.schema.json), [board-ble.schema.json](https://developers.smongrot.com/spec/schema/board-ble.schema.json); ชุด vector ใช้ `vectors-.schema.json` ในโฟลเดอร์เดียวกัน ## Vectors - [vectors/checksum.json](https://developers.smongrot.com/vectors/checksum.json), [vectors/echo.json](https://developers.smongrot.com/vectors/echo.json), [vectors/session.json](https://developers.smongrot.com/vectors/session.json) - Live: [vectors/live/extract.json](https://developers.smongrot.com/vectors/live/extract.json), [vectors/live/detect.json](https://developers.smongrot.com/vectors/live/detect.json), [vectors/live/t17.sub8.json](https://developers.smongrot.com/vectors/live/t17.sub8.json), [vectors/live/t17.sub4.json](https://developers.smongrot.com/vectors/live/t17.sub4.json), [vectors/live/t13.type7.json](https://developers.smongrot.com/vectors/live/t13.type7.json), [vectors/live/t11.type1.json](https://developers.smongrot.com/vectors/live/t11.type1.json), [vectors/live/generic.t17.json](https://developers.smongrot.com/vectors/live/generic.t17.json) - [vectors/dtc.json](https://developers.smongrot.com/vectors/dtc.json) ## เอกสาร อ่านตามลำดับนี้: - [หน้าแรก](https://developers.smongrot.com/th/docs): v0.1 คืออะไร สามอย่างที่สร้างได้ ควิกสตาร์ต 60 วินาที แพลตฟอร์ม และสิ่งที่ไม่ทำ - [แนวคิด](https://developers.smongrot.com/th/docs/concepts): วงจร session, ECM-ID, โปรไฟล์ live, สถานะฟิลด์ (`ok` / `absent` / `invalid`), ผู้ผลิต, จังหวะเวลา - [ฮาร์ดแวร์](https://developers.smongrot.com/th/docs/hardware): สาย K-Line, สัญญาณบนขั้ว, FTDI VCP, 10400 8N1, Android OTG, ทำไม iOS ใช้สายไม่ได้ - [ความปลอดภัย](https://developers.smongrot.com/th/docs/safety): เฟรมแบบอ่านอย่างเดียว, absent ไม่ใช่ 0, ค่า provisional, รหัสข้อผิดพลาด beta - [เริ่มต้นใช้งาน: JavaScript](https://developers.smongrot.com/th/docs/quickstart-js): WebSerial บนเบราว์เซอร์ และ Node `serialport` - [เริ่มต้นใช้งาน: Dart](https://developers.smongrot.com/th/docs/quickstart-dart): Flutter เดสก์ท็อป (`smongrot_sdk_libserialport`) และ Android OTG (`smongrot_sdk_usb_serial`) - [ตัวอย่าง](https://developers.smongrot.com/th/docs/examples): ตัวบันทึก CSV บน Node, เกจบนเบราว์เซอร์, หน้าจอ live ของ Flutter, Android OTG, อ่าน DTC, API key - [ระบุตัวกล่องและ API key](https://developers.smongrot.com/th/docs/identify): ECM-ID แบบออฟไลน์, ชื่อรุ่นจาก `GET /v1/ecu/identify`, ข้อผิดพลาดที่ไม่ทำให้ identify พัง - [อ้างอิง API](https://developers.smongrot.com/th/docs/api): ทุกฟังก์ชัน ชนิด ตัวเลือก และข้อผิดพลาดที่ export ทั้ง JS และ Dart - [ภาพรวมโปรโตคอล](https://developers.smongrot.com/th/docs/protocol): รูปแบบบนสาย, wake, ไบต์ของ session, การตัด live, การอ่านรหัสข้อผิดพลาด - [แก้ปัญหา](https://developers.smongrot.com/th/docs/troubleshooting): ทุก `code` (`ECU_SILENT`, `API_*`, …) พร้อมสาเหตุและวิธีแก้ รวมอาการที่ดูคล้ายบั๊ก - [คำถามที่พบบ่อย](https://developers.smongrot.com/th/docs/faq): SDK ฟรีสัญญาอนุญาต MIT, API key ฟรี, 1000 คำขอต่อวัน, ใช้เชิงพาณิชย์ได้, ความเป็นส่วนตัว, แผน v0.2 ## ไม่บังคับ - [llms-full.txt](https://developers.smongrot.com/th/llms-full.txt): รวมเอกสารและไฟล์สเปกทั้งหมดเป็นข้อความเดียว สร้างขึ้นอัตโนมัติ