/* SPDX-License-Identifier: GPL-2.0-only WITH Linux-syscall-note */ /* * Copyright (c) 2016-2019, The Linux Foundation. All rights reserved. */ #ifndef __UAPI_CAM_SENSOR_H__ #define __UAPI_CAM_SENSOR_H__ #include #include #include #define CAM_SENSOR_PROBE_CMD (CAM_COMMON_OPCODE_MAX + 1) #define CAM_FLASH_MAX_LED_TRIGGERS 3 #define MAX_OIS_NAME_SIZE 32 #define MAX_RAINBOW_CONFIG_SIZE 32 #define CAM_CSIPHY_SECURE_MODE_ENABLED 1 enum rainbow_op_type { RAINBOW_SEQ_READ, RAINBOW_RANDOM_READ, RAINBOW_SEQ_WRITE, RAINBOW_RANDOM_WRITE, RAINBOW_ENABLE }; struct rainbow_config { enum rainbow_op_type operation; uint32_t size; uint32_t reg_addr[MAX_RAINBOW_CONFIG_SIZE]; uint32_t reg_data[MAX_RAINBOW_CONFIG_SIZE]; } __attribute__((packed)); #define RAINBOW_CONFIG \ _IOWR('R', 1, struct rainbow_config) /** * struct cam_sensor_query_cap - capabilities info for sensor * * @slot_info : Indicates about the slotId or cell Index * @secure_camera : Camera is in secure/Non-secure mode * @pos_pitch : Sensor position pitch * @pos_roll : Sensor position roll * @pos_yaw : Sensor position yaw * @actuator_slot_id : Actuator slot id which connected to sensor * @eeprom_slot_id : EEPROM slot id which connected to sensor * @ois_slot_id : OIS slot id which connected to sensor * @flash_slot_id : Flash slot id which connected to sensor * @csiphy_slot_id : CSIphy slot id which connected to sensor * */ struct cam_sensor_query_cap { uint32_t slot_info; uint32_t secure_camera; uint32_t pos_pitch; uint32_t pos_roll; uint32_t pos_yaw; uint32_t actuator_slot_id; uint32_t eeprom_slot_id; uint32_t ois_slot_id; uint32_t flash_slot_id; uint32_t csiphy_slot_id; } __attribute__((packed)); /** * struct cam_csiphy_query_cap - capabilities info for csiphy * * @slot_info : Indicates about the slotId or cell Index * @version : CSIphy version * @clk lane : Of the 5 lanes, informs lane configured * as clock lane * @reserved */ struct cam_csiphy_query_cap { uint32_t slot_info; uint32_t version; uint32_t clk_lane; uint32_t reserved; } __attribute__((packed)); /** * struct cam_actuator_query_cap - capabilities info for actuator * * @slot_info : Indicates about the slotId or cell Index * @reserved */ struct cam_actuator_query_cap { uint32_t slot_info; uint32_t reserved; } __attribute__((packed)); /** * struct cam_eeprom_query_cap_t - capabilities info for eeprom * * @slot_info : Indicates about the slotId or cell Index * @eeprom_kernel_probe : Indicates about the kernel or userspace probe */ struct cam_eeprom_query_cap_t { uint32_t slot_info; uint16_t eeprom_kernel_probe; uint16_t is_multimodule_mode; } __attribute__((packed)); /** * struct cam_ois_query_cap_t - capabilities info for ois * * @slot_info : Indicates about the slotId or cell Index */ struct cam_ois_query_cap_t { uint32_t slot_info; uint16_t reserved; } __attribute__((packed)); /** * struct cam_cmd_i2c_info - Contains slave I2C related info * * @slave_addr : Slave address * @i2c_freq_mode : 4 bits are used for I2c freq mode * @cmd_type : Explains type of command */ struct cam_cmd_i2c_info { uint32_t slave_addr; uint8_t i2c_freq_mode; uint8_t cmd_type; uint16_t reserved; } __attribute__((packed)); /** * struct cam_cmd_get_ois_data - Contains OIS data read cmd * * @reg_addr : register addr to read data from * @reg_data : number of bytes to read * @query_size_handle : handle to user space query_size address * @query_data_handle : handle to user space query_data address */ struct cam_cmd_get_ois_data { uint32_t reg_addr; uint32_t reg_data; uint64_t query_size_handle; uint64_t query_data_handle; } __attribute__((packed)); /** * struct cam_ois_shift - Contains OIS shift data * * @ois_shift_x : shift in x dim * @ois_shift_y : shift in y dim * @af_lop1 : shift in z dim with ois * @time_readout : time that the shift is read out */ struct cam_ois_shift { int16_t ois_shift_x; int16_t ois_shift_y; int32_t af_lop1; int64_t time_readout; } __attribute__((packed)); /** * struct cam_ois_opcode - Contains OIS opcode * * @prog : OIS FW prog register address * @coeff : OIS FW coeff register address * @pheripheral : OIS pheripheral * @memory : OIS memory */ struct cam_ois_opcode { uint32_t prog; uint32_t coeff; uint32_t pheripheral; uint32_t memory; } __attribute__((packed)); /** * struct cam_cmd_ois_info - Contains OIS slave info * * @slave_addr : OIS i2c slave address * @i2c_freq_mode : i2c frequency mode * @cmd_type : Explains type of command * @ois_fw_flag : indicates if fw is present or not * @is_ois_calib : indicates the calibration data is available * @ois_name : OIS name * @opcode : opcode */ struct cam_cmd_ois_info { uint32_t slave_addr; uint8_t i2c_freq_mode; uint8_t cmd_type; uint8_t ois_fw_flag; uint8_t is_ois_calib; char ois_name[MAX_OIS_NAME_SIZE]; struct cam_ois_opcode opcode; } __attribute__((packed)); /** * struct cam_cmd_probe - Contains sensor slave info * * @data_type : Slave register data type * @addr_type : Slave register address type * @op_code : Don't Care * @cmd_type : Explains type of command * @reg_addr : Slave register address * @expected_data : Data expected at slave register address * @data_mask : Data mask if only few bits are valid * @camera_id : Indicates the slot to which camera * needs to be probed * @fw_update_flag : Update OIS firmware * @reserved */ struct cam_cmd_probe { uint8_t data_type; uint8_t addr_type; uint8_t op_code; uint8_t cmd_type; uint32_t reg_addr; uint32_t expected_data; uint32_t data_mask; uint16_t camera_id; uint8_t fw_update_flag; uint16_t reserved; } __attribute__((packed)); /** * struct cam_power_settings - Contains sensor power setting info * * @power_seq_type : Type of power sequence * @reserved * @config_val_low : Lower 32 bit value configuration value * @config_val_high : Higher 32 bit value configuration value * */ struct cam_power_settings { uint16_t power_seq_type; uint16_t reserved; uint32_t config_val_low; uint32_t config_val_high; } __attribute__((packed)); /** * struct cam_cmd_power - Explains about the power settings * * @count : Number of power settings follows * @reserved * @cmd_type : Explains type of command * @power_settings : Contains power setting info */ struct cam_cmd_power { uint32_t count; uint8_t reserved; uint8_t cmd_type; uint16_t more_reserved; struct cam_power_settings power_settings[1]; } __attribute__((packed)); /** * struct i2c_rdwr_header - header of READ/WRITE I2C command * * @ count : Number of registers / data / reg-data pairs * @ op_code : Operation code * @ cmd_type : Command buffer type * @ data_type : I2C data type * @ addr_type : I2C address type * @ reserved */ struct i2c_rdwr_header { uint32_t count; uint8_t op_code; uint8_t cmd_type; uint8_t data_type; uint8_t addr_type; } __attribute__((packed)); /** * struct i2c_random_wr_payload - payload for I2C random write * * @ reg_addr : Register address * @ reg_data : Register data * */ struct i2c_random_wr_payload { uint32_t reg_addr; uint32_t reg_data; } __attribute__((packed)); /** * struct cam_cmd_i2c_random_wr - I2C random write command * @ header : header of READ/WRITE I2C command * @ random_wr_payload : payload for I2C random write */ struct cam_cmd_i2c_random_wr { struct i2c_rdwr_header header; struct i2c_random_wr_payload random_wr_payload[1]; } __attribute__((packed)); /** * struct cam_cmd_read - I2C read command * @ reg_data : Register data * @ reserved */ struct cam_cmd_read { uint32_t reg_data; uint32_t reserved; } __attribute__((packed)); /** * struct cam_cmd_i2c_continuous_wr - I2C continuous write command * @ header : header of READ/WRITE I2C command * @ reg_addr : Register address * @ data_read : I2C read command */ struct cam_cmd_i2c_continuous_wr { struct i2c_rdwr_header header; uint32_t reg_addr; struct cam_cmd_read data_read[1]; } __attribute__((packed)); /** * struct cam_cmd_i2c_random_rd - I2C random read command * @ header : header of READ/WRITE I2C command * @ data_read : I2C read command */ struct cam_cmd_i2c_random_rd { struct i2c_rdwr_header header; struct cam_cmd_read data_read[1]; } __attribute__((packed)); /** * struct cam_cmd_i2c_continuous_rd - I2C continuous continuous read command * @ header : header of READ/WRITE I2C command * @ reg_addr : Register address * */ struct cam_cmd_i2c_continuous_rd { struct i2c_rdwr_header header; uint32_t reg_addr; } __attribute__((packed)); /** * struct cam_cmd_conditional_wait - Conditional wait command * @data_type : Data type * @addr_type : Address type * @op_code : Opcode * @cmd_type : Explains type of command * @timeout : Timeout for retries * @reserved * @reg_addr : Register Address * @reg_data : Register data * @data_mask : Data mask if only few bits are valid * @camera_id : Indicates the slot to which camera * needs to be probed * */ struct cam_cmd_conditional_wait { uint8_t data_type; uint8_t addr_type; uint16_t reserved; uint8_t op_code; uint8_t cmd_type; uint16_t timeout; uint32_t reg_addr; uint32_t reg_data; uint32_t data_mask; } __attribute__((packed)); /** * struct cam_cmd_unconditional_wait - Un-conditional wait command * @delay : Delay * @op_code : Opcode * @cmd_type : Explains type of command */ struct cam_cmd_unconditional_wait { int16_t delay; int16_t reserved; uint8_t op_code; uint8_t cmd_type; uint16_t reserved1; } __attribute__((packed)); /** * cam_csiphy_info: Provides cmdbuffer structre * @lane_mask : Lane mask details * @lane_assign : Lane sensor will be using * @csiphy_3phase : Total number of lanes * @combo_mode : Info regarding combo_mode is enable / disable * @lane_cnt : Total number of lanes * @secure_mode : Secure mode flag to enable / disable * @3phase : Details whether 3Phase / 2Phase operation * @settle_time : Settling time in ms * @data_rate : Data rate * */ struct cam_csiphy_info { uint16_t lane_mask; uint16_t lane_assign; uint8_t csiphy_3phase; uint8_t combo_mode; uint8_t lane_cnt; uint8_t secure_mode; uint64_t settle_time; uint64_t data_rate; } __attribute__((packed)); /** * cam_csiphy_acquire_dev_info : Information needed for * csiphy at the time of acquire * @combo_mode : Indicates the device mode of operation * @reserved * */ struct cam_csiphy_acquire_dev_info { uint32_t combo_mode; uint32_t reserved; } __attribute__((packed)); /** * cam_sensor_acquire_dev : Updates sensor acuire cmd * @device_handle : Updates device handle * @session_handle : Session handle for acquiring device * @handle_type : Resource handle type * @reserved * @info_handle : Handle to additional info * needed for sensor sub modules * */ struct cam_sensor_acquire_dev { uint32_t session_handle; uint32_t device_handle; uint32_t handle_type; uint32_t reserved; uint64_t info_handle; } __attribute__((packed)); /** * cam_sensor_streamon_dev : StreamOn command for the sensor * @session_handle : Session handle for acquiring device * @device_handle : Updates device handle * @handle_type : Resource handle type * @reserved * @info_handle : Information Needed at the time of streamOn * */ struct cam_sensor_streamon_dev { uint32_t session_handle; uint32_t device_handle; uint32_t handle_type; uint32_t reserved; uint64_t info_handle; } __attribute__((packed)); /** * struct cam_cmd_get_sensor_data - Contains Sensor data read cmd * * @reg_addr : register addr to read data from * @reg_data : number of bytes to read * @query_size_handle : handle to user space query_size address * @query_data_handle : handle to user space query_data address */ struct cam_cmd_get_sensor_data { uint32_t reg_addr; uint32_t reg_data; uint64_t query_size_handle; uint64_t query_data_handle; } __attribute__((packed)); /** * struct cam_flash_init : Init command for the flash * @flash_type : flash hw type * @reserved * @cmd_type : command buffer type */ struct cam_flash_init { uint32_t flash_type; uint8_t reserved; uint8_t cmd_type; uint16_t reserved1; } __attribute__((packed)); /** * struct cam_flash_set_rer : RedEyeReduction command buffer * * @count : Number of flash leds * @opcode : Command buffer opcode * CAM_FLASH_FIRE_RER * @cmd_type : command buffer operation type * @num_iteration : Number of led turn on/off sequence * @reserved * @led_on_delay_ms : flash led turn on time in ms * @led_off_delay_ms : flash led turn off time in ms * @led_current_ma : flash led current in ma * */ struct cam_flash_set_rer { uint32_t count; uint8_t opcode; uint8_t cmd_type; uint16_t num_iteration; uint32_t led_on_delay_ms; uint32_t led_off_delay_ms; uint32_t led_current_ma[CAM_FLASH_MAX_LED_TRIGGERS]; } __attribute__((packed)); /** * struct cam_flash_set_on_off : led turn on/off command buffer * * @count : Number of Flash leds * @opcode : command buffer opcodes * CAM_FLASH_FIRE_LOW * CAM_FLASH_FIRE_HIGH * CAM_FLASH_OFF * @cmd_type : command buffer operation type * @led_current_ma : flash led current in ma * */ struct cam_flash_set_on_off { uint32_t count; uint8_t opcode; uint8_t cmd_type; uint16_t reserved; uint32_t led_current_ma[CAM_FLASH_MAX_LED_TRIGGERS]; } __attribute__((packed)); /** * struct cam_flash_query_curr : query current command buffer * * @reserved * @opcode : command buffer opcode * @cmd_type : command buffer operation type * @query_current_ma : battery current in ma * */ struct cam_flash_query_curr { uint16_t reserved; uint8_t opcode; uint8_t cmd_type; uint32_t query_current_ma; } __attribute__ ((packed)); /** * struct cam_flash_query_cap : capabilities info for flash * * @slot_info : Indicates about the slotId or cell Index * @max_current_flash : max supported current for flash * @max_duration_flash : max flash turn on duration * @max_current_torch : max supported current for torch * */ struct cam_flash_query_cap_info { uint32_t slot_info; uint32_t max_current_flash[CAM_FLASH_MAX_LED_TRIGGERS]; uint32_t max_duration_flash[CAM_FLASH_MAX_LED_TRIGGERS]; uint32_t max_current_torch[CAM_FLASH_MAX_LED_TRIGGERS]; } __attribute__ ((packed)); #endif