SDK v0.1 · อ่านอย่างเดียว
เริ่มต้นใช้งาน: Dart
ติดตั้ง
smongrot_sdkแล้วเปิด session แบบอ่านอย่างเดียวบน Flutter เดสก์ท็อปหรือ Android
สายและไดรเวอร์: ฮาร์ดแวร์ สูตรที่ยาวกว่า: ตัวอย่าง
dart pub add smongrot_sdk
flutter pub add smongrot_sdk_libserialport # desktop cable
flutter pub add smongrot_sdk_usb_serial # Android USB-OTG cable
smongrot_sdk เป็น Dart ล้วน ไม่ต้องใช้ Flutter และคอมไพล์ขึ้นเว็บได้ สัญญาอนุญาต MIT
transport ของสายแยกเป็นแพ็กเกจเล็ก ๆ เพื่อให้ core ไม่มี native code
เดสก์ท็อป (Windows / macOS / Linux)
import 'package:smongrot_sdk/smongrot_sdk.dart';
import 'package:smongrot_sdk_libserialport/smongrot_sdk_libserialport.dart';
print(SerialPort.availablePorts);
final s = await connect(LibSerialPortTransport.open('/dev/cu.usbserial-XXXX'));
final id = await s.identify();
await for (final f in s.live()) {
final rpm = f.fields['rpm']!;
print(rpm.ok ? rpm.value : '—'); // never show 0 for a missing value
}
Android (USB-OTG)
import 'package:smongrot_sdk/smongrot_sdk.dart';
import 'package:smongrot_sdk_usb_serial/smongrot_sdk_usb_serial.dart';
final devices = await UsbSerial.listDevices();
final port = await devices.first.create(); // Android asks for USB permission
final s = await connect(await UsbSerialTransport.open(port!));
final dtc = await s.dtc.read(); // beta: dtc.beta == true
await s.close();
usb_serial ดึงสายค้างที่ LOW โดยตรงไม่ได้
adapter บน Android จึงส่งพัลส์ baud ต่ำสั้น ๆ แทน (ประมาณ 45 ms)
กล่อง Keihin ส่วนใหญ่ตอบพัลส์นี้
กล่อง Shindengen ทันทีหลังบิดกุญแจไปที่ ON อาจไม่ตอบ และ connect จะลองใหม่ 4 ครั้ง
ถ้ามีตัวช่วย FTDI bit-bang แบบ native ให้ส่งเข้ามาทาง atomicWake
iOS เข้าถึง USB-serial ไม่ได้ การรองรับ iOS จะมาใน v0.2 พร้อมบอร์ด SMR
ชื่อรุ่น
final api = SmongrotApi(apiKey: myKey);
final s = await connect(transport, lookupModel: api.lookupModel);
ทดสอบโดยไม่มีรถ
final fake = 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',
});
final s = await connect(fake, sleep: (_) async {});
print((await s.live().first).fields['rpm']!.value); // 3566.0
ถัดไป: ตัวอย่าง