404: Something's gone wrong :-(
+ +You've tried to visit a page that doesn't exist. Luckily this site + has other pages.
+If you were looking for something specific, try searching: +
+ + +
+
+
+
+
+
+
+
+
+You've tried to visit a page that doesn't exist. Luckily this site + has other pages.
+If you were looking for something specific, try searching: +
+ + +The main class for the app.
+model.
+ DiagnosticsNode objects describing this node's
+children.
+ Creates the main app.
+RoverControlDashboard() : super(models.settings);Builds the UI according to the state in model.
@override
+Widget build(BuildContext context, SettingsModel model) => MaterialApp(
+ title: "Binghamton University Rover Team",
+ home: SplashPage(),
+ debugShowCheckedModeBanner: false,
+ themeMode: models.isReady ? model.dashboard.themeMode : ThemeMode.system,
+ theme: ThemeData(
+ useMaterial3: false,
+ colorScheme: ColorScheme.light(
+ primary: binghamtonGreen,
+ secondary: binghamtonGreen,
+ surfaceVariant: Colors.blueGrey.shade400,
+ ),
+ appBarTheme: const AppBarTheme(
+ backgroundColor: binghamtonGreen,
+ foregroundColor: Colors.white,
+ ),
+ ),
+ darkTheme: ThemeData.from(
+ colorScheme: ColorScheme.dark(
+ primary: binghamtonGreen,
+ secondary: binghamtonGreen,
+ surfaceVariant: Colors.blueGrey.shade700,
+ ),
+ ),
+ routes: {
+ Routes.home: (_) => HomePage(),
+ Routes.settings: (_) => SettingsPage(),
+ },
+);Defines any global app configuration.
+Usually this page is reserved for theming, navigation, and startup logic.
+This library is the final touch that ties the app together, so it may depend on any other +library (except for main.dart).
+The classic Binghamton green.
+const binghamtonGreen = Color(0xff005943);true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory ArmCommand.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory ArmCommand.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory ArmCommand({
+ $core.bool? stop,
+ $core.bool? calibrate,
+ MotorCommand? swivel,
+ MotorCommand? shoulder,
+ MotorCommand? elbow,
+ MotorCommand? gripperLift,
+ $core.double? ikX,
+ $core.double? ikY,
+ $core.double? ikZ,
+ $core.bool? jab,
+}) {
+ final $result = create();
+ if (stop != null) {
+ $result.stop = stop;
+ }
+ if (calibrate != null) {
+ $result.calibrate = calibrate;
+ }
+ if (swivel != null) {
+ $result.swivel = swivel;
+ }
+ if (shoulder != null) {
+ $result.shoulder = shoulder;
+ }
+ if (elbow != null) {
+ $result.elbow = elbow;
+ }
+ if (gripperLift != null) {
+ $result.gripperLift = gripperLift;
+ }
+ if (ikX != null) {
+ $result.ikX = ikX;
+ }
+ if (ikY != null) {
+ $result.ikY = ikY;
+ }
+ if (ikZ != null) {
+ $result.ikZ = ikZ;
+ }
+ if (jab != null) {
+ $result.jab = jab;
+ }
+ return $result;
+}@$pb.TagNumber(2)
+$core.bool get calibrate => $_getBF(1);@$pb.TagNumber(2)
+set calibrate($core.bool v) { $_setBool(1, v); }@$pb.TagNumber(2)
+void clearCalibrate() => clearField(2);@$pb.TagNumber(5)
+void clearElbow() => clearField(5);@$pb.TagNumber(6)
+void clearGripperLift() => clearField(6);@$pb.TagNumber(7)
+void clearIkX() => clearField(7);@$pb.TagNumber(8)
+void clearIkY() => clearField(8);@$pb.TagNumber(9)
+void clearIkZ() => clearField(9);@$pb.TagNumber(10)
+void clearJab() => clearField(10);@$pb.TagNumber(4)
+void clearShoulder() => clearField(4);@$pb.TagNumber(1)
+void clearStop() => clearField(1);@$pb.TagNumber(3)
+void clearSwivel() => clearField(3);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+ArmCommand clone() => ArmCommand()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+ArmCommand copyWith(void Function(ArmCommand) updates) => super.copyWith((message) => updates(message as ArmCommand)) as ArmCommand;@$core.pragma('dart2js:noInline')
+static ArmCommand create() => ArmCommand._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
ArmCommand createEmptyInstance() => create();static $pb.PbList<ArmCommand> createRepeated() => $pb.PbList<ArmCommand>();@$pb.TagNumber(5)
+MotorCommand get elbow => $_getN(4);@$pb.TagNumber(5)
+set elbow(MotorCommand v) { setField(5, v); }@$pb.TagNumber(5)
+MotorCommand ensureElbow() => $_ensure(4);@$pb.TagNumber(6)
+MotorCommand ensureGripperLift() => $_ensure(5);@$pb.TagNumber(4)
+MotorCommand ensureShoulder() => $_ensure(3);@$pb.TagNumber(3)
+MotorCommand ensureSwivel() => $_ensure(2);@$core.pragma('dart2js:noInline')
+static ArmCommand getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<ArmCommand>(create);Needed for IK: If the wrist-lift moves, we need to re-calculate IK to keep the end-effector +stationary. See /Arm/src/ik/README.md in the Arm-Firmware repository.
+@$pb.TagNumber(6)
+MotorCommand get gripperLift => $_getN(5);@$pb.TagNumber(6)
+set gripperLift(MotorCommand v) { setField(6, v); }@$pb.TagNumber(2)
+$core.bool hasCalibrate() => $_has(1);@$pb.TagNumber(5)
+$core.bool hasElbow() => $_has(4);@$pb.TagNumber(6)
+$core.bool hasGripperLift() => $_has(5);@$pb.TagNumber(7)
+$core.bool hasIkX() => $_has(6);@$pb.TagNumber(8)
+$core.bool hasIkY() => $_has(7);@$pb.TagNumber(9)
+$core.bool hasIkZ() => $_has(8);@$pb.TagNumber(10)
+$core.bool hasJab() => $_has(9);@$pb.TagNumber(4)
+$core.bool hasShoulder() => $_has(3);@$pb.TagNumber(1)
+$core.bool hasStop() => $_has(0);@$pb.TagNumber(3)
+$core.bool hasSwivel() => $_has(2);@$pb.TagNumber(7)
+$core.double get ikX => $_getN(6);@$pb.TagNumber(7)
+set ikX($core.double v) { $_setFloat(6, v); }@$pb.TagNumber(8)
+$core.double get ikY => $_getN(7);@$pb.TagNumber(8)
+set ikY($core.double v) { $_setFloat(7, v); }@$pb.TagNumber(9)
+$core.double get ikZ => $_getN(8);@$pb.TagNumber(9)
+set ikZ($core.double v) { $_setFloat(8, v); }$pb.BuilderInfo get info_ => _i;Custom actions
+@$pb.TagNumber(10)
+$core.bool get jab => $_getBF(9);@$pb.TagNumber(10)
+set jab($core.bool v) { $_setBool(9, v); }@$pb.TagNumber(4)
+MotorCommand get shoulder => $_getN(3);@$pb.TagNumber(4)
+set shoulder(MotorCommand v) { setField(4, v); }General commands
+@$pb.TagNumber(1)
+$core.bool get stop => $_getBF(0);@$pb.TagNumber(1)
+set stop($core.bool v) { $_setBool(0, v); }Move individual motors
+@$pb.TagNumber(3)
+MotorCommand get swivel => $_getN(2);@$pb.TagNumber(3)
+set swivel(MotorCommand v) { setField(3, v); }true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory ArmData.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory ArmData.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory ArmData({
+ Coordinates? currentPosition,
+ Coordinates? targetPosition,
+ MotorData? base,
+ MotorData? shoulder,
+ MotorData? elbow,
+}) {
+ final $result = create();
+ if (currentPosition != null) {
+ $result.currentPosition = currentPosition;
+ }
+ if (targetPosition != null) {
+ $result.targetPosition = targetPosition;
+ }
+ if (base != null) {
+ $result.base = base;
+ }
+ if (shoulder != null) {
+ $result.shoulder = shoulder;
+ }
+ if (elbow != null) {
+ $result.elbow = elbow;
+ }
+ return $result;
+}@$pb.TagNumber(3)
+MotorData get base => $_getN(2);@$pb.TagNumber(3)
+set base(MotorData v) { setField(3, v); }@$pb.TagNumber(3)
+void clearBase() => clearField(3);@$pb.TagNumber(1)
+void clearCurrentPosition() => clearField(1);@$pb.TagNumber(5)
+void clearElbow() => clearField(5);@$pb.TagNumber(4)
+void clearShoulder() => clearField(4);@$pb.TagNumber(2)
+void clearTargetPosition() => clearField(2);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+ArmData clone() => ArmData()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+ArmData copyWith(void Function(ArmData) updates) => super.copyWith((message) => updates(message as ArmData)) as ArmData;@$core.pragma('dart2js:noInline')
+static ArmData create() => ArmData._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
ArmData createEmptyInstance() => create();@$pb.TagNumber(1)
+Coordinates get currentPosition => $_getN(0);@$pb.TagNumber(1)
+set currentPosition(Coordinates v) { setField(1, v); }@$pb.TagNumber(5)
+MotorData get elbow => $_getN(4);@$pb.TagNumber(5)
+set elbow(MotorData v) { setField(5, v); }@$pb.TagNumber(1)
+Coordinates ensureCurrentPosition() => $_ensure(0);@$pb.TagNumber(2)
+Coordinates ensureTargetPosition() => $_ensure(1);@$core.pragma('dart2js:noInline')
+static ArmData getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<ArmData>(create);@$pb.TagNumber(3)
+$core.bool hasBase() => $_has(2);@$pb.TagNumber(1)
+$core.bool hasCurrentPosition() => $_has(0);@$pb.TagNumber(5)
+$core.bool hasElbow() => $_has(4);@$pb.TagNumber(4)
+$core.bool hasShoulder() => $_has(3);@$pb.TagNumber(2)
+$core.bool hasTargetPosition() => $_has(1);$pb.BuilderInfo get info_ => _i;@$pb.TagNumber(4)
+MotorData get shoulder => $_getN(3);@$pb.TagNumber(4)
+set shoulder(MotorData v) { setField(4, v); }@$pb.TagNumber(2)
+Coordinates get targetPosition => $_getN(1);@$pb.TagNumber(2)
+set targetPosition(Coordinates v) { setField(2, v); }Metrics reported by the HREI subsystem about the arm. Does not include the gripper.
+Metrics from the arm.
+ArmMetrics() : super(ArmData());A list of user-friendly explanations for each of the metrics.
+Be sure to store the actual values as fields. This property should be a list of one +user-friendly explanation per metric.
+@override
+List<MetricLine> get allMetrics => [
+ MetricLine("IK: "),
+ MetricLine(" Current: ${data.currentPosition.prettyPrint}"),
+ MetricLine(" Target: ${data.targetPosition.prettyPrint}"),
+ MetricLine("------------------------------"),
+ MetricLine("Swivel: "),
+ ...getMotorData(data.base),
+ MetricLine("------------------------------"),
+ MetricLine("Shoulder: "),
+ ...getMotorData(data.shoulder),
+ MetricLine("------------------------------"),
+ MetricLine("Elbow: "),
+ ...getMotorData(data.elbow),
+];Returns a description of a MotorData.
+List<MetricLine> getMotorData(MotorData motor) => [
+ MetricLine(" Is moving? ${motor.isMoving}", severity: motor.isMoving ? Severity.info : null),
+ MetricLine(" Limit? ${motor.isLimitSwitchPressed}", severity: motor.isLimitSwitchPressed ? Severity.warning : null),
+ MetricLine(" Direction: ${motor.direction.humanName}"),
+ MetricLine(" Steps: ${motor.currentStep} --> ${motor.targetStep}"),
+ MetricLine(" Angle: ${motor.angle.toDegrees()} degrees"),
+];A collective name for this group of metrics (usually the name of the subsystem).
+@override
+String get name => "Arm Base";Settings relating to the arm.
+Parses arm settings from a JSON map.
+ArmSettings.fromJson(Json? json) :
+ shoulder = json?["shoulder"] ?? 0.005,
+ elbow = json?["elbow"] ?? 0.005,
+ swivel = json?["swivel"] ?? 0.2,
+ pinch = json?["pinch"] ?? 0.002,
+ lift = json?["lift"] ?? 0.01,
+ rotate = json?["rotate"] ?? 0.01,
+ useIK = json?["useIK"] ?? false,
+ ikIncrement = json?["ikIncrement"] ?? 10;A const constructor.
+const ArmSettings({
+ required this.shoulder,
+ required this.elbow,
+ required this.swivel,
+ required this.pinch,
+ required this.lift,
+ required this.rotate,
+ required this.ikIncrement,
+ required this.useIK,
+ });How many radians to move the elbow joint each frame.
+final double elbow;The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;How many mm to move every 10 ms in IK mode.
+final double ikIncrement;How many radians to lift the gripper each frame.
+final double lift;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);How many radians to pinch each frame.
+final double pinch;How many radians to rotate the gripper each frame.
+final double rotate;A representation of the runtime type of the object.
+external Type get runtimeType;How many radians to move the shoulder joint each frame.
+final double shoulder;How many radians to move the swivel joint each frame.
+final double swivel;Serializes these settings to a JSON map.
+Json toJson() => {
+ "shoulder": shoulder,
+ "elbow": elbow,
+ "swivel": swivel,
+ "pinch": pinch,
+ "lift": lift,
+ "rotate": rotate,
+ "useIK": useIK,
+ "ikIncrement": ikIncrement,
+};A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();Whether the arm is in manual or IK mode.
+final bool useIK;true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory AutonomyCommand.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory AutonomyCommand.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory AutonomyCommand({
+ $0.GpsCoordinates? destination,
+ AutonomyTask? task,
+ $core.int? arucoId,
+ $core.bool? abort,
+}) {
+ final $result = create();
+ if (destination != null) {
+ $result.destination = destination;
+ }
+ if (task != null) {
+ $result.task = task;
+ }
+ if (arucoId != null) {
+ $result.arucoId = arucoId;
+ }
+ if (abort != null) {
+ $result.abort = abort;
+ }
+ return $result;
+}@$pb.TagNumber(4)
+$core.bool get abort => $_getBF(3);@$pb.TagNumber(4)
+set abort($core.bool v) { $_setBool(3, v); }@$pb.TagNumber(3)
+$core.int get arucoId => $_getIZ(2);@$pb.TagNumber(3)
+set arucoId($core.int v) { $_setSignedInt32(2, v); }@$pb.TagNumber(4)
+void clearAbort() => clearField(4);@$pb.TagNumber(3)
+void clearArucoId() => clearField(3);@$pb.TagNumber(1)
+void clearDestination() => clearField(1);@$pb.TagNumber(2)
+void clearTask() => clearField(2);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+AutonomyCommand clone() => AutonomyCommand()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+AutonomyCommand copyWith(void Function(AutonomyCommand) updates) => super.copyWith((message) => updates(message as AutonomyCommand)) as AutonomyCommand;@$core.pragma('dart2js:noInline')
+static AutonomyCommand create() => AutonomyCommand._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
AutonomyCommand createEmptyInstance() => create();static $pb.PbList<AutonomyCommand> createRepeated() => $pb.PbList<AutonomyCommand>();@$pb.TagNumber(1)
+$0.GpsCoordinates get destination => $_getN(0);@$pb.TagNumber(1)
+set destination($0.GpsCoordinates v) { setField(1, v); }@$pb.TagNumber(1)
+$0.GpsCoordinates ensureDestination() => $_ensure(0);@$core.pragma('dart2js:noInline')
+static AutonomyCommand getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<AutonomyCommand>(create);@$pb.TagNumber(4)
+$core.bool hasAbort() => $_has(3);@$pb.TagNumber(3)
+$core.bool hasArucoId() => $_has(2);@$pb.TagNumber(1)
+$core.bool hasDestination() => $_has(0);@$pb.TagNumber(2)
+$core.bool hasTask() => $_has(1);$pb.BuilderInfo get info_ => _i;@$pb.TagNumber(2)
+AutonomyTask get task => $_getN(1);@$pb.TagNumber(2)
+set task(AutonomyTask v) { setField(2, v); }true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory AutonomyData.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory AutonomyData.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory AutonomyData({
+ AutonomyState? state,
+ $0.GpsCoordinates? destination,
+ $core.Iterable<$0.GpsCoordinates>? obstacles,
+ $core.Iterable<$0.GpsCoordinates>? path,
+ AutonomyTask? task,
+ $core.bool? crash,
+}) {
+ final $result = create();
+ if (state != null) {
+ $result.state = state;
+ }
+ if (destination != null) {
+ $result.destination = destination;
+ }
+ if (obstacles != null) {
+ $result.obstacles.addAll(obstacles);
+ }
+ if (path != null) {
+ $result.path.addAll(path);
+ }
+ if (task != null) {
+ $result.task = task;
+ }
+ if (crash != null) {
+ $result.crash = crash;
+ }
+ return $result;
+}@$pb.TagNumber(6)
+void clearCrash() => clearField(6);@$pb.TagNumber(2)
+void clearDestination() => clearField(2);@$pb.TagNumber(1)
+void clearState() => clearField(1);@$pb.TagNumber(5)
+void clearTask() => clearField(5);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+AutonomyData clone() => AutonomyData()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+AutonomyData copyWith(void Function(AutonomyData) updates) => super.copyWith((message) => updates(message as AutonomyData)) as AutonomyData;@$pb.TagNumber(6)
+$core.bool get crash => $_getBF(5);@$pb.TagNumber(6)
+set crash($core.bool v) { $_setBool(5, v); }@$core.pragma('dart2js:noInline')
+static AutonomyData create() => AutonomyData._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
AutonomyData createEmptyInstance() => create();static $pb.PbList<AutonomyData> createRepeated() => $pb.PbList<AutonomyData>();@$pb.TagNumber(2)
+$0.GpsCoordinates get destination => $_getN(1);@$pb.TagNumber(2)
+set destination($0.GpsCoordinates v) { setField(2, v); }@$pb.TagNumber(2)
+$0.GpsCoordinates ensureDestination() => $_ensure(1);@$core.pragma('dart2js:noInline')
+static AutonomyData getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<AutonomyData>(create);@$pb.TagNumber(6)
+$core.bool hasCrash() => $_has(5);@$pb.TagNumber(2)
+$core.bool hasDestination() => $_has(1);@$pb.TagNumber(1)
+$core.bool hasState() => $_has(0);@$pb.TagNumber(5)
+$core.bool hasTask() => $_has(4);$pb.BuilderInfo get info_ => _i;@$pb.TagNumber(3)
+$core.List<$0.GpsCoordinates> get obstacles => $_getList(2);@$pb.TagNumber(4)
+$core.List<$0.GpsCoordinates> get path => $_getList(3);@$pb.TagNumber(1)
+AutonomyState get state => $_getN(0);@$pb.TagNumber(1)
+set state(AutonomyState v) { setField(1, v); }@$pb.TagNumber(5)
+AutonomyTask get task => $_getN(4);@$pb.TagNumber(5)
+set task(AutonomyTask v) { setField(5, v); }static const AutonomyState ABORTING = AutonomyState._(8, _omitEnumNames ? '' : 'ABORTING');static const AutonomyState APPROACHING = AutonomyState._(3, _omitEnumNames ? '' : 'APPROACHING');static const AutonomyState AT_DESTINATION = AutonomyState._(4, _omitEnumNames ? '' : 'AT_DESTINATION');static const AutonomyState AUTONOMY_STATE_UNDEFINED = AutonomyState._(0, _omitEnumNames ? '' : 'AUTONOMY_STATE_UNDEFINED');static const AutonomyState DRIVING = AutonomyState._(5, _omitEnumNames ? '' : 'DRIVING');static const AutonomyState NO_SOLUTION = AutonomyState._(7, _omitEnumNames ? '' : 'NO_SOLUTION');static const AutonomyState PATHING = AutonomyState._(2, _omitEnumNames ? '' : 'PATHING');static const AutonomyState SEARCHING = AutonomyState._(6, _omitEnumNames ? '' : 'SEARCHING');static AutonomyState? valueOf($core.int value) => _byValue[value];static const $core.List<AutonomyState> values = <AutonomyState> [
+ AUTONOMY_STATE_UNDEFINED,
+ PATHING,
+ APPROACHING,
+ AT_DESTINATION,
+ DRIVING,
+ SEARCHING,
+ NO_SOLUTION,
+ ABORTING,
+];Utilities for AutonomyStates.
+The human-readable name of the task.
+String get humanName {
+ switch (this) {
+ case AutonomyState.AUTONOMY_STATE_UNDEFINED: return "Disabled";
+ case AutonomyState.PATHING: return "Calculating path";
+ case AutonomyState.APPROACHING: return "Approaching destination";
+ case AutonomyState.AT_DESTINATION: return "Arrived at destination";
+ case AutonomyState.DRIVING: return "Driving";
+ case AutonomyState.SEARCHING: return "Searching for ArUco";
+ case AutonomyState.ABORTING: return "Aborting";
+ case AutonomyState.NO_SOLUTION: return "No solution found";
+ }
+ // Do not use default or else you'll lose exhaustiveness checking.
+ throw ArgumentError("Unrecognized status: $this");
+}static const AutonomyTask AUTONOMY_TASK_UNDEFINED = AutonomyTask._(0, _omitEnumNames ? '' : 'AUTONOMY_TASK_UNDEFINED');static const AutonomyTask BETWEEN_GATES = AutonomyTask._(3, _omitEnumNames ? '' : 'BETWEEN_GATES');static const AutonomyTask GPS_ONLY = AutonomyTask._(1, _omitEnumNames ? '' : 'GPS_ONLY');static const AutonomyTask VISUAL_MARKER = AutonomyTask._(2, _omitEnumNames ? '' : 'VISUAL_MARKER');static AutonomyTask? valueOf($core.int value) => _byValue[value];static const $core.List<AutonomyTask> values = <AutonomyTask> [
+ AUTONOMY_TASK_UNDEFINED,
+ GPS_ONLY,
+ VISUAL_MARKER,
+ BETWEEN_GATES,
+];Utilities for AutonomyTasks.
+The human-readable name of the task.
+String get humanName {
+ switch (this) {
+ case AutonomyTask.AUTONOMY_TASK_UNDEFINED: return "No task";
+ case AutonomyTask.GPS_ONLY: return "GPS only";
+ case AutonomyTask.VISUAL_MARKER: return "Visual marker";
+ case AutonomyTask.BETWEEN_GATES: return "Between gates";
+ }
+ // Do not use default or else you'll lose exhaustiveness checking.
+ throw ArgumentError("Unrecognized task: $this");
+}true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory BurtLog.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory BurtLog.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory BurtLog({
+ BurtLogLevel? level,
+ $core.String? title,
+ $core.String? body,
+ $1.Device? device,
+}) {
+ final $result = create();
+ if (level != null) {
+ $result.level = level;
+ }
+ if (title != null) {
+ $result.title = title;
+ }
+ if (body != null) {
+ $result.body = body;
+ }
+ if (device != null) {
+ $result.device = device;
+ }
+ return $result;
+}@$pb.TagNumber(3)
+$core.String get body => $_getSZ(2);@$pb.TagNumber(3)
+set body($core.String v) { $_setString(2, v); }@$pb.TagNumber(3)
+void clearBody() => clearField(3);@$pb.TagNumber(4)
+void clearDevice() => clearField(4);@$pb.TagNumber(1)
+void clearLevel() => clearField(1);@$pb.TagNumber(2)
+void clearTitle() => clearField(2);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+BurtLog clone() => BurtLog()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+BurtLog copyWith(void Function(BurtLog) updates) => super.copyWith((message) => updates(message as BurtLog)) as BurtLog;@$core.pragma('dart2js:noInline')
+static BurtLog create() => BurtLog._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
BurtLog createEmptyInstance() => create();@$pb.TagNumber(4)
+$1.Device get device => $_getN(3);@$pb.TagNumber(4)
+set device($1.Device v) { setField(4, v); }@$core.pragma('dart2js:noInline')
+static BurtLog getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<BurtLog>(create);@$pb.TagNumber(3)
+$core.bool hasBody() => $_has(2);@$pb.TagNumber(4)
+$core.bool hasDevice() => $_has(3);@$pb.TagNumber(1)
+$core.bool hasLevel() => $_has(0);@$pb.TagNumber(2)
+$core.bool hasTitle() => $_has(1);$pb.BuilderInfo get info_ => _i;@$pb.TagNumber(1)
+BurtLogLevel get level => $_getN(0);@$pb.TagNumber(1)
+set level(BurtLogLevel v) { setField(1, v); }@$pb.TagNumber(2)
+$core.String get title => $_getSZ(1);@$pb.TagNumber(2)
+set title($core.String v) { $_setString(1, v); }static const BurtLogLevel BURT_LOG_LEVEL_UNDEFINED = BurtLogLevel._(0, _omitEnumNames ? '' : 'BURT_LOG_LEVEL_UNDEFINED');static const BurtLogLevel critical = BurtLogLevel._(1, _omitEnumNames ? '' : 'critical');static const BurtLogLevel debug = BurtLogLevel._(5, _omitEnumNames ? '' : 'debug');static const BurtLogLevel error = BurtLogLevel._(2, _omitEnumNames ? '' : 'error');static const BurtLogLevel info = BurtLogLevel._(4, _omitEnumNames ? '' : 'info');static const BurtLogLevel trace = BurtLogLevel._(6, _omitEnumNames ? '' : 'trace');static BurtLogLevel? valueOf($core.int value) => _byValue[value];static const $core.List<BurtLogLevel> values = <BurtLogLevel> [
+ BURT_LOG_LEVEL_UNDEFINED,
+ critical,
+ error,
+ warning,
+ info,
+ debug,
+ trace,
+];static const BurtLogLevel warning = BurtLogLevel._(3, _omitEnumNames ? '' : 'warning');/ Details about a specific camera.
+true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory CameraDetails.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory CameraDetails.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory CameraDetails({
+ CameraName? name,
+ $core.int? resolutionWidth,
+ $core.int? resolutionHeight,
+ $core.int? quality,
+ $core.int? fps,
+ CameraStatus? status,
+ $core.bool? autofocus,
+ $core.int? zoom,
+ $core.int? pan,
+ $core.int? tilt,
+ $core.int? focus,
+}) {
+ final $result = create();
+ if (name != null) {
+ $result.name = name;
+ }
+ if (resolutionWidth != null) {
+ $result.resolutionWidth = resolutionWidth;
+ }
+ if (resolutionHeight != null) {
+ $result.resolutionHeight = resolutionHeight;
+ }
+ if (quality != null) {
+ $result.quality = quality;
+ }
+ if (fps != null) {
+ $result.fps = fps;
+ }
+ if (status != null) {
+ $result.status = status;
+ }
+ if (autofocus != null) {
+ $result.autofocus = autofocus;
+ }
+ if (zoom != null) {
+ $result.zoom = zoom;
+ }
+ if (pan != null) {
+ $result.pan = pan;
+ }
+ if (tilt != null) {
+ $result.tilt = tilt;
+ }
+ if (focus != null) {
+ $result.focus = focus;
+ }
+ return $result;
+}@$pb.TagNumber(7)
+$core.bool get autofocus => $_getBF(6);@$pb.TagNumber(7)
+set autofocus($core.bool v) { $_setBool(6, v); }@$pb.TagNumber(7)
+void clearAutofocus() => clearField(7);@$pb.TagNumber(11)
+void clearFocus() => clearField(11);@$pb.TagNumber(5)
+void clearFps() => clearField(5);@$pb.TagNumber(1)
+void clearName() => clearField(1);@$pb.TagNumber(9)
+void clearPan() => clearField(9);@$pb.TagNumber(4)
+void clearQuality() => clearField(4);@$pb.TagNumber(3)
+void clearResolutionHeight() => clearField(3);@$pb.TagNumber(2)
+void clearResolutionWidth() => clearField(2);@$pb.TagNumber(6)
+void clearStatus() => clearField(6);@$pb.TagNumber(10)
+void clearTilt() => clearField(10);@$pb.TagNumber(8)
+void clearZoom() => clearField(8);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+CameraDetails clone() => CameraDetails()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+CameraDetails copyWith(void Function(CameraDetails) updates) => super.copyWith((message) => updates(message as CameraDetails)) as CameraDetails;@$core.pragma('dart2js:noInline')
+static CameraDetails create() => CameraDetails._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
CameraDetails createEmptyInstance() => create();static $pb.PbList<CameraDetails> createRepeated() => $pb.PbList<CameraDetails>();@$pb.TagNumber(11)
+$core.int get focus => $_getIZ(10);@$pb.TagNumber(11)
+set focus($core.int v) { $_setSignedInt32(10, v); }/ The amount of frames per second. Eg, 60 FPS or 24 FPS.
+@$pb.TagNumber(5)
+$core.int get fps => $_getIZ(4);@$pb.TagNumber(5)
+set fps($core.int v) { $_setSignedInt32(4, v); }@$core.pragma('dart2js:noInline')
+static CameraDetails getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<CameraDetails>(create);@$pb.TagNumber(7)
+$core.bool hasAutofocus() => $_has(6);@$pb.TagNumber(11)
+$core.bool hasFocus() => $_has(10);@$pb.TagNumber(5)
+$core.bool hasFps() => $_has(4);@$pb.TagNumber(1)
+$core.bool hasName() => $_has(0);@$pb.TagNumber(9)
+$core.bool hasPan() => $_has(8);@$pb.TagNumber(4)
+$core.bool hasQuality() => $_has(3);@$pb.TagNumber(3)
+$core.bool hasResolutionHeight() => $_has(2);@$pb.TagNumber(2)
+$core.bool hasResolutionWidth() => $_has(1);@$pb.TagNumber(6)
+$core.bool hasStatus() => $_has(5);@$pb.TagNumber(10)
+$core.bool hasTilt() => $_has(9);@$pb.TagNumber(8)
+$core.bool hasZoom() => $_has(7);$pb.BuilderInfo get info_ => _i;/ The name of the camera.
+@$pb.TagNumber(1)
+CameraName get name => $_getN(0);@$pb.TagNumber(1)
+set name(CameraName v) { setField(1, v); }@$pb.TagNumber(9)
+$core.int get pan => $_getIZ(8);@$pb.TagNumber(9)
+set pan($core.int v) { $_setSignedInt32(8, v); }/ The quality of the frame, as a percentage. Used for JPG compression.
+@$pb.TagNumber(4)
+$core.int get quality => $_getIZ(3);@$pb.TagNumber(4)
+set quality($core.int v) { $_setSignedInt32(3, v); }@$pb.TagNumber(3)
+$core.int get resolutionHeight => $_getIZ(2);@$pb.TagNumber(3)
+set resolutionHeight($core.int v) { $_setSignedInt32(2, v); }/ The width and height of the image frame.
+@$pb.TagNumber(2)
+$core.int get resolutionWidth => $_getIZ(1);@$pb.TagNumber(2)
+set resolutionWidth($core.int v) { $_setSignedInt32(1, v); }/ The status of this camera.
+@$pb.TagNumber(6)
+CameraStatus get status => $_getN(5);@$pb.TagNumber(6)
+set status(CameraStatus v) { setField(6, v); }@$pb.TagNumber(10)
+$core.int get tilt => $_getIZ(9);@$pb.TagNumber(10)
+set tilt($core.int v) { $_setSignedInt32(9, v); }@$pb.TagNumber(8)
+$core.int get zoom => $_getIZ(7);@$pb.TagNumber(8)
+set zoom($core.int v) { $_setSignedInt32(7, v); }static const CameraName AUTONOMY_DEPTH = CameraName._(3, _omitEnumNames ? '' : 'AUTONOMY_DEPTH');static const CameraName CAMERA_NAME_UNDEFINED = CameraName._(0, _omitEnumNames ? '' : 'CAMERA_NAME_UNDEFINED');static const CameraName ROVER_FRONT = CameraName._(1, _omitEnumNames ? '' : 'ROVER_FRONT');static const CameraName ROVER_REAR = CameraName._(2, _omitEnumNames ? '' : 'ROVER_REAR');static const CameraName SUBSYSTEM1 = CameraName._(4, _omitEnumNames ? '' : 'SUBSYSTEM1');static const CameraName SUBSYSTEM2 = CameraName._(5, _omitEnumNames ? '' : 'SUBSYSTEM2');static const CameraName SUBSYSTEM3 = CameraName._(6, _omitEnumNames ? '' : 'SUBSYSTEM3');static CameraName? valueOf($core.int value) => _byValue[value];static const $core.List<CameraName> values = <CameraName> [
+ CAMERA_NAME_UNDEFINED,
+ ROVER_FRONT,
+ ROVER_REAR,
+ AUTONOMY_DEPTH,
+ SUBSYSTEM1,
+ SUBSYSTEM2,
+ SUBSYSTEM3,
+];Extensions for CameraName values.
+Gets a user-friendly name for a CameraName.
+String get humanName {
+ switch(this) {
+ case CameraName.CAMERA_NAME_UNDEFINED: return "";
+ case CameraName.ROVER_FRONT: return "Rover front";
+ case CameraName.ROVER_REAR: return "Rover rear";
+ case CameraName.AUTONOMY_DEPTH: return "Depth";
+ case CameraName.SUBSYSTEM1: return "Subsystem 1";
+ case CameraName.SUBSYSTEM2: return "Subsystem 2";
+ case CameraName.SUBSYSTEM3: return "Subsystem 3";
+ }
+ // Do not use default or else you'll lose exhaustiveness checking.
+ throw ArgumentError("Unrecognized camera name: $this");
+}static const CameraStatus CAMERA_DISABLED = CameraStatus._(3, _omitEnumNames ? '' : 'CAMERA_DISABLED');static const CameraStatus CAMERA_DISCONNECTED = CameraStatus._(1, _omitEnumNames ? '' : 'CAMERA_DISCONNECTED');static const CameraStatus CAMERA_ENABLED = CameraStatus._(2, _omitEnumNames ? '' : 'CAMERA_ENABLED');static const CameraStatus CAMERA_HAS_NO_NAME = CameraStatus._(7, _omitEnumNames ? '' : 'CAMERA_HAS_NO_NAME');static const CameraStatus CAMERA_LOADING = CameraStatus._(5, _omitEnumNames ? '' : 'CAMERA_LOADING');static const CameraStatus CAMERA_NOT_RESPONDING = CameraStatus._(4, _omitEnumNames ? '' : 'CAMERA_NOT_RESPONDING');static const CameraStatus CAMERA_STATUS_UNDEFINED = CameraStatus._(0, _omitEnumNames ? '' : 'CAMERA_STATUS_UNDEFINED');static const CameraStatus FRAME_TOO_LARGE = CameraStatus._(6, _omitEnumNames ? '' : 'FRAME_TOO_LARGE');static CameraStatus? valueOf($core.int value) => _byValue[value];static const $core.List<CameraStatus> values = <CameraStatus> [
+ CAMERA_STATUS_UNDEFINED,
+ CAMERA_DISCONNECTED,
+ CAMERA_ENABLED,
+ CAMERA_DISABLED,
+ CAMERA_NOT_RESPONDING,
+ CAMERA_LOADING,
+ FRAME_TOO_LARGE,
+ CAMERA_HAS_NO_NAME,
+];Extensions for CameraStatus values.
+Gets a user-friendly name for a CameraStatus.
+String get humanName {
+ switch(this) {
+ case CameraStatus.CAMERA_STATUS_UNDEFINED: return "";
+ case CameraStatus.CAMERA_DISCONNECTED: return "Disconnected";
+ case CameraStatus.CAMERA_ENABLED: return "Enabled";
+ case CameraStatus.CAMERA_DISABLED: return "Disabled";
+ case CameraStatus.CAMERA_NOT_RESPONDING: return "Not responding";
+ case CameraStatus.CAMERA_LOADING: return "Loading";
+ case CameraStatus.FRAME_TOO_LARGE: return "Frame too large";
+ case CameraStatus.CAMERA_HAS_NO_NAME: return "Camera has no name";
+ }
+ // Do not use default or else you'll lose exhaustiveness checking.
+ throw ArgumentError("Unrecognized rover status: $this");
+}Used for a simple handshake between devices.
+true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory Connect.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory Connect.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory Connect({
+ Device? sender,
+ Device? receiver,
+}) {
+ final $result = create();
+ if (sender != null) {
+ $result.sender = sender;
+ }
+ if (receiver != null) {
+ $result.receiver = receiver;
+ }
+ return $result;
+}@$pb.TagNumber(2)
+void clearReceiver() => clearField(2);@$pb.TagNumber(1)
+void clearSender() => clearField(1);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+Connect clone() => Connect()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+Connect copyWith(void Function(Connect) updates) => super.copyWith((message) => updates(message as Connect)) as Connect;@$core.pragma('dart2js:noInline')
+static Connect create() => Connect._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
Connect createEmptyInstance() => create();@$core.pragma('dart2js:noInline')
+static Connect getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<Connect>(create);@$pb.TagNumber(2)
+$core.bool hasReceiver() => $_has(1);@$pb.TagNumber(1)
+$core.bool hasSender() => $_has(0);$pb.BuilderInfo get info_ => _i;@$pb.TagNumber(2)
+Device get receiver => $_getN(1);@$pb.TagNumber(2)
+set receiver(Device v) { setField(2, v); }@$pb.TagNumber(1)
+Device get sender => $_getN(0);@$pb.TagNumber(1)
+set sender(Device v) { setField(1, v); }true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory Coordinates.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory Coordinates.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory Coordinates({
+ $core.double? x,
+ $core.double? y,
+ $core.double? z,
+}) {
+ final $result = create();
+ if (x != null) {
+ $result.x = x;
+ }
+ if (y != null) {
+ $result.y = y;
+ }
+ if (z != null) {
+ $result.z = z;
+ }
+ return $result;
+}@$pb.TagNumber(1)
+void clearX() => clearField(1);@$pb.TagNumber(2)
+void clearY() => clearField(2);@$pb.TagNumber(3)
+void clearZ() => clearField(3);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+Coordinates clone() => Coordinates()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+Coordinates copyWith(void Function(Coordinates) updates) => super.copyWith((message) => updates(message as Coordinates)) as Coordinates;@$core.pragma('dart2js:noInline')
+static Coordinates create() => Coordinates._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
Coordinates createEmptyInstance() => create();static $pb.PbList<Coordinates> createRepeated() => $pb.PbList<Coordinates>();@$core.pragma('dart2js:noInline')
+static Coordinates getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<Coordinates>(create);@$pb.TagNumber(1)
+$core.bool hasX() => $_has(0);@$pb.TagNumber(2)
+$core.bool hasY() => $_has(1);@$pb.TagNumber(3)
+$core.bool hasZ() => $_has(2);$pb.BuilderInfo get info_ => _i;@$pb.TagNumber(1)
+$core.double get x => $_getN(0);@$pb.TagNumber(1)
+set x($core.double v) { $_setFloat(0, v); }@$pb.TagNumber(2)
+$core.double get y => $_getN(1);@$pb.TagNumber(2)
+set y($core.double v) { $_setFloat(1, v); }@$pb.TagNumber(3)
+$core.double get z => $_getN(2);@$pb.TagNumber(3)
+set z($core.double v) { $_setFloat(2, v); }Extensions for Coordinates messages.
+Adds two coordinates.
+Coordinates operator +(Coordinates other) =>
+ Coordinates(x: x + other.x, y: y + other.y, z: z + other.z);Returns a user-friendly format of these coordinates.
+String get prettyPrint => "(${x.toStringAsFixed(2)}, ${y.toStringAsFixed(2)}, ${z.toStringAsFixed(2)})";Settings related to the dashboard itself, not the rover.
+Parses Dashboard settings from JSON.
+DashboardSettings.fromJson(Json? json) :
+ splitMode = SplitMode.values[json?["splitMode"] ?? SplitMode.horizontal.index],
+ mapBlockSize = json?["mapBlockSize"] ?? 1.0,
+ maxFps = (json?["maxFps"] ?? 60) as int,
+ themeMode = ThemeMode.values.byName(json?["theme"] ?? ThemeMode.system.name);A const constructor.
+const DashboardSettings({
+ required this.splitMode,
+ required this.mapBlockSize,
+ required this.maxFps,
+ required this.themeMode,
+});The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;The precision of the GPS grid.
+Since GPS coordinates are decimal values, we divide by this value to get the index of the cell +each coordinate belongs to. Smaller sizes means more blocks, but we should be careful that the +blocks are big enough to the margin of error of our GPS. This value must be synced with the +value in the autonomy program, or else the UI will not be accurate to the rover's logic.
+final double mapBlockSize;How many frames to render per second.
+This does not affect how many frames are sent by the rover per second.
+final int maxFps;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;How the Dashboard should split when only two views are present.
+final SplitMode splitMode;The theme of the Dashboard.
+final ThemeMode themeMode;Serializes these settings to JSON.
+Json toJson() => {
+ "splitMode": splitMode.index,
+ "mapBlockSize": mapBlockSize,
+ "maxFps": maxFps,
+ "theme": themeMode.name,
+};A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();Helpful extensions on DateTimes.
DateTime as a simple timestamp.
+ Formats this DateTime as a simple timestamp.
String get timeStamp => "$year-$month-$day-$hour-$minute";static const Device ARM = Device._(6, _omitEnumNames ? '' : 'ARM');static const Device AUTONOMY = Device._(4, _omitEnumNames ? '' : 'AUTONOMY');static const Device DASHBOARD = Device._(1, _omitEnumNames ? '' : 'DASHBOARD');static const Device DEVICE_UNDEFINED = Device._(0, _omitEnumNames ? '' : 'DEVICE_UNDEFINED');static const Device DRIVE = Device._(9, _omitEnumNames ? '' : 'DRIVE');static const Device FIRMWARE = Device._(5, _omitEnumNames ? '' : 'FIRMWARE');static const Device GRIPPER = Device._(7, _omitEnumNames ? '' : 'GRIPPER');static const Device SCIENCE = Device._(8, _omitEnumNames ? '' : 'SCIENCE');static const Device SUBSYSTEMS = Device._(2, _omitEnumNames ? '' : 'SUBSYSTEMS');static const Device VIDEO = Device._(3, _omitEnumNames ? '' : 'VIDEO');static Device? valueOf($core.int value) => _byValue[value];static const $core.List<Device> values = <Device> [
+ DEVICE_UNDEFINED,
+ DASHBOARD,
+ SUBSYSTEMS,
+ VIDEO,
+ AUTONOMY,
+ FIRMWARE,
+ ARM,
+ GRIPPER,
+ SCIENCE,
+ DRIVE,
+];Gets a user-friendly name for a Device.
+String get humanName {
+ switch(this) {
+ case Device.DEVICE_UNDEFINED: return "Unknown device";
+ case Device.DASHBOARD: return "Dashboard";
+ case Device.SUBSYSTEMS: return "Subsystems";
+ case Device.VIDEO: return "Video";
+ case Device.AUTONOMY: return "Autonomy";
+ case Device.FIRMWARE: return "Firmware";
+ case Device.ARM: return "Arm";
+ case Device.GRIPPER: return "Gripper";
+ case Device.SCIENCE: return "Science";
+ case Device.DRIVE: return "Drive";
+ }
+ // Do not use default or else you'll lose exhaustiveness checking.
+ throw ArgumentError("Unrecognized device: $this");
+}static const DirtReleaseState CLOSE_DIRT = DirtReleaseState._(2, _omitEnumNames ? '' : 'CLOSE_DIRT');static const DirtReleaseState DIRT_RELEASE_STATE_UNDEFINED = DirtReleaseState._(0, _omitEnumNames ? '' : 'DIRT_RELEASE_STATE_UNDEFINED');static const DirtReleaseState OPEN_DIRT = DirtReleaseState._(1, _omitEnumNames ? '' : 'OPEN_DIRT');static DirtReleaseState? valueOf($core.int value) => _byValue[value];static const $core.List<DirtReleaseState> values = <DirtReleaseState> [
+ DIRT_RELEASE_STATE_UNDEFINED,
+ OPEN_DIRT,
+ CLOSE_DIRT,
+];Notifies the recipient that the sender will no longer be connected.
+true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory Disconnect.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory Disconnect.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory Disconnect({
+ Device? sender,
+}) {
+ final $result = create();
+ if (sender != null) {
+ $result.sender = sender;
+ }
+ return $result;
+}@$pb.TagNumber(1)
+void clearSender() => clearField(1);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+Disconnect clone() => Disconnect()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+Disconnect copyWith(void Function(Disconnect) updates) => super.copyWith((message) => updates(message as Disconnect)) as Disconnect;@$core.pragma('dart2js:noInline')
+static Disconnect create() => Disconnect._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
Disconnect createEmptyInstance() => create();static $pb.PbList<Disconnect> createRepeated() => $pb.PbList<Disconnect>();@$core.pragma('dart2js:noInline')
+static Disconnect getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<Disconnect>(create);@$pb.TagNumber(1)
+$core.bool hasSender() => $_has(0);$pb.BuilderInfo get info_ => _i;@$pb.TagNumber(1)
+Device get sender => $_getN(0);@$pb.TagNumber(1)
+set sender(Device v) { setField(1, v); }true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory DriveCommand.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory DriveCommand.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory DriveCommand({
+ $core.double? throttle,
+ $core.double? left,
+ $core.double? right,
+ $core.bool? setLeft,
+ $core.bool? setRight,
+ $core.bool? setThrottle,
+ $core.double? frontSwivel,
+ $core.double? frontTilt,
+ $core.double? rearSwivel,
+ $core.double? rearTilt,
+ $1.RoverStatus? status,
+}) {
+ final $result = create();
+ if (throttle != null) {
+ $result.throttle = throttle;
+ }
+ if (left != null) {
+ $result.left = left;
+ }
+ if (right != null) {
+ $result.right = right;
+ }
+ if (setLeft != null) {
+ $result.setLeft = setLeft;
+ }
+ if (setRight != null) {
+ $result.setRight = setRight;
+ }
+ if (setThrottle != null) {
+ $result.setThrottle = setThrottle;
+ }
+ if (frontSwivel != null) {
+ $result.frontSwivel = frontSwivel;
+ }
+ if (frontTilt != null) {
+ $result.frontTilt = frontTilt;
+ }
+ if (rearSwivel != null) {
+ $result.rearSwivel = rearSwivel;
+ }
+ if (rearTilt != null) {
+ $result.rearTilt = rearTilt;
+ }
+ if (status != null) {
+ $result.status = status;
+ }
+ return $result;
+}@$pb.TagNumber(7)
+void clearFrontSwivel() => clearField(7);@$pb.TagNumber(8)
+void clearFrontTilt() => clearField(8);@$pb.TagNumber(2)
+void clearLeft() => clearField(2);@$pb.TagNumber(9)
+void clearRearSwivel() => clearField(9);@$pb.TagNumber(10)
+void clearRearTilt() => clearField(10);@$pb.TagNumber(3)
+void clearRight() => clearField(3);@$pb.TagNumber(4)
+void clearSetLeft() => clearField(4);@$pb.TagNumber(5)
+void clearSetRight() => clearField(5);@$pb.TagNumber(6)
+void clearSetThrottle() => clearField(6);@$pb.TagNumber(11)
+void clearStatus() => clearField(11);@$pb.TagNumber(1)
+void clearThrottle() => clearField(1);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+DriveCommand clone() => DriveCommand()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+DriveCommand copyWith(void Function(DriveCommand) updates) => super.copyWith((message) => updates(message as DriveCommand)) as DriveCommand;@$core.pragma('dart2js:noInline')
+static DriveCommand create() => DriveCommand._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
DriveCommand createEmptyInstance() => create();static $pb.PbList<DriveCommand> createRepeated() => $pb.PbList<DriveCommand>();@$pb.TagNumber(7)
+$core.double get frontSwivel => $_getN(6);@$pb.TagNumber(7)
+set frontSwivel($core.double v) { $_setFloat(6, v); }@$pb.TagNumber(8)
+$core.double get frontTilt => $_getN(7);@$pb.TagNumber(8)
+set frontTilt($core.double v) { $_setFloat(7, v); }@$core.pragma('dart2js:noInline')
+static DriveCommand getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<DriveCommand>(create);@$pb.TagNumber(7)
+$core.bool hasFrontSwivel() => $_has(6);@$pb.TagNumber(8)
+$core.bool hasFrontTilt() => $_has(7);@$pb.TagNumber(2)
+$core.bool hasLeft() => $_has(1);@$pb.TagNumber(9)
+$core.bool hasRearSwivel() => $_has(8);@$pb.TagNumber(10)
+$core.bool hasRearTilt() => $_has(9);@$pb.TagNumber(3)
+$core.bool hasRight() => $_has(2);@$pb.TagNumber(4)
+$core.bool hasSetLeft() => $_has(3);@$pb.TagNumber(5)
+$core.bool hasSetRight() => $_has(4);@$pb.TagNumber(6)
+$core.bool hasSetThrottle() => $_has(5);@$pb.TagNumber(11)
+$core.bool hasStatus() => $_has(10);@$pb.TagNumber(1)
+$core.bool hasThrottle() => $_has(0);$pb.BuilderInfo get info_ => _i;Speed of the left wheels, as a percentage of throttle.
+@$pb.TagNumber(2)
+$core.double get left => $_getN(1);@$pb.TagNumber(2)
+set left($core.double v) { $_setFloat(1, v); }@$pb.TagNumber(9)
+$core.double get rearSwivel => $_getN(8);@$pb.TagNumber(9)
+set rearSwivel($core.double v) { $_setFloat(8, v); }@$pb.TagNumber(10)
+$core.double get rearTilt => $_getN(9);@$pb.TagNumber(10)
+set rearTilt($core.double v) { $_setFloat(9, v); }Speed of the right wheels, as a percentage of throttle.
+@$pb.TagNumber(3)
+$core.double get right => $_getN(2);@$pb.TagNumber(3)
+set right($core.double v) { $_setFloat(2, v); }Indicates that left = 0 is valid, even though 0 usually means no value.
+@$pb.TagNumber(4)
+$core.bool get setLeft => $_getBF(3);@$pb.TagNumber(4)
+set setLeft($core.bool v) { $_setBool(3, v); }Indicates that right = 0 is valid, even though 0 usually means no value.
+@$pb.TagNumber(5)
+$core.bool get setRight => $_getBF(4);@$pb.TagNumber(5)
+set setRight($core.bool v) { $_setBool(4, v); }Indicates that throttle = 0 is valid, even though 0 usually means no value.
+@$pb.TagNumber(6)
+$core.bool get setThrottle => $_getBF(5);@$pb.TagNumber(6)
+set setThrottle($core.bool v) { $_setBool(5, v); }@$pb.TagNumber(11)
+$1.RoverStatus get status => $_getN(10);@$pb.TagNumber(11)
+set status($1.RoverStatus v) { setField(11, v); }The max speed, as a percentage of the rover's possible speed.
+@$pb.TagNumber(1)
+$core.double get throttle => $_getN(0);@$pb.TagNumber(1)
+set throttle($core.double v) { $_setFloat(0, v); }true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory DriveData.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory DriveData.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory DriveData({
+ $core.double? throttle,
+ $core.double? left,
+ $core.double? right,
+ $core.bool? setLeft,
+ $core.bool? setRight,
+ $core.bool? setThrottle,
+ $core.double? frontSwivel,
+ $core.double? frontTilt,
+ $core.double? rearSwivel,
+ $core.double? rearTilt,
+ $core.double? batteryVoltage,
+ $core.double? batteryCurrent,
+ $core.double? batteryTemperature,
+}) {
+ final $result = create();
+ if (throttle != null) {
+ $result.throttle = throttle;
+ }
+ if (left != null) {
+ $result.left = left;
+ }
+ if (right != null) {
+ $result.right = right;
+ }
+ if (setLeft != null) {
+ $result.setLeft = setLeft;
+ }
+ if (setRight != null) {
+ $result.setRight = setRight;
+ }
+ if (setThrottle != null) {
+ $result.setThrottle = setThrottle;
+ }
+ if (frontSwivel != null) {
+ $result.frontSwivel = frontSwivel;
+ }
+ if (frontTilt != null) {
+ $result.frontTilt = frontTilt;
+ }
+ if (rearSwivel != null) {
+ $result.rearSwivel = rearSwivel;
+ }
+ if (rearTilt != null) {
+ $result.rearTilt = rearTilt;
+ }
+ if (batteryVoltage != null) {
+ $result.batteryVoltage = batteryVoltage;
+ }
+ if (batteryCurrent != null) {
+ $result.batteryCurrent = batteryCurrent;
+ }
+ if (batteryTemperature != null) {
+ $result.batteryTemperature = batteryTemperature;
+ }
+ return $result;
+}@$pb.TagNumber(12)
+$core.double get batteryCurrent => $_getN(11);@$pb.TagNumber(12)
+set batteryCurrent($core.double v) { $_setFloat(11, v); }@$pb.TagNumber(13)
+$core.double get batteryTemperature => $_getN(12);@$pb.TagNumber(13)
+set batteryTemperature($core.double v) { $_setFloat(12, v); }Vitals for the whole rover
+@$pb.TagNumber(11)
+$core.double get batteryVoltage => $_getN(10);@$pb.TagNumber(11)
+set batteryVoltage($core.double v) { $_setFloat(10, v); }@$pb.TagNumber(12)
+void clearBatteryCurrent() => clearField(12);@$pb.TagNumber(13)
+void clearBatteryTemperature() => clearField(13);@$pb.TagNumber(11)
+void clearBatteryVoltage() => clearField(11);@$pb.TagNumber(7)
+void clearFrontSwivel() => clearField(7);@$pb.TagNumber(8)
+void clearFrontTilt() => clearField(8);@$pb.TagNumber(2)
+void clearLeft() => clearField(2);@$pb.TagNumber(9)
+void clearRearSwivel() => clearField(9);@$pb.TagNumber(10)
+void clearRearTilt() => clearField(10);@$pb.TagNumber(3)
+void clearRight() => clearField(3);@$pb.TagNumber(4)
+void clearSetLeft() => clearField(4);@$pb.TagNumber(5)
+void clearSetRight() => clearField(5);@$pb.TagNumber(6)
+void clearSetThrottle() => clearField(6);@$pb.TagNumber(1)
+void clearThrottle() => clearField(1);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+DriveData clone() => DriveData()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+DriveData copyWith(void Function(DriveData) updates) => super.copyWith((message) => updates(message as DriveData)) as DriveData;@$core.pragma('dart2js:noInline')
+static DriveData create() => DriveData._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
DriveData createEmptyInstance() => create();@$pb.TagNumber(7)
+$core.double get frontSwivel => $_getN(6);@$pb.TagNumber(7)
+set frontSwivel($core.double v) { $_setFloat(6, v); }@$pb.TagNumber(8)
+$core.double get frontTilt => $_getN(7);@$pb.TagNumber(8)
+set frontTilt($core.double v) { $_setFloat(7, v); }@$core.pragma('dart2js:noInline')
+static DriveData getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<DriveData>(create);@$pb.TagNumber(12)
+$core.bool hasBatteryCurrent() => $_has(11);@$pb.TagNumber(13)
+$core.bool hasBatteryTemperature() => $_has(12);@$pb.TagNumber(11)
+$core.bool hasBatteryVoltage() => $_has(10);@$pb.TagNumber(7)
+$core.bool hasFrontSwivel() => $_has(6);@$pb.TagNumber(8)
+$core.bool hasFrontTilt() => $_has(7);@$pb.TagNumber(2)
+$core.bool hasLeft() => $_has(1);@$pb.TagNumber(9)
+$core.bool hasRearSwivel() => $_has(8);@$pb.TagNumber(10)
+$core.bool hasRearTilt() => $_has(9);@$pb.TagNumber(3)
+$core.bool hasRight() => $_has(2);@$pb.TagNumber(4)
+$core.bool hasSetLeft() => $_has(3);@$pb.TagNumber(5)
+$core.bool hasSetRight() => $_has(4);@$pb.TagNumber(6)
+$core.bool hasSetThrottle() => $_has(5);@$pb.TagNumber(1)
+$core.bool hasThrottle() => $_has(0);$pb.BuilderInfo get info_ => _i;Speed of the left wheels, as a percentage of throttle.
+@$pb.TagNumber(2)
+$core.double get left => $_getN(1);@$pb.TagNumber(2)
+set left($core.double v) { $_setFloat(1, v); }@$pb.TagNumber(9)
+$core.double get rearSwivel => $_getN(8);@$pb.TagNumber(9)
+set rearSwivel($core.double v) { $_setFloat(8, v); }@$pb.TagNumber(10)
+$core.double get rearTilt => $_getN(9);@$pb.TagNumber(10)
+set rearTilt($core.double v) { $_setFloat(9, v); }Speed of the right wheels, as a percentage of throttle.
+@$pb.TagNumber(3)
+$core.double get right => $_getN(2);@$pb.TagNumber(3)
+set right($core.double v) { $_setFloat(2, v); }Indicates that left = 0 is valid, even though 0 usually means no value.
+@$pb.TagNumber(4)
+$core.bool get setLeft => $_getBF(3);@$pb.TagNumber(4)
+set setLeft($core.bool v) { $_setBool(3, v); }Indicates that right = 0 is valid, even though 0 usually means no value.
+@$pb.TagNumber(5)
+$core.bool get setRight => $_getBF(4);@$pb.TagNumber(5)
+set setRight($core.bool v) { $_setBool(4, v); }Indicates that throttle = 0 is valid, even though 0 usually means no value.
+@$pb.TagNumber(6)
+$core.bool get setThrottle => $_getBF(5);@$pb.TagNumber(6)
+set setThrottle($core.bool v) { $_setBool(5, v); }The max speed, as a percentage of the rover's possible speed.
+@$pb.TagNumber(1)
+$core.double get throttle => $_getN(0);@$pb.TagNumber(1)
+set throttle($core.double v) { $_setFloat(0, v); }Metrics reported by the drive subsystem.
+In the future, the drive Teensy will have a GPS and IMU to read RoverPosition data. For now, +this information is sent separately and is represented by its own RoverPosition object because +they are collected on the Pi. In the future, when they are moved to the Drive subsystem, this +data should still be kept separate so as to make it easier to show in the UI and send to MARS.
+A collection of metrics relevant for monitoring the rover's electrical status.
+DriveMetrics() : super(DriveData());A list of user-friendly explanations for each of the metrics.
+Be sure to store the actual values as fields. This property should be a list of one +user-friendly explanation per metric.
+@override
+List<MetricLine> get allMetrics => [
+ MetricLine("Throttle: ${data.throttle.toStringAsFixed(2)}", severity: throttleSeverity),
+ MetricLine("Left: ${data.left.toStringAsFixed(2)}"),
+ MetricLine("Right: ${data.right.toStringAsFixed(2)}"),
+ MetricLine("Battery: ${data.batteryVoltage.toStringAsFixed(2)}V,${data.batteryCurrent.toStringAsFixed(2)}A, ${data.batteryTemperature.toStringAsFixed(2)}°F", severity: electricalSeverity),
+];The charge of the battery, as a percentage.
+double get batteryPercentage => (batteryVoltage - 24) / 6;The battery voltage.
+double get batteryVoltage => data.batteryVoltage;The severity for the electrical metrics.
+Severity? get electricalSeverity {
+ if (data.batteryVoltage == 0) return null;
+ if (data.batteryVoltage <= 25) {
+ return Severity.critical;
+ } else if (data.batteryVoltage <= 26) {
+ return Severity.warning;
+ } else {
+ return null;
+ }
+}A collective name for this group of metrics (usually the name of the subsystem).
+@override
+String get name => "Drive";The severity based on the throttle speed.
+Severity? get throttleSeverity {
+ if (data.throttle == 0) {
+ return null;
+ } else if (data.throttle <= 0.3) {
+ return Severity.info;
+ } else if (data.throttle <= 0.75) {
+ return Severity.warning;
+ } else {
+ return Severity.critical;
+ }
+}Updates data with new data.
+@override
+void update(DriveData value) {
+ // Since the newValues are often zero, [Metrics.merge] won't work.
+ if (value.setLeft) data.left = value.left;
+ if (value.setRight) data.right = value.right;
+ if (value.setThrottle) data.throttle = value.throttle;
+ if (value.hasBatteryCurrent()) data.batteryCurrent = value.batteryCurrent;
+ if (value.hasBatteryVoltage()) data.batteryVoltage = value.batteryVoltage;
+ if (value.hasBatteryTemperature()) data.batteryTemperature = value.batteryTemperature;
+ notifyListeners();
+}Settings relating to easter eggs.
+Implement these! Ask Levi for details.
+Parses easter eggs settings from JSON.
+EasterEggsSettings.fromJson(Json? json) :
+ segaIntro = json?["segaIntro"] ?? true,
+ segaSound = json?["segaSound"] ?? true,
+ enableClippy = json?["enableClippy"] ?? true,
+ badApple = json?["badApple"] ?? true;A const constructor.
+const EasterEggsSettings({
+ required this.segaIntro,
+ required this.segaSound,
+ required this.enableClippy,
+ required this.badApple,
+});Whether to render Bad Apple in the Map page.
+final bool badApple;Whether clippy should appear by log messages.
+final bool enableClippy;The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;Whether to do a SEGA-like intro during boot.
+final bool segaIntro;Whether to say "Binghamton" in the SEGA style.
+final bool segaSound;Serializes these settings to JSON.
+Json toJson() => {
+ "segaIntro": segaIntro,
+ "segaSound": segaSound,
+ "enableClippy": enableClippy,
+ "badApple": badApple,
+};A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory GpsCoordinates.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory GpsCoordinates.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory GpsCoordinates({
+ $core.double? latitude,
+ $core.double? longitude,
+ $core.double? altitude,
+}) {
+ final $result = create();
+ if (latitude != null) {
+ $result.latitude = latitude;
+ }
+ if (longitude != null) {
+ $result.longitude = longitude;
+ }
+ if (altitude != null) {
+ $result.altitude = altitude;
+ }
+ return $result;
+}@$pb.TagNumber(3)
+$core.double get altitude => $_getN(2);@$pb.TagNumber(3)
+set altitude($core.double v) { $_setFloat(2, v); }@$pb.TagNumber(3)
+void clearAltitude() => clearField(3);@$pb.TagNumber(1)
+void clearLatitude() => clearField(1);@$pb.TagNumber(2)
+void clearLongitude() => clearField(2);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+GpsCoordinates clone() => GpsCoordinates()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+GpsCoordinates copyWith(void Function(GpsCoordinates) updates) => super.copyWith((message) => updates(message as GpsCoordinates)) as GpsCoordinates;@$core.pragma('dart2js:noInline')
+static GpsCoordinates create() => GpsCoordinates._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
GpsCoordinates createEmptyInstance() => create();static $pb.PbList<GpsCoordinates> createRepeated() => $pb.PbList<GpsCoordinates>();@$core.pragma('dart2js:noInline')
+static GpsCoordinates getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<GpsCoordinates>(create);@$pb.TagNumber(3)
+$core.bool hasAltitude() => $_has(2);@$pb.TagNumber(1)
+$core.bool hasLatitude() => $_has(0);@$pb.TagNumber(2)
+$core.bool hasLongitude() => $_has(1);$pb.BuilderInfo get info_ => _i;@$pb.TagNumber(1)
+$core.double get latitude => $_getN(0);@$pb.TagNumber(1)
+set latitude($core.double v) { $_setFloat(0, v); }@$pb.TagNumber(2)
+$core.double get longitude => $_getN(1);@$pb.TagNumber(2)
+set longitude($core.double v) { $_setFloat(1, v); }Utilities for Gps Coordinates Data
+Calculate Euclidean distance between current coordinates and another set of coordinates.
+See https://en.wikipedia.org/wiki/Geographic_coordinate_system#Length_of_a_degree
+double distanceTo(GpsCoordinates other) {
+ // Convert to distance in meters and use Pythagorean theorem
+ final latitudeDistance = 111132.92 - 559.82*cos(2*latitude) + 1.175*cos(4*latitude) - 0.0023*cos(6*latitude);
+ final longitudeDistance = 111412.84*cos(latitude) - 93.5*cos(3*latitude) + 0.118*cos(5*latitude);
+ return pow(
+ pow((latitude - other.latitude)*latitudeDistance, 2)
+ + pow((longitude - other.longitude)*longitudeDistance, 2)
+ + pow(altitude - other.altitude, 2),
+ 0.5,
+ ).toDouble();
+}true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory GripperCommand.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory GripperCommand.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory GripperCommand({
+ $core.bool? stop,
+ $core.bool? calibrate,
+ MotorCommand? lift,
+ MotorCommand? rotate,
+ MotorCommand? pinch,
+ $core.bool? open,
+ $core.bool? close,
+ $core.bool? spin,
+}) {
+ final $result = create();
+ if (stop != null) {
+ $result.stop = stop;
+ }
+ if (calibrate != null) {
+ $result.calibrate = calibrate;
+ }
+ if (lift != null) {
+ $result.lift = lift;
+ }
+ if (rotate != null) {
+ $result.rotate = rotate;
+ }
+ if (pinch != null) {
+ $result.pinch = pinch;
+ }
+ if (open != null) {
+ $result.open = open;
+ }
+ if (close != null) {
+ $result.close = close;
+ }
+ if (spin != null) {
+ $result.spin = spin;
+ }
+ return $result;
+}@$pb.TagNumber(2)
+$core.bool get calibrate => $_getBF(1);@$pb.TagNumber(2)
+set calibrate($core.bool v) { $_setBool(1, v); }@$pb.TagNumber(2)
+void clearCalibrate() => clearField(2);@$pb.TagNumber(7)
+void clearClose() => clearField(7);@$pb.TagNumber(3)
+void clearLift() => clearField(3);@$pb.TagNumber(6)
+void clearOpen() => clearField(6);@$pb.TagNumber(5)
+void clearPinch() => clearField(5);@$pb.TagNumber(4)
+void clearRotate() => clearField(4);@$pb.TagNumber(8)
+void clearSpin() => clearField(8);@$pb.TagNumber(1)
+void clearStop() => clearField(1);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+GripperCommand clone() => GripperCommand()..mergeFromMessage(this);@$pb.TagNumber(7)
+$core.bool get close => $_getBF(6);@$pb.TagNumber(7)
+set close($core.bool v) { $_setBool(6, v); }Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+GripperCommand copyWith(void Function(GripperCommand) updates) => super.copyWith((message) => updates(message as GripperCommand)) as GripperCommand;@$core.pragma('dart2js:noInline')
+static GripperCommand create() => GripperCommand._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
GripperCommand createEmptyInstance() => create();static $pb.PbList<GripperCommand> createRepeated() => $pb.PbList<GripperCommand>();@$pb.TagNumber(3)
+MotorCommand ensureLift() => $_ensure(2);@$pb.TagNumber(5)
+MotorCommand ensurePinch() => $_ensure(4);@$pb.TagNumber(4)
+MotorCommand ensureRotate() => $_ensure(3);@$core.pragma('dart2js:noInline')
+static GripperCommand getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<GripperCommand>(create);@$pb.TagNumber(2)
+$core.bool hasCalibrate() => $_has(1);@$pb.TagNumber(7)
+$core.bool hasClose() => $_has(6);@$pb.TagNumber(3)
+$core.bool hasLift() => $_has(2);@$pb.TagNumber(6)
+$core.bool hasOpen() => $_has(5);@$pb.TagNumber(5)
+$core.bool hasPinch() => $_has(4);@$pb.TagNumber(4)
+$core.bool hasRotate() => $_has(3);@$pb.TagNumber(8)
+$core.bool hasSpin() => $_has(7);@$pb.TagNumber(1)
+$core.bool hasStop() => $_has(0);$pb.BuilderInfo get info_ => _i;Move individual motors
+@$pb.TagNumber(3)
+MotorCommand get lift => $_getN(2);@$pb.TagNumber(3)
+set lift(MotorCommand v) { setField(3, v); }Custom actions
+@$pb.TagNumber(6)
+$core.bool get open => $_getBF(5);@$pb.TagNumber(6)
+set open($core.bool v) { $_setBool(5, v); }@$pb.TagNumber(5)
+MotorCommand get pinch => $_getN(4);@$pb.TagNumber(5)
+set pinch(MotorCommand v) { setField(5, v); }@$pb.TagNumber(4)
+MotorCommand get rotate => $_getN(3);@$pb.TagNumber(4)
+set rotate(MotorCommand v) { setField(4, v); }@$pb.TagNumber(8)
+$core.bool get spin => $_getBF(7);@$pb.TagNumber(8)
+set spin($core.bool v) { $_setBool(7, v); }General commands
+@$pb.TagNumber(1)
+$core.bool get stop => $_getBF(0);@$pb.TagNumber(1)
+set stop($core.bool v) { $_setBool(0, v); }true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory GripperData.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory GripperData.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory GripperData({
+ MotorData? lift,
+ MotorData? rotate,
+ MotorData? pinch,
+}) {
+ final $result = create();
+ if (lift != null) {
+ $result.lift = lift;
+ }
+ if (rotate != null) {
+ $result.rotate = rotate;
+ }
+ if (pinch != null) {
+ $result.pinch = pinch;
+ }
+ return $result;
+}@$pb.TagNumber(1)
+void clearLift() => clearField(1);@$pb.TagNumber(3)
+void clearPinch() => clearField(3);@$pb.TagNumber(2)
+void clearRotate() => clearField(2);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+GripperData clone() => GripperData()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+GripperData copyWith(void Function(GripperData) updates) => super.copyWith((message) => updates(message as GripperData)) as GripperData;@$core.pragma('dart2js:noInline')
+static GripperData create() => GripperData._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
GripperData createEmptyInstance() => create();static $pb.PbList<GripperData> createRepeated() => $pb.PbList<GripperData>();@$core.pragma('dart2js:noInline')
+static GripperData getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<GripperData>(create);@$pb.TagNumber(1)
+$core.bool hasLift() => $_has(0);@$pb.TagNumber(3)
+$core.bool hasPinch() => $_has(2);@$pb.TagNumber(2)
+$core.bool hasRotate() => $_has(1);$pb.BuilderInfo get info_ => _i;@$pb.TagNumber(1)
+MotorData get lift => $_getN(0);@$pb.TagNumber(1)
+set lift(MotorData v) { setField(1, v); }@$pb.TagNumber(3)
+MotorData get pinch => $_getN(2);@$pb.TagNumber(3)
+set pinch(MotorData v) { setField(3, v); }@$pb.TagNumber(2)
+MotorData get rotate => $_getN(1);@$pb.TagNumber(2)
+set rotate(MotorData v) { setField(2, v); }Metrics about the gripper on the HREI subsystem.
+Metrics about the gripper.
+GripperMetrics() : super(GripperData());A list of user-friendly explanations for each of the metrics.
+Be sure to store the actual values as fields. This property should be a list of one +user-friendly explanation per metric.
+@override
+List<MetricLine> get allMetrics => [
+ MetricLine("Lift:"),
+ ...getMotorData(data.lift,),
+ MetricLine("------------------------------",),
+ MetricLine("Rotate"),
+ ...getMotorData(data.rotate),
+ MetricLine("------------------------------",),
+ MetricLine("Pinch:"),
+ ...getMotorData(data.pinch),
+];Returns a description of a MotorData.
+List<MetricLine> getMotorData(MotorData motor) => [
+ MetricLine(" Is moving? ${motor.isMoving}", severity: motor.isMoving ? Severity.info : null),
+ MetricLine(" Limit? ${motor.isLimitSwitchPressed}", severity: motor.isLimitSwitchPressed ? Severity.warning : null),
+ MetricLine(" Direction: ${motor.direction.humanName}"),
+ MetricLine(" Steps: ${motor.currentStep} --> ${motor.targetStep}"),
+ MetricLine(" Angle: ${motor.angle.toDegrees()} degrees"),
+];A collective name for this group of metrics (usually the name of the subsystem).
+@override
+String get name => "Gripper";JSON data as a map.
+typedef Json = Map<String, dynamic>;A list that can manage its own length.
+element to this list and pops an element to keep the total length within limit.
+
+
+Adds element to this list and pops an element to keep the total length within limit.
void pushWithLimit(E element, int limit) {
+ if (length >= limit) removeFirst();
+ addLast(element);
+}Formats BurtLog messages in plain-text. For the UI, use widgets.
+String format() {
+ final result = StringBuffer()
+ ..write(level.label)
+ ..write(" ")
+ ..write(title);
+ if (body.isNotEmpty) {
+ result..write("\n ")..write(body);
+ }
+ return result.toString();
+}More human-friendly fields for BurtLogLevels.
+The human-readable name of this level.
+String get humanName => switch(this) {
+ BurtLogLevel.critical => "Critical",
+ BurtLogLevel.error => "Error",
+ BurtLogLevel.warning => "Warning",
+ BurtLogLevel.info => "Info",
+ BurtLogLevel.debug => "Debug",
+ BurtLogLevel.trace => "Trace",
+ _ => "Unknown",
+};The label to represent this log.
+String get label => switch(this) {
+ BurtLogLevel.critical => "[C]",
+ BurtLogLevel.error => "[E]",
+ BurtLogLevel.warning => "[W]",
+ BurtLogLevel.info => "[I]",
+ BurtLogLevel.debug => "[D]",
+ BurtLogLevel.trace => "[T]",
+ _ => "?",
+};Helpful extensions on maps.
+entries.
+ A list of key-value records in this map. Allows easier iteration than entries.
Iterable<(K, V)> get records sync* {
+ for (final entry in entries) {
+ yield (entry.key, entry.value);
+ }
+}true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory MarsCommand.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory MarsCommand.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory MarsCommand({
+ $core.double? swivel,
+ $core.double? tilt,
+ $0.GpsCoordinates? rover,
+ $0.GpsCoordinates? baseStationOverride,
+}) {
+ final $result = create();
+ if (swivel != null) {
+ $result.swivel = swivel;
+ }
+ if (tilt != null) {
+ $result.tilt = tilt;
+ }
+ if (rover != null) {
+ $result.rover = rover;
+ }
+ if (baseStationOverride != null) {
+ $result.baseStationOverride = baseStationOverride;
+ }
+ return $result;
+}@$pb.TagNumber(4)
+$0.GpsCoordinates get baseStationOverride => $_getN(3);@$pb.TagNumber(4)
+set baseStationOverride($0.GpsCoordinates v) { setField(4, v); }@$pb.TagNumber(4)
+void clearBaseStationOverride() => clearField(4);@$pb.TagNumber(3)
+void clearRover() => clearField(3);@$pb.TagNumber(1)
+void clearSwivel() => clearField(1);@$pb.TagNumber(2)
+void clearTilt() => clearField(2);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+MarsCommand clone() => MarsCommand()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+MarsCommand copyWith(void Function(MarsCommand) updates) => super.copyWith((message) => updates(message as MarsCommand)) as MarsCommand;@$core.pragma('dart2js:noInline')
+static MarsCommand create() => MarsCommand._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
MarsCommand createEmptyInstance() => create();static $pb.PbList<MarsCommand> createRepeated() => $pb.PbList<MarsCommand>();@$pb.TagNumber(4)
+$0.GpsCoordinates ensureBaseStationOverride() => $_ensure(3);@$pb.TagNumber(3)
+$0.GpsCoordinates ensureRover() => $_ensure(2);@$core.pragma('dart2js:noInline')
+static MarsCommand getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<MarsCommand>(create);@$pb.TagNumber(4)
+$core.bool hasBaseStationOverride() => $_has(3);@$pb.TagNumber(3)
+$core.bool hasRover() => $_has(2);@$pb.TagNumber(1)
+$core.bool hasSwivel() => $_has(0);@$pb.TagNumber(2)
+$core.bool hasTilt() => $_has(1);$pb.BuilderInfo get info_ => _i;Automatic control
+@$pb.TagNumber(3)
+$0.GpsCoordinates get rover => $_getN(2);@$pb.TagNumber(3)
+set rover($0.GpsCoordinates v) { setField(3, v); }Manual control
+@$pb.TagNumber(1)
+$core.double get swivel => $_getN(0);@$pb.TagNumber(1)
+set swivel($core.double v) { $_setFloat(0, v); }@$pb.TagNumber(2)
+$core.double get tilt => $_getN(1);@$pb.TagNumber(2)
+set tilt($core.double v) { $_setFloat(1, v); }true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory MarsData.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory MarsData.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory MarsData({
+ $core.double? swivel,
+ $core.double? tilt,
+ $0.GpsCoordinates? coordinates,
+ MarsStatus? status,
+}) {
+ final $result = create();
+ if (swivel != null) {
+ $result.swivel = swivel;
+ }
+ if (tilt != null) {
+ $result.tilt = tilt;
+ }
+ if (coordinates != null) {
+ $result.coordinates = coordinates;
+ }
+ if (status != null) {
+ $result.status = status;
+ }
+ return $result;
+}@$pb.TagNumber(3)
+void clearCoordinates() => clearField(3);@$pb.TagNumber(4)
+void clearStatus() => clearField(4);@$pb.TagNumber(1)
+void clearSwivel() => clearField(1);@$pb.TagNumber(2)
+void clearTilt() => clearField(2);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+MarsData clone() => MarsData()..mergeFromMessage(this);@$pb.TagNumber(3)
+$0.GpsCoordinates get coordinates => $_getN(2);@$pb.TagNumber(3)
+set coordinates($0.GpsCoordinates v) { setField(3, v); }Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+MarsData copyWith(void Function(MarsData) updates) => super.copyWith((message) => updates(message as MarsData)) as MarsData;@$core.pragma('dart2js:noInline')
+static MarsData create() => MarsData._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
MarsData createEmptyInstance() => create();@$pb.TagNumber(3)
+$0.GpsCoordinates ensureCoordinates() => $_ensure(2);@$core.pragma('dart2js:noInline')
+static MarsData getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<MarsData>(create);@$pb.TagNumber(3)
+$core.bool hasCoordinates() => $_has(2);@$pb.TagNumber(4)
+$core.bool hasStatus() => $_has(3);@$pb.TagNumber(1)
+$core.bool hasSwivel() => $_has(0);@$pb.TagNumber(2)
+$core.bool hasTilt() => $_has(1);$pb.BuilderInfo get info_ => _i;@$pb.TagNumber(4)
+MarsStatus get status => $_getN(3);@$pb.TagNumber(4)
+set status(MarsStatus v) { setField(4, v); }@$pb.TagNumber(1)
+$core.double get swivel => $_getN(0);@$pb.TagNumber(1)
+set swivel($core.double v) { $_setFloat(0, v); }@$pb.TagNumber(2)
+$core.double get tilt => $_getN(1);@$pb.TagNumber(2)
+set tilt($core.double v) { $_setFloat(1, v); }static const MarsStatus FAILED_HANDSHAKE = MarsStatus._(3, _omitEnumNames ? '' : 'FAILED_HANDSHAKE');static const MarsStatus MARS_STATUS_UNDEFINED = MarsStatus._(0, _omitEnumNames ? '' : 'MARS_STATUS_UNDEFINED');static const MarsStatus PORT_NOT_FOUND = MarsStatus._(1, _omitEnumNames ? '' : 'PORT_NOT_FOUND');static const MarsStatus TEENSY_CONNECTED = MarsStatus._(4, _omitEnumNames ? '' : 'TEENSY_CONNECTED');static const MarsStatus TEENSY_UNRESPONSIVE = MarsStatus._(2, _omitEnumNames ? '' : 'TEENSY_UNRESPONSIVE');static MarsStatus? valueOf($core.int value) => _byValue[value];static const $core.List<MarsStatus> values = <MarsStatus> [
+ MARS_STATUS_UNDEFINED,
+ PORT_NOT_FOUND,
+ TEENSY_UNRESPONSIVE,
+ FAILED_HANDSHAKE,
+ TEENSY_CONNECTED,
+];Utilities for MarsStatuses.
+The human-readable name of the status
+String get humanName {
+ switch (this) {
+ case MarsStatus.MARS_STATUS_UNDEFINED: return "Not available";
+ case MarsStatus.PORT_NOT_FOUND: return "Could not open port";
+ case MarsStatus.TEENSY_UNRESPONSIVE: return "Teensy unresponsive";
+ case MarsStatus.FAILED_HANDSHAKE: return "Failed handshake";
+ case MarsStatus.TEENSY_CONNECTED: return "Connected";
+ }
+ // Do not use default or else you'll lose exhaustiveness checking.
+ throw ArgumentError("Unrecognized MarsStatus: $this");
+}A cleaner name for any message generated by Protobuf.
+typedef Message = proto.GeneratedMessage;A function that decodes a Protobuf messages serialized form.
+The .fromBuffer constructor is a type of MessageDecoder.
typedef MessageDecoder<T extends Message> = T Function(List<int> data);A callback to execute with a specific serialized Protobuf message.
+typedef MessageHandler<T extends Message> = void Function(T);Defines a friendlier method for getting the name of a message.
+The name of the message as declared in the .proto file.
+String get messageName => info_.messageName;Returns a WrappedMessage representing this message with a timestamp
+WrappedMessage wrap([DateTime? timestamp]) => WrappedMessage(
+ data: writeToBuffer(),
+ name: messageName,
+ timestamp: Timestamp.fromDateTime(timestamp ?? DateTime.now()),
+);Class to construct a Metric
+Constructor for the MetricLine class
+MetricLine(this.text, {this.severity});The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;Severity of the Metric
+final Severity? severity;Message for the Metric
+final String text;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();A readout of metrics reported by one of the rover's subsystems.
+To use this class, create a subclass that extends this class with T as the generated
+Protobuf class. For example, to create metrics for the science subsystem, use:
class ScienceMetrics extends Metrics<ScienceMessage> { }
+A const constructor for metrics.
+Metrics(this.data);A list of user-friendly explanations for each of the metrics.
+Be sure to store the actual values as fields. This property should be a list of one +user-friendly explanation per metric.
+List<MetricLine> get allMetrics;The underlying data used to get these metrics.
+final T data;A collective name for this group of metrics (usually the name of the subsystem).
+String get name;Fetch the overall Security
+Severity? get overallSeverity {
+ final indexes = [for (final metric in allMetrics) metric.severity?.index ?? -1];
+ final index = indexes.reduce(max);
+ if (index == -1) return null;
+ return Severity.values[index];
+ }Updates data with new data.
+void update(T value) {
+ data.mergeFromMessage(value);
+ notifyListeners();
+ services.files.logData(value);
+}true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory MotorCommand.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory MotorCommand.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory MotorCommand({
+ $core.int? moveSteps,
+ $core.double? moveRadians,
+}) {
+ final $result = create();
+ if (moveSteps != null) {
+ $result.moveSteps = moveSteps;
+ }
+ if (moveRadians != null) {
+ $result.moveRadians = moveRadians;
+ }
+ return $result;
+}@$pb.TagNumber(2)
+void clearMoveRadians() => clearField(2);@$pb.TagNumber(1)
+void clearMoveSteps() => clearField(1);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+MotorCommand clone() => MotorCommand()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+MotorCommand copyWith(void Function(MotorCommand) updates) => super.copyWith((message) => updates(message as MotorCommand)) as MotorCommand;@$core.pragma('dart2js:noInline')
+static MotorCommand create() => MotorCommand._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
MotorCommand createEmptyInstance() => create();static $pb.PbList<MotorCommand> createRepeated() => $pb.PbList<MotorCommand>();@$core.pragma('dart2js:noInline')
+static MotorCommand getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<MotorCommand>(create);@$pb.TagNumber(2)
+$core.bool hasMoveRadians() => $_has(1);@$pb.TagNumber(1)
+$core.bool hasMoveSteps() => $_has(0);$pb.BuilderInfo get info_ => _i;Precise control: Move by radians
+@$pb.TagNumber(2)
+$core.double get moveRadians => $_getN(1);@$pb.TagNumber(2)
+set moveRadians($core.double v) { $_setFloat(1, v); }Debug control: Move by individual steps
+@$pb.TagNumber(1)
+$core.int get moveSteps => $_getIZ(0);@$pb.TagNumber(1)
+set moveSteps($core.int v) { $_setSignedInt32(0, v); }true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory MotorData.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory MotorData.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory MotorData({
+ $core.bool? isMoving,
+ $core.bool? isLimitSwitchPressed,
+ MotorDirection? direction,
+ $core.int? currentStep,
+ $core.int? targetStep,
+ $core.double? angle,
+}) {
+ final $result = create();
+ if (isMoving != null) {
+ $result.isMoving = isMoving;
+ }
+ if (isLimitSwitchPressed != null) {
+ $result.isLimitSwitchPressed = isLimitSwitchPressed;
+ }
+ if (direction != null) {
+ $result.direction = direction;
+ }
+ if (currentStep != null) {
+ $result.currentStep = currentStep;
+ }
+ if (targetStep != null) {
+ $result.targetStep = targetStep;
+ }
+ if (angle != null) {
+ $result.angle = angle;
+ }
+ return $result;
+}@$pb.TagNumber(6)
+$core.double get angle => $_getN(5);@$pb.TagNumber(6)
+set angle($core.double v) { $_setFloat(5, v); }@$pb.TagNumber(6)
+void clearAngle() => clearField(6);@$pb.TagNumber(4)
+void clearCurrentStep() => clearField(4);@$pb.TagNumber(3)
+void clearDirection() => clearField(3);@$pb.TagNumber(2)
+void clearIsLimitSwitchPressed() => clearField(2);@$pb.TagNumber(1)
+void clearIsMoving() => clearField(1);@$pb.TagNumber(5)
+void clearTargetStep() => clearField(5);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+MotorData clone() => MotorData()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+MotorData copyWith(void Function(MotorData) updates) => super.copyWith((message) => updates(message as MotorData)) as MotorData;@$core.pragma('dart2js:noInline')
+static MotorData create() => MotorData._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
MotorData createEmptyInstance() => create();@$pb.TagNumber(4)
+$core.int get currentStep => $_getIZ(3);@$pb.TagNumber(4)
+set currentStep($core.int v) { $_setSignedInt32(3, v); }@$pb.TagNumber(3)
+MotorDirection get direction => $_getN(2);@$pb.TagNumber(3)
+set direction(MotorDirection v) { setField(3, v); }@$core.pragma('dart2js:noInline')
+static MotorData getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<MotorData>(create);@$pb.TagNumber(6)
+$core.bool hasAngle() => $_has(5);@$pb.TagNumber(4)
+$core.bool hasCurrentStep() => $_has(3);@$pb.TagNumber(3)
+$core.bool hasDirection() => $_has(2);@$pb.TagNumber(2)
+$core.bool hasIsLimitSwitchPressed() => $_has(1);@$pb.TagNumber(1)
+$core.bool hasIsMoving() => $_has(0);@$pb.TagNumber(5)
+$core.bool hasTargetStep() => $_has(4);$pb.BuilderInfo get info_ => _i;@$pb.TagNumber(2)
+$core.bool get isLimitSwitchPressed => $_getBF(1);@$pb.TagNumber(2)
+set isLimitSwitchPressed($core.bool v) { $_setBool(1, v); }@$pb.TagNumber(1)
+$core.bool get isMoving => $_getBF(0);@$pb.TagNumber(1)
+set isMoving($core.bool v) { $_setBool(0, v); }@$pb.TagNumber(5)
+$core.int get targetStep => $_getIZ(4);@$pb.TagNumber(5)
+set targetStep($core.int v) { $_setSignedInt32(4, v); }static const MotorDirection CLOCKWISE = MotorDirection._(5, _omitEnumNames ? '' : 'CLOCKWISE');static const MotorDirection CLOSING = MotorDirection._(8, _omitEnumNames ? '' : 'CLOSING');static const MotorDirection COUNTER_CLOCKWISE = MotorDirection._(6, _omitEnumNames ? '' : 'COUNTER_CLOCKWISE');static const MotorDirection DOWN = MotorDirection._(2, _omitEnumNames ? '' : 'DOWN');static const MotorDirection LEFT = MotorDirection._(3, _omitEnumNames ? '' : 'LEFT');static const MotorDirection MOTOR_DIRECTION_UNDEFINED = MotorDirection._(0, _omitEnumNames ? '' : 'MOTOR_DIRECTION_UNDEFINED');static const MotorDirection NOT_MOVING = MotorDirection._(9, _omitEnumNames ? '' : 'NOT_MOVING');static const MotorDirection OPENING = MotorDirection._(7, _omitEnumNames ? '' : 'OPENING');static const MotorDirection RIGHT = MotorDirection._(4, _omitEnumNames ? '' : 'RIGHT');static const MotorDirection UP = MotorDirection._(1, _omitEnumNames ? '' : 'UP');static MotorDirection? valueOf($core.int value) => _byValue[value];static const $core.List<MotorDirection> values = <MotorDirection> [
+ MOTOR_DIRECTION_UNDEFINED,
+ UP,
+ DOWN,
+ LEFT,
+ RIGHT,
+ CLOCKWISE,
+ COUNTER_CLOCKWISE,
+ OPENING,
+ CLOSING,
+ NOT_MOVING,
+];Utilities for MotorDirections.
+The human-readable name of the direction
+String get humanName {
+ switch (this) {
+ case MotorDirection.MOTOR_DIRECTION_UNDEFINED: return "Unknown";
+ case MotorDirection.UP: return "Up";
+ case MotorDirection.DOWN: return "Down";
+ case MotorDirection.LEFT: return "Left";
+ case MotorDirection.RIGHT: return "Right";
+ case MotorDirection.CLOCKWISE: return "Clockwise";
+ case MotorDirection.COUNTER_CLOCKWISE: return "Counter clockwise";
+ case MotorDirection.OPENING: return "Opening";
+ case MotorDirection.CLOSING: return "Closing";
+ case MotorDirection.NOT_MOVING: return "Not moving";
+ }
+ // Do not use default or else you'll lose exhaustiveness checking.
+ throw ArgumentError("Unrecognized MotorDirection: $this");
+}Settings related to network configuration.
+Parses network settings from a JSON map.
+NetworkSettings.fromJson(Json? json) :
+ subsystemsSocket = json?.getSocket("subsystemsSocket") ?? SocketInfo.raw("192.168.1.20", 8001),
+ videoSocket = json?.getSocket("videoSocket") ?? SocketInfo.raw("192.168.1.30", 8002),
+ autonomySocket = json?.getSocket("autonomySocket") ?? SocketInfo.raw("192.168.1.30", 8003),
+ tankSocket = json?.getSocket("tankSocket") ?? SocketInfo.raw("192.168.1.40", 8000),
+ connectionTimeout = json?["connectionTimeout"] ?? 5;Creates a new network settings object.
+NetworkSettings({
+ required this.subsystemsSocket,
+ required this.videoSocket,
+ required this.autonomySocket,
+ required this.tankSocket,
+ required this.connectionTimeout,
+});The address and port of the autonomy program.
+final SocketInfo autonomySocket;The amount of time, in seconds, the dashboard should wait before determining it's +lost connection to the rover. For reference, the rover should be sending messages +at least once per second.
+final int connectionTimeout;The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;The address and port of the subsystems program.
+final SocketInfo subsystemsSocket;The address of the tank. The port is ignored.
+The Tank is a model rover that has all the same programs as the rover. This field does not +include port numbers because ports are specific to the program, and the tank will have many +programs running. Instead, the IP address of all the other programs should be swapped with +the tank when it's being used.
+final SocketInfo tankSocket;Serializes these settings to JSON.
+Json toJson() => {
+ "subsystemsSocket": subsystemsSocket.toJson(),
+ "videoSocket": videoSocket.toJson(),
+ "autonomySocket": autonomySocket.toJson(),
+ "tankSocket": tankSocket.toJson(),
+ "connectionTimeout": connectionTimeout,
+};A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();The address and port of the video program.
+final SocketInfo videoSocket;Helpful utils on doubles.
+Formats this number by rounding to 2 decimal points.
+String format() => toStringAsFixed(2);Converts this number (as radians) to degrees.
+int toDegrees() => (this * (180 / pi)).truncate();A mode for operating the rover.
+The operator can switch between modes which will:
+No controls. Allows the user to "disable" a gamepad.
+ + +const OperatingMode("None")
+ Drive mode.
+Focus on helping the user simply drive the rover.
+ + +const OperatingMode("Drive")
+ Camera mode.
+The on-board cameras are on spinnable mounts. This mode controls those mounts.
+ + +const OperatingMode("Cameras")
+ Science mode.
+Focus cameras on the science chamber and allow the user to collect samples and data.
+ + +const OperatingMode("Science")
+ Arm mode.
+Focus on helping the user manipulate the arm.
+ + +const OperatingMode("Arm")
+ MARS mode.
+Allows the user to control the MARS subsystem manually.
+ + +const OperatingMode("MARS")
+ Describes an operating mode.
+const OperatingMode(this.name);The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;A numeric identifier for the enumerated value.
+The values of a single enumeration are numbered
+consecutively from zero to one less than the
+number of values.
+This is also the index of the value in the
+enumerated type's static values list.
int get index;The name of this mode.
+Use this instead of EnumName.name so we can use a longer name.
final String name;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();A constant List of the values in this enum, in order of their declaration.
+true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory Orientation.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory Orientation.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory Orientation({
+ $core.double? x,
+ $core.double? y,
+ $core.double? z,
+}) {
+ final $result = create();
+ if (x != null) {
+ $result.x = x;
+ }
+ if (y != null) {
+ $result.y = y;
+ }
+ if (z != null) {
+ $result.z = z;
+ }
+ return $result;
+}@$pb.TagNumber(1)
+void clearX() => clearField(1);@$pb.TagNumber(2)
+void clearY() => clearField(2);@$pb.TagNumber(3)
+void clearZ() => clearField(3);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+Orientation clone() => Orientation()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+Orientation copyWith(void Function(Orientation) updates) => super.copyWith((message) => updates(message as Orientation)) as Orientation;@$core.pragma('dart2js:noInline')
+static Orientation create() => Orientation._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
Orientation createEmptyInstance() => create();static $pb.PbList<Orientation> createRepeated() => $pb.PbList<Orientation>();@$core.pragma('dart2js:noInline')
+static Orientation getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<Orientation>(create);@$pb.TagNumber(1)
+$core.bool hasX() => $_has(0);@$pb.TagNumber(2)
+$core.bool hasY() => $_has(1);@$pb.TagNumber(3)
+$core.bool hasZ() => $_has(2);$pb.BuilderInfo get info_ => _i;@$pb.TagNumber(1)
+$core.double get x => $_getN(0);@$pb.TagNumber(1)
+set x($core.double v) { $_setFloat(0, v); }@$pb.TagNumber(2)
+$core.double get y => $_getN(1);@$pb.TagNumber(2)
+set y($core.double v) { $_setFloat(1, v); }@$pb.TagNumber(3)
+$core.double get z => $_getN(2);@$pb.TagNumber(3)
+set z($core.double v) { $_setFloat(2, v); }Metrics about the rover's position and orientation.
+For simplicity, these metrics also track the first recorded GPS position as the base station.
+A collection of metrics relevant for monitoring the rover's GPS location.
+PositionMetrics() : super(RoverPosition());A list of user-friendly explanations for each of the metrics.
+Be sure to store the actual values as fields. This property should be a list of one +user-friendly explanation per metric.
+@override
+List<MetricLine> get allMetrics => [
+ MetricLine("GPS: "),
+ MetricLine(" Latitude: ${data.gps.latitude.toStringAsFixed(6)}°",),
+ MetricLine(" Longitude: ${data.gps.longitude.toStringAsFixed(6)}°",),
+ MetricLine(" Altitude: ${data.gps.altitude.toStringAsFixed(2)} m"),
+ MetricLine("Orientation:",),
+ MetricLine(" X: ${data.orientation.x.toStringAsFixed(2)}°", severity: getRotationSeverity(data.orientation.x)),
+ MetricLine(" Y: ${data.orientation.y.toStringAsFixed(2)}°", severity: getRotationSeverity(data.orientation.y)),
+ MetricLine(" Z: ${data.orientation.z.toStringAsFixed(2)}°"),
+ MetricLine("Distance: ${data.gps.distanceTo(baseStation).toStringAsFixed(2)} m",),
+];The angle to orient the rover on the top-down map.
+double get angle => data.orientation.z;The position of the base station. Setting this value updates the UI.
+Defaults to RoverPosition.gps until the MARS subsystem comes online (see MarsData.coordinates).
+GpsCoordinates get baseStation => _baseStation ?? data.gps;set baseStation(GpsCoordinates value) {
+ _baseStation = value;
+ notifyListeners();
+}Gets the severity of the rover's orientation for both pitch and roll.
+Severity? getRotationSeverity(double orientation) {
+ final abs = orientation.abs();
+ if (abs >= 30) {
+ return Severity.critical;
+ } else if (abs >= 15) {
+ return Severity.warning;
+ } else if (abs >= 10) {
+ return Severity.info;
+ } else {
+ return null;
+ }
+}A collective name for this group of metrics (usually the name of the subsystem).
+@override
+String get name => "Position";Updates data with new data.
+@override
+void update(RoverPosition value) {
+ final oldOrientation = data.orientation.deepCopy();
+ super.update(value);
+ if(data.orientation.x > 360 || data.orientation.x < -360){
+ data.orientation.x = oldOrientation.x;
+ notifyListeners();
+ }
+ if(data.orientation.y > 360 || data.orientation.y < -360){
+ data.orientation.y = oldOrientation.y;
+ notifyListeners();
+ }
+ if(data.orientation.z > 360 || data.orientation.z < -360){
+ data.orientation.z = oldOrientation.z;
+ notifyListeners();
+ }
+}true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory ProtoColor.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory ProtoColor.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory ProtoColor({
+ $core.double? red,
+ $core.double? green,
+ $core.double? blue,
+}) {
+ final $result = create();
+ if (red != null) {
+ $result.red = red;
+ }
+ if (green != null) {
+ $result.green = green;
+ }
+ if (blue != null) {
+ $result.blue = blue;
+ }
+ return $result;
+}@$pb.TagNumber(3)
+$core.double get blue => $_getN(2);@$pb.TagNumber(3)
+set blue($core.double v) { $_setFloat(2, v); }@$pb.TagNumber(3)
+void clearBlue() => clearField(3);@$pb.TagNumber(2)
+void clearGreen() => clearField(2);@$pb.TagNumber(1)
+void clearRed() => clearField(1);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+ProtoColor clone() => ProtoColor()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+ProtoColor copyWith(void Function(ProtoColor) updates) => super.copyWith((message) => updates(message as ProtoColor)) as ProtoColor;@$core.pragma('dart2js:noInline')
+static ProtoColor create() => ProtoColor._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
ProtoColor createEmptyInstance() => create();static $pb.PbList<ProtoColor> createRepeated() => $pb.PbList<ProtoColor>();@$core.pragma('dart2js:noInline')
+static ProtoColor getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<ProtoColor>(create);@$pb.TagNumber(2)
+$core.double get green => $_getN(1);@$pb.TagNumber(2)
+set green($core.double v) { $_setFloat(1, v); }@$pb.TagNumber(3)
+$core.bool hasBlue() => $_has(2);@$pb.TagNumber(2)
+$core.bool hasGreen() => $_has(1);@$pb.TagNumber(1)
+$core.bool hasRed() => $_has(0);$pb.BuilderInfo get info_ => _i;@$pb.TagNumber(1)
+$core.double get red => $_getN(0);@$pb.TagNumber(1)
+set red($core.double v) { $_setFloat(0, v); }static const PumpState PUMP_OFF = PumpState._(2, _omitEnumNames ? '' : 'PUMP_OFF');static const PumpState PUMP_ON = PumpState._(1, _omitEnumNames ? '' : 'PUMP_ON');static const PumpState PUMP_STATE_UNDEFINED = PumpState._(0, _omitEnumNames ? '' : 'PUMP_STATE_UNDEFINED');static PumpState? valueOf($core.int value) => _byValue[value];static const $core.List<PumpState> values = <PumpState> [
+ PUMP_STATE_UNDEFINED,
+ PUMP_ON,
+ PUMP_OFF,
+];A callback to execute with raw Protobuf data.
+typedef RawDataHandler = void Function(List<int> data);true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory RoverPosition.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory RoverPosition.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory RoverPosition({
+ GpsCoordinates? gps,
+ Orientation? orientation,
+}) {
+ final $result = create();
+ if (gps != null) {
+ $result.gps = gps;
+ }
+ if (orientation != null) {
+ $result.orientation = orientation;
+ }
+ return $result;
+}@$pb.TagNumber(1)
+void clearGps() => clearField(1);@$pb.TagNumber(2)
+void clearOrientation() => clearField(2);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+RoverPosition clone() => RoverPosition()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+RoverPosition copyWith(void Function(RoverPosition) updates) => super.copyWith((message) => updates(message as RoverPosition)) as RoverPosition;@$core.pragma('dart2js:noInline')
+static RoverPosition create() => RoverPosition._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
RoverPosition createEmptyInstance() => create();static $pb.PbList<RoverPosition> createRepeated() => $pb.PbList<RoverPosition>();@$pb.TagNumber(1)
+GpsCoordinates ensureGps() => $_ensure(0);@$pb.TagNumber(2)
+Orientation ensureOrientation() => $_ensure(1);@$core.pragma('dart2js:noInline')
+static RoverPosition getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<RoverPosition>(create);@$pb.TagNumber(1)
+GpsCoordinates get gps => $_getN(0);@$pb.TagNumber(1)
+set gps(GpsCoordinates v) { setField(1, v); }@$pb.TagNumber(1)
+$core.bool hasGps() => $_has(0);@$pb.TagNumber(2)
+$core.bool hasOrientation() => $_has(1);$pb.BuilderInfo get info_ => _i;@$pb.TagNumber(2)
+Orientation get orientation => $_getN(1);@$pb.TagNumber(2)
+set orientation(Orientation v) { setField(2, v); }/ Changes the way the rover listens to incoming commands. +/ +/ - When IDLE, all subsystems will ignore all commands +/ - When MANUAL, all subsystems will accept all commands +/ - When AUTONOMOUS, the rover will ignore commands from the dashboard
+static const RoverStatus AUTONOMOUS = RoverStatus._(3, _omitEnumNames ? '' : 'AUTONOMOUS');static const RoverStatus DISCONNECTED = RoverStatus._(0, _omitEnumNames ? '' : 'DISCONNECTED');static const RoverStatus IDLE = RoverStatus._(1, _omitEnumNames ? '' : 'IDLE');static const RoverStatus MANUAL = RoverStatus._(2, _omitEnumNames ? '' : 'MANUAL');static const RoverStatus POWER_OFF = RoverStatus._(4, _omitEnumNames ? '' : 'POWER_OFF');static const RoverStatus RESTART = RoverStatus._(5, _omitEnumNames ? '' : 'RESTART');static RoverStatus? valueOf($core.int value) => _byValue[value];static const $core.List<RoverStatus> values = <RoverStatus> [
+ DISCONNECTED,
+ IDLE,
+ MANUAL,
+ AUTONOMOUS,
+ POWER_OFF,
+ RESTART,
+];Gets a user-friendly name for a RoverStatus.
+Gets a user-friendly name for a RoverStatus.
+String get humanName {
+ switch (this) {
+ case RoverStatus.DISCONNECTED: return "Disconnected";
+ case RoverStatus.IDLE: return "Idle";
+ case RoverStatus.MANUAL: return "Manual";
+ case RoverStatus.AUTONOMOUS: return "Autonomous";
+ case RoverStatus.POWER_OFF: return "Off";
+ case RoverStatus.RESTART: return "Restart";
+ }
+ // Do not use default or else you'll lose exhaustiveness checking.
+ throw ArgumentError("Unrecognized rover status: $this");
+}Which rover-like system to communicate with.
+The ports on each SocketInfo will remain the same, but the IP addresses may vary.
+The rover itself.
+The rover has multiple computers with multiple IP addresses.
+ + +The user's own computer.
+Useful when debugging and running the rover programs locally.
+ + +The smaller rover used for autonomy.
+The tank only has one computer with one static IP address.
+ + +The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;The human-friendly name for this RoverType.
+String get humanName {
+ switch(this) {
+ case rover: return "Rover";
+ case tank: return "Tank";
+ case localhost: return "Local";
+ }
+}A numeric identifier for the enumerated value.
+The values of a single enumeration are numbered
+consecutively from zero to one less than the
+number of values.
+This is also the index of the value in the
+enumerated type's static values list.
int get index;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();A constant List of the values in this enum, in order of their declaration.
+Stores all the readings of one sensor for one sample.
+timestamp relative to firstTimestamp.
+
+
+Adds a new SensorReading with timestamp relative to firstTimestamp.
void addReading(Timestamp timestamp, double value) {
+ firstTimestamp ??= timestamp;
+ readings.add(SensorReading(time: timestamp - firstTimestamp!, value: value));
+ if (min == null || value < min!) min = value;
+ if (max == null || value > max!) max = value;
+ sum += value;
+ average = sum / readings.length;
+}The average value of readings.
+Because there may be many readings, this is updated efficiently in addReading.
+double? average;Clears all readings.
+void clear() {
+ readings.clear();
+ firstTimestamp = null;
+ min = average = max = null;
+ sum = 0;
+}The Timestamp of the first reading.
+All other SensorReading.times are relative to this.
+Timestamp? firstTimestamp;The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;The maximum value of readings.
+double? max;The minimum value of readings.
+double? min;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A list of the readings for this sample and sensor.
+final List<SensorReading> readings = [];A representation of the runtime type of the object.
+external Type get runtimeType;double sum = 0;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory ScienceCommand.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory ScienceCommand.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory ScienceCommand({
+ $core.double? dirtCarousel,
+ $core.double? dirtLinear,
+ $core.double? scienceLinear,
+ $core.double? vacuumLinear,
+ PumpState? vacuum,
+ DirtReleaseState? dirtRelease,
+ PumpState? pump1,
+ PumpState? pump2,
+ PumpState? pump3,
+ PumpState? pump4,
+ $core.bool? calibrate,
+ $core.bool? stop,
+ $core.bool? nextTube,
+ $core.bool? nextSection,
+ $core.int? sample,
+ ScienceState? state,
+}) {
+ final $result = create();
+ if (dirtCarousel != null) {
+ $result.dirtCarousel = dirtCarousel;
+ }
+ if (dirtLinear != null) {
+ $result.dirtLinear = dirtLinear;
+ }
+ if (scienceLinear != null) {
+ $result.scienceLinear = scienceLinear;
+ }
+ if (vacuumLinear != null) {
+ $result.vacuumLinear = vacuumLinear;
+ }
+ if (vacuum != null) {
+ $result.vacuum = vacuum;
+ }
+ if (dirtRelease != null) {
+ $result.dirtRelease = dirtRelease;
+ }
+ if (pump1 != null) {
+ $result.pump1 = pump1;
+ }
+ if (pump2 != null) {
+ $result.pump2 = pump2;
+ }
+ if (pump3 != null) {
+ $result.pump3 = pump3;
+ }
+ if (pump4 != null) {
+ $result.pump4 = pump4;
+ }
+ if (calibrate != null) {
+ $result.calibrate = calibrate;
+ }
+ if (stop != null) {
+ $result.stop = stop;
+ }
+ if (nextTube != null) {
+ $result.nextTube = nextTube;
+ }
+ if (nextSection != null) {
+ $result.nextSection = nextSection;
+ }
+ if (sample != null) {
+ $result.sample = sample;
+ }
+ if (state != null) {
+ $result.state = state;
+ }
+ return $result;
+}High level commands
+@$pb.TagNumber(12)
+$core.bool get calibrate => $_getBF(10);@$pb.TagNumber(12)
+set calibrate($core.bool v) { $_setBool(10, v); }@$pb.TagNumber(12)
+void clearCalibrate() => clearField(12);@$pb.TagNumber(1)
+void clearDirtCarousel() => clearField(1);@$pb.TagNumber(2)
+void clearDirtLinear() => clearField(2);@$pb.TagNumber(7)
+void clearDirtRelease() => clearField(7);@$pb.TagNumber(15)
+void clearNextSection() => clearField(15);@$pb.TagNumber(14)
+void clearNextTube() => clearField(14);@$pb.TagNumber(8)
+void clearPump1() => clearField(8);@$pb.TagNumber(9)
+void clearPump2() => clearField(9);@$pb.TagNumber(10)
+void clearPump3() => clearField(10);@$pb.TagNumber(11)
+void clearPump4() => clearField(11);@$pb.TagNumber(16)
+void clearSample() => clearField(16);@$pb.TagNumber(3)
+void clearScienceLinear() => clearField(3);@$pb.TagNumber(17)
+void clearState() => clearField(17);@$pb.TagNumber(13)
+void clearStop() => clearField(13);@$pb.TagNumber(5)
+void clearVacuum() => clearField(5);@$pb.TagNumber(4)
+void clearVacuumLinear() => clearField(4);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+ScienceCommand clone() => ScienceCommand()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+ScienceCommand copyWith(void Function(ScienceCommand) updates) => super.copyWith((message) => updates(message as ScienceCommand)) as ScienceCommand;@$core.pragma('dart2js:noInline')
+static ScienceCommand create() => ScienceCommand._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
ScienceCommand createEmptyInstance() => create();static $pb.PbList<ScienceCommand> createRepeated() => $pb.PbList<ScienceCommand>();Individual control over each motor. Indicates steps to move
+@$pb.TagNumber(1)
+$core.double get dirtCarousel => $_getN(0);@$pb.TagNumber(1)
+set dirtCarousel($core.double v) { $_setFloat(0, v); }@$pb.TagNumber(2)
+$core.double get dirtLinear => $_getN(1);@$pb.TagNumber(2)
+set dirtLinear($core.double v) { $_setFloat(1, v); }@$pb.TagNumber(7)
+DirtReleaseState get dirtRelease => $_getN(5);@$pb.TagNumber(7)
+set dirtRelease(DirtReleaseState v) { setField(7, v); }@$core.pragma('dart2js:noInline')
+static ScienceCommand getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<ScienceCommand>(create);@$pb.TagNumber(12)
+$core.bool hasCalibrate() => $_has(10);@$pb.TagNumber(1)
+$core.bool hasDirtCarousel() => $_has(0);@$pb.TagNumber(2)
+$core.bool hasDirtLinear() => $_has(1);@$pb.TagNumber(7)
+$core.bool hasDirtRelease() => $_has(5);@$pb.TagNumber(15)
+$core.bool hasNextSection() => $_has(13);@$pb.TagNumber(14)
+$core.bool hasNextTube() => $_has(12);@$pb.TagNumber(8)
+$core.bool hasPump1() => $_has(6);@$pb.TagNumber(9)
+$core.bool hasPump2() => $_has(7);@$pb.TagNumber(10)
+$core.bool hasPump3() => $_has(8);@$pb.TagNumber(11)
+$core.bool hasPump4() => $_has(9);@$pb.TagNumber(16)
+$core.bool hasSample() => $_has(14);@$pb.TagNumber(3)
+$core.bool hasScienceLinear() => $_has(2);@$pb.TagNumber(17)
+$core.bool hasState() => $_has(15);@$pb.TagNumber(13)
+$core.bool hasStop() => $_has(11);@$pb.TagNumber(5)
+$core.bool hasVacuum() => $_has(4);@$pb.TagNumber(4)
+$core.bool hasVacuumLinear() => $_has(3);$pb.BuilderInfo get info_ => _i;@$pb.TagNumber(15)
+$core.bool get nextSection => $_getBF(13);@$pb.TagNumber(15)
+set nextSection($core.bool v) { $_setBool(13, v); }@$pb.TagNumber(14)
+$core.bool get nextTube => $_getBF(12);@$pb.TagNumber(14)
+set nextTube($core.bool v) { $_setBool(12, v); }Pumps
+@$pb.TagNumber(8)
+PumpState get pump1 => $_getN(6);@$pb.TagNumber(8)
+set pump1(PumpState v) { setField(8, v); }@$pb.TagNumber(9)
+PumpState get pump2 => $_getN(7);@$pb.TagNumber(9)
+set pump2(PumpState v) { setField(9, v); }@$pb.TagNumber(10)
+PumpState get pump3 => $_getN(8);@$pb.TagNumber(10)
+set pump3(PumpState v) { setField(10, v); }@$pb.TagNumber(11)
+PumpState get pump4 => $_getN(9);@$pb.TagNumber(11)
+set pump4(PumpState v) { setField(11, v); }@$pb.TagNumber(16)
+$core.int get sample => $_getIZ(14);@$pb.TagNumber(16)
+set sample($core.int v) { $_setSignedInt32(14, v); }@$pb.TagNumber(3)
+$core.double get scienceLinear => $_getN(2);@$pb.TagNumber(3)
+set scienceLinear($core.double v) { $_setFloat(2, v); }@$pb.TagNumber(17)
+ScienceState get state => $_getN(15);@$pb.TagNumber(17)
+set state(ScienceState v) { setField(17, v); }@$pb.TagNumber(13)
+$core.bool get stop => $_getBF(11);@$pb.TagNumber(13)
+set stop($core.bool v) { $_setBool(11, v); }Vacuum
+@$pb.TagNumber(5)
+PumpState get vacuum => $_getN(4);@$pb.TagNumber(5)
+set vacuum(PumpState v) { setField(5, v); }@$pb.TagNumber(4)
+$core.double get vacuumLinear => $_getN(3);@$pb.TagNumber(4)
+set vacuumLinear($core.double v) { $_setFloat(3, v); }true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory ScienceData.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory ScienceData.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory ScienceData({
+ $core.double? co2,
+ $core.double? humidity,
+ $core.double? methane,
+ $core.double? pH,
+ $core.double? temperature,
+ $core.int? sample,
+ ScienceState? state,
+}) {
+ final $result = create();
+ if (co2 != null) {
+ $result.co2 = co2;
+ }
+ if (humidity != null) {
+ $result.humidity = humidity;
+ }
+ if (methane != null) {
+ $result.methane = methane;
+ }
+ if (pH != null) {
+ $result.pH = pH;
+ }
+ if (temperature != null) {
+ $result.temperature = temperature;
+ }
+ if (sample != null) {
+ $result.sample = sample;
+ }
+ if (state != null) {
+ $result.state = state;
+ }
+ return $result;
+}@$pb.TagNumber(1)
+void clearCo2() => clearField(1);@$pb.TagNumber(2)
+void clearHumidity() => clearField(2);@$pb.TagNumber(3)
+void clearMethane() => clearField(3);@$pb.TagNumber(4)
+void clearPH() => clearField(4);@$pb.TagNumber(6)
+void clearSample() => clearField(6);@$pb.TagNumber(7)
+void clearState() => clearField(7);@$pb.TagNumber(5)
+void clearTemperature() => clearField(5);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+ScienceData clone() => ScienceData()..mergeFromMessage(this);@$pb.TagNumber(1)
+$core.double get co2 => $_getN(0);@$pb.TagNumber(1)
+set co2($core.double v) { $_setFloat(0, v); }Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+ScienceData copyWith(void Function(ScienceData) updates) => super.copyWith((message) => updates(message as ScienceData)) as ScienceData;@$core.pragma('dart2js:noInline')
+static ScienceData create() => ScienceData._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
ScienceData createEmptyInstance() => create();static $pb.PbList<ScienceData> createRepeated() => $pb.PbList<ScienceData>();@$core.pragma('dart2js:noInline')
+static ScienceData getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<ScienceData>(create);@$pb.TagNumber(1)
+$core.bool hasCo2() => $_has(0);@$pb.TagNumber(2)
+$core.bool hasHumidity() => $_has(1);@$pb.TagNumber(3)
+$core.bool hasMethane() => $_has(2);@$pb.TagNumber(4)
+$core.bool hasPH() => $_has(3);@$pb.TagNumber(6)
+$core.bool hasSample() => $_has(5);@$pb.TagNumber(7)
+$core.bool hasState() => $_has(6);@$pb.TagNumber(5)
+$core.bool hasTemperature() => $_has(4);@$pb.TagNumber(2)
+$core.double get humidity => $_getN(1);@$pb.TagNumber(2)
+set humidity($core.double v) { $_setFloat(1, v); }$pb.BuilderInfo get info_ => _i;@$pb.TagNumber(3)
+$core.double get methane => $_getN(2);@$pb.TagNumber(3)
+set methane($core.double v) { $_setFloat(2, v); }@$pb.TagNumber(4)
+$core.double get pH => $_getN(3);@$pb.TagNumber(4)
+set pH($core.double v) { $_setFloat(3, v); }@$pb.TagNumber(6)
+$core.int get sample => $_getIZ(5);@$pb.TagNumber(6)
+set sample($core.int v) { $_setSignedInt32(5, v); }@$pb.TagNumber(7)
+ScienceState get state => $_getN(6);@$pb.TagNumber(7)
+set state(ScienceState v) { setField(7, v); }@$pb.TagNumber(5)
+$core.double get temperature => $_getN(4);@$pb.TagNumber(5)
+set temperature($core.double v) { $_setFloat(4, v); }Metrics reported by the science subsystem.
+These metrics represent analysis of dirt samples extracted by the science subsystem. They need +to not only be recorded but logged as well so the science team can generate charts out of it.
+A collection of metrics relevant for monitoring the rover's electrical status.
+ScienceMetrics() : super(ScienceData());A list of user-friendly explanations for each of the metrics.
+Be sure to store the actual values as fields. This property should be a list of one +user-friendly explanation per metric.
+@override
+List<MetricLine> get allMetrics => [
+ MetricLine("Methane: ${data.methane.toStringAsFixed(3)}"),
+ MetricLine("CO2: ${data.co2.toStringAsFixed(3)}"),
+ MetricLine("Temperature: ${data.temperature.toStringAsFixed(3)}"),
+ MetricLine("Humidity: ${data.humidity.toStringAsFixed(3)}"),
+ MetricLine("pH: ${data.pH.toStringAsFixed(3)}"),
+];A collective name for this group of metrics (usually the name of the subsystem).
+@override
+String get name => "Science";Updates data with new data.
+@override
+void update(ScienceData value){
+ if (value.state == ScienceState.STOP_COLLECTING) return;
+ super.update(value);
+}The result of a science test.
+There was never life in this ecosystem.
+ + +There is currently life in this ecosystem.
+ + +There used to be life in this ecosystem, but not anymore.
+ + +This test cannot determine the presence of life.
+ + +This test is awaiting more data.
+ + +The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;A numeric identifier for the enumerated value.
+The values of a single enumeration are numbered
+consecutively from zero to one less than the
+number of values.
+This is also the index of the value in the
+enumerated type's static values list.
int get index;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();A constant List of the values in this enum, in order of their declaration.
+A sensor in the science subsystem.
+A const constructor.
+const ScienceSensor({
+ required this.name,
+ required this.test,
+ required this.testDescription,
+});The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;The name of this sensor.
+final String name;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;The test to determine the presence of life based on data from this sensor.
+final ScienceTest test;A human-readable description of tests.
+final String testDescription;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();Settings relating to science.
+Parses a ScienceSettings from JSON.
+ScienceSettings.fromJson(Json? json) :
+ numSamples = json?["numSamples"] ?? 3,
+ scrollableGraphs = json?["scrollableGraphs"] ?? false;A const constructor.
+const ScienceSettings({required this.scrollableGraphs, required this.numSamples});The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The number of samples collected by the science subsystem.
+final int numSamples;The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;How many frames to render per second.
+This does not affect how many frames are sent by the rover per second.
+final bool scrollableGraphs;Serializes these settings in JSON format.
+Json toJson() => {
+ "scrollableGraphs": scrollableGraphs,
+};A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();static const ScienceState COLLECT_DATA = ScienceState._(1, _omitEnumNames ? '' : 'COLLECT_DATA');static const ScienceState SCIENCE_STATE_UNDEFINED = ScienceState._(0, _omitEnumNames ? '' : 'SCIENCE_STATE_UNDEFINED');static const ScienceState STOP_COLLECTING = ScienceState._(2, _omitEnumNames ? '' : 'STOP_COLLECTING');static ScienceState? valueOf($core.int value) => _byValue[value];static const $core.List<ScienceState> values = <ScienceState> [
+ SCIENCE_STATE_UNDEFINED,
+ COLLECT_DATA,
+ STOP_COLLECTING,
+];Utilities for ScienceStates.
+The human-readable name of the task.
+String get humanName {
+ switch (this) {
+ case ScienceState.SCIENCE_STATE_UNDEFINED: return "Unknown";
+ case ScienceState.STOP_COLLECTING: return "Idle";
+ case ScienceState.COLLECT_DATA: return "Collecting data";
+ }
+ // Do not use default or else you'll lose exhaustiveness checking.
+ throw ArgumentError("Unrecognized task: $this");
+}A function that determines the presence of life based on sensor data.
+typedef ScienceTest = ScienceResult Function(SampleData);A sensor reading with a timestamp.
+A const constructor.
+const SensorReading({required this.time, required this.value});The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;The time this reading was taken, relative to the first reading.
+final double time;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();The value from the sensor.
+final double value;Contains the settings for running the dashboard and the rover.
+Initialize settings from Json.
+Settings.fromJson(Json json) :
+ network = NetworkSettings.fromJson(json["network"]),
+ easterEggs = EasterEggsSettings.fromJson(json["easterEggs"]),
+ science = ScienceSettings.fromJson(json["science"]),
+ arm = ArmSettings.fromJson(json["arm"]),
+ dashboard = DashboardSettings.fromJson(json["dashboard"]);A const constructor.
+const Settings({
+ required this.network,
+ required this.easterEggs,
+ required this.science,
+ required this.arm,
+ required this.dashboard,
+});Settings for the arm.
+final ArmSettings arm;Settings related to the dashboard itself.
+final DashboardSettings dashboard;Settings for easter eggs.
+Please, please, please -- do not remove these (Levi Lesches, '25).
+final EasterEggsSettings easterEggs;The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;Settings for the network, like IP addresses and ports.
+final NetworkSettings network;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;Settings for the science analysis.
+final ScienceSettings science;Converts the data from the settings instance to Json.
+Json toJson() => {
+ "network": network.toJson(),
+ "easterEggs": easterEggs.toJson(),
+ "science": science.toJson(),
+ "arm": arm.toJson(),
+ "dashboard": dashboard.toJson(),
+};A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();A collection of functions for parsing Settings.
+Parses a SocketInfo that may not be present.
+SocketInfo? getSocket(String key) {
+ final Json? socket = this[key];
+ if (socket == null) return null;
+ return SocketInfo.fromJson(socket);
+}The level of danger a message represents.
+A simple message that doesn't represent an issue.
+ + +A warning that something may go wrong soon.
+This could be used to imply possible damage to the rover, possible disconnects, etc.
+ + +Some operation did not work and requires manual intervention.
+ + +Something went wrong and data or commands may be lost.
+ + +The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;A numeric identifier for the enumerated value.
+The values of a single enumeration are numbered
+consecutively from zero to one less than the
+number of values.
+This is also the index of the value in the
+enumerated type's static values list.
int get index;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();A constant List of the values in this enum, in order of their declaration.
+Information about a socket.
+Parses the socket data from a YAML map.
+SocketInfo.fromJson(Json yaml) :
+ address = InternetAddress(yaml["host"]),
+ port = yaml["port"];A const constructor.
+const SocketInfo({required this.address, required this.port});Use this constructor to pass in a raw String for the address.
+SocketInfo.raw(String host, this.port) : address = InternetAddress(host);The IP address of this socket.
+final InternetAddress address;A copy of this configuration, to avoid modifying the original.
+SocketInfo copyWith({InternetAddress? address, int? port}) => SocketInfo(
+ address: address ?? this.address,
+ port: port ?? this.port,
+);The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+@override
+int get hashCode => Object.hash(address, port);Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+@override
+bool operator ==(Object other) => other is SocketInfo
+ && address == other.address
+ && port == other.port;The port that the socket is connected to.
+final int port;A representation of the runtime type of the object.
+external Type get runtimeType;This socket's configuration in JSON format.
+Json toJson() => {
+ "host": address.address,
+ "port": port,
+};A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
@override
+String toString() => "${address.address}:$port";Controls the way the Dashboard views split.
+A const constructor.
+const SplitMode(this.humanName);The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;The name to show in the UI.
+final String humanName;A numeric identifier for the enumerated value.
+The values of a single enumeration are numbered
+consecutively from zero to one less than the
+number of values.
+This is also the index of the value in the
+enumerated type's static values list.
int get index;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();A constant List of the values in this enum, in order of their declaration.
+A message to show on the taskbar, with an associated severity.
+Creates a message to show on the taskbar.
+TaskbarMessage({
+ required this.severity,
+ required this.text,
+});The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;The severity of this message.
+final Severity severity;The text of this message.
+final String text;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();A human-friendly name for this mode.
+String get humanName => switch (this) {
+ ThemeMode.system => "Match system",
+ ThemeMode.light => "Light theme",
+ ThemeMode.dark => "Dark theme",
+};A Timestamp represents a point in time independent of any time zone or local +calendar, encoded as a count of seconds and fractions of seconds at +nanosecond resolution. The count is relative to an epoch at UTC midnight on +January 1, 1970, in the proleptic Gregorian calendar which extends the +Gregorian calendar backwards to year one.
+All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap +second table is needed for interpretation, using a 24-hour linear + smear.
+The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By +restricting to that range, we ensure that we can convert to and from RFC + 3339 date strings.
+Example 1: Compute Timestamp from POSIX time().
Timestamp timestamp;
+ timestamp.set_seconds(time(NULL));
+ timestamp.set_nanos(0);
+Example 2: Compute Timestamp from POSIX gettimeofday().
struct timeval tv;
+ gettimeofday(&tv, NULL);
+
+ Timestamp timestamp;
+ timestamp.set_seconds(tv.tv_sec);
+ timestamp.set_nanos(tv.tv_usec * 1000);
+Example 3: Compute Timestamp from Win32 GetSystemTimeAsFileTime().
FILETIME ft;
+ GetSystemTimeAsFileTime(&ft);
+ UINT64 ticks = (((UINT64)ft.dwHighDateTime) << 32) | ft.dwLowDateTime;
+
+ // A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z
+ // is 11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z.
+ Timestamp timestamp;
+ timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
+ timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));
+Example 4: Compute Timestamp from Java System.currentTimeMillis().
long millis = System.currentTimeMillis();
+
+ Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
+ .setNanos((int) ((millis % 1000) * 1000000)).build();
+Example 5: Compute Timestamp from Java Instant.now().
Instant now = Instant.now();
+
+ Timestamp timestamp =
+ Timestamp.newBuilder().setSeconds(now.getEpochSecond())
+ .setNanos(now.getNano()).build();
+Example 6: Compute Timestamp from current time in Python.
+ timestamp = Timestamp()
+ timestamp.GetCurrentTime()
+In JSON format, the Timestamp type is encoded as a string in the
+RFC 3339 format. That is, the
+ format is "{year}-{month}-{day}T{hour}:{min}:{sec}.{frac_sec}Z"
+ where {year} is always expressed using four digits while {month}, {day},
+ {hour}, {min}, and {sec} are zero-padded to two digits each. The fractional
+ seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution),
+ are optional. The "Z" suffix indicates the timezone ("UTC"); the timezone
+ is required. A proto3 JSON serializer should always use UTC (as indicated by
+ "Z") when printing the Timestamp type and a proto3 JSON parser should be
+ able to accept both UTC and other timezones (as indicated by an offset).
For example, "2017-01-15T01:30:15.01Z" encodes 15.01 seconds past +01:30 UTC on January 15, 2017.
+In JavaScript, one can convert a Date object to this format using the
+standard
+toISOString()
+ method. In Python, a standard datetime.datetime object can be converted
+ to this format using
+ strftime with
+ the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
+ the Joda Time's ISODateTimeFormat.dateTime() to obtain a formatter capable of generating timestamps in this format.
true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ DateTime.
+ this.
+ Map.
+ dateTime.
+
+
+factory Timestamp.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory Timestamp.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory Timestamp({
+ $fixnum.Int64? seconds,
+ $core.int? nanos,
+}) {
+ final $result = create();
+ if (seconds != null) {
+ $result.seconds = seconds;
+ }
+ if (nanos != null) {
+ $result.nanos = nanos;
+ }
+ return $result;
+}@$pb.TagNumber(2)
+void clearNanos() => clearField(2);@$pb.TagNumber(1)
+void clearSeconds() => clearField(1);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+Timestamp clone() => Timestamp()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+Timestamp copyWith(void Function(Timestamp) updates) => super.copyWith((message) => updates(message as Timestamp)) as Timestamp;@$core.pragma('dart2js:noInline')
+static Timestamp create() => Timestamp._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
Timestamp createEmptyInstance() => create();Creates a new instance from dateTime.
Time zone information will not be preserved.
+static Timestamp fromDateTime($core.DateTime dateTime) {
+ final result = create();
+ $mixin.TimestampMixin.setFromDateTime(result, dateTime);
+ return result;
+}@$core.pragma('dart2js:noInline')
+static Timestamp getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<Timestamp>(create);@$pb.TagNumber(2)
+$core.bool hasNanos() => $_has(1);@$pb.TagNumber(1)
+$core.bool hasSeconds() => $_has(0);$pb.BuilderInfo get info_ => _i;Non-negative fractions of a second at nanosecond resolution. Negative +second values with fractions must still have non-negative nanos values +that count forward in time. Must be from 0 to 999,999,999 +inclusive.
+@$pb.TagNumber(2)
+$core.int get nanos => $_getIZ(1);@$pb.TagNumber(2)
+set nanos($core.int v) { $_setSignedInt32(1, v); }Represents seconds of UTC time since Unix epoch +1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to +9999-12-31T23:59:59Z inclusive.
+@$pb.TagNumber(1)
+$fixnum.Int64 get seconds => $_getI64(0);@$pb.TagNumber(1)
+set seconds($fixnum.Int64 v) { $_setInt64(0, v); }Converts an instance to DateTime.
The result is in UTC time zone and has microsecond precision, as
+DateTime does not support nanosecond precision.
Use toLocal to convert to local time zone, instead of the default UTC.
DateTime toDateTime({bool toLocal = false}) =>
+ DateTime.fromMicrosecondsSinceEpoch(
+ seconds.toInt() * Duration.microsecondsPerSecond + nanos ~/ 1000,
+ isUtc: !toLocal);Utilities for Timestamps.
+Duration to a Timestamp.
+
+
+Subtracts the
+double operator -(Timestamp other) => (seconds - other.seconds).toDouble();Utilities for a list of Protobuf enums.
+_UNDEFINED values from the list.
+ Filters out _UNDEFINED values from the list.
List<T> get filtered => [
+ for (final value in this)
+ if (value.value != 0)
+ value,
+];Decodes a wrapped Protobuf message.
+T.
+
+
+Decodes the wrapped message into a message of type T.
T decode<T extends Message>(MessageDecoder<T> decoder) => decoder(data);/ Update a sensitive setting, such as the rover's status. +/ +/ This message must be triggered manually and the recipient (usually the subsystems Pi) +/ must respond with the exact same message to confirm its receipt.
+true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory UpdateSetting.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory UpdateSetting.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory UpdateSetting({
+ RoverStatus? status,
+ ProtoColor? color,
+}) {
+ final $result = create();
+ if (status != null) {
+ $result.status = status;
+ }
+ if (color != null) {
+ $result.color = color;
+ }
+ return $result;
+}@$pb.TagNumber(2)
+void clearColor() => clearField(2);@$pb.TagNumber(1)
+void clearStatus() => clearField(1);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+UpdateSetting clone() => UpdateSetting()..mergeFromMessage(this);@$pb.TagNumber(2)
+ProtoColor get color => $_getN(1);@$pb.TagNumber(2)
+set color(ProtoColor v) { setField(2, v); }Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+UpdateSetting copyWith(void Function(UpdateSetting) updates) => super.copyWith((message) => updates(message as UpdateSetting)) as UpdateSetting;@$core.pragma('dart2js:noInline')
+static UpdateSetting create() => UpdateSetting._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
UpdateSetting createEmptyInstance() => create();static $pb.PbList<UpdateSetting> createRepeated() => $pb.PbList<UpdateSetting>();@$pb.TagNumber(2)
+ProtoColor ensureColor() => $_ensure(1);@$core.pragma('dart2js:noInline')
+static UpdateSetting getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<UpdateSetting>(create);@$pb.TagNumber(2)
+$core.bool hasColor() => $_has(1);@$pb.TagNumber(1)
+$core.bool hasStatus() => $_has(0);$pb.BuilderInfo get info_ => _i;@$pb.TagNumber(1)
+RoverStatus get status => $_getN(0);@$pb.TagNumber(1)
+set status(RoverStatus v) { setField(1, v); }/ Make changes to a camera feed.
+CameraStatus.DISCONNECTED.
+ true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory VideoCommand.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory VideoCommand.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory VideoCommand({
+ $core.String? id,
+ CameraDetails? details,
+}) {
+ final $result = create();
+ if (id != null) {
+ $result.id = id;
+ }
+ if (details != null) {
+ $result.details = details;
+ }
+ return $result;
+}@$pb.TagNumber(2)
+void clearDetails() => clearField(2);@$pb.TagNumber(1)
+void clearId() => clearField(1);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+VideoCommand clone() => VideoCommand()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+VideoCommand copyWith(void Function(VideoCommand) updates) => super.copyWith((message) => updates(message as VideoCommand)) as VideoCommand;@$core.pragma('dart2js:noInline')
+static VideoCommand create() => VideoCommand._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
VideoCommand createEmptyInstance() => create();static $pb.PbList<VideoCommand> createRepeated() => $pb.PbList<VideoCommand>();/ The new details for this camera.
+/
+/ If changing CameraDetails.status, you cannot set it to CameraStatus.DISCONNECTED.
@$pb.TagNumber(2)
+CameraDetails get details => $_getN(1);@$pb.TagNumber(2)
+set details(CameraDetails v) { setField(2, v); }@$pb.TagNumber(2)
+CameraDetails ensureDetails() => $_ensure(1);@$core.pragma('dart2js:noInline')
+static VideoCommand getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<VideoCommand>(create);@$pb.TagNumber(2)
+$core.bool hasDetails() => $_has(1);@$pb.TagNumber(1)
+$core.bool hasId() => $_has(0);/ The unique ID of the camera to change.
+@$pb.TagNumber(1)
+$core.String get id => $_getSZ(0);@$pb.TagNumber(1)
+set id($core.String v) { $_setString(0, v); }$pb.BuilderInfo get info_ => _i;/ Reports data about a camera.
+true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory VideoData.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory VideoData.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory VideoData({
+ $core.String? id,
+ CameraDetails? details,
+ $core.List<$core.int>? frame,
+}) {
+ final $result = create();
+ if (id != null) {
+ $result.id = id;
+ }
+ if (details != null) {
+ $result.details = details;
+ }
+ if (frame != null) {
+ $result.frame = frame;
+ }
+ return $result;
+}@$pb.TagNumber(2)
+void clearDetails() => clearField(2);@$pb.TagNumber(3)
+void clearFrame() => clearField(3);@$pb.TagNumber(1)
+void clearId() => clearField(1);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+VideoData clone() => VideoData()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+VideoData copyWith(void Function(VideoData) updates) => super.copyWith((message) => updates(message as VideoData)) as VideoData;@$core.pragma('dart2js:noInline')
+static VideoData create() => VideoData._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
VideoData createEmptyInstance() => create();/ The details for this camera.
+@$pb.TagNumber(2)
+CameraDetails get details => $_getN(1);@$pb.TagNumber(2)
+set details(CameraDetails v) { setField(2, v); }@$pb.TagNumber(2)
+CameraDetails ensureDetails() => $_ensure(1);/ The latest frame from this camera.
+@$pb.TagNumber(3)
+$core.List<$core.int> get frame => $_getN(2);@$pb.TagNumber(3)
+set frame($core.List<$core.int> v) { $_setBytes(2, v); }@$core.pragma('dart2js:noInline')
+static VideoData getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<VideoData>(create);@$pb.TagNumber(2)
+$core.bool hasDetails() => $_has(1);@$pb.TagNumber(3)
+$core.bool hasFrame() => $_has(2);@$pb.TagNumber(1)
+$core.bool hasId() => $_has(0);/ The unique ID of this camera.
+@$pb.TagNumber(1)
+$core.String get id => $_getSZ(0);@$pb.TagNumber(1)
+set id($core.String v) { $_setString(0, v); }$pb.BuilderInfo get info_ => _i;Whether this data has a frame to show.
+A Protobuf bytes object is never null, only empty.
bool get hasFrame => frame.isNotEmpty;true if this message is marked read-only. Otherwise false.
+ updates to a copy of this message.
+ extension.
+ tagNumber, or the
+default value if it is not set.
+ true if a value of extension is present.
+ tagNumber.
+ data, a JSON object, encoded as described by
+GeneratedMessage.writeToJson.
+ other into this message.
+ json, a JSON object using proto3 encoding.
+ value.
+ tagNumber.
+ this.
+ Map.
+ factory WrappedMessage.fromBuffer($core.List<$core.int> i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromBuffer(i, r);factory WrappedMessage.fromJson($core.String i, [$pb.ExtensionRegistry r = $pb.ExtensionRegistry.EMPTY]) => create()..mergeFromJson(i, r);factory WrappedMessage({
+ $core.List<$core.int>? data,
+ $core.String? name,
+ $2.Timestamp? timestamp,
+}) {
+ final $result = create();
+ if (data != null) {
+ $result.data = data;
+ }
+ if (name != null) {
+ $result.name = name;
+ }
+ if (timestamp != null) {
+ $result.timestamp = timestamp;
+ }
+ return $result;
+}@$pb.TagNumber(1)
+void clearData() => clearField(1);@$pb.TagNumber(2)
+void clearName() => clearField(2);@$pb.TagNumber(3)
+void clearTimestamp() => clearField(3);Creates a deep copy of the fields in this message. +(The generated code uses mergeFromMessage.)
+@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.deepCopy] instead. '
+'Will be removed in next major version')
+WrappedMessage clone() => WrappedMessage()..mergeFromMessage(this);Apply updates to a copy of this message.
Makes a writable shallow copy of this message, applies the updates to
+it, and marks the copy read-only before returning it.
@$core.Deprecated(
+'Using this can add significant overhead to your binary. '
+'Use [GeneratedMessageGenericExtensions.rebuild] instead. '
+'Will be removed in next major version')
+WrappedMessage copyWith(void Function(WrappedMessage) updates) => super.copyWith((message) => updates(message as WrappedMessage)) as WrappedMessage;@$core.pragma('dart2js:noInline')
+static WrappedMessage create() => WrappedMessage._();Creates an empty instance of the same message type as this.
+This method is useful when you have a value of type GeneratedMessage or
+T extends GeneratedMessage and you want a new empty message with the
+same message type as the value. If you know the actual message type, it's
+more direct to use the constructor, and this method creates the same
+message as the message's constructor.
WrappedMessage createEmptyInstance() => create();static $pb.PbList<WrappedMessage> createRepeated() => $pb.PbList<WrappedMessage>();@$pb.TagNumber(1)
+$core.List<$core.int> get data => $_getN(0);@$pb.TagNumber(1)
+set data($core.List<$core.int> v) { $_setBytes(0, v); }@$core.pragma('dart2js:noInline')
+static WrappedMessage getDefault() => _defaultInstance ??= $pb.GeneratedMessage.$_defaultFor<WrappedMessage>(create);@$pb.TagNumber(1)
+$core.bool hasData() => $_has(0);@$pb.TagNumber(2)
+$core.bool hasName() => $_has(1);@$pb.TagNumber(3)
+$core.bool hasTimestamp() => $_has(2);$pb.BuilderInfo get info_ => _i;@$pb.TagNumber(2)
+$core.String get name => $_getSZ(1);@$pb.TagNumber(2)
+set name($core.String v) { $_setString(1, v); }@$pb.TagNumber(3)
+$2.Timestamp get timestamp => $_getN(2);@$pb.TagNumber(3)
+set timestamp($2.Timestamp v) { setField(3, v); }A callback to handle any WrappedMessage.
+typedef WrappedMessageHandler = void Function(WrappedMessage);The co2 sensor.
+const co2 = ScienceSensor(
+ name: "CO2",
+ test: co2Test,
+ testDescription: "Max CO2 greater than 10% of Min CO2: Extant",
+);The test to determine the presence of life based on CO2 data. +The max has to be greater than 10% greater than min for life to exist
+ScienceResult co2Test(SampleData data) => (data.max! >= (data.min! * 1.1))
+ ? ScienceResult.extant : ScienceResult.notPresent;The data library.
+This library defines any data types needed by the rest of the app. While the data classes may +have methods, the logic within should be simple, and any broad logic that changes state should +happen in the models library.
+This library should be the bottom of the dependency graph, meaning that no file included in this +library should import any other library.
+DateTimes.
+GeneratedMessages.
+Gets the name of the command message for the given device.
+String getCommandName(Device device) => switch (device) {
+ Device.ARM => "ArmCommand",
+ Device.GRIPPER => "GripperCommand",
+ Device.SCIENCE => "ScienceCommand",
+ Device.DRIVE => "DriveCommand",
+ _ => "Unknown",
+};Gets the name of the data message for the given device.
+String getDataName(Device device) => switch (device) {
+ Device.ARM => "ArmData",
+ Device.GRIPPER => "GripperData",
+ Device.SCIENCE => "ScienceData",
+ Device.DRIVE => "DriveData",
+ _ => "Unknown",
+};The humidity sensor.
+const humidity = ScienceSensor(
+ name: "Humidity",
+ test: humidityTest,
+ testDescription: "Average above 20%: Extant",
+);The test to determine the presence of life based on humidity data.
+ScienceResult humidityTest(SampleData data) => (data.average! > 20)
+ ? ScienceResult.extant : ScienceResult.notPresent;A list of all the sensors on the Science subsystem.
+const sensors = [temperature, humidity, co2];The temperature sensor.
+const temperature = ScienceSensor(
+ name: "Temperature",
+ test: temperatureTest,
+ testDescription: "Average between -15°C and 122°C: Extinct",
+);The test to determine the presence of life based on temperature data.
+ScienceResult temperatureTest(SampleData data) => (data.average! > -15 && data.average! < 122)
+ ? ScienceResult.extant : ScienceResult.notPresent;The base class for all exceptions thrown by the dashboard.
+When handling errors, you can either catch a specific class of errors or all errors at once.
+If you know which error or exception to expect, that works, but catching all errors could
+hide important ones that are meant to be fixed. This class defines the parent class of all
+exceptions the dashboard would throw on its own, which means higher-level functions can use
+this class to catch them and indicate an operation failed.
Exceptions are different than errors. An error indicates faulty code, while an exception means
+the underlying cause can be addressed even if it requires human intervention. All error cases
+that need to be caught and handled -- even if that means simply alerting the user -- should
+therefore be exceptions. For more information, see Exception vs Error.
When creating your own exception, be sure to override toString with a helpful message.
+Provides a const constructor.
+const DashboardException();The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();The Rover Control Dashboard is a graphical desktop application the Binghamton University Rover Team will use to operate and monitor the rover. It is a vital part of our remote command station.
+Every folder in this project has a purpose, but you’ll mostly need the lib folder.
.github: Contains GitHub specific files, like Actions workflow fileslib: Contains all the cross-platform Flutter code for the front and back endslinux: Contains Linux-specific code generated by flutter createmacos: Contains Mac-specific code generated by flutter createtest: Contains unit and integration tests for the projectwindows: Contains Windows-specific code generated by flutter createIt’s worth noting that the platform-specific directories do not contain the compiled executables. Those would be under the build directory, which is in the .gitignore file. These directories simply hold platform-specific configuration that was automatically generated by the flutter create command and may have since been customized by us.
lib is the main entry point for the project – flutter run really just runs lib/main.dart. The interesting code is in five libraries organized under lib/src.
data: Defines data classes needed for the app. See lib/data.dartservices: Defines and manages out-of-app resources. See lib/services.dartmodels: Hosts app-wide logic involving data models and services. See lib/models.dartwidgets: Defines small chunks of UI across the app. See lib/widgetspages: Hosts UI code for individual pages, made of widgets. See lib/pages.dartAs explained in the files listed above, these libraries are organized hierarchically, starting with data and ending with pages (and ultimately being imported by main.dart). Each library can only import libraries before it to avoid cyclic dependencies. Each library can get quite complex and contain several smaller libraries – this is only the high-level overview of the project’s structure.
A Dart library is technically just a file. To add more complexity, classes and functions are split into other files, and they are all collected into one main file that exports them all. For example, all the data classes are under lib/src/data, but you can import them by importing from lib/data.dart (using a package import: import package:rover_control_dashboard/data.dart). Specific documentation on individual libraries can be found in their corresponding library file.
Note that while Flutter technically supports multiple platforms, we focus our development on Windows. Compiling and launching on Mac or Linux is a plus though, as it lets us work on UI and other non-critical features.
+To run a debug build, run the appropriate command for your computer:
+flutter run -d windows
+flutter run -d linux
+flutter run -d macos
+To compile a release build, run the appropriate command for your computer:
+flutter build windows
+flutter build linux
+flutter build macos
+Note that Flutter's compiler is not cross-platform, which means you can only output executables for the platform you compile on. The location of the executable differs by platform:
+build\windows\runner\Releasebuild/linux/x64/release/bundlebuild/linux/x64/release/bundleTo analyze your code, run:
+flutter analyze --dartdocs
+This ensures that your code passes all the lint options defined in analysis_options.yaml.
Dependencies are managed in pubspec.yaml and refer to packages and plugins on https://pub.dev. Follow instructions there for adding packages to the project. When running any of the above compilation commands, Dart may detect updated dependencies and try to update them for you. When this happens, Git will indicate that pubspec.lock has changed.
While this is nice, we can avoid dependency-caused issues by ensuring we’re all using the same versions – that’s what pubspec.lock is for. Instead of giving a minimum version of a specific dependency, it lists the exact version for all dependencies, both our own dependencies and dependencies of our dependencies. Changes to this file should be tracked by version control. Practically, it is cumbersome to open a pull request virtually every time you compile your code. Instead, only submit your updated pubspec.lock as part of your other changes, which indicates that the new dependencies have been tested along with your changes.
The entrypoint of the app.
+These library declarations are not needed, the default name for a Dart library is simply the
+name of the file. However, DartDoc comments placed above a library declaration will show up on
+the libraries page in the generated documentation.
This library's main purpose is to execute the app defined in the app library and is designed to +be as simple as possible.
+void main() async {
+ runZonedGuarded(
+ () => runApp(RoverControlDashboard()),
+ (error, stack) async {
+ if (error is SocketException && networkErrors.contains(error.osError!.errorCode)) {
+ models.home.setMessage(severity: Severity.critical, text: "Network error, restart by clicking the network icon");
+ } else {
+ models.home.setMessage(severity: Severity.critical, text: "Dashboard error. See the logs");
+ await services.files.logError(error, stack);
+ Error.throwWithStackTrace(error, stack);
+ }
+ }
+ );
+}Network errors that can be fixed by a simple reset.
+const networkErrors = {1234, 1231};A specialized TextBuilder to handle IP addresses.
+Creates an IP address builder with the given initial value.
+AddressBuilder(super.value) : super(text: value.address);A regular expression representing a valid IP address.
+static final regex = RegExp(r"\d+\.\d+\.\d+\.\d+");Updates the value based on the user's input.
+Perform validation here and set error accordingly. You do not have to set value in this +function -- for example, if the user entered an invalid input.
+@override
+void update(String input) {
+ if (input.isEmpty) {
+ error = "Must not be blank";
+ } else if (regex.stringMatch(input) != input || input.endsWith(".")) {
+ error = "Not a valid IP";
+ } else if (input.split(".").any((part) => int.parse(part) > 255)) {
+ error = "IP out of range";
+ } else {
+ error = null;
+ value = InternetAddress(input);
+ }
+ notifyListeners();
+}A RoverControls that controls the arm.
+A human-readable explanation of what the controls are.
+Keys are the actions, values are the buttons that trigger them.
+@override
+Map<String, String> get buttonMapping => {
+ // Arm
+ if (settings.useIK) ...{
+ // IK
+ "IK control": "Right joystick",
+ "IK depth": "Bumpers",
+ } else ...{
+ // Manual control
+ "Swivel": "Right joystick (horizontal)",
+ "Shoulder": "Right joystick (vertical)",
+ "Elbow": "Left stick (vertical)",
+ "Pseudo-IK": "Bumpers",
+ },
+
+ // Gripper
+ "Lift gripper": "D-pad up/down",
+ "Rotate gripper": "D-pad left/right",
+ "Pinch": "Triggers",
+
+ // Custom actions
+ "Fully close": "A",
+ "Fully open": "B",
+ "Press keyboard": "X",
+ "Spin gripper": "Y",
+
+ // General
+ "Stop": "Select",
+ "Calibrate": "Start",
+};The coordinates of the gripper.
+The arm uses IK to move all the joints to stay at these coordinates.
+Coordinates ik = Coordinates(x: 0.5, y: 0.5, z: 0.5);Tracks whether the A button is pressed, so the action is only done once.
+bool isAPressed = false;Tracks whether the B button is pressed, so the action is only done once.
+bool isBPressed = false;Tracks whether the X button is pressed, so the action is only done once.
+bool isXPressed = false;Tracks whether the Y button is pressed, so the action is only done once.
+bool isYPressed = false;The OperatingMode for these controls.
+@override
+OperatingMode get mode => OperatingMode.arm;A list of commands that disables the subsystem.
+For example, after driving this should set the speed to 0.
+@override
+List<Message> get onDispose => [ ArmCommand(stop: true), GripperCommand(stop: true) ];Return a list of commands based on the current state of the gamepad.
+@override
+List<Message?> parseInputs(GamepadState state) => [
+ // Arm
+ if (settings.useIK) ...[
+ // IK
+ ...updateIK(state.normalRightX * settings.ikIncrement, state.normalShoulder * settings.ikIncrement, state.normalRightY * settings.ikIncrement),
+ ] else ...[
+ // Manual control
+ if (state.normalRightX != 0) ArmCommand(swivel: MotorCommand(moveRadians: state.normalRightX * settings.swivel)),
+ if (state.normalRightY != 0) ArmCommand(shoulder: MotorCommand(moveRadians: state.normalRightY * settings.shoulder)),
+ if (state.normalLeftY != 0) ArmCommand(elbow: MotorCommand(moveRadians: state.normalLeftY * settings.elbow)),
+ // The bumpers should be pseudo-IK: Move the shoulder and elbow in sync.
+ if (state.normalShoulder != 0) ArmCommand(
+ shoulder: MotorCommand(moveRadians: state.normalShoulder * settings.shoulder * -1),
+ elbow: MotorCommand(moveRadians: state.normalShoulder * settings.elbow),
+ ),
+ ],
+
+ // Gripper
+ if (state.normalDpadY != 0) GripperCommand(lift: MotorCommand(moveRadians: state.normalDpadY * settings.lift)),
+ if (state.normalDpadX != 0) GripperCommand(rotate: MotorCommand(moveRadians: state.normalDpadX * settings.rotate)),
+ if (state.normalTrigger != 0) GripperCommand(pinch: MotorCommand(moveRadians: state.normalTrigger * settings.pinch)),
+
+ // Custom actions
+ if (state.buttonA && !isAPressed) () { isAPressed = true; return GripperCommand(open: true); }(),
+ if (state.buttonB && !isBPressed) () { isBPressed = true; return GripperCommand(close: true); }(),
+ if (state.buttonX && !isXPressed) () { isXPressed = true; return ArmCommand(jab: true); }(),
+ if (state.buttonY && !isYPressed) () { isYPressed = true; return GripperCommand(spin: true); }(),
+
+ // General commands
+ if (state.buttonBack) ...[ArmCommand(stop: true), GripperCommand(stop: true)],
+ if (state.buttonStart) ...[ArmCommand(calibrate: true), GripperCommand(calibrate: true)],
+];The user's arm settings.
+ArmSettings get settings => models.settings.arm;Updates the IK coordinates by the given offsets.
+List<Message> updateIK(double x, double y, double z) {
+ if (x == 0 && y == 0 && z == 0) return [];
+ ik += Coordinates(x: x, y: y, z: z);
+ return [ArmCommand(ikX: 1, ikY: ik.y, ikZ: ik.z)];
+}Any logic to run before checking parseInputs.
+@override
+void updateState(GamepadState state) {
+ if (!state.buttonA) isAPressed = false;
+ if (!state.buttonB) isBPressed = false;
+ if (!state.buttonX) isXPressed = false;
+ if (!state.buttonY) isYPressed = false;
+}A ValueBuilder representing an ArmSettings.
+Modifies the given ArmSettings.
+ArmSettingsBuilder(ArmSettings initial) :
+ swivel = NumberBuilder(initial.swivel),
+ shoulder = NumberBuilder(initial.shoulder),
+ elbow = NumberBuilder(initial.elbow),
+ lift = NumberBuilder(initial.lift),
+ rotate = NumberBuilder(initial.rotate),
+ pinch = NumberBuilder(initial.pinch),
+ ik = NumberBuilder(initial.ikIncrement),
+ useIK = initial.useIK
+{
+ swivel.addListener(notifyListeners);
+ shoulder.addListener(notifyListeners);
+ elbow.addListener(notifyListeners);
+ lift.addListener(notifyListeners);
+ rotate.addListener(notifyListeners);
+ pinch.addListener(notifyListeners);
+ ik.addListener(notifyListeners);
+}The view model for ArmSettings.elbow.
+final NumberBuilder<double> elbow;The view model for ArmSettings.ikIncrement.
+final NumberBuilder<double> ik;Whether the value in the UI is valid.
+Do not try to access value if this is false.
+@override
+bool get isValid => swivel.isValid
+ && shoulder.isValid
+ && elbow.isValid
+ && lift.isValid
+ && rotate.isValid
+ && pinch.isValid
+ && ik.isValid;The view model for ArmSettings.lift.
+final NumberBuilder<double> lift;The view model for ArmSettings.pinch.
+final NumberBuilder<double> pinch;The view model for ArmSettings.rotate.
+final NumberBuilder<double> rotate;The view model for ArmSettings.shoulder.
+final NumberBuilder<double> shoulder;The view model for ArmSettings.swivel.
+final NumberBuilder<double> swivel;Updates the useIK variable.
+void updateIK(bool input) { // ignore: avoid_positional_boolean_parameters
+ useIK = input;
+ notifyListeners();
+}Whether to use manual control or IK.
+bool useIK;The value being updated in the UI.
+@override
+ArmSettings get value => ArmSettings(
+ shoulder: shoulder.value,
+ elbow: elbow.value,
+ swivel: swivel.value,
+ pinch: pinch.value,
+ lift: lift.value,
+ rotate: rotate.value,
+ ikIncrement: ik.value,
+ useIK: useIK,
+);Represents the state of a cell on the autonomy map.
+This is where the rover currently is.
+ + +This is where the rover is trying to go.
+ + +This cell has an obstacle the rover needs to avoid.
+ + +This cell is along the rover's path to its destination.
+ + +This cell is traversable but otherwise not of interest.
+ + +THis cell was manually marked as a point of interest.
+ + +The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;A numeric identifier for the enumerated value.
+The values of a single enumeration are numbered
+consecutively from zero to one less than the
+number of values.
+This is also the index of the value in the
+enumerated type's static values list.
int get index;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();A constant List of the values in this enum, in order of their declaration.
+A ValueBuilder to modify and send an AutonomyCommand.
+A constructor to call init when created.
+AutonomyCommandBuilder() { init(); }Forces the rover to go back to the previous waypoint.
+Future<void> abort() async {
+ _handshake = null;
+ isLoading = true;
+ notifyListeners();
+ final message = AutonomyCommand(abort: true);
+ // x3 just in case
+ models.sockets.autonomy.sendMessage(message);
+ models.sockets.autonomy.sendMessage(message);
+ models.sockets.autonomy.sendMessage(message);
+ models.home.setMessage(severity: Severity.info, text: "Aborting...");
+ await Future<void>.delayed(const Duration(seconds: 1));
+ if (_handshake != null) {
+ models.home.setMessage(severity: Severity.info, text: "Command received");
+ } else {
+ models.home.setMessage(severity: Severity.critical, text: "Command not received");
+ }
+ isLoading = false;
+ notifyListeners();
+}Discards any resources used by the object. After this is called, the +object is not in a usable state and should be discarded (calls to +addListener will throw after the object is disposed).
+This method should only be called by the object's owner.
+This method does not notify listeners, and clears the listener list once +it is called. Consumers of this class must decide on whether to notify +listeners or not immediately before disposal.
+@override
+void dispose() {
+ models.messages.removeHandler(AutonomyCommand().messageName);
+ super.dispose();
+}The view model to edit the AutonomyCommand.destination.
+final gps = GpsBuilder();Listens for incoming confirmations from the rover that it received the command.
+Future<void> init() async {
+ await Future<void>.delayed(const Duration(seconds: 1));
+ models.messages.registerHandler<AutonomyCommand>(
+ name: AutonomyCommand().messageName,
+ decoder: AutonomyCommand.fromBuffer,
+ handler: (data) => _handshake = data,
+ );
+}Whether the dashboard is awaiting a response from the rover.
+bool isLoading = false;Sends this command to the rover using Sockets.autonomy.
+Future<void> submit() async {
+ _handshake = null;
+ isLoading = true;
+ notifyListeners();
+ models.sockets.autonomy.sendMessage(value);
+ models.home.setMessage(severity: Severity.info, text: "Submitting autonomy command...");
+ await Future<void>.delayed(const Duration(seconds: 1));
+ if (_handshake != null) {
+ models.home.setMessage(severity: Severity.info, text: "Command received");
+ } else {
+ models.home.setMessage(severity: Severity.error, text: "Command not received");
+ }
+ isLoading = false;
+ notifyListeners();
+}The type of task the rover should complete.
+AutonomyTask task = AutonomyTask.GPS_ONLY;Updates the type of task being performed.
+void updateTask(AutonomyTask input) {
+ task = input;
+ notifyListeners();
+}The value being updated in the UI.
+@override
+AutonomyCommand get value => AutonomyCommand(
+ destination: gps.value,
+ task: task,
+);A view model for the autonomy page to render a grid map.
+Shows a bird's-eye map of where the rover is, what's around it, where the goal is, and the path +to get there. This class uses AutonomyData to keep track of the data as reported by the rover. +The grid is a 2D map of width and height gridSize that keeps the roverPosition in the +center (by keeping track of its offset) and filling the other cells with AutonomyCells.
+gps based on offset and adds it to the list.
+
+
+gps
+
+
+Listens for incoming autonomy or position data.
+AutonomyModel() { init(); }The audio player for the Bad Apple music
+final badAppleAudioPlayer = AudioPlayer();How many frames in a second are being shown
+static const badAppleFps = 1;Which frame in the Bad Apple video we are up to right now
+int badAppleFrame = 0;The last frame of Bad Apple
+static const badAppleLastFrame = 6570;A timer to update the map for every frame of Bad Apple
+Timer? badAppleTimer;Deletes all the markers in markers.
+void clearMarkers() {
+ markers.clear();
+ markerBuilder.clear();
+ notifyListeners();
+}The autonomy data as received from the rover.
+AutonomyData data = AutonomyData();Discards any resources used by the object. After this is called, the +object is not in a usable state and should be discarded (calls to +addListener will throw after the object is disposed).
+This method should only be called by the object's owner.
+This method does not notify listeners, and clears the listener list once +it is called. Consumers of this class must decide on whether to notify +listeners or not immediately before disposal.
+@override
+void dispose() {
+ models.messages.removeHandler(AutonomyData().messageName);
+ models.settings.removeListener(notifyListeners);
+ models.rover.metrics.position.removeListener(recenterRover);
+ badAppleAudioPlayer.dispose();
+ super.dispose();
+}An empty grid of size gridSize.
+List<List<(GpsCoordinates, AutonomyCell)>> get empty => [
+ for (int i = 0; i < gridSize; i++) [
+ for (int j = 0; j < gridSize; j++)
+ (GpsCoordinates(), AutonomyCell.empty),
+ ],
+];Converts a decimal GPS coordinate to an index representing the block in the grid.
+int gpsToBlock(double value) => (value / models.settings.dashboard.mapBlockSize).round();The grid of size gridSize with the rover in the center, ready to draw on the UI.
+List<List<(GpsCoordinates, AutonomyCell)>> get grid {
+ final result = empty;
+ for (final obstacle in data.obstacles) {
+ markCell(result, obstacle, AutonomyCell.obstacle);
+ }
+ if (isPlayingBadApple) return result;
+ for (final path in data.path) {
+ markCell(result, path, AutonomyCell.path);
+ }
+ for (final marker in markers) {
+ markCell(result, marker, AutonomyCell.marker);
+ }
+ // Marks the rover and destination -- these should be last
+ if (data.hasDestination()) markCell(result, data.destination, AutonomyCell.destination);
+ markCell(result, roverPosition, AutonomyCell.rover);
+ return result;
+}The amount of blocks in the width and height of the grid.
+Keep this an odd number to keep the rover in the center.
+int gridSize = 11;Initializes the view model.
+Future<void> init() async {
+ recenterRover();
+ await Future<void>.delayed(const Duration(seconds: 1));
+ models.messages.registerHandler<AutonomyData>(
+ name: AutonomyData().messageName,
+ decoder: AutonomyData.fromBuffer,
+ handler: onNewData,
+ );
+ models.rover.metrics.position.addListener(recenterRover);
+ models.settings.addListener(notifyListeners);
+ // Force the initial update, even with no new data.
+ recenterRover();
+ onNewData(AutonomyData());
+ }Whether the UI is currently playing Bad Apple
+bool isPlayingBadApple = false;Calculates a new position for gps based on offset and adds it to the list.
This function filters out any coordinates that shouldn't be shown based on gridSize.
+void markCell(List<List<(GpsCoordinates, AutonomyCell)>> list, GpsCoordinates gps, AutonomyCell value) {
+ // Latitude is y-axis, longitude is x-axis
+ // The rover will occupy the center of the grid, so
+ // - rover.longitude => (gridSize - 1) / 2
+ // - rover.latitude => (gridSize - 1) / 2
+ // Then, everything else should be offset by that
+ final x = gpsToBlock(gps.longitude) + offset.x;
+ final y = gpsToBlock(gps.latitude) + offset.y;
+ if (x < 0 || x >= gridSize) return;
+ if (y < 0 || y >= gridSize) return;
+ list[y][x] = (gps, value);
+}The view model to edit the coordinate of the marker.
+GpsBuilder markerBuilder = GpsBuilder();A list of markers manually placed by the user. Useful for the Extreme Retrieval Mission.
+List<GpsCoordinates> markers = [];The offset to add to all other coordinates, based on roverPosition. See recenterRover.
+GridOffset offset = const GridOffset(0, 0);A handler to call when new data arrives. Updates data and the UI.
+void onNewData(AutonomyData value) {
+ data = value;
+ services.files.logData(value);
+ notifyListeners();
+}Places the marker in markerBuilder.
+void placeMarker() {
+ markers.add(markerBuilder.value);
+ markerBuilder.clear();
+ notifyListeners();
+}Determines the new offset based on the current roverPosition.
+The autonomy grid is inherently unbounded, meaning we have to choose somewhere to bound the +grid. We chose to draw a grid of size gridSize with the rover in the center. This means we +need to add an offset to every other coordinates to draw it relative to the rover on-screen.
+For example, say the rover is at (2, 3), and there is an obstacle at (1, 2), with a grid
+size of 11. The rover should be at the center, (5, 5), so we need to add an offset of
+(3, 2) to get it there. That means we should also add (3, 2) to the obstacle's position
+so it remains (-1, -1) away from the rover's new position, yielding (4, 4).
void recenterRover() {
+ // final position = isPlayingBadApple ? GpsCoordinates() : roverPosition;
+ final position = isPlayingBadApple ? GpsCoordinates(latitude: (gridSize ~/ 2).toDouble(), longitude: (gridSize ~/ 2).toDouble()) : roverPosition;
+ final midpoint = ((gridSize - 1) / 2).floor();
+ final offsetX = midpoint - gpsToBlock(position.longitude);
+ final offsetY = midpoint - gpsToBlock(position.latitude);
+ offset = GridOffset(offsetX, offsetY);
+ notifyListeners();
+}The rover's heading
+double get roverHeading => models.rover.metrics.position.angle;The rover's current position.
+GpsCoordinates get roverPosition => models.rover.metrics.position.data.gps;Starts playing Bad Apple.
+Future<void> startBadApple() async {
+ isPlayingBadApple = true;
+ notifyListeners();
+ zoom(50);
+ badAppleFrame = 0;
+ badAppleTimer = Timer.periodic(const Duration(milliseconds: 1000 ~/ 30), _loadBadAppleFrame);
+ await badAppleAudioPlayer.setAsset("assets/bad_apple2.mp3");
+ badAppleAudioPlayer.play().ignore();
+}Stops playing Bad Apple and resets the UI.
+void stopBadApple() {
+ isPlayingBadApple = false;
+ badAppleTimer?.cancel();
+ data = AutonomyData();
+ badAppleAudioPlayer.stop();
+ zoom(11);
+ notifyListeners();
+}Removes a marker in gps
void updateMarker(GpsCoordinates gps) {
+ if(markers.remove(gps)){
+ notifyListeners();
+ } else {
+ models.home.setMessage(severity: Severity.info, text: "Marker not found");
+ }
+ }Zooms in or out by modifying gridSize.
+void zoom(int newSize) {
+ gridSize = newSize;
+ recenterRover();
+}A RoverControls for the rover's front and rear cameras.
+A human-readable explanation of what the controls are.
+Keys are the actions, values are the buttons that trigger them.
+@override
+Map<String, String> get buttonMapping => {
+ "Front camera": "Right trigger + joystick",
+ "Rear camera": "Left trigger + joystick",
+ "MARS swivel": "D-pad (horizontal)",
+};The OperatingMode for these controls.
+@override
+OperatingMode get mode => OperatingMode.cameras;A list of commands that disables the subsystem.
+For example, after driving this should set the speed to 0.
+@override
+List<Message> get onDispose => [];Return a list of commands based on the current state of the gamepad.
+@override
+List<Message> parseInputs(GamepadState state) => [
+ if (state.normalRightTrigger.abs() > 0.75) ...[
+ DriveCommand(frontSwivel: 90 - state.normalRightX * 90),
+ DriveCommand(frontTilt: 90 - state.normalRightY * 90),
+ ],
+ if (state.normalLeftTrigger.abs() > 0.75) ...[
+ DriveCommand(rearSwivel: 90 - state.normalLeftX * 90),
+ DriveCommand(rearTilt: 90 + state.normalLeftY * 90),
+ ],
+ if (state.normalDpadX != 0) MarsCommand(swivel: state.normalDpadX * pi / 50),
+];A ValueBuilder view model to modify a CameraDetails.
+Creates a ValueBuilder view model to change a CameraDetails.
+CameraDetailsBuilder(CameraDetails data) :
+ resolutionHeight = NumberBuilder(data.resolutionHeight, min: 0, max: 300),
+ resolutionWidth = NumberBuilder(data.resolutionWidth, min: 0, max: 300),
+ quality = NumberBuilder(data.quality, min: 0, max: 100),
+ fps = NumberBuilder(data.fps, min: 0, max: 60),
+ name = data.name,
+ status = CameraStatus.CAMERA_ENABLED;The error that occurrec when changing these settings, if any.
+String? error;How many frames per second to capture. See CameraDetails.fps.
+final NumberBuilder<int> fps;Whether changes are loading.
+bool isLoading = false;Whether the value in the UI is valid.
+Do not try to access value if this is false.
+@override
+bool get isValid => resolutionHeight.isValid
+ && resolutionWidth.isValid
+ && quality.isValid
+ && fps.isValid
+ && okStatuses.contains(status);The name of this camera.
+This should not be changed by the user as it will cause multiple cameras to stream +data under the same name and confuse the dashboard.
+final CameraName name;Statuses the user can set the camera to.
+static const okStatuses = [CameraStatus.CAMERA_ENABLED, CameraStatus.CAMERA_DISABLED];Other builders to listen to.
+@override
+List<ValueBuilder<dynamic>> get otherBuilders => [resolutionHeight, resolutionWidth, quality, fps];The quality of the camera, as a percentage. See CameraDetails.quality.
+final NumberBuilder<int> quality;The camera resolution's height. See CameraDetails.resolutionHeight.
+final NumberBuilder<int> resolutionHeight;The camera resolution's width. See CameraDetails.resolutionWidth.
+final NumberBuilder<int> resolutionWidth;Saves these settings to the rover and updates the UI.
+Future<bool> saveSettings(String id) async {
+ isLoading = true;
+ error = null;
+ notifyListeners();
+ try {
+ await models.video.updateCamera(id, value);
+ } on RequestNotAccepted {
+ error = "Rover did not accept this request";
+ }
+ isLoading = false;
+ notifyListeners();
+ return error == null;
+}The camera's status.
+The user cannot change this to any status, like CameraStatus.CAMERA_DISCONNECTED.
+CameraStatus status;Updates the status field.
+void updateStatus(CameraStatus? input) {
+ if (input == null) return;
+ if (!okStatuses.contains(input)) {
+ error = "You can't set that status";
+ notifyListeners();
+ return;
+ } else {
+ error = null;
+ }
+ status = input;
+ notifyListeners();
+}The value being updated in the UI.
+@override
+CameraDetails get value => CameraDetails(
+ resolutionHeight: resolutionHeight.value,
+ resolutionWidth: resolutionWidth.value,
+ quality: quality.value,
+ fps: fps.value,
+ name: name,
+ status: status,
+);A view model to modify a color and send it to the rover.
+value.
+
+
+Sets color to the rover's current color.
+ColorBuilder() : color = models.rover.settings.settings.color.toColor();The color to show in the UI.
+Color color;The error when calling setColor, if any.
+String? errorText;Whether setColor is still running.
+bool isLoading = false;Sets the LED strip on the rover to the color in value.
+Future<bool> setColor() async {
+ isLoading = true;
+ notifyListeners();
+ final color = ProtoColor().fromColor(value);
+ final result = await models.rover.settings.setColor(color);
+ errorText = result ? null : "The rover did not accept this command";
+ isLoading = false;
+ notifyListeners();
+ return result;
+}The value of the color slider in the UI.
+This will not match color on startup but that's okay.
+double slider = 0;Updates color based on the slider value.
void updateSlider(double value) {
+ color = HSVColor.lerp(minColor, maxColor, value)!.toColor();
+ slider = value;
+ notifyListeners();
+}The value being updated in the UI.
+@override
+Color get value => color;Utilities for color data.
+Creates a new ProtoColor from a Flutter Color.
+ProtoColor fromColor(Color other) => ProtoColor(
+ red: other.red / 255,
+ green: other.green / 255,
+ blue: other.blue / 255,
+);Uses the gamepad to control the rover.
+Each gamepad can only control one subsystem at a time, so this class uses controls to +keep track of what each button does in the current OperatingMode.
+Once every gamepadDelay, the gamepadTimer will trigger, which _updates the gamepad and
+call RoverControls.parseInputs to see what actions can be done. Each command is then sent
+with MessagesModel.sendMessage, which will either send them over the network or via serial.
Controller(this.gamepadIndex, this.controls);Connects the gamepad to the user's device.
+Future<void> connect() async {
+ await services.gamepad.connect(gamepadIndex);
+ if (gamepad.isConnected) {
+ models.home.setMessage(severity: Severity.info, text: "Connected to gamepad");
+ } else {
+ models.home.setMessage(severity: Severity.error, text: "No gamepad connected");
+ }
+ notifyListeners();
+}Defines what the current controls are for the current mode.
+RoverControls controls;Discards any resources used by the object. After this is called, the +object is not in a usable state and should be discarded (calls to +addListener will throw after the object is disposed).
+This method should only be called by the object's owner.
+This method does not notify listeners, and clears the listener list once +it is called. Consumers of this class must decide on whether to notify +listeners or not immediately before disposal.
+@override
+void dispose() {
+ gamepadTimer.cancel();
+ models.settings.removeListener(notifyListeners);
+ controls.onDispose.forEach(models.messages.sendMessage);
+ super.dispose();
+}The gamepad to read from.
+Gamepad get gamepad => services.gamepad.gamepads[gamepadIndex];The index of the gamepad to read from. Does not match Gamepad.controller.
+final int gamepadIndex;Reads the gamepad and controls the rover when triggered.
+late final Timer gamepadTimer;Initializes any data needed by this model.
+@override
+Future<void> init() async {
+ gamepadTimer = Timer.periodic(gamepadDelay, _update);
+ models.settings.addListener(notifyListeners);
+}Whether this controller is ready to use.
+bool get isConnected => gamepad.isConnected;The current operating mode.
+OperatingMode get mode => controls.mode;Changes the current mode this gamepad is controlling, and chooses a new RoverControls.
+void setMode(OperatingMode? mode) {
+ if (mode == null) return;
+ controls.onDispose.forEach(models.messages.sendMessage);
+ controls = RoverControls.forMode(mode);
+ gamepad.pulse();
+ notifyListeners();
+}Same as setMode, but uses OperatingMode.index instead.
+void setModeIndex(int index) => setMode(OperatingMode.values[index]);A ValueBuilder that modifies a DashboardSettings.
+Modifies the given DashboardSettings.
+DashboardSettingsBuilder(DashboardSettings initial) :
+ fps = NumberBuilder(initial.maxFps),
+ blockSize = NumberBuilder(initial.mapBlockSize),
+ splitMode = initial.splitMode,
+ themeMode = initial.themeMode;The precision of the GPS grid. See DashboardSettings.mapBlockSize.
+final NumberBuilder<double> blockSize;The builder for the FPS count.
+final NumberBuilder<int> fps;How the Dashboard should split when only two views are present.
+SplitMode splitMode;The theme of the Dashboard. See DashboardSettings.themeMode.
+ThemeMode themeMode;The value being updated in the UI.
+@override
+DashboardSettings get value => DashboardSettings(
+ maxFps: fps.value,
+ mapBlockSize: blockSize.value,
+ splitMode: splitMode,
+ themeMode: themeMode,
+);A view in the UI.
+A view can be a camera feed or any other UI element. Views are arranged in a grid.
+A const constructor.
+DashboardView({required this.name, required this.builder, this.key}) :
+ flutterKey = UniqueKey();A blank view.
+static final blank = DashboardView(
+ name: Routes.blank,
+ builder: (context) => ColoredBox(
+ color: context.colorScheme.brightness == Brightness.light
+ ? Colors.blueGrey
+ : Colors.blueGrey[700]!,
+ child: const Column(
+ children: [
+ Row(children: [Spacer(), ViewsSelector(currentView: Routes.blank)]),
+ Spacer(),
+ Text("Choose a view"),
+ Spacer(),
+ ],
+ ),
+ ),
+);A function to build this view.
+final WidgetBuilder builder;A list of views that represent all the camera feeds.
+static final List<DashboardView> cameraViews = [
+ for (final name in CameraName.values)
+ if (name != CameraName.CAMERA_NAME_UNDEFINED) DashboardView(
+ name: name.humanName,
+ key: name,
+ builder: (context) => VideoFeed(name: name),
+ ),
+];The Flutter widget key for this view.
+final Key flutterKey;The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;A unique key to use while selecting this view.
+final Object? key;The name of the view.
+final String name;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();A list of views that represent all non-camera feeds.
+static final List<DashboardView> uiViews = [
+ DashboardView(name: Routes.science, builder: (context) => SciencePage()),
+ DashboardView(name: Routes.autonomy, builder: (context) => MapPage()),
+ DashboardView(name: Routes.electrical, builder: (context) => ElectricalPage()),
+ DashboardView(name: Routes.arm, builder: (context) => ArmPage()),
+];A RoverControls that drives the rover.
+A human-readable explanation of what the controls are.
+Keys are the actions, values are the buttons that trigger them.
+@override
+Map<String, String> get buttonMapping => {
+ "Left Throttle": "Left joystick (vertical)",
+ "Right Throttle": "Right joystick (vertical)",
+ // "Drive Straight": "Triggers",
+ // "Turn in place": "Bumpers",
+};The OperatingMode for these controls.
+@override
+OperatingMode get mode => OperatingMode.drive;A list of commands that disables the subsystem.
+For example, after driving this should set the speed to 0.
+@override
+List<Message> get onDispose => [
+ DriveCommand(setThrottle: true, throttle: 0),
+ DriveCommand(setLeft: true, left: 0),
+ DriveCommand(setLeft: false, left: 0),
+];Return a list of commands based on the current state of the gamepad.
+@override
+List<Message> parseInputs(GamepadState state) => [
+ DriveCommand(setLeft: true, left: state.normalLeftY),
+ DriveCommand(setRight: true, right: -1*state.normalRightY),
+];A ValueBuilder that modifies an EasterEggsSettings.
+initial settings.
+ Fills in the fields with the given initial settings.
EasterEggsSettingsBuilder(EasterEggsSettings initial) :
+ badApple = initial.badApple,
+ enableClippy = initial.enableClippy,
+ segaSound = initial.segaSound,
+ segaIntro = initial.segaIntro;Whether to render Bad Apple in the Map page. See EasterEggsSettings.badApple.
+bool badApple;Whether Clippy should appear by log messages. See EasterEggsSettings.enableClippy.
+bool enableClippy;Whether to show a SEGA intro. See EasterEggsSettings.segaIntro.
+bool segaIntro;Whether to say "Binghamton" in the SEGA style. See EasterEggsSettings.segaSound.
+bool segaSound;Updates the value of badApple.
+void updateBadApple(bool input) { // ignore: avoid_positional_boolean_parameters
+ badApple = input;
+ notifyListeners();
+}Updates the value of EasterEggsSettings.enableClippy.
+void updateClippy(bool input) { // ignore: avoid_positional_boolean_parameters
+ enableClippy = input;
+ notifyListeners();
+}Updates the value of EasterEggsSettings.segaIntro.
+void updateSegaIntro(bool input) { // ignore: avoid_positional_boolean_parameters
+ segaIntro = input;
+ notifyListeners();
+}Updates the value of segaSound.
+void updateSegaSound(bool input) { // ignore: avoid_positional_boolean_parameters
+ segaSound = input;
+ notifyListeners();
+}The value being updated in the UI.
+@override
+EasterEggsSettings get value => EasterEggsSettings(
+ segaIntro: segaIntro,
+ segaSound: segaSound,
+ enableClippy: enableClippy,
+ badApple: badApple,
+ );The view model for the electrical analysis page.
+Listens to all the ScienceTestBuilders in the UI.
+ElectricalModel() {
+ metrics.addListener(_setFlag);
+ timer = Timer.periodic(const Duration(milliseconds: 10), _updateData);
+}Orientation for the graphs on page. true is row, false is column
+bool axis = false;Changes the axis that the UI displays the graphs
+void changeDirection(){
+ axis = !axis;
+ notifyListeners();
+}Clears all the readings from all the samples.
+void clear() {
+ voltageReadings.clear();
+ currentReadings.clear();
+ leftSpeeds.clear();
+ rightSpeeds.clear();
+ firstTimestamp = null;
+ notifyListeners();
+}Current readings over time.
+final DoubleLinkedQueue<SensorReading> currentReadings = DoubleLinkedQueue<SensorReading>();Discards any resources used by the object. After this is called, the +object is not in a usable state and should be discarded (calls to +addListener will throw after the object is disposed).
+This method should only be called by the object's owner.
+This method does not notify listeners, and clears the listener list once +it is called. Consumers of this class must decide on whether to notify +listeners or not immediately before disposal.
+@override
+void dispose() {
+ metrics.removeListener(_setFlag);
+ timer?.cancel();
+ super.dispose();
+}The timestamp of the first or earliest reading. All other timestamps are based on this.
+DateTime? firstTimestamp;Left speed readings over time.
+final DoubleLinkedQueue<SensorReading> leftSpeeds = DoubleLinkedQueue<SensorReading>();The maximum amount of readings on-screen before the data starts scrolling.
+static const maxReadings = 300;The Metrics model for electrical data.
+DriveMetrics get metrics => models.rover.metrics.drive;Right speed readings over time.
+final DoubleLinkedQueue<SensorReading> rightSpeeds = DoubleLinkedQueue<SensorReading>();The timer that grabs new data for these graphs.
+Timer? timer;Voltage readings over time.
+final DoubleLinkedQueue<SensorReading> voltageReadings = DoubleLinkedQueue<SensorReading>();A ValueBuilder to modify a GpsCoordinates object in either GpsType.
+Clears all the data in these text boxes.
+void clear() {
+ longDecimal.clear();
+ longDegrees.clear();
+ longMinutes.clear();
+ longSeconds.clear();
+
+ latDecimal.clear();
+ latDegrees.clear();
+ latMinutes.clear();
+ latSeconds.clear();
+ notifyListeners();
+}Whether the value in the UI is valid.
+Do not try to access value if this is false.
+@override
+bool get isValid => type == GpsType.decimal
+ ? (latDecimal.isValid && longDecimal.isValid)
+ : (latDegrees.isValid && longDegrees.isValid && latMinutes.isValid && longMinutes.isValid && latSeconds.isValid && longSeconds.isValid);Latitude in decimal degrees.
+final latDecimal = NumberBuilder<double>(0);Latitude in degrees.
+final latDegrees = NumberBuilder<int>(0);Latitude in minutes.
+final latMinutes = NumberBuilder<int>(0);Latitude in seconds.
+final latSeconds = NumberBuilder<int>(0);Longitude in decimal degrees.
+final longDecimal = NumberBuilder<double>(0);Longitude in degrees.
+final longDegrees = NumberBuilder<int>(0);Longitude in minutes.
+final longMinutes = NumberBuilder<int>(0);Longitude in seconds.
+final longSeconds = NumberBuilder<int>(0);Other builders to listen to.
+@override
+List<NumberBuilder<dynamic>> get otherBuilders => [
+ longDecimal, latDecimal,
+ longDegrees, longMinutes, longSeconds,
+ latDegrees, latMinutes, latSeconds,
+];The format to enter a GPS coordinate.
+GpsType type = GpsType.decimal;The value being updated in the UI.
+@override
+GpsCoordinates get value => switch (type) {
+ GpsType.decimal => GpsCoordinates(longitude: longDecimal.value, latitude: latDecimal.value),
+ GpsType.degrees => GpsCoordinates(
+ longitude: longDegrees.value + (longMinutes.value / 60) + (longSeconds.value / 3600),
+ latitude: latDegrees.value + (latMinutes.value / 60) + (latSeconds.value / 3600),
+ ),
+};The format to enter a GPS coordinate.
+Internally, all the math is done in decimal, but GpsBuilder supports degrees as well.
+The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;The human-readable name of the GPS type.
+String get humanName => switch (this) {
+ GpsType.degrees => "Degrees",
+ GpsType.decimal => "Decimal",
+};A numeric identifier for the enumerated value.
+The values of a single enumeration are numbered
+consecutively from zero to one less than the
+number of values.
+This is also the index of the value in the
+enumerated type's static values list.
int get index;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();A constant List of the values in this enum, in order of their declaration.
+Like an Offset from Flutter, but using integers instead of doubles.
+This is used to represent an offset from a position in a grid. Since the grid is represented +as a 2D list, the x and y coordinates must be integers to act as indexes. Use this class to +keep the rover centered in the UI.
+A const constructor.
+const GridOffset(this.x, this.y);The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();The X offset.
+final int x;The Y offset.
+final int y;The view model for the main page.
+pubspec.yaml.
+ clearErrors is set.
+
+
+Clears the current message. Errors won't be cleared unless clearErrors is set.
void clear({bool clearErrors = false}) {
+ if (_hasError && !clearErrors) return;
+ _hasError = false;
+ message = null;
+ notifyListeners();
+}Discards any resources used by the object. After this is called, the +object is not in a usable state and should be discarded (calls to +addListener will throw after the object is disposed).
+This method should only be called by the object's owner.
+This method does not notify listeners, and clears the listener list once +it is called. Consumers of this class must decide on whether to notify +listeners or not immediately before disposal.
+@override
+void dispose() {
+ _messageTimer?.cancel();
+ mission.cancel();
+ models.settings.removeListener(notifyListeners);
+ super.dispose();
+}Initializes any data needed by this model.
+@override
+Future<void> init() async {
+ models.settings.addListener(notifyListeners);
+ final info = await PackageInfo.fromPlatform();
+ version = "${info.version}+${info.buildNumber}";
+ if (services.error != null) setMessage(severity: Severity.critical, text: services.error!);
+}The message currently displaying on the taskbar.
+TaskbarMessage? message;Mission timer displayed on homepage
+final mission = MissionTimer();Sets a new message that will disappear in 3 seconds.
+void setMessage({required Severity severity, required String text, bool permanent = false}) {
+ if (_hasError && severity != Severity.critical) return; // Don't replace critical messages
+ _messageTimer?.cancel(); // the new message might be cleared if the old one were about to
+ message = TaskbarMessage(severity: severity, text: text);
+ notifyListeners();
+ _hasError = permanent;
+ _messageTimer = Timer(const Duration(seconds: 3), clear);
+}The dashboard's version from the pubspec.yaml.
String? version;A data model that collects and stores logs from the rover.
+The logs are kept in-memory in the allLogs list and are also saved to disk for retroactive +debugging. To prevent slowing down the dashboard or consuming too much memory, the in-memory +list is limited to maxLogCount, and logs are only saved to disk every saveToFileInterval.
+The most recent maxLogCount logs received.
+final ListQueue<BurtLog> allLogs = ListQueue();Clears all the logs from memory (but not from disk).
+void clear() {
+ allLogs.clear();
+ models.home.clear(clearErrors: true);
+ notifyListeners();
+}Sends a log message to be shown in the footer.
+void handleLog(BurtLog log) {
+ // Save to disk and memory
+ saveToFileBuffer.add(log);
+ allLogs.addWithLimit(log);
+ notifyListeners();
+
+ // Show important messages to the footer.
+ switch (log.level) {
+ case BurtLogLevel.critical: models.home.setMessage(severity: Severity.critical, text: log.title, permanent: true);
+ case BurtLogLevel.warning: models.home.setMessage(severity: Severity.warning, text: log.title);
+ case BurtLogLevel.error: models.home.setMessage(severity: Severity.error, text: log.title);
+ case BurtLogLevel.info: // Info messages from other devices are not important enough to show here
+ case BurtLogLevel.debug:
+ case BurtLogLevel.trace:
+ case BurtLogLevel.BURT_LOG_LEVEL_UNDEFINED:
+ }
+}Initializes any data needed by this model.
+@override
+Future<void> init() async {
+ models.messages.registerHandler<BurtLog>(name: BurtLog().messageName, decoder: BurtLog.fromBuffer, handler: handleLog);
+ saveToFileTimer = Timer.periodic(saveToFileInterval, saveToFile);
+}Saves all the logs in saveToFileBuffer to disk.
+Future<void> saveToFile(_) async {
+ if (saveToFileBuffer.isEmpty) return;
+ for (final log in List<BurtLog>.from(saveToFileBuffer)) {
+ await services.files.logMessage(log);
+ }
+ saveToFileBuffer.clear();
+}The logs received since the last flush to disk. See saveToFileInterval.
+List<BurtLog> saveToFileBuffer = [];How often to save the buffered logs to the log file.
+static const saveToFileInterval = Duration(seconds: 5);A timer that checks for unsaved logs and flushes them to disk.
+Timer? saveToFileTimer;A view model to track options for the logs page.
+This view model is needed to separate the menus from the main logs page as whenever a new log +message is added to the page, the currently-selected menu item would flicker.
+Whether this page should autoscroll.
+When scrolling manually, this will be set to false for convenience.
+bool autoscroll = true;Only show logs from this device. If null, show all devices.
+Device? deviceFilter;The level at which to show logs. All logs at this level or above are shown.
+BurtLogLevel levelFilter = BurtLogLevel.info;Resets the given device by sending RoverStatus.RESTART.
+void resetDevice(Device device) {
+ models.home.clear(clearErrors: true);
+ final socket = switch(device) {
+ Device.SUBSYSTEMS => models.sockets.data,
+ Device.AUTONOMY => models.sockets.autonomy,
+ Device.VIDEO => models.sockets.video,
+ _ => null,
+ };
+ final message = UpdateSetting(status: RoverStatus.RESTART);
+ socket?.sendMessage(message);
+}Enables or disables autoscroll.
+void setAutoscroll({bool? input}) {
+ if (input == null || autoscroll == input) return;
+ autoscroll = input;
+ Timer.run(notifyListeners);
+}Sets deviceFilter and updates the UI.
+void setDeviceFilter(Device? input) {
+ deviceFilter = input;
+ notifyListeners();
+}Sets levelFilter and updates the UI.
+void setLevelFilter(BurtLogLevel? input) {
+ if (input == null) return;
+ levelFilter = input;
+ notifyListeners();
+}A view model for the logs page to control which logs are shown.
+Listens for incoming logs.
+LogsViewModel() {
+ scrollController = ScrollController(
+ onAttach: _listenForScroll,
+ onDetach: _stopListeningForScroll,
+ );
+ models.logs.addListener(onNewLog);
+}Discards any resources used by the object. After this is called, the +object is not in a usable state and should be discarded (calls to +addListener will throw after the object is disposed).
+This method should only be called by the object's owner.
+This method does not notify listeners, and clears the listener list once +it is called. Consumers of this class must decide on whether to notify +listeners or not immediately before disposal.
+@override
+void dispose() {
+ models.logs.removeListener(onNewLog);
+ super.dispose();
+}Jumps to the bottom of the logs.
+void jumpToBottom() {
+ if (!scrollController.hasClients) return;
+ scrollController.animateTo(0, duration: const Duration(milliseconds: 500), curve: Curves.easeOutBack);
+}The logs that should be shown, according to LogsOptionsViewModel.
+List<BurtLog> get logs {
+ final result = <BurtLog>[];
+ for (final log in models.logs.allLogs) {
+ if (options.deviceFilter != null && log.device != options.deviceFilter) continue;
+ if (log.level.value > options.levelFilter.value) continue;
+ result.add(log);
+ }
+ return result.reversed.toList();
+}Scrolls to the bottom when a new log appears (if LogsOptionsViewModel.autoscroll is true).
+void onNewLog() {
+ notifyListeners();
+ if (!scrollController.hasClients) return;
+ scrollController.jumpTo(options.autoscroll ? 0 : scrollController.offset + 64);
+}Disables LogsOptionsViewModel.autoscroll when the user scrolls manually.
+void onScroll() {
+ final enableAutoscroll = scrollController.position.pixels == 0;
+ options.setAutoscroll(input: enableAutoscroll);
+}The options for the log page.
+final options = LogsOptionsViewModel();The scroll controller used to implement autoscroll.
+late final ScrollController scrollController;Updates the UI.
+void update() => notifyListeners();A RoverControls for the MARS subsystems.
+A human-readable explanation of what the controls are.
+Keys are the actions, values are the buttons that trigger them.
+@override
+Map<String, String> get buttonMapping => {
+ "Swivel": "Left joystick (horizontal)",
+ "Tilt": "Right joystick (vertical)",
+};The OperatingMode for these controls.
+@override
+OperatingMode get mode => OperatingMode.mars;A list of commands that disables the subsystem.
+For example, after driving this should set the speed to 0.
+@override
+List<Message> get onDispose => [];Return a list of commands based on the current state of the gamepad.
+@override
+List<Message> parseInputs(GamepadState state) => [
+ if (state.normalLeftX != 0) MarsCommand(swivel: state.normalLeftX * pi / 50),
+ if (state.normalRightY != 0) MarsCommand(tilt: state.normalRightY * 5000),
+];A mixin that delegates WrappedMessages to a handler via registerHandler.
+A set of message types that are allowed to pass through without being handled.
+static const Set<String> allowedFallthrough = {"AutonomyData", "Disconnect"};The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);Delegates the message contents to the appropriate handler.
+void onMessage(WrappedMessage wrapper) {
+ final rawHandler = _handlers[wrapper.name];
+ if (rawHandler == null) {
+ if (allowedFallthrough.contains(wrapper.name)) return;
+ throw StateError("No handler registered for ${wrapper.name} message");
+ }
+ try { return rawHandler(wrapper.data); }
+ on InvalidProtocolBufferException {
+ try { return rawHandler(wrapper.data); }
+ on InvalidProtocolBufferException { /* Nothing we can do */ }
+ }
+}The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);Adds a handler for the given message type.
+When a new message is received, onMessage checks to see if its type matches name.
+If so, it calls decoder to parse the binary data into a Protobuf class, and then
+calls handler with that parsed data class.
For example, with a message called ScienceData, you would use this function as:
registerHandler<ScienceData>(
+ name: ScienceData().messageName, // identify the data as a ScienceData message
+ decoder: ScienceData.fromBuffer, // deserialize into a ScienceData instance
+ handler: (ScienceData data) => print(data.methane), // do something with the data
+);
+void registerHandler<T extends Message>({
+ required String name,
+ required MessageDecoder<T> decoder,
+ required MessageHandler<T> handler,
+}) {
+ if (_handlers.containsKey(name)) { // handler was already registered
+ throw ArgumentError("There's already a message handler for $name.");
+ } else {
+ _handlers[name] = (data) => handler(decoder(data));
+ }
+}Removes the handler for a given message type.
+This is useful if you register a handler to update a piece of UI that is no longer on-screen.
+void removeHandler(String name) => _handlers.remove(name);A representation of the runtime type of the object.
+external Type get runtimeType;Sends a command over the network or over Serial.
+void sendMessage(Message message) {
+ models.serial.sendMessage(message);
+ models.sockets.data.sendMessage(message);
+}A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();A timer to keep track of progress in a mission.
+ +Cancels the timer.
+void cancel() {
+ title = null;
+ _timer?.cancel();
+ notifyListeners();
+}Whether this timer is paused.
+bool isPaused = false;Pauses the timer.
+void pause() {
+ isPaused = true;
+ _timer?.cancel();
+ notifyListeners();
+}Resumes the timer.
+void resume() {
+ isPaused = false;
+ _timer = Timer.periodic(const Duration(seconds: 1), _update);
+}Starts a new timer with the given title and duration. Cancels any previous timer.
+void start({required String title, required Duration duration}) {
+ cancel();
+ isPaused = false;
+ this.title = title;
+ timeLeft = duration;
+ _timer = Timer.periodic(const Duration(seconds: 1), _update);
+ notifyListeners();
+}The time remaining. Stops decreasing when isPaused is true.
+Duration timeLeft = Duration.zero;The title for this timer. Null means no timer has been set.
+String? title;Whether this timer has under a minute remaining.
+bool get underMin => timeLeft <= const Duration(minutes: 1);A data model that handles data from services.
+Initializes any data needed by this model.
+Future<void> init();A wrapper model around all other data models used by the app.
+Use this class to ensure a data model will be initialized before the dashboard starts. For a
+view model (a model that only needs to be used in one part of the UI), use the model directly
+with a ChangeNotifierProvider from package:provider.
When adding a new model to this class, be sure to:
+MultiProvider in app.dartDiscards any resources used by the object. After this is called, the +object is not in a usable state and should be discarded (calls to +addListener will throw after the object is disposed).
+This method should only be called by the object's owner.
+This method does not notify listeners, and clears the listener list once +it is called. Consumers of this class must decide on whether to notify +listeners or not immediately before disposal.
+@override
+void dispose() {
+ settings.dispose();
+ home.dispose();
+ video.dispose();
+ rover.dispose();
+ serial.dispose();
+ sockets.dispose();
+ views.dispose();
+
+ super.dispose();
+}Contains persistent data about the dashboard's current state.
+final home = HomeModel();Initializes any data needed by this model.
+@override
+Future<void> init() async {
+ // initialize all models here
+ await settings.init();
+ await home.init();
+ await logs.init();
+ await video.init();
+ await rover.init();
+ await serial.init();
+ await sockets.init();
+ await views.init();
+
+ isReady = true;
+ notifyListeners();
+}Whether all models have been initialized.
+bool isReady = false;The logs model.
+final logs = LogsModel();The messages model.
+final messages = MessagesModel();Controls and interacts with the rover.
+final rover = Rover();Responsible for connecting to and monitoring Serial devices.
+final serial = SerialModel();Caches the settings and updates them to all listeners.
+final settings = SettingsModel();The data model responsible for communicating over Protobuf.
+final sockets = Sockets();The data model to provide video from the rover.
+final video = VideoModel();The views data model.
+final views = ViewsModel();A ValueBuilder representing a NetworkSettings.
+Creates the view model based on the current Settings.
+NetworkSettingsBuilder(NetworkSettings initial) :
+ dataSocket = SocketBuilder(initial.subsystemsSocket),
+ videoSocket = SocketBuilder(initial.videoSocket),
+ autonomySocket = SocketBuilder(initial.autonomySocket),
+ tankSocket = SocketBuilder(initial.tankSocket);The view model representing the SocketInfo for the autonomy program.
+final SocketBuilder autonomySocket;The view model representing the SocketInfo for the subsystems program.
+final SocketBuilder dataSocket;Whether the value in the UI is valid.
+Do not try to access value if this is false.
+@override
+bool get isValid => dataSocket.isValid
+ && videoSocket.isValid
+ && autonomySocket.isValid
+ && tankSocket.isValid;Other builders to listen to.
+@override
+List<SocketBuilder> get otherBuilders => [dataSocket, videoSocket, autonomySocket, tankSocket];The view model representing the SocketInfo for the tank.
+Since the tank runs multiple programs, the port is discarded and only the address is used.
+final SocketBuilder tankSocket;The value being updated in the UI.
+@override
+NetworkSettings get value => NetworkSettings(
+ subsystemsSocket: dataSocket.value,
+ videoSocket: videoSocket.value,
+ autonomySocket: autonomySocket.value,
+ tankSocket: tankSocket.value,
+ connectionTimeout: 5,
+);The view model representing the SocketInfo for the video program.
+final SocketBuilder videoSocket;A RoverControls that does nothing.
+A human-readable explanation of what the controls are.
+Keys are the actions, values are the buttons that trigger them.
+@override
+Map<String, String> get buttonMapping => {};The OperatingMode for these controls.
+@override
+OperatingMode get mode => OperatingMode.none;A list of commands that disables the subsystem.
+For example, after driving this should set the speed to 0.
+@override
+List<Message> get onDispose => [];Return a list of commands based on the current state of the gamepad.
+@override
+List<Message> parseInputs(GamepadState state) => [];A specialized TextBuilder to handle numeric inputs.
+T can be either int or double, and the UI will validate that.
Creates a number builder based on an initial value.
+NumberBuilder(super.value, {this.min, this.max});Clears the value in this builder.
+void clear() {
+ error = null;
+ value = (isInteger ? 0 : 0.0) as T;
+ controller.text = value.toString();
+ notifyListeners();
+}Whether this builder is modifying a decimal number.
+bool get isInteger => List<int> == List<T>;The maximum allowed value.
+final num? max;The minimum allowed value.
+final num? min;Updates the value based on the user's input.
+Perform validation here and set error accordingly. You do not have to set value in this +function -- for example, if the user entered an invalid input.
+@override
+void update(String input) {
+ if (input.isEmpty) {
+ error = "Empty";
+ } else if (double.tryParse(input) == null) {
+ error = "Invalid number";
+ } else if (isInteger && int.tryParse(input) == null) {
+ error = "Not an integer";
+ } else {
+ error = null;
+ final result = isInteger ? (int.parse(input) as T) : (double.parse(input) as T);
+ if (min != null && result < min!) error = "Must be >$min";
+ if (max != null && result > max!) error = "Must be <$max";
+ value = result;
+ }
+ notifyListeners();
+}An exception thrown when the rover does not respond to a handshake.
+Certain changes require a handshake to ensure the rover has received and applied the change. +If the rover fails to acknowledge or apply the change, a response will not be sent. Throw +this error to indicate that.
+The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();The model to control the entire rover.
+Find more specific functionality in this class's fields.
+Listens for inputs on the first connected gamepad.
+final controller1 = Controller(0, DriveControls());Listens for inputs on the second connected gamepad.
+final controller2 = Controller(1, ArmControls());Listens for inputs on the third connected gamepad.
+final controller3 = Controller(2, CameraControls());Discards any resources used by the object. After this is called, the +object is not in a usable state and should be discarded (calls to +addListener will throw after the object is disposed).
+This method should only be called by the object's owner.
+This method does not notify listeners, and clears the listener list once +it is called. Consumers of this class must decide on whether to notify +listeners or not immediately before disposal.
+@override
+void dispose() {
+ metrics.removeListener(notifyListeners);
+ settings.removeListener(notifyListeners);
+
+ metrics.dispose();
+ controller1.dispose();
+ controller2.dispose();
+ controller3.dispose();
+ settings.dispose();
+ super.dispose();
+}Initializes any data needed by this model.
+@override
+Future<void> init() async {
+ await metrics.init();
+ await controller1.init();
+ await controller2.init();
+ await controller3.init();
+ await settings.init();
+
+ metrics.addListener(notifyListeners);
+ settings.addListener(notifyListeners);
+}Whether the rover is connected.
+bool get isConnected => models.sockets.data.isConnected;Monitors metrics coming from the rover.
+final metrics = RoverMetrics();A model to adjust settings on the rover.
+final settings = RoverSettings();The current status of the rover.
+ValueNotifier<RoverStatus> status = ValueNotifier(RoverStatus.DISCONNECTED);A class that controls one subsystem based on the gamepad state.
+To use this class, subclass it and implement parseInputs. Be sure to add your class to the +RoverControls.forMode constructor so it can be used within the UI.
+Creates the appropriate RoverControls for this mode.
+factory RoverControls.forMode(OperatingMode mode) {
+ switch (mode) {
+ case OperatingMode.arm: return ArmControls();
+ case OperatingMode.science: return ScienceControls();
+ case OperatingMode.drive: return DriveControls();
+ case OperatingMode.mars: return MarsControls();
+ case OperatingMode.none: return NoControls();
+ case OperatingMode.cameras: return CameraControls();
+ }
+}Classes with a factory constructor must also have a regular constructor to be overriden.
+const RoverControls();A human-readable explanation of what the controls are.
+Keys are the actions, values are the buttons that trigger them.
+Map<String, String> get buttonMapping;The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;The OperatingMode for these controls.
+OperatingMode get mode;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);A list of commands that disables the subsystem.
+For example, after driving this should set the speed to 0.
+Iterable<Message> get onDispose;The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);Return a list of commands based on the current state of the gamepad.
+Iterable<Message?> parseInputs(GamepadState state);A representation of the runtime type of the object.
+external Type get runtimeType;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();Any logic to run before checking parseInputs.
+void updateState(GamepadState state) { }A data model that listens for updated data and provides Metrics to the UI.
+A list of all the metrics to iterate over.
+NOTE: Keep this as a getter, NOT a field. If this is made a field, then it won't update +when new data is received. As a getter, every time it is called it will use new data.
+List<Metrics> get allMetrics => [position, drive, science, arm, gripper];Data from the HREI subsystem about the arm base.
+final arm = ArmMetrics();Data from the drive subsystem.
+final drive = DriveMetrics();Data from the HREI subsystem about the gripper.
+final gripper = GripperMetrics();Initializes any data needed by this model.
+@override
+Future<void> init() async {
+ models.messages.registerHandler<DriveData>(
+ name: DriveData().messageName,
+ decoder: DriveData.fromBuffer,
+ handler: drive.update,
+ );
+ models.messages.registerHandler<ScienceData>(
+ name: ScienceData().messageName,
+ decoder: ScienceData.fromBuffer,
+ handler: science.update,
+ );
+ models.messages.registerHandler<RoverPosition>(
+ name: RoverPosition().messageName,
+ decoder: RoverPosition.fromBuffer,
+ handler: position.update,
+ );
+ models.messages.registerHandler<ArmData>(
+ name: ArmData().messageName,
+ decoder: ArmData.fromBuffer,
+ handler: arm.update,
+ );
+ models.messages.registerHandler<GripperData>(
+ name: GripperData().messageName,
+ decoder: GripperData.fromBuffer,
+ handler: gripper.update,
+ );
+}Data from the GPS.
+final position = PositionMetrics();Data from the science subsystem.
+final science = ScienceMetrics();Analysis for one sample and sensor.
+A constructor.
+ScienceAnalysis(this.sensor);Adds a reading to this analysis.
+void addReading(Timestamp timestamp, double value) {
+ data.addReading(timestamp, value);
+ testBuilder.update(data);
+}Clears all readings from this analysis.
+void clear() {
+ data.clear();
+ testBuilder.update(data);
+}The data being recorded.
+final SampleData data = SampleData();The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;The sensor being analyzed.
+final ScienceSensor sensor;The view models for the test values.
+final testBuilder = ScienceTestBuilder();Passes the overriden data to the sensor's test to determine signs of life.
+ScienceResult get testResult => data.readings.isEmpty
+ ? ScienceResult.loading : sensor.test(SampleData()
+ ..min = testBuilder.min.value
+ ..average = testBuilder.average.value
+ ..max = testBuilder.max.value,
+ );A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();A ValueBuilder to modify and send an AutonomyCommand.
+Listens to changes in the sample number.
+@override
+List<ValueBuilder<dynamic>> get otherBuilders => [sample];The sample number being tested.
+final sample = NumberBuilder<int>(1, min: 1, max: 3);Sends the command to the science subsystem.
+Future<void> send() async {
+ models.messages.sendMessage(value);
+ models.home.setMessage(severity: Severity.info, text: "Science command submitted. Check the video feed to confirm");
+}Whether the science program should collect data.
+ScienceState state = ScienceState.STOP_COLLECTING;Updates the state and refreshes the UI.
+void updateState(ScienceState input) {
+ state = input;
+ notifyListeners();
+}The value being updated in the UI.
+@override
+ScienceCommand get value => ScienceCommand(
+ sample: sample.value,
+ state: state,
+);A RoverControls that controls the science chamber.
+A human-readable explanation of what the controls are.
+Keys are the actions, values are the buttons that trigger them.
+@override
+Map<String, String> get buttonMapping => {
+ "Vacuum Linear": "Left Stick (vertical)",
+ "Science Linear": "Right Stick (vertical)",
+ "Dirt Linear": "D-pad left/right",
+ "Dirt carousel": "Bumpers",
+ "Vacuum power": "Left Trigger",
+ "Vacuum release": "D-pad up/down",
+ "Pumps": "A/B/X/Y",
+};The OperatingMode for these controls.
+@override
+OperatingMode get mode => OperatingMode.science;A list of commands that disables the subsystem.
+For example, after driving this should set the speed to 0.
+@override
+List<Message> get onDispose => [ScienceCommand(stop: true)];Return a list of commands based on the current state of the gamepad.
+@override
+List<Message> parseInputs(GamepadState state) => [
+ if (state.normalLeftY != 0) ScienceCommand(vacuumLinear: state.normalLeftY*1000),
+ if (state.normalRightY != 0) ScienceCommand(scienceLinear: state.normalRightY*-10000),
+ if (state.normalDpadX != 0) ScienceCommand(dirtLinear: state.normalDpadX * 10000),
+ if (state.dpadUp) ScienceCommand(dirtRelease: DirtReleaseState.CLOSE_DIRT),
+ if (state.dpadDown) ScienceCommand(dirtRelease: DirtReleaseState.OPEN_DIRT),
+ if (state.leftShoulder) ScienceCommand(dirtCarousel: -1000),
+ if (state.rightShoulder) ScienceCommand(dirtCarousel: 1000),
+ // These must be sent at all times to allow sending zero values
+ if (state.buttonA) ScienceCommand(pump1: PumpState.PUMP_ON)
+ else ScienceCommand(pump1: PumpState.PUMP_OFF),
+ if (state.buttonB) ScienceCommand(pump2: PumpState.PUMP_ON)
+ else ScienceCommand(pump2: PumpState.PUMP_OFF),
+ if (state.buttonX) ScienceCommand(pump3: PumpState.PUMP_ON)
+ else ScienceCommand(pump3: PumpState.PUMP_OFF),
+ if (state.buttonY) ScienceCommand(pump4: PumpState.PUMP_ON)
+ else ScienceCommand(pump4: PumpState.PUMP_OFF),
+ if (state.normalTrigger != 0) ScienceCommand(vacuum: PumpState.PUMP_ON)
+ else ScienceCommand(vacuum: PumpState.PUMP_OFF),
+
+ if (state.buttonStart) ScienceCommand(calibrate: true),
+ if (state.buttonBack) ScienceCommand(stop: true),
+];The view model for the science analysis page.
+Listens to all the ScienceTestBuilders in the UI.
+ScienceModel() {
+ metrics.addListener(updateData);
+ for (final sample in analysesForSample) {
+ sample.testBuilder.addListener(notifyListeners);
+ }
+}Adds a WrappedMessage containing a ScienceData to the UI.
+void addMessage(WrappedMessage wrapper) {
+ if (!wrapper.name.contains(ScienceData().messageName)) throw ArgumentError("Incorrect log type: ${wrapper.name}");
+ final data = wrapper.decode(ScienceData.fromBuffer);
+ final sample = data.sample;
+ if (!wrapper.hasTimestamp()) { throw ArgumentError("Data is missing a timestamp"); }
+ if (sample >= numSamples) throw RangeError("Got data for sample #${sample + 1}, but there are only $numSamples samples.\nChange the number of samples in the settings and reload.");
+ if (data.co2 != 0) addReading(co2, sample, wrapper.timestamp, data.co2);
+ if (data.humidity != 0) addReading(humidity, sample, wrapper.timestamp, data.humidity);
+ if (data.temperature != 0) addReading(temperature, sample, wrapper.timestamp, data.temperature);
+}Adds a value to the correct analysis for the sensor and sample.
+void addReading(ScienceSensor sensor, int sample, Timestamp timestamp, double value) =>
+ allSamples[sensor]![sample].addReading(timestamp, value);A list of all the samples for all the sensors.
+Map<ScienceSensor, List<ScienceAnalysis>> allSamples = {
+ for (final sensor in sensors) sensor: [
+ for (int i = 0; i < models.settings.science.numSamples; i++)
+ ScienceAnalysis(sensor),
+ ],
+};All the sensors for the current sample.
+List<ScienceAnalysis> get analysesForSample => [
+ for (final sensor in sensors) allSamples[sensor]![sample],
+];Clears all the readings from all the samples.
+void clear() {
+ for (final sensor in sensors) {
+ for (final analysis in allSamples[sensor]!) {
+ analysis.clear();
+ }
+ }
+ isListening = true;
+ models.home.setMessage(severity: Severity.info, text: "Science UI will update on new data");
+}Discards any resources used by the object. After this is called, the +object is not in a usable state and should be discarded (calls to +addListener will throw after the object is disposed).
+This method should only be called by the object's owner.
+This method does not notify listeners, and clears the listener list once +it is called. Consumers of this class must decide on whether to notify +listeners or not immediately before disposal.
+@override
+void dispose() {
+ metrics.removeListener(updateData);
+ for (final sample in analysesForSample) {
+ sample.testBuilder.dispose();
+ }
+ super.dispose();
+}The error, if any, that occurred while loading the data.
+String? errorText;Whether to listen for new data from the rover. This is false after loading a file.
+bool isListening = true;Whether the page is currently loading.
+bool isLoading = false;Calls addMessage for each message in the picked file.
+Future<void> loadFile() async {
+ // Pick a file
+ clear();
+ isLoading = true;
+ notifyListeners();
+ final result = await FilePicker.platform.pickFiles(
+ dialogTitle: "Choose science logs",
+ initialDirectory: services.files.loggingDir.path,
+ );
+ if (result == null || result.count == 0) {
+ isLoading = false;
+ notifyListeners();
+ return;
+ }
+
+ // Read the file
+ final file = File(result.paths.first!);
+ try {
+ final messages = await services.files.readLogs(file);
+ messages.forEach(addMessage);
+ errorText = null;
+ isLoading = false;
+ isListening = false;
+ models.home.setMessage(severity: Severity.info, text: "Science logs loaded, new data will be ignored");
+ notifyListeners();
+ } catch (error) {
+ errorText = error.toString();
+ isLoading = false;
+ notifyListeners();
+ rethrow;
+ }
+}The Metrics model for science data.
+ScienceMetrics get metrics => models.rover.metrics.science;How many samples to analyze. Can be changed in the settings.
+int get numSamples => models.settings.science.numSamples;The sample whose stats are being displayed.
+int sample = 0;Updates the graph using addMessage with the latest data from metrics.
+void updateData() {
+ if (!isListening) return;
+ addMessage(metrics.data.wrap());
+ notifyListeners();
+}Updates the sample variable.
+void updateSample(int? input) {
+ if (input == null) return;
+ sample = input;
+ notifyListeners();
+}A ValueBuilder that modifies a ScienceSettings.
+Modifies the given ScienceSettings.
+ScienceSettingsBuilder(ScienceSettings initial) :
+ numSamples = NumberBuilder(initial.numSamples),
+ scrollableGraphs = initial.scrollableGraphs;The number of samples collected. See ScienceSettings.numSamples.
+NumberBuilder<int> numSamples;Whether the graphs can scrolls. See ScienceSettings.scrollableGraphs.
+bool scrollableGraphs;Modifies scrollableGraphs.
+void updateScrollableGraphs(bool input) { // ignore: avoid_positional_boolean_parameters
+ scrollableGraphs = input;
+ notifyListeners();
+}The value being updated in the UI.
+@override
+ScienceSettings get value => ScienceSettings(
+ scrollableGraphs: scrollableGraphs,
+ numSamples: numSamples.value,
+);A view model to allow the user to override values supplied to ScienceTests.
+A constructor.
+ScienceTestBuilder() {
+ min.addListener(notifyListeners);
+ average.addListener(notifyListeners);
+ max.addListener(notifyListeners);
+}An override for the average value.
+final average = NumberBuilder<double>(0);Discards any resources used by the object. After this is called, the +object is not in a usable state and should be discarded (calls to +addListener will throw after the object is disposed).
+This method should only be called by the object's owner.
+This method does not notify listeners, and clears the listener list once +it is called. Consumers of this class must decide on whether to notify +listeners or not immediately before disposal.
+@override
+void dispose() {
+ min..removeListener(notifyListeners)..dispose();
+ average..removeListener(notifyListeners)..dispose();
+ max..removeListener(notifyListeners)..dispose();
+ super.dispose();
+}An override for the maximum value.
+final max = NumberBuilder<double>(0);An override for the minimum value.
+final min = NumberBuilder<double>(0);Updates the view models with the latest data.
+void update(SampleData data) {
+ min.value = data.min ?? 0;
+ min.controller.text = min.value.toString();
+ average.value = data.average ?? 0;
+ average.controller.text = average.value.toString();
+ max.value = data.max ?? 0;
+ max.controller.text = max.value.toString();
+ notifyListeners();
+}A data model to manage all connected serial devices.
+Each connected device is represented by a SerialDevice object in the devices map. +This model offers an API to connect, disconnect, and query devices using their port +names instead.
+Send messages to the connected devices using the sendMessage method, and all messages +received all ports are forwarded to MessagesModel.onMessage.
+Connects to the given serial port and adds an entry to devices.
+If the connection or handshake fails, a message is logged to the home screen +and the device is not added to devices.
+Future<void> connect(String port) async {
+ models.home.setMessage(severity: Severity.info, text: "Connecting to $port...");
+ final device = SerialDevice(port: port, onMessage: models.messages.onMessage);
+ try {
+ await device.connect();
+ } on SerialException catch(error) {
+ device.dispose();
+ models.home.setMessage(severity: Severity.error, text: error.toString());
+ return;
+ }
+ models.home.setMessage(severity: Severity.info, text: "Connected to $port");
+ devices[port] = device;
+ notifyListeners();
+}All the connected devices and their respective serial ports.
+Devices listed here are assumed to have successfully connected.
+Map<String, SerialDevice> devices = {};Disconnects the device on the given port, if any, and removes its entry from devices.
+void disconnect(String port) {
+ final device = devices[port];
+ if (device == null) return;
+ device.dispose();
+ devices.remove(port);
+ models.home.setMessage(severity: Severity.info, text: "Disconnected from $port");
+ notifyListeners();
+}Returns true if any device is connected.
+bool get hasDevice => devices.isNotEmpty;Initializes any data needed by this model.
+@override
+Future<void> init() async { }Whether the given port is connected.
+bool isConnected(String port) => devices.containsKey(port);Sends a message to all connected devices.
+SerialDevice.sendMessage ensures that only the correct messages get sent to each device.
+void sendMessage(Message message) {
+ for (final device in devices.values) {
+ device.sendMessage(message);
+ }
+}Either connects or disconnects the device on the given port.
+void toggle(String port) => isConnected(port) ? disconnect(port) : connect(port);A ValueBuilder representing an ArmSettings.
+Modifies the user's settings.
+SettingsBuilder() :
+ network = NetworkSettingsBuilder(models.settings.network),
+ arm = ArmSettingsBuilder(models.settings.arm),
+ science = ScienceSettingsBuilder(models.settings.science),
+ dashboard = DashboardSettingsBuilder(models.settings.dashboard),
+ easterEggs = EasterEggsSettingsBuilder(models.settings.easterEggs)
+{
+ network.addListener(notifyListeners);
+ arm.addListener(notifyListeners);
+ science.addListener(notifyListeners);
+ dashboard.addListener(notifyListeners);
+ easterEggs.addListener(notifyListeners);
+}The ArmSettings view model.
+final ArmSettingsBuilder arm;The DashboardSettings view model.
+final DashboardSettingsBuilder dashboard;The EasterEggsSettings view model.
+final EasterEggsSettingsBuilder easterEggs;Whether the page is loading.
+bool isLoading = false;Whether the value in the UI is valid.
+Do not try to access value if this is false.
+@override
+bool get isValid => network.isValid
+ && arm.isValid
+ && science.isValid
+ && dashboard.isValid
+ && easterEggs.isValid;The NetworkSettings view model.
+final NetworkSettingsBuilder network;Saves the settings to the device.
+Future<void> save() async {
+ isLoading = true;
+ notifyListeners();
+ await models.settings.update(value);
+ await models.sockets.reset();
+ models.video.reset();
+ isLoading = false;
+ notifyListeners();
+}The ScienceSettings view model.
+final ScienceSettingsBuilder science;The value being updated in the UI.
+@override
+Settings get value => Settings(
+ network: network.value,
+ arm: arm.value,
+ science: science.value,
+ dashboard: dashboard.value,
+ easterEggs: easterEggs.value,
+);Manages the user's settings.
+The current settings.
+late Settings all;The user's arm settings.
+ArmSettings get arm => all.arm;The user's dashboard settings.
+DashboardSettings get dashboard => all.dashboard;The user's easter egg settings.
+EasterEggsSettings get easterEggs => all.easterEggs;Initializes any data needed by this model.
+@override
+Future<void> init() async {
+ all = await services.files.readSettings();
+}The user's network settings.
+NetworkSettings get network => all.network;The user's science settings.
+ScienceSettings get science => all.science;Replaces the current settings with the provided ones.
+Future<void> update(Settings value) async {
+ try {
+ await services.files.writeSettings(value);
+ all = value;
+ notifyListeners();
+ } catch (error) {
+ models.home.setMessage(severity: Severity.critical, text: "Could not save settings: $error");
+ }
+}A ValueBuilder that modifies a SocketInfo.
+Creates a view model to modify the given SocketInfo.
+SocketBuilder(SocketInfo initial) :
+ address = AddressBuilder(initial.address),
+ port = NumberBuilder<int>(initial.port)
+{
+ address.addListener(notifyListeners);
+ port.addListener(notifyListeners);
+}The builder for the IP address.
+final AddressBuilder address;The builder for the port number.
+final NumberBuilder<int> port;The value being updated in the UI.
+@override
+SocketInfo get value => SocketInfo(address: address.value, port: port.value);Coordinates all the sockets to point to the right RoverType.
+InternetAddress to use instead of the address on the rover.
+ The InternetAddress to use instead of the address on the rover.
InternetAddress? get addressOverride => switch (rover) {
+ RoverType.rover => null,
+ RoverType.tank => models.settings.network.tankSocket.address,
+ RoverType.localhost => InternetAddress.loopbackIPv4,
+};A UDP socket for controlling autonomy.
+late final autonomy = DashboardSocket(
+ device: Device.AUTONOMY,
+ onConnect: onConnect,
+ onDisconnect: onDisconnect,
+ messageHandler: models.messages.onMessage,
+);A rundown of the connection strength of each device.
+String get connectionSummary {
+ final result = StringBuffer();
+ for (final socket in sockets) {
+ result.write("${socket.device.humanName}: ${(socket.connectionStrength.value*100).toStringAsFixed(0)}%\n");
+ }
+ return result.toString().trim();
+}A UDP socket for sending and receiving Protobuf data.
+late final data = DashboardSocket(
+ device: Device.SUBSYSTEMS,
+ onConnect: onConnect,
+ onDisconnect: onDisconnect,
+ messageHandler: models.messages.onMessage,
+);Discards any resources used by the object. After this is called, the +object is not in a usable state and should be discarded (calls to +addListener will throw after the object is disposed).
+This method should only be called by the object's owner.
+This method does not notify listeners, and clears the listener list once +it is called. Consumers of this class must decide on whether to notify +listeners or not immediately before disposal.
+@override
+Future<void> dispose() async {
+ for (final socket in sockets) {
+ await socket.dispose();
+ }
+ super.dispose();
+}Initializes any data needed by this model.
+@override
+Future<void> init() async {
+ for (final socket in sockets) {
+ await socket.init();
+ }
+ final level = Logger.level;
+ Logger.level = LogLevel.warning;
+ await updateSockets();
+ Logger.level = level;
+}Notifies the user when a new device has connected.
+void onConnect(Device device) {
+ models.home.setMessage(severity: Severity.info, text: "The ${device.humanName} has connected");
+ if (device == Device.SUBSYSTEMS) {
+ models.rover.status.value = models.rover.settings.status;
+ models.rover.controller1.gamepad.pulse();
+ models.rover.controller2.gamepad.pulse();
+ models.rover.controller3.gamepad.pulse();
+ }
+}Notifies the user when a device has disconnected.
+void onDisconnect(Device device) {
+ models.home.setMessage(severity: Severity.critical, text: "The ${device.humanName} has disconnected");
+ if (device == Device.SUBSYSTEMS) models.rover.status.value = RoverStatus.DISCONNECTED;
+ if (device == Device.VIDEO) models.video.reset();
+}Resets all the sockets.
+When working with localhost, even UDP sockets can throw errors when the remote is unreachable. +Resetting the sockets will bypass these errors.
+Future<void> reset() async {
+ for (final socket in sockets) {
+ await socket.dispose();
+ await socket.init();
+ }
+ // Sockets lose their destination when disposed, so we restore it.
+ await updateSockets();
+}The rover-like system currently in use.
+RoverType rover = RoverType.rover;Change which rover is being used.
+Future<void> setRover(RoverType? value) async {
+ if (value == null) return;
+ rover = value;
+ models.home.setMessage(severity: Severity.info, text: "Using: ${rover.name}");
+ await reset();
+ notifyListeners();
+}A list of all the sockets this model manages.
+List<DashboardSocket> get sockets => [data, video, autonomy];Set the right IP addresses for the rover or tank.
+Future<void> updateSockets() async {
+ final settings = models.settings.network;
+ data.destination = settings.subsystemsSocket.copyWith(address: addressOverride);
+ video.destination = settings.videoSocket.copyWith(address: addressOverride);
+ autonomy.destination = settings.autonomySocket.copyWith(address: addressOverride);
+}A UDP socket for receiving video.
+late final video = DashboardSocket(
+ device: Device.VIDEO,
+ onConnect: onConnect,
+ onDisconnect: onDisconnect,
+ messageHandler: models.messages.onMessage,
+);A ValueBuilder backed by a Flutter TextField.
+Creates a view model to update settings.
+If text is not null, it will be used instead of value to prefill the controller.
TextBuilder(this.value, {String? text}) :
+ controller = TextEditingController(text: text ?? value.toString()), super();The controller for the TextField.
+This allows the text field to be prefilled with a value.
+final TextEditingController controller;The error to display in the UI, if any.
+String? error;Updates the value based on the user's input.
+Perform validation here and set error accordingly. You do not have to set value in this +function -- for example, if the user entered an invalid input.
+void update(String input);The value being updated in the UI.
+@override
+T value;A view model to allow the user to edit a throttle value and send it to the rover.
+A NumberBuilder to modify the throttle value.
+final controller = NumberBuilder<double>(0, min: 0, max: 1);The error with the throttle, if any.
+String? errorText;Whether the throttle command is still sending.
+bool isLoading = false;Whether the throttle is valid.
+bool get isValid => controller.isValid;Saves the throttle to the rover. Does not perform a handshake.
+Future<void> save() async {
+ isLoading = true;
+ notifyListeners();
+ final throttle = controller.value;
+ final command = DriveCommand(setThrottle: true, throttle: throttle);
+ models.messages.sendMessage(command);
+ await Future<void>.delayed(const Duration(milliseconds: 200));
+ isLoading = false;
+ notifyListeners();
+}Starts a MissionTimer based on user input.
+Number of minutes
+NumberBuilder<int> duration = NumberBuilder<int>(0);Whether the value in the UI is valid.
+Do not try to access value if this is false.
+@override
+bool get isValid => nameController.text.isNotEmpty && duration.value > 0;The text controller for the timer name.
+final nameController = TextEditingController();Other builders to listen to.
+@override
+List<NumberBuilder> get otherBuilders => [duration];Starts the timer
+void start() {
+ models.home.mission.start(title: nameController.text, duration: Duration(minutes: duration.value));
+}Updates the UI.
+void update(_) => notifyListeners();The value being updated in the UI.
+@override
+void get value { /* Use [start] instead */ }A view model to modify a value.
+The value being modified is saved in value, which must be a valid T. The UI, however, may
+contain invalid data inputted by the user. Use isValid to see if value matches the UI.
Listens to all otherBuilders as part of this builder.
+ValueBuilder() {
+ for (final builder in otherBuilders) {
+ builder.addListener(notifyListeners);
+ }
+}Discards any resources used by the object. After this is called, the +object is not in a usable state and should be discarded (calls to +addListener will throw after the object is disposed).
+This method should only be called by the object's owner.
+This method does not notify listeners, and clears the listener list once +it is called. Consumers of this class must decide on whether to notify +listeners or not immediately before disposal.
+@override
+void dispose() {
+ for (final builder in otherBuilders) {
+ builder.removeListener(notifyListeners);
+ }
+ super.dispose();
+}Other builders to listen to.
+List<ValueBuilder<dynamic>> get otherBuilders => [];The value being updated in the UI.
+T get value;A data model to stream video from the rover.
+Discards any resources used by the object. After this is called, the +object is not in a usable state and should be discarded (calls to +addListener will throw after the object is disposed).
+This method should only be called by the object's owner.
+This method does not notify listeners, and clears the listener list once +it is called. Consumers of this class must decide on whether to notify +listeners or not immediately before disposal.
+@override
+void dispose() {
+ frameUpdater?.cancel();
+ fpsTimer.cancel();
+ super.dispose();
+}All the video feeds supported by the rover.
+final Map<CameraName, VideoData> feeds = {
+ for (final name in CameraName.values) name: VideoData(
+ details: CameraDetails(
+ name: name,
+ status: CameraStatus.CAMERA_DISCONNECTED,
+ ),
+ ),
+};A timer to update the FPS counter.
+late final Timer fpsTimer;Triggers when it's time to update a new frame.
+This is kept here to ensure all widgets are in sync.
+Timer? frameUpdater;How many frames came in the network in the past second.
+This number is updated every frame. Use networkFps in the UI.
+Map<CameraName, int> framesThisSecond = {
+ for (final name in CameraName.values)
+ name: 0,
+};Updates the data for a given camera.
+void handleData(VideoData newData) {
+ if (
+ (newData.hasFrame() && newData.details.name == CameraName.CAMERA_NAME_UNDEFINED) ||
+ newData.details.status == CameraStatus.CAMERA_HAS_NO_NAME
+ ) {
+ models.home.setMessage(severity: Severity.critical, text: "Received feed from camera #${newData.id} with no name");
+ return;
+ }
+ final name = newData.details.name;
+ final data = feeds[name]!
+ ..details = newData.details
+ ..id = newData.id;
+
+ // Some [VideoData] packets are just representing metadata, not an empty video frame.
+ // If this is one such packet (doesn't have a frame but status == enabled), don't save.
+ if (newData.hasFrame() && newData.details.status == CameraStatus.CAMERA_ENABLED) {
+ data.frame = newData.frame;
+ framesThisSecond[name] = (framesThisSecond[name] ?? 0) + 1;
+ }
+}Initializes any data needed by this model.
+@override
+Future<void> init() async {
+ models.messages.registerHandler<VideoData>(
+ name: VideoData().messageName,
+ decoder: VideoData.fromBuffer,
+ handler: handleData,
+ );
+ models.messages.registerHandler<VideoCommand>(
+ name: VideoCommand().messageName,
+ decoder: VideoCommand.fromBuffer,
+ handler: (command) => _handshake = command,
+ );
+ fpsTimer = Timer.periodic(const Duration(seconds: 1), resetNetworkFps);
+ reset();
+}How many frames came in the network in the past second.
+Map<CameraName, int> networkFps = {};Clears all video data and resets the timer.
+void reset() {
+ resetNetworkFps();
+ for (final name in CameraName.values) {
+ feeds[name]!.details.status = CameraStatus.CAMERA_DISCONNECTED;
+ }
+
+ frameUpdater?.cancel();
+ frameUpdater = Timer.periodic(
+ Duration(milliseconds: (1000/models.settings.dashboard.maxFps).round()),
+ (_) => notifyListeners(),
+ );
+}Saves the frames in the past second (framesThisSecond) to networkFps.
+void resetNetworkFps([_]) {
+ networkFps = Map.from(framesThisSecond);
+ framesThisSecond = {
+ for (final name in CameraName.values)
+ name: 0,
+ };
+ notifyListeners();
+}Takes a screenshot of the current frame.
+Future<void> saveFrame(CameraName name) async {
+ final cachedFrame = feeds[name]?.frame;
+ if (cachedFrame == null) throw ArgumentError.notNull("Feed for $name");
+ await services.files.writeImage(cachedFrame, name.humanName);
+ models.home.setMessage(severity: Severity.info, text: "Screenshot saved");
+}Enables or disables the given camera.
+This function is called automatically, so if the camera is not connected or otherwise available, +it'll fail silently. However, if the server simply doesn't respond, it'll show a warning.
+Future<void> toggleCamera(CameraName name, {required bool enable}) async {
+ final details = feeds[name]!.details;
+ if (enable && details.status != CameraStatus.CAMERA_DISABLED) return;
+ if (!enable && details.status == CameraStatus.CAMERA_DISCONNECTED) return;
+
+ _handshake = null;
+ details.status = enable ? CameraStatus.CAMERA_ENABLED : CameraStatus.CAMERA_DISABLED;
+ final command = VideoCommand(id: feeds[name]!.id, details: details);
+ models.sockets.video.sendMessage(command);
+ await Future<void>.delayed(const Duration(seconds: 2));
+ if (_handshake == null) {
+ models.home.setMessage(
+ severity: Severity.warning,
+ text: "Could not ${enable ? 'enable' : 'disable'} the ${name.humanName} camera",
+ );
+ }
+}Updates settings for the given camera.
+Future<void> updateCamera(String id, CameraDetails details) async {
+ _handshake = null;
+ final command = VideoCommand(id: id, details: details);
+ models.sockets.video.sendMessage(command);
+ await Future<void>.delayed(const Duration(seconds: 2));
+ if (_handshake == null) throw RequestNotAccepted();
+}A data model for keeping track of the on-screen views.
+oldView with the newView.
+
+
+Discards any resources used by the object. After this is called, the +object is not in a usable state and should be discarded (calls to +addListener will throw after the object is disposed).
+This method should only be called by the object's owner.
+This method does not notify listeners, and clears the listener list once +it is called. Consumers of this class must decide on whether to notify +listeners or not immediately before disposal.
+@override
+void dispose() {
+ models.settings.removeListener(notifyListeners);
+ horizontalController1.dispose();
+ horizontalController2.dispose();
+ verticalController.dispose();
+ super.dispose();
+}The controller for the resizable row on top.
+final horizontalController1 = ResizableController();The controller for the resizable row on bottom.
+final horizontalController2 = ResizableController();Initializes any data needed by this model.
+@override
+Future<void> init() async {
+ models.settings.addListener(notifyListeners);
+ }Replaces the oldView with the newView.
void replaceView(String oldView, DashboardView newView) {
+ if (views.contains(newView)) {
+ models.home.setMessage(severity: Severity.error, text: "That view is already on-screen");
+ return;
+ }
+ final index = views.indexWhere((view) => view.name == oldView);
+ views[index] = newView;
+ notifyListeners();
+}Resets the size of all the views.
+void resetSizes() {
+ if (views.length == 2 && models.settings.dashboard.splitMode == SplitMode.horizontal) {
+ verticalController.setRatios([0.5, 0.5]);
+ } else if (views.length > 2) {
+ verticalController.setRatios([0.5, 0.5]);
+ }
+ if (views.length == 2 && models.settings.dashboard.splitMode == SplitMode.vertical) {
+ horizontalController1.setRatios([0.5, 0.5]);
+ } else if (views.length > 2) {
+ horizontalController1.setRatios([0.5, 0.5]);
+ }
+ if (views.length == 4) horizontalController2.setRatios([0.5, 0.5]);
+}Adds or subtracts a number of views to/from the UI
+void setNumViews(int? value) {
+ if (value == null || value > 4 || value < 1) return;
+ final currentNum = views.length;
+ if (value < currentNum) {
+ views = views.sublist(0, value);
+ } else {
+ for (var i = currentNum; i < value; i++) {
+ views.add(DashboardView.blank);
+ }
+ }
+ notifyListeners();
+}The controller for the resizable column.
+final verticalController = ResizableController();The current views on the screen.
+List<DashboardView> views = [
+ DashboardView.cameraViews[0],
+];A button for the user to select a new view.
+DiagnosticsNode objects describing this node's
+children.
+ A const constructor.
+const ViewsSelector({required this.currentView});Describes the part of the user interface represented by this widget.
+The framework calls this method when this widget is inserted into the tree +in a given BuildContext and when the dependencies of this widget change +(e.g., an InheritedWidget referenced by this widget changes). This +method can potentially be called in every frame and should not have any side +effects beyond building a widget.
+The framework replaces the subtree below this widget with the widget +returned by this method, either by updating the existing subtree or by +removing the subtree and inflating a new subtree, depending on whether the +widget returned by this method can update the root of the existing +subtree, as determined by calling Widget.canUpdate.
+Typically implementations return a newly created constellation of widgets +that are configured with information from this widget's constructor and +from the given BuildContext.
+The given BuildContext contains information about the location in the +tree at which this widget is being built. For example, the context +provides the set of inherited widgets for this location in the tree. A +given widget might be built with multiple different BuildContext +arguments over time if the widget is moved around the tree or if the +widget is inserted into the tree in multiple places at once.
+The implementation of this method must only depend on:
+context using
+BuildContext.dependOnInheritedWidgetOfExactType.If a widget's build method is to depend on anything else, use a +StatefulWidget instead.
+See also:
+@override
+Widget build(BuildContext context) => PopupMenuButton<DashboardView>(
+ tooltip: "Select a feed",
+ icon: const Icon(Icons.expand_more),
+ onSelected: (view) => models.views.replaceView(currentView, view),
+ itemBuilder: (_) => [
+ const PopupMenuItem(enabled: false, child: Text("Cameras")),
+ for (final view in DashboardView.cameraViews) PopupMenuItem(
+ value: view,
+ child: Row(children: [
+ if (models.sockets.video.isConnected) ...[getCameraStatus(view), const SizedBox(width: 8)],
+ Text(view.name),
+ ],),
+ ),
+ const PopupMenuDivider(),
+ const PopupMenuItem(enabled: false, child: Text("Controls")),
+ for (final view in DashboardView.uiViews) PopupMenuItem(
+ value: view,
+ child: Text(view.name),
+ ),
+ ],
+);The current view to swap with the user's choice of view.
+final String currentView;An icon to indicate the status of the given camera.
+Widget getCameraStatus(DashboardView view) {
+ final name = view.key! as CameraName;
+ final status = models.video.feeds[name]!.details.status;
+ const size = 12.0;
+ switch(status) {
+ case CameraStatus.CAMERA_STATUS_UNDEFINED: return const Icon(Icons.question_mark, size: size);
+ case CameraStatus.CAMERA_DISCONNECTED: return const Icon(Icons.circle, size: size, color: Colors.black);
+ case CameraStatus.CAMERA_ENABLED: return const Icon(Icons.circle, size: size, color: Colors.green);
+ case CameraStatus.CAMERA_LOADING: return const Icon(Icons.circle, size: size, color: Colors.blueGrey);
+ case CameraStatus.CAMERA_DISABLED: return const Icon(Icons.circle, size: size, color: Colors.orange);
+ case CameraStatus.CAMERA_NOT_RESPONDING: return const Icon(Icons.circle, size: size, color: Colors.red);
+ case CameraStatus.FRAME_TOO_LARGE: return const Icon(Icons.circle, size: size, color: Colors.orange);
+ case CameraStatus.CAMERA_HAS_NO_NAME: return const Icon(Icons.circle, size: size, color: Colors.black); // won't happen
+ }
+ // Do not use `default` or you will lose exhaustiveness checking
+ throw ArgumentError("Unrecognized status: $status");
+}How often to check the gamepad for new button presses.
+const gamepadDelay = Duration(milliseconds: 10);The rightmost color on the spectrum.
+HSVColor maxColor = HSVColor.fromColor(Colors.pink);The maximum amount of logs (to prevent consuming too much memory).
+const maxLogCount = 1000;The leftmost color on the spectrum.
+HSVColor minColor = HSVColor.fromColor(Colors.redAccent[700]!);A library that manages and controls the state of the app.
+This library is comprised of classes that have methods to allow simple control over the app's +state, which can have side effects as well. For example, adjusting the speed of the rover will +change the value of the on-screen speedometer while also commanding the rover to move faster.
+This library may depend on the data and services library.
+The data model representing the entire backend of the dashboard.
+This constant is here to provide easy access to the backend. But simply using this variable
+will not cause the UI to update. For that, you must place it in a ChangeNotifierProvider
+and use Consumer when needed.
final models = Models();A ScrollingRow of charts, using builder on each ScienceAnalysis in analyses.
+DiagnosticsNode objects describing this node's
+children.
+ A const constructor.
+const ChartsRow({
+ required this.title,
+ required this.analyses,
+ required this.builder,
+ this.height = 300,
+});The data for these charts.
+final List<ScienceAnalysis> analyses;Describes the part of the user interface represented by this widget.
+The framework calls this method when this widget is inserted into the tree +in a given BuildContext and when the dependencies of this widget change +(e.g., an InheritedWidget referenced by this widget changes). This +method can potentially be called in every frame and should not have any side +effects beyond building a widget.
+The framework replaces the subtree below this widget with the widget +returned by this method, either by updating the existing subtree or by +removing the subtree and inflating a new subtree, depending on whether the +widget returned by this method can update the root of the existing +subtree, as determined by calling Widget.canUpdate.
+Typically implementations return a newly created constellation of widgets +that are configured with information from this widget's constructor and +from the given BuildContext.
+The given BuildContext contains information about the location in the +tree at which this widget is being built. For example, the context +provides the set of inherited widgets for this location in the tree. A +given widget might be built with multiple different BuildContext +arguments over time if the widget is moved around the tree or if the +widget is inserted into the tree in multiple places at once.
+The implementation of this method must only depend on:
+context using
+BuildContext.dependOnInheritedWidgetOfExactType.If a widget's build method is to depend on anything else, use a +StatefulWidget instead.
+See also:
+@override
+Widget build(BuildContext context) => Column(children: [
+ const SizedBox(height: 24),
+ Text(title, style: context.textTheme.titleLarge),
+ const SizedBox(height: 12),
+ ScrollingRow(height: height, children: [
+ for (final analysis in analyses) Column(children: [
+ Text(analysis.sensor.name, textAlign: TextAlign.center, style: context.textTheme.labelLarge),
+ const SizedBox(height: 8),
+ Expanded(child: builder(analysis)),
+ ],),
+ ],),
+],);The chart to show for each piece of data.
+final Widget Function(ScienceAnalysis) builder;The height of this row.
+final double height;The title of these charts.
+final String title;Allows desktop users to scroll with their mouse or other device.
+LogicalKeyboardKeys that, when any or all are pressed in
+combination with a PointerDeviceKind.mouse pointer scroll event, will
+flip the axes of the scroll input.
+ scrollbar and overscrollIndicator effects.
+ The device kinds that the scrollable will accept drag gestures from.
+By default only PointerDeviceKind.touch, PointerDeviceKind.stylus, and +PointerDeviceKind.invertedStylus are configured to create drag gestures. +Enabling this for PointerDeviceKind.mouse will make it difficult or +impossible to select text in scrollable containers and is not recommended.
+@override
+Set<PointerDeviceKind> get dragDevices => {
+ PointerDeviceKind.touch,
+ PointerDeviceKind.mouse,
+ PointerDeviceKind.stylus,
+ PointerDeviceKind.trackpad,
+};The UI for the electrical subsystem.
+model.
+ DiagnosticsNode objects describing this node's
+children.
+ Builds the UI according to the state in model.
@override
+Widget build(BuildContext context, ElectricalModel model) => Column(
+ crossAxisAlignment: CrossAxisAlignment.stretch,
+ children: [
+ Row(children: [ // The header at the top
+ const SizedBox(width: 8),
+ Text("Electrical", style: context.textTheme.headlineMedium),
+ const SizedBox(width: 12),
+ const Spacer(),
+ Text(model.axis ? "Horizontal" : "Vertical", style: context.textTheme.labelLarge),
+ const SizedBox(width: 12),
+ Switch(
+ value: model.axis,
+ onChanged: (bool value) => model.changeDirection(),
+ ),
+ const SizedBox(width: 8),
+ ElevatedButton.icon(icon: const Icon(Icons.clear), label: const Text("Clear all"), onPressed: model.clear),
+ const SizedBox(width: 8),
+ const ViewsSelector(currentView: Routes.electrical),
+ ],),
+ if (model.axis) Expanded(child:
+ Row(children: [
+ for (final graph in _getGraphs(model))
+ Expanded(child: graph),
+ ],),
+ )
+ else
+ for (final graph in _getGraphs(model))
+ Expanded(child: graph),
+ const SizedBox(height: 8),
+ ],
+ );A function to create or find the model. This function will only be called once.
+@override
+ElectricalModel createModel() => ElectricalModel();The main dashboard page.
+Each page the user could navigate to is embedded here, as a View.
+DiagnosticsNode objects describing this node's
+children.
+ Creates the mutable state for this widget at a given location in the tree.
+Subclasses should override this method to return a newly created +instance of their associated State subclass:
+@override
+State<SomeWidget> createState() => _SomeWidgetState();
+The framework can call this method multiple times over the lifetime of
+a StatefulWidget. For example, if the widget is inserted into the tree
+in multiple locations, the framework will create a separate State object
+for each location. Similarly, if the widget is removed from the tree and
+later inserted into the tree again, the framework will call createState
+again to create a fresh State object, simplifying the lifecycle of
+State objects.
@override
+HomePageState createState() => HomePageState();The state for the homepage. Handles showing and hiding the sidebar.
+Describes the part of the user interface represented by this widget.
+The framework calls this method in a number of different situations. For +example:
+This method can potentially be called in every frame and should not have +any side effects beyond building a widget.
+The framework replaces the subtree below this widget with the widget +returned by this method, either by updating the existing subtree or by +removing the subtree and inflating a new subtree, depending on whether the +widget returned by this method can update the root of the existing +subtree, as determined by calling Widget.canUpdate.
+Typically implementations return a newly created constellation of widgets +that are configured with information from this widget's constructor, the +given BuildContext, and the internal state of this State object.
+The given BuildContext contains information about the location in the
+tree at which this widget is being built. For example, the context
+provides the set of inherited widgets for this location in the tree. The
+BuildContext argument is always the same as the context property of
+this State object and will remain the same for the lifetime of this
+object. The BuildContext argument is provided redundantly here so that
+this method matches the signature for a WidgetBuilder.
Putting a Widget build(BuildContext context) method on State rather
+than putting a Widget build(BuildContext context, State state) method
+on StatefulWidget gives developers more flexibility when subclassing
+StatefulWidget.
For example, AnimatedWidget is a subclass of StatefulWidget that
+introduces an abstract Widget build(BuildContext context) method for its
+subclasses to implement. If StatefulWidget already had a build method
+that took a State argument, AnimatedWidget would be forced to provide
+its State object to subclasses even though its State object is an
+internal implementation detail of AnimatedWidget.
Conceptually, StatelessWidget could also be implemented as a subclass of +StatefulWidget in a similar manner. If the build method were on +StatefulWidget rather than State, that would not be possible anymore.
+Putting the build function on State rather than StatefulWidget also
+helps avoid a category of bugs related to closures implicitly capturing
+this. If you defined a closure in a build function on a
+StatefulWidget, that closure would implicitly capture this, which is
+the current widget instance, and would have the (immutable) fields of that
+instance in scope:
// (this is not valid Flutter code)
+class MyButton extends StatefulWidgetX {
+ MyButton({super.key, required this.color});
+
+ final Color color;
+
+ @override
+ Widget build(BuildContext context, State state) {
+ return SpecialWidget(
+ handler: () { print('color: $color'); },
+ );
+ }
+}
+For example, suppose the parent builds MyButton with color being blue,
+the $color in the print function refers to blue, as expected. Now,
+suppose the parent rebuilds MyButton with green. The closure created by
+the first build still implicitly refers to the original widget and the
+$color still prints blue even through the widget has been updated to
+green; should that closure outlive its widget, it would print outdated
+information.
In contrast, with the build function on the State object, closures +created during build implicitly capture the State instance instead of +the widget instance:
+class MyButton extends StatefulWidget {
+ const MyButton({super.key, this.color = Colors.teal});
+
+ final Color color;
+ // ...
+}
+
+class MyButtonState extends State<MyButton> {
+ // ...
+ @override
+ Widget build(BuildContext context) {
+ return SpecialWidget(
+ handler: () { print('color: ${widget.color}'); },
+ );
+ }
+}
+Now when the parent rebuilds MyButton with green, the closure created by
+the first build still refers to State object, which is preserved across
+rebuilds, but the framework has updated that State object's widget
+property to refer to the new MyButton instance and ${widget.color}
+prints green, as expected.
See also:
+@override
+Widget build(BuildContext context) => Scaffold(
+ appBar: AppBar(
+ automaticallyImplyLeading: false,
+ title: Text("Dashboard v${models.home.version ?? ''}"),
+ flexibleSpace: Center(child: TimerWidget()),
+ actions: [
+ SocketSwitcher(),
+ IconButton(
+ icon: const Icon(Icons.aspect_ratio),
+ tooltip: "Reset view sizes",
+ onPressed: models.views.resetSizes,
+ ),
+ IconButton(
+ icon: const Icon(Icons.settings),
+ onPressed: () => Navigator.of(context).pushNamed(Routes.settings),
+ ),
+ Builder(builder: (context) => IconButton(
+ icon: const Icon(Icons.menu),
+ onPressed: () => setState(() => showSidebar = !showSidebar),
+ ),),
+ ],
+ ),
+ bottomNavigationBar: const Footer(),
+ body: Stack(children: [
+ Row(
+ children: [
+ Expanded(child: ViewsWidget()),
+ // An AnimatedSize widget automatically shrinks the widget away
+ AnimatedSize(
+ duration: const Duration(milliseconds: 250),
+ child: showSidebar ? const Sidebar() : Container(),
+ ),
+ ],
+ ),
+ if (defaultTargetPlatform == TargetPlatform.android)
+ MobileControls(),
+ ],),
+);Whether to show the sidebar.
+bool showSidebar = false;A widget that shows a BurtLog.
+DiagnosticsNode objects describing this node's
+children.
+ Creates a widget to display the given log message.
+const LogWidget(this.log);Describes the part of the user interface represented by this widget.
+The framework calls this method when this widget is inserted into the tree +in a given BuildContext and when the dependencies of this widget change +(e.g., an InheritedWidget referenced by this widget changes). This +method can potentially be called in every frame and should not have any side +effects beyond building a widget.
+The framework replaces the subtree below this widget with the widget +returned by this method, either by updating the existing subtree or by +removing the subtree and inflating a new subtree, depending on whether the +widget returned by this method can update the root of the existing +subtree, as determined by calling Widget.canUpdate.
+Typically implementations return a newly created constellation of widgets +that are configured with information from this widget's constructor and +from the given BuildContext.
+The given BuildContext contains information about the location in the +tree at which this widget is being built. For example, the context +provides the set of inherited widgets for this location in the tree. A +given widget might be built with multiple different BuildContext +arguments over time if the widget is moved around the tree or if the +widget is inserted into the tree in multiple places at once.
+The implementation of this method must only depend on:
+context using
+BuildContext.dependOnInheritedWidgetOfExactType.If a widget's build method is to depend on anything else, use a +StatefulWidget instead.
+See also:
+@override
+Widget build(BuildContext context) => ListTile(
+ leading: icon,
+ title: Text(log.title),
+ subtitle: log.body.isEmpty ? Text(log.device.humanName) : Text("${log.device.humanName}\n${log.body}".trim()),
+);Gets an icon for the given BurtLogLevel.
+Widget get icon => switch(log.level) {
+ BurtLogLevel.critical => criticalWidget,
+ BurtLogLevel.error => errorWidget,
+ BurtLogLevel.warning => warningWidget,
+ BurtLogLevel.info => infoWidget,
+ BurtLogLevel.debug => debugWidget,
+ BurtLogLevel.trace => traceWidget,
+ _ => const Icon(Icons.question_mark),
+};The log message being shown in this widget.
+final BurtLog log;The widget that actually contains the logs for the page.
+This is a separate widget to prevent updating the rest of the page when new logs come in.
+model.
+ DiagnosticsNode objects describing this node's
+children.
+ Listens to the given view model.
+const LogsBody(super.model);Builds the UI according to the state in model.
@override
+Widget build(BuildContext context, LogsViewModel model) => model.logs.isEmpty
+ ? const Center(child: Text("No logs yet"))
+ : ListView.builder(
+ itemCount: model.logs.length,
+ controller: model.scrollController,
+ reverse: true,
+ itemBuilder: (context, index) => LogWidget(model.logs[index]),
+ );A widget to show the options for the logs page.
+This is separate from the logs display so that the menu doesn't flicker when new logs arrive.
+model.
+ DiagnosticsNode objects describing this node's
+children.
+ Listens to the view model without disposing it.
+LogsOptions(this.viewModel) : super(viewModel.options);Builds the UI according to the state in model.
@override
+Widget build(BuildContext context, LogsOptionsViewModel model) => Wrap(
+ runAlignment: WrapAlignment.center,
+ alignment: WrapAlignment.center,
+ crossAxisAlignment: WrapCrossAlignment.center,
+ runSpacing: 8,
+ children: [ // Menu
+ for (final device in [Device.SUBSYSTEMS, Device.VIDEO, Device.AUTONOMY]) // Reset devices
+ SizedBox(width: 250, child: Card(
+ child: ListTile(
+ onTap: () => model.resetDevice(device),
+ leading: const Icon(Icons.restart_alt),
+ title: Text("Reset the ${device.humanName}"),
+ subtitle: const Text("The device will reboot"),
+ ),),
+ ),
+ DropdownMenu<Device?>(
+ label: const Text("Select device"),
+ initialSelection: model.deviceFilter,
+ onSelected: (input) {
+ model.setDeviceFilter(input);
+ viewModel.update();
+ },
+ dropdownMenuEntries: [
+ for (final device in [Device.SUBSYSTEMS, Device.VIDEO, Device.AUTONOMY, null])
+ DropdownMenuEntry(label: device?.humanName ?? "All", value: device),
+ ],
+ ),
+ const SizedBox(width: 8),
+ DropdownMenu<BurtLogLevel>(
+ label: const Text("Select severity"),
+ initialSelection: model.levelFilter,
+ onSelected: (input) {
+ model.setLevelFilter(input);
+ viewModel.update();
+ },
+ dropdownMenuEntries: [
+ for (final level in BurtLogLevel.values.filtered)
+ DropdownMenuEntry(label: level.humanName, value: level),
+ ],
+ ),
+ const SizedBox(width: 8),
+ SizedBox(width: 250, child: CheckboxListTile(
+ title: const Text("Autoscroll"),
+ subtitle: const Text("Scroll to override"),
+ value: model.autoscroll,
+ onChanged: (input) {
+ model.setAutoscroll(input: input);
+ if (input ?? false) viewModel.jumpToBottom();
+ viewModel.update();
+ },
+ ),),
+ ],
+);The view model for the whole page.
+final LogsViewModel viewModel;The logs page, containing the LogsOptions and LogsBody widgets.
+This page lets the user view logs, set filters, and reboot the rover.
+DiagnosticsNode objects describing this node's
+children.
+ Creates the mutable state for this widget at a given location in the tree.
+Subclasses should override this method to return a newly created +instance of their associated State subclass:
+@override
+State<SomeWidget> createState() => _SomeWidgetState();
+The framework can call this method multiple times over the lifetime of
+a StatefulWidget. For example, if the widget is inserted into the tree
+in multiple locations, the framework will create a separate State object
+for each location. Similarly, if the widget is removed from the tree and
+later inserted into the tree again, the framework will call createState
+again to create a fresh State object, simplifying the lifecycle of
+State objects.
@override
+LogsState createState() => LogsState();The state of the logs page. Used to ensure that the LogsViewModel is only created once.
+Describes the part of the user interface represented by this widget.
+The framework calls this method in a number of different situations. For +example:
+This method can potentially be called in every frame and should not have +any side effects beyond building a widget.
+The framework replaces the subtree below this widget with the widget +returned by this method, either by updating the existing subtree or by +removing the subtree and inflating a new subtree, depending on whether the +widget returned by this method can update the root of the existing +subtree, as determined by calling Widget.canUpdate.
+Typically implementations return a newly created constellation of widgets +that are configured with information from this widget's constructor, the +given BuildContext, and the internal state of this State object.
+The given BuildContext contains information about the location in the
+tree at which this widget is being built. For example, the context
+provides the set of inherited widgets for this location in the tree. The
+BuildContext argument is always the same as the context property of
+this State object and will remain the same for the lifetime of this
+object. The BuildContext argument is provided redundantly here so that
+this method matches the signature for a WidgetBuilder.
Putting a Widget build(BuildContext context) method on State rather
+than putting a Widget build(BuildContext context, State state) method
+on StatefulWidget gives developers more flexibility when subclassing
+StatefulWidget.
For example, AnimatedWidget is a subclass of StatefulWidget that
+introduces an abstract Widget build(BuildContext context) method for its
+subclasses to implement. If StatefulWidget already had a build method
+that took a State argument, AnimatedWidget would be forced to provide
+its State object to subclasses even though its State object is an
+internal implementation detail of AnimatedWidget.
Conceptually, StatelessWidget could also be implemented as a subclass of +StatefulWidget in a similar manner. If the build method were on +StatefulWidget rather than State, that would not be possible anymore.
+Putting the build function on State rather than StatefulWidget also
+helps avoid a category of bugs related to closures implicitly capturing
+this. If you defined a closure in a build function on a
+StatefulWidget, that closure would implicitly capture this, which is
+the current widget instance, and would have the (immutable) fields of that
+instance in scope:
// (this is not valid Flutter code)
+class MyButton extends StatefulWidgetX {
+ MyButton({super.key, required this.color});
+
+ final Color color;
+
+ @override
+ Widget build(BuildContext context, State state) {
+ return SpecialWidget(
+ handler: () { print('color: $color'); },
+ );
+ }
+}
+For example, suppose the parent builds MyButton with color being blue,
+the $color in the print function refers to blue, as expected. Now,
+suppose the parent rebuilds MyButton with green. The closure created by
+the first build still implicitly refers to the original widget and the
+$color still prints blue even through the widget has been updated to
+green; should that closure outlive its widget, it would print outdated
+information.
In contrast, with the build function on the State object, closures +created during build implicitly capture the State instance instead of +the widget instance:
+class MyButton extends StatefulWidget {
+ const MyButton({super.key, this.color = Colors.teal});
+
+ final Color color;
+ // ...
+}
+
+class MyButtonState extends State<MyButton> {
+ // ...
+ @override
+ Widget build(BuildContext context) {
+ return SpecialWidget(
+ handler: () { print('color: ${widget.color}'); },
+ );
+ }
+}
+Now when the parent rebuilds MyButton with green, the closure created by
+the first build still refers to State object, which is preserved across
+rebuilds, but the framework has updated that State object's widget
+property to refer to the new MyButton instance and ${widget.color}
+prints green, as expected.
See also:
+@override
+Widget build(BuildContext context) => Scaffold(
+ body: Column(children: [
+ const SizedBox(height: 12),
+ LogsOptions(model),
+ const Divider(),
+ Expanded(child: LogsBody(model)),
+ ],),
+ appBar: AppBar(
+ title: const Text("Logs"),
+ actions: [
+ IconButton(
+ icon: const Icon(Icons.help),
+ tooltip: "Help",
+ onPressed: () => showDialog<void>(
+ context: context,
+ builder: (context) => AlertDialog(
+ title: const Text("Logs help"),
+ content: Column(mainAxisSize: MainAxisSize.min, children: [
+ const Text("This page contains all logs received by the dashboard.\nSelecting a level means that only messages of that level or higher will be shown.", textAlign: TextAlign.center,),
+ const SizedBox(height: 4),
+ ListTile(leading: criticalWidget, title: const Text("Critical"), subtitle: const Text("The rover is in a broken state and may shutdown")),
+ const ListTile(leading: errorWidget, title: Text("Error"), subtitle: Text("Something you tried didn't work, but the rover can still function")),
+ const ListTile(leading: warningWidget, title: Text("Warning"), subtitle: Text("Something may have gone wrong, you should check it out")),
+ ListTile(leading: infoWidget, title: const Text("Info"), subtitle: const Text("The rover is functioning normally")),
+ const ListTile(leading: debugWidget, title: Text("Debug"), subtitle: Text("Extra information that shows what the rover's thinking")),
+ const ListTile(leading: traceWidget, title: Text("Trace"), subtitle: Text("Values from the code to debug specific issues")),
+ const SizedBox(height: 12),
+ ],),
+ actions: [
+ ElevatedButton(
+ onPressed: () => Navigator.of(context).pop(),
+ child: const Text("Close"),
+ ),
+ ],
+ ),
+ ),
+ ),
+ IconButton(
+ icon: const Icon(Icons.vertical_align_bottom),
+ onPressed: model.jumpToBottom,
+ tooltip: "Jump to bottom",
+ ),
+ IconButton(
+ icon: const Icon(Icons.delete_forever),
+ onPressed: models.logs.clear,
+ tooltip: "Clear logs",
+ ),
+ ],
+ ),
+ bottomNavigationBar: const Footer(showLogs: false),
+);The view model for this page.
+final model = LogsViewModel();The UI for the autonomy subsystem.
+Displays a bird's-eye view of the rover and its path to the goal.
+model.
+ DiagnosticsNode objects describing this node's
+children.
+ Builds the UI according to the state in model.
@override
+Widget build(BuildContext context, AutonomyModel model) => Stack(children: [
+ Column(children: [
+ const SizedBox(height: 48),
+ for (final row in model.grid.reversed) Expanded(
+ child: Row(children: [
+ for (final cell in row) Expanded(
+ child: GestureDetector(
+ onTap: () => cell.$2 != AutonomyCell.marker ? () : model.updateMarker(cell.$1),
+ child: Container(
+ height: double.infinity,
+ width: 24,
+ decoration: BoxDecoration(color: getColor(cell.$2), border: Border.all()),
+ child: cell.$2 != AutonomyCell.rover ? null : Transform.rotate(
+ angle: -model.roverHeading * pi / 180,
+ child: const Icon(Icons.arrow_upward, size: 24),
+ ),
+ ),
+ ),
+ ),
+ ],),
+ ),
+ const SizedBox(height: 4),
+ if (!model.isPlayingBadApple) Row(children: [ // Legend
+ const SizedBox(width: 4),
+ Text("Legend:", style: context.textTheme.titleLarge),
+ const SizedBox(width: 8),
+ Container(width: 24, height: 24, color: Colors.blue),
+ const SizedBox(width: 4),
+ Text("Rover", style: context.textTheme.titleMedium),
+ const SizedBox(width: 24),
+ Container(width: 24, height: 24, color: Colors.green),
+ const SizedBox(width: 4),
+ Text("Destination", style: context.textTheme.titleMedium),
+ const SizedBox(width: 24),
+ Container(width: 24, height: 24, color: Colors.black),
+ const SizedBox(width: 4),
+ Text("Obstacle", style: context.textTheme.titleMedium),
+ const SizedBox(width: 24),
+ Container(width: 24, height: 24, color: Colors.blueGrey),
+ const SizedBox(width: 4),
+ Text("Path", style: context.textTheme.titleMedium),
+ const SizedBox(width: 24),
+ Container(width: 24, height: 24, color: Colors.red),
+ const SizedBox(width: 4),
+ Text("Marker", style: context.textTheme.titleMedium),
+ const Spacer(),
+ Text("Zoom: ", style: context.textTheme.titleLarge),
+ Expanded(flex: 2, child: Slider(
+ value: model.gridSize.toDouble(),
+ min: 1,
+ max: 41,
+ divisions: 20,
+ label: "${model.gridSize}x${model.gridSize}",
+ onChanged: (value) => model.zoom(value.toInt()),
+ ),),
+ ],),
+ if (!model.isPlayingBadApple) Row(children: [ // Controls
+ const SizedBox(width: 4),
+ Text("Place marker: ", style: context.textTheme.titleLarge),
+ const SizedBox(width: 8),
+ ElevatedButton.icon(
+ icon: const Icon(Icons.add),
+ label: const Text("Add Marker"),
+ onPressed: () => placeMarker(context, model),
+ ),
+ const SizedBox(width: 8),
+ ElevatedButton.icon(icon: const Icon(Icons.clear), label: const Text("Clear all"), onPressed: model.clearMarkers),
+ const Spacer(),
+ AutonomyCommandEditor(),
+ const SizedBox(width: 8),
+ ],),
+ const SizedBox(height: 4),
+ ],),
+ Container(
+ color: context.colorScheme.surface,
+ height: 50,
+ child: Row(children: [ // The header at the top
+ const SizedBox(width: 8),
+ Text("Map", style: context.textTheme.headlineMedium),
+ if (models.settings.easterEggs.badApple) IconButton(
+ iconSize: 48,
+ icon: CircleAvatar(
+ backgroundImage: const AssetImage("assets/bad_apple_thumbnail.webp"),
+ child: model.isPlayingBadApple ? const Icon(Icons.block, color: Colors.red, size: 36) : null,
+ ),
+ onPressed: model.isPlayingBadApple ? model.stopBadApple : model.startBadApple,
+ ),
+ const Spacer(),
+ if (model.isPlayingBadApple)
+ Text("Autonomy status: Bad Apple", style: context.textTheme.headlineSmall)
+ else
+ Text("Autonomy status: ${model.data.state.humanName}, ${model.data.task.humanName}", style: context.textTheme.headlineSmall),
+ const VerticalDivider(),
+ const ViewsSelector(currentView: Routes.autonomy),
+ ],),
+ ),
+ ],);A function to create or find the model. This function will only be called once.
+@override
+AutonomyModel createModel() => AutonomyModel();Gets the color for a given AutonomyCell.
+Color? getColor(AutonomyCell cell) => switch(cell) {
+ AutonomyCell.rover => Colors.blue,
+ AutonomyCell.destination => Colors.green,
+ AutonomyCell.obstacle => Colors.black,
+ AutonomyCell.path => Colors.blueGrey,
+ AutonomyCell.empty => Colors.white,
+ AutonomyCell.marker => Colors.red,
+};Opens a dialog to prompt the user for GPS coordinates and places a marker there.
+void placeMarker(BuildContext context, AutonomyModel model) => showDialog<void>(
+ context: context,
+ builder: (_) => AlertDialog(
+ title: const Text("Add a Marker"),
+ content: Column(
+ mainAxisSize: MainAxisSize.min,
+ children: [ GpsEditor(model.markerBuilder) ],
+ ),
+ actions: [
+ TextButton(child: const Text("Cancel"), onPressed: () => Navigator.of(context).pop()),
+ ElevatedButton(
+ onPressed: model.markerBuilder.isValid ? () { model.placeMarker(); Navigator.of(context).pop(); } : null,
+ child: const Text("Add"),
+ ),
+ ],
+ ),
+);A box to display the final results for each sensor.
+DiagnosticsNode objects describing this node's
+children.
+ Creates a widget to display the results of a science test.
+const ResultsBox(this.analysis);The sensor being tested.
+final ScienceAnalysis analysis;Describes the part of the user interface represented by this widget.
+The framework calls this method when this widget is inserted into the tree +in a given BuildContext and when the dependencies of this widget change +(e.g., an InheritedWidget referenced by this widget changes). This +method can potentially be called in every frame and should not have any side +effects beyond building a widget.
+The framework replaces the subtree below this widget with the widget +returned by this method, either by updating the existing subtree or by +removing the subtree and inflating a new subtree, depending on whether the +widget returned by this method can update the root of the existing +subtree, as determined by calling Widget.canUpdate.
+Typically implementations return a newly created constellation of widgets +that are configured with information from this widget's constructor and +from the given BuildContext.
+The given BuildContext contains information about the location in the +tree at which this widget is being built. For example, the context +provides the set of inherited widgets for this location in the tree. A +given widget might be built with multiple different BuildContext +arguments over time if the widget is moved around the tree or if the +widget is inserted into the tree in multiple places at once.
+The implementation of this method must only depend on:
+context using
+BuildContext.dependOnInheritedWidgetOfExactType.If a widget's build method is to depend on anything else, use a +StatefulWidget instead.
+See also:
+@override
+Widget build(BuildContext context) => Column(children: [
+ Expanded(child: Container(
+ margin: const EdgeInsets.all(8),
+ padding: const EdgeInsets.all(8),
+ width: double.infinity,
+ color: color ?? context.colorScheme.surface,
+ child: Column(
+ crossAxisAlignment: CrossAxisAlignment.start,
+ children: [
+ Text(analysis.sensor.testDescription),
+ const Spacer(),
+ Center(child: Text(text, textAlign: TextAlign.center, style: context.textTheme.headlineLarge)),
+ const Spacer(),
+ ],
+ ),
+ ),),
+ NumberEditor(
+ name: "Min",
+ model: analysis.testBuilder.min,
+ ),
+ NumberEditor(
+ name: "Average",
+ model: analysis.testBuilder.average,
+ ),
+ NumberEditor(
+ name: "Max",
+ model: analysis.testBuilder.max,
+ ),
+],);The color to render this box.
+Color? get color {
+ switch(analysis.testResult) {
+ case ScienceResult.extinct: return Colors.red;
+ case ScienceResult.extant: return Colors.green;
+ case ScienceResult.notPresent: return Colors.red;
+ case ScienceResult.inconclusive: return Colors.blueGrey;
+ case ScienceResult.loading: return null;
+ }
+}The text to display in this box.
+String get text {
+ switch(analysis.testResult) {
+ case ScienceResult.extinct: return "Extinct";
+ case ScienceResult.extant: return "Extant";
+ case ScienceResult.notPresent: return "Not Present";
+ case ScienceResult.inconclusive: return "Inconclusive";
+ case ScienceResult.loading: return "Collecting data...";
+ }
+}The names of all the pages available in the app.
+These names are used to jump from page to page. They are equivalent to a URL.
+The name of the arm IK page.
+static const String arm = "Arm";The name of the autonomy page.
+static const String autonomy = "Map";The name of the blank page.
+static const String blank = "blank";The name of the electrical data page
+static const String electrical = "Electrical";The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;The name of the home page.
+static const String home = "home";The name of the logs page.
+static const String logs = "Logs";The name of the MARS page.
+static const String mars = "MARS";Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;The name of the science analysis page.
+static const String science = "Science Analysis";The name of the settings page.
+static const String settings = "settings";A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();The science analysis page.
+model.
+ DiagnosticsNode objects describing this node's
+children.
+ package:fl_chart helper class for the summary charts.
+
+
+package:fl_chart helper class for the details charts.
+
+
+Builds the UI according to the state in model.
@override
+Widget build(BuildContext context, ScienceModel model) => Column(children: [
+ Row(children: [ // The header at the top
+ const SizedBox(width: 8),
+ Text("Science Analysis", style: context.textTheme.headlineMedium),
+ const SizedBox(width: 12),
+ if (model.isLoading) const SizedBox(height: 20, width: 20, child: CircularProgressIndicator()),
+ const Spacer(),
+ DropdownButton(
+ value: model.sample,
+ onChanged: model.updateSample,
+ items: [
+ for (int i = 0; i < model.numSamples; i++) DropdownMenuItem(
+ value: i,
+ child: Text("Sample ${i + 1}"),
+ ),
+ ],
+ ),
+ if (model.isListening) IconButton(
+ icon: const Icon(Icons.upload_file),
+ onPressed: model.loadFile,
+ tooltip: "Load file",
+ ) else IconButton(
+ icon: const Icon(Icons.clear),
+ onPressed: model.clear,
+ tooltip: "Clear",
+ ),
+ const ViewsSelector(currentView: Routes.science),
+ ],),
+ Expanded(child: ListView( // The main content of the page
+ padding: const EdgeInsets.symmetric(horizontal: 4),
+ children: [
+ if (model.errorText != null) ...[
+ Text("Error analyzing the logs", textAlign: TextAlign.center, style: context.textTheme.headlineLarge),
+ const SizedBox(height: 24),
+ Text("Here is the error:", textAlign: TextAlign.center, style: context.textTheme.titleLarge),
+ const SizedBox(height: 12),
+ Text(model.errorText!, textAlign: TextAlign.center, style: context.textTheme.titleMedium),
+ ] else if (!model.isLoading) ...[
+ ChartsRow(
+ title: "Details",
+ analyses: model.analysesForSample,
+ builder: (analysis) => LineChart(getDetailsData(analysis, getColor(model.sample / model.numSamples))),
+ ),
+ ChartsRow(
+ title: "Summary",
+ analyses: model.analysesForSample,
+ builder: (analysis) => BarChart(getBarChartData(analysis, getColor(model.sample / model.numSamples))),
+ ),
+ ChartsRow(
+ title: "Results",
+ height: 425,
+ analyses: model.analysesForSample,
+ builder: ResultsBox.new,
+ ),
+ ],
+ ],
+ ),),
+ ScienceCommandEditor(),
+ ],);A function to create or find the model. This function will only be called once.
+@override
+ScienceModel createModel() => ScienceModel();The package:fl_chart helper class for the summary charts.
BarChartData getBarChartData(ScienceAnalysis analysis, Color color) => BarChartData(
+ barGroups: [
+ BarChartGroupData(x: 0, barRods: [BarChartRodData(color: color, fromY: 0, toY: analysis.data.min ?? 0)]),
+ BarChartGroupData(x: 1, barRods: [BarChartRodData(color: color, fromY: 0, toY: analysis.data.average ?? 0)]),
+ BarChartGroupData(x: 2, barRods: [BarChartRodData(color: color, fromY: 0, toY: analysis.data.max ?? 0)]),
+ ],
+ titlesData: FlTitlesData(
+ topTitles: const AxisTitles(),
+ bottomTitles: AxisTitles(
+ sideTitles: SideTitles(
+ showTitles: true,
+ getTitlesWidget: (double value, TitleMeta meta) => SideTitleWidget(
+ axisSide: AxisSide.bottom,
+ space: 3,
+ child: Text(["Min", "Avg", "Max"][value.toInt()]),
+ ),
+ ),
+ ),
+ ),
+ barTouchData: BarTouchData(touchTooltipData: BarTouchTooltipData(fitInsideVertically: true, fitInsideHorizontally: true)),
+);Gets a color between red and purple
+value must be between 0.0 and 1.0.
Color getColor(double value) => HSVColor.lerp(red, purple, value)!.toColor();The package:fl_chart helper class for the details charts.
LineChartData getDetailsData(ScienceAnalysis analysis, Color color) => LineChartData(
+ lineBarsData: [
+ LineChartBarData(
+ spots: [
+ for (final reading in analysis.data.readings)
+ FlSpot(reading.time, reading.value),
+ ],
+ color: color,
+ preventCurveOverShooting: true,
+ isCurved: true,
+ ),
+ ],
+ titlesData: FlTitlesData(
+ topTitles: const AxisTitles(),
+ bottomTitles: AxisTitles(
+ sideTitles: SideTitles(
+ showTitles: true,
+ getTitlesWidget: (double value, TitleMeta meta) => SideTitleWidget(
+ axisSide: AxisSide.bottom,
+ space: 3,
+ child: Text(value.toStringAsFixed(0)),
+ ),
+ ),
+ ),
+ ),
+ extraLinesData: ExtraLinesData(horizontalLines: [HorizontalLine(y: 0)], verticalLines: [VerticalLine(x: 0)]),
+ minX: 0, minY: 0,
+ clipData: const FlClipData.all(),
+ lineTouchData: const LineTouchData(touchTooltipData: LineTouchTooltipData(fitInsideVertically: true, fitInsideHorizontally: true)),
+);Purple, used as the color for the last sample.
+static final purple = HSVColor.fromColor(Colors.purple);Red, used as the color for the first sample.
+static final red = HSVColor.fromColor(Colors.red);A row of scrollable or non-scrollable widgets.
+model.
+ DiagnosticsNode objects describing this node's
+children.
+ Renders a row of widgets.
+ScrollingRow({required this.children, this.height = 300}) : super(models.settings);Builds the UI according to the state in model.
@override
+Widget build(BuildContext context, SettingsModel model) => SizedBox(
+ height: height,
+ child: model.science.scrollableGraphs
+ ? ScrollConfiguration(
+ behavior: DesktopScrollBehavior(),
+ child: ListView(
+ scrollDirection: Axis.horizontal,
+ children: [for (final child in children) SizedBox(width: 400, child: child)],
+ ),
+ )
+ : Row(
+ children: [for (final child in children) Expanded(child: child)],
+ ),
+ );The widgets to display.
+final List<Widget> children;The height of this row.
+final double height;The state of the SEGA animation.
+The rover is off-screen to the left, facing the right, and the text is transparent.
+ + +The rover is off-screen to the right, facing the right, and the text is 30% opaque.
+ + +The rover is off-screen to the left, facing the left, and the text is 100% opaque.
+ + +The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;A numeric identifier for the enumerated value.
+The values of a single enumeration are numbered
+consecutively from zero to one less than the
+number of values.
+This is also the index of the value in the
+enumerated type's static values list.
int get index;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();A constant List of the values in this enum, in order of their declaration.
+The settings page.
+model.
+ DiagnosticsNode objects describing this node's
+children.
+ Builds the UI according to the state in model.
@override
+Widget build(BuildContext context, SettingsBuilder model) => Scaffold(
+ appBar: AppBar(title: const Text("Settings")),
+ body: Column(children: [
+ Expanded(child: ListView(
+ padding: const EdgeInsets.all(12),
+ children: [
+ ValueEditor<NetworkSettings>(
+ name: "Network settings",
+ children: [
+ SocketEditor(name: "Subsystems socket", model: model.network.dataSocket),
+ SocketEditor(name: "Video socket", model: model.network.videoSocket),
+ SocketEditor(name: "Autonomy socket", model: model.network.autonomySocket),
+ SocketEditor(name: "Tank IP address", model: model.network.tankSocket, editPort: false),
+ ListTile(
+ title: const Text("Restart the network sockets"),
+ subtitle: const Text("This only resets your computer's network, not the rover's"),
+ trailing: const Icon(Icons.refresh),
+ onTap: () async {
+ await models.sockets.reset();
+ if (context.mounted) {
+ ScaffoldMessenger.of(context).showSnackBar(
+ const SnackBar(content: Text("Network reset"), duration: Duration(milliseconds: 500)),
+ );
+ }
+ },
+ ),
+ ],
+ ),
+ const Divider(),
+ ValueEditor<ArmSettings>(
+ name: "Arm settings",
+ children: [
+ NumberEditor(name: "Swivel increment", model: model.arm.swivel),
+ NumberEditor(name: "Shoulder increment", model: model.arm.shoulder),
+ NumberEditor(name: "Elbow increment", model: model.arm.elbow),
+ NumberEditor(name: "Wrist rotate increment", model: model.arm.rotate),
+ NumberEditor(name: "Wrist lift increment", model: model.arm.lift),
+ NumberEditor(name: "Pinch increment", model: model.arm.pinch),
+ NumberEditor(name: "IK increment", model: model.arm.ik),
+ SwitchListTile(
+ title: const Text("Use IK?"),
+ subtitle: const Text("Move in millimeters in 3D space instead of radians"),
+ value: model.arm.useIK,
+ onChanged: model.arm.updateIK,
+ ),
+ ],
+ ),
+ const Divider(),
+ ValueEditor<ScienceSettings>(
+ name: "Science settings",
+ children: [
+ NumberEditor(
+ name: "Number of samples",
+ model: model.science.numSamples,
+ ),
+ SwitchListTile(
+ title: const Text("Scrollable graphs"),
+ subtitle: const Text("Graphs can either be forced to fit the page or allowed to scroll\nMight be inconvenient for desktop users"),
+ value: model.science.scrollableGraphs,
+ onChanged: model.science.updateScrollableGraphs,
+ ),
+ ],
+ ),
+ const Divider(),
+ ValueEditor<DashboardSettings>(
+ name: "Dashboard Settings",
+ children: [
+ NumberEditor(
+ name: "Frames per second",
+ subtitle: "This does not affect the rover's cameras. Useful for limiting the CPU of the dashboard",
+ model: model.dashboard.fps,
+ ),
+ NumberEditor(
+ name: "Block size",
+ subtitle: "The precision of the GPS grid",
+ model: model.dashboard.blockSize,
+ ),
+ Row(children: [
+ const SizedBox(
+ width: 200,
+ child: ListTile(
+ title: Text("Split mode"),
+ ),
+ ),
+ const Spacer(),
+ DropdownMenu<SplitMode>(
+ initialSelection: model.dashboard.splitMode,
+ onSelected: model.dashboard.updateSplitMode,
+ dropdownMenuEntries: [
+ for (final value in SplitMode.values) DropdownMenuEntry(
+ value: value,
+ label: value.humanName,
+ ),
+ ],
+ ),
+ ],),
+ Row(children: [
+ const SizedBox(
+ width: 200,
+ child: ListTile(
+ title: Text("Theme mode"),
+ ),
+ ),
+ const Spacer(),
+ DropdownMenu<ThemeMode>(
+ initialSelection: model.dashboard.themeMode,
+ onSelected: model.dashboard.updateThemeMode,
+ dropdownMenuEntries: [
+ for (final value in ThemeMode.values) DropdownMenuEntry<ThemeMode>(
+ value: value,
+ label: value.humanName,
+ ),
+ ],
+ ),
+ ],),
+ ],
+ ),
+ const Divider(),
+ ValueEditor<EasterEggsSettings>(
+ name: "Easter eggs",
+ children: [
+ SwitchListTile(
+ title: const Text("Enable SEGA Intro"),
+ value: model.easterEggs.segaIntro,
+ onChanged: model.easterEggs.updateSegaIntro,
+ ),
+ // Disabled because the sound is horrible. Please find a better sound :)
+ // SwitchListTile(
+ // title: const Text("Enable SEGA sound"),
+ // subtitle: const Text('Says "Binghamton" in the SEGA style'),
+ // value: model.easterEggs.segaSound,
+ // onChanged: model.easterEggs.segaIntro ? model.easterEggs.updateSegaSound : null,
+ // ),
+ SwitchListTile(
+ title: const Text("Enable Clippy"),
+ value: model.easterEggs.enableClippy,
+ onChanged: model.easterEggs.updateClippy,
+ ),
+ SwitchListTile(
+ title: const Text("Bad Apple in the Map"),
+ value: model.easterEggs.badApple,
+ onChanged: model.easterEggs.updateBadApple,
+ ),
+ ],
+ ),
+ const Divider(),
+ Text("Misc", style: Theme.of(context).textTheme.titleLarge),
+ ListTile(
+ title: const Text("Adjust throttle"),
+ subtitle: const Text("Sets the max speed on the rover"),
+ trailing: const Icon(Icons.speed),
+ onTap: () => showDialog<void>(
+ context: context,
+ builder: (_) => ThrottleEditor(),
+ ),
+ ),
+ ListTile(
+ title: const Text("Open session output"),
+ subtitle: const Text("Opens all files created by this session"),
+ trailing: const Icon(Icons.launch),
+ onTap: () => launchUrl(services.files.loggingDir.uri),
+ ),
+ ListTile(
+ title: const Text("Open the output folder"),
+ subtitle: const Text("Contains logs, screenshots, and settings"),
+ trailing: const Icon(Icons.launch),
+ onTap: () => launchUrl(services.files.outputDir.uri),
+ ),
+ ListTile(
+ title: const Text("Change the LED strip color"),
+ subtitle: const Text("Opens an RGB picker"),
+ trailing: const Icon(Icons.launch),
+ onTap: () => showDialog<void>(context: context, builder: (_) => ColorEditor(ColorBuilder())),
+ ),
+ ListTile(
+ title: const Text("Set a timer"),
+ subtitle: const Text("Shows a timer for the current mission"),
+ trailing: const Icon(Icons.launch),
+ onTap: () => showDialog<void>(context: context, builder: (_) => TimerEditor()),
+ ),
+ ],
+ ),),
+ Row(
+ mainAxisAlignment: MainAxisAlignment.end,
+ children: [
+ TextButton(
+ onPressed: () => Navigator.of(context).pop(),
+ child: const Text("Cancel"),
+ ),
+ const SizedBox(width: 4),
+ ElevatedButton.icon(
+ onPressed: !model.isValid ? null : () async {
+ await model.save();
+ if (context.mounted) Navigator.of(context).pop();
+ },
+ label: const Text("Save"),
+ icon: model.isLoading
+ ? const SizedBox(height: 24, width: 24, child: CircularProgressIndicator())
+ : const Icon(Icons.save),
+ ),
+ const SizedBox(width: 4),
+ ],
+ ),
+ const SizedBox(height: 12),
+ ],),
+);A function to create or find the model. This function will only be called once.
+@override
+SettingsBuilder createModel() => SettingsBuilder();A widget to switch between tank and rover modes.
+model.
+ DiagnosticsNode objects describing this node's
+children.
+ A constructor for this widget.
+SocketSwitcher() : super(models.sockets);Builds the UI according to the state in model.
@override
+Widget build(BuildContext context, Sockets model) => DropdownButton<RoverType>(
+ value: model.rover,
+ onChanged: model.setRover,
+ focusNode: FocusNode(),
+ items: [
+ for (final type in RoverType.values) DropdownMenuItem(
+ value: type,
+ child: Text(type.humanName),
+ ),
+ ],
+ );Initializes the dashboard and handles errors.
+DiagnosticsNode objects describing this node's
+children.
+ Creates the mutable state for this widget at a given location in the tree.
+Subclasses should override this method to return a newly created +instance of their associated State subclass:
+@override
+State<SomeWidget> createState() => _SomeWidgetState();
+The framework can call this method multiple times over the lifetime of
+a StatefulWidget. For example, if the widget is inserted into the tree
+in multiple locations, the framework will create a separate State object
+for each location. Similarly, if the widget is removed from the tree and
+later inserted into the tree again, the framework will call createState
+again to create a fresh State object, simplifying the lifecycle of
+State objects.
@override
+SplashPageState createState() => SplashPageState();Initializes the dashboard and handles errors.
+The Audio player.
+final audioPlayer = AudioPlayer();Describes the part of the user interface represented by this widget.
+The framework calls this method in a number of different situations. For +example:
+This method can potentially be called in every frame and should not have +any side effects beyond building a widget.
+The framework replaces the subtree below this widget with the widget +returned by this method, either by updating the existing subtree or by +removing the subtree and inflating a new subtree, depending on whether the +widget returned by this method can update the root of the existing +subtree, as determined by calling Widget.canUpdate.
+Typically implementations return a newly created constellation of widgets +that are configured with information from this widget's constructor, the +given BuildContext, and the internal state of this State object.
+The given BuildContext contains information about the location in the
+tree at which this widget is being built. For example, the context
+provides the set of inherited widgets for this location in the tree. The
+BuildContext argument is always the same as the context property of
+this State object and will remain the same for the lifetime of this
+object. The BuildContext argument is provided redundantly here so that
+this method matches the signature for a WidgetBuilder.
Putting a Widget build(BuildContext context) method on State rather
+than putting a Widget build(BuildContext context, State state) method
+on StatefulWidget gives developers more flexibility when subclassing
+StatefulWidget.
For example, AnimatedWidget is a subclass of StatefulWidget that
+introduces an abstract Widget build(BuildContext context) method for its
+subclasses to implement. If StatefulWidget already had a build method
+that took a State argument, AnimatedWidget would be forced to provide
+its State object to subclasses even though its State object is an
+internal implementation detail of AnimatedWidget.
Conceptually, StatelessWidget could also be implemented as a subclass of +StatefulWidget in a similar manner. If the build method were on +StatefulWidget rather than State, that would not be possible anymore.
+Putting the build function on State rather than StatefulWidget also
+helps avoid a category of bugs related to closures implicitly capturing
+this. If you defined a closure in a build function on a
+StatefulWidget, that closure would implicitly capture this, which is
+the current widget instance, and would have the (immutable) fields of that
+instance in scope:
// (this is not valid Flutter code)
+class MyButton extends StatefulWidgetX {
+ MyButton({super.key, required this.color});
+
+ final Color color;
+
+ @override
+ Widget build(BuildContext context, State state) {
+ return SpecialWidget(
+ handler: () { print('color: $color'); },
+ );
+ }
+}
+For example, suppose the parent builds MyButton with color being blue,
+the $color in the print function refers to blue, as expected. Now,
+suppose the parent rebuilds MyButton with green. The closure created by
+the first build still implicitly refers to the original widget and the
+$color still prints blue even through the widget has been updated to
+green; should that closure outlive its widget, it would print outdated
+information.
In contrast, with the build function on the State object, closures +created during build implicitly capture the State instance instead of +the widget instance:
+class MyButton extends StatefulWidget {
+ const MyButton({super.key, this.color = Colors.teal});
+
+ final Color color;
+ // ...
+}
+
+class MyButtonState extends State<MyButton> {
+ // ...
+ @override
+ Widget build(BuildContext context) {
+ return SpecialWidget(
+ handler: () { print('color: ${widget.color}'); },
+ );
+ }
+}
+Now when the parent rebuilds MyButton with green, the closure created by
+the first build still refers to State object, which is preserved across
+rebuilds, but the framework has updated that State object's widget
+property to refer to the new MyButton instance and ${widget.color}
+prints green, as expected.
See also:
+@override
+Widget build(BuildContext context) => Scaffold(
+ body: errorText == null
+ ? Stack( // SEGA intro
+ alignment: Alignment.center,
+ children: [
+ AnimatedOpacity(
+ duration: const Duration(milliseconds: 1000),
+ opacity: switch (state) {
+ SegaState.partOne => 0,
+ SegaState.partTwo => 0.2,
+ SegaState.partThree => 1,
+ },
+ child: Text("Binghamton University\nRover Team", textAlign: TextAlign.center, style: context.textTheme.displayMedium),
+ ),
+ AnimatedAlign(
+ duration: const Duration(milliseconds: 500),
+ alignment: switch (state) {
+ SegaState.partOne => const Alignment(-1.5, 0),
+ SegaState.partTwo => const Alignment(1.5, 0),
+ SegaState.partThree => const Alignment(-1.5, 0),
+ },
+ child: Transform.flip(
+ flipX: switch (state) {
+ SegaState.partOne => true,
+ SegaState.partTwo => true,
+ SegaState.partThree => false,
+ },
+ child: SizedBox(
+ width: 150,
+ height: 150,
+ child: Image.asset("assets/rover.png"),
+ ),
+ ),
+ ),
+ ],
+ )
+ : Center(child: Column( // Error
+ mainAxisAlignment: MainAxisAlignment.center,
+ children: [
+ const Spacer(flex: 2),
+ Text("Something went wrong", style: Theme.of(context).textTheme.displayLarge),
+ const Spacer(),
+ Text("The error occurred when trying to initialize $current", style: Theme.of(context).textTheme.headlineLarge),
+ const SizedBox(height: 24),
+ Text("Here is the exact error:", style: Theme.of(context).textTheme.titleLarge),
+ const SizedBox(height: 16),
+ Text(errorText!),
+ const Spacer(flex: 2),
+ ],
+ ),),
+);The current task, if any.
+String? current;Called when this object is removed from the tree permanently.
+The framework calls this method when this State object will never +build again. After the framework calls dispose, the State object is +considered unmounted and the mounted property is false. It is an error +to call setState at this point. This stage of the lifecycle is terminal: +there is no way to remount a State object that has been disposed.
+Subclasses should override this method to release any resources retained +by this object (e.g., stop any active animations).
+If a State's build method depends on an object that can itself
+change state, for example a ChangeNotifier or Stream, or some
+other object to which one can subscribe to receive notifications, then
+be sure to subscribe and unsubscribe properly in initState,
+didUpdateWidget, and dispose:
Implementations of this method should end with a call to the inherited
+method, as in super.dispose().
This method is not invoked at times where a developer might otherwise +expect it, such as application shutdown or dismissal via platform +native methods.
+There is no way to predict when application shutdown will happen. For +example, a user's battery could catch fire, or the user could drop the +device into a swimming pool, or the operating system could unilaterally +terminate the application process due to memory pressure.
+Applications are responsible for ensuring that they are well-behaved +even in the face of a rapid unscheduled termination.
+To artificially cause the entire widget tree to be disposed, consider +calling runApp with a widget such as SizedBox.shrink.
+To listen for platform shutdown messages (and other lifecycle changes), +consider the AppLifecycleListener API.
+An application may have both Flutter and non-Flutter UI in it. If the +application calls non-Flutter methods to remove Flutter based UI such as +platform native API to manipulate the platform native navigation stack, +the framework does not know if the developer intends to eagerly free +resources or not. The widget tree remains mounted and ready to render +as soon as it is displayed again.
+To release resources more eagerly, establish a platform channel +and use it to call runApp with a widget such as SizedBox.shrink when +the framework should dispose of the active widget tree.
+See also:
+@override
+void dispose() {
+ audioPlayer.dispose();
+ super.dispose();
+}The error message produced during initialization, if any.
+String? errorText;Calls Services.init and Models.init while monitoring for errors.
+Future<void> init() async {
+ try {
+ await SystemChrome.setPreferredOrientations([DeviceOrientation.landscapeLeft, DeviceOrientation.landscapeRight]);
+ current = "Flutter";
+ WidgetsFlutterBinding.ensureInitialized();
+
+ current = "services";
+ await services.init();
+
+ current = "models";
+ await models.init();
+ if (models.settings.easterEggs.segaIntro) await initAnimation();
+ if (mounted) {
+ await Navigator.of(context).pushReplacementNamed(Routes.home);
+ }
+ } catch (error, stackTrace) {
+ setState(() => errorText = "$error\n$stackTrace");
+ rethrow;
+ }
+}Starts the SEGA animation.
+Future<void> initAnimation() async {
+ // Disabled because the sound is horrible. Please find a better sound :)
+ // if (models.settings.easterEggs.segaSound) {
+ // await audioPlayer.setAsset("assets/binghamton2.wav");
+ // await audioPlayer.setVolume(0.5);
+ // audioPlayer.play().ignore();
+ // }
+ setState(() => state = SegaState.partTwo);
+ await Future<void>.delayed(const Duration(milliseconds: 750));
+ setState(() => state = SegaState.partThree);
+ await Future<void>.delayed(const Duration(milliseconds: 750));
+}Called when this object is inserted into the tree.
+The framework will call this method exactly once for each State object +it creates.
+Override this method to perform initialization that depends on the +location at which this object was inserted into the tree (i.e., context) +or on the widget used to configure this object (i.e., widget).
+If a State's build method depends on an object that can itself
+change state, for example a ChangeNotifier or Stream, or some
+other object to which one can subscribe to receive notifications, then
+be sure to subscribe and unsubscribe properly in initState,
+didUpdateWidget, and dispose:
You should not use BuildContext.dependOnInheritedWidgetOfExactType from this +method. However, didChangeDependencies will be called immediately +following this method, and BuildContext.dependOnInheritedWidgetOfExactType can +be used there.
+Implementations of this method should start with a call to the inherited
+method, as in super.initState().
@override
+void initState() {
+ super.initState();
+ init();
+}The state of the SEGA animation.
+SegaState state = SegaState.partOne;A widget to display all the settings in a ValueBuilder.
+Technically this class does not need to be used with ValueBuilder, but it provides a heading +and a list of children widgets to modify individual settings.
+DiagnosticsNode objects describing this node's
+children.
+ Creates a widget to modify a value.
+const ValueEditor({required this.name, required this.children});Describes the part of the user interface represented by this widget.
+The framework calls this method when this widget is inserted into the tree +in a given BuildContext and when the dependencies of this widget change +(e.g., an InheritedWidget referenced by this widget changes). This +method can potentially be called in every frame and should not have any side +effects beyond building a widget.
+The framework replaces the subtree below this widget with the widget +returned by this method, either by updating the existing subtree or by +removing the subtree and inflating a new subtree, depending on whether the +widget returned by this method can update the root of the existing +subtree, as determined by calling Widget.canUpdate.
+Typically implementations return a newly created constellation of widgets +that are configured with information from this widget's constructor and +from the given BuildContext.
+The given BuildContext contains information about the location in the +tree at which this widget is being built. For example, the context +provides the set of inherited widgets for this location in the tree. A +given widget might be built with multiple different BuildContext +arguments over time if the widget is moved around the tree or if the +widget is inserted into the tree in multiple places at once.
+The implementation of this method must only depend on:
+context using
+BuildContext.dependOnInheritedWidgetOfExactType.If a widget's build method is to depend on anything else, use a +StatefulWidget instead.
+See also:
+@override
+Widget build(BuildContext context) => Column(
+ crossAxisAlignment: CrossAxisAlignment.start,
+ children: [
+ const SizedBox(height: 4),
+ Padding(
+ padding: const EdgeInsets.symmetric(horizontal: 8),
+ child: Text(
+ name,
+ style: Theme.of(context).textTheme.titleLarge,
+ textAlign: TextAlign.start,
+ ),
+ ),
+ const SizedBox(height: 4),
+ ...children,
+ ],
+);Widgets to modify each individual setting.
+final List<Widget> children;The name of the value being edited.
+final String name;The icon to show for logs with BurtLogLevel.critical.
+final criticalWidget = Icon(Icons.cancel, color: Colors.red.shade900);The icon to show for logs with BurtLogLevel.debug.
+const debugWidget = Icon(Icons.chat, color: Colors.blueGrey);The icon to show for logs with BurtLogLevel.error.
+const errorWidget = Icon(Icons.error, color: Colors.red);Gets titles for a graph.
+GetTitleWidgetFunction getTitles(List<String> titles) => (value, meta) => SideTitleWidget(
+ axisSide: AxisSide.bottom,
+ space: 2,
+ child: Text(titles[value.toInt()]),
+);The icon to show for logs with BurtLogLevel.info.
+final infoWidget = Icon(Icons.info, color: Colors.lightBlue.shade900);Contains the high-level UI code that defines each page.
+This library is organized by having a separate file for each page (or complex popup) in +the entire app.
+This library may depend on the data, services, models, and widgets libraries.
+The icon to show for logs with BurtLogLevel.trace.
+const traceWidget = Icon(Icons.code, color: Colors.grey);The icon to show for logs with BurtLogLevel.warning.
+const warningWidget = Icon(Icons.warning, color: Colors.orange);A service to send and receive Protobuf messages over a UDP socket, using ProtoSocket.
This class monitors its connection to the given device by sending heartbeats periodically and +logging the response (or lack thereof). To be notified of connection events, pass in +onConnect and onDisconnect callbacks. To be notified of incoming messages, pass in an +onMessage callback that accepts a WrappedMessage.
+To use this class:
+device.
+ RawDatagramSocket.bind.
+ allowedErrors).
+ destinationOverride.
+ Listens for incoming messages on a UDP socket and sends heartbeats to the device.
DashboardSocket({
+ required this.onConnect,
+ required this.onDisconnect,
+ required this.messageHandler,
+ required super.device,
+}) : super(
+ port: null,
+ quiet: true,
+);Checks for incoming heartbeats from the intended device(s).
+For example, on the rover, this waits for new heartbeats, but on the Dashboard, +it sends heartbeats to every connected device.
+@override
+Future<void> checkHeartbeats() async {
+ if (_isChecking) return;
+ // 1. Clear state and send a heartbeat
+ _isChecking = true;
+ _heartbeats = 0;
+ final wasConnected = isConnected;
+ sendMessage(Connect(sender: Device.DASHBOARD, receiver: device));
+ // 2. Wait a bit and count the number of responses
+ await Future<void>.delayed(heartbeatWaitDelay);
+ if (_heartbeats > 0) {
+ connectionStrength.value += connectionIncrement * _heartbeats;
+ } else {
+ connectionStrength.value -= connectionIncrement;
+ }
+ // 3. Assess the current state
+ connectionStrength.value = connectionStrength.value.clamp(0, 1);
+ if (isConnected && !wasConnected) onConnect(device);
+ if (wasConnected && !isConnected) onDisconnect(device);
+ _isChecking = false;
+}The connection strength, as a percentage to this device.
+final connectionStrength = ValueNotifier<double>(0);The destination port to send to.
+All the send* functions allow you to send to a specific SocketInfo. This field
+is the default destination if those parameters are omitted.
SocketInfo? destination;The rover device this socket represents.
+final Device device;Closes the socket.
+@override
+Future<void> dispose() async {
+ heartbeatTimer?.cancel();
+ await super.dispose();
+}The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;How often to check for heartbeats.
+@override
+Duration get heartbeatInterval => const Duration(milliseconds: 200);A timer to call checkHeartbeats every heartbeatInterval.
+Timer? heartbeatTimer;Initializes the socket, and restarts it if a known "safe" error occurs (see allowedErrors).
@override
+Future<void> init() async {
+ await super.init();
+ heartbeatTimer = Timer.periodic(heartbeatInterval, (_) => checkHeartbeats());
+}Whether this socket has a stable connection to the device.
+@override
+bool get isConnected => connectionStrength.value > 0;A logger to capture important events during operation.
+final logger = BurtLogger();The handler to call when a WrappedMessage comes in. Used by onMessage.
+final WrappedMessageHandler messageHandler;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);Override this function to process incoming data, along with the source address and port.
+@override
+void onData(Datagram packet) {
+ final wrapper = WrappedMessage.fromBuffer(packet.data);
+ final source = SocketInfo(address: packet.address, port: packet.port);
+ onWrapper(wrapper, source);
+}Handles an incoming heartbeat from another device.
+@override
+void onHeartbeat(Connect heartbeat, SocketInfo source) => _heartbeats++;Handles a non-heartbeat message, usually containing data or commands.
+@override
+void onMessage(WrappedMessage wrapper) => messageHandler(wrapper);A callback for when messages are received.
+@override
+@mustCallSuper
+void onWrapper(WrappedMessage wrapper, SocketInfo source) {
+ if (wrapper.name == Connect().messageName) {
+ final heartbeat = Connect.fromBuffer(wrapper.data);
+ onHeartbeat(heartbeat, source);
+ } else {
+ onMessage(wrapper);
+ }
+}The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);The port this socket is listening on. See RawDatagramSocket.bind.
int? port;Whether to silence "normal" output, like opening/closing and resetting sockets.
+final bool quiet;A representation of the runtime type of the object.
+external Type get runtimeType;Sends data to the given destination.
+Being UDP, this function does not wait for a response or even confirmation of a +successful send and is therefore very quick and non-blocking.
+void sendData(List<int> data, {SocketInfo? destinationOverride}) {
+ final target = destinationOverride ?? destination;
+ if (target == null) return;
+ if (_socket == null) throw StateError("Cannot use a UdpSocket on port $port after it's been disposed");
+ _socket!.send(data, target.address, target.port);
+}Wraps a message and sends it with sendWrapper.
+void sendMessage(Message message, {SocketInfo? destinationOverride}) =>
+ sendWrapper(message.wrap(), destinationOverride: destinationOverride);Sends an already-wrapped WrappedMessage to the destination, or the given destinationOverride.
Use this function instead of sendMessage if you need to manually wrap a message yourself.
+void sendWrapper(WrappedMessage wrapper, {SocketInfo? destinationOverride}) =>
+ sendData(wrapper.writeToBuffer(), destinationOverride: destinationOverride);A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();Indicates that no device has been connected.
+A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
@override
+String toString() => "No device was chosen. Please connect by calling Serial.connect() first.";A service to read and write to the file system.
+The dashboard reads and writes to files in outputDir.
+IOSink for faster writes.
+ Cleans up any resources used by the service.
+@override
+Future<void> dispose() async { }The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;Ensure that files and directories that are expected to be present actually +exist on the system. If not, create them.
+@override
+Future<void> init() async {
+ final appDir = await getApplicationDocumentsDirectory();
+ outputDir = await Directory("${appDir.path}/Dashboard").create();
+ loggingDir = await Directory("${outputDir.path}/logs/${DateTime.now().timeStamp}").create(recursive: true);
+ if (!settingsFile.existsSync()) await writeSettings(null);
+}Outputs log data to the correct file based on message
+Future<void> logData(Message message) async {
+ final name = message.messageName;
+ final wrapper = message.wrap();
+ final content = base64Encode(wrapper.writeToBuffer());
+ await _log(name, content);
+}Outputs an error to the Dashboard log file.
+Future<void> logError(Object error, StackTrace stack) async{
+ final content = "${DateTime.now().timeStamp} $error\n $stack\n";
+ await _log("Dashboard", content);
+}A map from filename to an IOSink for faster writes.
final Map<String, IOSink> logFiles = {};Outputs a log to its device's respective log file.
+Future<void> logMessage(BurtLog log) async {
+ final name = log.device.humanName;
+ final content = log.format();
+ await _log(name, content);
+}The directory where all logging data is outputted
+This includes all the different operating modes with specified folders inside
+late final Directory loggingDir;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);The directory where the dashboard keeps its files.
+This includes settings, data, images, and anything else the user or dashboard +may want to keep between sessions. Categories of output, like screenshots, +should get their own subdirectory.
+late final Directory outputDir;Reads logs from the given file.
+Future<List<WrappedMessage>> readLogs(File file) async => [
+ for (final line in (await file.readAsString()).trim().split("\n"))
+ WrappedMessage.fromBuffer(base64.decode(line)),
+];Reads the user's settings from the settingsFile.
+Future<Settings> readSettings({bool retry = true}) async {
+ final Json json = jsonDecode(await settingsFile.readAsString());
+ try {
+ final settings = Settings.fromJson(json);
+ await writeSettings(settings); // re-save any default values
+ return settings;
+ } catch (error) {
+ services.error = "Settings were corrupted and reset back to defaults";
+ await writeSettings(Settings.fromJson({})); // delete corrupt settings
+ if (retry) {
+ return readSettings(retry: false);
+ } else {
+ rethrow;
+ }
+ }
+}A representation of the runtime type of the object.
+external Type get runtimeType;The directory where screenshots are stored.
+These are only screenshots of video feeds, not of the dashboard itself.
+Directory get screenshotsDir => Directory("${outputDir.path}/screenshots");The file containing the user's Settings, in JSON form.
+This file should contain the result of Settings.toJson, and loading settings +from the file should be done with Settings.fromJson.
+File get settingsFile => outputDir / "settings.json";A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();Saves the current frame in the feed to the camera's output directory.
+Future<void> writeImage(List<int> image, String cameraName) async {
+ final dir = await Directory("${screenshotsDir.path}/$cameraName").create(recursive: true);
+ final files = dir.listSync();
+ final number = files.isEmpty ? 1 : (int.parse(files.last.filename) + 1);
+ await File("${dir.path}/$number.jpg").writeAsBytes(image);
+}Saves the Settings object to the settingsFile, as JSON.
+Future<void> writeSettings(Settings? value) async {
+ final json = jsonEncode(value?.toJson() ?? {});
+ await settingsFile.writeAsString(json);
+}An extension to do gamepad math.
+Normalizes joystick inputs to be between -1 and 1.
+double get normalizeJoystick {
+ final value = (this - 128) / 32768;
+ return (value.abs() < epsilon) ? 0 : value.clamp(-1, 1);
+}Normalizes the trigger inputs to be between 0 and 1.
+double get normalizeTrigger {
+ final value = this / 256;
+ return (value.abs() < epsilon) ? 0 : value.clamp(0, 1);
+}A service to receive input from a gamepad connected to the user's device.
+This service uses package:win32_gamepad, to read
+controller inputs, which works with XInput-compliant devices. At the time of writing, there
+are no gamepad plugins on pub.dev available for MacOS or Linux -- this uses Win32 libraries.
To read the state of the controller, check Gamepad.state, which will always be available, even +when the controller is disconnected (all its fields will be zero). To check for a connection, use +Gamepad.isConnected. No action is needed to check for a new gamepad, but you must call +update to read any button presses, or else Gamepad.state will never update.
+Gamepads the user has connected.
+ Connects to a gamepad and calls GamepadUtils.pulse.
+Future<void> connect(int index) async {
+ if (!Platform.isWindows) return;
+ gamepads[index] = MockGamepad();
+ for (var i = 0; i < maxGamepads; i++) {
+ final gamepad = Gamepad(i);
+ if (!gamepad.isConnected) continue;
+ if (ids.contains(i)) continue;
+ gamepads[index] = gamepad;
+ gamepad.pulse();
+ return;
+ }
+}Cleans up any resources used by the service.
+@override
+Future<void> dispose() async {}A list of all the Gamepads the user has connected.
Non-connected gamepads are represented with MockGamepads, which has the nice benefit of +automatically handling the case where the user is on a non-supported platform.
+final List<Gamepad> gamepads = [
+ for (int i = 0; i < numGamepads; i++) MockGamepad(),
+];The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;The set of all the Gamepad.controller IDs.
+Set<int> get ids => {
+ for (final gamepad in gamepads) gamepad.controller,
+};Initializes the service.
+@override
+Future<void> init() async {
+ for (var i = 0; i < numGamepads; i++) {
+ await connect(i);
+ }
+}Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The maximum number of gamepads we support.
+static const int numGamepads = 3;The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();Checks the state of the controller and updates each Gamepad.state.
+New button presses will not be recorded until this is called, so you should try to do +so in a way that it is called periodically, either via a timer or Flutter's build function.
+void update() {
+ for (final gamepad in gamepads) {
+ gamepad.updateState();
+ }
+}More user-friendly values from GamepadState.
+The signed value of the D-pad's horizontal axis. Left is -1, right is +1.
+double get normalDpadX {
+ if (dpadLeft) return -1;
+ if (dpadRight) return 1;
+ return 0;
+}The signed value of the D-pad's vertical axis. Up is +1, down is -1.
+double get normalDpadY {
+ if (dpadUp) return 1;
+ if (dpadDown) return -1;
+ return 0;
+}Returns a normalized value for the left trigger. See GamepadNumbers.normalizeTrigger.
+double get normalLeftTrigger => leftTrigger.normalizeTrigger;Returns a normalized value for the left joystick's X-axis. See GamepadNumbers.normalizeJoystick.
+double get normalLeftX => leftThumbstickX.normalizeJoystick;Returns a normalized value for the left joystick's Y-axis. See GamepadNumbers.normalizeJoystick.
+double get normalLeftY => leftThumbstickY.normalizeJoystick;Returns a normalized value for the right trigger. See GamepadNumbers.normalizeTrigger.
+double get normalRightTrigger => rightTrigger.normalizeTrigger;Returns a normalized value for the right joystick's X-axis. See GamepadNumbers.normalizeJoystick.
+double get normalRightX => rightThumbstickX.normalizeJoystick;Returns a normalized value for the right joystick's Y-axis. See GamepadNumbers.normalizeJoystick.
+double get normalRightY => rightThumbstickY.normalizeJoystick;The signed value of the bumpers. The left bumper is negative, the right is positive.
+double get normalShoulder {
+ if (leftShoulder) return -1;
+ if (rightShoulder) return 1;
+ return 0;
+}The signed value of the triggers. The left trigger is negative, the right is positive.
+double get normalTrigger {
+ if (leftTrigger > 0) return -normalLeftTrigger;
+ if (rightTrigger > 0) return normalRightTrigger;
+ return 0;
+}Convenience methods on Gamepad.
+A shorthand to get the battery level of this controller.
+GamepadBatteryLevel get battery => gamepadBatteryInfo.batteryLevel;Makes the gamepad vibrate a small "pulse"
+void pulse() async { // ignore: avoid_void_async, because this should not be awaited
+ if (!isConnected) return;
+ vibrate(leftMotorSpeed: vibrateIntensity, rightMotorSpeed: vibrateIntensity);
+ await Future<void>.delayed(const Duration(milliseconds: 200));
+ vibrate(); // default speed of 0
+ await Future<void>.delayed(const Duration(milliseconds: 100));
+ vibrate(leftMotorSpeed: vibrateIntensity, rightMotorSpeed: vibrateIntensity);
+ await Future<void>.delayed(const Duration(milliseconds: 200));
+ vibrate(); // default speed of 0
+}Indicates that a data packet has come malformed.
+Similar to a FormatException, but this usually indicates a hardware or
+physical connection issue to the serial device.
Creates an error about a malformed packet.
+const MalformedSerialPacket({required this.packet});The malformed packet.
+final Uint8List packet;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
@override
+String toString() => "Malformed serial packet: $packet.";An "implementation" of package:win32_gamepad for non-supported platforms.
Controls whether the gamepad is active.
+This function is meant to be called when an app gains or loses focus. When +set to false, vibration effects will be stopped and calls to updateState +will be returned neutral values.
+@override
+set appHasFocus(bool value) { }The identifier for the current controller.
+Up to four controllers may be connected to a system, numbered from 0 to
+3.
@override
+int get controller => -1;Get the battery type for the gamepad.
+@override
+GamepadBatteryInfo get gamepadBatteryInfo => GamepadBatteryInfo(0, GamepadDeviceType.controller);Get the battery type for a headset attached to the gamepad, if there is +one.
+@override
+GamepadBatteryInfo get headsetBatteryInfo => GamepadBatteryInfo(0, GamepadDeviceType.headset);Returns a value for whether the controller is connected.
+This can be used to identify which controllers are connected to a system. +But a controller may be disconnected at any point, so a true value does +not guarantee that a following call will succeed. Instead, guard calls to +other functions to check that a DeviceNotConnectedError is not thrown.
+@override
+bool get isConnected => false;The status of the buttons, triggers and thumbsticks on the gamepad.
+@override
+GamepadState get state => GamepadState.disconnected();The status of the buttons, triggers and thumbsticks on the gamepad.
+@override
+set state(GamepadState value) { }Get the current state of the current controller.
+This function is designed to be called once for each pass on a game loop. +It can safely be called even if the gamepad is disconnected, at which +point neutral values will be returned for all buttons and thumbsticks.
+@override
+void updateState() { }Activate a gamepad controller's vibration motors.
+Either the left or right motor can be activated. The value should be +between 0 and 65535.
+@override
+void vibrate({int? leftMotorSpeed, int? rightMotorSpeed}) { }Indicates that multiple devices are available to connect to.
+Creates an error that contains the list of available devices.
+const MultipleDevicesFound(this.devices);The list of available devices.
+final List<String> devices;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
@override
+String toString() => "Multiple serial devices were found: ${devices.join(', ')}";Indicates that no devices are available to connect to.
+A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
@override
+String toString() => "No available serial device found.";Indicates that the port could not be opened.
+This usually means another process has an open handle on the port.
+Creates an error about a port that won't open.
+const SerialCannotOpen(this.port);The port that failed to open.
+final String port;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
@override
+String toString() => "Could not open port $port";A service to connect to a single serial device.
+Create a new SerialDevice instance for every device you wish to connect to. You must call +connect before you can use the device, and you must call dispose when you are done.
+To send a message, use sendMessage. To handle messages, pass an onMessage callback.
+Manages a connection to a Serial device.
+SerialDevice({required this.port, required this.onMessage});A list of all available ports to connect to.
+static List<String> get availablePorts => SerialPort.availablePorts;Opens the Serial port and identifies the device on the other end.
+Future<void> connect() async {
+ await Future(_setupConnection);
+ await _identifyDevice();
+ _reader.stream.listen(_onData);
+}The device we're connected to.
+Initially, the device is just a generic "firmware", but after calling Connect, the Teensy +will identify itself more specifically.
+Device device = Device.FIRMWARE;Closes the connection and resets the device.
+void dispose() {
+ _writer..close()..dispose();
+ _reader.close();
+}The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);A callback to run whenever a message is received by this device.
+final WrappedMessageHandler onMessage;The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);The port to connect to.
+final String port;Sending this code resets the Teensy to its "unconnected" state.
+static const resetCode = [0, 0, 0, 0];A representation of the runtime type of the object.
+external Type get runtimeType;Sends a message to the device, if the device accepts it.
+The firmware on the rover cannot handle WrappedMessages and instead assume that all commands
+they receive are the type they ecpect. This function checks getCommandName to ensure that
+the message is of the correct type before sending it.
void sendMessage(Message message) {
+ final thisDeviceAccepts = getCommandName(device);
+ if (message.messageName != thisDeviceAccepts) return;
+ _sendRaw(message.writeToBuffer());
+}A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();The base class for all exceptions relating to using Serial devices.
+Provides a const constructor.
+const SerialException();Indicates that the Serial device did not reciprocate the handshake.
+In particular, the device sent back a "Connect" message, but the fields +weren't set properly.
+A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
@override
+String toString() => "Connection handshake failed";Indicates that the device is unreachable.
+This is simply a SerialPortError wrapped up as a SerialException.
+libserialport library.
+ Creates an SerialException to represent a SerialPortError.
+const SerialIOError(this.error);The underlying IO error thrown by the libserialport library.
final SerialPortError error;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
@override
+String toString() => error.toString();A dependency injection service that manages the lifecycle of other services.
+All services must only be used by accessing them from this class, and this class will take care +of calling lifecycle methods like init while handling possibly asynchrony.
+When adding a new service, declare it as a field in this class and add it to the init +and dispose methods. Otherwise, the service will fail to initialize and dispose properly.
+To get an instance of this class, use services.
+Cleans up any resources used by the service.
+@override
+Future<void> dispose() async {
+ await gamepad.dispose();
+ await files.dispose();
+}The first error that occurred during startup.
+String? error;A service that reads and writes to device files.
+final files = FilesService();A service that handles controller inputs.
+final gamepad = GamepadService();The hash code for this object.
+A hash code is a single integer which represents the state of the object +that affects operator == comparisons.
+All objects have hash codes.
+The default hash code implemented by Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).
If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Set and Map implementations.
Hash codes must be the same for objects that are equal to each other +according to operator ==. +The hash code of an object should only change if the object changes +in a way that affects equality. +There are no further requirements for the hash codes. +They need not be consistent between executions of the same program +and there are no distribution guarantees.
+Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like HashSet or HashMap.
If a subclass overrides hashCode, it should override the +operator == operator as well to maintain consistency.
+external int get hashCode;Initializes the service.
+@override
+Future<void> init() async {
+ await gamepad.init();
+ await files.init();
+}Invoked when a nonexistent method or property is accessed.
+A dynamic member invocation can attempt to call a member which +doesn't exist on the receiving object. Example:
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+This invalid code will invoke the noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
Classes can override noSuchMethod to provide custom behavior +for such invalid dynamic invocations.
+A class with a non-default noSuchMethod invocation can also +omit implementations for members of its interface. +Example:
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+This code has no compile-time warnings or errors even though
+the MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.
If a value is returned from noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.
The default behavior is to throw a NoSuchMethodError.
@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);The equality operator.
+The default behavior for all Objects is to return true if and
+only if this object and other are the same object.
Override this method to specify a different equality relation on +a class. The overriding method must still be an equivalence relation. +That is, it must be:
+Total: It must return a boolean for all arguments. It should never throw.
+Reflexive: For all objects o, o == o must be true.
Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.
Transitive: For all objects o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.
The method should also be consistent over time, +so whether two objects are equal should only change +if at least one of the objects was modified.
+If a subclass overrides the equality operator, it should override +the hashCode method as well to maintain consistency.
+external bool operator ==(Object other);A representation of the runtime type of the object.
+external Type get runtimeType;A string representation of this object.
+Some classes have a default textual representation,
+often paired with a static parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.
Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.
external String toString();How much each successful/missed handshake is worth, as a percent.
+const connectionIncrement = 0.2;The "deadzone" of the gamepad.
+const epsilon = 0.01;How long to wait for incoming heartbeats after sending them out.
+const heartbeatWaitDelay = Duration(milliseconds: 200);The maximum amount of gamepads a user can have.
+const maxGamepads = 4;Defines handler classes for out-of-app resources.
+These resources include plugins that are designed to be general, not specific to the rover project.
+By providing rover-centric APIs for these services, the app's logic becomes simpler and easier
+to follow without having to study the specific service. Each service declared is to extend
+the abstract Service class.
The Services class acts as a bundle service for all services defined in this library. Its +responsibilities include initializing and disposing of the services, and it also acts as a +sort of dependency injection service by ensuring simple access. Use the services singleton.
+This library sits right above the data library, and may import it, but not any other library +in this project, only 3rd party plugins. That way, all other code can import any service.
+ProtoSocket.
+package:win32_gamepad for non-supported platforms.
+The default vibration intensity.
+This value is stored in an unsigned 16-bit integer, so it's range is from 0-65,535.
+const vibrateIntensity = 65000;"),r:s("o<+item,matchPosition(w,A)>"),s:s("o A widget to edit an AutonomyCommand. Builds the UI according to the state in A function to create or find the model. This function will only be called once. Opens a dialog to prompt the user to create an AutonomyCommand and sends it to the rover. Convenience functions on BuildContext. Gets the color scheme of the app. Gets the text theme of the app. A widget to modify CameraDetails for a given camera, backed by a CameraDetailsBuilder. Creates a widget to modify a CameraDetails. Builds the UI according to the state in A function to create or find the model. This function will only be called once. The data for the camera being modified. This must be a VideoData and not a CameraDetails to get the camera's ID. A widget to edit a color, backed by ColorBuilder. A widget that modifies the given view model's color. Builds the UI according to the state in Displays controls for the given Controller. A const constructor for this widget. Builds the UI according to the state in The number gamepad being used. A widget to choose a single value from a dropdown. Creates a DropdownButton list to choose between items. Describes the part of the user interface represented by this widget. The framework calls this method when this widget is inserted into the tree
+in a given BuildContext and when the dependencies of this widget change
+(e.g., an InheritedWidget referenced by this widget changes). This
+method can potentially be called in every frame and should not have any side
+effects beyond building a widget. The framework replaces the subtree below this widget with the widget
+returned by this method, either by updating the existing subtree or by
+removing the subtree and inflating a new subtree, depending on whether the
+widget returned by this method can update the root of the existing
+subtree, as determined by calling Widget.canUpdate. Typically implementations return a newly created constellation of widgets
+that are configured with information from this widget's constructor and
+from the given BuildContext. The given BuildContext contains information about the location in the
+tree at which this widget is being built. For example, the context
+provides the set of inherited widgets for this location in the tree. A
+given widget might be built with multiple different BuildContext
+arguments over time if the widget is moved around the tree or if the
+widget is inserted into the tree in multiple places at once. The implementation of this method must only depend on: If a widget's build method is to depend on anything else, use a
+StatefulWidget instead. See also: Converts a A list of items to choose from. The name to show when editing these settings. A callback for when a new value is selected. Is not called when the user cancels. The chosen value in the dropdown. The footer, responsible for showing vitals and logs. Creates the footer. Describes the part of the user interface represented by this widget. The framework calls this method when this widget is inserted into the tree
+in a given BuildContext and when the dependencies of this widget change
+(e.g., an InheritedWidget referenced by this widget changes). This
+method can potentially be called in every frame and should not have any side
+effects beyond building a widget. The framework replaces the subtree below this widget with the widget
+returned by this method, either by updating the existing subtree or by
+removing the subtree and inflating a new subtree, depending on whether the
+widget returned by this method can update the root of the existing
+subtree, as determined by calling Widget.canUpdate. Typically implementations return a newly created constellation of widgets
+that are configured with information from this widget's constructor and
+from the given BuildContext. The given BuildContext contains information about the location in the
+tree at which this widget is being built. For example, the context
+provides the set of inherited widgets for this location in the tree. A
+given widget might be built with multiple different BuildContext
+arguments over time if the widget is moved around the tree or if the
+widget is inserted into the tree in multiple places at once. The implementation of this method must only depend on: If a widget's build method is to depend on anything else, use a
+StatefulWidget instead. See also: Whether to show logs. Disable this when on the logs page. A widget to show the gamepad state and allow the user to switch its mode. A const constructor for this widget. Builds the UI according to the state in Returns a color representing the gamepad's battery level. Whether the gamepad should be disabled in this mode. A widget to edit a GPS coordinate in degree/minute/seconds or decimal format. Listens to model to rebuild the UI. Builds the UI according to the state in A helper class to load and manage resources used by a To use: It is safe to call load or dispose multiple times, and calling load
+will automatically call dispose on the existing resources. The codec used by image. Disposes all the resources associated with the current frame. Whether this loader has been initialized. The hash code for this object. A hash code is a single integer which represents the state of the object
+that affects operator == comparisons. All objects have hash codes.
+The default hash code implemented by If operator == is overridden to use the object state instead,
+the hash code must also be changed to represent that state,
+otherwise the object cannot be used in hash based data structures
+like the default Hash codes must be the same for objects that are equal to each other
+according to operator ==.
+The hash code of an object should only change if the object changes
+in a way that affects equality.
+There are no further requirements for the hash codes.
+They need not be consistent between executions of the same program
+and there are no distribution guarantees. Objects that are not equal are allowed to have the same hash code.
+It is even technically allowed that all instances have the same hash code,
+but if clashes happen too often,
+it may reduce the efficiency of hash-based data structures
+like If a subclass overrides hashCode, it should override the
+operator == operator as well to maintain consistency. The Whether an image is currently loading. Processes the next frame and stores the result in image. Invoked when a nonexistent method or property is accessed. A dynamic member invocation can attempt to call a member which
+doesn't exist on the receiving object. Example: This invalid code will invoke the Classes can override noSuchMethod to provide custom behavior
+for such invalid dynamic invocations. A class with a non-default noSuchMethod invocation can also
+omit implementations for members of its interface.
+Example: This code has no compile-time warnings or errors even though
+the If a value is returned from The default behavior is to throw a The equality operator. The default behavior for all Override this method to specify a different equality relation on
+a class. The overriding method must still be an equivalence relation.
+That is, it must be: Total: It must return a boolean for all arguments. It should never throw. Reflexive: For all objects Symmetric: For all objects Transitive: For all objects The method should also be consistent over time,
+so whether two objects are equal should only change
+if at least one of the objects was modified. If a subclass overrides the equality operator, it should override
+the hashCode method as well to maintain consistency. A representation of the runtime type of the object. A string representation of this object. Some classes have a default textual representation,
+often paired with a static Other classes have no meaningful textual representation
+that a program will care about.
+Such classes will typically override Displays the latest TaskbarMessage from HomeModel.message. Provides a const constructor for this widget. Builds the UI according to the state in Gets the appropriate color for the given severity. Gets the appropriate icon for the given severity. Whether to show an option to open the logs page. Displays metrics of all sorts in a collapsible list. A const constructor for this widget. Builds the UI according to the state in Drive controls for mobile devices where gamepads aren't feasible. Builds the UI according to the state in A function to create or find the model. This function will only be called once. Drive controls for mobile devices where gamepads aren't feasible. Starts sending messages to the rover. Discards any resources used by the object. After this is called, the
+object is not in a usable state and should be discarded (calls to
+addListener will throw after the object is disposed). This method should only be called by the object's owner. This method does not notify listeners, and clears the listener list once
+it is called. Consumers of this class must decide on whether to notify
+listeners or not immediately before disposal. The speed of the left wheels. The speed of the right wheels. Updates the left speed. Updates the right speed. A widget to edit a number, backed by NumberBuilder. Creates a widget to modify a number. Builds the UI according to the state in The value this number represents. Shows extra details. The amount of space to allocate to the title. How much space to allocate in between the label and text field. A widget that listens to a ChangeNotifier and rebuilds when the model updates. A const constructor. A function to create or find the model. This function will only be called once. Whether this widget should dispose the model after it's destroyed. Normally, we want the widget to clean up after itself and dispose its view model. But it's
+also common for one view model to create and depend on another model. In this case, if we
+are listening to the sub-model, we don't want to dispose it while the parent model is still
+using it. A widget that listens to a ChangeNotifier (called the view model) and updates when it does. A const constructor. Builds the UI according to the state in Creates the view model. This is only called once in the widget's lifetime. Creates the mutable state for this widget at a given location in the tree. Subclasses should override this method to return a newly created
+instance of their associated State subclass: The framework can call this method multiple times over the lifetime of
+a This function gives you an opportunity to update the view model when the widget updates. For more details, see State.didUpdateWidget. Whether this widget should dispose the model after it's destroyed. Normally, we want the widget to clean up after itself and dispose its view model. But it's
+also common for one view model to create and depend on another model. In this case, if we
+are listening to the sub-model, we don't want to dispose it while the parent model is still
+using it. A state for ReactiveWidget that manages the model. Describes the part of the user interface represented by this widget. The framework calls this method in a number of different situations. For
+example: This method can potentially be called in every frame and should not have
+any side effects beyond building a widget. The framework replaces the subtree below this widget with the widget
+returned by this method, either by updating the existing subtree or by
+removing the subtree and inflating a new subtree, depending on whether the
+widget returned by this method can update the root of the existing
+subtree, as determined by calling Widget.canUpdate. Typically implementations return a newly created constellation of widgets
+that are configured with information from this widget's constructor, the
+given BuildContext, and the internal state of this State object. The given BuildContext contains information about the location in the
+tree at which this widget is being built. For example, the context
+provides the set of inherited widgets for this location in the tree. The
+BuildContext argument is always the same as the Putting a For example, AnimatedWidget is a subclass of StatefulWidget that
+introduces an abstract Conceptually, StatelessWidget could also be implemented as a subclass of
+StatefulWidget in a similar manner. If the build method were on
+StatefulWidget rather than State, that would not be possible anymore. Putting the build function on State rather than StatefulWidget also
+helps avoid a category of bugs related to closures implicitly capturing
+ For example, suppose the parent builds In contrast, with the build function on the State object, closures
+created during build implicitly capture the State instance instead of
+the widget instance: Now when the parent rebuilds See also: Called whenever the widget configuration changes. If the parent widget rebuilds and requests that this location in the tree
+update to display a new widget with the same runtimeType and
+Widget.key, the framework will update the widget property of this
+State object to refer to the new widget and then call this method
+with the previous widget as an argument. Override this method to respond when the widget changes (e.g., to start
+implicit animations). The framework always calls build after calling didUpdateWidget, which
+means any calls to setState in didUpdateWidget are redundant. If a State's build method depends on an object that can itself
+change state, for example a ChangeNotifier or Implementations of this method should start with a call to the inherited
+method, as in See the discussion at Element.rebuild for more information on when this
+method is called. Called when this object is removed from the tree permanently. The framework calls this method when this State object will never
+build again. After the framework calls dispose, the State object is
+considered unmounted and the mounted property is false. It is an error
+to call setState at this point. This stage of the lifecycle is terminal:
+there is no way to remount a State object that has been disposed. Subclasses should override this method to release any resources retained
+by this object (e.g., stop any active animations). If a State's build method depends on an object that can itself
+change state, for example a ChangeNotifier or Implementations of this method should end with a call to the inherited
+method, as in This method is not invoked at times where a developer might otherwise
+expect it, such as application shutdown or dismissal via platform
+native methods. There is no way to predict when application shutdown will happen. For
+example, a user's battery could catch fire, or the user could drop the
+device into a swimming pool, or the operating system could unilaterally
+terminate the application process due to memory pressure. Applications are responsible for ensuring that they are well-behaved
+even in the face of a rapid unscheduled termination. To artificially cause the entire widget tree to be disposed, consider
+calling runApp with a widget such as SizedBox.shrink. To listen for platform shutdown messages (and other lifecycle changes),
+consider the AppLifecycleListener API. An application may have both Flutter and non-Flutter UI in it. If the
+application calls non-Flutter methods to remove Flutter based UI such as
+platform native API to manipulate the platform native navigation stack,
+the framework does not know if the developer intends to eagerly free
+resources or not. The widget tree remains mounted and ready to render
+as soon as it is displayed again. To release resources more eagerly, establish a platform channel
+and use it to call runApp with a widget such as SizedBox.shrink when
+the framework should dispose of the active widget tree. See also: Called when this object is inserted into the tree. The framework will call this method exactly once for each State object
+it creates. Override this method to perform initialization that depends on the
+location at which this object was inserted into the tree (i.e., context)
+or on the widget used to configure this object (i.e., widget). If a State's build method depends on an object that can itself
+change state, for example a ChangeNotifier or You should not use BuildContext.dependOnInheritedWidgetOfExactType from this
+method. However, didChangeDependencies will be called immediately
+following this method, and BuildContext.dependOnInheritedWidgetOfExactType can
+be used there. Implementations of this method should start with a call to the inherited
+method, as in Updates the UI when model updates. The model to listen to. A ReactiveWidgetInterface that "borrows" a view model and does not dispose of it. A const constructor. Creates the view model. This is only called once in the widget's lifetime. The model to borrow. Whether this widget should dispose the model after it's destroyed. Normally, we want the widget to clean up after itself and dispose its view model. But it's
+also common for one view model to create and depend on another model. In this case, if we
+are listening to the sub-model, we don't want to dispose it while the parent model is still
+using it. A widget to create and send a ScienceCommand. Builds the UI according to the state in A function to create or find the model. This function will only be called once. Allows the user to connect to the firmware directly, over Serial. See SerialModel for an implementation. Provides a const constructor. Builds the UI according to the state in Extension for COlors on Severity Fetch the color based on the severity A widget to display metrics and controls off to the side. A const constructor for this widget. Describes the part of the user interface represented by this widget. The framework calls this method when this widget is inserted into the tree
+in a given BuildContext and when the dependencies of this widget change
+(e.g., an InheritedWidget referenced by this widget changes). This
+method can potentially be called in every frame and should not have any side
+effects beyond building a widget. The framework replaces the subtree below this widget with the widget
+returned by this method, either by updating the existing subtree or by
+removing the subtree and inflating a new subtree, depending on whether the
+widget returned by this method can update the root of the existing
+subtree, as determined by calling Widget.canUpdate. Typically implementations return a newly created constellation of widgets
+that are configured with information from this widget's constructor and
+from the given BuildContext. The given BuildContext contains information about the location in the
+tree at which this widget is being built. For example, the context
+provides the set of inherited widgets for this location in the tree. A
+given widget might be built with multiple different BuildContext
+arguments over time if the widget is moved around the tree or if the
+widget is inserted into the tree in multiple places at once. The implementation of this method must only depend on: If a widget's build method is to depend on anything else, use a
+StatefulWidget instead. See also: Creates a widget to edit a SocketInfo, backed by SocketBuilder. Creates a widget to edit host and port data for a socket. Builds the UI according to the state in Whether to edit the port as well. The name of the socket being edited. A few icons displaying the rover's current status. Provides a const constructor. Describes the part of the user interface represented by this widget. The framework calls this method when this widget is inserted into the tree
+in a given BuildContext and when the dependencies of this widget change
+(e.g., an InheritedWidget referenced by this widget changes). This
+method can potentially be called in every frame and should not have any side
+effects beyond building a widget. The framework replaces the subtree below this widget with the widget
+returned by this method, either by updating the existing subtree or by
+removing the subtree and inflating a new subtree, depending on whether the
+widget returned by this method can update the root of the existing
+subtree, as determined by calling Widget.canUpdate. Typically implementations return a newly created constellation of widgets
+that are configured with information from this widget's constructor and
+from the given BuildContext. The given BuildContext contains information about the location in the
+tree at which this widget is being built. For example, the context
+provides the set of inherited widgets for this location in the tree. A
+given widget might be built with multiple different BuildContext
+arguments over time if the widget is moved around the tree or if the
+widget is inserted into the tree in multiple places at once. The implementation of this method must only depend on: If a widget's build method is to depend on anything else, use a
+StatefulWidget instead. See also: An appropriate battery icon in increments of 1/8 battery level. A color representing a meter's fill. An appropriate WiFi icon in increments of 1/5 connection strength. The color of the rover's status icon. An appropriate battery icon representing the rover's current status. An AlertDialog to prompt the user for a throttle value and send it to the rover. Builds the UI according to the state in A function to create or find the model. This function will only be called once. A widget to edit a color, backed by TimerBuilder. Builds the UI according to the state in A function to create or find the model. This function will only be called once. A widget to view timer
+Can also stop and start timer Creates a new Timer widget Builds the UI according to the state in Gets the text style for the timer. Displays frames of a video feed. Displays a video feed for the given camera. Creates the mutable state for this widget at a given location in the tree. Subclasses should override this method to return a newly created
+instance of their associated State subclass: The framework can call this method multiple times over the lifetime of
+a The feed to show in this widget. The logic for updating a VideoFeed. This widget listens to VideoModel.frameUpdater to sync its framerate with other VideoFeeds.
+On every update, this widget grabs the frame from VideoData.frame, decodes it, renders it,
+then replaces the old frame. The key is that all the image processing logic is done off-screen
+while the old frame remains on-screen. When the frame is processed, it quickly replaces the old
+frame. That way, the user sees one continuous video instead of a flickering image. Describes the part of the user interface represented by this widget. The framework calls this method in a number of different situations. For
+example: This method can potentially be called in every frame and should not have
+any side effects beyond building a widget. The framework replaces the subtree below this widget with the widget
+returned by this method, either by updating the existing subtree or by
+removing the subtree and inflating a new subtree, depending on whether the
+widget returned by this method can update the root of the existing
+subtree, as determined by calling Widget.canUpdate. Typically implementations return a newly created constellation of widgets
+that are configured with information from this widget's constructor, the
+given BuildContext, and the internal state of this State object. The given BuildContext contains information about the location in the
+tree at which this widget is being built. For example, the context
+provides the set of inherited widgets for this location in the tree. The
+BuildContext argument is always the same as the Putting a For example, AnimatedWidget is a subclass of StatefulWidget that
+introduces an abstract Conceptually, StatelessWidget could also be implemented as a subclass of
+StatefulWidget in a similar manner. If the build method were on
+StatefulWidget rather than State, that would not be possible anymore. Putting the build function on State rather than StatefulWidget also
+helps avoid a category of bugs related to closures implicitly capturing
+ For example, suppose the parent builds In contrast, with the build function on the State object, closures
+created during build implicitly capture the State instance instead of
+the widget instance: Now when the parent rebuilds See also: The data being streamed. Called when this object is removed from the tree permanently. The framework calls this method when this State object will never
+build again. After the framework calls dispose, the State object is
+considered unmounted and the mounted property is false. It is an error
+to call setState at this point. This stage of the lifecycle is terminal:
+there is no way to remount a State object that has been disposed. Subclasses should override this method to release any resources retained
+by this object (e.g., stop any active animations). If a State's build method depends on an object that can itself
+change state, for example a ChangeNotifier or Implementations of this method should end with a call to the inherited
+method, as in This method is not invoked at times where a developer might otherwise
+expect it, such as application shutdown or dismissal via platform
+native methods. There is no way to predict when application shutdown will happen. For
+example, a user's battery could catch fire, or the user could drop the
+device into a swimming pool, or the operating system could unilaterally
+terminate the application process due to memory pressure. Applications are responsible for ensuring that they are well-behaved
+even in the face of a rapid unscheduled termination. To artificially cause the entire widget tree to be disposed, consider
+calling runApp with a widget such as SizedBox.shrink. To listen for platform shutdown messages (and other lifecycle changes),
+consider the AppLifecycleListener API. An application may have both Flutter and non-Flutter UI in it. If the
+application calls non-Flutter methods to remove Flutter based UI such as
+platform native API to manipulate the platform native navigation stack,
+the framework does not know if the developer intends to eagerly free
+resources or not. The widget tree remains mounted and ready to render
+as soon as it is displayed again. To release resources more eagerly, establish a platform channel
+and use it to call runApp with a widget such as SizedBox.shrink when
+the framework should dispose of the active widget tree. See also: Displays an error message describing why A helper class responsible for managing and loading an image. Called when this object is inserted into the tree. The framework will call this method exactly once for each State object
+it creates. Override this method to perform initialization that depends on the
+location at which this object was inserted into the tree (i.e., context)
+or on the widget used to configure this object (i.e., widget). If a State's build method depends on an object that can itself
+change state, for example a ChangeNotifier or You should not use BuildContext.dependOnInheritedWidgetOfExactType from this
+method. However, didChangeDependencies will be called immediately
+following this method, and BuildContext.dependOnInheritedWidgetOfExactType can
+be used there. Implementations of this method should start with a call to the inherited
+method, as in Grabs the new frame, renders it, and replaces the old frame. A widget to show one DashboardView. Shows a DashboardView. Creates the mutable state for this widget at a given location in the tree. Subclasses should override this method to return a newly created
+instance of their associated State subclass: The framework can call this method multiple times over the lifetime of
+a The view to show. A dropdown to select more or less views. Provides a const constructor for this widget. Builds the UI according to the state in A widget to render all the views the user selected. A const constructor. Builds the UI according to the state in Contains complex or reusable widgets. If a widget is becoming too large or needs to be reused, separate it into its own file and put
+it here. Although "everything is a widget"™ in Flutter, this library is reserved for widgets
+that are contained to a small, logical section of the general UI. Groups of widgets spanning
+multiple loosely-related purposes should be considered "pages" and put in the pages library. This library is broken out into several directories: This library may depend on the data, services, and models library.
+
+
diff --git a/docs/widgets/AutonomyCommandEditor-class.html b/docs/widgets/AutonomyCommandEditor-class.html
new file mode 100644
index 0000000000..ad41b3ad7d
--- /dev/null
+++ b/docs/widgets/AutonomyCommandEditor-class.html
@@ -0,0 +1,429 @@
+
+
+
+
+
+
+
+ AutonomyCommandEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+AutonomyCommandEditor class
+
+
+
+
+
+
+ Constructors
+
+
+
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+no setterinherited
+
+no setterinherited
+
+Methods
+
+
+ model.
+ override
+
+inherited
+
+override
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+AutonomyCommandEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ AutonomyCommandEditor constructor
+
build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+ model.Implementation
+
+@override
+Widget build(BuildContext context, AutonomyCommandBuilder model) => Row(mainAxisSize: MainAxisSize.min, children: [
+ const SizedBox(width: 4),
+ Text("Autonomy: ", style: context.textTheme.titleLarge),
+ const SizedBox(width: 8),
+ ElevatedButton.icon(
+ icon: const Icon(Icons.add),
+ label: const Text("New Task"),
+ onPressed: () => createTask(context, model),
+ ),
+ const SizedBox(width: 8),
+ ElevatedButton(
+ style: ButtonStyle(backgroundColor: MaterialStateProperty.all(Colors.red)),
+ onPressed: model.abort,
+ child: const Text("ABORT"),
+ ),
+],);createModel
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ createModel method
+
+
+
+AutonomyCommandBuilder
+createModel(
+
+ override
+
+ Implementation
+
+@override
+AutonomyCommandBuilder createModel() => AutonomyCommandBuilder();createTask
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ createTask method
+
)
+
+
+
+ Implementation
+
+void createTask(BuildContext context, AutonomyCommandBuilder command) => showDialog<void>(
+ context: context,
+ builder: (_) => AlertDialog(
+ title: const Text("Create a new Task"),
+ content: Column(
+ mainAxisSize: MainAxisSize.min,
+ children: [
+ DropdownEditor<AutonomyTask>(
+ name: "Task type",
+ value: command.task,
+ items: [
+ for (final task in AutonomyTask.values)
+ if (task != AutonomyTask.AUTONOMY_TASK_UNDEFINED) task,
+ ],
+ onChanged: command.updateTask,
+ humanName: (task) => task.humanName,
+ ),
+ GpsEditor(command.gps),
+ ],
+ ),
+ actions: [
+ TextButton(child: const Text("Cancel"), onPressed: () => Navigator.of(context).pop()),
+ ElevatedButton(
+ onPressed: command.isLoading ? null : () { command.submit(); Navigator.of(context).pop(); },
+ child: const Text("Submit"),
+ ),
+ ],
+ ),
+);
+
+
+
+
+
+
+
diff --git a/docs/widgets/BuildContextUtils.html b/docs/widgets/BuildContextUtils.html
new file mode 100644
index 0000000000..e74571d8a3
--- /dev/null
+++ b/docs/widgets/BuildContextUtils.html
@@ -0,0 +1,168 @@
+
+
+
+
+
+
+
+ BuildContextUtils
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+BuildContextUtils extension
+
+
+
+
+
+
+
+
+ Properties
+
+
+ no setter
+
+no setter
+
+colorScheme
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ colorScheme property
+
Implementation
+
+ColorScheme get colorScheme => Theme.of(this).colorScheme;textTheme
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ textTheme property
+
Implementation
+
+TextTheme get textTheme => Theme.of(this).textTheme;
+
+
diff --git a/docs/widgets/CameraDetailsEditor-class.html b/docs/widgets/CameraDetailsEditor-class.html
new file mode 100644
index 0000000000..566aaea3fa
--- /dev/null
+++ b/docs/widgets/CameraDetailsEditor-class.html
@@ -0,0 +1,429 @@
+
+
+
+
+
+
+
+ CameraDetailsEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+CameraDetailsEditor class
+
+
+
+
+
+
+ Constructors
+
+
+
+ const
+ Properties
+
+
+ final
+
+no setterinherited
+
+finalinherited
+
+no setterinherited
+
+no setterinherited
+
+Methods
+
+
+ model.
+ override
+
+inherited
+
+override
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+CameraDetailsEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ CameraDetailsEditor constructor
+
)
+ Implementation
+
+const CameraDetailsEditor(this.data);build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+ model.Implementation
+
+@override
+Widget build(BuildContext context, CameraDetailsBuilder model) => AlertDialog(
+ title: const Text("Modify camera"),
+ actions: [
+ TextButton(
+ onPressed: () => Navigator.of(context).pop(),
+ child: const Text("Cancel"),
+ ),
+ ElevatedButton(
+ onPressed: !model.isValid ? null : () async {
+ final result = await model.saveSettings(data.id);
+ if (result && context.mounted) Navigator.of(context).pop();
+ },
+ child: const Text("Save"),
+ ),
+ ],
+ content: SingleChildScrollView(
+ child: Column(
+ children: [
+ Padding(
+ padding: const EdgeInsets.symmetric(horizontal: 16),
+ child: DropdownEditor<CameraStatus>(
+ name: "Status",
+ humanName: (value) => value.humanName,
+ value: model.status,
+ onChanged: model.updateStatus,
+ items: CameraDetailsBuilder.okStatuses,
+ ),
+ ),
+ NumberEditor(
+ name: "Resolution height",
+ model: model.resolutionHeight,
+ titleFlex: 2,
+ ),
+ NumberEditor(
+ name: "Resolution width",
+ model: model.resolutionWidth,
+ titleFlex: 2,
+ ),
+ NumberEditor(
+ name: "Quality (0-100)",
+ model: model.quality,
+ titleFlex: 2,
+ ),
+ NumberEditor(
+ name: "Frames per second",
+ model: model.fps,
+ titleFlex: 2,
+ ),
+ const SizedBox(height: 24),
+ if (model.isLoading) const Text("Loading..."),
+ if (model.error != null) Text(model.error!, style: const TextStyle(color: Colors.red)),
+ ],
+ ),
+ ),
+);createModel
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ createModel method
+
+
+
+CameraDetailsBuilder
+createModel(
+
+ override
+
+ Implementation
+
+@override
+CameraDetailsBuilder createModel() => CameraDetailsBuilder(data.details);data
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ data property
+
final
+
+ Implementation
+
+final VideoData data;
+
+
diff --git a/docs/widgets/ColorEditor-class.html b/docs/widgets/ColorEditor-class.html
new file mode 100644
index 0000000000..57b520e58d
--- /dev/null
+++ b/docs/widgets/ColorEditor-class.html
@@ -0,0 +1,429 @@
+
+
+
+
+
+
+
+ ColorEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ColorEditor class
+
+
+
+
+
+
+ Constructors
+
+
+
+ const
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+finalinherited
+
+no setterinherited
+
+no setterinherited
+
+Methods
+
+
+ model.
+ override
+
+inherited
+
+inherited
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+ColorEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ColorEditor constructor
+
)
+ Implementation
+
+const ColorEditor(super.model);build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+ model.Implementation
+
+@override
+Widget build(BuildContext context, ColorBuilder model) => AlertDialog(
+ title: const Text("Pick a color"),
+ actions: [
+ TextButton(child: const Text("Cancel"), onPressed: () => Navigator.of(context).pop()),
+ ElevatedButton(
+ onPressed: () async {
+ final result = await model.setColor();
+ if (result && context.mounted) Navigator.of(context).pop();
+ },
+ child: const Text("Save"),
+ ),
+ ],
+ content: Column(
+ mainAxisSize: MainAxisSize.min,
+ children: [
+ Slider(
+ value: model.slider,
+ onChanged: model.updateSlider,
+ label: "color",
+ ),
+ Container(height: 50, width: double.infinity, color: model.value),
+ if (model.isLoading) const Text("Loading..."),
+ if (model.errorText != null) Text(model.errorText!, style: const TextStyle(color: Colors.red)),
+ ],
+ ),
+);
+
+
diff --git a/docs/widgets/ControlsDisplay-class.html b/docs/widgets/ControlsDisplay-class.html
new file mode 100644
index 0000000000..d2cb42642a
--- /dev/null
+++ b/docs/widgets/ControlsDisplay-class.html
@@ -0,0 +1,441 @@
+
+
+
+
+
+
+
+ ControlsDisplay
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ControlsDisplay class
+
+
+
+
+
+
+ Constructors
+
+
+
+ const
+ Properties
+
+
+ final
+
+no setterinherited
+
+finalinherited
+
+finalinherited
+
+no setterinherited
+
+no setterinherited
+
+Methods
+
+
+ model.
+ override
+
+inherited
+
+inherited
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+ControlsDisplay
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ControlsDisplay constructor
+
})
+ Implementation
+
+const ControlsDisplay({required Controller controller, required this.gamepadNum}) : super(controller);build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+ model.Implementation
+
+@override
+Widget build(BuildContext context, Controller model) => ExpansionTile(
+ expandedCrossAxisAlignment: CrossAxisAlignment.start,
+ expandedAlignment: Alignment.centerLeft,
+ childrenPadding: const EdgeInsets.symmetric(horizontal: 16, vertical: 8),
+ title: Text(
+ model.controls.mode.name,
+ style: Theme.of(context).textTheme.titleLarge,
+ textAlign: TextAlign.start,
+ ),
+ children: [
+ for (final entry in model.controls.buttonMapping.entries) ...[
+ Text(entry.key, style: Theme.of(context).textTheme.labelLarge),
+ Text(" ${entry.value}", style: Theme.of(context).textTheme.titleMedium),
+ ],
+ ],
+);gamepadNum
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ gamepadNum property
+
final
+
+ Implementation
+
+final int gamepadNum;
+
+
diff --git a/docs/widgets/DropdownEditor-class.html b/docs/widgets/DropdownEditor-class.html
new file mode 100644
index 0000000000..1f00b3235b
--- /dev/null
+++ b/docs/widgets/DropdownEditor-class.html
@@ -0,0 +1,424 @@
+
+
+
+
+
+
+
+ DropdownEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+DropdownEditor<
+
+
+
+
+ Constructors
+
+
+
+ const
+ Properties
+
+
+ no setterinherited
+
+T item to a user-friendly string.
+ final
+
+final
+
+finalinherited
+
+final
+
+final
+
+no setterinherited
+
+final
+
+Methods
+
+
+ override
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+DropdownEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ DropdownEditor<
})
+
), Implementation
+
+const DropdownEditor({
+ required this.name,
+ required this.value,
+ required this.onChanged,
+ required this.items,
+ required this.humanName,
+});build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+
+
+context using
+BuildContext.dependOnInheritedWidgetOfExactType.
+
+Implementation
+
+@override
+Widget build(BuildContext context) => Row(
+ children: [
+ Text(name),
+ const SizedBox(width: 12),
+ DropdownButton<T>(
+ focusNode: FocusNode(),
+ value: value,
+ onChanged: (input) {
+ if (input == null) return;
+ onChanged(input);
+ },
+ items: [
+ for (final other in items) DropdownMenuItem<T>(
+ value: other,
+ child: Text(humanName(other)),
+ ),
+ ],
+ ),
+ ],
+);humanName
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ humanName property
+
final
+
+ T item to a user-friendly string.Implementation
+
+final String Function(T) humanName;items
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ items property
+
final
+
+ Implementation
+
+final List<T> items;name
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ name property
+
final
+
+ Implementation
+
+final String name;onChanged
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ onChanged property
+
final
+
+ Implementation
+
+final ValueChanged<T> onChanged;value
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ value property
+
final
+
+ Implementation
+
+final T value;
+
+
diff --git a/docs/widgets/Footer-class.html b/docs/widgets/Footer-class.html
new file mode 100644
index 0000000000..5697754efc
--- /dev/null
+++ b/docs/widgets/Footer-class.html
@@ -0,0 +1,376 @@
+
+
+
+
+
+
+
+ Footer
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Footer class
+
+
+
+
+
+
+ Constructors
+
+
+
+
+ const
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+no setterinherited
+
+final
+
+Methods
+
+
+ override
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+Footer
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Footer constructor
+
})
+ Implementation
+
+const Footer({this.showLogs = true});build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+
+
+context using
+BuildContext.dependOnInheritedWidgetOfExactType.
+
+Implementation
+
+@override
+Widget build(BuildContext context) => ColoredBox(
+ color: Theme.of(context).colorScheme.secondary,
+ child: Wrap(
+ alignment: WrapAlignment.spaceBetween,
+ children: [
+ MessageDisplay(showLogs: showLogs),
+ Wrap( // Groups these elements together even when wrapping
+ // mainAxisSize: MainAxisSize.min,
+ children: [
+ ViewsCounter(),
+ const SizedBox(width: 8),
+ // GamepadButtons(),
+ GamepadButton(models.rover.controller1),
+ const SizedBox(width: 8),
+ GamepadButton(models.rover.controller2),
+ const SizedBox(width: 8),
+ GamepadButton(models.rover.controller3),
+ SerialButton(),
+ const SizedBox(width: 4),
+ const StatusIcons(),
+ ],
+ ),
+ ],
+ ),
+);showLogs
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ showLogs property
+
final
+
+ Implementation
+
+final bool showLogs;
+
+
diff --git a/docs/widgets/GamepadButton-class.html b/docs/widgets/GamepadButton-class.html
new file mode 100644
index 0000000000..d977e8f07b
--- /dev/null
+++ b/docs/widgets/GamepadButton-class.html
@@ -0,0 +1,460 @@
+
+
+
+
+
+
+
+ GamepadButton
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+GamepadButton class
+
+
+
+
+
+
+
+
+ Constructors
+
+
+
+ const
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+finalinherited
+
+no setterinherited
+
+no setterinherited
+
+Methods
+
+
+ model.
+ override
+
+inherited
+
+inherited
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+GamepadButton
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ GamepadButton constructor
+
)
+ Implementation
+
+const GamepadButton(super.model);build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+ model.Implementation
+
+@override
+Widget build(BuildContext context, Controller model) => ValueListenableBuilder(
+ valueListenable: models.rover.status,
+ builder: (context, status, _) => Row(
+ mainAxisSize: MainAxisSize.min,
+ children: [
+ IconButton(
+ icon: Stack(
+ children: [
+ const Icon(Icons.sports_esports),
+ Positioned(
+ bottom: -2,
+ right: -2,
+ child: Text("${model.gamepadIndex + 1}", style: const TextStyle(fontSize: 12, color: Colors.white)),
+ ),
+ ],
+ ),
+ color: isDisabled(status) ? Colors.grey : model.isConnected
+ ? getColor(model.gamepad.battery)
+ : Colors.black,
+ constraints: const BoxConstraints(maxWidth: 36),
+ onPressed: model.connect,
+ ),
+ DropdownButton<OperatingMode>(
+ iconEnabledColor: Colors.black,
+ value: model.mode,
+ onChanged: isDisabled(status) ? null : model.setMode,
+ items: [
+ for (final mode in OperatingMode.values) DropdownMenuItem(
+ value: mode,
+ child: Text(mode.name),
+ ),
+ ],
+ ),
+ ],
+ ),
+ );getColor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ getColor method
+
)
+
+
+
+ Implementation
+
+Color getColor(GamepadBatteryLevel battery) {
+ switch (battery) {
+ case GamepadBatteryLevel.empty: return Colors.red;
+ case GamepadBatteryLevel.low: return Colors.red;
+ case GamepadBatteryLevel.medium: return Colors.orange;
+ case GamepadBatteryLevel.full: return Colors.green;
+ case GamepadBatteryLevel.unknown: return Colors.black;
+ }
+}isDisabled
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ isDisabled method
+
)
+
+
+
+ Implementation
+
+bool isDisabled(RoverStatus status) => status == RoverStatus.AUTONOMOUS || status == RoverStatus.IDLE;
+
+
diff --git a/docs/widgets/GpsEditor-class.html b/docs/widgets/GpsEditor-class.html
new file mode 100644
index 0000000000..304b445828
--- /dev/null
+++ b/docs/widgets/GpsEditor-class.html
@@ -0,0 +1,429 @@
+
+
+
+
+
+
+
+ GpsEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+GpsEditor class
+
+
+
+
+
+
+ Constructors
+
+
+
+ const
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+finalinherited
+
+no setterinherited
+
+no setterinherited
+
+Methods
+
+
+ model.
+ override
+
+inherited
+
+inherited
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+GpsEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ GpsEditor constructor
+
)
+ Implementation
+
+const GpsEditor(super.model);build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+ model.Implementation
+
+@override
+Widget build(BuildContext context, GpsBuilder model) => Column(
+ crossAxisAlignment: CrossAxisAlignment.start,
+ children: [
+ DropdownEditor(
+ name: "Type",
+ value: model.type,
+ onChanged: model.updateType,
+ items: GpsType.values,
+ humanName: (type) => type.humanName,
+ ),
+ const SizedBox(width: 12),
+ if (model.type == GpsType.degrees) ...[
+ const Text("Longitude:"),
+ SizedBox(width: 200, child: NumberEditor(name: "Degrees", width: 12, titleFlex: 1, model: model.longDegrees)),
+ SizedBox(width: 200, child: NumberEditor(name: "Minutes", width: 12, titleFlex: 1, model: model.longMinutes)),
+ SizedBox(width: 200, child: NumberEditor(name: "Seconds", width: 12, titleFlex: 1, model: model.longSeconds)),
+ const Text("Latitude:"),
+ SizedBox(width: 200, child: NumberEditor(name: "Degrees", width: 12, titleFlex: 1, model: model.latDegrees)),
+ SizedBox(width: 200, child: NumberEditor(name: "Minutes", width: 12, titleFlex: 1, model: model.latMinutes)),
+ SizedBox(width: 200, child: NumberEditor(name: "Seconds", width: 12, titleFlex: 1, model: model.latSeconds)),
+ ] else ...[
+ SizedBox(width: 225, child: NumberEditor(name: "Longitude", width: 0, titleFlex: 1, model: model.longDecimal)),
+ SizedBox(width: 200, child: NumberEditor(name: "Latitude", width: 0, titleFlex: 1, model: model.latDecimal)),
+ ],
+ ],
+ );
+
+
diff --git a/docs/widgets/ImageLoader-class.html b/docs/widgets/ImageLoader-class.html
new file mode 100644
index 0000000000..87f5c941a1
--- /dev/null
+++ b/docs/widgets/ImageLoader-class.html
@@ -0,0 +1,303 @@
+
+
+
+
+
+
+
+ ImageLoader
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ImageLoader class
+
+
ui.Image.
+
+Constructors
+
+
+
+ Properties
+
+
+ getter/setter pair
+
+no setterinherited
+
+no setter
+
+dart:ui instance of the current frame.
+ getter/setter pair
+
+getter/setter pair
+
+no setterinherited
+
+Methods
+
+
+ inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+ImageLoader
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ImageLoader constructor
+
codec
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ codec property
+
getter/setter pair
+
+ Implementation
+
+ui.Codec? codec;dispose
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ dispose method
+
Implementation
+
+void dispose() {
+ codec?.dispose();
+ image?.dispose();
+ image = null;
+}hasImage
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ hasImage property
+
Implementation
+
+bool get hasImage => image != null;hashCode
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ hashCode property
+
inherited
+
+ Object
+represents only the identity of the object,
+the same way as the default operator == implementation only considers objects
+equal if they are identical (see identityHashCode).Set and Map implementations.HashSet or HashMap.Implementation
+
+external int get hashCode;image
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ image property
+
getter/setter pair
+
+ dart:ui instance of the current frame.Implementation
+
+ui.Image? image;isLoading
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ isLoading property
+
getter/setter pair
+
+ Implementation
+
+bool isLoading = false;load
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ load method
+
)
+
+
+
+ Implementation
+
+Future<void> load(List<int> bytes) async {
+ isLoading = true;
+ final ulist = Uint8List.fromList(bytes.toList());
+ codec = await ui.instantiateImageCodec(ulist);
+ final frame = await codec!.getNextFrame();
+ image = frame.image;
+ isLoading = false;
+}noSuchMethod
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ noSuchMethod method
+
)
+
+ inherited
+
+
+dynamic object = 1;
+object.add(42); // Statically allowed, run-time error
+noSuchMethod method
+of the integer 1 with an Invocation representing the
+.add(42) call and arguments (which then throws).
+class MockList<T> implements List<T> {
+ noSuchMethod(Invocation invocation) {
+ log(invocation);
+ super.noSuchMethod(invocation); // Will throw.
+ }
+}
+void main() {
+ MockList().add(42);
+}
+MockList class has no concrete implementation of
+any of the List interface methods.
+Calls to List methods are forwarded to noSuchMethod,
+so this code will log an invocation similar to
+Invocation.method(#add, [42]) and then throw.noSuchMethod,
+it becomes the result of the original invocation.
+If the value is not of a type that can be returned by the original
+invocation, a type error occurs at the invocation.NoSuchMethodError.Implementation
+
+@pragma("vm:entry-point")
+@pragma("wasm:entry-point")
+external dynamic noSuchMethod(Invocation invocation);operator ==
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ operator == method
+
)
+
+ inherited
+
+ Objects is to return true if and
+only if this object and other are the same object.
+
+o, o == o must be true.o1 and o2, o1 == o2 and o2 == o1 must
+either both be true, or both be false.o1, o2, and o3, if o1 == o2 and
+o2 == o3 are true, then o1 == o3 must be true.Implementation
+
+external bool operator ==(Object other);runtimeType
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ runtimeType property
+
inherited
+
+ Implementation
+
+external Type get runtimeType;toString
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ toString method
+
inherited
+
+ parse function (like int.parse).
+These classes will provide the textual representation as
+their string representation.toString to provide
+useful information when inspecting the object,
+mainly for debugging or logging.Implementation
+
+external String toString();
+
+
diff --git a/docs/widgets/MessageDisplay-class.html b/docs/widgets/MessageDisplay-class.html
new file mode 100644
index 0000000000..d20a5e97a5
--- /dev/null
+++ b/docs/widgets/MessageDisplay-class.html
@@ -0,0 +1,466 @@
+
+
+
+
+
+
+
+ MessageDisplay
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+MessageDisplay class
+
+
+
+
+
+
+ Constructors
+
+
+
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+finalinherited
+
+no setterinherited
+
+no setterinherited
+
+final
+
+Methods
+
+
+ model.
+ override
+
+inherited
+
+inherited
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+MessageDisplay
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ MessageDisplay constructor
+
})
+ Implementation
+
+MessageDisplay({required this.showLogs}) : super(models.home);build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+ model.Implementation
+
+@override
+Widget build(BuildContext context, HomeModel model) => SizedBox(
+ height: 48,
+ child: InkWell(
+ onTap: () => Navigator.of(context).push(MaterialPageRoute<void>(builder: (context) => LogsPage())),
+ child: Card(
+ shadowColor: Colors.transparent,
+ color: getColor(model.message?.severity),
+ shape: ContinuousRectangleBorder(
+ borderRadius: BorderRadius.circular(12),
+ ),
+ child: (model.message == null && !showLogs) ? const SizedBox() : Row(
+ mainAxisSize: MainAxisSize.min,
+ children: [
+ const SizedBox(width: 4),
+ Icon(getIcon(model.message?.severity)),
+ const SizedBox(width: 4),
+ if (model.message == null) const Text("Open logs")
+ else Tooltip(
+ message: "Click to open logs",
+ child: models.settings.easterEggs.enableClippy
+ ? Row(children: [
+ Image.asset("assets/clippy.webp", width: 36, height: 36),
+ const Text(" -- "),
+ Text(model.message!.text),
+ ],)
+ : Text(model.message!.text),
+ ),
+ const SizedBox(width: 8),
+ ],
+ ),
+ ),
+ ),
+);getColor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ getColor method
+
)
+
+
+
+ Implementation
+
+Color getColor(Severity? severity) {
+ switch (severity) {
+ case null: return Colors.transparent;
+ case Severity.info: return Colors.transparent;
+ case Severity.warning: return Colors.orange;
+ case Severity.error: return Colors.red;
+ case Severity.critical: return Colors.red.shade900;
+ }
+}getIcon
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ getIcon method
+
)
+
+
+
+ Implementation
+
+IconData getIcon(Severity? severity) {
+ switch (severity) {
+ case Severity.info: return Icons.info;
+ case Severity.warning: return Icons.warning;
+ case Severity.error: return Icons.error;
+ case Severity.critical: return Icons.dangerous;
+ case null: return Icons.receipt_long;
+ }
+}showLogs
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ showLogs property
+
final
+
+ Implementation
+
+final bool showLogs;
+
+
diff --git a/docs/widgets/MetricsList-class.html b/docs/widgets/MetricsList-class.html
new file mode 100644
index 0000000000..06cb36fb4e
--- /dev/null
+++ b/docs/widgets/MetricsList-class.html
@@ -0,0 +1,429 @@
+
+
+
+
+
+
+
+ MetricsList
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+MetricsList class
+
+
+
+
+
+
+ Constructors
+
+
+
+ const
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+finalinherited
+
+no setterinherited
+
+no setterinherited
+
+Methods
+
+
+ model.
+ override
+
+inherited
+
+inherited
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+MetricsList
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ MetricsList constructor
+
Implementation
+
+const MetricsList(super.model);build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+ model.Implementation
+
+@override
+Widget build(BuildContext context, Metrics model) => ExpansionTile(
+ expandedCrossAxisAlignment: CrossAxisAlignment.start,
+ expandedAlignment: Alignment.centerLeft,
+ childrenPadding: const EdgeInsets.symmetric(horizontal: 16),
+ title: Text(
+ model.name,
+ style: Theme.of(context).textTheme.headlineSmall?.copyWith(
+ color: model.overallSeverity?.color,
+ ),
+ ),
+ children: [
+ for (final MetricLine metric in model.allMetrics) Text(
+ metric.text,
+ style: TextStyle(
+ color: metric.severity?.color,
+ ),
+ ),
+ const SizedBox(height: 4),
+ ],
+ );
+
+
diff --git a/docs/widgets/MobileControls-class.html b/docs/widgets/MobileControls-class.html
new file mode 100644
index 0000000000..51f25568a2
--- /dev/null
+++ b/docs/widgets/MobileControls-class.html
@@ -0,0 +1,416 @@
+
+
+
+
+
+
+
+ MobileControls
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+MobileControls class
+
+
+
+
+
+
+ Constructors
+
+
+
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+no setterinherited
+
+no setterinherited
+
+Methods
+
+
+ model.
+ override
+
+inherited
+
+override
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+MobileControls
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ MobileControls constructor
+
build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+ model.Implementation
+
+@override
+Widget build(BuildContext context, MobileControlsModel model) => Row(
+ children: [
+ const SizedBox(width: 24),
+ RotatedBox(
+ quarterTurns: 3,
+ child: SliderTheme(
+ data: const SliderThemeData(
+ trackHeight: 48,
+ thumbShape: RoundSliderThumbShape(enabledThumbRadius: 36),
+ ),
+ child: Slider(
+ onChanged: model.updateLeft,
+ onChangeEnd: (_) => model.updateLeft(0),
+ value: model.left,
+ min: -1,
+ label: model.left.toString(),
+ ),
+ ),
+ ),
+ const Spacer(),
+ RotatedBox(
+ quarterTurns: 3,
+ child: SliderTheme(
+ data: const SliderThemeData(
+ trackHeight: 48,
+ thumbShape: RoundSliderThumbShape(enabledThumbRadius: 36),
+ ),
+ child: Slider(
+ onChanged: model.updateRight,
+ onChangeEnd: (_) => model.updateRight(0),
+ value: model.right,
+ min: -1,
+ label: model.right.toString(),
+ ),
+ ),
+ ),
+ const SizedBox(width: 24),
+ ],
+);createModel
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ createModel method
+
+
+
+MobileControlsModel
+createModel(
+
+ override
+
+ Implementation
+
+@override
+MobileControlsModel createModel() => MobileControlsModel();
+
+
diff --git a/docs/widgets/MobileControlsModel-class.html b/docs/widgets/MobileControlsModel-class.html
new file mode 100644
index 0000000000..6c774fbbbb
--- /dev/null
+++ b/docs/widgets/MobileControlsModel-class.html
@@ -0,0 +1,358 @@
+
+
+
+
+
+
+
+ MobileControlsModel
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+MobileControlsModel class
+
+
+
+
+
+
+
+
+
+ Constructors
+
+
+
+ Properties
+
+
+ no setterinherited
+
+no setterinherited
+
+getter/setter pair
+
+getter/setter pair
+
+no setterinherited
+
+Methods
+
+
+ inherited
+
+override
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+MobileControlsModel
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ MobileControlsModel constructor
+
Implementation
+
+MobileControlsModel() {
+ _timer = Timer.periodic(const Duration(milliseconds: 10), _sendSpeeds);
+}dispose
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ dispose method
+
+
+
+void
+dispose(
+
+ override
+
+ Implementation
+
+@override
+void dispose() {
+ _timer.cancel();
+ super.dispose();
+}left
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ left property
+
getter/setter pair
+
+ Implementation
+
+double left = 0;right
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ right property
+
getter/setter pair
+
+ Implementation
+
+double right = 0;updateLeft
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ updateLeft method
+
)
+
+
+
+ Implementation
+
+void updateLeft(double value) {
+ left = value;
+ notifyListeners();
+}updateRight
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ updateRight method
+
)
+
+
+
+ Implementation
+
+void updateRight(double value) {
+ right = value;
+ notifyListeners();
+}
+
+
diff --git a/docs/widgets/NumberEditor-class.html b/docs/widgets/NumberEditor-class.html
new file mode 100644
index 0000000000..f348880377
--- /dev/null
+++ b/docs/widgets/NumberEditor-class.html
@@ -0,0 +1,477 @@
+
+
+
+
+
+
+
+ NumberEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+NumberEditor class
+
+
+
+
+
+
+ Constructors
+
+
+
+ const
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+finalinherited
+
+final
+
+no setterinherited
+
+no setterinherited
+
+final
+
+final
+
+final
+
+Methods
+
+
+ model.
+ override
+
+inherited
+
+inherited
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+NumberEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ NumberEditor constructor
+
})
+ Implementation
+
+const NumberEditor({
+ required NumberBuilder model,
+ required this.name,
+ this.subtitle,
+ this.titleFlex = 4,
+ this.width,
+}) : super(model);build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+ model.Implementation
+
+@override
+Widget build(BuildContext context, NumberBuilder model) => Row(
+ mainAxisSize: MainAxisSize.min,
+ children: [
+ Expanded(
+ flex: titleFlex,
+ child: subtitle == null ? ListTile(title: Text(name)) : ListTile(
+ title: Text(name),
+ subtitle: Text(subtitle!),
+ ),
+ ),
+ if (width == null) const Spacer()
+ else SizedBox(width: width),
+ Expanded(child: TextField(
+ onChanged: model.update,
+ decoration: InputDecoration(errorText: model.error),
+ controller: model.controller,
+ inputFormatters: [FilteringTextInputFormatter.allow(RegExp(r"\d|\.|-"))],
+ ),),
+ ],
+);name
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ name property
+
final
+
+ Implementation
+
+final String name;subtitle
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ subtitle property
+
final
+
+ Implementation
+
+final String? subtitle;titleFlex
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ titleFlex property
+
final
+
+ Implementation
+
+final int titleFlex;width
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ width property
+
final
+
+ Implementation
+
+final double? width;
+
+
diff --git a/docs/widgets/ReactiveWidget-class.html b/docs/widgets/ReactiveWidget-class.html
new file mode 100644
index 0000000000..f1ed3a8032
--- /dev/null
+++ b/docs/widgets/ReactiveWidget-class.html
@@ -0,0 +1,430 @@
+
+
+
+
+
+
+
+ ReactiveWidget
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ReactiveWidget<
+
+
+
+
+ Constructors
+
+
+
+ const
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+no setterinherited
+
+no setteroverride
+
+Methods
+
+
+ model.
+ inherited
+
+inherited
+
+override
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+ReactiveWidget
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReactiveWidget<
})
+ Implementation
+
+const ReactiveWidget({super.key});createModel
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ createModel abstract method
+
+
+
+T
+createModel(
+
+ override
+
+ Implementation
+
+@override
+T createModel();shouldDispose
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ shouldDispose property
+
+
+ bool
+ shouldDispose
+
+
+ override
+
+ Implementation
+
+@override
+bool get shouldDispose => true;
+
+
diff --git a/docs/widgets/ReactiveWidgetInterface-class.html b/docs/widgets/ReactiveWidgetInterface-class.html
new file mode 100644
index 0000000000..8beae495da
--- /dev/null
+++ b/docs/widgets/ReactiveWidgetInterface-class.html
@@ -0,0 +1,425 @@
+
+
+
+
+
+
+
+ ReactiveWidgetInterface
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ReactiveWidgetInterface<
+
+
+
+
+
+
+ Constructors
+
+
+
+ const
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+no setterinherited
+
+no setter
+
+Methods
+
+
+ model.
+
+
+inherited
+
+override
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+ReactiveWidgetInterface
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReactiveWidgetInterface<
})
+ Implementation
+
+const ReactiveWidgetInterface({super.key});build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build abstract method
+
)
+
+
+
+ model.Implementation
+
+Widget build(BuildContext context, T model);createModel
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ createModel abstract method
+
Implementation
+
+T createModel();createState
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ createState method
+
+
+
+ReactiveWidgetState<
+
+ override
+
+
+@override
+State<SomeWidget> createState() => _SomeWidgetState();
+StatefulWidget. For example, if the widget is inserted into the tree
+in multiple locations, the framework will create a separate State object
+for each location. Similarly, if the widget is removed from the tree and
+later inserted into the tree again, the framework will call createState
+again to create a fresh State object, simplifying the lifecycle of
+State objects.Implementation
+
+@override
+ReactiveWidgetState createState() => ReactiveWidgetState<T>();didUpdateWidget
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ didUpdateWidget method
+
+
+
+void
+didUpdateWidget(
+
+
)
+
+
+
+ Implementation
+
+@mustCallSuper
+void didUpdateWidget(covariant ReactiveWidgetInterface<T> oldWidget, T model) { }shouldDispose
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ shouldDispose property
+
Implementation
+
+bool get shouldDispose;
+
+
diff --git a/docs/widgets/ReactiveWidgetState-class.html b/docs/widgets/ReactiveWidgetState-class.html
new file mode 100644
index 0000000000..7517abe10e
--- /dev/null
+++ b/docs/widgets/ReactiveWidgetState-class.html
@@ -0,0 +1,464 @@
+
+
+
+
+
+
+
+ ReactiveWidgetState
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ReactiveWidgetState<
+
+
+
+
+ Constructors
+
+
+
+ Properties
+
+
+ no setterinherited
+
+no setterinherited
+
+latefinal
+
+no setterinherited
+
+no setterinherited
+
+no setterinherited
+
+Methods
+
+
+ inherited
+
+override
+
+inherited
+
+inherited
+
+inherited
+
+override
+
+override
+
+override
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+ReactiveWidgetState
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReactiveWidgetState<
build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+
+
+context property of
+this State object and will remain the same for the lifetime of this
+object. The BuildContext argument is provided redundantly here so that
+this method matches the signature for a WidgetBuilder.Design discussion
+Why is the build method on State, and not StatefulWidget?
+Widget build(BuildContext context) method on State rather
+than putting a Widget build(BuildContext context, State state) method
+on StatefulWidget gives developers more flexibility when subclassing
+StatefulWidget.Widget build(BuildContext context) method for its
+subclasses to implement. If StatefulWidget already had a build method
+that took a State argument, AnimatedWidget would be forced to provide
+its State object to subclasses even though its State object is an
+internal implementation detail of AnimatedWidget.this. If you defined a closure in a build function on a
+StatefulWidget, that closure would implicitly capture this, which is
+the current widget instance, and would have the (immutable) fields of that
+instance in scope:
+// (this is not valid Flutter code)
+class MyButton extends StatefulWidgetX {
+ MyButton({super.key, required this.color});
+
+ final Color color;
+
+ @override
+ Widget build(BuildContext context, State state) {
+ return SpecialWidget(
+ handler: () { print('color: $color'); },
+ );
+ }
+}
+MyButton with color being blue,
+the $color in the print function refers to blue, as expected. Now,
+suppose the parent rebuilds MyButton with green. The closure created by
+the first build still implicitly refers to the original widget and the
+$color still prints blue even through the widget has been updated to
+green; should that closure outlive its widget, it would print outdated
+information.
+class MyButton extends StatefulWidget {
+ const MyButton({super.key, this.color = Colors.teal});
+
+ final Color color;
+ // ...
+}
+
+class MyButtonState extends State<MyButton> {
+ // ...
+ @override
+ Widget build(BuildContext context) {
+ return SpecialWidget(
+ handler: () { print('color: ${widget.color}'); },
+ );
+ }
+}
+MyButton with green, the closure created by
+the first build still refers to State object, which is preserved across
+rebuilds, but the framework has updated that State object's widget
+property to refer to the new MyButton instance and ${widget.color}
+prints green, as expected.
+
+Implementation
+
+@override
+Widget build(BuildContext context) => widget.build(context, model);didUpdateWidget
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ didUpdateWidget method
+
+
+
+void
+didUpdateWidget(
+
+
)
+
+ override
+
+ Stream, or some
+other object to which one can subscribe to receive notifications, then
+be sure to subscribe and unsubscribe properly in initState,
+didUpdateWidget, and dispose:
+
+super.didUpdateWidget(oldWidget).Implementation
+
+@override
+void didUpdateWidget(covariant ReactiveWidgetInterface<T> oldWidget) {
+ widget.didUpdateWidget(oldWidget, model);
+ super.didUpdateWidget(oldWidget);
+}dispose
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ dispose method
+
+
+
+void
+dispose(
+
+ override
+
+ Stream, or some
+other object to which one can subscribe to receive notifications, then
+be sure to subscribe and unsubscribe properly in initState,
+didUpdateWidget, and dispose:
+
+super.dispose().Caveats
+Application shutdown
+Dismissing Flutter UI via platform native methods
+
+
+Implementation
+
+@override
+void dispose() {
+ model.removeListener(listener);
+ if (widget.shouldDispose) model.dispose();
+ super.dispose();
+}initState
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ initState method
+
+
+
+void
+initState(
+
+ override
+
+ Stream, or some
+other object to which one can subscribe to receive notifications, then
+be sure to subscribe and unsubscribe properly in initState,
+didUpdateWidget, and dispose:
+
+super.initState().Implementation
+
+@override
+void initState() {
+ super.initState();
+ model = widget.createModel();
+ model.addListener(listener);
+}listener
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ listener method
+
Implementation
+
+void listener() => setState(() {});model
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ model property
+
latefinal
+
+ Implementation
+
+late final T model;
+
+
diff --git a/docs/widgets/ReusableReactiveWidget-class.html b/docs/widgets/ReusableReactiveWidget-class.html
new file mode 100644
index 0000000000..098486e597
--- /dev/null
+++ b/docs/widgets/ReusableReactiveWidget-class.html
@@ -0,0 +1,449 @@
+
+
+
+
+
+
+
+ ReusableReactiveWidget
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ReusableReactiveWidget<
+
+
+
+
+ Constructors
+
+
+
+ const
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+final
+
+no setterinherited
+
+no setteroverride
+
+Methods
+
+
+ model.
+ inherited
+
+inherited
+
+override
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+ReusableReactiveWidget
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReusableReactiveWidget<
)
+ Implementation
+
+const ReusableReactiveWidget(this.model);createModel
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ createModel method
+
+
+
+T
+createModel(
+
+ override
+
+ Implementation
+
+@override
+T createModel() => model;model
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ model property
+
final
+
+ Implementation
+
+final T model;shouldDispose
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ shouldDispose property
+
+
+ bool
+ shouldDispose
+
+
+ override
+
+ Implementation
+
+@override
+bool get shouldDispose => false;
+
+
diff --git a/docs/widgets/ScienceCommandEditor-class.html b/docs/widgets/ScienceCommandEditor-class.html
new file mode 100644
index 0000000000..f47edecf3c
--- /dev/null
+++ b/docs/widgets/ScienceCommandEditor-class.html
@@ -0,0 +1,416 @@
+
+
+
+
+
+
+
+ ScienceCommandEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ScienceCommandEditor class
+
+
+
+
+
+
+ Constructors
+
+
+
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+no setterinherited
+
+no setterinherited
+
+Methods
+
+
+ model.
+ override
+
+inherited
+
+override
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+ScienceCommandEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ScienceCommandEditor constructor
+
build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+ model.Implementation
+
+@override
+Widget build(BuildContext context, ScienceCommandBuilder model) => Container(
+ color: context.colorScheme.surface,
+ height: 48,
+ child: Row(
+ mainAxisSize: MainAxisSize.min,
+ children: [
+ const SizedBox(width: 8),
+ Text("Status", style: context.textTheme.titleLarge),
+ const SizedBox(width: 12),
+ Text("Sample: ${models.rover.metrics.science.data.sample}", style: context.textTheme.titleMedium),
+ const SizedBox(width: 12),
+ Text("State: ${models.rover.metrics.science.data.state.humanName}", style: context.textTheme.titleMedium),
+ const Spacer(),
+ Text("Command", style: context.textTheme.titleLarge),
+ SizedBox(width: 125, child: NumberEditor(width: 4, name: "Sample: ", model: model.sample)),
+ SizedBox(child: DropdownEditor(
+ name: "State: ",
+ value: model.state,
+ onChanged: model.updateState,
+ items: const [ScienceState.STOP_COLLECTING, ScienceState.COLLECT_DATA],
+ humanName: (state) => state.humanName,
+ ),),
+ const SizedBox(width: 12),
+ ElevatedButton(
+ onPressed: model.isValid ? model.send : null,
+ child: const Text("Send"),
+ ),
+ const SizedBox(width: 12),
+ ],
+ ),
+);createModel
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ createModel method
+
+
+
+ScienceCommandBuilder
+createModel(
+
+ override
+
+ Implementation
+
+@override
+ScienceCommandBuilder createModel() => ScienceCommandBuilder();
+
+
diff --git a/docs/widgets/SerialButton-class.html b/docs/widgets/SerialButton-class.html
new file mode 100644
index 0000000000..83150c1c2d
--- /dev/null
+++ b/docs/widgets/SerialButton-class.html
@@ -0,0 +1,429 @@
+
+
+
+
+
+
+
+ SerialButton
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+SerialButton class
+
+
+
+
+
+
+ Constructors
+
+
+
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+finalinherited
+
+no setterinherited
+
+no setterinherited
+
+Methods
+
+
+ model.
+ override
+
+inherited
+
+inherited
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+SerialButton
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ SerialButton constructor
+
Implementation
+
+SerialButton() : super(models.serial);build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+ model.Implementation
+
+@override
+Widget build(BuildContext context, SerialModel model) => PopupMenuButton(
+ icon: Icon(
+ Icons.usb,
+ color: model.hasDevice ? Colors.green : context.colorScheme.onSecondary,
+ ),
+ tooltip: "Select device",
+ onSelected: model.toggle,
+ itemBuilder: (_) => [
+ for (final String port in SerialDevice.availablePorts) PopupMenuItem(
+ value: port,
+ child: ListTile(
+ title: Text(port),
+ leading: model.isConnected(port) ? const Icon(Icons.check) : null,
+ ),
+ ),
+ ],
+);
+
+
+
+
+
+
+
diff --git a/docs/widgets/SeverityUtil.html b/docs/widgets/SeverityUtil.html
new file mode 100644
index 0000000000..18c69cf5ff
--- /dev/null
+++ b/docs/widgets/SeverityUtil.html
@@ -0,0 +1,156 @@
+
+
+
+
+
+
+
+ SeverityUtil
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+SeverityUtil extension
+
+
+
+
+
+
+
+
+ Properties
+
+ color
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ color property
+
Implementation
+
+Color? get color => switch (this) {
+ Severity.info => Colors.blueGrey,
+ Severity.warning => Colors.orange,
+ Severity.error => Colors.red,
+ Severity.critical => Colors.red.shade900,
+};
+
+
diff --git a/docs/widgets/Sidebar-class.html b/docs/widgets/Sidebar-class.html
new file mode 100644
index 0000000000..b5173c3cc6
--- /dev/null
+++ b/docs/widgets/Sidebar-class.html
@@ -0,0 +1,364 @@
+
+
+
+
+
+
+
+ Sidebar
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Sidebar class
+
+
+
+
+
+
+ Constructors
+
+
+
+ const
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+no setterinherited
+
+Methods
+
+
+ override
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+Sidebar
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Sidebar constructor
+
Implementation
+
+const Sidebar();build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+
+
+context using
+BuildContext.dependOnInheritedWidgetOfExactType.
+
+Implementation
+
+@override
+Widget build(BuildContext context) => Container(
+ width: 250,
+ color: Theme.of(context).colorScheme.surfaceVariant,
+ child: ListView(
+ padding: const EdgeInsets.symmetric(horizontal: 4),
+ children: [
+ Text("Metrics", style: context.textTheme.displaySmall, textAlign: TextAlign.center),
+ for (final metrics in models.rover.metrics.allMetrics)
+ MetricsList(metrics),
+ const Divider(),
+ Text("Controls", style: context.textTheme.displaySmall, textAlign: TextAlign.center),
+ const SizedBox(height: 4),
+ ControlsDisplay(controller: models.rover.controller1, gamepadNum: 1),
+ ControlsDisplay(controller: models.rover.controller2, gamepadNum: 2),
+ ControlsDisplay(controller: models.rover.controller3, gamepadNum: 3),
+ ],
+ ),
+);
+
+
diff --git a/docs/widgets/SocketEditor-class.html b/docs/widgets/SocketEditor-class.html
new file mode 100644
index 0000000000..6e05f0398b
--- /dev/null
+++ b/docs/widgets/SocketEditor-class.html
@@ -0,0 +1,453 @@
+
+
+
+
+
+
+
+ SocketEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+SocketEditor class
+
+
+
+
+
+
+ Constructors
+
+
+
+ const
+ Properties
+
+
+ final
+
+no setterinherited
+
+finalinherited
+
+finalinherited
+
+final
+
+no setterinherited
+
+no setterinherited
+
+Methods
+
+
+ model.
+ override
+
+inherited
+
+inherited
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+SocketEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ SocketEditor constructor
+
})
+ Implementation
+
+const SocketEditor({
+ required this.name,
+ required SocketBuilder model,
+ this.editPort = true,
+}) : super(model);build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+ model.Implementation
+
+@override
+Widget build(BuildContext context, SocketBuilder model) => Row(
+ children: [
+ const SizedBox(width: 16),
+ Expanded(flex: 5, child: Text(name)),
+ const Spacer(),
+ Expanded(child: TextField(
+ onChanged: model.address.update,
+ controller: model.address.controller,
+ decoration: InputDecoration(errorText: model.address.error),
+ inputFormatters: [FilteringTextInputFormatter.allow(RegExp(r"\d|\."))],
+ ),),
+ const SizedBox(width: 12),
+ if (editPort) ...[
+ Expanded(child: TextField(
+ onChanged: model.port.update,
+ controller: model.port.controller,
+ decoration: InputDecoration(errorText: model.port.error),
+ inputFormatters: [FilteringTextInputFormatter.allow(RegExp(r"\d"))],
+ ),),
+ ] else const Spacer(),
+ ],
+);editPort
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ editPort property
+
final
+
+ Implementation
+
+final bool editPort;name
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ name property
+
final
+
+ Implementation
+
+final String name;
+
+
diff --git a/docs/widgets/StatusIcons-class.html b/docs/widgets/StatusIcons-class.html
new file mode 100644
index 0000000000..d142b5bd83
--- /dev/null
+++ b/docs/widgets/StatusIcons-class.html
@@ -0,0 +1,429 @@
+
+
+
+
+
+
+
+ StatusIcons
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+StatusIcons class
+
+
+
+
+
+
+ Constructors
+
+
+
+ const
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+no setterinherited
+
+Methods
+
+
+ override
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+StatusIcons
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StatusIcons constructor
+
Implementation
+
+const StatusIcons();build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+
+
+context using
+BuildContext.dependOnInheritedWidgetOfExactType.
+
+Implementation
+
+@override
+Widget build(BuildContext context) => Row(
+ mainAxisSize: MainAxisSize.min,
+ children: [
+ AnimatedBuilder( // battery level
+ animation: Listenable.merge([models.rover.metrics.drive, models.rover.status]),
+ builder: (context, _) => Tooltip(
+ message: "Battery: ${models.rover.metrics.drive.batteryVoltage.toStringAsFixed(2)} "
+ "(${(models.rover.metrics.drive.batteryPercentage * 100).toStringAsFixed(0)}%)",
+ child: Icon(
+ models.rover.isConnected
+ ? getBatteryIcon(models.rover.metrics.drive.batteryPercentage)
+ : Icons.battery_unknown,
+ color: models.rover.isConnected
+ ? getColor(models.rover.metrics.drive.batteryPercentage)
+ : Colors.black,
+ ),
+ ),
+ ),
+ ValueListenableBuilder<double>( // network strength
+ valueListenable: models.sockets.data.connectionStrength,
+ builder: (context, value, child) => IconButton(
+ tooltip: "${models.sockets.connectionSummary}\nClick to reset",
+ icon: Icon(
+ value > 0 ? getNetworkIcon(value) : Icons.signal_wifi_off_outlined,
+ color: getColor(value),
+ ),
+ onPressed: () async {
+ await models.sockets.reset();
+ models.home.setMessage(severity: Severity.info, text: "Network reset");
+ },
+ ),
+ ),
+ ValueListenableBuilder<RoverStatus>( // status
+ valueListenable: models.rover.status,
+ builder: (context, value, child) => PopupMenuButton(
+ tooltip: "Change mode",
+ onSelected: (value) async {
+ if (value == RoverStatus.POWER_OFF) {
+ await showDialog<void>(
+ context: context,
+ builder: (ctx) => AlertDialog(
+ title: const Text("Are you sure?"),
+ content: const Text("This will turn off the rover and you must physically turn it back on again"),
+ actions: [
+ TextButton(child: const Text("Cancel"), onPressed: () => Navigator.of(context).pop()),
+ ElevatedButton(
+ onPressed: () { models.rover.settings.setStatus(value); Navigator.of(context).pop(); },
+ child: const Text("Continue"),
+ ),
+ ],
+ ),
+ );
+ } else {
+ await models.rover.settings.setStatus(value);
+ }
+ },
+ icon: Icon(
+ getStatusIcon(value),
+ color: getStatusColor(value),
+ ),
+ itemBuilder: (_) => [
+ for (final value in RoverStatus.values)
+ if (value != RoverStatus.DISCONNECTED) // can't select this!
+ PopupMenuItem(value: value, child: Text(value.humanName)),
+ ],
+ ),
+ ),
+ const SizedBox(width: 4),
+ ],
+);getBatteryIcon
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ getBatteryIcon method
+
)
+
+
+
+ Implementation
+
+IconData getBatteryIcon(double percentage) {
+ if (percentage >= 0.84) { return Icons.battery_full; } // 80-100
+ else if (percentage >= 0.72) { return Icons.battery_6_bar; } // 60-80
+ else if (percentage >= 0.60) { return Icons.battery_5_bar; } // 60-80
+ else if (percentage >= 0.48) { return Icons.battery_4_bar; } // 60-80
+ else if (percentage >= 0.36) { return Icons.battery_3_bar; } // 60-80
+ else if (percentage >= 0.24) { return Icons.battery_2_bar; } // 40-60
+ else if (percentage >= 0.12) { return Icons.battery_1_bar; } // 20-40
+ else { return Icons.battery_0_bar; } // 0-20
+}getColor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ getColor method
+
)
+
+
+
+ Implementation
+
+Color getColor(double percentage) {
+ if (percentage > 0.45) { return Colors.green; }
+ else if (percentage > 0.2) { return Colors.orange; }
+ else if (percentage > 0.0) { return Colors.red; }
+ else { return Colors.black; }
+}getNetworkIcon
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ getNetworkIcon method
+
)
+
+
+
+ Implementation
+
+IconData getNetworkIcon(double percentage) {
+ if (percentage >= 0.8) { return Icons.signal_wifi_statusbar_4_bar; }
+ else if (percentage >= 0.6) { return Icons.network_wifi_3_bar; }
+ else if (percentage >= 0.4) { return Icons.network_wifi_2_bar; }
+ else if (percentage >= 0.2) { return Icons.network_wifi_1_bar; }
+ else { return Icons.signal_wifi_0_bar; }
+}getStatusColor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ getStatusColor method
+
)
+
+
+
+ Implementation
+
+Color getStatusColor(RoverStatus status) {
+ switch(status) {
+ case RoverStatus.DISCONNECTED: return Colors.black;
+ case RoverStatus.IDLE: return Colors.yellow;
+ case RoverStatus.MANUAL: return Colors.green;
+ case RoverStatus.AUTONOMOUS: return Colors.blueGrey;
+ case RoverStatus.POWER_OFF: return Colors.red;
+ case RoverStatus.RESTART: return Colors.yellow;
+ }
+ throw ArgumentError("Unrecognized rover status: $status");
+}getStatusIcon
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ getStatusIcon method
+
)
+
+
+
+ Implementation
+
+IconData getStatusIcon(RoverStatus status) {
+ switch (status) {
+ case RoverStatus.DISCONNECTED: return Icons.power_off;
+ case RoverStatus.POWER_OFF: return Icons.power_off;
+ case RoverStatus.IDLE: return Icons.pause_circle;
+ case RoverStatus.MANUAL: return Icons.play_circle;
+ case RoverStatus.AUTONOMOUS: return Icons.smart_toy;
+ case RoverStatus.RESTART: return Icons.restart_alt;
+ }
+ throw ArgumentError("Unrecognized rover status: $status");
+}
+
+
diff --git a/docs/widgets/ThrottleEditor-class.html b/docs/widgets/ThrottleEditor-class.html
new file mode 100644
index 0000000000..eddefbf895
--- /dev/null
+++ b/docs/widgets/ThrottleEditor-class.html
@@ -0,0 +1,416 @@
+
+
+
+
+
+
+
+ ThrottleEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ThrottleEditor class
+
+
+
+
+
+
+ Constructors
+
+
+
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+no setterinherited
+
+no setterinherited
+
+Methods
+
+
+ model.
+ override
+
+inherited
+
+override
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+ThrottleEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ThrottleEditor constructor
+
build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+ model.Implementation
+
+@override
+Widget build(BuildContext context, ThrottleBuilder model) => AlertDialog(
+ title: const Text("Adjust throttle"),
+ content: Column(
+ crossAxisAlignment: CrossAxisAlignment.start,
+ mainAxisSize: MainAxisSize.min,
+ children: [
+ NumberEditor(name: "Throttle", model: model.controller),
+ const SizedBox(height: 12),
+ if (model.errorText != null) Text(
+ model.errorText!,
+ style: const TextStyle(color: Colors.red),
+ ),
+ ],
+ ),
+ actions: [
+ ElevatedButton(
+ onPressed: !model.isValid || model.isLoading ? null : () async {
+ await model.save();
+ if (!context.mounted) return;
+ Navigator.of(context).pop();
+ },
+ child: const Text("Save"),
+ ),
+ TextButton(
+ onPressed: () => Navigator.of(context).pop(),
+ child: const Text("Cancel"),
+ ),
+ ],
+);createModel
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ createModel method
+
+
+
+ThrottleBuilder
+createModel(
+
+ override
+
+ Implementation
+
+@override
+ThrottleBuilder createModel() => ThrottleBuilder();
+
+
diff --git a/docs/widgets/TimerEditor-class.html b/docs/widgets/TimerEditor-class.html
new file mode 100644
index 0000000000..e8930888c5
--- /dev/null
+++ b/docs/widgets/TimerEditor-class.html
@@ -0,0 +1,416 @@
+
+
+
+
+
+
+
+ TimerEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+TimerEditor class
+
+
+
+
+
+
+ Constructors
+
+
+
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+no setterinherited
+
+no setterinherited
+
+Methods
+
+
+ model.
+ override
+
+inherited
+
+override
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+TimerEditor
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ TimerEditor constructor
+
build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+ model.Implementation
+
+@override
+Widget build(BuildContext context, TimerBuilder model) => AlertDialog(
+ title: const Text("Start a timer"),
+ content: Column(
+ mainAxisSize: MainAxisSize.min,
+ children: [
+ SizedBox(
+ height: 50,
+ width: double.infinity,
+ child: TextField(
+ controller: model.nameController,
+ onChanged: model.update,
+ decoration: const InputDecoration(hintText: "Timer Name"),
+ ),
+ ),
+ SizedBox(
+ height: 50,
+ width: double.infinity,
+ child: TextField(
+ onChanged: model.duration.update,
+ decoration: const InputDecoration(hintText: "Number of Minutes"),
+ inputFormatters: [FilteringTextInputFormatter.allow(RegExp(r"\d"))],
+ ),
+ ),
+ ],
+ ),
+ actions: [
+ TextButton(child: const Text("Cancel"), onPressed: () => Navigator.of(context).pop()),
+ ElevatedButton(
+ onPressed: model.isValid ? () { model.start(); Navigator.of(context).pop(); } : null,
+ child: const Text("Save"),
+ ),
+ ],
+);createModel
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ createModel method
+
+
+
+TimerBuilder
+createModel(
+
+ override
+
+ Implementation
+
+@override
+TimerBuilder createModel() => TimerBuilder();
+
+
diff --git a/docs/widgets/TimerWidget-class.html b/docs/widgets/TimerWidget-class.html
new file mode 100644
index 0000000000..0ddb71a527
--- /dev/null
+++ b/docs/widgets/TimerWidget-class.html
@@ -0,0 +1,442 @@
+
+
+
+
+
+
+
+ TimerWidget
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+TimerWidget class
+
+
+
+
+
+
+ Constructors
+
+
+
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+finalinherited
+
+no setterinherited
+
+no setterinherited
+
+Methods
+
+
+ model.
+ override
+
+inherited
+
+inherited
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+TimerWidget
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ TimerWidget constructor
+
Implementation
+
+TimerWidget() : super(models.home.mission);build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+ model.Implementation
+
+@override
+Widget build(BuildContext context, MissionTimer model) => model.title == null
+ ? Container()
+ : Row(
+ mainAxisAlignment: MainAxisAlignment.center,
+ children: [
+ Text("${model.title}: ",
+ style: context.textTheme.headlineSmall!.copyWith(color: context.colorScheme.onPrimary),
+ ),
+ const SizedBox(width: 4),
+ AnimatedScale(
+ scale: (model.underMin) && (model.timeLeft.inSeconds.isEven) ? 1.2 : 1,
+ duration: const Duration(milliseconds: 750),
+ child: Text(
+ model.timeLeft.toString().split(".").first.padLeft(8, "0"),
+ style: getStyle(context, model),
+ ),
+ ),
+ const SizedBox(width: 8),
+ ElevatedButton(
+ onPressed: model.isPaused ? model.resume : model.pause,
+ child: model.isPaused ? const Text("Resume") : const Text("Pause"),
+ ),
+ const SizedBox(width: 8),
+ ElevatedButton(
+ onPressed: model.cancel,
+ child: const Text("Cancel"),
+ ),
+ ],
+ );getStyle
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ getStyle method
+
)
+
+
+
+ Implementation
+
+TextStyle getStyle(BuildContext context, MissionTimer model) => model.underMin
+ ? context.textTheme.headlineSmall!.copyWith(
+ color: context.colorScheme.error,
+ fontWeight: FontWeight.bold,
+ )
+ : context.textTheme.headlineSmall!.copyWith(color: context.colorScheme.onPrimary);
+
+
diff --git a/docs/widgets/VideoFeed-class.html b/docs/widgets/VideoFeed-class.html
new file mode 100644
index 0000000000..f8fcc63540
--- /dev/null
+++ b/docs/widgets/VideoFeed-class.html
@@ -0,0 +1,376 @@
+
+
+
+
+
+
+
+ VideoFeed
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+VideoFeed class
+
+
+
+
+
+
+ Constructors
+
+
+
+ const
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+final
+
+no setterinherited
+
+Methods
+
+
+ inherited
+
+override
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+VideoFeed
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ VideoFeed constructor
+
})
+ Implementation
+
+const VideoFeed({required this.name});createState
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ createState method
+
+
+
+VideoFeedState
+createState(
+
+ override
+
+
+@override
+State<SomeWidget> createState() => _SomeWidgetState();
+StatefulWidget. For example, if the widget is inserted into the tree
+in multiple locations, the framework will create a separate State object
+for each location. Similarly, if the widget is removed from the tree and
+later inserted into the tree again, the framework will call createState
+again to create a fresh State object, simplifying the lifecycle of
+State objects.Implementation
+
+@override
+VideoFeedState createState() => VideoFeedState();name
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ name property
+
final
+
+ Implementation
+
+final CameraName name;
+
+
diff --git a/docs/widgets/VideoFeedState-class.html b/docs/widgets/VideoFeedState-class.html
new file mode 100644
index 0000000000..670d2e41b9
--- /dev/null
+++ b/docs/widgets/VideoFeedState-class.html
@@ -0,0 +1,493 @@
+
+
+
+
+
+
+
+ VideoFeedState
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+VideoFeedState class
+
+
Constructors
+
+
+
+ Properties
+
+
+ no setterinherited
+
+getter/setter pair
+
+image == null.
+ no setter
+
+no setterinherited
+
+final
+
+no setterinherited
+
+no setterinherited
+
+no setterinherited
+
+Methods
+
+
+ inherited
+
+override
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+override
+
+override
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+VideoFeedState
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ VideoFeedState constructor
+
build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+
+
+context property of
+this State object and will remain the same for the lifetime of this
+object. The BuildContext argument is provided redundantly here so that
+this method matches the signature for a WidgetBuilder.Design discussion
+Why is the build method on State, and not StatefulWidget?
+Widget build(BuildContext context) method on State rather
+than putting a Widget build(BuildContext context, State state) method
+on StatefulWidget gives developers more flexibility when subclassing
+StatefulWidget.Widget build(BuildContext context) method for its
+subclasses to implement. If StatefulWidget already had a build method
+that took a State argument, AnimatedWidget would be forced to provide
+its State object to subclasses even though its State object is an
+internal implementation detail of AnimatedWidget.this. If you defined a closure in a build function on a
+StatefulWidget, that closure would implicitly capture this, which is
+the current widget instance, and would have the (immutable) fields of that
+instance in scope:
+// (this is not valid Flutter code)
+class MyButton extends StatefulWidgetX {
+ MyButton({super.key, required this.color});
+
+ final Color color;
+
+ @override
+ Widget build(BuildContext context, State state) {
+ return SpecialWidget(
+ handler: () { print('color: $color'); },
+ );
+ }
+}
+MyButton with color being blue,
+the $color in the print function refers to blue, as expected. Now,
+suppose the parent rebuilds MyButton with green. The closure created by
+the first build still implicitly refers to the original widget and the
+$color still prints blue even through the widget has been updated to
+green; should that closure outlive its widget, it would print outdated
+information.
+class MyButton extends StatefulWidget {
+ const MyButton({super.key, this.color = Colors.teal});
+
+ final Color color;
+ // ...
+}
+
+class MyButtonState extends State<MyButton> {
+ // ...
+ @override
+ Widget build(BuildContext context) {
+ return SpecialWidget(
+ handler: () { print('color: ${widget.color}'); },
+ );
+ }
+}
+MyButton with green, the closure created by
+the first build still refers to State object, which is preserved across
+rebuilds, but the framework has updated that State object's widget
+property to refer to the new MyButton instance and ${widget.color}
+prints green, as expected.
+
+Implementation
+
+@override
+Widget build(BuildContext context) => Stack(
+ children: [
+ Container(
+ color: context.colorScheme.brightness == Brightness.light
+ ? Colors.blueGrey
+ : Colors.blueGrey[700],
+ height: double.infinity,
+ width: double.infinity,
+ padding: const EdgeInsets.all(4),
+ alignment: Alignment.center,
+ child: models.sockets.video.isConnected && imageLoader.hasImage && data.details.status == CameraStatus.CAMERA_ENABLED
+ ? Row(children: [
+ Expanded(child: RawImage(image: imageLoader.image, fit: BoxFit.contain)),
+ ],)
+ : Text(errorMessage, textAlign: TextAlign.center),
+ ),
+ Row(
+ mainAxisAlignment: MainAxisAlignment.end,
+ children: [
+ Text("${models.video.networkFps[data.details.name]!} FPS"),
+ if (data.hasFrame()) IconButton(
+ icon: const Icon(Icons.add_a_photo),
+ onPressed: () => models.video.saveFrame(widget.name),
+ ),
+ IconButton(
+ icon: const Icon(Icons.settings),
+ onPressed: () async => showDialog(
+ context: context,
+ builder: (_) => CameraDetailsEditor(data),
+ ),
+ ),
+ ViewsSelector(currentView: widget.name.humanName),
+ ],
+ ),
+ Positioned(left: 5, bottom: 5, child: Text(data.details.name.humanName)),
+ ],
+);data
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ data property
+
getter/setter pair
+
+ Implementation
+
+late VideoData data;dispose
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ dispose method
+
+
+
+void
+dispose(
+
+ override
+
+ Stream, or some
+other object to which one can subscribe to receive notifications, then
+be sure to subscribe and unsubscribe properly in initState,
+didUpdateWidget, and dispose:
+
+super.dispose().Caveats
+Application shutdown
+Dismissing Flutter UI via platform native methods
+
+
+Implementation
+
+@override
+void dispose() {
+ models.video.removeListener(updateImage);
+ imageLoader.dispose();
+ super.dispose();
+}errorMessage
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ errorMessage property
+
image == null.Implementation
+
+String get errorMessage {
+ if (!models.sockets.video.isConnected) return "The video program is not connected";
+ switch (data.details.status) {
+ case CameraStatus.CAMERA_LOADING: return "Camera is loading...";
+ case CameraStatus.CAMERA_STATUS_UNDEFINED: return "Unknown error";
+ case CameraStatus.CAMERA_DISCONNECTED: return "Camera is not connected";
+ case CameraStatus.CAMERA_DISABLED: return "Camera is disabled.\nClick the settings icon to enabled it.";
+ case CameraStatus.CAMERA_NOT_RESPONDING: return "Camera is not responding";
+ case CameraStatus.FRAME_TOO_LARGE: return "Camera is reading too much detail\nReduce the quality or resolution";
+ case CameraStatus.CAMERA_HAS_NO_NAME: return "Camera has no name\nChange lib/constants.py on the video Pi";
+ case CameraStatus.CAMERA_ENABLED:
+ if (data.hasFrame()) { return "Loading feed..."; }
+ else { return "Starting camera..."; }
+ }
+ return "Unknown error";
+}imageLoader
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ imageLoader property
+
final
+
+ Implementation
+
+final imageLoader = ImageLoader();initState
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ initState method
+
+
+
+void
+initState(
+
+ override
+
+ Stream, or some
+other object to which one can subscribe to receive notifications, then
+be sure to subscribe and unsubscribe properly in initState,
+didUpdateWidget, and dispose:
+
+super.initState().Implementation
+
+@override
+void initState() {
+ super.initState();
+ data = models.video.feeds[widget.name]!;
+ models.video.addListener(updateImage);
+}updateImage
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ updateImage method
+
Implementation
+
+Future<void> updateImage() async {
+ data = models.video.feeds[widget.name]!;
+ if (data.details.status != CameraStatus.CAMERA_ENABLED) {
+ setState(() => imageLoader.image = null);
+ }
+ setState(() { });
+ if (!data.hasFrame() || imageLoader.isLoading) return;
+ await imageLoader.load(data.frame);
+ if (mounted) setState(() { });
+}
+
+
diff --git a/docs/widgets/ViewWidget-class.html b/docs/widgets/ViewWidget-class.html
new file mode 100644
index 0000000000..f68dd99bfd
--- /dev/null
+++ b/docs/widgets/ViewWidget-class.html
@@ -0,0 +1,375 @@
+
+
+
+
+
+
+
+ ViewWidget
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ViewWidget class
+
+
+
+
+
+
+ Constructors
+
+
+
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+no setterinherited
+
+final
+
+Methods
+
+
+ inherited
+
+override
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+ViewWidget
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ViewWidget constructor
+
)
+ Implementation
+
+ViewWidget(this.view) : super(key: view.flutterKey);createState
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ createState method
+
+
+
+State<
+
+ override
+
+
+@override
+State<SomeWidget> createState() => _SomeWidgetState();
+StatefulWidget. For example, if the widget is inserted into the tree
+in multiple locations, the framework will create a separate State object
+for each location. Similarly, if the widget is removed from the tree and
+later inserted into the tree again, the framework will call createState
+again to create a fresh State object, simplifying the lifecycle of
+State objects.Implementation
+
+@override
+State<ViewWidget> createState() => _ViewWidgetState();view
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ view property
+
final
+
+ Implementation
+
+final DashboardView view;
+
+
diff --git a/docs/widgets/ViewsCounter-class.html b/docs/widgets/ViewsCounter-class.html
new file mode 100644
index 0000000000..eb685b0067
--- /dev/null
+++ b/docs/widgets/ViewsCounter-class.html
@@ -0,0 +1,428 @@
+
+
+
+
+
+
+
+ ViewsCounter
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ViewsCounter class
+
+
+
+
+
+
+ Constructors
+
+
+
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+finalinherited
+
+no setterinherited
+
+no setterinherited
+
+Methods
+
+
+ model.
+ override
+
+inherited
+
+inherited
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+ViewsCounter
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ViewsCounter constructor
+
Implementation
+
+ViewsCounter() : super(models.views);build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+ model.Implementation
+
+@override
+Widget build(BuildContext context, ViewsModel model) => Row(
+ mainAxisSize: MainAxisSize.min,
+ children: [
+ const Text("Views:"),
+ const SizedBox(width: 4),
+ DropdownButton<int>(
+ iconEnabledColor: Colors.black,
+ value: model.views.length,
+ onChanged: model.setNumViews,
+ items: [
+ for (int i = 1; i <= 4; i++) DropdownMenuItem(
+ value: i,
+ child: Center(child: Text(i.toString())),
+ ),
+ ],
+ ),
+ ],
+);
+
+
diff --git a/docs/widgets/ViewsWidget-class.html b/docs/widgets/ViewsWidget-class.html
new file mode 100644
index 0000000000..8e6e07defa
--- /dev/null
+++ b/docs/widgets/ViewsWidget-class.html
@@ -0,0 +1,428 @@
+
+
+
+
+
+
+
+ ViewsWidget
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ViewsWidget class
+
+
+
+
+
+
+ Constructors
+
+
+
+ Properties
+
+
+ no setterinherited
+
+finalinherited
+
+finalinherited
+
+no setterinherited
+
+no setterinherited
+
+Methods
+
+
+ model.
+ override
+
+inherited
+
+inherited
+
+inherited
+
+DiagnosticsNode objects describing this node's
+children.
+ inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+inherited
+
+Operators
+
+
+ inherited
+
+ViewsWidget
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ViewsWidget constructor
+
Implementation
+
+ViewsWidget() : super(models.views);build
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ build method
+
+
+
+Widget
+build(
+
+
)
+
+ override
+
+ model.Implementation
+
+@override
+Widget build(BuildContext context, ViewsModel model) => switch (model.views.length) {
+ 1 => Column(children: [Expanded(
+ child: ViewWidget(models.views.views[0]),
+ ),],),
+ 2 => ResizableContainer(
+ direction: switch (models.settings.dashboard.splitMode) {
+ SplitMode.horizontal => Axis.vertical,
+ SplitMode.vertical => Axis.horizontal,
+ },
+ dividerWidth: 8,
+ controller: switch (models.settings.dashboard.splitMode) {
+ SplitMode.horizontal => model.verticalController,
+ SplitMode.vertical => model.horizontalController1,
+ },
+ dividerColor: Colors.black,
+ children: [
+ ResizableChildData(
+ minSize: 100,
+ startingRatio: 0.5,
+ child: ViewWidget(models.views.views[0]),
+ ),
+ ResizableChildData(
+ minSize: 100,
+ startingRatio: 0.5,
+ child: ViewWidget(models.views.views[1]),
+ ),
+ ],
+ ),
+ 3 || 4 => ResizableContainer(
+ controller: model.verticalController,
+ direction: Axis.vertical,
+ dividerWidth: 8,
+ dividerColor: Colors.black,
+ children: [
+ ResizableChildData(
+ minSize: 100,
+ startingRatio: 0.5,
+ child: ResizableContainer(
+ controller: model.horizontalController1,
+ direction: Axis.horizontal,
+ dividerWidth: 8,
+ dividerColor: Colors.black,
+ children: [
+ ResizableChildData(
+ minSize: 100,
+ startingRatio: 0.5,
+ child: ViewWidget(models.views.views[0]),
+ ),
+ ResizableChildData(
+ minSize: 100,
+ startingRatio: 0.5,
+ child: ViewWidget(models.views.views[1]),
+ ),
+ ],
+ ),
+ ),
+ if (model.views.length == 3) ResizableChildData(
+ minSize: 100,
+ startingRatio: 0.5,
+ child: ViewWidget(models.views.views[2]),
+ ) else ResizableChildData(
+ minSize: 100,
+ startingRatio: 0.5,
+ child: ResizableContainer(
+ controller: model.horizontalController2,
+ direction: Axis.horizontal,
+ dividerWidth: 8,
+ dividerColor: Colors.black,
+ children: [
+ ResizableChildData(
+ minSize: 100,
+ startingRatio: 0.5,
+ child: ViewWidget(models.views.views[2]),
+ ),
+ ResizableChildData(
+ minSize: 100,
+ startingRatio: 0.5,
+ child: ViewWidget(models.views.views[3]),
+ ),
+ ],
+ ),
+ ),
+ ],
+ ),
+ _ => throw StateError("Too many views: ${model.views.length}"),
+ };
+
diff --git a/docs/widgets/widgets-library.html b/docs/widgets/widgets-library.html
new file mode 100644
index 0000000000..915ac24897
--- /dev/null
+++ b/docs/widgets/widgets-library.html
@@ -0,0 +1,438 @@
+
+
+
+
+
+
+
+ widgets
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ widgets
+ library
+
+
+
+
+
+atomic directory represent singular pieces of data, such as metric readouts.generic directory contains random pieces of UI that are reused in many locations.navigation directory is for global pieces of UI that handle navigation.utils directory contains widgets or other frontend code used by other widgets.Classes
+
+
+
+ ui.Image.
+Extensions
+
+
+
+