xref: /openbmc/linux/drivers/acpi/acpica/rsaddr.c (revision ddc141e5)
1 /*******************************************************************************
2  *
3  * Module Name: rsaddr - Address resource descriptors (16/32/64)
4  *
5  ******************************************************************************/
6 
7 /*
8  * Copyright (C) 2000 - 2018, Intel Corp.
9  * All rights reserved.
10  *
11  * Redistribution and use in source and binary forms, with or without
12  * modification, are permitted provided that the following conditions
13  * are met:
14  * 1. Redistributions of source code must retain the above copyright
15  *    notice, this list of conditions, and the following disclaimer,
16  *    without modification.
17  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
18  *    substantially similar to the "NO WARRANTY" disclaimer below
19  *    ("Disclaimer") and any redistribution must be conditioned upon
20  *    including a substantially similar Disclaimer requirement for further
21  *    binary redistribution.
22  * 3. Neither the names of the above-listed copyright holders nor the names
23  *    of any contributors may be used to endorse or promote products derived
24  *    from this software without specific prior written permission.
25  *
26  * Alternatively, this software may be distributed under the terms of the
27  * GNU General Public License ("GPL") version 2 as published by the Free
28  * Software Foundation.
29  *
30  * NO WARRANTY
31  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
32  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
33  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
34  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
35  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
39  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
40  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
41  * POSSIBILITY OF SUCH DAMAGES.
42  */
43 
44 #include <acpi/acpi.h>
45 #include "accommon.h"
46 #include "acresrc.h"
47 
48 #define _COMPONENT          ACPI_RESOURCES
49 ACPI_MODULE_NAME("rsaddr")
50 
51 /*******************************************************************************
52  *
53  * acpi_rs_convert_address16 - All WORD (16-bit) address resources
54  *
55  ******************************************************************************/
56 struct acpi_rsconvert_info acpi_rs_convert_address16[5] = {
57 	{ACPI_RSC_INITGET, ACPI_RESOURCE_TYPE_ADDRESS16,
58 	 ACPI_RS_SIZE(struct acpi_resource_address16),
59 	 ACPI_RSC_TABLE_SIZE(acpi_rs_convert_address16)},
60 
61 	{ACPI_RSC_INITSET, ACPI_RESOURCE_NAME_ADDRESS16,
62 	 sizeof(struct aml_resource_address16),
63 	 0},
64 
65 	/* Resource Type, General Flags, and Type-Specific Flags */
66 
67 	{ACPI_RSC_ADDRESS, 0, 0, 0},
68 
69 	/*
70 	 * These fields are contiguous in both the source and destination:
71 	 * Address Granularity
72 	 * Address Range Minimum
73 	 * Address Range Maximum
74 	 * Address Translation Offset
75 	 * Address Length
76 	 */
77 	{ACPI_RSC_MOVE16, ACPI_RS_OFFSET(data.address16.address.granularity),
78 	 AML_OFFSET(address16.granularity),
79 	 5},
80 
81 	/* Optional resource_source (Index and String) */
82 
83 	{ACPI_RSC_SOURCE, ACPI_RS_OFFSET(data.address16.resource_source),
84 	 0,
85 	 sizeof(struct aml_resource_address16)}
86 };
87 
88 /*******************************************************************************
89  *
90  * acpi_rs_convert_address32 - All DWORD (32-bit) address resources
91  *
92  ******************************************************************************/
93 
94 struct acpi_rsconvert_info acpi_rs_convert_address32[5] = {
95 	{ACPI_RSC_INITGET, ACPI_RESOURCE_TYPE_ADDRESS32,
96 	 ACPI_RS_SIZE(struct acpi_resource_address32),
97 	 ACPI_RSC_TABLE_SIZE(acpi_rs_convert_address32)},
98 
99 	{ACPI_RSC_INITSET, ACPI_RESOURCE_NAME_ADDRESS32,
100 	 sizeof(struct aml_resource_address32),
101 	 0},
102 
103 	/* Resource Type, General Flags, and Type-Specific Flags */
104 
105 	{ACPI_RSC_ADDRESS, 0, 0, 0},
106 
107 	/*
108 	 * These fields are contiguous in both the source and destination:
109 	 * Address Granularity
110 	 * Address Range Minimum
111 	 * Address Range Maximum
112 	 * Address Translation Offset
113 	 * Address Length
114 	 */
115 	{ACPI_RSC_MOVE32, ACPI_RS_OFFSET(data.address32.address.granularity),
116 	 AML_OFFSET(address32.granularity),
117 	 5},
118 
119 	/* Optional resource_source (Index and String) */
120 
121 	{ACPI_RSC_SOURCE, ACPI_RS_OFFSET(data.address32.resource_source),
122 	 0,
123 	 sizeof(struct aml_resource_address32)}
124 };
125 
126 /*******************************************************************************
127  *
128  * acpi_rs_convert_address64 - All QWORD (64-bit) address resources
129  *
130  ******************************************************************************/
131 
132 struct acpi_rsconvert_info acpi_rs_convert_address64[5] = {
133 	{ACPI_RSC_INITGET, ACPI_RESOURCE_TYPE_ADDRESS64,
134 	 ACPI_RS_SIZE(struct acpi_resource_address64),
135 	 ACPI_RSC_TABLE_SIZE(acpi_rs_convert_address64)},
136 
137 	{ACPI_RSC_INITSET, ACPI_RESOURCE_NAME_ADDRESS64,
138 	 sizeof(struct aml_resource_address64),
139 	 0},
140 
141 	/* Resource Type, General Flags, and Type-Specific Flags */
142 
143 	{ACPI_RSC_ADDRESS, 0, 0, 0},
144 
145 	/*
146 	 * These fields are contiguous in both the source and destination:
147 	 * Address Granularity
148 	 * Address Range Minimum
149 	 * Address Range Maximum
150 	 * Address Translation Offset
151 	 * Address Length
152 	 */
153 	{ACPI_RSC_MOVE64, ACPI_RS_OFFSET(data.address64.address.granularity),
154 	 AML_OFFSET(address64.granularity),
155 	 5},
156 
157 	/* Optional resource_source (Index and String) */
158 
159 	{ACPI_RSC_SOURCE, ACPI_RS_OFFSET(data.address64.resource_source),
160 	 0,
161 	 sizeof(struct aml_resource_address64)}
162 };
163 
164 /*******************************************************************************
165  *
166  * acpi_rs_convert_ext_address64 - All Extended (64-bit) address resources
167  *
168  ******************************************************************************/
169 
170 struct acpi_rsconvert_info acpi_rs_convert_ext_address64[5] = {
171 	{ACPI_RSC_INITGET, ACPI_RESOURCE_TYPE_EXTENDED_ADDRESS64,
172 	 ACPI_RS_SIZE(struct acpi_resource_extended_address64),
173 	 ACPI_RSC_TABLE_SIZE(acpi_rs_convert_ext_address64)},
174 
175 	{ACPI_RSC_INITSET, ACPI_RESOURCE_NAME_EXTENDED_ADDRESS64,
176 	 sizeof(struct aml_resource_extended_address64),
177 	 0},
178 
179 	/* Resource Type, General Flags, and Type-Specific Flags */
180 
181 	{ACPI_RSC_ADDRESS, 0, 0, 0},
182 
183 	/* Revision ID */
184 
185 	{ACPI_RSC_MOVE8, ACPI_RS_OFFSET(data.ext_address64.revision_ID),
186 	 AML_OFFSET(ext_address64.revision_ID),
187 	 1},
188 	/*
189 	 * These fields are contiguous in both the source and destination:
190 	 * Address Granularity
191 	 * Address Range Minimum
192 	 * Address Range Maximum
193 	 * Address Translation Offset
194 	 * Address Length
195 	 * Type-Specific Attribute
196 	 */
197 	{ACPI_RSC_MOVE64,
198 	 ACPI_RS_OFFSET(data.ext_address64.address.granularity),
199 	 AML_OFFSET(ext_address64.granularity),
200 	 6}
201 };
202 
203 /*******************************************************************************
204  *
205  * acpi_rs_convert_general_flags - Flags common to all address descriptors
206  *
207  ******************************************************************************/
208 
209 static struct acpi_rsconvert_info acpi_rs_convert_general_flags[6] = {
210 	{ACPI_RSC_FLAGINIT, 0, AML_OFFSET(address.flags),
211 	 ACPI_RSC_TABLE_SIZE(acpi_rs_convert_general_flags)},
212 
213 	/* Resource Type (Memory, Io, bus_number, etc.) */
214 
215 	{ACPI_RSC_MOVE8, ACPI_RS_OFFSET(data.address.resource_type),
216 	 AML_OFFSET(address.resource_type),
217 	 1},
218 
219 	/* General flags - Consume, Decode, min_fixed, max_fixed */
220 
221 	{ACPI_RSC_1BITFLAG, ACPI_RS_OFFSET(data.address.producer_consumer),
222 	 AML_OFFSET(address.flags),
223 	 0},
224 
225 	{ACPI_RSC_1BITFLAG, ACPI_RS_OFFSET(data.address.decode),
226 	 AML_OFFSET(address.flags),
227 	 1},
228 
229 	{ACPI_RSC_1BITFLAG, ACPI_RS_OFFSET(data.address.min_address_fixed),
230 	 AML_OFFSET(address.flags),
231 	 2},
232 
233 	{ACPI_RSC_1BITFLAG, ACPI_RS_OFFSET(data.address.max_address_fixed),
234 	 AML_OFFSET(address.flags),
235 	 3}
236 };
237 
238 /*******************************************************************************
239  *
240  * acpi_rs_convert_mem_flags - Flags common to Memory address descriptors
241  *
242  ******************************************************************************/
243 
244 static struct acpi_rsconvert_info acpi_rs_convert_mem_flags[5] = {
245 	{ACPI_RSC_FLAGINIT, 0, AML_OFFSET(address.specific_flags),
246 	 ACPI_RSC_TABLE_SIZE(acpi_rs_convert_mem_flags)},
247 
248 	/* Memory-specific flags */
249 
250 	{ACPI_RSC_1BITFLAG, ACPI_RS_OFFSET(data.address.info.mem.write_protect),
251 	 AML_OFFSET(address.specific_flags),
252 	 0},
253 
254 	{ACPI_RSC_2BITFLAG, ACPI_RS_OFFSET(data.address.info.mem.caching),
255 	 AML_OFFSET(address.specific_flags),
256 	 1},
257 
258 	{ACPI_RSC_2BITFLAG, ACPI_RS_OFFSET(data.address.info.mem.range_type),
259 	 AML_OFFSET(address.specific_flags),
260 	 3},
261 
262 	{ACPI_RSC_1BITFLAG, ACPI_RS_OFFSET(data.address.info.mem.translation),
263 	 AML_OFFSET(address.specific_flags),
264 	 5}
265 };
266 
267 /*******************************************************************************
268  *
269  * acpi_rs_convert_io_flags - Flags common to I/O address descriptors
270  *
271  ******************************************************************************/
272 
273 static struct acpi_rsconvert_info acpi_rs_convert_io_flags[4] = {
274 	{ACPI_RSC_FLAGINIT, 0, AML_OFFSET(address.specific_flags),
275 	 ACPI_RSC_TABLE_SIZE(acpi_rs_convert_io_flags)},
276 
277 	/* I/O-specific flags */
278 
279 	{ACPI_RSC_2BITFLAG, ACPI_RS_OFFSET(data.address.info.io.range_type),
280 	 AML_OFFSET(address.specific_flags),
281 	 0},
282 
283 	{ACPI_RSC_1BITFLAG, ACPI_RS_OFFSET(data.address.info.io.translation),
284 	 AML_OFFSET(address.specific_flags),
285 	 4},
286 
287 	{ACPI_RSC_1BITFLAG,
288 	 ACPI_RS_OFFSET(data.address.info.io.translation_type),
289 	 AML_OFFSET(address.specific_flags),
290 	 5}
291 };
292 
293 /*******************************************************************************
294  *
295  * FUNCTION:    acpi_rs_get_address_common
296  *
297  * PARAMETERS:  resource            - Pointer to the internal resource struct
298  *              aml                 - Pointer to the AML resource descriptor
299  *
300  * RETURN:      TRUE if the resource_type field is OK, FALSE otherwise
301  *
302  * DESCRIPTION: Convert common flag fields from a raw AML resource descriptor
303  *              to an internal resource descriptor
304  *
305  ******************************************************************************/
306 
307 u8
308 acpi_rs_get_address_common(struct acpi_resource *resource,
309 			   union aml_resource *aml)
310 {
311 	ACPI_FUNCTION_ENTRY();
312 
313 	/* Validate the Resource Type */
314 
315 	if ((aml->address.resource_type > 2) &&
316 	    (aml->address.resource_type < 0xC0)) {
317 		return (FALSE);
318 	}
319 
320 	/* Get the Resource Type and General Flags */
321 
322 	(void)acpi_rs_convert_aml_to_resource(resource, aml,
323 					      acpi_rs_convert_general_flags);
324 
325 	/* Get the Type-Specific Flags (Memory and I/O descriptors only) */
326 
327 	if (resource->data.address.resource_type == ACPI_MEMORY_RANGE) {
328 		(void)acpi_rs_convert_aml_to_resource(resource, aml,
329 						      acpi_rs_convert_mem_flags);
330 	} else if (resource->data.address.resource_type == ACPI_IO_RANGE) {
331 		(void)acpi_rs_convert_aml_to_resource(resource, aml,
332 						      acpi_rs_convert_io_flags);
333 	} else {
334 		/* Generic resource type, just grab the type_specific byte */
335 
336 		resource->data.address.info.type_specific =
337 		    aml->address.specific_flags;
338 	}
339 
340 	return (TRUE);
341 }
342 
343 /*******************************************************************************
344  *
345  * FUNCTION:    acpi_rs_set_address_common
346  *
347  * PARAMETERS:  aml                 - Pointer to the AML resource descriptor
348  *              resource            - Pointer to the internal resource struct
349  *
350  * RETURN:      None
351  *
352  * DESCRIPTION: Convert common flag fields from a resource descriptor to an
353  *              AML descriptor
354  *
355  ******************************************************************************/
356 
357 void
358 acpi_rs_set_address_common(union aml_resource *aml,
359 			   struct acpi_resource *resource)
360 {
361 	ACPI_FUNCTION_ENTRY();
362 
363 	/* Set the Resource Type and General Flags */
364 
365 	(void)acpi_rs_convert_resource_to_aml(resource, aml,
366 					      acpi_rs_convert_general_flags);
367 
368 	/* Set the Type-Specific Flags (Memory and I/O descriptors only) */
369 
370 	if (resource->data.address.resource_type == ACPI_MEMORY_RANGE) {
371 		(void)acpi_rs_convert_resource_to_aml(resource, aml,
372 						      acpi_rs_convert_mem_flags);
373 	} else if (resource->data.address.resource_type == ACPI_IO_RANGE) {
374 		(void)acpi_rs_convert_resource_to_aml(resource, aml,
375 						      acpi_rs_convert_io_flags);
376 	} else {
377 		/* Generic resource type, just copy the type_specific byte */
378 
379 		aml->address.specific_flags =
380 		    resource->data.address.info.type_specific;
381 	}
382 }
383