@blueyerobotics/protocol-definitions 3.2.0-2da79a0a → 3.2.0-2de0da47

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.
@@ -154,6 +154,22 @@ export declare enum NotificationLevel {
154
154
  }
155
155
  export declare function notificationLevelFromJSON(object: any): NotificationLevel;
156
156
  export declare function notificationLevelToJSON(object: NotificationLevel): string;
157
+ /**
158
+ * Storage location.
159
+ *
160
+ * Used to specify which storage location to use for recording photos and videos.
161
+ */
162
+ export declare enum StorageLocation {
163
+ /** STORAGE_LOCATION_UNSPECIFIED - Unspecified. */
164
+ STORAGE_LOCATION_UNSPECIFIED = 0,
165
+ /** STORAGE_LOCATION_INTERNAL - Internal storage of the drone. */
166
+ STORAGE_LOCATION_INTERNAL = 1,
167
+ /** STORAGE_LOCATION_REMOVABLE - Removable storage device. */
168
+ STORAGE_LOCATION_REMOVABLE = 2,
169
+ UNRECOGNIZED = -1
170
+ }
171
+ export declare function storageLocationFromJSON(object: any): StorageLocation;
172
+ export declare function storageLocationToJSON(object: StorageLocation): string;
157
173
  /** Drone models produced by Blueye. */
