xref: /linux/drivers/gpu/drm/amd/amdgpu/amdgpu_reg_access.h (revision 74b9c49e6d8ba2586081aecd86af96c510092103)
1 /* SPDX-License-Identifier: MIT */
2 /*
3  * Copyright 2025 Advanced Micro Devices, Inc.
4  *
5  * Permission is hereby granted, free of charge, to any person obtaining a
6  * copy of this software and associated documentation files (the "Software"),
7  * to deal in the Software without restriction, including without limitation
8  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
9  * and/or sell copies of the Software, and to permit persons to whom the
10  * Software is furnished to do so, subject to the following conditions:
11  *
12  * The above copyright notice and this permission notice shall be included in
13  * all copies or substantial portions of the Software.
14  *
15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
18  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
19  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
20  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
21  * OTHER DEALINGS IN THE SOFTWARE.
22  */
23 
24 #ifndef __AMDGPU_REG_ACCESS_H__
25 #define __AMDGPU_REG_ACCESS_H__
26 
27 #include <linux/types.h>
28 #include <linux/spinlock.h>
29 
30 struct amdgpu_device;
31 
32 typedef uint32_t (*amdgpu_rreg_t)(struct amdgpu_device *, uint32_t);
33 typedef void (*amdgpu_wreg_t)(struct amdgpu_device *, uint32_t, uint32_t);
34 typedef uint32_t (*amdgpu_rreg_ext_t)(struct amdgpu_device *, uint64_t);
35 typedef void (*amdgpu_wreg_ext_t)(struct amdgpu_device *, uint64_t, uint32_t);
36 typedef uint64_t (*amdgpu_rreg64_t)(struct amdgpu_device *, uint32_t);
37 typedef void (*amdgpu_wreg64_t)(struct amdgpu_device *, uint32_t, uint64_t);
38 
39 typedef uint32_t (*amdgpu_block_rreg_t)(struct amdgpu_device *, uint32_t,
40 					uint32_t);
41 typedef void (*amdgpu_block_wreg_t)(struct amdgpu_device *, uint32_t, uint32_t,
42 				    uint32_t);
43 
44 struct amdgpu_reg_ind {
45 	spinlock_t lock;
46 	amdgpu_rreg_t rreg;
47 	amdgpu_wreg_t wreg;
48 };
49 
50 struct amdgpu_reg_ind_blk {
51 	spinlock_t lock;
52 	amdgpu_block_rreg_t rreg;
53 	amdgpu_block_wreg_t wreg;
54 };
55 
56 struct amdgpu_reg_pcie_ind {
57 	amdgpu_rreg_t rreg;
58 	amdgpu_wreg_t wreg;
59 	amdgpu_rreg_ext_t rreg_ext;
60 	amdgpu_wreg_ext_t wreg_ext;
61 	amdgpu_rreg64_t rreg64;
62 	amdgpu_wreg64_t wreg64;
63 	amdgpu_rreg_t port_rreg;
64 	amdgpu_wreg_t port_wreg;
65 };
66 
67 struct amdgpu_reg_access {
68 	struct amdgpu_reg_ind smc;
69 	struct amdgpu_reg_ind uvd_ctx;
70 	struct amdgpu_reg_ind didt;
71 	struct amdgpu_reg_ind gc_cac;
72 	struct amdgpu_reg_ind se_cac;
73 	struct amdgpu_reg_ind_blk audio_endpt;
74 	struct amdgpu_reg_pcie_ind pcie;
75 };
76 
77 void amdgpu_reg_access_init(struct amdgpu_device *adev);
78 uint32_t amdgpu_reg_smc_rd32(struct amdgpu_device *adev, uint32_t reg);
79 void amdgpu_reg_smc_wr32(struct amdgpu_device *adev, uint32_t reg, uint32_t v);
80 uint32_t amdgpu_reg_uvd_ctx_rd32(struct amdgpu_device *adev, uint32_t reg);
81 void amdgpu_reg_uvd_ctx_wr32(struct amdgpu_device *adev, uint32_t reg, uint32_t v);
82 uint32_t amdgpu_reg_didt_rd32(struct amdgpu_device *adev, uint32_t reg);
83 void amdgpu_reg_didt_wr32(struct amdgpu_device *adev, uint32_t reg, uint32_t v);
84 uint32_t amdgpu_reg_gc_cac_rd32(struct amdgpu_device *adev, uint32_t reg);
85 void amdgpu_reg_gc_cac_wr32(struct amdgpu_device *adev, uint32_t reg,
86 			    uint32_t v);
87 uint32_t amdgpu_reg_se_cac_rd32(struct amdgpu_device *adev, uint32_t reg);
88 void amdgpu_reg_se_cac_wr32(struct amdgpu_device *adev, uint32_t reg,
89 			    uint32_t v);
90 uint32_t amdgpu_reg_audio_endpt_rd32(struct amdgpu_device *adev, uint32_t block,
91 				     uint32_t reg);
92 void amdgpu_reg_audio_endpt_wr32(struct amdgpu_device *adev, uint32_t block,
93 				 uint32_t reg, uint32_t v);
94 uint32_t amdgpu_reg_pcie_rd32(struct amdgpu_device *adev, uint32_t reg);
95 void amdgpu_reg_pcie_wr32(struct amdgpu_device *adev, uint32_t reg, uint32_t v);
96 uint32_t amdgpu_reg_pcie_ext_rd32(struct amdgpu_device *adev, uint64_t reg);
97 void amdgpu_reg_pcie_ext_wr32(struct amdgpu_device *adev, uint64_t reg,
98 			      uint32_t v);
99 uint64_t amdgpu_reg_pcie_rd64(struct amdgpu_device *adev, uint32_t reg);
100 void amdgpu_reg_pcie_wr64(struct amdgpu_device *adev, uint32_t reg, uint64_t v);
101 uint32_t amdgpu_reg_pciep_rd32(struct amdgpu_device *adev, uint32_t reg);
102 void amdgpu_reg_pciep_wr32(struct amdgpu_device *adev, uint32_t reg,
103 			   uint32_t v);
104 
105 typedef uint64_t (*amdgpu_rreg64_ext_t)(struct amdgpu_device *, uint64_t);
106 typedef void (*amdgpu_wreg64_ext_t)(struct amdgpu_device *, uint64_t, uint64_t);
107 
108 uint32_t amdgpu_device_rreg(struct amdgpu_device *adev, uint32_t reg,
109 			    uint32_t acc_flags);
110 uint32_t amdgpu_device_xcc_rreg(struct amdgpu_device *adev, uint32_t reg,
111 				uint32_t acc_flags, uint32_t xcc_id);
112 void amdgpu_device_wreg(struct amdgpu_device *adev, uint32_t reg, uint32_t v,
113 			uint32_t acc_flags);
114 void amdgpu_device_xcc_wreg(struct amdgpu_device *adev, uint32_t reg,
115 			    uint32_t v, uint32_t acc_flags, uint32_t xcc_id);
116 void amdgpu_mm_wreg_mmio_rlc(struct amdgpu_device *adev, uint32_t reg,
117 			     uint32_t v, uint32_t xcc_id);
118 void amdgpu_mm_wreg8(struct amdgpu_device *adev, uint32_t offset,
119 		     uint8_t value);
120 uint8_t amdgpu_mm_rreg8(struct amdgpu_device *adev, uint32_t offset);
121 
122 u32 amdgpu_device_indirect_rreg(struct amdgpu_device *adev, u32 reg_addr);
123 u32 amdgpu_device_indirect_rreg_ext(struct amdgpu_device *adev, u64 reg_addr);
124 u64 amdgpu_device_indirect_rreg64(struct amdgpu_device *adev, u32 reg_addr);
125 u64 amdgpu_device_indirect_rreg64_ext(struct amdgpu_device *adev, u64 reg_addr);
126 void amdgpu_device_indirect_wreg(struct amdgpu_device *adev, u32 reg_addr,
127 				 u32 reg_data);
128 void amdgpu_device_indirect_wreg_ext(struct amdgpu_device *adev, u64 reg_addr,
129 				     u32 reg_data);
130 void amdgpu_device_indirect_wreg64(struct amdgpu_device *adev, u32 reg_addr,
131 				   u64 reg_data);
132 void amdgpu_device_indirect_wreg64_ext(struct amdgpu_device *adev, u64 reg_addr,
133 				       u64 reg_data);
134 
135 u32 amdgpu_device_pcie_port_rreg(struct amdgpu_device *adev, u32 reg);
136 void amdgpu_device_pcie_port_wreg(struct amdgpu_device *adev, u32 reg, u32 v);
137 
138 uint32_t amdgpu_device_wait_on_rreg(struct amdgpu_device *adev, uint32_t inst,
139 				    uint32_t reg_addr, char reg_name[],
140 				    uint32_t expected_value, uint32_t mask);
141 
142 #endif /* __AMDGPU_REG_ACCESS_H__ */
143