@blueyerobotics/protocol-definitions 3.3.0-e472bef2 → 3.4.0-38c6a3b0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,11 +1,37 @@
1
1
  import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
2
- import { Any } from "./google/protobuf/any";
3
- import { Duration } from "./google/protobuf/duration";
2
+ import { Any } from "./google/protobuf/any.js";
3
+ import { Duration } from "./google/protobuf/duration.js";
4
4
  /**
5
5
  * Common messages
6
6
  *
7
7
  * These are used for logging as well as building requests and responses.
8
8
  */
9
+ /** How the arm input of the last command was read, as reported in telemetry. */
10
+ export declare enum ManipulatorControlMode {
11
+ /** MANIPULATOR_CONTROL_MODE_UNSPECIFIED - No arm input. */
12
+ MANIPULATOR_CONTROL_MODE_UNSPECIFIED = 0,
13
+ /** MANIPULATOR_CONTROL_MODE_CYLINDRICAL - CylindricalManipulatorInput. */
14
+ MANIPULATOR_CONTROL_MODE_CYLINDRICAL = 1,
15
+ /** MANIPULATOR_CONTROL_MODE_CARTESIAN - CartesianManipulatorInput. */
16
+ MANIPULATOR_CONTROL_MODE_CARTESIAN = 2,
17
+ /** MANIPULATOR_CONTROL_MODE_KNOWN_POSE - KnownPoseManipulatorInput. */
18
+ MANIPULATOR_CONTROL_MODE_KNOWN_POSE = 3,
19
+ UNRECOGNIZED = -1
20
+ }
21
+ export declare function manipulatorControlModeFromJSON(object: any): ManipulatorControlMode;
22
+ export declare function manipulatorControlModeToJSON(object: ManipulatorControlMode): string;
23
+ /** Named manipulator poses. */
24
+ export declare enum ManipulatorPose {
25
+ /** MANIPULATOR_POSE_UNSPECIFIED - No pose. */
26
+ MANIPULATOR_POSE_UNSPECIFIED = 0,
27
+ /** MANIPULATOR_POSE_STOWED - Folded for transport, launch and recovery. */
28
+ MANIPULATOR_POSE_STOWED = 1,
29
+ /** MANIPULATOR_POSE_DEPLOYED - Unfolded and ready to work. */
30
+ MANIPULATOR_POSE_DEPLOYED = 2,
31
+ UNRECOGNIZED = -1
32
+ }
33
+ export declare function manipulatorPoseFromJSON(object: any): ManipulatorPose;
34
+ export declare function manipulatorPoseToJSON(object: ManipulatorPose): string;
9
35
  /** Interval type for time-lapse photos. */
