SDK v0.1 · อ่านอย่างเดียว

English

แก้ปัญหา

รหัส code ทุกตัวที่ SDK throw หรือรายงาน สาเหตุ และสิ่งที่ต้องเปลี่ยน

JavaScript throw SmongrotError (e.code, e.message) Dart throw SmongrotException (ฟิลด์เดียวกัน) จับสองชนิดนี้ การค้นรุ่นไม่ throw: lookupModel คืน null และเรียก onError ยกเว้นกรณี "ไม่รู้จัก ECU"

try {
  const s = await connect(transport);
} catch (e) {
  if (e instanceof SmongrotError) console.error(e.code, e.message);
  else throw e;
}
try {
  final s = await connect(transport);
} on SmongrotException catch (e) {
  print('${e.code} ${e.message}');
}

ความล้มเหลวของ adapter และเบราว์เซอร์บางครั้ง reject ด้วยข้อผิดพลาดเดิมโดยไม่มี code (DOMException จาก WebSerial, ข้อผิดพลาดของสตรีมจาก fromDuplex) จับ SmongrotError ก่อน แล้วค่อยจัดการที่เหลือ

Session

ECU_SILENT

ไม่มี reply ของ liveness หลัง wake 4 ครั้ง (LOW 70 ms, idle 130 ms, StartComm, probe สามตัว) ข้อความคือ no answer after wake (key ON? cable on the DLC?)

สาเหตุ. กุญแจ OFF, สายเสียบผิดขั้ว, พอร์ตอนุกรมผิด, baud ไม่ใช่ 10400 หรือ wake ที่กล่องไม่สนใจ

แก้. บิดกุญแจ ON ตรวจพาธพอร์ต ดู ฮาร์ดแวร์ แล้วลองใหม่ กล่อง Shindengen ที่เพิ่งบิดไป ON มักต้องใช้ wake แบบ atomic 70 ms (FTDI bit-bang) พัลส์บน Android ประมาณ 45 ms และ adapter บนเดสก์ท็อปใช้ break ของระบบปฏิบัติการ connect ลองให้ครบ 4 ครั้งแล้ว ค่าเริ่มต้นคือ 4 ครั้ง เรียก connect ใหม่ หรือส่ง wakeTries สูงขึ้นเมื่อมีเหตุผล

BAD_STATE

การเรียกไม่ตรงกับ session.state ข้อความคือ session is <state>, needs <state>

สาเหตุ. เรียก identify, detect, live หรือ dtc.read ตอน state ไม่ใช่ ready กรณีที่พบบ่อยคือเรียก dtc.read() หรือ live() ครั้งที่สองจากในลูป live (state เป็น live) รวมถึงใช้ session ก่อน connect สำเร็จ หรือหลัง close()

แก้. await connect ให้จบก่อน ออกจากลูป live (หรือ abort สัญญาณ / ยกเลิก subscription ของ Dart) แล้วรอจนลูปจบ state กลับเป็น ready จากนั้นค่อยอ่านรหัสข้อผิดพลาด อย่ากำหนด state เอง

LIVE_UNSUPPORTED

live() probe 0x17, 0x13 และ 0x11 แล้วไม่มีตารางไหนคืนข้อมูล

สาเหตุ. session ขึ้นแล้ว แต่กล่องนี้ไม่ตอบตาราง live รวมถึงสายที่หลุดหลัง wake หรือ timeout ของตาราง (500 ms) บนลิงก์ที่ช้ามาก

แก้. อยู่บน session นี้แล้วเรียก identify() ถ้า ECM-ID มา แปลว่าบัสใช้ได้ และกล่องนี้ไม่มีตาราง live ของ level 1 (detect() คืน null) ถ้า ID เป็น null ด้วย ให้แก้สายแล้วเชื่อมใหม่ อย่าเติมจอด้วยศูนย์

BAD_PROFILE

live({ profile }) ได้ id ที่ไม่มีในสเปก

สาเหตุ. พิมพ์ผิด หรือสตริง liveProfile จาก API ที่ SDK รุ่นนี้ไม่มี คำแนะนำจาก API มักเป็น null อยู่แล้ว

แก้. ไม่ต้องส่ง profile ให้ live() ตรวจเอง id ที่ใช้ได้: t17.sub8, t17.sub4, t13.type7, t11.type1, generic.t17

CLOSED

