1 | /* |
2 | * Copyright 2018 Advanced Micro Devices, Inc. |
3 | * |
4 | * Permission is hereby granted, free of charge, to any person obtaining a |
5 | * copy of this software and associated documentation files (the "Software"), |
6 | * to deal in the Software without restriction, including without limitation |
7 | * the rights to use, copy, modify, merge, publish, distribute, sublicense, |
8 | * and/or sell copies of the Software, and to permit persons to whom the |
9 | * Software is furnished to do so, subject to the following conditions: |
10 | * |
11 | * The above copyright notice and this permission notice shall be included in |
12 | * all copies or substantial portions of the Software. |
13 | * |
14 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
15 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
16 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
17 | * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR |
18 | * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, |
19 | * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR |
20 | * OTHER DEALINGS IN THE SOFTWARE. |
21 | * |
22 | * Authors: AMD |
23 | * |
24 | */ |
25 | |
26 | #ifndef _DMUB_DC_SRV_H_ |
27 | #define _DMUB_DC_SRV_H_ |
28 | |
29 | #include "dm_services_types.h" |
30 | #include "dmub/dmub_srv.h" |
31 | |
32 | struct dmub_srv; |
33 | struct dc; |
34 | struct pipe_ctx; |
35 | struct dc_crtc_timing_adjust; |
36 | struct dc_crtc_timing; |
37 | struct dc_state; |
38 | |
39 | struct dc_reg_helper_state { |
40 | bool gather_in_progress; |
41 | uint32_t same_addr_count; |
42 | bool should_burst_write; |
43 | union dmub_rb_cmd cmd_data; |
44 | unsigned int reg_seq_count; |
45 | }; |
46 | |
47 | struct dc_dmub_srv { |
48 | struct dmub_srv *dmub; |
49 | struct dc_reg_helper_state reg_helper_offload; |
50 | |
51 | struct dc_context *ctx; |
52 | void *dm; |
53 | |
54 | bool idle_allowed; |
55 | }; |
56 | |
57 | void dc_dmub_srv_wait_idle(struct dc_dmub_srv *dc_dmub_srv); |
58 | |
59 | bool dc_dmub_srv_optimized_init_done(struct dc_dmub_srv *dc_dmub_srv); |
60 | |
61 | bool dc_dmub_srv_cmd_list_queue_execute(struct dc_dmub_srv *dc_dmub_srv, |
62 | unsigned int count, |
63 | union dmub_rb_cmd *cmd_list); |
64 | |
65 | bool dc_dmub_srv_wait_for_idle(struct dc_dmub_srv *dc_dmub_srv, |
66 | enum dm_dmub_wait_type wait_type, |
67 | union dmub_rb_cmd *cmd_list); |
68 | |
69 | bool dc_dmub_srv_cmd_run(struct dc_dmub_srv *dc_dmub_srv, union dmub_rb_cmd *cmd, enum dm_dmub_wait_type wait_type); |
70 | |
71 | bool dc_dmub_srv_cmd_run_list(struct dc_dmub_srv *dc_dmub_srv, unsigned int count, union dmub_rb_cmd *cmd_list, enum dm_dmub_wait_type wait_type); |
72 | |
73 | bool dc_dmub_srv_notify_stream_mask(struct dc_dmub_srv *dc_dmub_srv, |
74 | unsigned int stream_mask); |
75 | |
76 | bool dc_dmub_srv_is_restore_required(struct dc_dmub_srv *dc_dmub_srv); |
77 | |
78 | bool dc_dmub_srv_get_dmub_outbox0_msg(const struct dc *dc, struct dmcub_trace_buf_entry *entry); |
79 | |
80 | void dc_dmub_trace_event_control(struct dc *dc, bool enable); |
81 | |
82 | void dc_dmub_srv_drr_update_cmd(struct dc *dc, uint32_t tg_inst, uint32_t vtotal_min, uint32_t vtotal_max); |
83 | |
84 | void dc_dmub_srv_set_drr_manual_trigger_cmd(struct dc *dc, uint32_t tg_inst); |
85 | bool dc_dmub_srv_p_state_delegate(struct dc *dc, bool enable_pstate, struct dc_state *context); |
86 | |
87 | void dc_dmub_srv_query_caps_cmd(struct dc_dmub_srv *dc_dmub_srv); |
88 | void dc_dmub_srv_get_visual_confirm_color_cmd(struct dc *dc, struct pipe_ctx *pipe_ctx); |
89 | void dc_dmub_srv_clear_inbox0_ack(struct dc_dmub_srv *dmub_srv); |
90 | void dc_dmub_srv_wait_for_inbox0_ack(struct dc_dmub_srv *dmub_srv); |
91 | void dc_dmub_srv_send_inbox0_cmd(struct dc_dmub_srv *dmub_srv, union dmub_inbox0_data_register data); |
92 | |
93 | bool dc_dmub_srv_get_diagnostic_data(struct dc_dmub_srv *dc_dmub_srv, struct dmub_diagnostic_data *dmub_oca); |
94 | |
95 | void dc_dmub_setup_subvp_dmub_command(struct dc *dc, struct dc_state *context, bool enable); |
96 | void dc_dmub_srv_log_diagnostic_data(struct dc_dmub_srv *dc_dmub_srv); |
97 | |
98 | void dc_send_update_cursor_info_to_dmu(struct pipe_ctx *pCtx, uint8_t pipe_idx); |
99 | bool dc_dmub_check_min_version(struct dmub_srv *srv); |
100 | |
101 | void dc_dmub_srv_enable_dpia_trace(const struct dc *dc); |
102 | void dc_dmub_srv_subvp_save_surf_addr(const struct dc_dmub_srv *dc_dmub_srv, const struct dc_plane_address *addr, uint8_t subvp_index); |
103 | |
104 | bool dc_dmub_srv_is_hw_pwr_up(struct dc_dmub_srv *dc_dmub_srv, bool wait); |
105 | |
106 | void dc_dmub_srv_apply_idle_power_optimizations(const struct dc *dc, bool allow_idle); |
107 | |
108 | void dc_dmub_srv_set_power_state(struct dc_dmub_srv *dc_dmub_srv, enum dc_acpi_cm_power_state powerState); |
109 | |
110 | /** |
111 | * dc_wake_and_execute_dmub_cmd() - Wrapper for DMUB command execution. |
112 | * |
113 | * Refer to dc_wake_and_execute_dmub_cmd_list() for usage and limitations, |
114 | * This function is a convenience wrapper for a single command execution. |
115 | * |
116 | * @ctx: DC context |
117 | * @cmd: The command to send/receive |
118 | * @wait_type: The wait behavior for the execution |
119 | * |
120 | * Return: true on command submission success, false otherwise |
121 | */ |
122 | bool dc_wake_and_execute_dmub_cmd(const struct dc_context *ctx, union dmub_rb_cmd *cmd, |
123 | enum dm_dmub_wait_type wait_type); |
124 | |
125 | /** |
126 | * dc_wake_and_execute_dmub_cmd_list() - Wrapper for DMUB command list execution. |
127 | * |
128 | * If the DMCUB hardware was asleep then it wakes the DMUB before |
129 | * executing the command and attempts to re-enter if the command |
130 | * submission was successful. |
131 | * |
132 | * This should be the preferred command submission interface provided |
133 | * the DC lock is acquired. |
134 | * |
135 | * Entry/exit out of idle power optimizations would need to be |
136 | * manually performed otherwise through dc_allow_idle_optimizations(). |
137 | * |
138 | * @ctx: DC context |
139 | * @count: Number of commands to send/receive |
140 | * @cmd: Array of commands to send |
141 | * @wait_type: The wait behavior for the execution |
142 | * |
143 | * Return: true on command submission success, false otherwise |
144 | */ |
145 | bool dc_wake_and_execute_dmub_cmd_list(const struct dc_context *ctx, unsigned int count, |
146 | union dmub_rb_cmd *cmd, enum dm_dmub_wait_type wait_type); |
147 | |
148 | /** |
149 | * dc_wake_and_execute_gpint() |
150 | * |
151 | * @ctx: DC context |
152 | * @command_code: The command ID to send to DMCUB |
153 | * @param: The parameter to message DMCUB |
154 | * @response: Optional response out value - may be NULL. |
155 | * @wait_type: The wait behavior for the execution |
156 | */ |
157 | bool dc_wake_and_execute_gpint(const struct dc_context *ctx, enum dmub_gpint_command command_code, |
158 | uint16_t param, uint32_t *response, enum dm_dmub_wait_type wait_type); |
159 | |
160 | #endif /* _DMUB_DC_SRV_H_ */ |
161 | |