10
36
  export declare enum IntervalType {
11
37
  /** INTERVAL_TYPE_UNSPECIFIED - Unspecified. */
@@ -138,6 +164,8 @@ export declare enum NotificationType {
138
164
  NOTIFICATION_TYPE_DVL_THERMAL_PROTECTION_MODE_DETECTED = 32,
139
165
  /** NOTIFICATION_TYPE_VIDEO_PARTITION_NOT_MOUNTED - Video partition not mounted. */
140
166
  NOTIFICATION_TYPE_VIDEO_PARTITION_NOT_MOUNTED = 33,
167
+ /** NOTIFICATION_TYPE_DVL_PROTOCOL_UNSUPPORTED - DVL firmware speaks a protocol version Blunux does not support. */
168
+ NOTIFICATION_TYPE_DVL_PROTOCOL_UNSUPPORTED = 34,
141
169
  UNRECOGNIZED = -1
142
170
  }
143
171
  export declare function notificationTypeFromJSON(object: any): NotificationType;
@@ -250,17 +278,19 @@ export declare function resolutionToJSON(object: Resolution): string;
250
278
  * Available camera frame rates.
251
279
  *
252
280
  * If the requested frame rate is higher than what is supported at the current resolution,
253
- * the frame rate will be reduced while the resolution is respected.
281
+ * the frame rate will be reduced while the resolution is respected: 60 to 30 and 50 to 25.
254
282
  */
255
283
  export declare enum Framerate {
256
284
  /** FRAMERATE_UNSPECIFIED - Framerate not specified. */
257
285
  FRAMERATE_UNSPECIFIED = 0,
258
286
  /** FRAMERATE_FPS_30 - 30 frames per second. */
259
287
  FRAMERATE_FPS_30 = 1,
260
- /** FRAMERATE_FPS_25 - 25 frames per second. (Only supported on Pioneer/Pro/X1/X3) */
288
+ /** FRAMERATE_FPS_25 - 25 frames per second. */
261
289
  FRAMERATE_FPS_25 = 2,
262
290
  /** FRAMERATE_FPS_60 - 60 frames per second. (Only supported on X3 Ultra at QHD, 1080p and 720p) */
263
291
  FRAMERATE_FPS_60 = 3,
292
+ /** FRAMERATE_FPS_50 - 50 frames per second. (Only supported on X3 Ultra at QHD, 1080p and 720p) */
293
+ FRAMERATE_FPS_50 = 4,
264
294
  UNRECOGNIZED = -1
265
295
  }
266
296
  export declare function framerateFromJSON(object: any): Framerate;
@@ -352,7 +382,10 @@ export declare function thicknessUnitFromJSON(object: any): ThicknessUnit;
352
382
  export declare function thicknessUnitToJSON(object: ThicknessUnit): string;
353
383
  /** Available font sizes for overlay text elements. */
354
384
  export declare enum FontSize {
355
- /** FONT_SIZE_UNSPECIFIED - Font size not specified. */
385
+ /**
386
+ * FONT_SIZE_UNSPECIFIED - Font size and margins derived from the recording resolution (Blunux >= 5.2).
387
+ * Older firmware defaults to 25px.
388
+ */
356
389
  FONT_SIZE_UNSPECIFIED = 0,
357
390
  /** FONT_SIZE_PX15 - 15 px. */
358
391
  FONT_SIZE_PX15 = 1,
@@ -479,6 +512,10 @@ export declare enum GuestPortDeviceID {
479
512
  GUEST_PORT_DEVICE_ID_CYGNUS_MINI_ROV_THICKNESS_GAUGE_RS232 = 49,
480
513
  /** GUEST_PORT_DEVICE_ID_WATERLINKED_DVL_A100 - Waterlinked DVL A100. */
481
514
  GUEST_PORT_DEVICE_ID_WATERLINKED_DVL_A100 = 50,
515
+ /** GUEST_PORT_DEVICE_ID_OUTLAND_TECHNOLOGY_MP200 - Outland Technology MP-200 Manipulator. */
516
+ GUEST_PORT_DEVICE_ID_OUTLAND_TECHNOLOGY_MP200 = 51,
517
+ /** GUEST_PORT_DEVICE_ID_REACH_ROBOTICS_REACH_ALPHA_5 - Reach Robotics Reach Alpha 5 Manipulator. */
518
+ GUEST_PORT_DEVICE_ID_REACH_ROBOTICS_REACH_ALPHA_5 = 52,
482
519
  UNRECOGNIZED = -1
483
520
  }
484
521
  export declare function guestPortDeviceIDFromJSON(object: any): GuestPortDeviceID;
@@ -552,6 +589,36 @@ export declare enum NavigationSensorID {
552
589
  }
553
590
  export declare function navigationSensorIDFromJSON(object: any): NavigationSensorID;
554
591
  export declare function navigationSensorIDToJSON(object: NavigationSensorID): string;
592
+ /** Position fix mode reported by the NMEA GSA sentence. */
593
+ export declare enum GnssFixMode {
594
+ /** GNSS_FIX_MODE_UNSPECIFIED - No GSA sentence has been received. */
595
+ GNSS_FIX_MODE_UNSPECIFIED = 0,
596
+ /** GNSS_FIX_MODE_NO_FIX - The receiver has no position fix. */
597
+ GNSS_FIX_MODE_NO_FIX = 1,
598
+ /** GNSS_FIX_MODE_2D - Horizontal fix only, no usable altitude. */
599
+ GNSS_FIX_MODE_2D = 2,
600
+ /** GNSS_FIX_MODE_3D - Full three dimensional fix. */
601
+ GNSS_FIX_MODE_3D = 3,
602
+ UNRECOGNIZED = -1
603
+ }
604
+ export declare function gnssFixModeFromJSON(object: any): GnssFixMode;
605
+ export declare function gnssFixModeToJSON(object: GnssFixMode): string;
606
+ /** GNSS constellation a satellite belongs to. */
607
+ export declare enum GnssConstellation {
608
+ /** GNSS_CONSTELLATION_UNSPECIFIED - Unspecified. */
609
+ GNSS_CONSTELLATION_UNSPECIFIED = 0,
610
+ /** GNSS_CONSTELLATION_GPS - GPS. */
611
+ GNSS_CONSTELLATION_GPS = 1,
612
+ /** GNSS_CONSTELLATION_GLONASS - GLONASS. */
613
+ GNSS_CONSTELLATION_GLONASS = 2,
614
+ /** GNSS_CONSTELLATION_GALILEO - Galileo. */
615
+ GNSS_CONSTELLATION_GALILEO = 3,
616
+ /** GNSS_CONSTELLATION_BEIDOU - BeiDou. */
617
+ GNSS_CONSTELLATION_BEIDOU = 4,
618
+ UNRECOGNIZED = -1
619
+ }
620
+ export declare function gnssConstellationFromJSON(object: any): GnssConstellation;
621
+ export declare function gnssConstellationToJSON(object: GnssConstellation): string;
555
622
  /** Status for guest port devices that can be attached and detached. */
556
623
  export declare enum GuestPortDetachStatus {
557
624
  /** GUEST_PORT_DETACH_STATUS_UNSPECIFIED - Unspecified (Default for non-detachable devices). */
@@ -752,7 +819,7 @@ export interface MotionInput {
752
819
  roll: number;
753
820
  /** Pitch down (negative) or up (positive). (-1..1). */
754
821
  pitch: number;
755
- /** Left (positive) and right (negative) movement (-1..1). */
822
+ /** Clockwise (positive) and counter-clockwise (negative) rotation (-1..1). */
756
823
  yaw: number;
757
824
  /** Modifier used to reduce the speed of the motion (0..1). */
758
825
  slow: number;
@@ -967,6 +1034,167 @@ export interface GripperVelocities {
967
1034
  /** The rotating velocity (-1.0..1.0). */
968
1035
  rotateVelocity: number;
969
1036
  }
1037
+ /**
1038
+ * Cartesian velocity of the end of a manipulator arm, in the drone body frame.
1039
+ *
1040
+ * Each value is normalized (-1.0..1.0) and scaled by the drone to its configured maximum speed.
1041
+ */
1042
+ export interface CartesianManipulatorInput {
1043
+ /** Forward (positive) and backward (negative). */
1044
+ x: number;
1045
+ /** Right (positive) and left (negative). */
1046
+ y: number;
1047
+ /** Down (positive) and up (negative). */
1048
+ z: number;
1049
+ }
1050
+ /**
1051
+ * Cylindrical velocity of the end of a manipulator arm, about the axis of the arm's base joint.
1052
+ *
1053
+ * Each value is normalized (-1.0..1.0) and scaled by the drone to its configured maximum speed.
1054
+ */
1055
+ export interface CylindricalManipulatorInput {
1056
+ /** Out from the base axis (positive) and in towards it (negative). */
1057
+ radial: number;
1058
+ /** Along the base axis: down (positive) and up (negative), as in the drone body frame. */
1059
+ vertical: number;
1060
+ /** Swing about the base axis: clockwise seen from above (positive). */
1061
+ azimuth: number;
1062
+ }
1063
+ /**
1064
+ * Movement of a manipulator arm towards a named pose, along a path the drone chooses.
1065
+ *
1066
+ * Hold-to-run: the arm moves only while the velocity is above zero, and resumes from wherever it
1067
+ * stopped.
1068
+ */
1069
+ export interface KnownPoseManipulatorInput {
1070
+ /** The pose to move towards. */
1071
+ pose: ManipulatorPose;
1072
+ /** Speed along the path (0.0..1.0): 0 holds the arm where it is. */
1073
+ velocity: number;
1074
+ }
1075
+ /** Gripper state: of its arm too, when the gripper is a manipulator arm. */
1076
+ export interface Gripper {
1077
+ /** How the arm input of the last command was read. */
1078
+ mode: ManipulatorControlMode;
1079
+ /** Joint positions from the jaws to the base: jaws opening (m), then joint angles (rad). */
1080
+ jointPositions: number[];
1081
+ /** Position of the base of the jaws in the drone body frame (m). */
1082
+ endPosition: Vector3 | undefined;
1083
+ /** A joint at the end of its range keeps the arm from going further. */
1084
+ atLimit: boolean;
1085
+ /** The arm stopped itself short of an obstacle or of itself. */
1086
+ collision: boolean;
1087
+ /** The jaws closed on something. */
1088
+ holding: boolean;
1089
+ /** A joint reports a hardware fault. */
1090
+ fault: boolean;
1091
+ /** Named pose the arm is moving towards, if any. */
1092
+ movingTo: ManipulatorPose;
1093
+ }
1094
+ /**
1095
+ * Hardware status flags a device of a Reach Robotics gripper raises about itself, named as Reach names them.
1096
+ * A gripper of another make would need flags of its own.
1097
+ */
1098
+ export interface ReachHardwareStatus {
1099
+ /** Reading the device's flash memory failed. */
1100
+ flashFailedRead: boolean;
1101
+ /** Humidity in the housing is too high: water may have got in. */
1102
+ overHumidity: boolean;
1103
+ /** The housing is too hot. */
1104
+ overTemperature: boolean;
1105
+ /** Error on the serial line. */
1106
+ commsSerialError: boolean;
1107
+ /** A packet failed its checksum. */
1108
+ commsCrcError: boolean;
1109
+ /** The motor driver reports a fault. */
1110
+ motorDriverFault: boolean;
1111
+ /** The position encoder reads an invalid position. */
1112
+ encoderPositionError: boolean;
1113
+ /** The position encoder is not detected. */
1114
+ encoderNotDetected: boolean;
1115
+ /** Another device has the same axis. */
1116
+ deviceAxisConflict: boolean;
1117
+ /** The motor is not connected. */
1118
+ motorNotConnected: boolean;
1119
+ /** The motor draws too much current. */
1120
+ motorOverCurrent: boolean;
1121
+ /** The input encoder reads an invalid position. */
1122
+ inputEncoderPositionError: boolean;
1123
+ /** Another device has the same ID. */
1124
+ deviceIdConflict: boolean;
1125
+ /** Pressure in the housing is too high: the seal may have failed. */
1126
+ overPressure: boolean;
1127
+ /** Over current or under voltage in the motor driver. */
1128
+ motorDriverOverCurrentAndUnderVoltage: boolean;
1129
+ /** The motor driver is too hot. */
1130
+ motorDriverOverTemperature: boolean;
1131
+ /** The device is due for service. */
1132
+ jointServiceDue: boolean;
1133
+ /** The position encoder reports a fault. */
1134
+ encoderFault: boolean;
1135
+ /** The supply voltage is too low. */
1136
+ lowSupplyVoltage: boolean;
1137
+ /** A position report the device waits for has not arrived. */
1138
+ positionReportNotReceived: boolean;
1139
+ }
1140
+ /**
1141
+ * Health of one device of a gripper: a joint, or a device of its own.
1142
+ *
1143
+ * A value the device did not report is 0, with its is_*_valid false.
1144
+ */
1145
+ export interface GripperDeviceDiagnostics {
1146
+ /** Address of the device on the gripper's bus. On a Reach Robotics arm, 1 is the jaws. */
1147
+ address: number;
1148
+ /** Supply voltage (V). */
1149
+ supplyVoltage: number;
1150
+ /** True when the device reported its supply voltage. */
1151
+ isSupplyVoltageValid: boolean;
1152
+ /** Temperature in the housing (°C). */
1153
+ temperature: number;
1154
+ /** True when the device reported the temperature in its housing. */
1155
+ isTemperatureValid: boolean;
1156
+ /** Relative humidity in the housing (%). */
1157
+ humidity: number;
1158
+ /** True when the device reported the humidity in its housing. */
1159
+ isHumidityValid: boolean;
1160
+ /** Absolute pressure in the housing (bar), a partial vacuum: a rise can mean a leak. */
1161
+ internalPressure: number;
1162
+ /** True when the device reported the pressure in its housing. */
1163
+ isInternalPressureValid: boolean;
1164
+ /** Motor current (A). */
1165
+ current: number;
1166
+ /** True when the device reported its motor current. */
1167
+ isCurrentValid: boolean;
1168
+ /**
1169
+ * Flags the device reported, and those it raised since the last report.
1170
+ * Not set if the device sent no hardware status.
1171
+ */
1172
+ hardwareStatus: ReachHardwareStatus | undefined;
1173
+ }
1174
+ /**
1175
+ * Identity of a gripper: what it is, and what it reports of itself.
1176
+ *
1177
+ * A value the gripper does not report is empty.
1178
+ */
1179
+ export interface GripperInfo {
1180
+ /** Guest port the gripper is on. */
1181
+ guestPortNumber: GuestPortNumber;
1182
+ /** What the gripper is, as its guest-port connector names it. */
1183
+ deviceId: GuestPortDeviceID;
1184
+ /** Serial number of the gripper, such as 5854. */
1185
+ serialNumber: string;
1186
+ /** Model number of the gripper, such as 5001 for a Reach Alpha 5 or 2130 for a Reach Alpha 2. */
1187
+ modelNumber: string;
1188
+ /** Firmware version of the gripper, such as 5.2.0. */
1189
+ firmwareVersion: string;
1190
+ }
1191
+ /** Health of a gripper and its devices, for diagnostics. */
1192
+ export interface GripperDiagnostics {
1193
+ /** One for each device of the gripper that answered. */
1194
+ devices: GripperDeviceDiagnostics[];
1195
+ /** Guest port the gripper is on. */
1196
+ guestPortNumber: GuestPortNumber;
1197
+ }
970
1198
  /** Information about a remote client. */
971
1199
  export interface ClientInfo {
972
1200
  /** The type of client (such as Blueye App, Observer App, SDK, etc). */
@@ -1085,6 +1313,20 @@ export interface CanisterHumidity {
1085
1313
  /** Air humidity (%). */
1086
1314
  humidity: number;
1087
1315
  }
1316
+ /** Sensor readings inside the X7 power canister. */
1317
+ export interface PowerCanister {
1318
+ /** Front ESC board; absent when no recent reading is available. */
1319
+ frontEsc: PowerCanister_Sensors | undefined;
1320
+ /** Rear ESC board; absent when no recent reading is available. */
1321
+ rearEsc: PowerCanister_Sensors | undefined;
1322
+ }
1323
+ /** Sensor readings from an ESC board. */
1324
+ export interface PowerCanister_Sensors {
1325
+ /** Temperature (°C). */
1326
+ temperature: number;
1327
+ /** Relative humidity (%). */
1328
+ humidity: number;
1329
+ }
1088
1330
  /** Essential battery information. */
1089
1331
  export interface Battery {
1090
1332
  /** Battery voltage (V). */
@@ -1902,12 +2144,22 @@ export interface ErrorFlags {
1902
2144
  dvlThermalProtectionMode: boolean;
1903
2145
  /** GP protection has been triggered at boot or faulty DVL. */
1904
2146
  dvlNoPower: boolean;
2147
+ /** DVL firmware speaks a protocol version Blunux does not support. */
2148
+ dvlProtocolUnsupported: boolean;
1905
2149
  /** USB disconnect. */
1906
2150
  usbDisconnect: boolean;
1907
2151
  /** Video URB error. */
1908
2152
  videoUrbError: boolean;
1909
2153
  /** Hardware not supported on current blunux version. */
1910
2154
  hardwareNotSupported: boolean;
2155
+ /** MPU 1 unavailable at observer startup. */
2156
+ imu1: boolean;
2157
+ /** MPU 2 unavailable at observer startup. */
2158
+ imu2: boolean;
2159
+ /** HP IMU unavailable on X3 Ultra or X7. */
2160
+ imuHp: boolean;
2161
+ /** No attitude source: manual body-frame control only. */
2162
+ imuAttitude: boolean;
1911
2163
  }
1912
2164
  /** Camera parameters. */
1913
2165
  export interface CameraParameters {
@@ -2007,11 +2259,14 @@ export interface OverlayParameters {
2007
2259
  thicknessUnit: ThicknessUnit;
2008
2260
  /** Timezone offset from UTC (min). */
2009
2261
  timezoneOffset: number;
2010
- /** Horizontal margins of text elements (px). */
2262
+ /** Horizontal margins of text elements (px). Ignored when font_size is FONT_SIZE_UNSPECIFIED (Blunux >= 5.2). */
2011
2263
  marginWidth: number;
2012
- /** Vertical margins of text elements (px). */
2264
+ /** Vertical margins of text elements (px). Ignored when font_size is FONT_SIZE_UNSPECIFIED (Blunux >= 5.2). */
2013
2265
  marginHeight: number;
2014
- /** Font size of text elements. */
2266
+ /**
2267
+ * Font size of text elements. FONT_SIZE_UNSPECIFIED derives font size and margins from the
2268
+ * recording resolution (Blunux >= 5.2). Older firmware defaults to 25px.
2269
+ */
2015
2270
  fontSize: FontSize;
2016
2271
  /** Optional title. */
2017
2272
  title: string;
@@ -2041,6 +2296,86 @@ export interface NavigationSensorStatus {
2041
2296
  /** Global position from sensor. */
2042
2297
  globalPosition: LatLongPosition | undefined;
2043
2298
  }
2299
+ /** Satellite tracked by the Blueye GNSS receiver. */
2300
+ export interface GnssSatellite {
2301
+ /** Constellation the satellite belongs to. */
2302
+ constellation: GnssConstellation;
2303
+ /** Satellite id within the constellation. */
2304
+ satelliteId: number;
2305
+ /** Carrier to noise ratio (dB-Hz). */
2306
+ snr: number;
2307
+ /** Elevation above the horizon (°, 0..90), or -1 when the receiver did not report it. */
2308
+ elevation: number;
2309
+ /** Azimuth clockwise from true north (°, 0..359), or -1 when the receiver did not report it. */
2310
+ azimuth: number;
2311
+ /** Whether GSA lists the satellite as used in the fix. Only meaningful if is_used_in_fix_valid. */
2312
+ usedInFix: boolean;
2313
+ }
2314
+ /** Status of the onboard Blueye GNSS receiver and its driver. */
2315
+ export interface GnssStatus {
2316
+ /** True when the receiver is connected and producing NMEA sentences. */
2317
+ receiverConnected: boolean;
2318
+ /** NMEA GGA fix quality indicator (0 = no fix). */
2319
+ fixQuality: number;
2320
+ /** True when the receiver reports a usable position fix. */
2321
+ isValid: boolean;
2322
+ /** Number of satellites used in the position fix. */
2323
+ satellitesUsed: number;
2324
+ /** Satellites in the satellites list: those with a signal in the latest GSV burst. */
2325
+ satellitesTracked: number;
2326
+ /** Satellites predicted above the horizon, over all constellations; needs no signal. */
2327
+ satellitesInView: number;
2328
+ /** True when GSA could be attributed to a constellation, making used_in_fix usable. */
2329
+ isUsedInFixValid: boolean;
2330
+ /** Fix mode from GSA (2D/3D). */
2331
+ fixMode: GnssFixMode;
2332
+ /** Horizontal dilution of precision. */
2333
+ hdop: number;
2334
+ /** Position (3D) dilution of precision, from GSA. */
2335
+ pdop: number;
2336
+ /** Vertical dilution of precision, from GSA. */
2337
+ vdop: number;
2338
+ /** Reported global position. */
2339
+ globalPosition: LatLongPosition | undefined;
2340
+ /** Altitude above mean sea level (m), from GGA. */
2341
+ altitude: number;
2342
+ /** Standard deviation of the latitude (m). Meaningless unless is_accuracy_valid. */
2343
+ stddevLatitude: number;
2344
+ /** Standard deviation of the longitude (m). Meaningless unless is_accuracy_valid. */
2345
+ stddevLongitude: number;
2346
+ /** Standard deviation of the altitude (m). Meaningless unless is_accuracy_valid. */
2347
+ stddevAltitude: number;
2348
+ /** Semi-major axis of the horizontal error ellipse (m). */
2349
+ stddevSemiMajor: number;
2350
+ /** Semi-minor axis of the horizontal error ellipse (m). */
2351
+ stddevSemiMinor: number;
2352
+ /** Orientation of the semi-major axis, clockwise from true north (°). */
2353
+ errorEllipseOrientation: number;
2354
+ /** RMS of the range residuals (m), from GST. */
2355
+ rangeRms: number;
2356
+ /** True once the receiver has reported a GST sentence to derive the deviations from. */
2357
+ isAccuracyValid: boolean;
2358
+ /** Course over ground (°). Meaningless unless is_course_valid. */
2359
+ courseOverGround: number;
2360
+ /** True when the fix is valid and the receiver actually reported a course. */
2361
+ isCourseValid: boolean;
2362
+ /** Speed over ground (m/s). */
2363
+ speedOverGround: number;
2364
+ /** Age of the differential corrections (s), or -1 without DGPS/RTK. */
2365
+ differentialAge: number;
2366
+ /** Id of the station supplying the differential corrections, or -1 when absent. */
2367
+ differentialStation: number;
2368
+ /** Serial baud rate in use (bit/s). */
2369
+ baudRate: number;
2370
+ /** Times the driver has reconnected to the receiver since boot. */
2371
+ reconnectCount: number;
2372
+ /** Receive errors seen by the driver since boot. */
2373
+ receiveErrorCount: number;
2374
+ /** Time since the last NMEA sentence was received (s). */
2375
+ timeSinceLastSentence: number;
2376
+ /** Satellites currently tracked with signal strength. */
2377
+ satellites: GnssSatellite[];
2378
+ }
2044
2379
  /** Information about a device connected to one of the guest ports. */
2045
2380
  export interface GuestPortDevice {
2046
2381
  /** Blueye device identifier. */
@@ -2337,6 +2672,17 @@ export interface MultibeamDiscovery {
2337
2672
  /** Error flags specific for the connected multibeam device. */
2338
2673
  errorFlags: MultibeamErrorFlags | undefined;
2339
2674
  }
2675
+ /**
2676
+ * Color filter used to render the multibeam sonar fan.
2677
+ *
2678
+ * The fan renderer maps each echo intensity (0..255) to a color through this
2679
+ * lookup table. The drone keeps the last filter received in memory and applies
2680
+ * it to the sonar RTSP stream; grayscale is used until one is set.
2681
+ */
2682
+ export interface MultibeamColorFilter {
2683
+ /** 768 bytes: 256 consecutive R,G,B triplets, indexed by echo intensity. */
2684
+ rgb: Uint8Array;
2685
+ }
2340
2686
  /** Error flags for multibeam sonar devices. */
2341
2687
  export interface MultibeamErrorFlags {
2342
2688
  /**
@@ -2632,12 +2978,19 @@ export interface BoundingBox {
2632
2978
  height: number;
2633
2979
  }
2634
2980
  /**
2635
- * RLE-encoded binary segmentation mask relative to the bounding box.
2981
+ * RLE-encoded binary segmentation mask with its own anchor box.
2636
2982
  *
2637
2983
  * The mask bitmap has dimensions (mask_width x mask_height) covering the
2638
- * detection's bounding box area. The counts field stores run-length encoded
2639
- * data as packed uint16 little-endian: alternating background/foreground
2640
- * pixel runs starting with background.
2984
+ * mask_box region of the camera image. The counts field stores run-length
2985
+ * encoded data as packed uint16 little-endian: alternating
2986
+ * background/foreground pixel runs starting with background. Runs longer
2987
+ * than 65535 pixels are split by inserting a zero-length run of the
2988
+ * opposite class (e.g. 70000 becomes 65535, 0, 4465), so decoders need no
2989
+ * special handling — a zero-length run just toggles the class.
2990
+ *
2991
+ * Scale the mask to mask_box, not to the detection's bounding_box: the
2992
+ * bounding box may be smoothed by tracking, while mask_box is pinned to the
2993
+ * raw detection position, so the mask stays on the actual object pixels.
2641
2994
  */
2642
2995
  export interface SegmentationMask {
2643
2996
  /** Width of the RLE bitmap. */
@@ -2646,10 +2999,12 @@ export interface SegmentationMask {
2646
2999
  maskHeight: number;
2647
3000
  /** RLE counts as packed uint16 little-endian. */
2648
3001
  counts: Uint8Array;
3002
+ /** Image region the mask bitmap covers (raw detection position, never smoothed). */
3003
+ maskBox: BoundingBox | undefined;
2649
3004
  }
2650
3005
  /** A single object detection from a computer vision model. */
2651
3006
  export interface ObjectDetection {
2652
- /** Bounding box of the detected object. */
3007
+ /** Bounding box of the detected object (may be smoothed by tracking). */
2653
3008
  boundingBox: BoundingBox | undefined;
2654
3009
  /** Detection confidence score (0..1). */
2655
3010
  confidence: number;
@@ -2682,6 +3037,13 @@ export interface FilterMessage {
2682
3037
  /** Intensity of the filter (0..1). */
2683
3038
  intensity: number;
2684
3039
  }
3040
+ /** Frames that the marine snow filter compares each frame with. */
3041
+ export interface MarineSnowFilterFrames {
3042
+ /** Past frames to compare with (1..4). */
3043
+ pastFrames: number;
3044
+ /** Future frames to compare with (0..2). Each one delays the video by 33 to 40 ms. */
3045
+ futureFrames: number;
3046
+ }
2685
3047
  /**
2686
3048
  * Digital pan, tilt, and zoom state for the main camera.
2687
3049
  *
@@ -2804,6 +3166,14 @@ export declare const ControlMode: MessageFns<ControlMode>;
2804
3166
  export declare const TiltStabilizationState: MessageFns<TiltStabilizationState>;
2805
3167
  export declare const SystemTime: MessageFns<SystemTime>;
2806
3168
  export declare const GripperVelocities: MessageFns<GripperVelocities>;
3169
+ export declare const CartesianManipulatorInput: MessageFns<CartesianManipulatorInput>;
3170
+ export declare const CylindricalManipulatorInput: MessageFns<CylindricalManipulatorInput>;
3171
+ export declare const KnownPoseManipulatorInput: MessageFns<KnownPoseManipulatorInput>;
3172
+ export declare const Gripper: MessageFns<Gripper>;
3173
+ export declare const ReachHardwareStatus: MessageFns<ReachHardwareStatus>;
3174
+ export declare const GripperDeviceDiagnostics: MessageFns<GripperDeviceDiagnostics>;
3175
+ export declare const GripperInfo: MessageFns<GripperInfo>;
3176
+ export declare const GripperDiagnostics: MessageFns<GripperDiagnostics>;
2807
3177
  export declare const ClientInfo: MessageFns<ClientInfo>;
2808
3178
  export declare const ConnectedClient: MessageFns<ConnectedClient>;
2809
3179
  export declare const RecordState: MessageFns<RecordState>;
@@ -2814,6 +3184,8 @@ export declare const WaterTemperature: MessageFns<WaterTemperature>;
2814
3184
  export declare const CPUTemperature: MessageFns<CPUTemperature>;
2815
3185
  export declare const CanisterTemperature: MessageFns<CanisterTemperature>;
2816
3186
  export declare const CanisterHumidity: MessageFns<CanisterHumidity>;
3187
+ export declare const PowerCanister: MessageFns<PowerCanister>;
3188
+ export declare const PowerCanister_Sensors: MessageFns<PowerCanister_Sensors>;
2817
3189
  export declare const Battery: MessageFns<Battery>;
2818
3190
  export declare const BatteryBQ40Z50: MessageFns<BatteryBQ40Z50>;
2819
3191
  export declare const BatteryBQ40Z50_Voltage: MessageFns<BatteryBQ40Z50_Voltage>;
@@ -2854,6 +3226,8 @@ export declare const ErrorFlags: MessageFns<ErrorFlags>;
2854
3226
  export declare const CameraParameters: MessageFns<CameraParameters>;
2855
3227
  export declare const OverlayParameters: MessageFns<OverlayParameters>;
2856
3228
  export declare const NavigationSensorStatus: MessageFns<NavigationSensorStatus>;
3229
+ export declare const GnssSatellite: MessageFns<GnssSatellite>;
3230
+ export declare const GnssStatus: MessageFns<GnssStatus>;
2857
3231
  export declare const GuestPortDevice: MessageFns<GuestPortDevice>;
2858
3232
  export declare const GuestPortDeviceList: MessageFns<GuestPortDeviceList>;
2859
3233
  export declare const GuestPortConnectorInfo: MessageFns<GuestPortConnectorInfo>;
@@ -2870,6 +3244,7 @@ export declare const MedusaSpectrometerData: MessageFns<MedusaSpectrometerData>;
2870
3244
  export declare const MultibeamPing: MessageFns<MultibeamPing>;
2871
3245
  export declare const MultibeamConfig: MessageFns<MultibeamConfig>;
2872
3246
  export declare const MultibeamDiscovery: MessageFns<MultibeamDiscovery>;
3247
+ export declare const MultibeamColorFilter: MessageFns<MultibeamColorFilter>;
2873
3248
  export declare const MultibeamErrorFlags: MessageFns<MultibeamErrorFlags>;
2874
3249
  export declare const MultibeamFrameOffset: MessageFns<MultibeamFrameOffset>;
2875
3250
  export declare const MutltibeamRecordingIndex: MessageFns<MutltibeamRecordingIndex>;
@@ -2890,6 +3265,7 @@ export declare const SegmentationMask: MessageFns<SegmentationMask>;
2890
3265
  export declare const ObjectDetection: MessageFns<ObjectDetection>;
2891
3266
  export declare const ModelDetections: MessageFns<ModelDetections>;
2892
3267
  export declare const FilterMessage: MessageFns<FilterMessage>;
3268
+ export declare const MarineSnowFilterFrames: MessageFns<MarineSnowFilterFrames>;
2893
3269
  export declare const CameraPanTiltZoom: MessageFns<CameraPanTiltZoom>;
2894
3270
  export declare const OperatorInfo: MessageFns<OperatorInfo>;
2895
3271
  export declare const SotState: MessageFns<SotState>;