Show the drone's locked home point on the fly-mode map

Adds MSP_WP (118) support to query the flightcontroller's stored home
point (WP#0 is a special case for this in iNAV's getWaypoint(), per
navigation.c) - the FC reports (0,0,0) rather than an error before one
is set, so parseMspHomePoint() treats that pair as "unset". Rendered
with a small pentagon house icon (design/homepoint-pentagon.svg,
ported to a CustomPainter like the other map icons).

Deliberately not polled continuously: a new home_point_provider.dart
refreshes it only at the three moments the FC's home point can
actually change - connect/reconnect, GPS fix acquired, and arming
(iNAV's default reset_home_type=FIRST_ARM only freezes it at the first
arm; before that it continuously follows the aircraft while disarmed).

Mock's implementation offsets the point 25m from the anchor so it
doesn't sit exactly under the drone marker during UI testing.
This commit is contained in:
Constantin Leue
2026-08-09 21:10:00 +02:00
parent c9f16b13f8
commit 5fd5d0117a
12 changed files with 594 additions and 0 deletions
@@ -30,6 +30,14 @@ class _FakeFlightController {
bool wpGetInfoValid = false;
int wpGetInfoCount = 0;
/// null simuliert "FC hat noch keinen Homepoint gesetzt" (`!STATE(
/// GPS_FIX_HOME)`, meldet dann (0,0,0) statt eines Fehlers).
({int lat, int lon, int altCm})? homePoint = (
lat: 525000000,
lon: 134000000,
altCm: 6000,
);
void _tick(Timer _) {
while (_answered < transport.sentData.length) {
final request =
@@ -76,6 +84,17 @@ class _FakeFlightController {
case MspCommands.wpGetInfo:
payload = Uint8List.fromList(
[0, 15, wpGetInfoValid ? 1 : 0, wpGetInfoCount]);
case MspCommands.getWp:
final wpNo = request.payload[0];
final point = homePoint;
final d = ByteData(21);
d.setUint8(0, wpNo);
if (wpNo == 0 && point != null) {
d.setInt32(2, point.lat, Endian.little);
d.setInt32(6, point.lon, Endian.little);
d.setInt32(10, point.altCm, Endian.little);
}
payload = d.buffer.asUint8List();
default:
payload = Uint8List(0);
}
@@ -170,6 +189,43 @@ void main() {
responder.cancel();
}, timeout: const Timeout(Duration(seconds: 5)));
group('readHomePoint', () {
test('fragt MSP_WP mit wp_no=0 ab und dekodiert den Homepoint', () async {
final transport = LoopbackTransport();
final responder = _startFakeFlightController(transport);
final link = MspFlightControllerLink(transport: transport);
await link.connect();
final home = await link.readHomePoint();
expect(home, isNotNull);
expect(home!.lat, closeTo(52.5, 1e-6));
expect(home.lon, closeTo(13.4, 1e-6));
expect(home.altitudeM, closeTo(60.0, 1e-9));
await link.disconnect();
responder.cancel();
}, timeout: const Timeout(Duration(seconds: 5)));
test('liefert null, wenn der FC noch keinen Homepoint gesetzt hat '
'(meldet (0,0,0) statt eines Fehlers)', () async {
final transport = LoopbackTransport();
final responder = _startFakeFlightController(transport)..homePoint = null;
final link = MspFlightControllerLink(transport: transport);
await link.connect();
expect(await link.readHomePoint(), isNull);
await link.disconnect();
responder.cancel();
}, timeout: const Timeout(Duration(seconds: 5)));
test('readHomePoint() vor connect() wirft StateError', () {
final link = MspFlightControllerLink(transport: LoopbackTransport());
expect(() => link.readHomePoint(), throwsStateError);
});
});
test('subscribeTelemetry() vor connect() wirft StateError', () {
final link = MspFlightControllerLink(transport: LoopbackTransport());
expect(() => link.subscribeTelemetry(), throwsStateError);
@@ -152,4 +152,68 @@ void main() {
expect(info.isValid, isFalse);
});
});
group('encodeMspGetWaypointRequest', () {
test('kodiert wp_no als einzelnes Byte', () {
expect(encodeMspGetWaypointRequest(0), Uint8List.fromList([0]));
expect(encodeMspGetWaypointRequest(255), Uint8List.fromList([255]));
});
test('mspWpNumberHome ist 0 (WP#0 = Homepoint laut getWaypoint())', () {
expect(mspWpNumberHome, 0);
});
});
group('parseMspHomePoint', () {
/// Baut die 21-Byte MSP_WP-Antwort wie der echte FC (`fc_msp.c`,
/// `mspFcWaypointOutCommand()`) - dient nur der Testverifikation.
Uint8List encodeFakeWpResponse({
int wpNo = 0,
int action = 0,
required int lat,
required int lon,
required int altCm,
}) {
final d = ByteData(21);
d.setUint8(0, wpNo);
d.setUint8(1, action);
d.setInt32(2, lat, Endian.little);
d.setInt32(6, lon, Endian.little);
d.setInt32(10, altCm, Endian.little);
return d.buffer.asUint8List();
}
test('dekodiert lat/lon (1e-7 deg) und Hoehe (cm -> m)', () {
final home = parseMspHomePoint(encodeFakeWpResponse(
lat: 525000000,
lon: 134000000,
altCm: 6050,
));
expect(home, isNotNull);
expect(home!.lat, closeTo(52.5, 1e-9));
expect(home.lon, closeTo(13.4, 1e-9));
expect(home.altitudeM, closeTo(60.5, 1e-9));
});
test('liefert null bei (0,0) - FCs eigener "kein Homepoint gesetzt"-Wert '
'(STATE(GPS_FIX_HOME) noch nicht erreicht)', () {
final home = parseMspHomePoint(encodeFakeWpResponse(
lat: 0,
lon: 0,
altCm: 0,
));
expect(home, isNull);
});
test('lat == 0 alleine (echter Punkt auf dem Aequator) zaehlt NICHT als '
'unset - nur (0,0) gemeinsam ist der Sonderfall', () {
final home = parseMspHomePoint(encodeFakeWpResponse(
lat: 0,
lon: 134000000,
altCm: 0,
));
expect(home, isNotNull);
expect(home!.lon, closeTo(13.4, 1e-9));
});
});
}
@@ -0,0 +1,200 @@
import 'dart:async';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:dmc_app/domain/waypoint/flat_waypoint_list.dart';
import 'package:dmc_app/transport/flight_controller_link.dart';
import 'package:dmc_app/ui/providers/home_point_provider.dart';
import 'package:dmc_app/ui/providers/telemetry_provider.dart';
/// Zaehlt readHomePoint()-Aufrufe statt sie tatsaechlich per MSP zu
/// beantworten - alle anderen Mitglieder sind fuer diesen Test irrelevant
/// und werfen bei Gebrauch bewusst.
class _FakeLink implements FlightControllerLink {
int readHomePointCalls = 0;
HomePoint? nextHomePoint;
@override
Future<HomePoint?> readHomePoint() async {
readHomePointCalls++;
return nextHomePoint;
}
@override
FcCapabilities get capabilities => throw UnimplementedError();
@override
Future<void> connect() => throw UnimplementedError();
@override
Future<void> disconnect() => throw UnimplementedError();
@override
Future<void> uploadMission(FlatWaypointList mission) => throw UnimplementedError();
@override
Future<bool> verifyMission(FlatWaypointList mission) => throw UnimplementedError();
@override
Future<void> setFlightMode(FlightMode mode) => throw UnimplementedError();
@override
Future<void> arm() => throw UnimplementedError();
@override
Stream<TelemetryFrame> subscribeTelemetry() => throw UnimplementedError();
@override
Future<int?> readActiveWaypointIndex() => throw UnimplementedError();
}
TelemetryFrame _frame({bool hasFix = true, bool armed = false}) => TelemetryFrame(
lat: 52.5,
lon: 13.4,
hasFix: hasFix,
fixType: hasFix ? 2 : 0,
numSat: 10,
altitudeM: 100,
gpsAltitudeM: 100,
speedMs: 15,
headingDeg: 0,
armed: armed,
batteryPercent: 80,
batteryVoltage: 22.0,
currentA: 10.0,
linkQuality: 90,
snrDb: 5,
hdop: 1.0,
navMode: 0,
flightMode: 'Idle',
sensorStatusBits: 0,
temperaturesC: const [null, null, null],
verticalSpeedMs: 0,
);
void main() {
test('fragt den Homepoint beim ersten Telemetrie-Frame ab (Verbindungsaufbau)',
() async {
final controller = StreamController<TelemetryFrame>();
addTearDown(controller.close);
final link = _FakeLink()
..nextHomePoint = const HomePoint(lat: 52.5, lon: 13.4, altitudeM: 60);
final container = ProviderContainer(overrides: [
telemetryProvider.overrideWith((ref) => controller.stream),
flightControllerLinkProvider.overrideWithValue(link),
]);
addTearDown(container.dispose);
container.listen(homePointAutoRefreshProvider, (previous, next) {});
controller.add(_frame(hasFix: false));
await Future<void>.delayed(Duration.zero);
expect(link.readHomePointCalls, 1);
expect(container.read(homePointProvider)?.lat, closeTo(52.5, 1e-9));
});
test('fragt NICHT bei jedem Frame erneut ab, solange sich Fix-/Arm-Status '
'nicht aendern (keine kontinuierliche Abfrage)', () async {
final controller = StreamController<TelemetryFrame>();
addTearDown(controller.close);
final link = _FakeLink();
final container = ProviderContainer(overrides: [
telemetryProvider.overrideWith((ref) => controller.stream),
flightControllerLinkProvider.overrideWithValue(link),
]);
addTearDown(container.dispose);
container.listen(homePointAutoRefreshProvider, (previous, next) {});
controller.add(_frame());
await Future<void>.delayed(Duration.zero);
controller.add(_frame());
controller.add(_frame());
controller.add(_frame());
await Future<void>.delayed(Duration.zero);
expect(link.readHomePointCalls, 1, reason: 'nur der erste Frame (Connect) loest aus');
});
test('fragt beim Uebergang auf einen GPS-Fix erneut ab', () async {
final controller = StreamController<TelemetryFrame>();
addTearDown(controller.close);
final link = _FakeLink();
final container = ProviderContainer(overrides: [
telemetryProvider.overrideWith((ref) => controller.stream),
flightControllerLinkProvider.overrideWithValue(link),
]);
addTearDown(container.dispose);
container.listen(homePointAutoRefreshProvider, (previous, next) {});
controller.add(_frame(hasFix: false));
await Future<void>.delayed(Duration.zero);
expect(link.readHomePointCalls, 1, reason: 'erster Frame = Connect-Trigger');
controller.add(_frame(hasFix: true));
await Future<void>.delayed(Duration.zero);
expect(link.readHomePointCalls, 2, reason: 'Fix-Erwerb ist ein eigener Trigger');
controller.add(_frame(hasFix: true));
await Future<void>.delayed(Duration.zero);
expect(link.readHomePointCalls, 2, reason: 'weiterhin Fix loest nicht erneut aus');
});
test('fragt beim Uebergang auf armed erneut ab', () async {
final controller = StreamController<TelemetryFrame>();
addTearDown(controller.close);
final link = _FakeLink();
final container = ProviderContainer(overrides: [
telemetryProvider.overrideWith((ref) => controller.stream),
flightControllerLinkProvider.overrideWithValue(link),
]);
addTearDown(container.dispose);
container.listen(homePointAutoRefreshProvider, (previous, next) {});
controller.add(_frame(armed: false));
await Future<void>.delayed(Duration.zero);
expect(link.readHomePointCalls, 1, reason: 'erster Frame = Connect-Trigger');
controller.add(_frame(armed: true));
await Future<void>.delayed(Duration.zero);
expect(link.readHomePointCalls, 2, reason: 'Armen ist ein eigener Trigger');
controller.add(_frame(armed: true));
await Future<void>.delayed(Duration.zero);
expect(link.readHomePointCalls, 2, reason: 'weiterhin armed loest nicht erneut aus');
});
test('fragt nach einem Verbindungsverlust bei Wiederverbindung erneut ab',
() async {
final controller = StreamController<TelemetryFrame>();
addTearDown(controller.close);
final link = _FakeLink();
final container = ProviderContainer(overrides: [
telemetryProvider.overrideWith((ref) => controller.stream),
flightControllerLinkProvider.overrideWithValue(link),
]);
addTearDown(container.dispose);
container.listen(homePointAutoRefreshProvider, (previous, next) {});
controller.add(_frame());
await Future<void>.delayed(Duration.zero);
expect(link.readHomePointCalls, 1);
controller.addError(StateError('link down'));
await Future<void>.delayed(Duration.zero);
expect(link.readHomePointCalls, 1, reason: 'ein Fehler alleine fragt nichts ab');
controller.add(_frame());
await Future<void>.delayed(Duration.zero);
expect(link.readHomePointCalls, 2, reason: 'erster Frame nach Reconnect ist wieder ein Trigger');
});
test('speichert null, wenn der FC (noch) keinen Homepoint gesetzt hat', () async {
final controller = StreamController<TelemetryFrame>();
addTearDown(controller.close);
final link = _FakeLink()..nextHomePoint = null;
final container = ProviderContainer(overrides: [
telemetryProvider.overrideWith((ref) => controller.stream),
flightControllerLinkProvider.overrideWithValue(link),
]);
addTearDown(container.dispose);
container.listen(homePointAutoRefreshProvider, (previous, next) {});
controller.add(_frame());
await Future<void>.delayed(Duration.zero);
expect(container.read(homePointProvider), isNull);
});
}