เรียกอะไรก็ตามที่คุยกับ ECU หลัง close()

สาเหตุ. ลูป live หรือ identify ที่มาช้ายังทำงานอยู่ตอนปิด หรือเรียกซ้ำบน session เดิม

แก้. ทิ้ง session แล้ว connect ใหม่ close() เป็นจุดจบ

NO_WAKE

สาเหตุ. JavaScript: transport ไม่มีทั้ง wake(lowMs) และ setBreak(on) Dart เดสก์ท็อป: ไดรเวอร์ปฏิเสธ break (break on/off refused by the driver)

แก้. ใช้ adapter ที่มากับ SDK หรือทำให้ transport ของคุณมี wake (ทางที่ควรใช้) หรือ setBreak สตรีมของ fromDuplex ต้องมี { setBreak } หรือ { wake } ในตัวเลือก การส่ง wake ให้ fromSerialPort จะใช้ตัวนั้นแทน break

FRAME_NOT_ALLOWED

สาเหตุ. มีการพยายามส่งเฟรมที่ไม่อยู่ในรายการอ่านอย่างเดียวของ SDK (เริ่ม session, อ่าน ECM ID, keep-alive, ตาราง live, อ่านรหัสปัญหา) SDK ปฏิเสธก่อนที่อะไรจะออกไปถึงสาย

แก้. การใช้งานปกติไม่ต้องแก้อะไร เพราะ API สาธารณะส่งเฉพาะเฟรมที่อนุญาต การเขียน การลบ และการล้างรหัสปัญหาทำผ่าน SDK นี้ไม่ได้

RESPONSE_TOO_LARGE

สาเหตุ. อุปกรณ์ส่งข้อมูลเกิน 4 KB ในคำตอบเดียว ECU จริงที่ 10400 baud ไม่ส่งแบบนี้ แปลว่าน่าจะเลือกพอร์ตผิด adapter มีปัญหา หรืออุปกรณ์ไม่ใช่ ECU

แก้. ตรวจพอร์ตกับสาย แล้ว connect ใหม่

Adapter

BAD_PORT

เฉพาะ fromSerialPort ค่าที่ส่งมาไม่ใช่ SerialPort ของ serialport, baud ถูกตั้งและไม่ใช่ 10400 หรือเฟรมไม่ใช่ 8N1

แก้. new SerialPort({ path, baudRate: 10400, dataBits: 8, stopBits: 1, parity: 'none', autoOpen: false }) ปล่อย baud ว่างได้ก็ต่อเมื่อยังไม่ได้เปิดจริง baud ที่ผิดจะถูกปฏิเสธ

PORT_OPEN

adapter ของ Dart เดสก์ท็อป: LibSerialPortTransport.open เปิดพาธไม่ได้ Android: UsbSerialTransport.open ได้ false จาก port.open() (ไม่ให้สิทธิ์ หรือถอดสาย)

แก้. เดสก์ท็อป: ใช้พาธจาก SerialPort.availablePorts และมีสิทธิ์บนโหนดอุปกรณ์ Android: เรียก device.create() เพื่อให้หน้าขอสิทธิ์ขึ้น แล้ว open พอร์ตที่มันคืน เสียบสาย OTG ก่อนลิสต์

WRITE_FAILED

เฉพาะ Dart เดสก์ท็อป LibSerialPortTransport.write รับไบต์ไม่ครบ (timeout ของการเขียนคือ 1000 ms)

สาเหตุ. พอร์ตค้าง หรือถูกถอดกลางทาง

แก้. ปิด เสียบใหม่ แล้ว connect อีกครั้ง การเขียนบน Android ไม่ใช้รหัสนี้ ข้อผิดพลาด USB จะ reject Future จาก port.write

NO_FETCH

เฉพาะ JavaScript throw ตอน สร้าง smongrotApi เมื่อไม่มี globalThis.fetch และคุณไม่ได้ส่ง fetch

แก้. Node 18 ขึ้นไปมี fetch บนรันไทม์ที่เก่ากว่า ให้ส่ง fetch ในตัวเลือก Dart ไม่มีรหัสนี้ (http เป็น dependency จริง)

API key

รหัสที่ throw มีแค่ NO_API_KEY รหัส API_* ทุกตัวไปที่ onError lookupModel ยังคืน null และ identify() ยังคืน ECM-ID

NO_API_KEY

