xref: /linux/drivers/acpi/acpica/rsaddr.c (revision 33619f0d3ff715a2a5499520967d526ad931d70d)
1 /*******************************************************************************
2  *
3  * Module Name: rsaddr - Address resource descriptors (16/32/64)
4  *
5  ******************************************************************************/
6 
7 /*
8  * Copyright (C) 2000 - 2011, 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.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.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.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, ACPI_RS_OFFSET(data.ext_address64.granularity),
198 	 AML_OFFSET(ext_address64.granularity),
199 	 6}
200 };
201 
202 /*******************************************************************************
203  *
204  * acpi_rs_convert_general_flags - Flags common to all address descriptors
205  *
206  ******************************************************************************/
207 
208 static struct acpi_rsconvert_info acpi_rs_convert_general_flags[6] = {
209 	{ACPI_RSC_FLAGINIT, 0, AML_OFFSET(address.flags),
210 	 ACPI_RSC_TABLE_SIZE(acpi_rs_convert_general_flags)},
211 
212 	/* Resource Type (Memory, Io, bus_number, etc.) */
213 
214 	{ACPI_RSC_MOVE8, ACPI_RS_OFFSET(data.address.resource_type),
215 	 AML_OFFSET(address.resource_type),
216 	 1},
217 
218 	/* General Flags - Consume, Decode, min_fixed, max_fixed */
219 
220 	{ACPI_RSC_1BITFLAG, ACPI_RS_OFFSET(data.address.producer_consumer),
221 	 AML_OFFSET(address.flags),
222 	 0},
223 
224 	{ACPI_RSC_1BITFLAG, ACPI_RS_OFFSET(data.address.decode),
225 	 AML_OFFSET(address.flags),
226 	 1},
227 
228 	{ACPI_RSC_1BITFLAG, ACPI_RS_OFFSET(data.address.min_address_fixed),
229 	 AML_OFFSET(address.flags),
230 	 2},
231 
232 	{ACPI_RSC_1BITFLAG, ACPI_RS_OFFSET(data.address.max_address_fixed),
233 	 AML_OFFSET(address.flags),
234 	 3}
235 };
236 
237 /*******************************************************************************
238  *
239  * acpi_rs_convert_mem_flags - Flags common to Memory address descriptors
240  *
241  ******************************************************************************/
242 
243 static struct acpi_rsconvert_info acpi_rs_convert_mem_flags[5] = {
244 	{ACPI_RSC_FLAGINIT, 0, AML_OFFSET(address.specific_flags),
245 	 ACPI_RSC_TABLE_SIZE(acpi_rs_convert_mem_flags)},
246 
247 	/* Memory-specific flags */
248 
249 	{ACPI_RSC_1BITFLAG, ACPI_RS_OFFSET(data.address.info.mem.write_protect),
250 	 AML_OFFSET(address.specific_flags),
251 	 0},
252 
253 	{ACPI_RSC_2BITFLAG, ACPI_RS_OFFSET(data.address.info.mem.caching),
254 	 AML_OFFSET(address.specific_flags),
255 	 1},
256 
257 	{ACPI_RSC_2BITFLAG, ACPI_RS_OFFSET(data.address.info.mem.range_type),
258 	 AML_OFFSET(address.specific_flags),
259 	 3},
260 
261 	{ACPI_RSC_1BITFLAG, ACPI_RS_OFFSET(data.address.info.mem.translation),
262 	 AML_OFFSET(address.specific_flags),
263 	 5}
264 };
265 
266 /*******************************************************************************
267  *
268  * acpi_rs_convert_io_flags - Flags common to I/O address descriptors
269  *
270  ******************************************************************************/
271 
272 static struct acpi_rsconvert_info acpi_rs_convert_io_flags[4] = {
273 	{ACPI_RSC_FLAGINIT, 0, AML_OFFSET(address.specific_flags),
274 	 ACPI_RSC_TABLE_SIZE(acpi_rs_convert_io_flags)},
275 
276 	/* I/O-specific flags */
277 
278 	{ACPI_RSC_2BITFLAG, ACPI_RS_OFFSET(data.address.info.io.range_type),
279 	 AML_OFFSET(address.specific_flags),
280 	 0},
281 
282 	{ACPI_RSC_1BITFLAG, ACPI_RS_OFFSET(data.address.info.io.translation),
283 	 AML_OFFSET(address.specific_flags),
284 	 4},
285 
286 	{ACPI_RSC_1BITFLAG,
287 	 ACPI_RS_OFFSET(data.address.info.io.translation_type),
288 	 AML_OFFSET(address.specific_flags),
289 	 5}
290 };
291 
292 /*******************************************************************************
293  *
294  * FUNCTION:    acpi_rs_get_address_common
295  *
296  * PARAMETERS:  Resource            - Pointer to the internal resource struct
297  *              Aml                 - Pointer to the AML resource descriptor
298  *
299  * RETURN:      TRUE if the resource_type field is OK, FALSE otherwise
300  *
301  * DESCRIPTION: Convert common flag fields from a raw AML resource descriptor
302  *              to an internal resource descriptor
303  *
304  ******************************************************************************/
305 
306 u8
307 acpi_rs_get_address_common(struct acpi_resource *resource,
308 			   union aml_resource *aml)
309 {
310 	ACPI_FUNCTION_ENTRY();
311 
312 	/* Validate the Resource Type */
313 
314 	if ((aml->address.resource_type > 2)
315 	    && (aml->address.resource_type < 0xC0)) {
316 		return (FALSE);
317 	}
318 
319 	/* Get the Resource Type and General Flags */
320 
321 	(void)acpi_rs_convert_aml_to_resource(resource, aml,
322 					      acpi_rs_convert_general_flags);
323 
324 	/* Get the Type-Specific Flags (Memory and I/O descriptors only) */
325 
326 	if (resource->data.address.resource_type == ACPI_MEMORY_RANGE) {
327 		(void)acpi_rs_convert_aml_to_resource(resource, aml,
328 						      acpi_rs_convert_mem_flags);
329 	} else if (resource->data.address.resource_type == ACPI_IO_RANGE) {
330 		(void)acpi_rs_convert_aml_to_resource(resource, aml,
331 						      acpi_rs_convert_io_flags);
332 	} else {
333 		/* Generic resource type, just grab the type_specific byte */
334 
335 		resource->data.address.info.type_specific =
336 		    aml->address.specific_flags;
337 	}
338 
339 	return (TRUE);
340 }
341 
342 /*******************************************************************************
343  *
344  * FUNCTION:    acpi_rs_set_address_common
345  *
346  * PARAMETERS:  Aml                 - Pointer to the AML resource descriptor
347  *              Resource            - Pointer to the internal resource struct
348  *
349  * RETURN:      None
350  *
351  * DESCRIPTION: Convert common flag fields from a resource descriptor to an
352  *              AML descriptor
353  *
354  ******************************************************************************/
355 
356 void
357 acpi_rs_set_address_common(union aml_resource *aml,
358 			   struct acpi_resource *resource)
359 {
360 	ACPI_FUNCTION_ENTRY();
361 
362 	/* Set the Resource Type and General Flags */
363 
364 	(void)acpi_rs_convert_resource_to_aml(resource, aml,
365 					      acpi_rs_convert_general_flags);
366 
367 	/* Set the Type-Specific Flags (Memory and I/O descriptors only) */
368 
369 	if (resource->data.address.resource_type == ACPI_MEMORY_RANGE) {
370 		(void)acpi_rs_convert_resource_to_aml(resource, aml,
371 						      acpi_rs_convert_mem_flags);
372 	} else if (resource->data.address.resource_type == ACPI_IO_RANGE) {
373 		(void)acpi_rs_convert_resource_to_aml(resource, aml,
374 						      acpi_rs_convert_io_flags);
375 	} else {
376 		/* Generic resource type, just copy the type_specific byte */
377 
378 		aml->address.specific_flags =
379 		    resource->data.address.info.type_specific;
380 	}
381 }
382