video-controls.h

Go to the documentation of this file.

/*
 * Copyright (c) 2019 Linaro Limited.
 * Copyright (c) 2024 tinyVision.ai Inc.
 * Copyright 2025 NXP
 *
 * SPDX-License-Identifier: Apache-2.0
 */
#ifndef ZEPHYR_INCLUDE_VIDEO_CONTROLS_H_
#define ZEPHYR_INCLUDE_VIDEO_CONTROLS_H_


 
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif

#define VIDEO_CID_BASE 0x00980900

#define VIDEO_CID_BRIGHTNESS (VIDEO_CID_BASE + 0)

#define VIDEO_CID_CONTRAST (VIDEO_CID_BASE + 1)

#define VIDEO_CID_SATURATION (VIDEO_CID_BASE + 2)

#define VIDEO_CID_HUE (VIDEO_CID_BASE + 3)

#define VIDEO_CID_AUTO_WHITE_BALANCE (VIDEO_CID_BASE + 12)

#define VIDEO_CID_RED_BALANCE (VIDEO_CID_BASE + 14)

#define VIDEO_CID_BLUE_BALANCE (VIDEO_CID_BASE + 15)

#define VIDEO_CID_GAMMA (VIDEO_CID_BASE + 16)

#define VIDEO_CID_EXPOSURE (VIDEO_CID_BASE + 17)

#define VIDEO_CID_AUTOGAIN (VIDEO_CID_BASE + 18)

#define VIDEO_CID_GAIN (VIDEO_CID_BASE + 19)

#define VIDEO_CID_HFLIP (VIDEO_CID_BASE + 20)

#define VIDEO_CID_VFLIP (VIDEO_CID_BASE + 21)

#define VIDEO_CID_POWER_LINE_FREQUENCY (VIDEO_CID_BASE + 24)

enum video_power_line_frequency {
        VIDEO_CID_POWER_LINE_FREQUENCY_DISABLED = 0, 
        VIDEO_CID_POWER_LINE_FREQUENCY_50HZ = 1,     
        VIDEO_CID_POWER_LINE_FREQUENCY_60HZ = 2,     
        VIDEO_CID_POWER_LINE_FREQUENCY_AUTO = 3,     
};

#define VIDEO_CID_HUE_AUTO (VIDEO_CID_BASE + 25)

#define VIDEO_CID_WHITE_BALANCE_TEMPERATURE (VIDEO_CID_BASE + 26)

#define VIDEO_CID_SHARPNESS (VIDEO_CID_BASE + 27)

#define VIDEO_CID_BACKLIGHT_COMPENSATION (VIDEO_CID_BASE + 28)

#define VIDEO_CID_COLORFX (VIDEO_CID_BASE + 31)

enum video_colorfx {
        VIDEO_COLORFX_NONE = 0,          
        VIDEO_COLORFX_BW = 1,            
        VIDEO_COLORFX_SEPIA = 2,         
        VIDEO_COLORFX_NEGATIVE = 3,      
        VIDEO_COLORFX_EMBOSS = 4,        
        VIDEO_COLORFX_SKETCH = 5,        
        VIDEO_COLORFX_SKY_BLUE = 6,      
        VIDEO_COLORFX_GRASS_GREEN = 7,   
        VIDEO_COLORFX_SKIN_WHITEN = 8,   
        VIDEO_COLORFX_VIVID = 9,         
        VIDEO_COLORFX_AQUA = 10,         
        VIDEO_COLORFX_ART_FREEZE = 11,   
        VIDEO_COLORFX_SILHOUETTE = 12,   
        VIDEO_COLORFX_SOLARIZATION = 13, 
        VIDEO_COLORFX_ANTIQUE = 14,      
};

#define VIDEO_CID_AUTOBRIGHTNESS (VIDEO_CID_BASE + 32)

#define VIDEO_CID_BAND_STOP_FILTER (VIDEO_CID_BASE + 33)

#define VIDEO_CID_ROTATE (VIDEO_CID_BASE + 34)

#define VIDEO_CID_ALPHA_COMPONENT (VIDEO_CID_BASE + 41)

#define VIDEO_CID_LASTP1 (VIDEO_CID_BASE + 44)


#define VIDEO_CID_CODEC_CLASS_BASE 0x00990900


#define VIDEO_CID_CAMERA_CLASS_BASE 0x009a0900

#define VIDEO_CID_EXPOSURE_AUTO (VIDEO_CID_CAMERA_CLASS_BASE + 1)

enum video_exposure_type {
        VIDEO_EXPOSURE_AUTO = 0,             
        VIDEO_EXPOSURE_MANUAL = 1,           
        VIDEO_EXPOSURE_SHUTTER_PRIORITY = 2, 
        VIDEO_EXPOSURE_APERTURE_PRIORITY = 3 
};

#define VIDEO_CID_EXPOSURE_ABSOLUTE (VIDEO_CID_CAMERA_CLASS_BASE + 2)

