SDK v0.1 · read-only
Quickstart: Dart
Install
smongrot_sdkand 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