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,
};
 
/* Enable Automatic Brightness. */
#define VIDEO_CID_AUTOBRIGHTNESS (VIDEO_CID_BASE + 32)
 
#define VIDEO_CID_BAND_STOP_FILTER (VIDEO_CID_BASE + 33)
 
#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_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_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_ */