apiKey หายหรือเป็นช่องว่าง throw จาก smongrotApi(...) / SmongrotApi(...) ไม่ใช่จาก identify

แก้. ส่ง key หรืออย่าสร้างตัวช่วย ถ้าไม่มีตัวช่วย ให้ connect โดยไม่ส่ง lookupModel แล้ว model จะเป็น null ขอ key ฟรีที่ https://developers.smongrot.com

API_BAD_INPUT

onError สตริงที่ส่งให้ lookupModel ไม่ใช่เลขฐานสิบหก 10 ตัว หลังจากตัดช่องว่างและทำตัวอักษรให้เป็นตัวใหญ่

แก้. ส่ง identity.ecmId ซึ่งเป็นเลขฐานสิบหกตัวใหญ่ 10 ตัวอยู่แล้ว หรืออย่าเรียก lookupModel เมื่อ ecmId เป็น null

API_UNAUTHORIZED

onError HTTP 401 หรือ 403

แก้. key ผิด หรือถูกตัดคำว่า Bearer ออกไปแล้ว ตัวช่วยส่ง Authorization: Bearer <key> เอง ส่ง key ดิบ ไม่ใช่ทั้งหัว

API_RATE_LIMITED

onError HTTP 429 key ฟรีใช้ได้ 1000 คำขอต่อวัน

แก้. เก็บชื่อรุ่นของ ECM-ID นั้นไว้ในแอป live data ไม่เรียก API identify() ก็จำผลไว้: หนึ่ง session ค้นครั้งเดียว

API_NETWORK

onError คำขอ throw หรือชน timeout (ค่าเริ่มต้น 5 วินาที, timeoutMs ใน JS, timeout ใน Dart)

แก้. ออฟไลน์เป็นสถานะที่รองรับ โชว์ ECM-ID แล้วปล่อยชื่อรุ่นเป็น — เพิ่ม timeoutMs ก็ต่อเมื่อเครือข่ายช้าจริง อย่ารีทรายในลูปถี่

API_ERROR

onError ข้อผิดพลาด HTTP อื่น ๆ e.message มีสถานะ และ error.code / error.message ของ API เมื่อบอดี้มีค่าพวกนั้น

แก้. อ่าน e.message ECM-ID ที่อ่านจากกล่องยังใช้ได้

API_BAD_RESPONSE

onError HTTP 200 แต่ JSON ไม่มี data ที่ใช้ได้ (model, ecu_code หรือ maker)

แก้. ถือว่าไม่รู้จักรุ่น อย่า parse บอดี้ด้วยวิธีที่สอง modelInfoFromApi คือตัว parse

ECU ที่ไม่รู้จัก

HTTP 404 คืน null และ ไม่ เรียก onError กล่องนั้นยังไม่อยู่ในแคตตาล็อก โชว์ ECM-ID

Timeout, NAK, echo

สิ่งเหล่านี้ไม่ใช่รหัสข้อผิดพลาด

Timeout. การอ่านคำสั่งจบหลังเงียบ 120 ms หรือครบ 2000 ms การอ่านตาราง live จบหลังเงียบ 120 ms หรือครบ 500 ms ไม่มีอะไรถูก throw ได้ reply สั้นหรือว่าง: ฟิลด์กลับมาเป็น absent หรือ dtc.read() กลับมาเป็น failed แก้สายและกุญแจก่อนไปแตะ timing แก้ commandTimeoutMs / tableTimeoutMs (JS) หรือฟิลด์คู่กันของ Timing (Dart) ก็ต่อเมื่อวัดแล้วว่าลิงก์ช้า

NAK. reply ของรหัสข้อผิดพลาดที่มีไบต์ 0x7F นับเป็นไม่มีคำตอบ ถ้าการอ่าน 72 05 74 ทั้งสามครั้งเงียบหรือเป็น NAK outcome คือ failed SDK ไม่แต่งรหัสจาก NAK เชื่อมใหม่ตอนกุญแจ ON อย่าล้างรหัส v0.1 ไม่มีฟังก์ชันล้าง

Echo. session ตัด echo ของทุกเฟรมที่ส่งให้เอง ไม่ต้องจัดการเอง

