@blueyerobotics/protocol-definitions 3.2.0-fed2b1e2 → 3.3.0-053a9cb8

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.
@@ -136,6 +136,8 @@ export declare enum NotificationType {
136
136
  NOTIFICATION_TYPE_DVL_HIGH_TEMPERATURE_DETECTED = 31,
137
137
  /** NOTIFICATION_TYPE_DVL_THERMAL_PROTECTION_MODE_DETECTED - DVL thermal protection mode detected. */
138
138
  NOTIFICATION_TYPE_DVL_THERMAL_PROTECTION_MODE_DETECTED = 32,
139
+ /** NOTIFICATION_TYPE_VIDEO_PARTITION_NOT_MOUNTED - Video partition not mounted. */
140
+ NOTIFICATION_TYPE_VIDEO_PARTITION_NOT_MOUNTED = 33,
139
141
  UNRECOGNIZED = -1
140
142
  }
141
143
  export declare function notificationTypeFromJSON(object: any): NotificationType;
@@ -184,6 +186,8 @@ export declare enum Model {
184
186
  MODEL_X3 = 3,
185
187
  /** MODEL_X3_ULTRA - Blueye X3 Ultra. */
186
188
  MODEL_X3_ULTRA = 6,
189
+ /** MODEL_X7 - Blueye X7. */
190
+ MODEL_X7 = 7,
187
191
  /** MODEL_NEXT - Blueye ? */
188
192
  MODEL_NEXT = 5,
189
193
  UNRECOGNIZED = -1
@@ -206,6 +210,24 @@ export declare enum PressureSensorType {
206
210
  }
207
211
  export declare function pressureSensorTypeFromJSON(object: any): PressureSensorType;
208
212
  export declare function pressureSensorTypeToJSON(object: PressureSensorType): string;
213
+ /**
214
+ * How the drone is powered.
215
+ *
216
+ * Lets clients determine the power configuration (e.g. parallel batteries on the
217
+ * X7) directly from DroneInfo, without waiting for telemetry. May be extended in
218
+ * the future, e.g. with topside power.
219
+ */
220
+ export declare enum PowerSource {
221
+ /** POWER_SOURCE_UNSPECIFIED - Power source unknown / not determined. */
222
+ POWER_SOURCE_UNSPECIFIED = 0,
223
+ /** POWER_SOURCE_SINGLE_BATTERY - A single battery. */
224
+ POWER_SOURCE_SINGLE_BATTERY = 1,
225
+ /** POWER_SOURCE_PARALLEL_BATTERIES - Two batteries running in parallel (e.g. X7). */
226
+ POWER_SOURCE_PARALLEL_BATTERIES = 2,
227
+ UNRECOGNIZED = -1
228
+ }
229
+ export declare function powerSourceFromJSON(object: any): PowerSource;
230
+ export declare function powerSourceToJSON(object: PowerSource): string;
209
231
  /** Available camera resolutions. */
210
232
  export declare enum Resolution {
211
233
  /** RESOLUTION_UNSPECIFIED - Resolution not specified. */
@@ -218,11 +240,18 @@ export declare enum Resolution {
218
240
  RESOLUTION_FULLHD_1080P = 1,
219
241
  /** RESOLUTION_UHD_4K - 4K Ultra HD (3840x2160, Only supported on X3 Ultra). */
220
242
  RESOLUTION_UHD_4K = 3,
243
+ /** RESOLUTION_QHD_2K - 2K QHD (2560x1440, Only supported on X3 Ultra). */
244
+ RESOLUTION_QHD_2K = 5,
221
245
  UNRECOGNIZED = -1
222
246
  }
223
247
  export declare function resolutionFromJSON(object: any): Resolution;
224
248
  export declare function resolutionToJSON(object: Resolution): string;
225
- /** Available camera frame rates. */
249
+ /**
250
+ * Available camera frame rates.
251
+ *
252
+ * 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.
254
+ */
226
255
  export declare enum Framerate {
227
256
  /** FRAMERATE_UNSPECIFIED - Framerate not specified. */
228
257
  FRAMERATE_UNSPECIFIED = 0,
@@ -230,6 +259,8 @@ export declare enum Framerate {
230
259
  FRAMERATE_FPS_30 = 1,
231
260
  /** FRAMERATE_FPS_25 - 25 frames per second. (Only supported on Pioneer/Pro/X1/X3) */
232
261
  FRAMERATE_FPS_25 = 2,
262
+ /** FRAMERATE_FPS_60 - 60 frames per second. (Only supported on X3 Ultra at QHD, 1080p and 720p) */
263
+ FRAMERATE_FPS_60 = 3,
233
264
  UNRECOGNIZED = -1
234
265
  }
235
266
  export declare function framerateFromJSON(object: any): Framerate;
@@ -257,6 +288,18 @@ export declare enum StreamingProtocol {
257
288
  }
258
289
  export declare function streamingProtocolFromJSON(object: any): StreamingProtocol;
259
290
  export declare function streamingProtocolToJSON(object: StreamingProtocol): string;
291
+ /** Recording video codec. */
292
+ export declare enum RecordingCodec {
293
+ /** RECORDING_CODEC_UNSPECIFIED - Use platform default (H.264). */
294
+ RECORDING_CODEC_UNSPECIFIED = 0,
295
+ /** RECORDING_CODEC_H264 - H.264/AVC codec. Wider compatibility with players/editors. */
296
+ RECORDING_CODEC_H264 = 1,
297
+ /** RECORDING_CODEC_H265 - H.265/HEVC codec. Better compression, limited compatibility. Ultra only. */
298
+ RECORDING_CODEC_H265 = 2,
299
+ UNRECOGNIZED = -1
300
+ }
301
+ export declare function recordingCodecFromJSON(object: any): RecordingCodec;
302
+ export declare function recordingCodecToJSON(object: RecordingCodec): string;
260
303
  /** Available temperature units. */
261
304
  export declare enum TemperatureUnit {
262
305
  /** TEMPERATURE_UNIT_UNSPECIFIED - Temperature unit not specified. */
@@ -323,6 +366,8 @@ export declare enum FontSize {
323
366
  FONT_SIZE_PX35 = 5,
324
367
  /** FONT_SIZE_PX40 - 40 px. */
325
368
  FONT_SIZE_PX40 = 6,
369
+ /** FONT_SIZE_PX50 - 50 px. */
370
+ FONT_SIZE_PX50 = 7,
326
371
  UNRECOGNIZED = -1
327
372
  }
328
373
  export declare function fontSizeFromJSON(object: any): FontSize;
@@ -419,8 +464,21 @@ export declare enum GuestPortDeviceID {
419
464
  GUEST_PORT_DEVICE_ID_WATERLINKED_SONAR_3D15 = 43,
420
465
  /** GUEST_PORT_DEVICE_ID_CERULEAN_TRACKER_650 - Cerulean Tracker 650. */
421
466
  GUEST_PORT_DEVICE_ID_CERULEAN_TRACKER_650 = 44,
422
- /** GUEST_PORT_DEVICE_ID_BLUEYE_EXTERNAL_USB_STORAGE - Blueye External USB Storage */
467
+ /** GUEST_PORT_DEVICE_ID_BLUEYE_EXTERNAL_USB_STORAGE - Blueye External USB Storage. */
423
468
  GUEST_PORT_DEVICE_ID_BLUEYE_EXTERNAL_USB_STORAGE = 45,
469
+ /** GUEST_PORT_DEVICE_ID_BLUEYE_MULTIBEAM_SERVO_V2 - Blueye Multibeam Skid Servo V2. */
470
+ GUEST_PORT_DEVICE_ID_BLUEYE_MULTIBEAM_SERVO_V2 = 46,
471
+ /** GUEST_PORT_DEVICE_ID_CERULEAN_OMNISCAN_450_COMPACT - Cerulean Omniscan 450 Compact. */
472
+ GUEST_PORT_DEVICE_ID_CERULEAN_OMNISCAN_450_COMPACT = 47,
473
+ /** GUEST_PORT_DEVICE_ID_BLUEYE_SCALING_LASER - Blueye Scaling Laser. */
474
+ GUEST_PORT_DEVICE_ID_BLUEYE_SCALING_LASER = 48,
475
+ /**
476
+ * GUEST_PORT_DEVICE_ID_CYGNUS_MINI_ROV_THICKNESS_GAUGE_RS232 - Cygnus Mini ROV Thickness Gauge on a connector that converts its RS485 to
477
+ * RS232, letting it be used on drones with no RS485, such as the X7.
478
+ */
479
+ GUEST_PORT_DEVICE_ID_CYGNUS_MINI_ROV_THICKNESS_GAUGE_RS232 = 49,
480
+ /** GUEST_PORT_DEVICE_ID_WATERLINKED_DVL_A100 - Waterlinked DVL A100. */
481
+ GUEST_PORT_DEVICE_ID_WATERLINKED_DVL_A100 = 50,
424
482
  UNRECOGNIZED = -1
425
483
  }
426
484
  export declare function guestPortDeviceIDFromJSON(object: any): GuestPortDeviceID;
@@ -435,10 +493,43 @@ export declare enum GuestPortNumber {
435
493
  GUEST_PORT_NUMBER_PORT_2 = 2,
436
494
  /** GUEST_PORT_NUMBER_PORT_3 - Guest port 3. */
437
495
  GUEST_PORT_NUMBER_PORT_3 = 3,
496
+ /** GUEST_PORT_NUMBER_PORT_4 - Guest port 4. */
497
+ GUEST_PORT_NUMBER_PORT_4 = 4,
498
+ /** GUEST_PORT_NUMBER_PORT_5 - Guest port 5. */
499
+ GUEST_PORT_NUMBER_PORT_5 = 5,
500
+ /** GUEST_PORT_NUMBER_PORT_6 - Guest port 6. */
501
+ GUEST_PORT_NUMBER_PORT_6 = 6,
438
502
  UNRECOGNIZED = -1
439
503
  }
440
504
  export declare function guestPortNumberFromJSON(object: any): GuestPortNumber;
441
505
  export declare function guestPortNumberToJSON(object: GuestPortNumber): string;
506
+ /**
507
+ * Physical interfaces a guest port can provide.
508
+ *
509
+ * Used both for the interfaces a port provides and for the interfaces a
510
+ * device requires from the port it is connected to.
511
+ */
512
+ export declare enum GuestPortCapability {
513
+ /** GUEST_PORT_CAPABILITY_UNSPECIFIED - Unspecified. */
514
+ GUEST_PORT_CAPABILITY_UNSPECIFIED = 0,
515
+ /** GUEST_PORT_CAPABILITY_ETHERNET - Ethernet. */
516
+ GUEST_PORT_CAPABILITY_ETHERNET = 1,
517
+ /** GUEST_PORT_CAPABILITY_I2C - I2C. */
518
+ GUEST_PORT_CAPABILITY_I2C = 2,
519
+ /** GUEST_PORT_CAPABILITY_RS232 - RS232 serial. */
520
+ GUEST_PORT_CAPABILITY_RS232 = 3,
521
+ /** GUEST_PORT_CAPABILITY_RS485 - RS485 serial. */
522
+ GUEST_PORT_CAPABILITY_RS485 = 4,
523
+ /** GUEST_PORT_CAPABILITY_USB2 - USB 2.0. */
524
+ GUEST_PORT_CAPABILITY_USB2 = 5,
525
+ /** GUEST_PORT_CAPABILITY_PWM - PWM. */
526
+ GUEST_PORT_CAPABILITY_PWM = 6,
527
+ /** GUEST_PORT_CAPABILITY_ETHERNET_1G - Gigabit Ethernet. */
528
+ GUEST_PORT_CAPABILITY_ETHERNET_1G = 7,
529
+ UNRECOGNIZED = -1
530
+ }
531
+ export declare function guestPortCapabilityFromJSON(object: any): GuestPortCapability;
532
+ export declare function guestPortCapabilityToJSON(object: GuestPortCapability): string;
442
533
  /** List of navigation sensors that can be used by the position observer. */
443
534
  export declare enum NavigationSensorID {
444
535
  /** NAVIGATION_SENSOR_ID_UNSPECIFIED - Unspecified. */
@@ -455,10 +546,42 @@ export declare enum NavigationSensorID {
455
546
  NAVIGATION_SENSOR_ID_NORTEK_DVL_NUCLEUS = 5,
456
547
  /** NAVIGATION_SENSOR_ID_CERULEAN_TRACKER_650 - Cerulean Tracker 650. */
457
548
  NAVIGATION_SENSOR_ID_CERULEAN_TRACKER_650 = 6,
549
+ /** NAVIGATION_SENSOR_ID_WATERLINKED_DVL_A100 - Water Linked DVL A100. */
550
+ NAVIGATION_SENSOR_ID_WATERLINKED_DVL_A100 = 7,
458
551
  UNRECOGNIZED = -1
459
552
  }
460
553
  export declare function navigationSensorIDFromJSON(object: any): NavigationSensorID;
461
554
  export declare function navigationSensorIDToJSON(object: NavigationSensorID): string;
555
+ /** Position fix mode reported by the NMEA GSA sentence. */
556
+ export declare enum GnssFixMode {
557
+ /** GNSS_FIX_MODE_UNSPECIFIED - No GSA sentence has been received. */
558
+ GNSS_FIX_MODE_UNSPECIFIED = 0,
559
+ /** GNSS_FIX_MODE_NO_FIX - The receiver has no position fix. */
560
+ GNSS_FIX_MODE_NO_FIX = 1,
561
+ /** GNSS_FIX_MODE_2D - Horizontal fix only, no usable altitude. */
562
+ GNSS_FIX_MODE_2D = 2,
563
+ /** GNSS_FIX_MODE_3D - Full three dimensional fix. */
564
+ GNSS_FIX_MODE_3D = 3,
565
+ UNRECOGNIZED = -1
566
+ }
567
+ export declare function gnssFixModeFromJSON(object: any): GnssFixMode;
568
+ export declare function gnssFixModeToJSON(object: GnssFixMode): string;
569
+ /** GNSS constellation a satellite belongs to. */
570
+ export declare enum GnssConstellation {
571
+ /** GNSS_CONSTELLATION_UNSPECIFIED - Unspecified. */
572
+ GNSS_CONSTELLATION_UNSPECIFIED = 0,
573
+ /** GNSS_CONSTELLATION_GPS - GPS. */
574
+ GNSS_CONSTELLATION_GPS = 1,
575
+ /** GNSS_CONSTELLATION_GLONASS - GLONASS. */
576
+ GNSS_CONSTELLATION_GLONASS = 2,
577
+ /** GNSS_CONSTELLATION_GALILEO - Galileo. */
578
+ GNSS_CONSTELLATION_GALILEO = 3,
579
+ /** GNSS_CONSTELLATION_BEIDOU - BeiDou. */
580
+ GNSS_CONSTELLATION_BEIDOU = 4,
581
+ UNRECOGNIZED = -1
582
+ }
583
+ export declare function gnssConstellationFromJSON(object: any): GnssConstellation;
584
+ export declare function gnssConstellationToJSON(object: GnssConstellation): string;
462
585
  /** Status for guest port devices that can be attached and detached. */
463
586
  export declare enum GuestPortDetachStatus {
464
587
  /** GUEST_PORT_DETACH_STATUS_UNSPECIFIED - Unspecified (Default for non-detachable devices). */
@@ -506,6 +629,48 @@ export declare enum MultibeamFrequencyMode {
506
629
  }
507
630
  export declare function multibeamFrequencyModeFromJSON(object: any): MultibeamFrequencyMode;
508
631
  export declare function multibeamFrequencyModeToJSON(object: MultibeamFrequencyMode): string;
632
+ /** Thermal zone identifiers. */
633
+ export declare enum ThermalZoneId {
634
+ /** THERMAL_ZONE_ID_UNSPECIFIED - Unspecified thermal zone. */
635
+ THERMAL_ZONE_ID_UNSPECIFIED = 0,
636
+ /** THERMAL_ZONE_ID_TJ - Junction temperature (Tj). */
637
+ THERMAL_ZONE_ID_TJ = 1,
638
+ /** THERMAL_ZONE_ID_CANISTER - Canister temperature. */
639
+ THERMAL_ZONE_ID_CANISTER = 2,
640
+ /** THERMAL_ZONE_ID_CPU - CPU thermal zone. */
641
+ THERMAL_ZONE_ID_CPU = 3,
642
+ /** THERMAL_ZONE_ID_GPU - GPU thermal zone. */
643
+ THERMAL_ZONE_ID_GPU = 4,
644
+ /** THERMAL_ZONE_ID_CV0 - Vision accelerator 0 thermal zone. */
645
+ THERMAL_ZONE_ID_CV0 = 5,
646
+ /** THERMAL_ZONE_ID_CV1 - Vision accelerator 1 thermal zone. */
647
+ THERMAL_ZONE_ID_CV1 = 6,
648
+ /** THERMAL_ZONE_ID_CV2 - Vision accelerator 2 thermal zone. */
649
+ THERMAL_ZONE_ID_CV2 = 7,
650
+ /** THERMAL_ZONE_ID_SOC0 - SoC 0 thermal zone. */
651
+ THERMAL_ZONE_ID_SOC0 = 8,
652
+ /** THERMAL_ZONE_ID_SOC1 - SoC 1 thermal zone. */
653
+ THERMAL_ZONE_ID_SOC1 = 9,
654
+ /** THERMAL_ZONE_ID_SOC2 - SoC 2 thermal zone. */
655
+ THERMAL_ZONE_ID_SOC2 = 10,
656
+ UNRECOGNIZED = -1
657
+ }
658
+ export declare function thermalZoneIdFromJSON(object: any): ThermalZoneId;
659
+ export declare function thermalZoneIdToJSON(object: ThermalZoneId): string;
660
+ /** Origin of an annotation. Mirrors the AnnotationSource enum in Blueye Cloud. */
661
+ export declare enum AnnotationSource {
662
+ /** ANNOTATION_SOURCE_UNSPECIFIED - Origin not specified. */
663
+ ANNOTATION_SOURCE_UNSPECIFIED = 0,
664
+ /** ANNOTATION_SOURCE_CLOUD - Created in Blueye Cloud after the dive. */
665
+ ANNOTATION_SOURCE_CLOUD = 1,
666
+ /** ANNOTATION_SOURCE_APP - Created in the app during the dive. */
667
+ ANNOTATION_SOURCE_APP = 2,
668
+ /** ANNOTATION_SOURCE_DRONE - Emitted by the drone itself. */
669
+ ANNOTATION_SOURCE_DRONE = 3,
670
+ UNRECOGNIZED = -1
671
+ }
672
+ export declare function annotationSourceFromJSON(object: any): AnnotationSource;
673
+ export declare function annotationSourceToJSON(object: AnnotationSource): string;
509
674
  /**
510
675
  * Wrapper message for each entry in the drone telemetry logfile.
511
676
  *
@@ -617,7 +782,7 @@ export interface MotionInput {
617
782
  roll: number;
618
783
  /** Pitch down (negative) or up (positive). (-1..1). */
619
784
  pitch: number;
620
- /** Left (positive) and right (negative) movement (-1..1). */
785
+ /** Clockwise (positive) and counter-clockwise (negative) rotation (-1..1). */
621
786
  yaw: number;
622
787
  /** Modifier used to reduce the speed of the motion (0..1). */
623
788
  slow: number;
@@ -639,6 +804,46 @@ export interface Lights {
639
804
  export interface Laser {
640
805
  /** Laser intensity, any value above 0 turns the laser on (0..1). */
641
806
  value: number;
807
+ /** Modulate the laser at 5Hz for tracking. Only available on Ultra. */
808
+ modulated: boolean;
809
+ }
810
+ /** Point in 2D space. */
811
+ export interface Point2D {
812
+ /** X coordinate of the point (px). */
813
+ x: number;
814
+ /** Y coordinate of the point (px). */
815
+ y: number;
816
+ }
817
+ /**
818
+ * Message representing the detection of scaling lasers in the main camera.
819
+ *
820
+ * The message contains the centroids of the detected dots, the distance between them in pixels,
821
+ * and the confidence of the detection. The dots are detected through temporal DFT analysis of
822
+ * 5 Hz laser modulation, isolating flickering pixels from the static scene background.
823
+ *
824
+ * Only available on Ultra.
825
+ */
826
+ export interface LaserDetection {
827
+ /** True if the laser is detected by the drone. */
828
+ detected: boolean;
829
+ /** First dot centroid (leftmost). */
830
+ dot1: Point2D | undefined;
831
+ /** Second dot centroid (rightmost). */
832
+ dot2: Point2D | undefined;
833
+ /** Distance between dots in pixels. */
834
+ pixelDistance: number;
835
+ /** Confidence of the detection (0..1). */
836
+ confidence: number;
837
+ /** Source frame width. */
838
+ imageWidth: number;
839
+ /** Source frame height. */
840
+ imageHeight: number;
841
+ /** Real world distance between the two laser dots (m). */
842
+ laserWidth: number;
843
+ /** Distance after lens undistortion (px). */
844
+ correctedPixelDistance: number;
845
+ /** Estimated subject distance (m). */
846
+ estimatedDistance: number;
642
847
  }
643
848
  /** Latitude and longitude position in WGS 84 decimal degrees format. */
644
849
  export interface LatLongPosition {
@@ -687,6 +892,66 @@ export interface AutoPilotHeaveState {
687
892
  /** If auto pilot heave is enabled. */
688
893
  enabled: boolean;
689
894
  }
895
+ /**
896
+ * Spotlight mode parameters.
897
+ *
898
+ * Vision-based mode that keeps the tracked object centred in the frame
899
+ * while the pilot flies around it. Currently carries no parameters.
900
+ *
901
+ * Automatically controlled: yaw (horizontal centring) and depth
902
+ * (vertical centring).
903
+ * Pilot controlled: surge and sway.
904
+ */
905
+ export interface SpotlightState {
906
+ }
907
+ /**
908
+ * Active track mode parameters.
909
+ *
910
+ * Vision-based mode that follows the tracked object, keeping it centred
911
+ * and at a constant apparent size in the frame. Currently carries no
912
+ * parameters.
913
+ *
914
+ * Automatically controlled: yaw (horizontal centring), depth (vertical
915
+ * centring), and surge (distance keeping).
916
+ * Pilot controlled: sway.
917
+ */
918
+ export interface ActiveTrackState {
919
+ }
920
+ /**
921
+ * Orbit mode parameters.
922
+ *
923
+ * Vision-based mode that circles the tracked object while keeping it
924
+ * centred in the frame.
925
+ *
926
+ * Automatically controlled: yaw (horizontal centring), depth (vertical
927
+ * centring), surge (distance keeping), and sway (tangential motion at
928
+ * the commanded angular rate). No degree of freedom is pilot controlled
929
+ * while orbit is active.
930
+ */
931
+ export interface OrbitState {
932
+ /** Orbit angular rate (deg/s); positive orbits clockwise seen from above. Must be non-zero. */
933
+ rate: number;
934
+ }
935
+ /**
936
+ * The active vision-based tracking mode.
937
+ *
938
+ * The modes are mutually exclusive, which the oneof encodes: at most one
939
+ * mode is set at a time, and no field set means no vision tracking mode
940
+ * is active.
941
+ *
942
+ * Each mode's message documents which degrees of freedom it controls
943
+ * automatically; any degree of freedom not listed as automatic remains
944
+ * under pilot control. Pilot input on an automatically controlled degree
945
+ * of freedom is ignored while the mode is active.
946
+ */
947
+ export interface VisionTrackingState {
948
+ /** Spotlight mode is active. */
949
+ spotlight?: SpotlightState | undefined;
950
+ /** Active track mode is active. */
951
+ activeTrack?: ActiveTrackState | undefined;
952
+ /** Orbit mode is active, at the reported angular rate. */
953
+ orbit?: OrbitState | undefined;
954
+ }
690
955
  /** Control mode from drone supervisor */
691
956
  export interface ControlMode {
692
957
  /** If auto depth is enabled. */
@@ -703,6 +968,8 @@ export interface ControlMode {
703
968
  autoPilotSurgeYaw: boolean;
704
969
  /** If auto pilot heave is enabled. */
705
970
  autoPilotHeave: boolean;
971
+ /** The active vision-based tracking mode, if any. */
972
+ visionTracking: VisionTrackingState | undefined;
706
973
  }
707
974
  /**
708
975
  * Tilt stabilization state.
@@ -774,8 +1041,12 @@ export interface RecordState {
774
1041
  multibeamSeconds: number;
775
1042
  /** Multibeam record fps. */
776
1043
  multibeamFps: number;
777
- /** Storage location used for recording. */
778
- storageLocation: StorageLocation;
1044
+ /** Storage location used for main camera recording. */
1045
+ mainStorageLocation: StorageLocation;
1046
+ /** Storage location used for guestport camera recording. */
1047
+ guestportStorageLocation: StorageLocation;
1048
+ /** Storage location used for multibeam recording. */
1049
+ multibeamStorageLocation: StorageLocation;
779
1050
  }
780
1051
  /** Time-lapse state published if time-lapse mission is running. */
781
1052
  export interface TimeLapseState {
@@ -821,7 +1092,7 @@ export interface WaterTemperature {
821
1092
  /** Water temperature (°C). */
822
1093
  value: number;
823
1094
  }
824
- /** CPU temperature. */
1095
+ /** CPU temperature (deprecated, use SystemPerformanceInfo.thermal_zones instead). */
825
1096
  export interface CPUTemperature {
826
1097
  /** CPU temperature (°C). */
827
1098
  value: number;
@@ -1269,6 +1540,8 @@ export interface StoragePartition {
1269
1540
  devicePath: string;
1270
1541
  /** Mount path of the partition. */
1271
1542
  mountPath: string;
1543
+ /** Label of the partition. */
1544
+ label: string;
1272
1545
  }
1273
1546
  /** Removable storage device. */
1274
1547
  export interface RemovableStorageDevice {
@@ -1291,10 +1564,12 @@ export declare enum RemovableStorageDevice_Status {
1291
1564
  STATUS_UNSPECIFIED = 0,
1292
1565
  /** STATUS_READY - The storage device is valid and ready for use. */
1293
1566
  STATUS_READY = 1,
1294
- /** STATUS_FORMATTING - The storage device is being formatted */
1567
+ /** STATUS_FORMATTING - The storage device is being formatted. */
1295
1568
  STATUS_FORMATTING = 2,
1296
1569
  /** STATUS_ERROR - The storage device is in an error state. */
1297
1570
  STATUS_ERROR = 3,
1571
+ /** STATUS_UNPLUGGED - The storage device is not present. */
1572
+ STATUS_UNPLUGGED = 4,
1298
1573
  UNRECOGNIZED = -1
1299
1574
  }
1300
1575
  export declare function removableStorageDevice_StatusFromJSON(object: any): RemovableStorageDevice_Status;
@@ -1390,6 +1665,77 @@ export interface TiltVelocity {
1390
1665
  /**
1391
1666
  * Information about the drone.
1392
1667
  *
1668
+ * Information about a loaded computer vision model.
1669
+ */
1670
+ export interface CvModelInfo {
1671
+ /** Human-readable model name (from model_meta.json). */
1672
+ name: string;
1673
+ /** Type of CV model. */
1674
+ type: CvModelInfo_ModelType;
1675
+ /** Whether the model is currently running. */
1676
+ running: boolean;
1677
+ /** Execution provider (e.g. "cuda", "tensorrt"). */
1678
+ device: string;
1679
+ /** Package directory name (e.g. "tinyyolov2_package"). Stable identifier. */
1680
+ packageId: string;
1681
+ /** Class names the model can detect (indexed by class_id). */
1682
+ labels: string[];
1683
+ /** Runtime state. SOT models report IDLE/TRACKING/LOST instead of RUNNING. */
1684
+ state: CvModelInfo_State;
1685
+ }
1686
+ export declare enum CvModelInfo_ModelType {
1687
+ MODEL_TYPE_UNSPECIFIED = 0,
1688
+ MODEL_TYPE_DETECTION = 1,
1689
+ MODEL_TYPE_SOT = 2,
1690
+ UNRECOGNIZED = -1
1691
+ }
1692
+ export declare function cvModelInfo_ModelTypeFromJSON(object: any): CvModelInfo_ModelType;
1693
+ export declare function cvModelInfo_ModelTypeToJSON(object: CvModelInfo_ModelType): string;
1694
+ /** Runtime state of a computer vision model. */
1695
+ export declare enum CvModelInfo_State {
1696
+ /** STATE_UNSPECIFIED - State unknown / not reported. */
1697
+ STATE_UNSPECIFIED = 0,
1698
+ /** STATE_STOPPED - The model is not running. */
1699
+ STATE_STOPPED = 1,
1700
+ /** STATE_RUNNING - The model is running (detection models). */
1701
+ STATE_RUNNING = 2,
1702
+ /** STATE_IDLE - The SOT model is running with no target selected. */
1703
+ STATE_IDLE = 3,
1704
+ /** STATE_TRACKING - The SOT model is actively tracking a target. */
1705
+ STATE_TRACKING = 4,
1706
+ /** STATE_LOST - The SOT model lost the target it was tracking. */
1707
+ STATE_LOST = 5,
1708
+ UNRECOGNIZED = -1
1709
+ }
1710
+ export declare function cvModelInfo_StateFromJSON(object: any): CvModelInfo_State;
1711
+ export declare function cvModelInfo_StateToJSON(object: CvModelInfo_State): string;
1712
+ /**
1713
+ * Camera intrinsic calibration (pinhole model with OpenCV distortion coefficients).
1714
+ *
1715
+ * All values are in pixels at the calibration resolution (image_width x image_height).
1716
+ * When applying the calibration to an image of a different resolution, scale fx and cx
1717
+ * by the width ratio and fy and cy by the height ratio; the distortion coefficients
1718
+ * are resolution independent.
1719
+ */
1720
+ export interface CameraCalibration {
1721
+ /** Focal length x (pixels). */
1722
+ fx: number;
1723
+ /** Focal length y (pixels). */
1724
+ fy: number;
1725
+ /** Principal point x (pixels). */
1726
+ cx: number;
1727
+ /** Principal point y (pixels). */
1728
+ cy: number;
1729
+ /** OpenCV order: k1, k2, p1, p2, k3. */
1730
+ distortionCoefficients: number[];
1731
+ /** Image width (pixels) the calibration was computed at. */
1732
+ imageWidth: number;
1733
+ /** Image height (pixels) the calibration was computed at. */
1734
+ imageHeight: number;
1735
+ /** True when this is the built-in default, not a per-drone calibration. */
1736
+ isDefault: boolean;
1737
+ }
1738
+ /**
1393
1739
  * This message contains serial numbers and version information for
1394
1740
  * internal components in the drone. Primarily used for diagnostics, or to
1395
1741
  * determine the origin of a logfile.
@@ -1417,6 +1763,12 @@ export interface DroneInfo {
1417
1763
  gp: GuestPortInfo | undefined;
1418
1764
  /** Type of depth sensor that is connected to the drone. */
1419
1765
  depthSensor: PressureSensorType;
1766
+ /** Installed computer vision models, including models that are not running. */
1767
+ cvModels: CvModelInfo[];
1768
+ /** How the drone is powered. */
1769
+ powerSource: PowerSource;
1770
+ /** Intrinsic calibration of the main camera. Unset when unknown. */
1771
+ mainCameraCalibration: CameraCalibration | undefined;
1420
1772
  }
1421
1773
  /** Known error states for the drone. */
1422
1774
  export interface ErrorFlags {
@@ -1442,30 +1794,72 @@ export interface ErrorFlags {
1442
1794
  gp2Read: boolean;
1443
1795
  /** Guest port 3 read error. */
1444
1796
  gp3Read: boolean;
1797
+ /** Guest port 4 read error. */
1798
+ gp4Read: boolean;
1799
+ /** Guest port 5 read error. */
1800
+ gp5Read: boolean;
1801
+ /** Guest port 6 read error. */
1802
+ gp6Read: boolean;
1445
1803
  /** Guest port 1 not flashed. */
1446
1804
  gp1NotFlashed: boolean;
1447
1805
  /** Guest port 2 not flashed. */
1448
1806
  gp2NotFlashed: boolean;
1449
1807
  /** Guest port 3 not flashed. */
1450
1808
  gp3NotFlashed: boolean;
1809
+ /** Guest port 4 not flashed. */
1810
+ gp4NotFlashed: boolean;
1811
+ /** Guest port 5 not flashed. */
1812
+ gp5NotFlashed: boolean;
1813
+ /** Guest port 6 not flashed. */
1814
+ gp6NotFlashed: boolean;
1451
1815
  /** Unknown device on guest port 1. */
1452
1816
  gp1UnknownDevice: boolean;
1453
1817
  /** Unknown device on guest port 2. */
1454
1818
  gp2UnknownDevice: boolean;
1455
1819
  /** Unknown device on guest port 3. */
1456
1820
  gp3UnknownDevice: boolean;
1821
+ /** Unknown device on guest port 4. */
1822
+ gp4UnknownDevice: boolean;
1823
+ /** Unknown device on guest port 5. */
1824
+ gp5UnknownDevice: boolean;
1825
+ /** Unknown device on guest port 6. */
1826
+ gp6UnknownDevice: boolean;
1457
1827
  /** Guest port 1 connection error. */
1458
1828
  gp1DeviceConnection: boolean;
1459
1829
  /** Guest port 2 connection error. */
1460
1830
  gp2DeviceConnection: boolean;
1461
1831
  /** Guest port 3 connection error. */
1462
1832
  gp3DeviceConnection: boolean;
1833
+ /** Guest port 4 connection error. */
1834
+ gp4DeviceConnection: boolean;
1835
+ /** Guest port 5 connection error. */
1836
+ gp5DeviceConnection: boolean;
1837
+ /** Guest port 6 connection error. */
1838
+ gp6DeviceConnection: boolean;
1463
1839
  /** Guest port 1 device error. */
1464
1840
  gp1Device: boolean;
1465
1841
  /** Guest port 2 device error. */
1466
1842
  gp2Device: boolean;
1467
1843
  /** Guest port 3 device error. */
1468
1844
  gp3Device: boolean;
1845
+ /** Guest port 4 device error. */
1846
+ gp4Device: boolean;
1847
+ /** Guest port 5 device error. */
1848
+ gp5Device: boolean;
1849
+ /** Guest port 6 device error. */
1850
+ gp6Device: boolean;
1851
+ /** Device on guest port 1 requires interfaces the port does not provide. */
1852
+ gp1IncompatibleDevice: boolean;
1853
+ /** Device on guest port 2 requires interfaces the port does not provide. */
1854
+ gp2IncompatibleDevice: boolean;
1855
+ /** Device on guest port 3 requires interfaces the port does not provide. */
1856
+ gp3IncompatibleDevice: boolean;
1857
+ /** Device on guest port 4 requires interfaces the port does not provide. */
1858
+ gp4IncompatibleDevice: boolean;
1859
+ /** Device on guest port 5 requires interfaces the port does not provide. */
1860
+ gp5IncompatibleDevice: boolean;
1861
+ /** Device on guest port 6 requires interfaces the port does not provide. */
1862
+ gp6IncompatibleDevice: boolean;
1469
1863
  /** Drone serial number not set. */
1470
1864
  droneSerialNotSet: boolean;
1471
1865
  /** Drone serial number error. */
@@ -1496,14 +1890,44 @@ export interface ErrorFlags {
1496
1890
  gpCurrentRead: boolean;
1497
1891
  /** Max GP current exceeded. */
1498
1892
  gpCurrent: boolean;
1499
- /** Max battery current exceeded on GP1. */
1893
+ /** Max battery current exceeded on guest port 1. */
1500
1894
  gp1BatCurrent: boolean;
1501
- /** Max battery current exceeded on GP2. */
1895
+ /** Max battery current exceeded on guest port 2. */
1502
1896
  gp2BatCurrent: boolean;
1503
- /** Max battery current exceeded on GP3. */
1897
+ /** Max battery current exceeded on guest port 3. */
1504
1898
  gp3BatCurrent: boolean;
1505
- /** Max 20V current exceeded on GP. */
1506
- gp20vCurrent: boolean;
1899
+ /** Max battery current exceeded on guest port 4. */
1900
+ gp4BatCurrent: boolean;
1901
+ /** Max battery current exceeded on guest port 5. */
1902
+ gp5BatCurrent: boolean;
1903
+ /** Max battery current exceeded on guest port 6. */
1904
+ gp6BatCurrent: boolean;
1905
+ /** Max 24V current exceeded on GP. Only present on X1/X3 (not X3 Ultra or X7). */
1906
+ gp24vCurrent: boolean;
1907
+ /** Max 24V current exceeded on guest port 1. */
1908
+ gp124vCurrent: boolean;
1909
+ /** Max 24V current exceeded on guest port 2. */
1910
+ gp224vCurrent: boolean;
1911
+ /** Max 24V current exceeded on guest port 3. */
1912
+ gp324vCurrent: boolean;
1913
+ /** Max 24V current exceeded on guest port 4. */
1914
+ gp424vCurrent: boolean;
1915
+ /** Max 24V current exceeded on guest port 5. */
1916
+ gp524vCurrent: boolean;
1917
+ /** Max 24V current exceeded on guest port 6. */
1918
+ gp624vCurrent: boolean;
1919
+ /** Max 5V current exceeded on guest port 1. */
1920
+ gp15vCurrent: boolean;
1921
+ /** Max 5V current exceeded on guest port 2. */
1922
+ gp25vCurrent: boolean;
1923
+ /** Max 5V current exceeded on guest port 3. */
1924
+ gp35vCurrent: boolean;
1925
+ /** Max 5V current exceeded on guest port 4. */
1926
+ gp45vCurrent: boolean;
1927
+ /** Max 5V current exceeded on guest port 5. */
1928
+ gp55vCurrent: boolean;
1929
+ /** Max 5V current exceeded on guest port 6. */
1930
+ gp65vCurrent: boolean;
1507
1931
  /** DVL is in thermal protection mode. */
1508
1932
  dvlThermalProtectionMode: boolean;
1509
1933
  /** GP protection has been triggered at boot or faulty DVL. */
@@ -1561,6 +1985,19 @@ export interface CameraParameters {
1561
1985
  framerate: Framerate;
1562
1986
  /** Which camera the parameters belong to. */
1563
1987
  camera: Camera;
1988
+ /**
1989
+ * Network MTU (Maximum Transmission Unit) size for video streaming in bytes (68..65535).
1990
+ * If 0 or unset, the system will use a default of 1400.
1991
+ * The Blueye App allows users to set values between 500 and 1460.
1992
+ */
1993
+ mtuSize: number;
1994
+ /** Recording video codec. If unset, uses platform default. */
1995
+ recordingCodec: RecordingCodec;
1996
+ /**
1997
+ * Recording bitrate in bits/sec. If 0 or unset, a default is computed based
1998
+ * on resolution, framerate, and encoding. Set explicitly to override.
1999
+ */
2000
+ recordingBitrate: number;
1564
2001
  }
1565
2002
  /**
1566
2003
  * Overlay parameters.
@@ -1634,6 +2071,86 @@ export interface NavigationSensorStatus {
1634
2071
  /** Global position from sensor. */
1635
2072
  globalPosition: LatLongPosition | undefined;
1636
2073
  }
2074
+ /** Satellite tracked by the Blueye GNSS receiver. */
2075
+ export interface GnssSatellite {
2076
+ /** Constellation the satellite belongs to. */
2077
+ constellation: GnssConstellation;
2078
+ /** Satellite id within the constellation. */
2079
+ satelliteId: number;
2080
+ /** Carrier to noise ratio (dB-Hz). */
2081
+ snr: number;
2082
+ /** Elevation above the horizon (°, 0..90), or -1 when the receiver did not report it. */
2083
+ elevation: number;
2084
+ /** Azimuth clockwise from true north (°, 0..359), or -1 when the receiver did not report it. */
2085
+ azimuth: number;
2086
+ /** Whether GSA lists the satellite as used in the fix. Only meaningful if is_used_in_fix_valid. */
2087
+ usedInFix: boolean;
2088
+ }
2089
+ /** Status of the onboard Blueye GNSS receiver and its driver. */
2090
+ export interface GnssStatus {
2091
+ /** True when the receiver is connected and producing NMEA sentences. */
2092
+ receiverConnected: boolean;
2093
+ /** NMEA GGA fix quality indicator (0 = no fix). */
2094
+ fixQuality: number;
2095
+ /** True when the receiver reports a usable position fix. */
2096
+ isValid: boolean;
2097
+ /** Number of satellites used in the position fix. */
2098
+ satellitesUsed: number;
2099
+ /** Satellites in the satellites list: those with a signal, seen within the last 30 s. */
2100
+ satellitesTracked: number;
2101
+ /** Satellites the receiver reports in view, summed over the constellations. */
2102
+ satellitesInView: number;
2103
+ /** True when GSA could be attributed to a constellation, making used_in_fix usable. */
2104
+ isUsedInFixValid: boolean;
2105
+ /** Fix mode from GSA (2D/3D). */
2106
+ fixMode: GnssFixMode;
2107
+ /** Horizontal dilution of precision. */
2108
+ hdop: number;
2109
+ /** Position (3D) dilution of precision, from GSA. */
2110
+ pdop: number;
2111
+ /** Vertical dilution of precision, from GSA. */
2112
+ vdop: number;
2113
+ /** Reported global position. */
2114
+ globalPosition: LatLongPosition | undefined;
2115
+ /** Altitude above mean sea level (m), from GGA. */
2116
+ altitude: number;
2117
+ /** Standard deviation of the latitude (m). Meaningless unless is_accuracy_valid. */
2118
+ stddevLatitude: number;
2119
+ /** Standard deviation of the longitude (m). Meaningless unless is_accuracy_valid. */
2120
+ stddevLongitude: number;
2121
+ /** Standard deviation of the altitude (m). Meaningless unless is_accuracy_valid. */
2122
+ stddevAltitude: number;
2123
+ /** Semi-major axis of the horizontal error ellipse (m). */
2124
+ stddevSemiMajor: number;
2125
+ /** Semi-minor axis of the horizontal error ellipse (m). */
2126
+ stddevSemiMinor: number;
2127
+ /** Orientation of the semi-major axis, clockwise from true north (°). */
2128
+ errorEllipseOrientation: number;
2129
+ /** RMS of the range residuals (m), from GST. */
2130
+ rangeRms: number;
2131
+ /** True once the receiver has reported a GST sentence to derive the deviations from. */
2132
+ isAccuracyValid: boolean;
2133
+ /** Course over ground (°). Meaningless unless is_course_valid. */
2134
+ courseOverGround: number;
2135
+ /** True when the fix is valid and the receiver actually reported a course. */
2136
+ isCourseValid: boolean;
2137
+ /** Speed over ground (m/s). */
2138
+ speedOverGround: number;
2139
+ /** Age of the differential corrections (s), or -1 without DGPS/RTK. */
2140
+ differentialAge: number;
2141
+ /** Id of the station supplying the differential corrections, or -1 when absent. */
2142
+ differentialStation: number;
2143
+ /** Serial baud rate in use (bit/s). */
2144
+ baudRate: number;
2145
+ /** Times the driver has reconnected to the receiver since boot. */
2146
+ reconnectCount: number;
2147
+ /** Receive errors seen by the driver since boot. */
2148
+ receiveErrorCount: number;
2149
+ /** Time since the last NMEA sentence was received (s). */
2150
+ timeSinceLastSentence: number;
2151
+ /** Satellites currently tracked with signal strength. */
2152
+ satellites: GnssSatellite[];
2153
+ }
1637
2154
  /** Information about a device connected to one of the guest ports. */
1638
2155
  export interface GuestPortDevice {
1639
2156
  /** Blueye device identifier. */
@@ -1650,6 +2167,13 @@ export interface GuestPortDevice {
1650
2167
  requiredBlunuxVersion: string;
1651
2168
  /** Detach status based on detection pin. */
1652
2169
  detachStatus: GuestPortDetachStatus;
2170
+ /** Interfaces the device requires from the port. */
2171
+ requiredCapabilities: GuestPortCapability[];
2172
+ /**
2173
+ * Ports on this drone where the device is fully supported. Computed by the
2174
+ * drone from the port capabilities and the device requirements.
2175
+ */
2176
+ compatibleGuestPorts: GuestPortNumber[];
1653
2177
  }
1654
2178
  /** List of guest port devices. */
1655
2179
  export interface GuestPortDeviceList {
@@ -1664,6 +2188,8 @@ export interface GuestPortConnectorInfo {
1664
2188
  error?: GuestPortError | undefined;
1665
2189
  /** Guest port the connector is connected to. */
1666
2190
  guestPortNumber: GuestPortNumber;
2191
+ /** Interfaces this port provides. */
2192
+ capabilities: GuestPortCapability[];
1667
2193
  }
1668
2194
  /** GuestPort information. */
1669
2195
  export interface GuestPortInfo {
@@ -1673,6 +2199,12 @@ export interface GuestPortInfo {
1673
2199
  gp2: GuestPortConnectorInfo | undefined;
1674
2200
  /** Information about guest port 3. */
1675
2201
  gp3: GuestPortConnectorInfo | undefined;
2202
+ /** Information about guest port 4. */
2203
+ gp4: GuestPortConnectorInfo | undefined;
2204
+ /** Information about guest port 5. */
2205
+ gp5: GuestPortConnectorInfo | undefined;
2206
+ /** Information about guest port 6. */
2207
+ gp6: GuestPortConnectorInfo | undefined;
1676
2208
  }
1677
2209
  /** GuestPort restart information. */
1678
2210
  export interface GuestPortRestartInfo {
@@ -1717,8 +2249,38 @@ export interface GuestPortCurrent {
1717
2249
  gp2Bat: number;
1718
2250
  /** Current on GP3 battery voltage (A). */
1719
2251
  gp3Bat: number;
1720
- /** Current on common 20V supply (A). */
1721
- gp20v: number;
2252
+ /** Current on common/input 24V supply (A). Only present on X1/X3 (not X3 Ultra or X7). */
2253
+ gp24v: number;
2254
+ /** Current on GP4 battery voltage (A). */
2255
+ gp4Bat: number;
2256
+ /** Current on GP5 battery voltage (A). */
2257
+ gp5Bat: number;
2258
+ /** Current on GP6 battery voltage (A). */
2259
+ gp6Bat: number;
2260
+ /** Current on GP1 24V supply (A). */
2261
+ gp124v: number;
2262
+ /** Current on GP2 24V supply (A). */
2263
+ gp224v: number;
2264
+ /** Current on GP3 24V supply (A). */
2265
+ gp324v: number;
2266
+ /** Current on GP4 24V supply (A). */
2267
+ gp424v: number;
2268
+ /** Current on GP5 24V supply (A). */
2269
+ gp524v: number;
2270
+ /** Current on GP6 24V supply (A). */
2271
+ gp624v: number;
2272
+ /** Current on GP1 5V supply (A). */
2273
+ gp15v: number;
2274
+ /** Current on GP2 5V supply (A). */
2275
+ gp25v: number;
2276
+ /** Current on GP3 5V supply (A). */
2277
+ gp35v: number;
2278
+ /** Current on GP4 5V supply (A). */
2279
+ gp45v: number;
2280
+ /** Current on GP5 5V supply (A). */
2281
+ gp55v: number;
2282
+ /** Current on GP6 5V supply (A). */
2283
+ gp65v: number;
1722
2284
  }
1723
2285
  /** Vector with 3 elements. */
1724
2286
  export interface Vector3 {
@@ -1786,8 +2348,7 @@ export interface MultibeamPing {
1786
2348
  /** Size in bytes of each row in the ping data image. */
1787
2349
  step: number;
1788
2350
  /**
1789
- * Bearing angle of each column of the sonar data
1790
- * (in 100th of a degree, multiply by 0.01 to get a value in degrees).
2351
+ * Bearing angle of each column of the sonar data in degrees.
1791
2352
  * The sonar image is not sampled uniformly in the bearing direction.
1792
2353
  */
1793
2354
  bearings: number[];
@@ -1797,6 +2358,16 @@ export interface MultibeamPing {
1797
2358
  deviceId: GuestPortDeviceID;
1798
2359
  /** Timestamp when the frame was generated. */
1799
2360
  frameGenerationTimestamp: Date | undefined;
2361
+ /** Heading (°). */
2362
+ heading: number;
2363
+ /** Pitch (°). */
2364
+ pitch: number;
2365
+ /** Roll (°). */
2366
+ roll: number;
2367
+ /** External temperature (°C). */
2368
+ temperature: number;
2369
+ /** External pressure (bar). */
2370
+ pressure: number;
1800
2371
  }
1801
2372
  /** Configuration message for sonar devices. */
1802
2373
  export interface MultibeamConfig {
@@ -1927,7 +2498,7 @@ export interface PersistentStorageSettings {
1927
2498
  accCalibration: boolean;
1928
2499
  }
1929
2500
  /**
1930
- * CPU information.
2501
+ * CPU information (deprecated, use SystemPerformanceInfo instead).
1931
2502
  *
1932
2503
  * Contains information about the CPU load and memory usage of the drone.
1933
2504
  */
@@ -1943,6 +2514,186 @@ export interface CPUInfo {
1943
2514
  /** Communication queue load (0..1). */
1944
2515
  commQueueLoad: number;
1945
2516
  }
2517
+ /** Per-core CPU utilization. */
2518
+ export interface CpuCoreLoad {
2519
+ /** Core index (0-based). */
2520
+ coreIndex: number;
2521
+ /** Core load (0..1). */
2522
+ load: number;
2523
+ /** Current clock frequency (MHz). */
2524
+ frequencyMhz: number;
2525
+ }
2526
+ /** GPU utilization and status. */
2527
+ export interface GpuInfo {
2528
+ /** GPU load (0..1). */
2529
+ load: number;
2530
+ /** Current GPU clock frequency (MHz). */
2531
+ frequencyMhz: number;
2532
+ }
2533
+ /**
2534
+ * Deep Learning Accelerator (DLA) utilization.
2535
+ *
2536
+ * Jetson Orin NX has two DLA engines used for inference offload.
2537
+ */
2538
+ export interface DlaInfo {
2539
+ /** DLA engine index (0-based). */
2540
+ engineIndex: number;
2541
+ /** DLA engine load (0..1). */
2542
+ load: number;
2543
+ /** Core clock frequency (MHz). 0 when disabled. */
2544
+ frequencyMhz: number;
2545
+ /** True when the DLA engine is actively processing. */
2546
+ enabled: boolean;
2547
+ /** Falcon microcontroller clock frequency (MHz). 0 when disabled. */
2548
+ falconFrequencyMhz: number;
2549
+ }
2550
+ /** System memory information. */
2551
+ export interface MemoryInfo {
2552
+ /** Total RAM (bytes). */
2553
+ totalBytes: number;
2554
+ /** Used RAM (bytes). */
2555
+ usedBytes: number;
2556
+ /** Cached RAM (bytes). */
2557
+ cachedBytes: number;
2558
+ /** Memory bus utilization (0..1). i.MX only. */
2559
+ busLoad: number;
2560
+ }
2561
+ /** Thermal zone reading. */
2562
+ export interface ThermalZone {
2563
+ /** Thermal zone identifier. */
2564
+ zone: ThermalZoneId;
2565
+ /** Temperature (°C). */
2566
+ temperature: number;
2567
+ }
2568
+ /** Video codec engine status. */
2569
+ export interface VideoCodecInfo {
2570
+ /** Jetson only (NVENC/NVDEC/NVJPG/VIC devfreq). */
2571
+ encoderActive: boolean;
2572
+ /** Video encoder clock frequency (MHz). */
2573
+ encoderFrequencyMhz: number;
2574
+ /** Video decoder (NVDEC) is active. */
2575
+ decoderActive: boolean;
2576
+ /** Video decoder clock frequency (MHz). */
2577
+ decoderFrequencyMhz: number;
2578
+ /** JPEG engine (NVJPG) is active. */
2579
+ nvjpgActive: boolean;
2580
+ /** JPEG engine clock frequency (MHz). */
2581
+ nvjpgFrequencyMhz: number;
2582
+ /** Video Image Compositor (VIC) is active. */
2583
+ vicActive: boolean;
2584
+ /** VIC clock frequency (MHz). */
2585
+ vicFrequencyMhz: number;
2586
+ /** i.MX only (CODA VPU). */
2587
+ vpuActive: boolean;
2588
+ /** VPU AXI clock frequency (MHz). */
2589
+ vpuFrequencyMhz: number;
2590
+ /** Cumulative VPU_CODEC_IRQ count. */
2591
+ vpuCodecIrqCount: number;
2592
+ /** Cumulative VPU_JPG_IRQ count. */
2593
+ vpuJpgIrqCount: number;
2594
+ /** Jetson only (host1x actmon engine utilization, 0..1). */
2595
+ encoderLoad: number;
2596
+ /** Video decoder (NVDEC) utilization (0..1). */
2597
+ decoderLoad: number;
2598
+ /** JPEG engine (NVJPG) utilization (0..1). */
2599
+ nvjpgLoad: number;
2600
+ /** Video Image Compositor (VIC) utilization (0..1). */
2601
+ vicLoad: number;
2602
+ }
2603
+ /**
2604
+ * NVMe SSD health, wear and identity (Jetson only; i.MX drones boot/store on
2605
+ * an SD card and have no NVMe device, so this message is omitted there).
2606
+ */
2607
+ export interface NvmeInfo {
2608
+ /** Tier 1 — health & safety. */
2609
+ compositeTemperature: number;
2610
+ /** NVMe critical-warning bitfield. */
2611
+ criticalWarning: number;
2612
+ /** Wear indicator (%, may exceed 100). */
2613
+ percentageUsed: number;
2614
+ /** Remaining spare capacity (%). */
2615
+ availableSpare: number;
2616
+ /** Spare alarm threshold (%). */
2617
+ availableSpareThreshold: number;
2618
+ /** Uncorrected data-integrity errors. */
2619
+ mediaErrors: number;
2620
+ /** Power-loss / unsafe shutdown count. */
2621
+ unsafeShutdowns: number;
2622
+ /** Tier 2 — thermal throttling. */
2623
+ warningTempTimeMin: number;
2624
+ /** Minutes above the critical temperature. */
2625
+ criticalTempTimeMin: number;
2626
+ /** Times entered light throttling. */
2627
+ thermalMgmtT1TransCount: number;
2628
+ /** Times entered heavy throttling. */
2629
+ thermalMgmtT2TransCount: number;
2630
+ /** Total seconds in light throttling. */
2631
+ thermalMgmtT1TotalTimeS: number;
2632
+ /** Total seconds in heavy throttling. */
2633
+ thermalMgmtT2TotalTimeS: number;
2634
+ /** Tier 3 — endurance / workload. */
2635
+ dataUnitsWrittenBytes: number;
2636
+ /** Host data read (B). */
2637
+ dataUnitsReadBytes: number;
2638
+ /** Host write command count. */
2639
+ hostWriteCommands: number;
2640
+ /** Host read command count. */
2641
+ hostReadCommands: number;
2642
+ /** Power-on hours. */
2643
+ powerOnHours: number;
2644
+ /** Power cycle count. */
2645
+ powerCycles: number;
2646
+ /** Controller busy time (min). */
2647
+ controllerBusyTimeMin: number;
2648
+ /** Error-log entry count. */
2649
+ numErrLogEntries: number;
2650
+ /** Tier 4 — identity & capacity. */
2651
+ model: string;
2652
+ /** Drive serial number. */
2653
+ serial: string;
2654
+ /** Firmware revision. */
2655
+ firmwareRev: string;
2656
+ /** Total drive capacity (B). Partition used/free is */
2657
+ capacityBytes: number;
2658
+ }
2659
+ /**
2660
+ * System performance information.
2661
+ *
2662
+ * Comprehensive performance metrics for the drone's compute platform.
2663
+ * Covers CPU, GPU, DLA, memory, thermals, video codec utilization and NVMe
2664
+ * SSD state. Fields not applicable to a platform are left at their
2665
+ * zero/empty defaults.
2666
+ */
2667
+ export interface SystemPerformanceInfo {
2668
+ /** Per-core CPU utilization. */
2669
+ cpuCores: CpuCoreLoad[];
2670
+ /** Mean CPU utilization across all cores (0..1). */
2671
+ cpuUtilization: number;
2672
+ /** GPU utilization. */
2673
+ gpu: GpuInfo | undefined;
2674
+ /** DLA engine utilization (Jetson only). */
2675
+ dlaEngines: DlaInfo[];
2676
+ /** RAM usage. */
2677
+ memory: MemoryInfo | undefined;
2678
+ /** All thermal zone readings. */
2679
+ thermalZones: ThermalZone[];
2680
+ /** Video encoder/decoder status. */
2681
+ videoCodec: VideoCodecInfo | undefined;
2682
+ /** Main queue load (0..1). */
2683
+ mainQueueLoad: number;
2684
+ /** Guestport queue load (0..1). */
2685
+ guestportQueueLoad: number;
2686
+ /** Communication queue load (0..1). */
2687
+ commQueueLoad: number;
2688
+ /** Camera queue load (0..1). */
2689
+ cameraQueueLoad: number;
2690
+ /** Overlay queue load (0..1). */
2691
+ overlayQueueLoad: number;
2692
+ /** Position observer queue load (0..1). */
2693
+ positionObserverQueueLoad: number;
2694
+ /** NVMe SSD health/identity (Jetson only). */
2695
+ nvme: NvmeInfo | undefined;
2696
+ }
1946
2697
  /**
1947
2698
  * Surface Unit battery information.
1948
2699
  *
@@ -1974,6 +2725,178 @@ export interface SurfaceUnitVersionInfo {
1974
2725
  /** Surface Unit firmware version (x.y.z). */
1975
2726
  version: string;
1976
2727
  }
2728
+ /**
2729
+ * Bounding box for object detection.
2730
+ *
2731
+ * Coordinates are in pixels relative to the camera image,
2732
+ * where (x, y) is the top-left corner of the bounding box.
2733
+ */
2734
+ export interface BoundingBox {
2735
+ /** Horizontal offset of the top-left corner (px). */
2736
+ x: number;
2737
+ /** Vertical offset of the top-left corner (px). */
2738
+ y: number;
2739
+ /** Width of the bounding box (px). */
2740
+ width: number;
2741
+ /** Height of the bounding box (px). */
2742
+ height: number;
2743
+ }
2744
+ /**
2745
+ * RLE-encoded binary segmentation mask with its own anchor box.
2746
+ *
2747
+ * The mask bitmap has dimensions (mask_width x mask_height) covering the
2748
+ * mask_box region of the camera image. The counts field stores run-length
2749
+ * encoded data as packed uint16 little-endian: alternating
2750
+ * background/foreground pixel runs starting with background. Runs longer
2751
+ * than 65535 pixels are split by inserting a zero-length run of the
2752
+ * opposite class (e.g. 70000 becomes 65535, 0, 4465), so decoders need no
2753
+ * special handling — a zero-length run just toggles the class.
2754
+ *
2755
+ * Scale the mask to mask_box, not to the detection's bounding_box: the
2756
+ * bounding box may be smoothed by tracking, while mask_box is pinned to the
2757
+ * raw detection position, so the mask stays on the actual object pixels.
2758
+ */
2759
+ export interface SegmentationMask {
2760
+ /** Width of the RLE bitmap. */
2761
+ maskWidth: number;
2762
+ /** Height of the RLE bitmap. */
2763
+ maskHeight: number;
2764
+ /** RLE counts as packed uint16 little-endian. */
2765
+ counts: Uint8Array;
2766
+ /** Image region the mask bitmap covers (raw detection position, never smoothed). */
2767
+ maskBox: BoundingBox | undefined;
2768
+ }
2769
+ /** A single object detection from a computer vision model. */
2770
+ export interface ObjectDetection {
2771
+ /** Bounding box of the detected object (may be smoothed by tracking). */
2772
+ boundingBox: BoundingBox | undefined;
2773
+ /** Detection confidence score (0..1). */
2774
+ confidence: number;
2775
+ /** Numeric class identifier from the model. */
2776
+ classId: number;
2777
+ /** Human-readable class name. */
2778
+ className: string;
2779
+ /** Unique ID for tracking the same object across frames. */
2780
+ trackingId: number;
2781
+ /** Instance segmentation mask (absent if model has no segmentation). */
2782
+ mask: SegmentationMask | undefined;
2783
+ }
2784
+ /** A list of object detections from a single model for a single video frame. */
2785
+ export interface ModelDetections {
2786
+ /** List of detections in the frame. */
2787
+ detections: ObjectDetection[];
2788
+ /** Which camera the detections are from. */
2789
+ camera: Camera;
2790
+ /** Width of the source image (px). */
2791
+ imageWidth: number;
2792
+ /** Height of the source image (px). */
2793
+ imageHeight: number;
2794
+ /** Name of the computer vision model that produced the detections. */
2795
+ modelName: string;
2796
+ }
2797
+ /** Generic filter settings. */
2798
+ export interface FilterMessage {
2799
+ /** If the filter is enabled. */
2800
+ enabled: boolean;
2801
+ /** Intensity of the filter (0..1). */
2802
+ intensity: number;
2803
+ }
2804
+ /**
2805
+ * Digital pan, tilt, and zoom state for the main camera.
2806
+ *
2807
+ * Only supported on X3 Ultra. Controls digital (not mechanical) zoom.
2808
+ */
2809
+ export interface CameraPanTiltZoom {
2810
+ /** Horizontal pan (-1.0..1.0), where 0.0 is center. */
2811
+ pan: number;
2812
+ /** Vertical tilt (-1.0..1.0), where 0.0 is center. */
2813
+ tilt: number;
2814
+ /** Zoom level (0.0..1.0), where 0.0 is no zoom and 1.0 is maximum zoom. */
2815
+ zoom: number;
2816
+ }
2817
+ /**
2818
+ * Information about the operator controlling the drone.
2819
+ *
2820
+ * Used to identify who started a dive, for reporting and when importing
2821
+ * dives to Blueye Cloud.
2822
+ */
2823
+ export interface OperatorInfo {
2824
+ /** Full name of the operator. */
2825
+ name: string;
2826
+ /** E-mail address of the operator. */
2827
+ email: string;
2828
+ }
2829
+ /**
2830
+ * Single-object tracking (SOT) state reported by the computer vision pipeline.
2831
+ *
2832
+ * The velocity fields are Kalman filter estimates expressed in the CV frame
2833
+ * coordinate space (image_width x image_height pixels).
2834
+ */
2835
+ export interface SotState {
2836
+ /** Current tracking state. */
2837
+ state: SotState_State;
2838
+ /** Current tracked bounding box (valid when TRACKING). */
2839
+ boundingBox: BoundingBox | undefined;
2840
+ /** Width of the source frame in pixels. */
2841
+ imageWidth: number;
2842
+ /** Height of the source frame in pixels. */
2843
+ imageHeight: number;
2844
+ /** Tracker confidence of the last model update (0..1). 0 while coasting and when LOST. */
2845
+ confidence: number;
2846
+ /** Kalman velocity estimate of the bounding box centre, horizontal (px/s). */
2847
+ vx: number;
2848
+ /** Kalman velocity estimate of the bounding box centre, vertical (px/s). */
2849
+ vy: number;
2850
+ /** Kalman rate of change of the bounding box area, width * height (px²/s). */
2851
+ vs: number;
2852
+ /** Kalman rate of change of the bounding box aspect ratio, width / height (1/s). */
2853
+ vr: number;
2854
+ }
2855
+ /** Current state of the SOT tracker. */
2856
+ export declare enum SotState_State {
2857
+ /** STATE_UNSPECIFIED - Unspecified state. */
2858
+ STATE_UNSPECIFIED = 0,
2859
+ /** STATE_IDLE - No target selected, waiting for a target bounding box. */
2860
+ STATE_IDLE = 1,
2861
+ /** STATE_TRACKING - Actively tracking a target. */
2862
+ STATE_TRACKING = 2,
2863
+ /** STATE_LOST - Target was lost (tracker failed to follow the object). */
2864
+ STATE_LOST = 3,
2865
+ UNRECOGNIZED = -1
2866
+ }
2867
+ export declare function sotState_StateFromJSON(object: any): SotState_State;
2868
+ export declare function sotState_StateToJSON(object: SotState_State): string;
2869
+ /**
2870
+ * A single annotation added during a dive, e.g. by a diver tapping a type in the
2871
+ * app command palette, or emitted by the drone itself.
2872
+ *
2873
+ * Self-contained: it carries the type's display fields (name/icon/color) inline,
2874
+ * so the drone, any connected client, and the dive logfile can render it without
2875
+ * a separate catalog. The app keeps the full catalog locally (synced from
2876
+ * Blueye Cloud) to drive its palette, but only complete annotations go over the
2877
+ * wire. type_slug lets Blueye Cloud correlate the annotation to its type on import.
2878
+ *
2879
+ * The drone owns the timestamp: when this is logged the enclosing BinlogRecord
2880
+ * carries the time, like any other sample, so there is no time field here.
2881
+ */
2882
+ export interface Annotation {
2883
+ /** Stable type id for grouping / Cloud correlation. Empty for a free-form annotation. */
2884
+ typeSlug: string;
2885
+ /** Type display name, e.g. "Hazard". Snapshot of the type at creation time. */
2886
+ typeName: string;
2887
+ /** Font Awesome solid icon name, kebab-case (e.g. "triangle-exclamation"). */
2888
+ typeIcon: string;
2889
+ /** Type color, RGB hex incl. leading '#', 7 chars (e.g. "#DC2626"). */
2890
+ typeColor: string;
2891
+ /** Optional annotation title; Cloud falls back to type_name if empty. Max 200 chars. */
2892
+ title: string;
2893
+ /** Optional free-form note. Unbounded. */
2894
+ body: string;
2895
+ /** Optional span; omit for a point-in-time marker. */
2896
+ duration: Duration | undefined;
2897
+ /** Origin of the annotation; the app sets APP, the drone sets DRONE for its own. */
2898
+ source: AnnotationSource;
2899
+ }
1977
2900
  export declare const BinlogRecord: MessageFns<BinlogRecord>;
1978
2901
  export declare const LogEntry: MessageFns<LogEntry>;
1979
2902
  export declare const KernelLogEntry: MessageFns<KernelLogEntry>;
@@ -1981,6 +2904,8 @@ export declare const KernelLogEntry_KeyValuePair: MessageFns<KernelLogEntry_KeyV
1981
2904
  export declare const MotionInput: MessageFns<MotionInput>;
1982
2905
  export declare const Lights: MessageFns<Lights>;
1983
2906
  export declare const Laser: MessageFns<Laser>;
2907
+ export declare const Point2D: MessageFns<Point2D>;
2908
+ export declare const LaserDetection: MessageFns<LaserDetection>;
1984
2909
  export declare const LatLongPosition: MessageFns<LatLongPosition>;
1985
2910
  export declare const ConnectionDuration: MessageFns<ConnectionDuration>;
1986
2911
  export declare const AutoHeadingState: MessageFns<AutoHeadingState>;
@@ -1990,6 +2915,10 @@ export declare const StationKeepingState: MessageFns<StationKeepingState>;
1990
2915
  export declare const WeatherVaningState: MessageFns<WeatherVaningState>;
1991
2916
  export declare const AutoPilotSurgeYawState: MessageFns<AutoPilotSurgeYawState>;
1992
2917
  export declare const AutoPilotHeaveState: MessageFns<AutoPilotHeaveState>;
2918
+ export declare const SpotlightState: MessageFns<SpotlightState>;
2919
+ export declare const ActiveTrackState: MessageFns<ActiveTrackState>;
2920
+ export declare const OrbitState: MessageFns<OrbitState>;
2921
+ export declare const VisionTrackingState: MessageFns<VisionTrackingState>;
1993
2922
  export declare const ControlMode: MessageFns<ControlMode>;
1994
2923
  export declare const TiltStabilizationState: MessageFns<TiltStabilizationState>;
1995
2924
  export declare const SystemTime: MessageFns<SystemTime>;
@@ -2037,11 +2966,15 @@ export declare const IperfStatus: MessageFns<IperfStatus>;
2037
2966
  export declare const NStreamers: MessageFns<NStreamers>;
2038
2967
  export declare const TiltAngle: MessageFns<TiltAngle>;
2039
2968
  export declare const TiltVelocity: MessageFns<TiltVelocity>;
2969
+ export declare const CvModelInfo: MessageFns<CvModelInfo>;
2970
+ export declare const CameraCalibration: MessageFns<CameraCalibration>;
2040
2971
  export declare const DroneInfo: MessageFns<DroneInfo>;
2041
2972
  export declare const ErrorFlags: MessageFns<ErrorFlags>;
2042
2973
  export declare const CameraParameters: MessageFns<CameraParameters>;
2043
2974
  export declare const OverlayParameters: MessageFns<OverlayParameters>;
2044
2975
  export declare const NavigationSensorStatus: MessageFns<NavigationSensorStatus>;
2976
+ export declare const GnssSatellite: MessageFns<GnssSatellite>;
2977
+ export declare const GnssStatus: MessageFns<GnssStatus>;
2045
2978
  export declare const GuestPortDevice: MessageFns<GuestPortDevice>;
2046
2979
  export declare const GuestPortDeviceList: MessageFns<GuestPortDeviceList>;
2047
2980
  export declare const GuestPortConnectorInfo: MessageFns<GuestPortConnectorInfo>;
@@ -2063,8 +2996,25 @@ export declare const MultibeamFrameOffset: MessageFns<MultibeamFrameOffset>;
2063
2996
  export declare const MutltibeamRecordingIndex: MessageFns<MutltibeamRecordingIndex>;
2064
2997
  export declare const PersistentStorageSettings: MessageFns<PersistentStorageSettings>;
2065
2998
  export declare const CPUInfo: MessageFns<CPUInfo>;
2999
+ export declare const CpuCoreLoad: MessageFns<CpuCoreLoad>;
3000
+ export declare const GpuInfo: MessageFns<GpuInfo>;
3001
+ export declare const DlaInfo: MessageFns<DlaInfo>;
3002
+ export declare const MemoryInfo: MessageFns<MemoryInfo>;
3003
+ export declare const ThermalZone: MessageFns<ThermalZone>;
3004
+ export declare const VideoCodecInfo: MessageFns<VideoCodecInfo>;
3005
+ export declare const NvmeInfo: MessageFns<NvmeInfo>;
3006
+ export declare const SystemPerformanceInfo: MessageFns<SystemPerformanceInfo>;
2066
3007
  export declare const SurfaceUnitBatteryInfo: MessageFns<SurfaceUnitBatteryInfo>;
2067
3008
  export declare const SurfaceUnitVersionInfo: MessageFns<SurfaceUnitVersionInfo>;
3009
+ export declare const BoundingBox: MessageFns<BoundingBox>;
3010
+ export declare const SegmentationMask: MessageFns<SegmentationMask>;
3011
+ export declare const ObjectDetection: MessageFns<ObjectDetection>;
3012
+ export declare const ModelDetections: MessageFns<ModelDetections>;
3013
+ export declare const FilterMessage: MessageFns<FilterMessage>;
3014
+ export declare const CameraPanTiltZoom: MessageFns<CameraPanTiltZoom>;
3015
+ export declare const OperatorInfo: MessageFns<OperatorInfo>;
3016
+ export declare const SotState: MessageFns<SotState>;
3017
+ export declare const Annotation: MessageFns<Annotation>;
2068
3018
  type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
2069
3019
  type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
2070
3020
  [K in keyof T]?: DeepPartial<T[K]>;