SDK v0.1 · read-only

Quickstart: Dart

ภาษาไทย

Install smongrot_sdk and open a read-only session on Flutter desktop or Android.

Cable and drivers: Hardware. Longer recipes: Examples.

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 is pure Dart (no Flutter needed, compiles for web), MIT. The cable transports are separate small packages so the core has no native code.

Desktop (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 cannot hold the line LOW directly, so the Android adapter sends a short low-baud pulse instead (about 45 ms). Most Keihin boxes answer it; a Shindengen box fresh off key-ON may not, and connect retries 4 times. If you have a native FTDI bit-bang helper, pass it as atomicWake.

iOS has no USB-serial access; iOS support comes in v0.2 with the SMR board.

Model name

final api = SmongrotApi(apiKey: myKey);
final s = await connect(transport, lookupModel: api.lookupModel);

See Identify and API key.

Test without a bike

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

Next: Examples