@blueyerobotics/protocol-definitions 3.2.0-10007c3e → 3.2.0-13a0ac0d

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. */
@@ -323,6 +346,8 @@ export declare enum FontSize {
     FONT_SIZE_PX35 = 5,
     /** FONT_SIZE_PX40 - 40 px. */
     FONT_SIZE_PX40 = 6,
+    /** FONT_SIZE_PX50 - 50 px. */
+    FONT_SIZE_PX50 = 7,
     UNRECOGNIZED = -1
 }
 export declare function fontSizeFromJSON(object: any): FontSize;
@@ -425,6 +450,8 @@ export declare enum GuestPortDeviceID {
     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;
@@ -510,6 +537,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.
  *
@@ -829,7 +868,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;
@@ -1402,6 +1441,31 @@ export interface TiltVelocity {
 /**
  * Information about the drone.
  *
+ * Information about a loaded computer vision model.
+ */
+export interface CvModelInfo {
+    /** Human-readable model name (from model_meta.json). */
+    name: string;
+    /** Type of CV model. */
+    type: CvModelInfo_ModelType;
+    /** Whether the model is currently running. */
+    running: boolean;
+    /** Execution provider (e.g. "cuda", "tensorrt"). */
+    device: string;
+    /** Package directory name (e.g. "tinyyolov2_package"). Stable identifier. */
+    packageId: string;
+    /** Class names the model can detect (indexed by class_id). */
+    labels: string[];
+}
+export declare enum CvModelInfo_ModelType {
+    MODEL_TYPE_UNSPECIFIED = 0,
+    MODEL_TYPE_DETECTION = 1,
+    MODEL_TYPE_SOT = 2,
+    UNRECOGNIZED = -1
+}
+export declare function cvModelInfo_ModelTypeFromJSON(object: any): CvModelInfo_ModelType;
+export declare function cvModelInfo_ModelTypeToJSON(object: CvModelInfo_ModelType): string;
+/**
  * This message contains serial numbers and version information for
  * internal components in the drone. Primarily used for diagnostics, or to
  * determine the origin of a logfile.
@@ -1429,6 +1493,8 @@ export interface DroneInfo {
     gp: GuestPortInfo | undefined;
     /** Type of depth sensor that is connected to the drone. */
     depthSensor: PressureSensorType;
+    /** List of loaded computer vision models. */
+    cvModels: CvModelInfo[];
 }
 /** Known error states for the drone. */
 export interface ErrorFlags {
@@ -1579,6 +1645,13 @@ export interface CameraParameters {
      * 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.
@@ -1944,7 +2017,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.
  */
@@ -1960,6 +2033,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.
  *
@@ -1991,6 +2177,123 @@ 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;
+}
+/**
+ * RLE-encoded binary segmentation mask relative to the bounding box.
+ *
+ * The mask bitmap has dimensions (mask_width x mask_height) covering the
+ * detection's bounding box area. The counts field stores run-length encoded
+ * data as packed uint16 little-endian: alternating background/foreground
+ * pixel runs starting with background.
+ */
+export interface SegmentationMask {
+    /** Width of the RLE bitmap. */
+    maskWidth: number;
+    /** Height of the RLE bitmap. */
+    maskHeight: number;
+    /** RLE counts as packed uint16 little-endian. */
+    counts: Uint8Array;
+}
+/** 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;
+    /** Instance segmentation mask (absent if model has no segmentation). */
+    mask: SegmentationMask | undefined;
+}
+/** 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;
+}
+/** Single-object tracking (SOT) state reported by the computer vision pipeline. */
+export interface SotState {
+    /** Current tracking state. */
+    state: SotState_State;
+    /** Current tracked bounding box (valid when TRACKING). */
+    boundingBox: BoundingBox | undefined;
+    /** Width of the source frame in pixels. */
+    imageWidth: number;
+    /** Height of the source frame in pixels. */
+    imageHeight: number;
+}
+/** Current state of the SOT tracker. */
+export declare enum SotState_State {
+    /** STATE_UNSPECIFIED - Unspecified state. */
+    STATE_UNSPECIFIED = 0,
+    /** STATE_IDLE - No target selected, waiting for a target bounding box. */
+    STATE_IDLE = 1,
+    /** STATE_TRACKING - Actively tracking a target. */
+    STATE_TRACKING = 2,
+    /** STATE_LOST - Target was lost (tracker failed to follow the object). */
+    STATE_LOST = 3,
+    UNRECOGNIZED = -1
+}
+export declare function sotState_StateFromJSON(object: any): SotState_State;
+export declare function sotState_StateToJSON(object: SotState_State): string;
 export declare const BinlogRecord: MessageFns<BinlogRecord>;
 export declare const LogEntry: MessageFns<LogEntry>;
 export declare const KernelLogEntry: MessageFns<KernelLogEntry>;
@@ -2054,6 +2357,7 @@ export declare const IperfStatus: MessageFns<IperfStatus>;
 export declare const NStreamers: MessageFns<NStreamers>;
 export declare const TiltAngle: MessageFns<TiltAngle>;
 export declare const TiltVelocity: MessageFns<TiltVelocity>;
+export declare const CvModelInfo: MessageFns<CvModelInfo>;
 export declare const DroneInfo: MessageFns<DroneInfo>;
 export declare const ErrorFlags: MessageFns<ErrorFlags>;
 export declare const CameraParameters: MessageFns<CameraParameters>;
@@ -2080,8 +2384,23 @@ 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 SegmentationMask: MessageFns<SegmentationMask>;
+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>;
+export declare const SotState: MessageFns<SotState>;
 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]>;