Linux Audio

Check our new training course

Yocto / OpenEmbedded training

Feb 10-13, 2025
Register
Loading...
Note: File does not exist in v3.5.6.
  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 __DCE_I2C_HW_H__
 27#define __DCE_I2C_HW_H__
 28
 29enum dc_i2c_status {
 30	DC_I2C_STATUS__DC_I2C_STATUS_IDLE,
 31	DC_I2C_STATUS__DC_I2C_STATUS_USED_BY_SW,
 32	DC_I2C_STATUS__DC_I2C_STATUS_USED_BY_HW,
 33	DC_I2C_REG_RW_CNTL_STATUS_DMCU_ONLY = 2,
 34};
 35
 36enum dc_i2c_arbitration {
 37	DC_I2C_ARBITRATION__DC_I2C_SW_PRIORITY_NORMAL,
 38	DC_I2C_ARBITRATION__DC_I2C_SW_PRIORITY_HIGH
 39};
 40
 41enum i2c_channel_operation_result {
 42	I2C_CHANNEL_OPERATION_SUCCEEDED,
 43	I2C_CHANNEL_OPERATION_FAILED,
 44	I2C_CHANNEL_OPERATION_NOT_GRANTED,
 45	I2C_CHANNEL_OPERATION_IS_BUSY,
 46	I2C_CHANNEL_OPERATION_NO_HANDLE_PROVIDED,
 47	I2C_CHANNEL_OPERATION_CHANNEL_IN_USE,
 48	I2C_CHANNEL_OPERATION_CHANNEL_CLIENT_MAX_ALLOWED,
 49	I2C_CHANNEL_OPERATION_ENGINE_BUSY,
 50	I2C_CHANNEL_OPERATION_TIMEOUT,
 51	I2C_CHANNEL_OPERATION_NO_RESPONSE,
 52	I2C_CHANNEL_OPERATION_HW_REQUEST_I2C_BUS,
 53	I2C_CHANNEL_OPERATION_WRONG_PARAMETER,
 54	I2C_CHANNEL_OPERATION_OUT_NB_OF_RETRIES,
 55	I2C_CHANNEL_OPERATION_NOT_STARTED
 56};
 57
 58
 59enum dce_i2c_transaction_action {
 60	DCE_I2C_TRANSACTION_ACTION_I2C_WRITE = 0x00,
 61	DCE_I2C_TRANSACTION_ACTION_I2C_READ = 0x10,
 62	DCE_I2C_TRANSACTION_ACTION_I2C_STATUS_REQUEST = 0x20,
 63
 64	DCE_I2C_TRANSACTION_ACTION_I2C_WRITE_MOT = 0x40,
 65	DCE_I2C_TRANSACTION_ACTION_I2C_READ_MOT = 0x50,
 66	DCE_I2C_TRANSACTION_ACTION_I2C_STATUS_REQUEST_MOT = 0x60,
 67
 68	DCE_I2C_TRANSACTION_ACTION_DP_WRITE = 0x80,
 69	DCE_I2C_TRANSACTION_ACTION_DP_READ = 0x90
 70};
 71
 72enum {
 73	I2C_SETUP_TIME_LIMIT_DCE = 255,
 74	I2C_SETUP_TIME_LIMIT_DCN = 3,
 75	I2C_HW_BUFFER_SIZE_DCE100 = 538,
 76	I2C_HW_BUFFER_SIZE_DCE = 144,
 77	I2C_SEND_RESET_LENGTH_9 = 9,
 78	I2C_SEND_RESET_LENGTH_10 = 10,
 79	DEFAULT_I2C_HW_SPEED = 50,
 80	DEFAULT_I2C_HW_SPEED_100KHZ = 100,
 81	TRANSACTION_TIMEOUT_IN_I2C_CLOCKS = 32,
 82};
 83
 84#define I2C_HW_ENGINE_COMMON_REG_LIST(id)\
 85	SRI(SETUP, DC_I2C_DDC, id),\
 86	SRI(SPEED, DC_I2C_DDC, id),\
 87	SRI(HW_STATUS, DC_I2C_DDC, id),\
 88	SR(DC_I2C_ARBITRATION),\
 89	SR(DC_I2C_CONTROL),\
 90	SR(DC_I2C_SW_STATUS),\
 91	SR(DC_I2C_TRANSACTION0),\
 92	SR(DC_I2C_TRANSACTION1),\
 93	SR(DC_I2C_TRANSACTION2),\
 94	SR(DC_I2C_TRANSACTION3),\
 95	SR(DC_I2C_DATA),\
 96	SR(MICROSECOND_TIME_BASE_DIV)
 97
 98#define I2C_HW_ENGINE_COMMON_REG_LIST_DCN30(id)\
 99	I2C_HW_ENGINE_COMMON_REG_LIST(id),\
