unplugged-kernel/drivers/misc/mediatek/video/mt6885/dispsys/ddp_manager.h

443 lines
13 KiB
C

/* SPDX-License-Identifier: GPL-2.0 */
/*
* Copyright (c) 2019 MediaTek Inc.
*/
#ifndef __DDP_PATH_MANAGER_H__
#define __DDP_PATH_MANAGER_H__
#include <linux/sched.h>
#include "ddp_info.h"
#include "ddp_path.h"
#include "cmdq_record.h"
#define MAKE_DDP_IRQ_BIT(module, shift) ((module<<24)|(0x1<<shift))
#define IRQBIT_MODULE(irqbit) (irqbit >> 24)
#define IRQBIT_BIT(irqbit) (irqbit & 0xffffff)
/* IRQ and module are combined to consist DDP IRQ */
enum DDP_IRQ_BIT {
DDP_IRQ_OVL0_FRAME_COMPLETE = MAKE_DDP_IRQ_BIT(DISP_MODULE_OVL0, 1),
DDP_IRQ_AAL0_OUT_END_FRAME = MAKE_DDP_IRQ_BIT(DISP_MODULE_AAL0, 1),
DDP_IRQ_RDMA0_REG_UPDATE = MAKE_DDP_IRQ_BIT(DISP_MODULE_RDMA0, 0),
DDP_IRQ_RDMA0_START = MAKE_DDP_IRQ_BIT(DISP_MODULE_RDMA0, 1),
DDP_IRQ_RDMA0_DONE = MAKE_DDP_IRQ_BIT(DISP_MODULE_RDMA0, 2),
DDP_IRQ_RDMA0_ABNORMAL = MAKE_DDP_IRQ_BIT(DISP_MODULE_RDMA0, 3),
DDP_IRQ_RDMA0_UNDERFLOW = MAKE_DDP_IRQ_BIT(DISP_MODULE_RDMA0, 4),
DDP_IRQ_RDMA0_TARGET_LINE = MAKE_DDP_IRQ_BIT(DISP_MODULE_RDMA0, 5),
DDP_IRQ_WDMA0_FRAME_COMPLETE = MAKE_DDP_IRQ_BIT(DISP_MODULE_WDMA0, 0),
DDP_IRQ_DSI0_CMD_DONE = MAKE_DDP_IRQ_BIT(DISP_MODULE_DSI0, 1),
DDP_IRQ_DSI0_EXT_TE = MAKE_DDP_IRQ_BIT(DISP_MODULE_DSI0, 2),
DDP_IRQ_DSI0_FRAME_DONE = MAKE_DDP_IRQ_BIT(DISP_MODULE_DSI0, 4),
DDP_IRQ_MUTEX0_SOF = MAKE_DDP_IRQ_BIT(DISP_MODULE_MUTEX, 0),
DDP_IRQ_MUTEX1_SOF = MAKE_DDP_IRQ_BIT(DISP_MODULE_MUTEX, 1),
DDP_IRQ_DPI_VSYNC = MAKE_DDP_IRQ_BIT(DISP_MODULE_DPI, 0),
DDP_IRQ_DPI_VDE = MAKE_DDP_IRQ_BIT(DISP_MODULE_DPI, 1),
DDP_IRQ_UNKNOWN = MAKE_DDP_IRQ_BIT(DISP_MODULE_UNKNOWN, 0),
};
/* path handle */
#define disp_path_handle void *
/**
* Init ddp manager, now only register irq handler to ddp_irq.c
* return 0 if ok or -1 if fail.
*/
int dpmgr_init(void);
/**
* create disp path handle , it will assign mutex to this handle,
* and cache this handle to modules in scenario, and will assign
* default irq event to this handle.
* return NULL if fail to create handle.
* scenario: used to demininate path, and ddp manager will do operations
* according to current scenario.
* @cmdq_handle: will save current config cmdqhandle, and if cmdq is enable,
* will use cmdq to write regitsers.
*/
disp_path_handle dpmgr_create_path(enum DDP_SCENARIO_ENUM scenario,
struct cmdqRecStruct *cmdq_handle);
int dpmgr_get_scenario(disp_path_handle dp_handle);
/* NOTES: modify path should call API like this :*/
int dpmgr_modify_path_power_on_new_modules(disp_path_handle dp_handle,
enum DDP_SCENARIO_ENUM new_scenario, int sw_only);
int dpmgr_modify_path(disp_path_handle dp_handle,
enum DDP_SCENARIO_ENUM new_scenario, struct cmdqRecStruct *cmdq_handle,
enum DDP_MODE isvdomode, int sw_only);
int dpmgr_modify_path_power_off_old_modules(
enum DDP_SCENARIO_ENUM old_scenario,
enum DDP_SCENARIO_ENUM new_scenario, int sw_only);
/* destroy path, it will release mutex to pool, and disconnect path,
* clear mapping between handle and modules.
* return 0;
*/
int dpmgr_destroy_path(disp_path_handle dp_handle,
struct cmdqRecStruct *cmdq_handle);
/* only destroy handle, don't disconnect path */
int dpmgr_destroy_path_handle(disp_path_handle dp_handle);
/* add dump to path, for primary path , support OVL0, UFOE and OD.
* for sub path ,support OVL1.
* return 0 if success or -1 if fail.
* dp_handle: disp path handle.
*/
int dpmgr_path_memout_clock(disp_path_handle dp_handle, int clock_switch);
int dpmgr_path_add_memout(disp_path_handle dp_handle,
enum DISP_MODULE_ENUM engine, void *cmdq_handle);
/* remove dump to path. should match between add dump and remove dump.
* return 0 if success or -1 if fail.
* dp_handle: disp path handle.
* encmdq: 1 use command queue, 0 not.
*/
int dpmgr_path_remove_memout(disp_path_handle dp_handle, void *cmdq_handle);
/* query current path mutex.
* return mutex.
* dp_handle: disp path handle.
*/
int dpmgr_path_get_mutex(disp_path_handle dp_handle);
/* query current dst module.
* return module enum.
* dp_handle: disp path handle.
*/
enum DISP_MODULE_ENUM dpmgr_path_get_dst_module(disp_path_handle dp_handle);
enum dst_module_type dpmgr_path_get_dst_module_type(
disp_path_handle dp_handle);
/* set dst module, the default dst module maybe not right,
* so set real dst module on this path.
* return 0.
* dp_handle: disp path handle.
* dst_module(one of bellow):
* DISP_MODULE_DSI0
* DISP_MODULE_DSI1
* DISP_MODULE_DSIDUAL(DISP_MODULE_DSI0+DISP_MODULE_DSI1)
* DISP_MODULE_DPI
*/
int dpmgr_path_set_dst_module(disp_path_handle dp_handle,
enum DISP_MODULE_ENUM dst_module);
/* set mode type(sof source): cmd or video mode.
* return 0.
* dp_handle: disp path handle.
* is_vdo_mode: 0 is cmd mode, 1 is video mode.
*/
int dpmgr_path_set_video_mode(disp_path_handle dp_handle, int is_vdo_mode);
/* init path , it will set mutex according to modules on this path
* and sof sorce. And it will connect path , then initialize modules
* on this path.
* return 0.
* dp_handle: disp path handle.
* encmdq: 1 use command queue, 0 not.
*/
int dpmgr_path_init(disp_path_handle dp_handle, int encmdq);
/* connect path , it will set mutex according to modules on this path
* and sof sorce.
* and it will connect path , then initialize modules on this path.
* return 0.
* dp_handle: disp path handle.
* encmdq: 1 use command queue, 0 not.
*/
int dpmgr_path_connect(disp_path_handle dp_handle, int encmdq);
/* connect path , it will set mutex according to modules on this path
* and sof sorce.
* and it will connect path , then initialize modules on this path.
* return 0.
* dp_handle: disp path handle.
* encmdq: 1 use command queue, 0 not.
*/
int dpmgr_path_disconnect(disp_path_handle dp_handle, int encmdq);
/* deinit path , it will clear mutex and dissconnect path.
* return 0.
* dp_handle: disp path handle.
* encmdq: 1 use command queue, 0 not.
*/
int dpmgr_path_deinit(disp_path_handle dp_handle, int encmdq);
/* start path , it will start this path by calling each drviers start function.
* return 0.
* dp_handle: disp path handle.
* encmdq: 1 use command queue, 0 not.
*/
int dpmgr_path_start(disp_path_handle dp_handle, int encmdq);
/* start path , it will stop this path by calling each drviers stop function.
* return 0.
* dp_handle: disp path handle.
* encmdq: 1 use command queue, 0 not.
*/
int dpmgr_path_stop(disp_path_handle dp_handle, int encmdq);
/* reset path , it will reset this path by calling each drviers reset function.
* return 0.
* dp_handle: disp path handle.
* encmdq: 1 use command queue, 0 not.
*/
int dpmgr_path_reset(disp_path_handle dp_handle, int encmdq);
/* config data , it will config input or output data of this path.
* now config contains three parts:
* 1. dst dirty .it means dst with & dst hight need be updated.
* 2. ovl dirty. it means ovl config need be updated.
* 3. rdma dirty. it means rdma need be updated.
* 4. wdma dirty. it means wdam need be updated.
* return 0.
* dp_handle: disp path handle.
* encmdq: 1 use command queue, 0 not.
*/
int dpmgr_path_config(disp_path_handle dp_handle,
struct disp_ddp_path_config *config, void *cmdq_handle);
int dpmgr_path_update_partial_roi(disp_path_handle dp_handle,
struct disp_rect partial, void *cmdq_handle);
/* path flush, this will enable mutex
* return 0.
* dp_handle: disp path handle.
* encmdq: 1 use command queue, 0 not.
*/
int dpmgr_path_flush(disp_path_handle dp_handle, int encmdq);
/* this will dump modules info on this path.
* return 0.
* dp_handle: disp path handle.
*/
int dpmgr_check_status(disp_path_handle dp_handle);
int dpmgr_check_status_by_scenario(enum DDP_SCENARIO_ENUM scenario);
/* this will dump modules info on mutex path.
* return 0.
* mutex_id: mutex idex[0-4], if not in this range, will dump all.
*/
void dpmgr_debug_path_status(int mutex_id);
/* this will deal with cmdq message:
* return 0.
* dp_handle: disp path handle.
* trigger_loop_handle: triger thread.
* state :
* CMDQ_BEFORE_STREAM_SOF
* CMDQ_WAIT_STREAM_EOF_EVENT
* CMDQ_CHECK_IDLE_AFTER_STREAM_EOF
* CMDQ_AFTER_STREAM_EOF
*/
int dpmgr_path_build_cmdq(disp_path_handle dp_handle,
void *trigger_loop_handle, enum CMDQ_STATE state, int reverse);
/* this will trigger this path. it will trigger each module and enable mutex.
* return 0.
* dp_handle: disp path handle.
* trigger_loop_handle : trigger thread.
*/
int dpmgr_path_trigger(disp_path_handle dp_handle, void *trigger_loop_handle,
int encmdq);
/* set signal to event. this if not irq signal, but user send event
* return 0.
* dp_handle: disp path handle.
* event: path event.
*/
int dpmgr_signal_event(disp_path_handle dp_handle, enum DISP_PATH_EVENT event);
/* enable init will initialize wakequeue.
* return 0.
* dp_handle: disp path handle.
* event: path event.
*/
int dpmgr_enable_event(disp_path_handle dp_handle, enum DISP_PATH_EVENT event);
/* disable event, related irq will not be received.
* return 0.
* dp_handle: disp path handle.
* event: path event.
*/
int dpmgr_disable_event(disp_path_handle dp_handle,
enum DISP_PATH_EVENT event);
/* map event to irq can change mappling between path event and irq .
* return 0.
* dp_handle: disp path handle.
* event: path event.
* irq_bit
*/
int dpmgr_map_event_to_irq(disp_path_handle dp_handle,
enum DISP_PATH_EVENT event, enum DDP_IRQ_BIT irq_bit);
/* wait event, timeout (ms).
* return
* < 0, error.
* 0 timeout
* > 0 no timeout
* event : disp event.
* timeout :(ms).
*/
int dpmgr_wait_event_timeout(disp_path_handle dp_handle,
enum DISP_PATH_EVENT event, int timeout);
/* wait event
* return :
* 0 , wait succesfull.
* <0, wait error.
* event : disp event.
* timeout :(ms).
*/
int dpmgr_wait_event(disp_path_handle dp_handle, enum DISP_PATH_EVENT event);
int dpmgr_wait_event_ts(disp_path_handle dp_handle, enum DISP_PATH_EVENT event,
unsigned long long *event_ts);
/* power on, turn on each modules clk.
* return 0.
* dp_handle: disp path handle.
* encmdq: 1 use command queue, 0 not.
*/
int dpmgr_path_power_on(disp_path_handle dp_handle, enum CMDQ_SWITCH encmdq);
int dpmgr_path_power_on_bypass_pwm(disp_path_handle dp_handle,
enum CMDQ_SWITCH encmdq);
/* power 0ff, turn off each modules clk, if all hande are closed.
*top clock will be off.
* return 0.
* dp_handle: disp path handle.
* encmdq: 1 use command queue, 0 not.
*/
int dpmgr_path_power_off(disp_path_handle dp_handle, enum CMDQ_SWITCH encmdq);
int dpmgr_path_power_off_bypass_pwm(disp_path_handle dp_handle,
enum CMDQ_SWITCH encmdq);
/* set lcm utils. now only dis/dpi used.
* return 0.
* dp_handle: disp path handle.
* lcm_drv: lcm driver
*/
int dpmgr_set_lcm_utils(disp_path_handle dp_handle, void *lcm_drv);
/* check if this path is busy. it wil check each module on this path.
* return 0.
* dp_handle: disp path handle.
*/
int dpmgr_path_is_busy(disp_path_handle dp_handle);
/* check if this path is idle. it wil check each module on this path.
* return 0 if idle.
* dp_handle: disp path handle.
*/
int dpmgr_path_is_idle(disp_path_handle dp_handle);
/* add parameter to this path.
* return 0.
* dp_handle: disp path handle.
* io_evnet: not defined.
* data : data.
*/
int dpmgr_path_user_cmd(disp_path_handle dp_handle, unsigned int msg,
unsigned long arg, void *cmdqhandle);
int dpmgr_path_set_parameter(disp_path_handle dp_handle, int io_evnet,
void *data);
/* get parameter of this path.
* return 0.
* dp_handle: disp path handle.
* io_evnet: not defined.
* data : data.
*/
int dpmgr_path_get_parameter(disp_path_handle dp_handle, int io_evnet,
void *data);
/* dpmgr_ioctl , it will call ioctl of ddp modules ioctl() to do some
* special config or setting.
* return 0.
* dp_handle: disp path handle.
* cmdq_handle: cmdq handle
* ioctl_cmd: ioctl cmd
* params: ioctl parameters
*/
int dpmgr_path_ioctl(disp_path_handle dp_handle, void *cmdq_handle,
enum DDP_IOCTL_NAME ioctl_cmd, void *params);
int dpmgr_path_enable_irq(disp_path_handle dp_handle, void *cmdq_handle,
enum DDP_IRQ_LEVEL irq_level);
/* get last config parameter of path
* return pointer to last config
* dp_handle: disp path handle.
*/
struct disp_ddp_path_config *dpmgr_path_get_last_config(
disp_path_handle dp_handle);
struct disp_ddp_path_config *dpmgr_path_get_last_config_notclear(
disp_path_handle dp_handle);
void dpmgr_get_input_buffer(disp_path_handle dp_handle, unsigned long *addr);
int dpmgr_module_notify(enum DISP_MODULE_ENUM module,
enum DISP_PATH_EVENT event);
int dpmgr_wait_ovl_available(int ovl_num);
int switch_module_to_nonsec(disp_path_handle dp_handle, void *cmdqhandle,
const char *caller);
/* dpmgr_get_input_address for extenal display
* get physical address from register
* return address in addr[]
*/
void dpmgr_get_input_address(disp_path_handle dp_handle, unsigned long *addr);
/* dpmgr_factory_mode_test for extenal display
* to kick dsi1 to show a pattern
*/
int dpmgr_factory_mode_test(int module_name, void *cmdqhandle, void *config);
int dpmgr_factory_mode_reset(int module_name, void *cmdqhandle, void *config);
/* turn off dsi */
int dpmgr_path_dsi_power_off(disp_path_handle dp_handle, void *cmdqhandle);
/* turn on dsi */
int dpmgr_path_dsi_power_on(disp_path_handle dp_handle, void *cmdqhandle);
#endif