@blueyerobotics/protocol-definitions 3.2.0-e9cac0e4 → 3.2.0-fcf0b829

package/dist/message_formats.d.ts

@@ -184,6 +184,8 @@ export declare enum Model {
     MODEL_X3 = 3,
     /** MODEL_X3_ULTRA - Blueye X3 Ultra. */
     MODEL_X3_ULTRA = 6,
+    /** MODEL_X7 - Blueye X7. */
+    MODEL_X7 = 7,
     /** MODEL_NEXT - Blueye ? */
     MODEL_NEXT = 5,
     UNRECOGNIZED = -1
@@ -218,11 +220,18 @@ export declare enum Resolution {
     RESOLUTION_FULLHD_1080P = 1,
     /** RESOLUTION_UHD_4K - 4K Ultra HD (3840x2160, Only supported on X3 Ultra). */
     RESOLUTION_UHD_4K = 3,
+    /** RESOLUTION_QHD_2K - 2K QHD (2560x1440, Only supported on X3 Ultra). */
+    RESOLUTION_QHD_2K = 5,
     UNRECOGNIZED = -1
 }
 export declare function resolutionFromJSON(object: any): Resolution;
 export declare function resolutionToJSON(object: Resolution): string;
-/** Available camera frame rates. */
+/**
+ * Available camera frame rates.
+ *
+ * If the requested frame rate is higher than what is supported at the current resolution,
+ * the frame rate will be reduced while the resolution is respected.
+ */
 export declare enum Framerate {
     /** FRAMERATE_UNSPECIFIED - Framerate not specified. */
     FRAMERATE_UNSPECIFIED = 0,
@@ -230,6 +239,8 @@ export declare enum Framerate {
     FRAMERATE_FPS_30 = 1,
     /** FRAMERATE_FPS_25 - 25 frames per second. (Only supported on Pioneer/Pro/X1/X3) */
     FRAMERATE_FPS_25 = 2,
+    /** FRAMERATE_FPS_60 - 60 frames per second. (Only supported on X3 Ultra at QHD, 1080p and 720p) */
+    FRAMERATE_FPS_60 = 3,
     UNRECOGNIZED = -1
 }
 export declare function framerateFromJSON(object: any): Framerate;
@@ -257,6 +268,18 @@ export declare enum StreamingProtocol {
 }
 export declare function streamingProtocolFromJSON(object: any): StreamingProtocol;
 export declare function streamingProtocolToJSON(object: StreamingProtocol): string;
+/** Recording video codec. */
+export declare enum RecordingCodec {
+    /** RECORDING_CODEC_UNSPECIFIED - Use platform default (H.264). */
+    RECORDING_CODEC_UNSPECIFIED = 0,
+    /** RECORDING_CODEC_H264 - H.264/AVC codec. Wider compatibility with players/editors. */
+    RECORDING_CODEC_H264 = 1,
+    /** RECORDING_CODEC_H265 - H.265/HEVC codec. Better compression, limited compatibility. Ultra only. */
+    RECORDING_CODEC_H265 = 2,
+    UNRECOGNIZED = -1
+}
+export declare function recordingCodecFromJSON(object: any): RecordingCodec;
+export declare function recordingCodecToJSON(object: RecordingCodec): string;
 /** Available temperature units. */
 export declare enum TemperatureUnit {
     /** TEMPERATURE_UNIT_UNSPECIFIED - Temperature unit not specified. */
@@ -419,8 +442,14 @@ export declare enum GuestPortDeviceID {
     GUEST_PORT_DEVICE_ID_WATERLINKED_SONAR_3D15 = 43,
     /** GUEST_PORT_DEVICE_ID_CERULEAN_TRACKER_650 - Cerulean Tracker 650. */
     GUEST_PORT_DEVICE_ID_CERULEAN_TRACKER_650 = 44,
-    /** GUEST_PORT_DEVICE_ID_BLUEYE_EXTERNAL_USB_STORAGE - Blueye External USB Storage */
+    /** GUEST_PORT_DEVICE_ID_BLUEYE_EXTERNAL_USB_STORAGE - Blueye External USB Storage. */
     GUEST_PORT_DEVICE_ID_BLUEYE_EXTERNAL_USB_STORAGE = 45,
+    /** GUEST_PORT_DEVICE_ID_BLUEYE_MULTIBEAM_SERVO_V2 - Blueye Multibeam Skid Servo V2. */
+    GUEST_PORT_DEVICE_ID_BLUEYE_MULTIBEAM_SERVO_V2 = 46,
+    /** GUEST_PORT_DEVICE_ID_CERULEAN_OMNISCAN_450_COMPACT - Cerulean Omniscan 450 Compact. */
+    GUEST_PORT_DEVICE_ID_CERULEAN_OMNISCAN_450_COMPACT = 47,
+    /** GUEST_PORT_DEVICE_ID_BLUEYE_SCALING_LASER - Blueye Scaling Laser. */
+    GUEST_PORT_DEVICE_ID_BLUEYE_SCALING_LASER = 48,
     UNRECOGNIZED = -1
 }
 export declare function guestPortDeviceIDFromJSON(object: any): GuestPortDeviceID;
@@ -506,6 +535,18 @@ export declare enum MultibeamFrequencyMode {
 }
 export declare function multibeamFrequencyModeFromJSON(object: any): MultibeamFrequencyMode;
 export declare function multibeamFrequencyModeToJSON(object: MultibeamFrequencyMode): string;
+/** Thermal zone identifiers. */
+export declare enum ThermalZoneId {
+    /** THERMAL_ZONE_ID_UNSPECIFIED - Unspecified thermal zone. */
+    THERMAL_ZONE_ID_UNSPECIFIED = 0,
+    /** THERMAL_ZONE_ID_TJ - Junction temperature (Tj). */
+    THERMAL_ZONE_ID_TJ = 1,
+    /** THERMAL_ZONE_ID_CANISTER - Canister temperature. */
+    THERMAL_ZONE_ID_CANISTER = 2,
+    UNRECOGNIZED = -1
+}
+export declare function thermalZoneIdFromJSON(object: any): ThermalZoneId;
+export declare function thermalZoneIdToJSON(object: ThermalZoneId): string;
 /**
  * Wrapper message for each entry in the drone telemetry logfile.
  *
@@ -562,6 +603,49 @@ export declare enum LogEntry_LogLevel {
 }
 export declare function logEntry_LogLevelFromJSON(object: any): LogEntry_LogLevel;
 export declare function logEntry_LogLevelToJSON(object: LogEntry_LogLevel): string;
+export interface KernelLogEntry {
+    /** Log level, info, warning, error, etc. */
+    level: KernelLogEntry_KernelLogLevel;
+    /** Sequence number of the log entry. */
+    seqnum: number;
+    /** Timestamp of the log entry. */
+    timestamp: Date | undefined;
+    /** Log messages. */
+    messages: string[];
+    /** List of key-value pairs. */
+    fields: KernelLogEntry_KeyValuePair[];
+}
+/** Kernel log level. */
+export declare enum KernelLogEntry_KernelLogLevel {
+    /** KERNEL_LOG_LEVEL_UNSPECIFIED - Unspecified log level. */
+    KERNEL_LOG_LEVEL_UNSPECIFIED = 0,
+    /** KERNEL_LOG_LEVEL_EMERG - Emergency log level. */
+    KERNEL_LOG_LEVEL_EMERG = 1,
+    /** KERNEL_LOG_LEVEL_ALERT - Alert log level. */
+    KERNEL_LOG_LEVEL_ALERT = 2,
+    /** KERNEL_LOG_LEVEL_CRIT - Critical log level. */
+    KERNEL_LOG_LEVEL_CRIT = 3,
+    /** KERNEL_LOG_LEVEL_ERR - Error log level. */
+    KERNEL_LOG_LEVEL_ERR = 4,
+    /** KERNEL_LOG_LEVEL_WARNING - Warning log level. */
+    KERNEL_LOG_LEVEL_WARNING = 5,
+    /** KERNEL_LOG_LEVEL_NOTICE - Notice log level. */
+    KERNEL_LOG_LEVEL_NOTICE = 6,
+    /** KERNEL_LOG_LEVEL_INFO - Informational log level. */
+    KERNEL_LOG_LEVEL_INFO = 7,
+    /** KERNEL_LOG_LEVEL_DEBUG - Debug log level. */
+    KERNEL_LOG_LEVEL_DEBUG = 8,
+    UNRECOGNIZED = -1
+}
+export declare function kernelLogEntry_KernelLogLevelFromJSON(object: any): KernelLogEntry_KernelLogLevel;
+export declare function kernelLogEntry_KernelLogLevelToJSON(object: KernelLogEntry_KernelLogLevel): string;
+/** Key-value pair used for structured logging. */
+export interface KernelLogEntry_KeyValuePair {
+    /** Key of the key-value pair. */
+    key: string;
+    /** Value of the key-value pair. */
+    value: string;
+}
 /** If you use both values at the same time they cancel each other out. */
 export interface MotionInput {
     /** Forward (positive) and backwards (negative) movement. (-1..1). */
@@ -731,6 +815,12 @@ export interface RecordState {
     multibeamSeconds: number;
     /** Multibeam record fps. */
     multibeamFps: number;
+    /** Storage location used for main camera recording. */
+    mainStorageLocation: StorageLocation;
+    /** Storage location used for guestport camera recording. */
+    guestportStorageLocation: StorageLocation;
+    /** Storage location used for multibeam recording. */
+    multibeamStorageLocation: StorageLocation;
 }
 /** Time-lapse state published if time-lapse mission is running. */
 export interface TimeLapseState {
@@ -776,7 +866,7 @@ export interface WaterTemperature {
     /** Water temperature (°C). */
     value: number;
 }
-/** CPU temperature. */
+/** CPU temperature (deprecated, use SystemPerformanceInfo.thermal_zones instead). */
 export interface CPUTemperature {
     /** CPU temperature (°C). */
     value: number;
@@ -1224,6 +1314,8 @@ export interface StoragePartition {
     devicePath: string;
     /** Mount path of the partition. */
     mountPath: string;
+    /** Label of the partition. */
+    label: string;
 }
 /** Removable storage device. */
 export interface RemovableStorageDevice {
@@ -1246,10 +1338,12 @@ export declare enum RemovableStorageDevice_Status {
     STATUS_UNSPECIFIED = 0,
     /** STATUS_READY - The storage device is valid and ready for use. */
     STATUS_READY = 1,
-    /** STATUS_FORMATTING - The storage device is being formatted */
+    /** STATUS_FORMATTING - The storage device is being formatted. */
     STATUS_FORMATTING = 2,
     /** STATUS_ERROR - The storage device is in an error state. */
     STATUS_ERROR = 3,
+    /** STATUS_UNPLUGGED - The storage device is not present. */
+    STATUS_UNPLUGGED = 4,
     UNRECOGNIZED = -1
 }
 export declare function removableStorageDevice_StatusFromJSON(object: any): RemovableStorageDevice_Status;
@@ -1516,6 +1610,19 @@ export interface CameraParameters {
     framerate: Framerate;
     /** Which camera the parameters belong to. */
     camera: Camera;
+    /**
+     * Network MTU (Maximum Transmission Unit) size for video streaming in bytes (68..65535).
+     * If 0 or unset, the system will use a default of 1400.
+     * The Blueye App allows users to set values between 500 and 1460.
+     */
+    mtuSize: number;
+    /** Recording video codec. If unset, uses platform default. */
+    recordingCodec: RecordingCodec;
+    /**
+     * Recording bitrate in bits/sec. If 0 or unset, a default is computed based
+     * on resolution, framerate, and encoding. Set explicitly to override.
+     */
+    recordingBitrate: number;
 }
 /**
  * Overlay parameters.
@@ -1741,8 +1848,7 @@ export interface MultibeamPing {
     /** Size in bytes of each row in the ping data image. */
     step: number;
     /**
-     * Bearing angle of each column of the sonar data
-     * (in 100th of a degree, multiply by 0.01 to get a value in degrees).
+     * Bearing angle of each column of the sonar data in degrees.
      * The sonar image is not sampled uniformly in the bearing direction.
      */
     bearings: number[];
@@ -1882,7 +1988,7 @@ export interface PersistentStorageSettings {
     accCalibration: boolean;
 }
 /**
- * CPU information.
+ * CPU information (deprecated, use SystemPerformanceInfo instead).
  *
  * Contains information about the CPU load and memory usage of the drone.
  */
@@ -1898,6 +2004,119 @@ export interface CPUInfo {
     /** Communication queue load (0..1). */
     commQueueLoad: number;
 }
+/** Per-core CPU utilization. */
+export interface CpuCoreLoad {
+    /** Core index (0-based). */
+    coreIndex: number;
+    /** Core load (0..1). */
+    load: number;
+    /** Current clock frequency (MHz). */
+    frequencyMhz: number;
+}
+/** GPU utilization and status. */
+export interface GpuInfo {
+    /** GPU load (0..1). */
+    load: number;
+    /** Current GPU clock frequency (MHz). */
+    frequencyMhz: number;
+}
+/**
+ * Deep Learning Accelerator (DLA) utilization.
+ *
+ * Jetson Orin NX has two DLA engines used for inference offload.
+ */
+export interface DlaInfo {
+    /** DLA engine index (0-based). */
+    engineIndex: number;
+    /** DLA engine load (0..1). */
+    load: number;
+    /** Core clock frequency (MHz). 0 when disabled. */
+    frequencyMhz: number;
+    /** True when the DLA engine is actively processing. */
+    enabled: boolean;
+    /** Falcon microcontroller clock frequency (MHz). 0 when disabled. */
+    falconFrequencyMhz: number;
+}
+/** System memory information. */
+export interface MemoryInfo {
+    /** Total RAM (bytes). */
+    totalBytes: number;
+    /** Used RAM (bytes). */
+    usedBytes: number;
+    /** Cached RAM (bytes). */
+    cachedBytes: number;
+    /** Memory bus utilization (0..1). i.MX only. */
+    busLoad: number;
+}
+/** Thermal zone reading. */
+export interface ThermalZone {
+    /** Thermal zone identifier. */
+    zone: ThermalZoneId;
+    /** Temperature (°C). */
+    temperature: number;
+}
+/** Video codec engine status. */
+export interface VideoCodecInfo {
+    /** Jetson only (NVENC/NVDEC/NVJPG/VIC devfreq). */
+    encoderActive: boolean;
+    /** Video encoder clock frequency (MHz). */
+    encoderFrequencyMhz: number;
+    /** Video decoder (NVDEC) is active. */
+    decoderActive: boolean;
+    /** Video decoder clock frequency (MHz). */
+    decoderFrequencyMhz: number;
+    /** JPEG engine (NVJPG) is active. */
+    nvjpgActive: boolean;
+    /** JPEG engine clock frequency (MHz). */
+    nvjpgFrequencyMhz: number;
+    /** Video Image Compositor (VIC) is active. */
+    vicActive: boolean;
+    /** VIC clock frequency (MHz). */
+    vicFrequencyMhz: number;
+    /** i.MX only (CODA VPU). */
+    vpuActive: boolean;
+    /** VPU AXI clock frequency (MHz). */
+    vpuFrequencyMhz: number;
+    /** Cumulative VPU_CODEC_IRQ count. */
+    vpuCodecIrqCount: number;
+    /** Cumulative VPU_JPG_IRQ count. */
+    vpuJpgIrqCount: number;
+}
+/**
+ * System performance information.
+ *
+ * Comprehensive performance metrics for the drone's compute platform.
+ * Covers CPU, GPU, DLA, memory, thermals, and video codec utilization.
+ * Fields not applicable to a platform are left at their zero/empty defaults.
+ */
+export interface SystemPerformanceInfo {
+    /** Per-core CPU utilization. */
+    cpuCores: CpuCoreLoad[];
+    /** Mean CPU utilization across all cores (0..1). */
+    cpuUtilization: number;
+    /** GPU utilization. */
+    gpu: GpuInfo | undefined;
+    /** DLA engine utilization (Jetson only). */
+    dlaEngines: DlaInfo[];
+    /** RAM usage. */
+    memory: MemoryInfo | undefined;
+    /** All thermal zone readings. */
+    thermalZones: ThermalZone[];
+    /** Video encoder/decoder status. */
+    videoCodec: VideoCodecInfo | undefined;
+    /** Main queue load (0..1). */
+    mainQueueLoad: number;
+    /** Guestport queue load (0..1). */
+    guestportQueueLoad: number;
+    /** Communication queue load (0..1). */
+    commQueueLoad: number;
+    /** Camera queue load (0..1). */
+    cameraQueueLoad: number;
+    /** Overlay queue load (0..1). */
+    overlayQueueLoad: number;
+    /** Position observer queue load (0..1). */
+    positionObserverQueueLoad: number;
+}
 /**
  * Surface Unit battery information.
  *
@@ -1929,8 +2148,84 @@ export interface SurfaceUnitVersionInfo {
     /** Surface Unit firmware version (x.y.z). */
     version: string;
 }
+/**
+ * Bounding box for object detection.
+ *
+ * Coordinates are in pixels relative to the camera image,
+ * where (x, y) is the top-left corner of the bounding box.
+ */
+export interface BoundingBox {
+    /** Horizontal offset of the top-left corner (px). */
+    x: number;
+    /** Vertical offset of the top-left corner (px). */
+    y: number;
+    /** Width of the bounding box (px). */
+    width: number;
+    /** Height of the bounding box (px). */
+    height: number;
+}
+/** A single object detection from a computer vision model. */
+export interface ObjectDetection {
+    /** Bounding box of the detected object. */
+    boundingBox: BoundingBox | undefined;
+    /** Detection confidence score (0..1). */
+    confidence: number;
+    /** Numeric class identifier from the model. */
+    classId: number;
+    /** Human-readable class name. */
+    className: string;
+    /** Unique ID for tracking the same object across frames. */
+    trackingId: number;
+}
+/** A list of object detections from a single model for a single video frame. */
+export interface ModelDetections {
+    /** List of detections in the frame. */
+    detections: ObjectDetection[];
+    /** Which camera the detections are from. */
+    camera: Camera;
+    /** Width of the source image (px). */
+    imageWidth: number;
+    /** Height of the source image (px). */
+    imageHeight: number;
+    /** Name of the computer vision model that produced the detections. */
+    modelName: string;
+}
+/** Generic filter settings. */
+export interface FilterMessage {
+    /** If the filter is enabled. */
+    enabled: boolean;
+    /** Intensity of the filter (0..1). */
+    intensity: number;
+}
+/**
+ * Digital pan, tilt, and zoom state for the main camera.
+ *
+ * Only supported on X3 Ultra. Controls digital (not mechanical) zoom.
+ */
+export interface CameraPanTiltZoom {
+    /** Horizontal pan (-1.0..1.0), where 0.0 is center. */
+    pan: number;
+    /** Vertical tilt (-1.0..1.0), where 0.0 is center. */
+    tilt: number;
+    /** Zoom level (0.0..1.0), where 0.0 is no zoom and 1.0 is maximum zoom. */
+    zoom: number;
+}
+/**
+ * Information about the operator controlling the drone.
+ *
+ * Used to identify who started a dive, for reporting and when importing
+ * dives to Blueye Cloud.
+ */
+export interface OperatorInfo {
+    /** Full name of the operator. */
+    name: string;
+    /** E-mail address of the operator. */
+    email: string;
+}
 export declare const BinlogRecord: MessageFns<BinlogRecord>;
 export declare const LogEntry: MessageFns<LogEntry>;
+export declare const KernelLogEntry: MessageFns<KernelLogEntry>;
+export declare const KernelLogEntry_KeyValuePair: MessageFns<KernelLogEntry_KeyValuePair>;
 export declare const MotionInput: MessageFns<MotionInput>;
 export declare const Lights: MessageFns<Lights>;
 export declare const Laser: MessageFns<Laser>;
@@ -2016,8 +2311,21 @@ export declare const MultibeamFrameOffset: MessageFns<MultibeamFrameOffset>;
 export declare const MutltibeamRecordingIndex: MessageFns<MutltibeamRecordingIndex>;
 export declare const PersistentStorageSettings: MessageFns<PersistentStorageSettings>;
 export declare const CPUInfo: MessageFns<CPUInfo>;
+export declare const CpuCoreLoad: MessageFns<CpuCoreLoad>;
+export declare const GpuInfo: MessageFns<GpuInfo>;
+export declare const DlaInfo: MessageFns<DlaInfo>;
+export declare const MemoryInfo: MessageFns<MemoryInfo>;
+export declare const ThermalZone: MessageFns<ThermalZone>;
+export declare const VideoCodecInfo: MessageFns<VideoCodecInfo>;
+export declare const SystemPerformanceInfo: MessageFns<SystemPerformanceInfo>;
 export declare const SurfaceUnitBatteryInfo: MessageFns<SurfaceUnitBatteryInfo>;
 export declare const SurfaceUnitVersionInfo: MessageFns<SurfaceUnitVersionInfo>;
+export declare const BoundingBox: MessageFns<BoundingBox>;
+export declare const ObjectDetection: MessageFns<ObjectDetection>;
+export declare const ModelDetections: MessageFns<ModelDetections>;
+export declare const FilterMessage: MessageFns<FilterMessage>;
+export declare const CameraPanTiltZoom: MessageFns<CameraPanTiltZoom>;
+export declare const OperatorInfo: MessageFns<OperatorInfo>;
 type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
 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 {} ? {
     [K in keyof T]?: DeepPartial<T[K]>;