xref: /netbsd-src/sys/external/bsd/drm2/dist/drm/radeon/atom.h (revision 41ec02673d281bbb3d38e6c78504ce6e30c228c1)
1 /*	$NetBSD: atom.h,v 1.4 2021/12/18 23:45:42 riastradh Exp $	*/
2 
3 /*
4  * Copyright 2008 Advanced Micro Devices, Inc.
5  *
6  * Permission is hereby granted, free of charge, to any person obtaining a
7  * copy of this software and associated documentation files (the "Software"),
8  * to deal in the Software without restriction, including without limitation
9  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
10  * and/or sell copies of the Software, and to permit persons to whom the
11  * Software is furnished to do so, subject to the following conditions:
12  *
13  * The above copyright notice and this permission notice shall be included in
14  * all copies or substantial portions of the Software.
15  *
16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
19  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
20  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
21  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
22  * OTHER DEALINGS IN THE SOFTWARE.
23  *
24  * Author: Stanislaw Skowronek
25  */
26 
27 #ifndef ATOM_H
28 #define ATOM_H
29 
30 #include <linux/mutex.h>
31 #include <linux/types.h>
32 
33 #define ATOM_BIOS_MAGIC		0xAA55
34 #define ATOM_ATI_MAGIC_PTR	0x30
35 #define ATOM_ATI_MAGIC		" 761295520"
36 #define ATOM_ROM_TABLE_PTR	0x48
37 
38 #define ATOM_ROM_MAGIC		"ATOM"
39 #define ATOM_ROM_MAGIC_PTR	4
40 
41 #define ATOM_ROM_MSG_PTR	0x10
42 #define ATOM_ROM_CMD_PTR	0x1E
43 #define ATOM_ROM_DATA_PTR	0x20
44 
45 #define ATOM_CMD_INIT		0
46 #define ATOM_CMD_SETSCLK	0x0A
47 #define ATOM_CMD_SETMCLK	0x0B
48 #define ATOM_CMD_SETPCLK	0x0C
49 #define ATOM_CMD_SPDFANCNTL	0x39
50 
51 #define ATOM_DATA_FWI_PTR	0xC
52 #define ATOM_DATA_IIO_PTR	0x32
53 
54 #define ATOM_FWI_DEFSCLK_PTR	8
55 #define ATOM_FWI_DEFMCLK_PTR	0xC
56 #define ATOM_FWI_MAXSCLK_PTR	0x24
57 #define ATOM_FWI_MAXMCLK_PTR	0x28
58 
59 #define ATOM_CT_SIZE_PTR	0
60 #define ATOM_CT_WS_PTR		4
61 #define ATOM_CT_PS_PTR		5
62 #define ATOM_CT_PS_MASK		0x7F
63 #define ATOM_CT_CODE_PTR	6
64 
65 #define ATOM_OP_CNT		123
66 #define ATOM_OP_EOT		91
67 
68 #define ATOM_CASE_MAGIC		0x63
69 #define ATOM_CASE_END		0x5A5A
70 
71 #define ATOM_ARG_REG		0
72 #define ATOM_ARG_PS		1
73 #define ATOM_ARG_WS		2
74 #define ATOM_ARG_FB		3
75 #define ATOM_ARG_ID		4
76 #define ATOM_ARG_IMM		5
77 #define ATOM_ARG_PLL		6
78 #define ATOM_ARG_MC		7
79 
80 #define ATOM_SRC_DWORD		0
81 #define ATOM_SRC_WORD0		1
82 #define ATOM_SRC_WORD8		2
83 #define ATOM_SRC_WORD16		3
84 #define ATOM_SRC_BYTE0		4
85 #define ATOM_SRC_BYTE8		5
86 #define ATOM_SRC_BYTE16		6
87 #define ATOM_SRC_BYTE24		7
88 
89 #define ATOM_WS_QUOTIENT	0x40
90 #define ATOM_WS_REMAINDER	0x41
91 #define ATOM_WS_DATAPTR		0x42
92 #define ATOM_WS_SHIFT		0x43
93 #define ATOM_WS_OR_MASK		0x44
94 #define ATOM_WS_AND_MASK	0x45
95 #define ATOM_WS_FB_WINDOW	0x46
96 #define ATOM_WS_ATTRIBUTES	0x47
97 #define ATOM_WS_REGPTR  	0x48
98 
99 #define ATOM_IIO_NOP		0
100 #define ATOM_IIO_START		1
101 #define ATOM_IIO_READ		2
102 #define ATOM_IIO_WRITE		3
103 #define ATOM_IIO_CLEAR		4
104 #define ATOM_IIO_SET		5
105 #define ATOM_IIO_MOVE_INDEX	6
106 #define ATOM_IIO_MOVE_ATTR	7
107 #define ATOM_IIO_MOVE_DATA	8
108 #define ATOM_IIO_END		9
109 
110 #define ATOM_IO_MM		0
111 #define ATOM_IO_PCI		1
112 #define ATOM_IO_SYSIO		2
113 #define ATOM_IO_IIO		0x80
114 
115 struct card_info {
116 	struct drm_device *dev;
117 	void (* reg_write)(struct card_info *, uint32_t, uint32_t);   /*  filled by driver */
118         uint32_t (* reg_read)(struct card_info *, uint32_t);          /*  filled by driver */
119 	void (* ioreg_write)(struct card_info *, uint32_t, uint32_t);   /*  filled by driver */
120         uint32_t (* ioreg_read)(struct card_info *, uint32_t);          /*  filled by driver */
121 	void (* mc_write)(struct card_info *, uint32_t, uint32_t);   /*  filled by driver */
122         uint32_t (* mc_read)(struct card_info *, uint32_t);          /*  filled by driver */
123 	void (* pll_write)(struct card_info *, uint32_t, uint32_t);   /*  filled by driver */
124         uint32_t (* pll_read)(struct card_info *, uint32_t);          /*  filled by driver */
125 };
126 
127 struct atom_context {
128 	struct card_info *card;
129 	struct mutex mutex;
130 	struct mutex scratch_mutex;
131 	uint8_t *bios;
132 	uint32_t cmd_table, data_table;
133 	uint16_t *iio;
134 
135 	uint16_t data_block;
136 	uint32_t fb_base;
137 	uint32_t divmul[2];
138 	uint16_t io_attr;
139 	uint16_t reg_block;
140 	uint8_t shift;
141 	int cs_equal, cs_above;
142 	int io_mode;
143 	uint32_t *scratch;
144 	int scratch_size_bytes;
145 };
146 
147 extern int atom_debug;
148 
149 struct atom_context *atom_parse(struct card_info *, void *);
150 int atom_execute_table(struct atom_context *, int, uint32_t *);
151 int atom_execute_table_scratch_unlocked(struct atom_context *, int, uint32_t *);
152 int atom_asic_init(struct atom_context *);
153 void atom_destroy(struct atom_context *);
154 bool atom_parse_data_header(struct atom_context *ctx, int index, uint16_t *size,
155 			    uint8_t *frev, uint8_t *crev, uint16_t *data_start);
156 bool atom_parse_cmd_header(struct atom_context *ctx, int index,
157 			   uint8_t *frev, uint8_t *crev);
158 int atom_allocate_fb_scratch(struct atom_context *ctx);
159 #include "atom-types.h"
160 #include "atombios.h"
161 #include "ObjectID.h"
162 
163 #endif
164