a9c89d1f41
Currently, camnoc buffer fill level register offsets are part of cpas monitoring. Register offsets keep changing between targets which would bring more conditionals. Make cpas monitoring generic by moving register offsets to header. Also, the reg values will be read in a buffer, and it can be controlled what offset needs to be read, by changing status in header to be enable/disable. Also, move camnoc fill level printing to CPAS for when we need only buffer fill info. CRs-Fixed: 2841729 Change-Id: I05425b4466d33dbef80eb8a0a1b5e974a6965600 Signed-off-by: Mukund Madhusudan Atre <matre@codeaurora.org>
783 lines
22 KiB
C
783 lines
22 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
/*
|
|
* Copyright (c) 2017-2021, The Linux Foundation. All rights reserved.
|
|
*/
|
|
|
|
#ifndef _CAM_CPAS_API_H_
|
|
#define _CAM_CPAS_API_H_
|
|
|
|
#include <linux/device.h>
|
|
#include <linux/platform_device.h>
|
|
|
|
#include <media/cam_cpas.h>
|
|
#include "cam_soc_util.h"
|
|
|
|
#define CAM_HW_IDENTIFIER_LENGTH 128
|
|
|
|
/* Default AXI Bandwidth vote */
|
|
#define CAM_CPAS_DEFAULT_AXI_BW 1024
|
|
|
|
#define CAM_CPAS_MAX_PATHS_PER_CLIENT 15
|
|
#define CAM_CPAS_API_PATH_DATA_STD_START 512
|
|
|
|
/* Qos Selection mask */
|
|
#define CAM_CPAS_QOS_DEFAULT_SETTINGS_MASK 0x1
|
|
#define CAM_CPAS_QOS_CUSTOM_SETTINGS_MASK 0x2
|
|
|
|
/**
|
|
* enum cam_cpas_reg_base - Enum for register base identifier. These
|
|
* are the identifiers used in generic register
|
|
* write/read APIs provided by cpas driver.
|
|
*/
|
|
enum cam_cpas_reg_base {
|
|
CAM_CPAS_REG_CPASTOP,
|
|
CAM_CPAS_REG_CAMNOC,
|
|
CAM_CPAS_REG_CAMSS,
|
|
CAM_CPAS_REG_RPMH,
|
|
CAM_CPAS_REG_MAX
|
|
};
|
|
|
|
/**
|
|
* enum cam_cpas_hw_index - Enum for identify HW index
|
|
*/
|
|
enum cam_cpas_hw_index {
|
|
CAM_CPAS_HW_IDX_ANY = 0,
|
|
CAM_CPAS_HW_IDX_0 = 1<<0,
|
|
CAM_CPAS_HW_IDX_1 = 1<<1,
|
|
CAM_CPAS_HW_IDX_2 = 1<<2,
|
|
CAM_CPAS_HW_IDX_3 = 1<<3,
|
|
CAM_CPAS_HW_IDX_4 = 1<<4,
|
|
CAM_CPAS_HW_IDX_5 = 1<<5,
|
|
CAM_CPAS_HW_IDX_6 = 1<<6,
|
|
CAM_CPAS_HW_IDX_7 = 1<<7,
|
|
CAM_CPAS_HW_IDX_MAX = 1<<8
|
|
};
|
|
|
|
/**
|
|
* enum cam_cpas_camera_version Enum for Titan Camera Versions
|
|
*/
|
|
enum cam_cpas_camera_version {
|
|
CAM_CPAS_CAMERA_VERSION_NONE = 0,
|
|
CAM_CPAS_CAMERA_VERSION_150 = 0x00010500,
|
|
CAM_CPAS_CAMERA_VERSION_170 = 0x00010700,
|
|
CAM_CPAS_CAMERA_VERSION_175 = 0x00010705,
|
|
CAM_CPAS_CAMERA_VERSION_480 = 0x00040800,
|
|
CAM_CPAS_CAMERA_VERSION_520 = 0x00050200,
|
|
CAM_CPAS_CAMERA_VERSION_540 = 0x00050400,
|
|
CAM_CPAS_CAMERA_VERSION_580 = 0x00050800,
|
|
CAM_CPAS_CAMERA_VERSION_545 = 0x00050405,
|
|
CAM_CPAS_CAMERA_VERSION_570 = 0x00050700,
|
|
CAM_CPAS_CAMERA_VERSION_680 = 0x00060800,
|
|
CAM_CPAS_CAMERA_VERSION_165 = 0x00010605,
|
|
CAM_CPAS_CAMERA_VERSION_MAX
|
|
};
|
|
|
|
/**
|
|
* enum cam_cpas_version Enum for Titan CPAS Versions
|
|
*/
|
|
enum cam_cpas_version {
|
|
CAM_CPAS_VERSION_NONE = 0,
|
|
CAM_CPAS_VERSION_100 = 0x10000000,
|
|
CAM_CPAS_VERSION_101 = 0x10000001,
|
|
CAM_CPAS_VERSION_110 = 0x10010000,
|
|
CAM_CPAS_VERSION_120 = 0x10020000,
|
|
CAM_CPAS_VERSION_130 = 0x10030000,
|
|
CAM_CPAS_VERSION_200 = 0x20000000,
|
|
CAM_CPAS_VERSION_MAX
|
|
};
|
|
|
|
/**
|
|
* enum cam_cpas_camera_version_map_id Enum for camera version map id
|
|
* This enum is mapped with cam_cpas_camera_version
|
|
*/
|
|
enum cam_cpas_camera_version_map_id {
|
|
CAM_CPAS_CAMERA_VERSION_ID_150 = 0x0,
|
|
CAM_CPAS_CAMERA_VERSION_ID_170 = 0x1,
|
|
CAM_CPAS_CAMERA_VERSION_ID_175 = 0x2,
|
|
CAM_CPAS_CAMERA_VERSION_ID_480 = 0x3,
|
|
CAM_CPAS_CAMERA_VERSION_ID_580 = 0x4,
|
|
CAM_CPAS_CAMERA_VERSION_ID_520 = 0x5,
|
|
CAM_CPAS_CAMERA_VERSION_ID_540 = 0x6,
|
|
CAM_CPAS_CAMERA_VERSION_ID_545 = 0x7,
|
|
CAM_CPAS_CAMERA_VERSION_ID_570 = 0x8,
|
|
CAM_CPAS_CAMERA_VERSION_ID_680 = 0x9,
|
|
CAM_CPAS_CAMERA_VERSION_ID_165 = 0xA,
|
|
CAM_CPAS_CAMERA_VERSION_ID_MAX
|
|
};
|
|
|
|
/**
|
|
* enum cam_cpas_version_map_id Enum for cpas version map id
|
|
* This enum is mapped with cam_cpas_version
|
|
*/
|
|
enum cam_cpas_version_map_id {
|
|
CAM_CPAS_VERSION_ID_100 = 0x0,
|
|
CAM_CPAS_VERSION_ID_101 = 0x1,
|
|
CAM_CPAS_VERSION_ID_110 = 0x2,
|
|
CAM_CPAS_VERSION_ID_120 = 0x3,
|
|
CAM_CPAS_VERSION_ID_130 = 0x4,
|
|
CAM_CPAS_VERSION_ID_200 = 0x5,
|
|
CAM_CPAS_VERSION_ID_MAX
|
|
};
|
|
|
|
/**
|
|
* enum cam_cpas_hw_version - Enum for Titan CPAS HW Versions
|
|
*/
|
|
enum cam_cpas_hw_version {
|
|
CAM_CPAS_TITAN_NONE = 0,
|
|
CAM_CPAS_TITAN_150_V100 = 0x150100,
|
|
CAM_CPAS_TITAN_165_V100 = 0x165100,
|
|
CAM_CPAS_TITAN_170_V100 = 0x170100,
|
|
CAM_CPAS_TITAN_170_V110 = 0x170110,
|
|
CAM_CPAS_TITAN_170_V120 = 0x170120,
|
|
CAM_CPAS_TITAN_170_V200 = 0x170200,
|
|
CAM_CPAS_TITAN_175_V100 = 0x175100,
|
|
CAM_CPAS_TITAN_175_V101 = 0x175101,
|
|
CAM_CPAS_TITAN_175_V120 = 0x175120,
|
|
CAM_CPAS_TITAN_175_V130 = 0x175130,
|
|
CAM_CPAS_TITAN_480_V100 = 0x480100,
|
|
CAM_CPAS_TITAN_580_V100 = 0x580100,
|
|
CAM_CPAS_TITAN_540_V100 = 0x540100,
|
|
CAM_CPAS_TITAN_520_V100 = 0x520100,
|
|
CAM_CPAS_TITAN_545_V100 = 0x545100,
|
|
CAM_CPAS_TITAN_570_V200 = 0x570200,
|
|
CAM_CPAS_TITAN_680_V100 = 0x680100,
|
|
CAM_CPAS_TITAN_MAX
|
|
};
|
|
|
|
/**
|
|
* enum cam_camnoc_irq_type - Enum for camnoc irq types
|
|
*
|
|
* @CAM_CAMNOC_IRQ_SLAVE_ERROR: Each slave port in CAMNOC (3 QSB ports and
|
|
* 1 QHB port) has an error logger. The error
|
|
* observed at any slave port is logged into
|
|
* the error logger register and an IRQ is
|
|
* triggered
|
|
* @CAM_CAMNOC_IRQ_IFE_UBWC_ENCODE_ERROR : Triggered if any error detected
|
|
* in the IFE UBWC encoder instance
|
|
* @CAM_CAMNOC_IRQ_IFE_UBWC_STATS_ENCODE_ERROR: Triggered if any error detected
|
|
* in the IFE UBWC-Stats encoder
|
|
* instance
|
|
* @CAM_CAMNOC_IRQ_IFE02_UBWC_ENCODE_ERROR : Triggered if any error detected
|
|
* in the IFE0 UBWC encoder instance
|
|
* @CAM_CAMNOC_IRQ_IFE13_UBWC_ENCODE_ERROR : Triggered if any error detected
|
|
* in the IFE1 or IFE3 UBWC encoder
|
|
* instance
|
|
* @CAM_CAMNOC_IRQ_IFE0_UBWC_ENCODE_ERROR : Triggered if any error detected
|
|
* in the IFE0 UBWC encoder instance
|
|
* @CAM_CAMNOC_IRQ_IFE1_WR_UBWC_ENCODE_ERROR : Triggered if any error detected
|
|
* in the IFE1 UBWC encoder
|
|
* instance
|
|
* @CAM_CAMNOC_IRQ_IPE_UBWC_ENCODE_ERROR : Triggered if any error detected
|
|
* in the IPE write path encoder
|
|
* instance
|
|
* @CAM_CAMNOC_IRQ_BPS_UBWC_ENCODE_ERROR : Triggered if any error detected
|
|
* in the BPS write path encoder
|
|
* instance
|
|
* @CAM_CAMNOC_IRQ_IPE1_BPS_UBWC_DECODE_ERROR: Triggered if any error detected
|
|
* in the IPE1/BPS read path decoder
|
|
* instance
|
|
* @CAM_CAMNOC_IRQ_IPE0_UBWC_DECODE_ERROR : Triggered if any error detected
|
|
* in the IPE0 read path decoder
|
|
* instance
|
|
* @CAM_CAMNOC_IRQ_IPE1_UBWC_DECODE_ERROR : Triggered if any error detected
|
|
* in the IPE1 read path decoder
|
|
* instance
|
|
* @CAM_CAMNOC_IRQ_IPE_BPS_UBWC_DECODE_ERROR: Triggered if any error detected
|
|
* in the IPE/BPS UBWC decoder
|
|
* instance
|
|
* @CAM_CAMNOC_IRQ_IPE_BPS_UBWC_ENCODE_ERROR: Triggered if any error detected
|
|
* in the IPE/BPS UBWC encoder
|
|
* instance
|
|
* @CAM_CAMNOC_IRQ_AHB_TIMEOUT : Triggered when the QHS_ICP slave
|
|
* times out after 4000 AHB cycles
|
|
*/
|
|
enum cam_camnoc_irq_type {
|
|
CAM_CAMNOC_IRQ_SLAVE_ERROR,
|
|
CAM_CAMNOC_IRQ_IFE_UBWC_ENCODE_ERROR,
|
|
CAM_CAMNOC_IRQ_IFE_UBWC_STATS_ENCODE_ERROR,
|
|
CAM_CAMNOC_IRQ_IFE_UBWC_STATS_1_ENCODE_ERROR,
|
|
CAM_CAMNOC_IRQ_IFE02_UBWC_ENCODE_ERROR,
|
|
CAM_CAMNOC_IRQ_IFE13_UBWC_ENCODE_ERROR,
|
|
CAM_CAMNOC_IRQ_IFE0_UBWC_ENCODE_ERROR,
|
|
CAM_CAMNOC_IRQ_IFE1_WRITE_UBWC_ENCODE_ERROR,
|
|
CAM_CAMNOC_IRQ_IPE_UBWC_ENCODE_ERROR,
|
|
CAM_CAMNOC_IRQ_BPS_UBWC_ENCODE_ERROR,
|
|
CAM_CAMNOC_IRQ_IPE1_BPS_UBWC_DECODE_ERROR,
|
|
CAM_CAMNOC_IRQ_IPE0_UBWC_DECODE_ERROR,
|
|
CAM_CAMNOC_IRQ_IPE1_UBWC_DECODE_ERROR,
|
|
CAM_CAMNOC_IRQ_IPE_BPS_UBWC_DECODE_ERROR,
|
|
CAM_CAMNOC_IRQ_IPE_BPS_UBWC_ENCODE_ERROR,
|
|
CAM_CAMNOC_IRQ_AHB_TIMEOUT,
|
|
};
|
|
|
|
|
|
/**
|
|
* enum cam_sys_cache_config_types - Enum for camera llc's
|
|
*/
|
|
enum cam_sys_cache_config_types {
|
|
CAM_LLCC_SMALL_1 = 0,
|
|
CAM_LLCC_SMALL_2 = 1,
|
|
CAM_LLCC_MAX = 2,
|
|
};
|
|
|
|
/**
|
|
* struct cam_camnoc_irq_slave_err_data : Data for Slave error.
|
|
*
|
|
* @mainctrl : Err logger mainctrl info
|
|
* @errvld : Err logger errvld info
|
|
* @errlog0_low : Err logger errlog0_low info
|
|
* @errlog0_high : Err logger errlog0_high info
|
|
* @errlog1_low : Err logger errlog1_low info
|
|
* @errlog1_high : Err logger errlog1_high info
|
|
* @errlog2_low : Err logger errlog2_low info
|
|
* @errlog2_high : Err logger errlog2_high info
|
|
* @errlog3_low : Err logger errlog3_low info
|
|
* @errlog3_high : Err logger errlog3_high info
|
|
*
|
|
*/
|
|
struct cam_camnoc_irq_slave_err_data {
|
|
union {
|
|
struct {
|
|
uint32_t stall_en : 1; /* bit 0 */
|
|
uint32_t fault_en : 1; /* bit 1 */
|
|
uint32_t rsv : 30; /* bits 2-31 */
|
|
};
|
|
uint32_t value;
|
|
} mainctrl;
|
|
union {
|
|
struct {
|
|
uint32_t err_vld : 1; /* bit 0 */
|
|
uint32_t rsv : 31; /* bits 1-31 */
|
|
};
|
|
uint32_t value;
|
|
} errvld;
|
|
union {
|
|
struct {
|
|
uint32_t loginfo_vld : 1; /* bit 0 */
|
|
uint32_t word_error : 1; /* bit 1 */
|
|
uint32_t non_secure : 1; /* bit 2 */
|
|
uint32_t device : 1; /* bit 3 */
|
|
uint32_t opc : 3; /* bits 4 - 6 */
|
|
uint32_t rsv0 : 1; /* bit 7 */
|
|
uint32_t err_code : 3; /* bits 8 - 10 */
|
|
uint32_t sizef : 3; /* bits 11 - 13 */
|
|
uint32_t rsv1 : 2; /* bits 14 - 15 */
|
|
uint32_t addr_space : 6; /* bits 16 - 21 */
|
|
uint32_t rsv2 : 10; /* bits 22 - 31 */
|
|
};
|
|
uint32_t value;
|
|
} errlog0_low;
|
|
union {
|
|
struct {
|
|
uint32_t len1 : 10; /* bits 0 - 9 */
|
|
uint32_t rsv : 22; /* bits 10 - 31 */
|
|
};
|
|
uint32_t value;
|
|
} errlog0_high;
|
|
union {
|
|
struct {
|
|
uint32_t path : 16; /* bits 0 - 15 */
|
|
uint32_t rsv : 16; /* bits 16 - 31 */
|
|
};
|
|
uint32_t value;
|
|
} errlog1_low;
|
|
union {
|
|
struct {
|
|
uint32_t extid : 18; /* bits 0 - 17 */
|
|
uint32_t rsv : 14; /* bits 18 - 31 */
|
|
};
|
|
uint32_t value;
|
|
} errlog1_high;
|
|
union {
|
|
struct {
|
|
uint32_t errlog2_lsb : 32; /* bits 0 - 31 */
|
|
};
|
|
uint32_t value;
|
|
} errlog2_low;
|
|
union {
|
|
struct {
|
|
uint32_t errlog2_msb : 16; /* bits 0 - 16 */
|
|
uint32_t rsv : 16; /* bits 16 - 31 */
|
|
};
|
|
uint32_t value;
|
|
} errlog2_high;
|
|
union {
|
|
struct {
|
|
uint32_t errlog3_lsb : 32; /* bits 0 - 31 */
|
|
};
|
|
uint32_t value;
|
|
} errlog3_low;
|
|
union {
|
|
struct {
|
|
uint32_t errlog3_msb : 32; /* bits 0 - 31 */
|
|
};
|
|
uint32_t value;
|
|
} errlog3_high;
|
|
};
|
|
|
|
/**
|
|
* struct cam_camnoc_irq_ubwc_enc_data : Data for UBWC Encode error.
|
|
*
|
|
* @encerr_status : Encode error status
|
|
*
|
|
*/
|
|
struct cam_camnoc_irq_ubwc_enc_data {
|
|
union {
|
|
struct {
|
|
uint32_t encerrstatus : 3; /* bits 0 - 2 */
|
|
uint32_t rsv : 29; /* bits 3 - 31 */
|
|
};
|
|
uint32_t value;
|
|
} encerr_status;
|
|
};
|
|
|
|
/**
|
|
* struct cam_camnoc_irq_ubwc_dec_data : Data for UBWC Decode error.
|
|
*
|
|
* @decerr_status : Decoder error status
|
|
* @thr_err : Set to 1 if
|
|
* At least one of the bflc_len fields in the bit steam exceeds
|
|
* its threshold value. This error is possible only for
|
|
* RGBA1010102, TP10, and RGB565 formats
|
|
* @fcl_err : Set to 1 if
|
|
* Fast clear with a legal non-RGB format
|
|
* @len_md_err : Set to 1 if
|
|
* The calculated burst length does not match burst length
|
|
* specified by the metadata value
|
|
* @format_err : Set to 1 if
|
|
* Illegal format
|
|
* 1. bad format :2,3,6
|
|
* 2. For 32B MAL, metadata=6
|
|
* 3. For 32B MAL RGB565, Metadata != 0,1,7
|
|
* 4. For 64B MAL RGB565, metadata[3:1] == 1,2
|
|
*
|
|
*/
|
|
struct cam_camnoc_irq_ubwc_dec_data {
|
|
union {
|
|
struct {
|
|
uint32_t thr_err : 1; /* bit 0 */
|
|
uint32_t fcl_err : 1; /* bit 1 */
|
|
uint32_t len_md_err : 1; /* bit 2 */
|
|
uint32_t format_err : 1; /* bit 3 */
|
|
uint32_t rsv : 28; /* bits 4 - 31 */
|
|
};
|
|
uint32_t value;
|
|
} decerr_status;
|
|
};
|
|
|
|
struct cam_camnoc_irq_ahb_timeout_data {
|
|
uint32_t data;
|
|
};
|
|
|
|
/**
|
|
* struct cam_cpas_irq_data : CAMNOC IRQ data
|
|
*
|
|
* @irq_type : To identify the type of IRQ
|
|
* @u : Union of irq err data information
|
|
* @slave_err : Data for Slave error.
|
|
* Valid if type is CAM_CAMNOC_IRQ_SLAVE_ERROR
|
|
* @enc_err : Data for UBWC Encode error.
|
|
* Valid if type is one of below:
|
|
* CAM_CAMNOC_IRQ_IFE02_UBWC_ENCODE_ERROR
|
|
* CAM_CAMNOC_IRQ_IFE13_UBWC_ENCODE_ERROR
|
|
* CAM_CAMNOC_IRQ_IPE_BPS_UBWC_ENCODE_ERROR
|
|
* @dec_err : Data for UBWC Decode error.
|
|
* Valid if type is CAM_CAMNOC_IRQ_IPE_BPS_UBWC_DECODE_ERROR
|
|
* @ahb_err : Data for Slave error.
|
|
* Valid if type is CAM_CAMNOC_IRQ_AHB_TIMEOUT
|
|
*
|
|
*/
|
|
struct cam_cpas_irq_data {
|
|
enum cam_camnoc_irq_type irq_type;
|
|
union {
|
|
struct cam_camnoc_irq_slave_err_data slave_err;
|
|
struct cam_camnoc_irq_ubwc_enc_data enc_err;
|
|
struct cam_camnoc_irq_ubwc_dec_data dec_err;
|
|
struct cam_camnoc_irq_ahb_timeout_data ahb_err;
|
|
} u;
|
|
};
|
|
|
|
/**
|
|
* struct cam_cpas_register_params : Register params for cpas client
|
|
*
|
|
* @identifier : Input identifier string which is the device label
|
|
* from dt like vfe, ife, jpeg etc
|
|
* @cell_index : Input integer identifier pointing to the cell index
|
|
* from dt of the device. This can be used to form a
|
|
* unique string with @identifier like vfe0, ife1,
|
|
* jpeg0, etc
|
|
* @dev : device handle
|
|
* @userdata : Input private data which will be passed as
|
|
* an argument while callback.
|
|
* @cam_cpas_callback : Input callback pointer for triggering the
|
|
* callbacks from CPAS driver.
|
|
* @client_handle : CPAS client handle
|
|
* @userdata : User data given at the time of register
|
|
* @event_type : event type
|
|
* @event_data : event data
|
|
* @client_handle : Output Unique handle generated for this register
|
|
*
|
|
*/
|
|
struct cam_cpas_register_params {
|
|
char identifier[CAM_HW_IDENTIFIER_LENGTH];
|
|
uint32_t cell_index;
|
|
struct device *dev;
|
|
void *userdata;
|
|
bool (*cam_cpas_client_cb)(
|
|
uint32_t client_handle,
|
|
void *userdata,
|
|
struct cam_cpas_irq_data *irq_data);
|
|
uint32_t client_handle;
|
|
};
|
|
|
|
/**
|
|
* enum cam_vote_type - Enum for voting type
|
|
*
|
|
* @CAM_VOTE_ABSOLUTE : Absolute vote
|
|
* @CAM_VOTE_DYNAMIC : Dynamic vote
|
|
*/
|
|
enum cam_vote_type {
|
|
CAM_VOTE_ABSOLUTE,
|
|
CAM_VOTE_DYNAMIC,
|
|
};
|
|
|
|
/**
|
|
* struct cam_ahb_vote : AHB vote
|
|
*
|
|
* @type : AHB voting type.
|
|
* CAM_VOTE_ABSOLUTE : vote based on the value 'level' is set
|
|
* CAM_VOTE_DYNAMIC : vote calculated dynamically using 'freq'
|
|
* and 'dev' handle is set
|
|
* @level : AHB vote level
|
|
* @freq : AHB vote dynamic frequency
|
|
*
|
|
*/
|
|
struct cam_ahb_vote {
|
|
enum cam_vote_type type;
|
|
union {
|
|
enum cam_vote_level level;
|
|
unsigned long freq;
|
|
} vote;
|
|
};
|
|
|
|
/**
|
|
* struct cam_axi_vote : AXI vote
|
|
*
|
|
* @num_paths: Number of paths on which BW vote is sent to CPAS
|
|
* @axi_path: Per path BW vote info
|
|
*
|
|
*/
|
|
struct cam_axi_vote {
|
|
uint32_t num_paths;
|
|
struct cam_axi_per_path_bw_vote axi_path[CAM_CPAS_MAX_PATHS_PER_CLIENT];
|
|
};
|
|
|
|
/**
|
|
* cam_cpas_register_client()
|
|
*
|
|
* @brief: API to register cpas client
|
|
*
|
|
* @register_params: Input params to register as a client to CPAS
|
|
*
|
|
* @return 0 on success.
|
|
*
|
|
*/
|
|
int cam_cpas_register_client(
|
|
struct cam_cpas_register_params *register_params);
|
|
|
|
/**
|
|
* cam_cpas_unregister_client()
|
|
*
|
|
* @brief: API to unregister cpas client
|
|
*
|
|
* @client_handle: Client handle to be unregistered
|
|
*
|
|
* @return 0 on success.
|
|
*
|
|
*/
|
|
int cam_cpas_unregister_client(uint32_t client_handle);
|
|
|
|
/**
|
|
* cam_cpas_start()
|
|
*
|
|
* @brief: API to start cpas client hw. Clients have to vote for minimal
|
|
* bandwidth requirements for AHB, AXI. Use cam_cpas_update_ahb_vote
|
|
* to scale bandwidth after start.
|
|
*
|
|
* @client_handle: client cpas handle
|
|
* @ahb_vote : Pointer to ahb vote info
|
|
* @axi_vote : Pointer to axi bandwidth vote info
|
|
*
|
|
* If AXI vote is not applicable to a particular client, use the value exposed
|
|
* by CAM_CPAS_DEFAULT_AXI_BW as the default vote request.
|
|
*
|
|
* @return 0 on success.
|
|
*
|
|
*/
|
|
int cam_cpas_start(
|
|
uint32_t client_handle,
|
|
struct cam_ahb_vote *ahb_vote,
|
|
struct cam_axi_vote *axi_vote);
|
|
|
|
/**
|
|
* cam_cpas_stop()
|
|
*
|
|
* @brief: API to stop cpas client hw. Bandwidth for AHB, AXI votes
|
|
* would be removed for this client on this call. Clients should not
|
|
* use cam_cpas_update_ahb_vote or cam_cpas_update_axi_vote
|
|
* to remove their bandwidth vote.
|
|
*
|
|
* @client_handle: client cpas handle
|
|
*
|
|
* @return 0 on success.
|
|
*
|
|
*/
|
|
int cam_cpas_stop(uint32_t client_handle);
|
|
|
|
/**
|
|
* cam_cpas_update_ahb_vote()
|
|
*
|
|
* @brief: API to update AHB vote requirement. Use this function only
|
|
* between cam_cpas_start and cam_cpas_stop in case clients wants
|
|
* to scale to different vote level. Do not use this function to de-vote,
|
|
* removing client's vote is implicit on cam_cpas_stop
|
|
*
|
|
* @client_handle : Client cpas handle
|
|
* @ahb_vote : Pointer to ahb vote info
|
|
*
|
|
* @return 0 on success.
|
|
*
|
|
*/
|
|
int cam_cpas_update_ahb_vote(
|
|
uint32_t client_handle,
|
|
struct cam_ahb_vote *ahb_vote);
|
|
|
|
/**
|
|
* cam_cpas_update_axi_vote()
|
|
*
|
|
* @brief: API to update AXI vote requirement. Use this function only
|
|
* between cam_cpas_start and cam_cpas_stop in case clients wants
|
|
* to scale to different vote level. Do not use this function to de-vote,
|
|
* removing client's vote is implicit on cam_cpas_stop
|
|
*
|
|
* @client_handle : Client cpas handle
|
|
* @axi_vote : Pointer to axi bandwidth vote info
|
|
*
|
|
* @return 0 on success.
|
|
*
|
|
*/
|
|
int cam_cpas_update_axi_vote(
|
|
uint32_t client_handle,
|
|
struct cam_axi_vote *axi_vote);
|
|
|
|
/**
|
|
* cam_cpas_reg_write()
|
|
*
|
|
* @brief: API to write a register value in CPAS register space
|
|
*
|
|
* @client_handle : Client cpas handle
|
|
* @reg_base : Register base identifier
|
|
* @offset : Offset from the register base address
|
|
* @mb : Whether to do reg write with memory barrier
|
|
* @value : Value to be written in register
|
|
*
|
|
* @return 0 on success.
|
|
*
|
|
*/
|
|
int cam_cpas_reg_write(
|
|
uint32_t client_handle,
|
|
enum cam_cpas_reg_base reg_base,
|
|
uint32_t offset,
|
|
bool mb,
|
|
uint32_t value);
|
|
|
|
/**
|
|
* cam_cpas_reg_read()
|
|
*
|
|
* @brief: API to read a register value from CPAS register space
|
|
*
|
|
* @client_handle : Client cpas handle
|
|
* @reg_base : Register base identifier
|
|
* @offset : Offset from the register base address
|
|
* @mb : Whether to do reg read with memory barrier
|
|
* @value : Value to be red from register
|
|
*
|
|
* @return 0 on success.
|
|
*
|
|
*/
|
|
int cam_cpas_reg_read(
|
|
uint32_t client_handle,
|
|
enum cam_cpas_reg_base reg_base,
|
|
uint32_t offset,
|
|
bool mb,
|
|
uint32_t *value);
|
|
|
|
/**
|
|
* cam_cpas_get_hw_info()
|
|
*
|
|
* @brief: API to get camera hw information
|
|
*
|
|
* @camera_family : Camera family type. One of
|
|
* CAM_FAMILY_CAMERA_SS
|
|
* CAM_FAMILY_CPAS_SS
|
|
* @camera_version : Camera platform version
|
|
* @cpas_version : Camera cpas version
|
|
* @cam_caps : Camera capability
|
|
* @cam_fuse_info : Camera fuse info
|
|
*
|
|
* @return 0 on success.
|
|
*
|
|
*/
|
|
int cam_cpas_get_hw_info(
|
|
uint32_t *camera_family,
|
|
struct cam_hw_version *camera_version,
|
|
struct cam_hw_version *cpas_version,
|
|
uint32_t *cam_caps,
|
|
struct cam_cpas_fuse_info *cam_fuse_info);
|
|
|
|
/**
|
|
* cam_cpas_get_cpas_hw_version()
|
|
*
|
|
* @brief: API to get camera cpas hw version
|
|
*
|
|
* @hw_version : Camera cpas hw version
|
|
*
|
|
* @return 0 on success.
|
|
*
|
|
*/
|
|
int cam_cpas_get_cpas_hw_version(
|
|
uint32_t *hw_version);
|
|
|
|
/**
|
|
* cam_cpas_is_feature_supported()
|
|
*
|
|
* @brief: API to get camera features
|
|
*
|
|
* @flag : Camera hw features to check
|
|
*
|
|
* @hw_map : To indicate which HWs are supported
|
|
*
|
|
* @fule_val : Return fule value in case of value type feature
|
|
*
|
|
* @return 1 if feature is supported
|
|
*
|
|
*/
|
|
bool cam_cpas_is_feature_supported(uint32_t flag, uint32_t hw_map,
|
|
uint32_t *fuse_val);
|
|
|
|
/**
|
|
* cam_cpas_axi_util_path_type_to_string()
|
|
*
|
|
* @brief: API to get string for given path type
|
|
*
|
|
* @path_data_type : Path type
|
|
*
|
|
* @return string.
|
|
*
|
|
*/
|
|
const char *cam_cpas_axi_util_path_type_to_string(
|
|
uint32_t path_data_type);
|
|
|
|
/**
|
|
* cam_cpas_axi_util_trans_type_to_string()
|
|
*
|
|
* @brief: API to get string for given transaction type
|
|
*
|
|
* @path_data_type : Transaction type
|
|
*
|
|
* @return string.
|
|
*
|
|
*/
|
|
const char *cam_cpas_axi_util_trans_type_to_string(
|
|
uint32_t path_data_type);
|
|
|
|
/**
|
|
* cam_cpas_log_votes()
|
|
*
|
|
* @brief: API to print the all bw votes of axi client. It also print the
|
|
* applied camnoc axi clock vote value and ahb vote value
|
|
*
|
|
* @return 0 on success.
|
|
*
|
|
*/
|
|
void cam_cpas_log_votes(void);
|
|
|
|
/**
|
|
* cam_cpas_select_qos_settings()
|
|
*
|
|
* @brief: API to select specific qos settings based on usecase requirements
|
|
*
|
|
* @return 0 on success.
|
|
*
|
|
*/
|
|
int cam_cpas_select_qos_settings(uint32_t selection_mask);
|
|
|
|
/**
|
|
* cam_cpas_notify_event()
|
|
*
|
|
* @brief: API that clients can notify about their events. CPAS save the event
|
|
* and any other useful information related to this event. This will
|
|
* be printed while cpas state dump - cam_cpas_log_votes.
|
|
* One such example is IFE notifiying SOF or EPOCH to cpas and cpas
|
|
* saving axi clock information (camnoc_axi, mnoc_hf) at that point
|
|
* and printing latest history on IFE overflow.
|
|
*
|
|
* @identifier_string: Identifier string passed by caller
|
|
* @identifier_value: Identifier value passed by caller
|
|
*
|
|
* @return 0 on success.
|
|
*
|
|
*/
|
|
int cam_cpas_notify_event(const char *identifier_string,
|
|
int32_t identifier_value);
|
|
|
|
/**
|
|
* cam_cpas_get_scid()
|
|
*
|
|
* @brief: API to obtain slice id for the given type
|
|
*
|
|
* @type: Cache type
|
|
*
|
|
* @return slice id, -1 for invalid id.
|
|
*
|
|
*/
|
|
int cam_cpas_get_scid(enum cam_sys_cache_config_types type);
|
|
|
|
/**
|
|
* cam_cpas_activate_llcc()
|
|
*
|
|
* @brief: API to activate system cache
|
|
*
|
|
* @type: Cache type
|
|
*
|
|
* @return 0 for success.
|
|
*
|
|
*/
|
|
int cam_cpas_activate_llcc(enum cam_sys_cache_config_types type);
|
|
|
|
/**
|
|
* cam_cpas_deactivate_llcc()
|
|
*
|
|
* @brief: API to de-activate system cache
|
|
*
|
|
* @type: Cache type
|
|
*
|
|
* @return 0 for success.
|
|
*
|
|
*/
|
|
int cam_cpas_deactivate_llcc(enum cam_sys_cache_config_types type);
|
|
|
|
/**
|
|
* cam_cpas_dump_camnoc_buff_fill_info()
|
|
*
|
|
* @brief: API to dump camnoc buffer fill level info
|
|
*
|
|
* @client_handle : Client cpas handle
|
|
*
|
|
* @return 0 on success
|
|
*
|
|
*/
|
|
int cam_cpas_dump_camnoc_buff_fill_info(uint32_t client_handle);
|
|
|
|
#endif /* _CAM_CPAS_API_H_ */
|