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

English

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

ดู ระบุตัวกล่องและ API key

ทดสอบโดยไม่มีรถ

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

ถัดไป: ตัวอย่าง