echo distorted เกิดอะไร
true false สาย echo คำขอตรงทุกไบต์ ปกติ
true true echo แค่เคลียร์บิต (ไม่มีการเซ็ตบิตเพิ่ม) และมี reply ที่ถูกต้องตามมา สาย USB บางเส้นเป็นแบบนี้ reply ยังถูกใช้
false false สิ่งที่อ่านกลับไม่ได้ขึ้นต้นด้วยคำขอ baud ผิด, พอร์ตที่ไม่ถูก flush หรือมีสอง session บนสายเส้นเดียว

distorted: true ครั้งหนึ่งใน session ไม่ใช่การอ่านที่ล้ม echo: false พร้อม reply ว่าง เป็นอาการเดียวกับ ECU_SILENT: ตั้งพอร์ตให้ถูก (10400 8N1, ไม่มี flow control) และใช้ session เดียว

อาการที่ดูเหมือนบั๊ก

rpm เป็น 0 หรือเลขสูงมากเช่น 17,500 และอุณหภูมิ −30 °C เครื่องดับอยู่ (เปิดกุญแจ) ดู frame.engine === 'off' (หัวฉีด 0 ms และองศาจุดระเบิด 0°) แปลว่ารอบกับอุณหภูมิไม่ใช่ค่าจริง ให้ขึ้นว่า "เครื่องดับ" rpm ที่ไม่มีจริง (ไม่มีตาราง) เป็น absent โชว์เป็น —

แบตดูปกติ แต่ค่าอื่นเป็น absent. ดู frame.profile

  • generic.t17 มีแค่ rpm, tps, inj_ms, ign ไม่มีอุณหภูมิ ไม่มีแบต
  • Shindengen (t17.sub4) รายงาน eot ไม่ใช่ ect การหา ect บนโปรไฟล์นั้นเป็น absent เสมอ
  • o2r อยู่บนตารางรองที่โพลทุก 5 tick และเลิกถามหลังพลาด 3 ครั้ง เฟรมแรกจึงยังไม่มี
  • batt ของ Shindengen เป็น provisional ไบต์ดิบ 0 เป็น absent ไม่ใช่ 0.0 V แหล่งแบตเพิ่มถูกโพลทุก 10 tick ยกเว้น ECM-ID 0105950D01 ที่อ่านจากตารางหลัก
  • primaryOk: false ล้างฟิลด์ของตารางหลักในเฟรมนั้น อย่าเก็บเลขของเฟรมก่อน

Shindengen, เพิ่งบิดกุญแจ ON, connect ล้มหรือใช้หลายครั้ง. wake 70 ms ต้องจับเวลาบน adapter break ของระบบปฏิบัติการบางครั้งพลาด และพัลส์ประมาณ 45 ms บน Android ถูกระบุว่ากล่อง Shindengen ที่เพิ่งออกจาก key ON จะไม่สนใจ ปล่อยให้ครบ 4 ครั้ง ถ้ายัง throw ECU_SILENT ให้ใช้สาย FTDI แล้วส่ง wake / atomicWake แบบ atomic ที่ดึงสายลง LOW ตาม lowMs ที่ได้รับ (70 ms) connect wake ให้อยู่แล้ว พัลส์เพิ่มก่อน connect มีแต่ทำให้จังหวะเพี้ยน

model เป็น null. ไม่ได้ส่ง lookupModel, key ถูกปฏิเสธ, เครือข่ายล้ม, ชนลิมิตต่อวัน หรือไม่รู้จัก ECU (404) id.ecmId ยังเป็นค่าจากกล่อง อ่าน onError เพื่อดูว่าเป็นรหัส API_* ตัวไหน 404 เงียบ

เบราว์เซอร์ไม่มี navigator.serial. WebSerial คือ Chrome หรือ Edge บนเดสก์ท็อป ในบริบทที่ปลอดภัย และเรียกจากคลิก Firefox, Safari และเบราว์เซอร์บนโทรศัพท์ไม่มี ใช้ Node หรือ adapter ของ Flutter

Android listDevices() ว่าง. สายไม่ใช่ OTG, หัวชาร์จอย่างเดียว หรือโทรศัพท์ไม่ได้อยู่ในโหมด USB host ลิสต์ใหม่หลังได้สิทธิ์ create() คืน null เมื่อผู้ใช้ปฏิเสธ นั่นจะเป็น PORT_OPEN ก็ต่อเมื่อเอาพอร์ตที่เป็น null ไปเปิด ตรวจ null ก่อน (ตัวอย่างทำแบบนั้น)

ถัดไป: คำถามที่พบบ่อย