158
174
  export declare enum Model {
159
175
  /** MODEL_UNSPECIFIED - ModelName not specified. */
@@ -168,6 +184,8 @@ export declare enum Model {
168
184
  MODEL_X3 = 3,
169
185
  /** MODEL_X3_ULTRA - Blueye X3 Ultra. */
170
186
  MODEL_X3_ULTRA = 6,
187
+ /** MODEL_X7 - Blueye X7. */
188
+ MODEL_X7 = 7,
171
189
  /** MODEL_NEXT - Blueye ? */
172
190
  MODEL_NEXT = 5,
173
191
  UNRECOGNIZED = -1
@@ -194,24 +212,35 @@ export declare function pressureSensorTypeToJSON(object: PressureSensorType): st
194
212
  export declare enum Resolution {
195
213
  /** RESOLUTION_UNSPECIFIED - Resolution not specified. */
196
214
  RESOLUTION_UNSPECIFIED = 0,
197
- /** RESOLUTION_FULLHD_1080P - 1080p Full HD resolution. */
198
- RESOLUTION_FULLHD_1080P = 1,
199
- /** RESOLUTION_HD_720P - 720p HD resolution. */
215
+ /** RESOLUTION_VGA_480P - VGA (640x480). */
216
+ RESOLUTION_VGA_480P = 4,
217
+ /** RESOLUTION_HD_720P - 720p HD (1280x720). */
200
218
  RESOLUTION_HD_720P = 2,
201
- /** RESOLUTION_UHD_4K - 4K Ultra HD resolution. */
219
+ /** RESOLUTION_FULLHD_1080P - 1080p Full HD (1920x1080). */
220
+ RESOLUTION_FULLHD_1080P = 1,
221
+ /** RESOLUTION_UHD_4K - 4K Ultra HD (3840x2160, Only supported on X3 Ultra). */
202
222
  RESOLUTION_UHD_4K = 3,
223
+ /** RESOLUTION_QHD_2K - 2K QHD (2560x1440, Only supported on X3 Ultra). */
224
+ RESOLUTION_QHD_2K = 5,
203
225
  UNRECOGNIZED = -1
204
226
  }
205
227
  export declare function resolutionFromJSON(object: any): Resolution;
206
228
  export declare function resolutionToJSON(object: Resolution): string;
207
- /** Available camera frame rates. */
229
+ /**
230
+ * Available camera frame rates.
231
+ *
232
+ * If the requested frame rate is higher than what is supported at the current resolution,
233
+ * the frame rate will be reduced while the resolution is respected.
234
+ */
208
235
  export declare enum Framerate {
209
236
  /** FRAMERATE_UNSPECIFIED - Framerate not specified. */
210
237
  FRAMERATE_UNSPECIFIED = 0,
211
238
  /** FRAMERATE_FPS_30 - 30 frames per second. */
212
239
  FRAMERATE_FPS_30 = 1,
213
- /** FRAMERATE_FPS_25 - 25 frames per second. */
240
+ /** FRAMERATE_FPS_25 - 25 frames per second. (Only supported on Pioneer/Pro/X1/X3) */
214
241
  FRAMERATE_FPS_25 = 2,
242
+ /** FRAMERATE_FPS_60 - 60 frames per second. (Only supported on X3 Ultra at QHD, 1080p and 720p) */
243
+ FRAMERATE_FPS_60 = 3,
215
244
  UNRECOGNIZED = -1
216
245
  }
217
246
  export declare function framerateFromJSON(object: any): Framerate;
@@ -228,6 +257,17 @@ export declare enum Camera {
228
257
  }
229
258
  export declare function cameraFromJSON(object: any): Camera;
230
259
  export declare function cameraToJSON(object: Camera): string;
260
+ export declare enum StreamingProtocol {
261
+ /** STREAMING_PROTOCOL_UNSPECIFIED - Streaming protocol not specified. */
262
+ STREAMING_PROTOCOL_UNSPECIFIED = 0,
263
+ /** STREAMING_PROTOCOL_RTSP_H264 - RTSP streaming protocol using H264 codec. */
264
+ STREAMING_PROTOCOL_RTSP_H264 = 1,
265
+ /** STREAMING_PROTOCOL_RTSP_MJPEG - RTSP streaming protocol using MJPEG codec. No recording when activated. */
266
+ STREAMING_PROTOCOL_RTSP_MJPEG = 2,
267
+ UNRECOGNIZED = -1
268
+ }
269
+ export declare function streamingProtocolFromJSON(object: any): StreamingProtocol;
270
+ export declare function streamingProtocolToJSON(object: StreamingProtocol): string;
231
271
  /** Available temperature units. */
232
272
  export declare enum TemperatureUnit {
233
273
  /** TEMPERATURE_UNIT_UNSPECIFIED - Temperature unit not specified. */
@@ -390,6 +430,12 @@ export declare enum GuestPortDeviceID {
390
430
  GUEST_PORT_DEVICE_ID_WATERLINKED_SONAR_3D15 = 43,
391
431
  /** GUEST_PORT_DEVICE_ID_CERULEAN_TRACKER_650 - Cerulean Tracker 650. */
392
432
  GUEST_PORT_DEVICE_ID_CERULEAN_TRACKER_650 = 44,
433
+ /** GUEST_PORT_DEVICE_ID_BLUEYE_EXTERNAL_USB_STORAGE - Blueye External USB Storage. */
434
+ GUEST_PORT_DEVICE_ID_BLUEYE_EXTERNAL_USB_STORAGE = 45,
435
+ /** GUEST_PORT_DEVICE_ID_BLUEYE_MULTIBEAM_SERVO_V2 - Blueye Multibeam Skid Servo V2. */
436
+ GUEST_PORT_DEVICE_ID_BLUEYE_MULTIBEAM_SERVO_V2 = 46,
437
+ /** GUEST_PORT_DEVICE_ID_CERULEAN_OMNISCAN_450_COMPACT - Cerulean Omniscan 450 Compact. */
438
+ GUEST_PORT_DEVICE_ID_CERULEAN_OMNISCAN_450_COMPACT = 47,
393
439
  UNRECOGNIZED = -1
394
440
  }
395
441
  export declare function guestPortDeviceIDFromJSON(object: any): GuestPortDeviceID;
@@ -491,6 +537,89 @@ export interface BinlogRecord {
491
537
  /** Posix CLOCK_MONOTONIC timestamp. */
492
538
  clockMonotonic: Date | undefined;
493
539
  }
540
+ /**
541
+ * Log entry
542
+ *
543
+ * Used to store ROS log entries in the bez file
544
+ */
545
+ export interface LogEntry {
546
+ /** Timestamp of the log entry. */
547
+ timestamp: Date | undefined;
548
+ /** Name of the process that generated the log entry. */
549
+ processName: string;
550
+ /** Process ID of the log entry. */
551
+ processId: number;
552
+ /** Thread ID of the log entry. */
553
+ threadId: number;
554
+ /** Source of the log entry (specific class or named logger). */
555
+ source: string;
556
+ /** Log level, info, warning, error, etc. */
557
+ level: LogEntry_LogLevel;
558
+ /** Log message. */
559
+ message: string;
560
+ }
561
+ export declare enum LogEntry_LogLevel {
562
+ /** LOG_LEVEL_UNSPECIFIED - Unspecified log level. */
563
+ LOG_LEVEL_UNSPECIFIED = 0,
564
+ /** LOG_LEVEL_TRACE - Trace log level. */
565
+ LOG_LEVEL_TRACE = 1,
566
+ /** LOG_LEVEL_DEBUG - Debug log level. */
567
+ LOG_LEVEL_DEBUG = 2,
568
+ /** LOG_LEVEL_INFO - Info log level. */
569
+ LOG_LEVEL_INFO = 3,
570
+ /** LOG_LEVEL_WARNING - Warning log level. */
571
+ LOG_LEVEL_WARNING = 4,
572
+ /** LOG_LEVEL_ERROR - Error log level. */
573
+ LOG_LEVEL_ERROR = 5,
574
+ /** LOG_LEVEL_CRITICAL - Critical log level. */
575
+ LOG_LEVEL_CRITICAL = 6,
576
+ UNRECOGNIZED = -1
577
+ }
578
+ export declare function logEntry_LogLevelFromJSON(object: any): LogEntry_LogLevel;
579
+ export declare function logEntry_LogLevelToJSON(object: LogEntry_LogLevel): string;
580
+ export interface KernelLogEntry {
581
+ /** Log level, info, warning, error, etc. */
582
+ level: KernelLogEntry_KernelLogLevel;
583
+ /** Sequence number of the log entry. */
584
+ seqnum: number;
585
+ /** Timestamp of the log entry. */
586
+ timestamp: Date | undefined;
587
+ /** Log messages. */
588
+ messages: string[];
589
+ /** List of key-value pairs. */
590
+ fields: KernelLogEntry_KeyValuePair[];
591
+ }
592
+ /** Kernel log level. */
593
+ export declare enum KernelLogEntry_KernelLogLevel {
594
+ /** KERNEL_LOG_LEVEL_UNSPECIFIED - Unspecified log level. */
595
+ KERNEL_LOG_LEVEL_UNSPECIFIED = 0,
596
+ /** KERNEL_LOG_LEVEL_EMERG - Emergency log level. */
597
+ KERNEL_LOG_LEVEL_EMERG = 1,
598
+ /** KERNEL_LOG_LEVEL_ALERT - Alert log level. */
599
+ KERNEL_LOG_LEVEL_ALERT = 2,
600
+ /** KERNEL_LOG_LEVEL_CRIT - Critical log level. */
601
+ KERNEL_LOG_LEVEL_CRIT = 3,
602
+ /** KERNEL_LOG_LEVEL_ERR - Error log level. */
603
+ KERNEL_LOG_LEVEL_ERR = 4,
604
+ /** KERNEL_LOG_LEVEL_WARNING - Warning log level. */
605
+ KERNEL_LOG_LEVEL_WARNING = 5,
606
+ /** KERNEL_LOG_LEVEL_NOTICE - Notice log level. */
607
+ KERNEL_LOG_LEVEL_NOTICE = 6,
608
+ /** KERNEL_LOG_LEVEL_INFO - Informational log level. */
609
+ KERNEL_LOG_LEVEL_INFO = 7,
610
+ /** KERNEL_LOG_LEVEL_DEBUG - Debug log level. */
611
+ KERNEL_LOG_LEVEL_DEBUG = 8,
612
+ UNRECOGNIZED = -1
613
+ }
614
+ export declare function kernelLogEntry_KernelLogLevelFromJSON(object: any): KernelLogEntry_KernelLogLevel;
615
+ export declare function kernelLogEntry_KernelLogLevelToJSON(object: KernelLogEntry_KernelLogLevel): string;
616
+ /** Key-value pair used for structured logging. */
617
+ export interface KernelLogEntry_KeyValuePair {
618
+ /** Key of the key-value pair. */
619
+ key: string;
620
+ /** Value of the key-value pair. */
621
+ value: string;
622
+ }
494
623
  /** If you use both values at the same time they cancel each other out. */
495
624
  export interface MotionInput {
496
625
  /** Forward (positive) and backwards (negative) movement. (-1..1). */
@@ -660,6 +789,12 @@ export interface RecordState {
660
789
  multibeamSeconds: number;
661
790
  /** Multibeam record fps. */
662
791
  multibeamFps: number;
792
+ /** Storage location used for main camera recording. */
793
+ mainStorageLocation: StorageLocation;
794
+ /** Storage location used for guestport camera recording. */
795
+ guestportStorageLocation: StorageLocation;
796
+ /** Storage location used for multibeam recording. */
797
+ multibeamStorageLocation: StorageLocation;
663
798
  }
664
799
  /** Time-lapse state published if time-lapse mission is running. */
665
800
  export interface TimeLapseState {
@@ -1127,7 +1262,7 @@ export interface DiveTime {
1127
1262
  /** Number of seconds the drone has been submerged. */
1128
1263
  value: number;
1129
1264
  }
1130
- /** Which cameras are supposed to be recording. */
1265
+ /** Which cameras or multibeam are supposed to be recording. */
1131
1266
  export interface RecordOn {
1132
1267
  /** Record the main camera. */
1133
1268
  main: boolean;
@@ -1153,6 +1288,8 @@ export interface StoragePartition {
1153
1288
  devicePath: string;
1154
1289
  /** Mount path of the partition. */
1155
1290
  mountPath: string;
1291
+ /** Label of the partition. */
1292
+ label: string;
1156
1293
  }
1157
1294
  /** Removable storage device. */
1158
1295
  export interface RemovableStorageDevice {
@@ -1175,10 +1312,12 @@ export declare enum RemovableStorageDevice_Status {
1175
1312
  STATUS_UNSPECIFIED = 0,
1176
1313
  /** STATUS_READY - The storage device is valid and ready for use. */
1177
1314
  STATUS_READY = 1,
1178
- /** STATUS_FORMATTING - The storage device is being formatted */
1315
+ /** STATUS_FORMATTING - The storage device is being formatted. */
1179
1316
  STATUS_FORMATTING = 2,
1180
1317
  /** STATUS_ERROR - The storage device is in an error state. */
1181
1318
  STATUS_ERROR = 3,
1319
+ /** STATUS_UNPLUGGED - The storage device is not present. */
1320
+ STATUS_UNPLUGGED = 4,
1182
1321
  UNRECOGNIZED = -1
1183
1322
  }
1184
1323
  export declare function removableStorageDevice_StatusFromJSON(object: any): RemovableStorageDevice_Status;
@@ -1407,22 +1546,50 @@ export interface CameraParameters {
1407
1546
  mjpgBitrate: number;
1408
1547
  /** Shutter speed (1/10000 * s), -1 for automatic exposure. */
1409
1548
  exposure: number;
1410
- /** White balance temperature (2800..9300), -1 for automatic white balance. */
1549
+ /** White balance temp (Pioneer/Pro/X1/X3: 2800..9300, Ultra: 2300..15000), -1 for auto. */
1411
1550
  whiteBalance: number;
1412
- /** Hue (-40..40), 0 as default. */
1551
+ /** Hue (-40..40), 0 as default. Only available on Pioneer/Pro/X1/X3. */
1413
1552
  hue: number;
1414
- /** Iso gain (0..1). */
1553
+ /** Iso gain (0..1). Only available on Pioneer/Pro/X1/X3. */
1415
1554
  gain: number;
1555
+ /** Brightness (-10..10), 0 as default. Only available on Ultra */
1556
+ brightness: number;
1557
+ /** Contrast (-50..50), 0 as default. Only available on Ultra. */
1558
+ contrast: number;
1559
+ /** Saturation (0..50), 8 as default. Only available on Ultra. */
1560
+ saturation: number;
1561
+ /** Gamma (4..79), 22 as default. Only available on Ultra. */
1562
+ gamma: number;
1563
+ /** Sharpness (-20..20), -20 as default. Only available on Ultra. */
1564
+ sharpness: number;
1565
+ /** Backlight compensation (-150..150), 10 as default. Only available on Ultra. */
1566
+ backlightCompensation: number;
1567
+ /** Noise reduction (-20..20), -20 as default. Only available on Ultra. */
1568
+ denoise: number;
1569
+ /** Enable eHDR mode. Default true. Only available on Ultra. */
1570
+ ehdrEnabled: boolean;
1571
+ /** Minimum number of eHDR frames. (1..4), default 1. Only available on Ultra. */
1572
+ ehdrExposureMinNumber: number;
1573
+ /** Maximum number of eHDR frames. (1..4), default 2. Only on Ultra. Setting larger than 2 can reduce the framerate. */
1574
+ ehdrExposureMaxNumber: number;
1416
1575
  /** Stream, recording and image resolution (deprecated). */
1417
1576
  resolution: Resolution;
1418
1577
  /** Stream resolution. */
1419
1578
  streamResolution: Resolution;
1420
1579
  /** Recording and image resolution. */
1421
1580
  recordingResolution: Resolution;
1581
+ /** Streaming protocol. */
1582
+ streamingProtocol: StreamingProtocol;
1422
1583
  /** Stream and recording framerate. */
1423
1584
  framerate: Framerate;
1424
1585
  /** Which camera the parameters belong to. */
1425
1586
  camera: Camera;
1587
+ /**
1588
+ * Network MTU (Maximum Transmission Unit) size for video streaming in bytes (68..65535).
1589
+ * If 0 or unset, the system will use a default of 1400.
1590
+ * The Blueye App allows users to set values between 500 and 1460.
1591
+ */
1592
+ mtuSize: number;
1426
1593
  }
1427
1594
  /**
1428
1595
  * Overlay parameters.
@@ -1648,8 +1815,7 @@ export interface MultibeamPing {
1648
1815
  /** Size in bytes of each row in the ping data image. */
1649
1816
  step: number;
1650
1817
  /**
1651
- * Bearing angle of each column of the sonar data
1652
- * (in 100th of a degree, multiply by 0.01 to get a value in degrees).
1818
+ * Bearing angle of each column of the sonar data in degrees.
1653
1819
  * The sonar image is not sampled uniformly in the bearing direction.
1654
1820
  */
1655
1821
  bearings: number[];
@@ -1802,8 +1968,100 @@ export interface CPUInfo {
1802
1968
  mainQueueLoad: number;
1803
1969
  /** Guestport queue load (0..1). */
1804
1970
  guestportQueueLoad: number;
1971
+ /** Communication queue load (0..1). */
1972
+ commQueueLoad: number;
1973
+ }
1974
+ /**
1975
+ * Surface Unit battery information.
1976
+ *
1977
+ * This message is published by the Surface Unit, and re-published by
1978
+ * the drone over the communication protocol.
1979
+ */
1980
+ export interface SurfaceUnitBatteryInfo {
1981
+ /** Battery charge status. */
1982
+ status: SurfaceUnitBatteryInfo_ChargeStatus;
1983
+ /** Battery level (0..1). */
1984
+ level: number;
1985
+ }
1986
+ export declare enum SurfaceUnitBatteryInfo_ChargeStatus {
1987
+ CHARGE_STATUS_UNSPECIFIED = 0,
1988
+ CHARGE_STATUS_DISCHARGE = 1,
1989
+ CHARGE_STATUS_CHARGE = 2,
1990
+ CHARGE_STATUS_CHARGE_ERROR = 3,
1991
+ UNRECOGNIZED = -1
1992
+ }
1993
+ export declare function surfaceUnitBatteryInfo_ChargeStatusFromJSON(object: any): SurfaceUnitBatteryInfo_ChargeStatus;
1994
+ export declare function surfaceUnitBatteryInfo_ChargeStatusToJSON(object: SurfaceUnitBatteryInfo_ChargeStatus): string;
1995
+ /**
1996
+ * Surface Unit version information.
1997
+ *
1998
+ * This message is published by the Surface Unit, and re-published by
1999
+ * the drone over the communication protocol.
2000
+ */
2001
+ export interface SurfaceUnitVersionInfo {
2002
+ /** Surface Unit firmware version (x.y.z). */
2003
+ version: string;
2004
+ }
2005
+ /**
2006
+ * Bounding box for object detection.
2007
+ *
2008
+ * Coordinates are in pixels relative to the camera image,
2009
+ * where (x, y) is the top-left corner of the bounding box.
2010
+ */
2011
+ export interface BoundingBox {
2012
+ /** Horizontal offset of the top-left corner (px). */
2013
+ x: number;
2014
+ /** Vertical offset of the top-left corner (px). */
2015
+ y: number;
2016
+ /** Width of the bounding box (px). */
2017
+ width: number;
2018
+ /** Height of the bounding box (px). */
2019
+ height: number;
2020
+ }
2021
+ /** A single object detection from a computer vision model. */
2022
+ export interface ObjectDetection {
2023
+ /** Bounding box of the detected object. */
2024
+ boundingBox: BoundingBox | undefined;
2025
+ /** Detection confidence score (0..1). */
2026
+ confidence: number;
2027
+ /** Numeric class identifier from the model. */
2028
+ classId: number;
2029
+ /** Human-readable class name. */
2030
+ className: string;
2031
+ /** Unique ID for tracking the same object across frames. */
2032
+ trackingId: number;
2033
+ }
2034
+ /** A list of object detections from a single video frame. */
2035
+ export interface ObjectDetections {
2036
+ /** List of detections in the frame. */
2037
+ detections: ObjectDetection[];
2038
+ /** Which camera the detections are from. */
2039
+ camera: Camera;
2040
+ }
2041
+ /** Generic filter settings. */
2042
+ export interface FilterMessage {
2043
+ /** If the filter is enabled. */
2044
+ enabled: boolean;
2045
+ /** Intensity of the filter (0..1). */
2046
+ intensity: number;
2047
+ }
2048
+ /**
2049
+ * Digital pan, tilt, and zoom state for the main camera.
2050
+ *
2051
+ * Only supported on X3 Ultra. Controls digital (not mechanical) zoom.
2052
+ */
2053
+ export interface CameraPanTiltZoom {
2054
+ /** Horizontal pan (-1.0..1.0), where 0.0 is center. */
2055
+ pan: number;
2056
+ /** Vertical tilt (-1.0..1.0), where 0.0 is center. */
2057
+ tilt: number;
2058
+ /** Zoom level (0.0..1.0), where 0.0 is no zoom and 1.0 is maximum zoom. */
2059
+ zoom: number;
1805
2060
  }
1806
2061
  export declare const BinlogRecord: MessageFns<BinlogRecord>;
2062
+ export declare const LogEntry: MessageFns<LogEntry>;
2063
+ export declare const KernelLogEntry: MessageFns<KernelLogEntry>;
2064
+ export declare const KernelLogEntry_KeyValuePair: MessageFns<KernelLogEntry_KeyValuePair>;
1807
2065
  export declare const MotionInput: MessageFns<MotionInput>;
1808
2066
  export declare const Lights: MessageFns<Lights>;
1809
2067
  export declare const Laser: MessageFns<Laser>;
@@ -1889,6 +2147,13 @@ export declare const MultibeamFrameOffset: MessageFns<MultibeamFrameOffset>;
1889
2147
  export declare const MutltibeamRecordingIndex: MessageFns<MutltibeamRecordingIndex>;
1890
2148
  export declare const PersistentStorageSettings: MessageFns<PersistentStorageSettings>;
1891
2149
  export declare const CPUInfo: MessageFns<CPUInfo>;
2150
+ export declare const SurfaceUnitBatteryInfo: MessageFns<SurfaceUnitBatteryInfo>;
2151
+ export declare const SurfaceUnitVersionInfo: MessageFns<SurfaceUnitVersionInfo>;
2152
+ export declare const BoundingBox: MessageFns<BoundingBox>;
2153
+ export declare const ObjectDetection: MessageFns<ObjectDetection>;
2154
+ export declare const ObjectDetections: MessageFns<ObjectDetections>;
2155
+ export declare const FilterMessage: MessageFns<FilterMessage>;
2156
+ export declare const CameraPanTiltZoom: MessageFns<CameraPanTiltZoom>;
1892
2157
  type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
1893
2158
  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 {} ? {
1894
2159
  [K in keyof T]?: DeepPartial<T[K]>;