
Userspace module may not trigger the atomic check and it can cause the commit failure. In such case, always reserve the minimum core clock rate on mmrm module for built-in displays to avoid the power ON failure. Change-Id: Iafd92a7b7d1b35befe70b041cbedaec2add40de4 Signed-off-by: Dhaval Patel <pdhaval@codeaurora.org>
380 righe
12 KiB
C
380 righe
12 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
/*
|
|
* Copyright (c) 2016-2021, The Linux Foundation. All rights reserved.
|
|
*/
|
|
|
|
#ifndef _SDE_POWER_HANDLE_H_
|
|
#define _SDE_POWER_HANDLE_H_
|
|
|
|
#define MAX_CLIENT_NAME_LEN 128
|
|
|
|
#define SDE_POWER_HANDLE_ENABLE_BUS_AB_QUOTA 0
|
|
#define SDE_POWER_HANDLE_DISABLE_BUS_AB_QUOTA 0
|
|
#define SDE_POWER_HANDLE_ENABLE_BUS_IB_QUOTA 400000000
|
|
#define SDE_POWER_HANDLE_ENABLE_NRT_BUS_IB_QUOTA 0
|
|
#define SDE_POWER_HANDLE_DISABLE_BUS_IB_QUOTA 0
|
|
|
|
#define SDE_POWER_HANDLE_CONT_SPLASH_BUS_IB_QUOTA 3000000000ULL
|
|
#define SDE_POWER_HANDLE_CONT_SPLASH_BUS_AB_QUOTA 3000000000ULL
|
|
|
|
#include <linux/sde_io_util.h>
|
|
#include <linux/interconnect.h>
|
|
|
|
/* event will be triggered before power handler disable */
|
|
#define SDE_POWER_EVENT_PRE_DISABLE 0x1
|
|
|
|
/* event will be triggered after power handler disable */
|
|
#define SDE_POWER_EVENT_POST_DISABLE 0x2
|
|
|
|
/* event will be triggered before power handler enable */
|
|
#define SDE_POWER_EVENT_PRE_ENABLE 0x4
|
|
|
|
/* event will be triggered after power handler enable */
|
|
#define SDE_POWER_EVENT_POST_ENABLE 0x8
|
|
|
|
/* event will be triggered during MMRM callback */
|
|
#define SDE_POWER_EVENT_MMRM_CALLBACK 0x10
|
|
|
|
#define DATA_BUS_PATH_MAX 0x2
|
|
|
|
/*
|
|
* The AMC bucket denotes constraints that are applied to hardware when
|
|
* icc_set_bw() completes, whereas the WAKE and SLEEP constraints are applied
|
|
* when the execution environment transitions between active and low power mode.
|
|
*/
|
|
#define QCOM_ICC_BUCKET_AMC 0
|
|
#define QCOM_ICC_BUCKET_WAKE 1
|
|
#define QCOM_ICC_BUCKET_SLEEP 2
|
|
#define QCOM_ICC_NUM_BUCKETS 3
|
|
#define QCOM_ICC_TAG_AMC BIT(QCOM_ICC_BUCKET_AMC)
|
|
#define QCOM_ICC_TAG_WAKE BIT(QCOM_ICC_BUCKET_WAKE)
|
|
#define QCOM_ICC_TAG_SLEEP BIT(QCOM_ICC_BUCKET_SLEEP)
|
|
#define QCOM_ICC_TAG_ACTIVE_ONLY (QCOM_ICC_TAG_AMC | QCOM_ICC_TAG_WAKE)
|
|
#define QCOM_ICC_TAG_ALWAYS (QCOM_ICC_TAG_AMC | QCOM_ICC_TAG_WAKE |\
|
|
QCOM_ICC_TAG_SLEEP)
|
|
|
|
/**
|
|
* mdss_bus_vote_type: register bus vote type
|
|
* VOTE_INDEX_DISABLE: removes the client vote
|
|
* VOTE_INDEX_LOW: keeps the lowest vote for register bus
|
|
* VOTE_INDEX_MEDIUM: keeps medium vote for register bus
|
|
* VOTE_INDEX_HIGH: keeps the highest vote for register bus
|
|
* VOTE_INDEX_MAX: invalid
|
|
*/
|
|
enum mdss_bus_vote_type {
|
|
VOTE_INDEX_DISABLE,
|
|
VOTE_INDEX_LOW,
|
|
VOTE_INDEX_MEDIUM,
|
|
VOTE_INDEX_HIGH,
|
|
VOTE_INDEX_MAX,
|
|
};
|
|
|
|
/**
|
|
* enum sde_power_handle_data_bus_client - type of axi bus clients
|
|
* @SDE_POWER_HANDLE_DATA_BUS_CLIENT_RT: core real-time bus client
|
|
* @SDE_POWER_HANDLE_DATA_BUS_CLIENT_NRT: core non-real-time bus client
|
|
* @SDE_POWER_HANDLE_DATA_BUS_CLIENT_MAX: maximum number of bus client type
|
|
*/
|
|
enum sde_power_handle_data_bus_client {
|
|
SDE_POWER_HANDLE_DATA_BUS_CLIENT_RT,
|
|
SDE_POWER_HANDLE_DATA_BUS_CLIENT_NRT,
|
|
SDE_POWER_HANDLE_DATA_BUS_CLIENT_MAX
|
|
};
|
|
|
|
/**
|
|
* enum SDE_POWER_HANDLE_DBUS_ID - data bus identifier
|
|
* @SDE_POWER_HANDLE_DBUS_ID_MNOC: DPU/MNOC data bus
|
|
* @SDE_POWER_HANDLE_DBUS_ID_LLCC: MNOC/LLCC data bus
|
|
* @SDE_POWER_HANDLE_DBUS_ID_EBI: LLCC/EBI data bus
|
|
*/
|
|
enum SDE_POWER_HANDLE_DBUS_ID {
|
|
SDE_POWER_HANDLE_DBUS_ID_MNOC,
|
|
SDE_POWER_HANDLE_DBUS_ID_LLCC,
|
|
SDE_POWER_HANDLE_DBUS_ID_EBI,
|
|
SDE_POWER_HANDLE_DBUS_ID_MAX,
|
|
};
|
|
|
|
/**
|
|
* struct sde_power_bus_scaling_data: struct for bus setting
|
|
* @ab: average bandwidth in bytes per second
|
|
* @ib: peak bandwidth in bytes per second
|
|
*/
|
|
struct sde_power_bus_scaling_data {
|
|
uint64_t ab; /* Arbitrated bandwidth */
|
|
uint64_t ib; /* Instantaneous bandwidth */
|
|
};
|
|
|
|
/**
|
|
* struct sde_power_data_handle: power handle struct for data bus
|
|
* @data_bus_hdl: current data bus handle
|
|
* @curr_val : save the current bus value
|
|
* @data_paths_cnt: number of rt data path ports
|
|
*/
|
|
struct sde_power_data_bus_handle {
|
|
struct icc_path *data_bus_hdl[DATA_BUS_PATH_MAX];
|
|
struct sde_power_bus_scaling_data curr_val;
|
|
u32 data_paths_cnt;
|
|
bool bus_active_only;
|
|
};
|
|
|
|
/**
|
|
* struct sde_power_reg_bus_handle: power handle struct for reg bus
|
|
* @reg_bus_hdl: reg bus interconnect path handle
|
|
* @curr_idx : use-case index in to scale_table for the current vote
|
|
* @scale_table: bus scaling bandwidth vote table
|
|
*/
|
|
struct sde_power_reg_bus_handle {
|
|
struct icc_path *reg_bus_hdl;
|
|
enum mdss_bus_vote_type curr_idx;
|
|
struct sde_power_bus_scaling_data scale_table[VOTE_INDEX_MAX];
|
|
};
|
|
|
|
/*
|
|
* struct sde_power_event - local event registration structure
|
|
* @client_name: name of the client registering
|
|
* @cb_fnc: pointer to desired callback function
|
|
* @usr: user pointer to pass to callback event trigger
|
|
* @event: refer to SDE_POWER_HANDLE_EVENT_*
|
|
* @list: list to attach event master list
|
|
* @active: indicates the state of sde power handle
|
|
*/
|
|
struct sde_power_event {
|
|
char client_name[MAX_CLIENT_NAME_LEN];
|
|
void (*cb_fnc)(u32 event_type, void *usr);
|
|
void *usr;
|
|
u32 event_type;
|
|
struct list_head list;
|
|
bool active;
|
|
};
|
|
|
|
/*
|
|
* struct sde_power_mmrm_reserve - mmrm resource reservation for clk and bw
|
|
* @clk_name: name of resource reservation clock
|
|
* @clk_rate: resource reservation clock rate
|
|
*/
|
|
struct sde_power_mmrm_reserve {
|
|
char clk_name[32];
|
|
u64 clk_rate;
|
|
};
|
|
|
|
/**
|
|
* struct sde_power_handle: power handle main struct
|
|
* @mp: module power for clock and regulator
|
|
* @phandle_lock: lock to synchronize the enable/disable
|
|
* @dev: pointer to device structure
|
|
* @reg_bus_handle: context structure for reg bus control
|
|
* @data_bus_handle: context structure for data bus control
|
|
* @event_list: current power handle event list
|
|
* @rsc_client: sde rsc client pointer
|
|
* @rsc_client_init: boolean to control rsc client create
|
|
* @mmrm_enable: boolean to indicate if mmrm is enabled
|
|
* @ib_quota: ib quota of the given bus
|
|
* @mmrm_reserve: mmrm resource reservation
|
|
*/
|
|
struct sde_power_handle {
|
|
struct dss_module_power mp;
|
|
struct mutex phandle_lock;
|
|
struct device *dev;
|
|
struct sde_power_reg_bus_handle reg_bus_handle;
|
|
struct sde_power_data_bus_handle data_bus_handle
|
|
[SDE_POWER_HANDLE_DBUS_ID_MAX];
|
|
struct list_head event_list;
|
|
u32 last_event_handled;
|
|
struct sde_rsc_client *rsc_client;
|
|
bool rsc_client_init;
|
|
bool mmrm_enable;
|
|
u64 ib_quota[SDE_POWER_HANDLE_DBUS_ID_MAX];
|
|
|
|
struct sde_power_mmrm_reserve mmrm_reserve;
|
|
};
|
|
|
|
/**
|
|
* sde_power_resource_init() - initializes the sde power handle
|
|
* @pdev: platform device to search the power resources
|
|
* @pdata: power handle to store the power resources
|
|
*
|
|
* Return: error code.
|
|
*/
|
|
int sde_power_resource_init(struct platform_device *pdev,
|
|
struct sde_power_handle *pdata);
|
|
|
|
/**
|
|
* sde_power_resource_deinit() - release the sde power handle
|
|
* @pdev: platform device for power resources
|
|
* @pdata: power handle containing the resources
|
|
*
|
|
* Return: error code.
|
|
*/
|
|
void sde_power_resource_deinit(struct platform_device *pdev,
|
|
struct sde_power_handle *pdata);
|
|
|
|
/**
|
|
* sde_power_resource_enable() - enable/disable the power resources
|
|
* @pdata: power handle containing the resources
|
|
* @enable: boolean request for enable/disable
|
|
*
|
|
* Return: error code.
|
|
*/
|
|
int sde_power_resource_enable(struct sde_power_handle *pdata, bool enable);
|
|
|
|
/**
|
|
* sde_power_scale_reg_bus() - Scale the registers bus for the specified client
|
|
* @phandle: power handle containing the resources
|
|
* @usecase_ndx: new use case to scale the reg bus
|
|
* @skip_lock: will skip holding the power rsrc mutex during the call, this is
|
|
* for internal callers that already hold this required lock.
|
|
*
|
|
* Return: error code.
|
|
*/
|
|
int sde_power_scale_reg_bus(struct sde_power_handle *phandle,
|
|
u32 usecase_ndx, bool skip_lock);
|
|
|
|
/**
|
|
* sde_power_data_bus_state_update() - update data bus state
|
|
* @pdata: power handle containing the resources
|
|
* @enable: take enable vs disable path
|
|
*
|
|
* Return: error code.
|
|
*/
|
|
int sde_power_data_bus_state_update(struct sde_power_handle *phandle,
|
|
bool enable);
|
|
|
|
/**
|
|
* sde_power_clk_reserve_rate() - reserve the clock rate with mmrm
|
|
* @pdata: power handle containing the resources
|
|
* @clock_name: clock name which needs rate update.
|
|
* @rate: Requested rate.
|
|
*
|
|
* Return: error code.
|
|
*/
|
|
int sde_power_clk_reserve_rate(struct sde_power_handle *pdata, char *clock_name, u64 rate);
|
|
|
|
/**
|
|
* sde_power_clk_set_rate() - set the clock rate
|
|
* @pdata: power handle containing the resources
|
|
* @clock_name: clock name which needs rate update.
|
|
* @rate: Requested rate.
|
|
* @flags: Flags to be set for this clk
|
|
*
|
|
* Return: error code.
|
|
*/
|
|
int sde_power_clk_set_rate(struct sde_power_handle *pdata, char *clock_name,
|
|
u64 rate, u32 flags);
|
|
|
|
/**
|
|
* sde_power_mmrm_set_clk_limit() - sets a limit for mdp core clk
|
|
* @clk: pointer to the mdp core clk
|
|
* @phandle: power handle containing the resources
|
|
* @requested_clk: limit requested for the core clk
|
|
*
|
|
* This function must be called in a thread different than the
|
|
* commit-thread, otherwise it will always fail, since this function
|
|
* sends a notification to user-space to reduce the clk, and then it
|
|
* waits for the next commit after this call to reduce the clk rate.
|
|
* Hence, if the commit-thread is blocked (by this function waiting)
|
|
* or if user-space does not send another commit to reduce the clk,
|
|
* this function will timeout after some time and fail.
|
|
*
|
|
* Return: 0 upon succeeding setting the clk to a value lower or
|
|
* equal than the 'requested_clk', otherwise it returns an
|
|
* error code.
|
|
*/
|
|
int sde_power_mmrm_set_clk_limit(struct dss_clk *clk,
|
|
struct sde_power_handle *phandle, unsigned long requested_clk);
|
|
|
|
/**
|
|
* sde_power_mmrm_get_requested_clk() - get clk rate requested by mmrm
|
|
* @pdata: power handle containing the resources
|
|
* @clock_name: clock name to get the rate requested by mmrm driver
|
|
* to decrease
|
|
*
|
|
* Return: clock rate requested by mmrm driver, if 0,
|
|
* then no active request by mmrm driver
|
|
*/
|
|
u64 sde_power_mmrm_get_requested_clk(struct sde_power_handle *pdata,
|
|
char *clock_name);
|
|
|
|
/**
|
|
* sde_power_clk_get_rate() - get the clock rate
|
|
* @pdata: power handle containing the resources
|
|
* @clock_name: clock name to get the rate
|
|
*
|
|
* Return: current clock rate
|
|
*/
|
|
u64 sde_power_clk_get_rate(struct sde_power_handle *pdata, char *clock_name);
|
|
|
|
/**
|
|
* sde_power_clk_get_max_rate() - get the maximum clock rate
|
|
* @pdata: power handle containing the resources
|
|
* @clock_name: clock name to get the max rate.
|
|
*
|
|
* Return: maximum clock rate or 0 if not found.
|
|
*/
|
|
u64 sde_power_clk_get_max_rate(struct sde_power_handle *pdata,
|
|
char *clock_name);
|
|
|
|
/**
|
|
* sde_power_clk_get_clk() - get the clock
|
|
* @pdata: power handle containing the resources
|
|
* @clock_name: clock name to get the clk pointer.
|
|
*
|
|
* Return: Pointer to clock
|
|
*/
|
|
struct clk *sde_power_clk_get_clk(struct sde_power_handle *phandle,
|
|
char *clock_name);
|
|
|
|
/**
|
|
* sde_power_data_bus_set_quota() - set data bus quota for power client
|
|
* @phandle: power handle containing the resources
|
|
* @bus_id: identifier of data bus, see SDE_POWER_HANDLE_DBUS_ID
|
|
* @ab_quota: arbitrated bus bandwidth
|
|
* @ib_quota: instantaneous bus bandwidth
|
|
*
|
|
* Return: zero if success, or error code otherwise
|
|
*/
|
|
int sde_power_data_bus_set_quota(struct sde_power_handle *phandle,
|
|
u32 bus_id, u64 ab_quota, u64 ib_quota);
|
|
|
|
/**
|
|
* sde_power_data_bus_bandwidth_ctrl() - control data bus bandwidth enable
|
|
* @phandle: power handle containing the resources
|
|
* @enable: true to enable bandwidth for data base
|
|
*
|
|
* Return: none
|
|
*/
|
|
void sde_power_data_bus_bandwidth_ctrl(struct sde_power_handle *phandle,
|
|
int enable);
|
|
|
|
/**
|
|
* sde_power_handle_register_event - register a callback function for an event.
|
|
* Clients can register for multiple events with a single register.
|
|
* Any block with access to phandle can register for the event
|
|
* notification.
|
|
* @phandle: power handle containing the resources
|
|
* @event_type: event type to register; refer SDE_POWER_HANDLE_EVENT_*
|
|
* @cb_fnc: pointer to desired callback function
|
|
* @usr: user pointer to pass to callback on event trigger
|
|
*
|
|
* Return: event pointer if success, or error code otherwise
|
|
*/
|
|
struct sde_power_event *sde_power_handle_register_event(
|
|
struct sde_power_handle *phandle,
|
|
u32 event_type, void (*cb_fnc)(u32 event_type, void *usr),
|
|
void *usr, char *client_name);
|
|
/**
|
|
* sde_power_handle_unregister_event - unregister callback for event(s)
|
|
* @phandle: power handle containing the resources
|
|
* @event: event pointer returned after power handle register
|
|
*/
|
|
void sde_power_handle_unregister_event(struct sde_power_handle *phandle,
|
|
struct sde_power_event *event);
|
|
|
|
/**
|
|
* sde_power_handle_get_dbus_name - get name of given data bus identifier
|
|
* @bus_id: data bus identifier
|
|
* Return: Pointer to name string if success; NULL otherwise
|
|
*/
|
|
const char *sde_power_handle_get_dbus_name(u32 bus_id);
|
|
|
|
#endif /* _SDE_POWER_HANDLE_H_ */
|