#define VIDEO_CID_EXPOSURE_AUTO_PRIORITY (VIDEO_CID_CAMERA_CLASS_BASE + 3)

#define VIDEO_CID_PAN_RELATIVE (VIDEO_CID_CAMERA_CLASS_BASE + 4)

#define VIDEO_CID_TILT_RELATIVE (VIDEO_CID_CAMERA_CLASS_BASE + 5)

#define VIDEO_CID_PAN_ABSOLUTE (VIDEO_CID_CAMERA_CLASS_BASE + 8)

#define VIDEO_CID_TILT_ABSOLUTE (VIDEO_CID_CAMERA_CLASS_BASE + 9)

#define VIDEO_CID_FOCUS_ABSOLUTE (VIDEO_CID_CAMERA_CLASS_BASE + 10)

#define VIDEO_CID_FOCUS_RELATIVE (VIDEO_CID_CAMERA_CLASS_BASE + 11)

#define VIDEO_CID_FOCUS_AUTO (VIDEO_CID_CAMERA_CLASS_BASE + 12)

#define VIDEO_CID_ZOOM_ABSOLUTE (VIDEO_CID_CAMERA_CLASS_BASE + 13)

#define VIDEO_CID_ZOOM_RELATIVE (VIDEO_CID_CAMERA_CLASS_BASE + 14)

#define VIDEO_CID_ZOOM_CONTINUOUS (VIDEO_CID_CAMERA_CLASS_BASE + 15)

#define VIDEO_CID_IRIS_ABSOLUTE (VIDEO_CID_CAMERA_CLASS_BASE + 17)

#define VIDEO_CID_IRIS_RELATIVE (VIDEO_CID_CAMERA_CLASS_BASE + 18)

#define VIDEO_CID_AUTO_EXPOSURE_BIAS (VIDEO_CID_CAMERA_CLASS_BASE + 19)

#define VIDEO_CID_WIDE_DYNAMIC_RANGE (VIDEO_CID_CAMERA_CLASS_BASE + 21)

#define VIDEO_CID_PAN_SPEED (VIDEO_CID_CAMERA_CLASS_BASE + 32)

#define VIDEO_CID_TILT_SPEED (VIDEO_CID_CAMERA_CLASS_BASE + 33)

#define VIDEO_CID_CAMERA_ORIENTATION (VIDEO_CID_CAMERA_CLASS_BASE + 34)

enum video_camera_orientation {
        VIDEO_CAMERA_ORIENTATION_FRONT = 0,
        VIDEO_CAMERA_ORIENTATION_BACK = 1,
        VIDEO_CAMERA_ORIENTATION_EXTERNAL = 2,
};

#define VIDEO_CID_CAMERA_SENSOR_ROTATION (VIDEO_CID_CAMERA_CLASS_BASE + 35)


#define VIDEO_CID_FLASH_CLASS_BASE 0x009c0900


#define VIDEO_CID_JPEG_CLASS_BASE 0x009d0900

#define VIDEO_CID_JPEG_COMPRESSION_QUALITY (VIDEO_CID_JPEG_CLASS_BASE + 3)


#define VIDEO_CID_IMAGE_SOURCE_CLASS_BASE 0x009e0900

#define VIDEO_CID_ANALOGUE_GAIN (VIDEO_CID_IMAGE_SOURCE_CLASS_BASE + 3)


#define VIDEO_CID_IMAGE_PROC_CLASS_BASE 0x009f0900

#define VIDEO_CID_LINK_FREQ (VIDEO_CID_IMAGE_PROC_CLASS_BASE + 1)

#define VIDEO_CID_PIXEL_RATE (VIDEO_CID_IMAGE_PROC_CLASS_BASE + 2)

#define VIDEO_CID_TEST_PATTERN (VIDEO_CID_IMAGE_PROC_CLASS_BASE + 3)

#define VIDEO_CID_DIGITAL_GAIN (VIDEO_CID_IMAGE_PROC_CLASS_BASE + 5)


#define VIDEO_CID_PRIVATE_BASE 0x08000000


#define VIDEO_CTRL_FLAG_NEXT_CTRL 0x80000000



struct video_control {
        uint32_t id;
        union {
                int32_t val;
                int64_t val64;
        };
};

struct video_ctrl_range {
        union {
                int32_t min;
                int64_t min64;
        };
        union {
                int32_t max;
                int64_t max64;
        };
        union {
                int32_t step;
                int64_t step64;
        };
        union {
                int32_t def;
                int64_t def64;
        };
};

struct video_ctrl_query {
        const struct device *dev;
        uint32_t id;
        uint32_t type;
        const char *name;
        uint32_t flags;
        struct video_ctrl_range range;
        union {
                const char *const *menu;
                const int64_t *int_menu;
        };
};

 
#ifdef __cplusplus
}
#endif

 
#endif /* ZEPHYR_INCLUDE_VIDEO_H_ */