/* SPDX-License-Identifier: GPL-2.0-only */ /* * Copyright (c) 2017-2021, The Linux Foundation. All rights reserved. */ #ifndef _CAM_CPAS_HW_H_ #define _CAM_CPAS_HW_H_ #include #include "cam_cpas_api.h" #include "cam_cpas_hw_intf.h" #include "cam_common_util.h" #include "cam_soc_bus.h" #define CAM_CPAS_INFLIGHT_WORKS 5 #define CAM_CPAS_MAX_CLIENTS 41 #define CAM_CPAS_MAX_AXI_PORTS 6 #define CAM_CPAS_MAX_TREE_LEVELS 4 #define CAM_CPAS_MAX_GRAN_PATHS_PER_CLIENT 32 #define CAM_CPAS_PATH_DATA_MAX 40 #define CAM_CPAS_TRANSACTION_MAX 2 #define CAM_CAMNOC_FILL_LVL_REG_INFO_MAX 6 #define CAM_CPAS_AXI_MIN_MNOC_AB_BW (2048 * 1024) #define CAM_CPAS_AXI_MIN_MNOC_IB_BW (2048 * 1024) #define CAM_CPAS_AXI_MIN_CAMNOC_AB_BW (2048 * 1024) #define CAM_CPAS_AXI_MIN_CAMNOC_IB_BW (3000000000UL) #define CAM_CPAS_GET_CLIENT_IDX(handle) (handle) #define CAM_CPAS_GET_CLIENT_HANDLE(indx) (indx) #define CAM_CPAS_CLIENT_VALID(indx) \ ((indx >= 0) && (indx < CAM_CPAS_MAX_CLIENTS)) #define CAM_CPAS_CLIENT_REGISTERED(cpas_core, indx) \ ((CAM_CPAS_CLIENT_VALID(indx)) && \ (cpas_core->cpas_client[indx]->registered)) #define CAM_CPAS_CLIENT_STARTED(cpas_core, indx) \ ((CAM_CPAS_CLIENT_REGISTERED(cpas_core, indx)) && \ (cpas_core->cpas_client[indx]->started)) /* Array indices to represent corresponding RPMH BCM info */ #define CAM_RPMH_NUMBER_OF_BCMS 0 #define CAM_RPMH_BCM_FE_OFFSET 1 #define CAM_RPMH_BCM_BE_OFFSET 2 #define CAM_RPMH_BCM_DDR_INDEX 3 #define CAM_RPMH_BCM_MNOC_INDEX 4 #define CAM_RPMH_BCM_INFO_MAX 5 #define CAM_CPAS_MONITOR_MAX_ENTRIES 100 #define CAM_CPAS_INC_MONITOR_HEAD(head, ret) \ div_u64_rem(atomic64_add_return(1, head),\ CAM_CPAS_MONITOR_MAX_ENTRIES, (ret)) /** * enum cam_cpas_access_type - Enum for Register access type */ enum cam_cpas_access_type { CAM_REG_TYPE_READ, CAM_REG_TYPE_WRITE, CAM_REG_TYPE_READ_WRITE, }; /** * struct cam_cpas_internal_ops - CPAS Hardware layer internal ops * * @get_hw_info: Function pointer for get hw info * @init_hw_version: Function pointer for hw init based on version * @handle_irq: Function poniter for irq handling * @setup_regbase: Function pointer for setup rebase indices * @power_on: Function pointer for hw core specific power on settings * @power_off: Function pointer for hw core specific power off settings * @setup_qos_settings: Function pointer for hw to select a specific qos header * @print_poweron_settings: Function pointer for hw to print poweron settings * @qchannel_handshake: Function pointer for hw core specific qchannel * handshake settings * */ struct cam_cpas_internal_ops { int (*get_hw_info)(struct cam_hw_info *cpas_hw, struct cam_cpas_hw_caps *hw_caps); int (*init_hw_version)(struct cam_hw_info *cpas_hw, struct cam_cpas_hw_caps *hw_caps); irqreturn_t (*handle_irq)(int irq_num, void *data); int (*setup_regbase)(struct cam_hw_soc_info *soc_info, int32_t regbase_index[], int32_t num_reg_map); int (*power_on)(struct cam_hw_info *cpas_hw); int (*power_off)(struct cam_hw_info *cpas_hw); int (*setup_qos_settings)(struct cam_hw_info *cpas_hw, uint32_t selection_mask); int (*print_poweron_settings)(struct cam_hw_info *cpas_hw); int (*qchannel_handshake)(struct cam_hw_info *cpas_hw, bool power_on); }; /** * struct cam_cpas_reg : CPAS register info * * @enable: Whether this reg info need to be enabled * @access_type: Register access type * @masked_value: Whether this register write/read is based on mask, shift * @mask: Mask for this register value * @shift: Shift for this register value * @value: Register value * */ struct cam_cpas_reg { bool enable; enum cam_cpas_access_type access_type; bool masked_value; uint32_t offset; uint32_t mask; uint32_t shift; uint32_t value; }; /** * struct cam_cpas_client : CPAS Client structure info * * @data: Client register params * @registered: Whether client has registered with cpas * @started: Whether client has streamed on * @tree_node_valid: Indicates whether tree node has at least one valid node * @ahb_level: Determined/Applied ahb level for the client * @axi_vote: Determined/Applied axi vote for the client * @axi_port: Client's parent axi port * @tree_node: All granular path voting nodes for the client * */ struct cam_cpas_client { struct cam_cpas_register_params data; bool registered; bool started; bool tree_node_valid; enum cam_vote_level ahb_level; struct cam_axi_vote axi_vote; struct cam_cpas_axi_port *axi_port; struct cam_cpas_tree_node *tree_node[CAM_CPAS_PATH_DATA_MAX] [CAM_CPAS_TRANSACTION_MAX]; }; /** * struct cam_cpas_bus_client : Bus client information * * @valid: Whether bus client is valid * @name: Name of the bus client * @lock: Mutex lock used while voting on this client * @curr_vote_level: current voted index * @common_data: Common data fields for bus client * @soc_bus_client: Bus client private information */ struct cam_cpas_bus_client { bool valid; struct mutex lock; unsigned int curr_vote_level; struct cam_soc_bus_client_common_data common_data; void *soc_bus_client; }; /** * struct cam_cpas_axi_port : AXI port information * * @axi_port_name: Name of this AXI port * @bus_client: bus client info for this port * @ib_bw_voting_needed: if this port can update ib bw dynamically * @axi_port_node: Node representing AXI Port info in device tree * @ab_bw: AB bw value for this port * @ib_bw: IB bw value for this port * @camnoc_bw: CAMNOC bw value for this port * @additional_bw: Additional bandwidth to cover non-hw cpas clients * @applied_ab_bw: applied ab bw for this port * @applied_ib_bw: applied ib bw for this port */ struct cam_cpas_axi_port { const char *axi_port_name; struct cam_cpas_bus_client bus_client; bool ib_bw_voting_needed; struct device_node *axi_port_node; uint64_t ab_bw; uint64_t ib_bw; uint64_t camnoc_bw; uint64_t additional_bw; uint64_t applied_ab_bw; uint64_t applied_ib_bw; }; /** * struct cam_cpas_axi_port_debug_info : AXI port information * * @axi_port_name: Name of this AXI port * @ab_bw: AB bw value for this port * @ib_bw: IB bw value for this port * @camnoc_bw: CAMNOC bw value for this port * @applied_ab_bw: applied ab bw for this port * @applied_ib_bw: applied ib bw for this port */ struct cam_cpas_axi_port_debug_info { const char *axi_port_name; uint64_t ab_bw; uint64_t ib_bw; uint64_t camnoc_bw; uint64_t applied_ab_bw; uint64_t applied_ib_bw; }; /** * struct cam_cpas_monitor : CPAS monitor array * * @timestamp: Timestamp at which this monitor entry is saved * @axi_info: AXI port information * @identifier_string: String passed by caller * @identifier_value: Identifier value passed by caller * @applied_camnoc_clk: Applied camnoc axi clock rate * @applied_ahb_level: Applied camcc ahb level * @fe_ddr: RPMH DDR BCM FE (front-end) status register value. * This indicates requested clock plan * @be_ddr: RPMH DDR BCM BE (back-end) status register value. * This indicates actual current clock plan * @fe_mnoc: RPMH MNOC BCM FE (front-end) status register value. * This indicates requested clock plan * @be_mnoc: RPMH MNOC BCM BE (back-end) status register value. * This indicates actual current clock plan * @be_shub: RPMH SHUB BCM BE (back-end) status register value. * This indicates actual current clock plan * @num_camnoc_lvl_regs: Number of enabled camnoc fill level * monitoring registers * @camnoc_port_name: Camnoc port names * @camnoc_fill_level: Camnoc fill level register info */ struct cam_cpas_monitor { struct timespec64 timestamp; char identifier_string[128]; int32_t identifier_value; struct cam_cpas_axi_port_debug_info axi_info[CAM_CPAS_MAX_AXI_PORTS]; uint64_t applied_camnoc_clk; unsigned int applied_ahb_level; uint32_t fe_ddr; uint32_t be_ddr; uint32_t fe_mnoc; uint32_t be_mnoc; uint32_t be_shub; uint32_t num_camnoc_lvl_regs; const char *camnoc_port_name[CAM_CAMNOC_FILL_LVL_REG_INFO_MAX]; uint32_t camnoc_fill_level[CAM_CAMNOC_FILL_LVL_REG_INFO_MAX]; }; /** * struct cam_cpas : CPAS core data structure info * * @hw_caps: CPAS hw capabilities * @cpas_client: Array of pointers to CPAS clients info * @client_mutex: Mutex for accessing client info * @tree_lock: Mutex lock for accessing CPAS node tree * @num_clients: Total number of clients that CPAS supports * @num_axi_ports: Total number of axi ports found in device tree * @num_camnoc_axi_ports: Total number of camnoc axi ports found in device tree * @registered_clients: Number of Clients registered currently * @streamon_clients: Number of Clients that are in start state currently * @regbase_index: Register base indices for CPAS register base IDs * @ahb_bus_client: AHB Bus client info * @axi_port: AXI port info for a specific axi index * @camnoc_axi_port: CAMNOC AXI port info for a specific camnoc axi index * @internal_ops: CPAS HW internal ops * @work_queue: Work queue handle * @irq_count: atomic irq count * @irq_count_wq: wait variable to ensure all irq's are handled * @dentry: debugfs file entry * @ahb_bus_scaling_disable: ahb scaling based on src clk corner for bus * @applied_camnoc_axi_rate: applied camnoc axi clock rate * @monitor_head: Monitor array head * @monitor_entries: cpas monitor array * @full_state_dump: Whether to enable full cpas state dump or not */ struct cam_cpas { struct cam_cpas_hw_caps hw_caps; struct cam_cpas_client *cpas_client[CAM_CPAS_MAX_CLIENTS]; struct mutex client_mutex[CAM_CPAS_MAX_CLIENTS]; struct mutex tree_lock; uint32_t num_clients; uint32_t num_axi_ports; uint32_t num_camnoc_axi_ports; uint32_t registered_clients; uint32_t streamon_clients; int32_t regbase_index[CAM_CPAS_REG_MAX]; struct cam_cpas_bus_client ahb_bus_client; struct cam_cpas_axi_port axi_port[CAM_CPAS_MAX_AXI_PORTS]; struct cam_cpas_axi_port camnoc_axi_port[CAM_CPAS_MAX_AXI_PORTS]; struct cam_cpas_internal_ops internal_ops; struct workqueue_struct *work_queue; atomic_t irq_count; wait_queue_head_t irq_count_wq; struct dentry *dentry; bool ahb_bus_scaling_disable; uint64_t applied_camnoc_axi_rate; atomic64_t monitor_head; struct cam_cpas_monitor monitor_entries[CAM_CPAS_MONITOR_MAX_ENTRIES]; bool full_state_dump; void *camnoc_info; }; int cam_camsstop_get_internal_ops(struct cam_cpas_internal_ops *internal_ops); int cam_cpastop_get_internal_ops(struct cam_cpas_internal_ops *internal_ops); int cam_cpas_util_reg_update(struct cam_hw_info *cpas_hw, enum cam_cpas_reg_base reg_base, struct cam_cpas_reg *reg_info); int cam_cpas_util_reg_read(struct cam_hw_info *cpas_hw, enum cam_cpas_reg_base reg_base, struct cam_cpas_reg *reg_info); int cam_cpas_util_client_cleanup(struct cam_hw_info *cpas_hw); #endif /* _CAM_CPAS_HW_H_ */