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

English

เริ่มต้นใช้งาน: 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