แนวคิด
session ของ level 1 เดินยังไง ECM-ID คืออะไร และทำไมค่า live ที่ไม่มีไม่ใช่ 0
วงจรของ session
connect(transport) เป็นทางเดียวที่จะเปิด session มันทำ wake, StartComm, liveness และ StartDiag แล้วคืนมาตอน state === 'ready' จากนั้นค่อยเรียก identify(), live() และ dtc.read() close() ปล่อยพอร์ต
App Cable / ECU
|-- connect() ------------------------------------------->|
| wake: line LOW 70 ms, release, idle 130 ms |
| StartComm FE 04 72 8C (reply not required) |
| liveness first non-empty reply means "up" |
| 72 05 00 F0 99 |
| 72 05 71 00 18 |
| 7E 06 01 01 00 7A |
|<------------------------ any reply --------------------|
| StartDiag 72 05 71 00 18 |
|<------------------------ 02 0F 71 00 <5-byte id> .. ----|
| |
| state is now "ready" |
|-- identify() ------------------------------------------>|
| 72 07 72 00 00 05 10 up to 3 tries, 300 ms apart |
|<------------------------ 02 0B 72 00 00 <5 bytes> ck ---|
|-- live() or dtc.read() (not at the same time) ------>|
|<------------------------ frames -----------------------|
|-- close() --------------------------------------------->|
| state is "closed" |
ถ้า probe ของ liveness ไม่มีตัวไหนตอบ connect จะทำ wake + StartComm + liveness ซ้ำ สูงสุด 4 ครั้ง แล้ว throw ECU_SILENT ต้องส่ง StartDiag ไม่งั้นตาราง live จะเงียบ connect ส่งให้แล้ว
state เริ่มที่ idle แล้ว waking แล้ว ready live() ย้ายไป live และกลับมา ready เมื่อลูปจบ identify, detect, live และ dtc.read ต้องอยู่ในสถานะ ready หยุดลูป live ก่อนอ่านรหัสข้อผิดพลาด identify() จำผลไว้ การเรียกครั้งที่สองไม่แตะสาย
ECM-ID
ECM-ID คือ 5 ไบต์ เขียนเป็นเลขฐานสิบหกตัวใหญ่ 10 ตัว เช่น 0104780D01 identify() เลือก frame อ่าน ID โดยเฉพาะก่อน ถ้า frame นั้นไม่มา จะใช้ ID ที่มากับ reply ของ StartDiag (source เป็น id_frame, start_diag หรือ null)
ID ไม่ใช่ชื่อรุ่น ชื่อ ผู้ผลิต และรหัสอะไหล่มาจาก lookupModel เท่านั้น (ดู ระบุตัวกล่องและ API key) live data กับรหัสข้อผิดพลาดไม่ต้องใช้ชื่อรุ่น
โปรไฟล์ live
live() ที่ไม่ส่ง profile จะ probe ตาราง 0x17 แล้ว 0x13 แล้ว 0x11 (ตารางละ 2 ครั้ง) แล้วเลือก layout ส่ง profile ก็ต่อเมื่อรู้ id อยู่แล้ว
| โปรไฟล์ | ผู้ผลิต | ฟิลด์ |
|---|---|---|
t17.sub8 |
Keihin | rpm, tps_v, tps, ect, batt, inj_ms, ign, ltft, o2r |
t17.sub4 |
Shindengen | rpm, tps_v, tps, eot, batt, inj_ms, ign |
t13.type7 |
Keihin | rpm, tps, ect, batt, inj_ms, ign, o2r |
t11.type1 |
Keihin | rpm, tps, ect, batt, inj_ms, ign, o2r |
generic.t17 |
ได้ทั้งคู่ | rpm, tps, inj_ms, ign |
generic.t17 เป็นทางสำรองเมื่อตาราง 0x17 ตอบ แต่ไม่เข้า layout ย่อยทั้งสอง มีเฉพาะฟิลด์ที่ตรงกันทั้งสองผู้ผลิต อุณหภูมิและแบตจึง absent โดยตั้งใจ
แต่ละค่าคือ raw × scale + add จากไบต์แบบ big-endian สเกลอยู่ใน spec/live.json SDK ไม่ส่งฟิลด์ o2_v ถ้าจะโชว์เป็นโวลต์ ให้ใช้ o2r × 0.0195 ตอน o2r เป็น ok การแปลงนี้เป็น provisional และเซ็นเซอร์ narrowband บอกได้แค่หนาหรือบาง ไม่ใช่ค่าอัตราส่วนอากาศต่อเชื้อเพลิง
detect() คืน { profile, method, mismatch } หรือ null method เป็น probed หรือ generic mismatch เป็นจริงเมื่อมี maker hint และผู้ผลิตของโปรไฟล์ทั้งคู่ และทั้งสองค่าไม่ตรงกัน layout ที่อ่านได้จริงยังชนะอยู่
สถานะของฟิลด์
ทุกฟิลด์ถูกส่งในทุก frame แม้ตารางของมันจะยังไม่ตอบ
status |
ความหมาย | ให้โชว์ |
|---|---|---|
ok |
value เป็นตัวเลข |
ตัวเลขนั้น |
absent |
ไม่มีใน frame นี้ | — |
invalid |
นอกช่วง หรือสองแหล่งไม่ตรงกัน | — ไม่ใช่ตัวเลขดิบ |
absent คือกรณี "ไม่มีค่า" ไม่ใช่ 0 ไบต์ sentinel (เช่น อุณหภูมิ 0xFF หรือแบต 0) เป็น absent ตารางที่ยังไม่ถูกอ่านเป็น absent ฟิลด์ที่โปรไฟล์นี้ไม่มีก็เป็น absent ถ้าเอา 0 ไปแทน จะเห็นเซ็นเซอร์ที่ตายเป็นศูนย์จริง
rpm ไม่มี sentinel ถ้าตารางตอบ จะเป็น status: 'ok' เสมอ แม้เครื่องดับ ตอนเปิดกุญแจแต่เครื่องดับ กล่องอาจส่ง 0 หรือเลขที่ไม่มีความหมาย (กล่อง Keihin K03-H01 บน bench ส่งราว 17,500 รอบ และอุณหภูมิ −30 °C) ให้ดู frame.engine ถ้าเป็น 'off' (หัวฉีด 0 ms และองศาจุดระเบิด 0°) แปลว่ารอบกับอุณหภูมิไม่ใช่ค่าจริง ซ่อน หรือขึ้นว่า "เครื่องดับ"
prov คนละเรื่องกับ status มีได้เป็น bench (วัดบน ECU จริง), field (สอดคล้องในล็อกภาคสนาม ยังไม่ได้เทียบมิเตอร์), reference (มาจากตัวถอดรหัสอ้างอิงอย่างเดียว) หรือ provisional (ตัวอย่างเดียว หรือเป็นการอนุมาน) ให้โชว์ค่า provisional ได้ แต่อย่าให้มันตัดสินใจเพียงลำพัง แบตบน layout ของ Shindengen เป็น provisional prov ไม่ใช่ status อย่าเช็ค status === 'provisional'
ใน Dart reading.ok คือ status == 'ok' ใน JavaScript ต้องเช็ค reading.status === 'ok' ก่อนใช้ value
frame ที่ primaryOk: false อ่านตารางหลักไม่สำเร็จ ฟิลด์ของตารางนั้นเป็น absent ใน tick นี้ SDK ไม่เอาเลขของเฟรมก่อนมาใช้ซ้ำ
ผู้ผลิต
| ผู้ผลิต | รหัสอะไหล่ขึ้นต้น | รหัสข้อผิดพลาดใน v0.1 |
|---|---|---|
keihin |
38770- |
ถอดรหัสได้ (beta) |
shindengen |
30400- |
อ่าน frame เดียวกัน แต่ payload ที่ไม่เป็นศูนย์ทั้งหมดเป็น unreadable |
makerHint ตอน connect หรือ model.maker / model.partCode หลัง identify() เป็นตัวเลือกตัวถอดรหัส ผู้ผลิตที่ไม่รู้บวก payload ที่ไม่เป็นศูนย์ คือ unreadable พร้อม reason: 'maker_unknown' payload ที่เป็นศูนย์ทั้งหมดคือ clean ได้ทั้งสองผู้ผลิต SDK ไม่เดารหัส
จังหวะเวลา
ค่าเริ่มต้น (DEFAULT_TIMING ใน JavaScript, Timing() ใน Dart) แก้ฟิลด์ก็ต่อเมื่อตั้งใจ
| ค่าเริ่มต้น | |
|---|---|
| Wake LOW / idle หลัง wake | 70 ms / 130 ms |
| จำนวนครั้งของ wake (wake + StartComm + liveness) | 4 |
| จำนวนครั้งของ ECM-ID / ช่องว่าง | 3 / 300 ms |
| command quiet / timeout | 120 ms / 2000 ms |
| ตาราง live quiet / timeout | 120 ms / 500 ms |
| ช่องว่างระหว่างการอ่านรหัสข้อผิดพลาด | 60 ms |
| หน่วย tick ของ live (ตารางรองถึงรอบเมื่อไหร่) | 300 ms |
| ช่องเป้าระหว่าง frame / ช่องต่ำสุด | 150 ms / 60 ms |
การอ่านจบเมื่อเงียบครบ quiet มิลลิวินาที หรือครบ timeout อย่างใดอย่างหนึ่งมาก่อน timeout ไม่ throw จะได้ reply ว่าง แล้วฟิลด์หรือผล DTC จะบอกเอง
ตาราง live หลักถูกอ่านทุก frame ตารางรอง (o2r บน t20, แบต Shindengen บน d0) อ่านได้มากสุดหนึ่งตารางต่อ frame ฟิลด์พวกนั้นจึง absent ในเฟรมแรก ๆ นั่นคือจังหวะการโพล ไม่ใช่เซ็นเซอร์เสีย
ถัดไป: ฮาร์ดแวร์