100	SR(DIO_MEM_PWR_CTRL),\
101	SR(DIO_MEM_PWR_STATUS)
102
103#define I2C_SF(reg_name, field_name, post_fix)\
104	.field_name = reg_name ## __ ## field_name ## post_fix
105
106#define I2C_COMMON_MASK_SH_LIST_DCE_COMMON_BASE(mask_sh)\
107	I2C_SF(DC_I2C_DDC1_SETUP, DC_I2C_DDC1_ENABLE, mask_sh),\
108	I2C_SF(DC_I2C_DDC1_SETUP, DC_I2C_DDC1_TIME_LIMIT, mask_sh),\
109	I2C_SF(DC_I2C_DDC1_SETUP, DC_I2C_DDC1_DATA_DRIVE_EN, mask_sh),\
110	I2C_SF(DC_I2C_DDC1_SETUP, DC_I2C_DDC1_CLK_DRIVE_EN, mask_sh),\
111	I2C_SF(DC_I2C_DDC1_SETUP, DC_I2C_DDC1_DATA_DRIVE_SEL, mask_sh),\
112	I2C_SF(DC_I2C_DDC1_SETUP, DC_I2C_DDC1_INTRA_TRANSACTION_DELAY, mask_sh),\
113	I2C_SF(DC_I2C_DDC1_SETUP, DC_I2C_DDC1_INTRA_BYTE_DELAY, mask_sh),\
114	I2C_SF(DC_I2C_DDC1_HW_STATUS, DC_I2C_DDC1_HW_STATUS, mask_sh),\
115	I2C_SF(DC_I2C_ARBITRATION, DC_I2C_SW_USE_I2C_REG_REQ, mask_sh),\
116	I2C_SF(DC_I2C_ARBITRATION, DC_I2C_SW_DONE_USING_I2C_REG, mask_sh),\
117	I2C_SF(DC_I2C_ARBITRATION, DC_I2C_NO_QUEUED_SW_GO, mask_sh),\
118	I2C_SF(DC_I2C_ARBITRATION, DC_I2C_SW_PRIORITY, mask_sh),\
119	I2C_SF(DC_I2C_CONTROL, DC_I2C_SOFT_RESET, mask_sh),\
120	I2C_SF(DC_I2C_CONTROL, DC_I2C_SW_STATUS_RESET, mask_sh),\
121	I2C_SF(DC_I2C_CONTROL, DC_I2C_GO, mask_sh),\
122	I2C_SF(DC_I2C_CONTROL, DC_I2C_SEND_RESET, mask_sh),\
123	I2C_SF(DC_I2C_CONTROL, DC_I2C_TRANSACTION_COUNT, mask_sh),\
124	I2C_SF(DC_I2C_CONTROL, DC_I2C_DDC_SELECT, mask_sh),\
125	I2C_SF(DC_I2C_DDC1_SPEED, DC_I2C_DDC1_PRESCALE, mask_sh),\
126	I2C_SF(DC_I2C_DDC1_SPEED, DC_I2C_DDC1_THRESHOLD, mask_sh),\
127	I2C_SF(DC_I2C_SW_STATUS, DC_I2C_SW_STOPPED_ON_NACK, mask_sh),\
128	I2C_SF(DC_I2C_SW_STATUS, DC_I2C_SW_TIMEOUT, mask_sh),\
129	I2C_SF(DC_I2C_SW_STATUS, DC_I2C_SW_ABORTED, mask_sh),\
130	I2C_SF(DC_I2C_SW_STATUS, DC_I2C_SW_DONE, mask_sh),\
131	I2C_SF(DC_I2C_SW_STATUS, DC_I2C_SW_STATUS, mask_sh),\
132	I2C_SF(DC_I2C_TRANSACTION0, DC_I2C_STOP_ON_NACK0, mask_sh),\
133	I2C_SF(DC_I2C_TRANSACTION0, DC_I2C_START0, mask_sh),\
134	I2C_SF(DC_I2C_TRANSACTION0, DC_I2C_RW0, mask_sh),\
135	I2C_SF(DC_I2C_TRANSACTION0, DC_I2C_STOP0, mask_sh),\
136	I2C_SF(DC_I2C_TRANSACTION0, DC_I2C_COUNT0, mask_sh),\
137	I2C_SF(DC_I2C_DATA, DC_I2C_DATA_RW, mask_sh),\
138	I2C_SF(DC_I2C_DATA, DC_I2C_DATA, mask_sh),\
139	I2C_SF(DC_I2C_DATA, DC_I2C_INDEX, mask_sh),\
140	I2C_SF(DC_I2C_DATA, DC_I2C_INDEX_WRITE, mask_sh),\
141	I2C_SF(MICROSECOND_TIME_BASE_DIV, XTAL_REF_DIV, mask_sh),\
142	I2C_SF(MICROSECOND_TIME_BASE_DIV, MICROSECOND_TIME_BASE_DIV, mask_sh),\
143	I2C_SF(DC_I2C_ARBITRATION, DC_I2C_REG_RW_CNTL_STATUS, mask_sh)
144
145#define I2C_COMMON_MASK_SH_LIST_DCE110(mask_sh)\
146	I2C_COMMON_MASK_SH_LIST_DCE_COMMON_BASE(mask_sh),\
147	I2C_SF(DC_I2C_DDC1_SPEED, DC_I2C_DDC1_START_STOP_TIMING_CNTL, mask_sh)
148
149struct dce_i2c_shift {
150	uint8_t DC_I2C_DDC1_ENABLE;
151	uint8_t DC_I2C_DDC1_TIME_LIMIT;
152	uint8_t DC_I2C_DDC1_DATA_DRIVE_EN;
153	uint8_t DC_I2C_DDC1_CLK_DRIVE_EN;
154	uint8_t DC_I2C_DDC1_DATA_DRIVE_SEL;
155	uint8_t DC_I2C_DDC1_INTRA_TRANSACTION_DELAY;
156	uint8_t DC_I2C_DDC1_INTRA_BYTE_DELAY;
157	uint8_t DC_I2C_DDC1_HW_STATUS;
158	uint8_t DC_I2C_SW_DONE_USING_I2C_REG;
159	uint8_t DC_I2C_SW_USE_I2C_REG_REQ;
160	uint8_t DC_I2C_NO_QUEUED_SW_GO;
161	uint8_t DC_I2C_SW_PRIORITY;
162	uint8_t DC_I2C_SOFT_RESET;
163	uint8_t DC_I2C_SW_STATUS_RESET;
164	uint8_t DC_I2C_GO;
165	uint8_t DC_I2C_SEND_RESET;
166	uint8_t DC_I2C_TRANSACTION_COUNT;
167	uint8_t DC_I2C_DDC_SELECT;
168	uint8_t DC_I2C_DDC1_PRESCALE;
169	uint8_t DC_I2C_DDC1_THRESHOLD;
170	uint8_t DC_I2C_DDC1_START_STOP_TIMING_CNTL;
171	uint8_t DC_I2C_SW_STOPPED_ON_NACK;
172	uint8_t DC_I2C_SW_TIMEOUT;
173	uint8_t DC_I2C_SW_ABORTED;
174	uint8_t DC_I2C_SW_DONE;
175	uint8_t DC_I2C_SW_STATUS;
176	uint8_t DC_I2C_STOP_ON_NACK0;
177	uint8_t DC_I2C_START0;
178	uint8_t DC_I2C_RW0;
179	uint8_t DC_I2C_STOP0;
180	uint8_t DC_I2C_COUNT0;
181	uint8_t DC_I2C_DATA_RW;
182	uint8_t DC_I2C_DATA;
183	uint8_t DC_I2C_INDEX;
184	uint8_t DC_I2C_INDEX_WRITE;
185	uint8_t XTAL_REF_DIV;
186	uint8_t MICROSECOND_TIME_BASE_DIV;
187	uint8_t DC_I2C_DDC1_SEND_RESET_LENGTH;
188	uint8_t DC_I2C_REG_RW_CNTL_STATUS;
189	uint8_t I2C_LIGHT_SLEEP_FORCE;
190	uint8_t I2C_MEM_PWR_STATE;
191	uint8_t DC_I2C_DDC1_CLK_EN;
192};
193
194struct dce_i2c_mask {
195	uint32_t DC_I2C_DDC1_ENABLE;
196	uint32_t DC_I2C_DDC1_TIME_LIMIT;
197	uint32_t DC_I2C_DDC1_DATA_DRIVE_EN;
198	uint32_t DC_I2C_DDC1_CLK_DRIVE_EN;
199	uint32_t DC_I2C_DDC1_DATA_DRIVE_SEL;
200	uint32_t DC_I2C_DDC1_INTRA_TRANSACTION_DELAY;
201	uint32_t DC_I2C_DDC1_INTRA_BYTE_DELAY;
202	uint32_t DC_I2C_DDC1_HW_STATUS;
203	uint32_t DC_I2C_SW_DONE_USING_I2C_REG;
204	uint32_t DC_I2C_SW_USE_I2C_REG_REQ;
205	uint32_t DC_I2C_NO_QUEUED_SW_GO;
206	uint32_t DC_I2C_SW_PRIORITY;
207	uint32_t DC_I2C_SOFT_RESET;
208	uint32_t DC_I2C_SW_STATUS_RESET;
209	uint32_t DC_I2C_GO;
210	uint32_t DC_I2C_SEND_RESET;
211	uint32_t DC_I2C_TRANSACTION_COUNT;
212	uint32_t DC_I2C_DDC_SELECT;
213	uint32_t DC_I2C_DDC1_PRESCALE;
214	uint32_t DC_I2C_DDC1_THRESHOLD;
215	uint32_t DC_I2C_DDC1_START_STOP_TIMING_CNTL;
216	uint32_t DC_I2C_SW_STOPPED_ON_NACK;
217	uint32_t DC_I2C_SW_TIMEOUT;
218	uint32_t DC_I2C_SW_ABORTED;
219	uint32_t DC_I2C_SW_DONE;
220	uint32_t DC_I2C_SW_STATUS;
221	uint32_t DC_I2C_STOP_ON_NACK0;
222	uint32_t DC_I2C_START0;
223	uint32_t DC_I2C_RW0;
224	uint32_t DC_I2C_STOP0;
225	uint32_t DC_I2C_COUNT0;
226	uint32_t DC_I2C_DATA_RW;
227	uint32_t DC_I2C_DATA;
228	uint32_t DC_I2C_INDEX;
229	uint32_t DC_I2C_INDEX_WRITE;
230	uint32_t XTAL_REF_DIV;
231	uint32_t MICROSECOND_TIME_BASE_DIV;
232	uint32_t DC_I2C_DDC1_SEND_RESET_LENGTH;
233	uint32_t DC_I2C_REG_RW_CNTL_STATUS;
234	uint32_t I2C_LIGHT_SLEEP_FORCE;
235	uint32_t I2C_MEM_PWR_STATE;
236	uint32_t DC_I2C_DDC1_CLK_EN;
237};
238
239#define I2C_COMMON_MASK_SH_LIST_DCN2(mask_sh)\
240	I2C_COMMON_MASK_SH_LIST_DCE110(mask_sh),\
241	I2C_SF(DC_I2C_DDC1_SETUP, DC_I2C_DDC1_SEND_RESET_LENGTH, mask_sh)
242
243#define I2C_COMMON_MASK_SH_LIST_DCN30(mask_sh)\
244	I2C_COMMON_MASK_SH_LIST_DCN2(mask_sh),\
245	I2C_SF(DIO_MEM_PWR_CTRL, I2C_LIGHT_SLEEP_FORCE, mask_sh),\
246	I2C_SF(DIO_MEM_PWR_STATUS, I2C_MEM_PWR_STATE, mask_sh)
247
248#define I2C_COMMON_MASK_SH_LIST_DCN35(mask_sh)\
249	I2C_COMMON_MASK_SH_LIST_DCN30(mask_sh),\
250	I2C_SF(DC_I2C_DDC1_SETUP, DC_I2C_DDC1_CLK_EN, mask_sh)
251
252struct dce_i2c_registers {
253	uint32_t SETUP;
254	uint32_t SPEED;
255	uint32_t HW_STATUS;
256	uint32_t DC_I2C_ARBITRATION;
257	uint32_t DC_I2C_CONTROL;
258	uint32_t DC_I2C_SW_STATUS;
259	uint32_t DC_I2C_TRANSACTION0;
260	uint32_t DC_I2C_TRANSACTION1;
261	uint32_t DC_I2C_TRANSACTION2;
262	uint32_t DC_I2C_TRANSACTION3;
263	uint32_t DC_I2C_DATA;
264	uint32_t MICROSECOND_TIME_BASE_DIV;
265	uint32_t DIO_MEM_PWR_CTRL;
266	uint32_t DIO_MEM_PWR_STATUS;
267};
268
269enum dce_i2c_transaction_address_space {
270	DCE_I2C_TRANSACTION_ADDRESS_SPACE_I2C = 1,
271	DCE_I2C_TRANSACTION_ADDRESS_SPACE_DPCD
272};
273
274struct i2c_request_transaction_data {
275	enum dce_i2c_transaction_action action;
276	enum i2c_channel_operation_result status;
277	uint8_t address;
278	uint32_t length;
279	uint8_t *data;
280};
281
282struct dce_i2c_hw {
283	struct ddc *ddc;
284	uint32_t engine_keep_power_up_count;
285	uint32_t transaction_count;
286	uint32_t buffer_used_bytes;
287	uint32_t buffer_used_write;
288	uint32_t reference_frequency;
289	uint32_t default_speed;
290	uint32_t engine_id;
291	uint32_t setup_limit;
292	uint32_t send_reset_length;
293	uint32_t buffer_size;
294	struct dc_context *ctx;
295
296	const struct dce_i2c_registers *regs;
297	const struct dce_i2c_shift *shifts;
298	const struct dce_i2c_mask *masks;
299};
300
301void dce_i2c_hw_construct(
302	struct dce_i2c_hw *dce_i2c_hw,
303	struct dc_context *ctx,
304	uint32_t engine_id,
305	const struct dce_i2c_registers *regs,
306	const struct dce_i2c_shift *shifts,
307	const struct dce_i2c_mask *masks);
308
309void dce100_i2c_hw_construct(
310	struct dce_i2c_hw *dce_i2c_hw,
311	struct dc_context *ctx,
312	uint32_t engine_id,
313	const struct dce_i2c_registers *regs,
314	const struct dce_i2c_shift *shifts,
315	const struct dce_i2c_mask *masks);
316
317void dce112_i2c_hw_construct(
318	struct dce_i2c_hw *dce_i2c_hw,
319	struct dc_context *ctx,
320	uint32_t engine_id,
321	const struct dce_i2c_registers *regs,
322	const struct dce_i2c_shift *shifts,
323	const struct dce_i2c_mask *masks);
324
325void dcn1_i2c_hw_construct(
326	struct dce_i2c_hw *dce_i2c_hw,
327	struct dc_context *ctx,
328	uint32_t engine_id,
329	const struct dce_i2c_registers *regs,
330	const struct dce_i2c_shift *shifts,
331	const struct dce_i2c_mask *masks);
332
333void dcn2_i2c_hw_construct(
334	struct dce_i2c_hw *dce_i2c_hw,
335	struct dc_context *ctx,
336	uint32_t engine_id,
337	const struct dce_i2c_registers *regs,
338	const struct dce_i2c_shift *shifts,
339	const struct dce_i2c_mask *masks);
340
341bool dce_i2c_submit_command_hw(
342	struct resource_pool *pool,
343	struct ddc *ddc,
344	struct i2c_command *cmd,
345	struct dce_i2c_hw *dce_i2c_hw);
346
347struct dce_i2c_hw *acquire_i2c_hw_engine(
348	struct resource_pool *pool,
349	struct ddc *ddc);
350
351#endif