SDK v0.1 · อ่านอย่างเดียว
เริ่มต้นใช้งาน: JavaScript
ติดตั้ง
@smongrot/sdkแล้วเปิด session แบบอ่านอย่างเดียวจากเบราว์เซอร์บนเดสก์ท็อปหรือจาก Node
สายและไดรเวอร์: ฮาร์ดแวร์ สูตรที่ยาวกว่า: ตัวอย่าง
npm i @smongrot/sdk
แพ็กเกจนี้เป็น ESM ไม่มี dependency ตอนรัน สัญญาอนุญาต MIT ใช้ได้บน Node ≥ 18 หรือ Chrome / Edge บนเดสก์ท็อป (WebSerial) บิดกุญแจไปที่ ON (ดับเครื่องได้) แล้วเสียบสายที่ขั้ววินิจฉัยของรถ
เบราว์เซอร์
import { connect, openWebSerial } from '@smongrot/sdk';
button.onclick = async () => {
const port = await navigator.serial.requestPort();
const s = await connect(await openWebSerial(port));
const { ecmId } = await s.identify();
for await (const f of s.live()) {
const rpm = f.fields.rpm;
show(rpm?.status === 'ok' ? rpm.value : '—'); // never show 0 for a missing value
}
};
Node
serialport เป็น optional peer dependency ให้ติดตั้งเอง
npm i @smongrot/sdk serialport
import { SerialPort } from 'serialport';
import { connect, fromSerialPort } from '@smongrot/sdk';
const port = new SerialPort({ path: '/dev/cu.usbserial-XXXX', baudRate: 10400, autoOpen: false });
const s = await connect(await fromSerialPort(port));
console.log(await s.identify());
console.log(await s.dtc.read()); // beta: result.beta === true
await s.close();
แพ็กเกจมีตัวอย่างที่รันได้ที่ examples/node-serialport.mjs
Duplex stream อื่นที่ 10400 8N1 ใช้กับ fromDuplex(stream, { setBreak | wake }) ได้
ชื่อรุ่น
ใส่ API key ฟรี เพื่อให้ identify() คืนชื่อรุ่น (ดู
ระบุตัวกล่องและ API key):
import { smongrotApi } from '@smongrot/sdk';
const api = smongrotApi({ apiKey: process.env.SMONGROT_API_KEY });
const s = await connect(transport, { lookupModel: api.lookupModel });
ทดสอบโดยไม่มีรถ
import { connect, FakeEcuTransport } from '@smongrot/sdk';
const fake = new FakeEcuTransport({
replies: { '72 07 72 17 00 0F EF': '02 15 72 17 00 0D EE 67 45 F8 0A FF FF FF FF 7D 0C 0D A8 55 28' },
});
const s = await connect(fake, { sleep: async () => {} });
for await (const f of s.live()) { console.log(f.fields.rpm.value); break; } // 3566
ถัดไป: เริ่มต้นใช้งาน: Dart