1 /*
   2  * CDDL HEADER START
   3  *
   4  * The contents of this file are subject to the terms of the
   5  * Common Development and Distribution License (the "License").
   6  * You may not use this file except in compliance with the License.
   7  *
   8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   9  * or http://www.opensolaris.org/os/licensing.
  10  * See the License for the specific language governing permissions
  11  * and limitations under the License.
  12  *
  13  * When distributing Covered Code, include this CDDL HEADER in each
  14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15  * If applicable, add the following below this CDDL HEADER, with the
  16  * fields enclosed by brackets "[]" replaced with your own identifying
  17  * information: Portions Copyright [yyyy] [name of copyright owner]
  18  *
  19  * CDDL HEADER END
  20  */
  21 
  22 /*
  23  * Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
  24  * Use is subject to license terms.
  25  */
  26 /*
  27  * Copyright (c) 2009, Intel Corporation.
  28  * All rights reserved.
  29  */
  30 
  31 #ifndef _SYS_ACPIDEV_RSC_H
  32 #define _SYS_ACPIDEV_RSC_H
  33 #include <sys/types.h>
  34 #include <sys/obpdefs.h>
  35 #include <sys/sunddi.h>
  36 #include <acpica/include/acpi.h>
  37 #include <sys/acpica.h>
  38 
  39 #ifdef __cplusplus
  40 extern "C" {
  41 #endif
  42 
  43 /* ACPI bus range structure. */
  44 typedef struct acpidev_bus_range {
  45         uint_t  bus_start;
  46         uint_t  bus_end;
  47 } acpidev_bus_range_t;
  48 
  49 /*
  50  * This structure is modeled after the 1275 "reg" property and
  51  * "assigned-addresses" property for PCI device nodes.
  52  * There's no standard definition available for ACPI devices.
  53  * This structure is used to store resources returned by the ACPI
  54  * _CRS method.
  55  *
  56  * The physical address format is:
  57  *         Bit#:      33222222 22221111 11111100 00000000
  58  *                    10987654 32109876 54321098 76543210
  59  * phys_hi cell:      xxxxxxxx xxxxxxxx xxxxxxxx TSxxxTTT
  60  * phys_hi(memory):   xxxxxxxx xxxxxxxx wxxxxxcc --xxx000
  61  * phys_hi(io):       xxxxxxxx xxxxxxxx sdxxxxaa --xxx001
  62  * phys_mid cell:     hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh
  63  * phys_low cell:     llllllll llllllll llllllll llllllll
  64  *
  65  * TTT        is type of resource. Such as MEMORY, IO etc.
  66  * S          is 1 if address range is subtractive decoding
  67  * T          is 1 if resource type is different on primary and
  68  *            secondary bus
  69  * cc         is memory coherence type
  70  * w          is 1 if memory is writable
  71  * aa         ranges of decoded ports, ISA only, non-ISA only or full.
  72  * d          is 1 if IO port decode 16 bit address, otherwise 10 bits.
  73  * s          is 1 if translation is sparse.
  74  * hh...hhh   is the 32-bit unsigned number
  75  * ll...lll   is the 32-bit unsigned number
  76  *
  77  * The physical size format is:
  78  *
  79  * size_hi cell:  hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh
  80  * size_low cell: llllllll llllllll llllllll llllllll
  81  *
  82  * hh...hhh   is the 32-bit unsigned number
  83  * ll...lll   is the 32-bit unsigned number
  84  */
  85 typedef struct acpidev_phys_spec {
  86         uint_t  phys_hi;                /* resource address, hi word */
  87         uint_t  phys_mid;               /* resource address, middle word */
  88         uint_t  phys_low;               /* resource address, low word */
  89         uint_t  size_hi;                /* high word of size field */
  90         uint_t  size_low;               /* low word of size field */
  91 } acpidev_phys_spec_t;
  92 
  93 typedef struct acpidev_phys_spec        acpidev_regspec_t;
  94 
  95 #define ACPIDEV_REG_TYPE_M              0x00000007
  96 #define ACPIDEV_REG_TYPE_MEMORY         0x00000000
  97 #define ACPIDEV_REG_TYPE_IO             0x00000001
  98 #define ACPIDEV_REG_SUB_DEC             0x00000040
  99 #define ACPIDEV_REG_TRANSLATED          0x00000080
 100 
 101 #define ACPIDEV_REG_MEM_COHERENT_M      0x00000300
 102 #define ACPIDEV_REG_MEM_COHERENT_NC     0x00000000      /* Non-cachable */
 103 #define ACPIDEV_REG_MEM_COHERENT_CA     0x00000100      /* Cachable */
 104 #define ACPIDEV_REG_MEM_COHERENT_WC     0x00000200      /* Write-combining */
 105 #define ACPIDEV_REG_MEM_COHERENT_PF     0x00000300      /* Prefectable */
 106 #define ACPIDEV_REG_MEM_WRITABLE        0x00008000      /* Writable */
 107 
 108 #define ACPIDEV_REG_IO_RANGE_M          0x00000300
 109 #define ACPIDEV_REG_IO_RANGE_NONISA     0x00000100
 110 #define ACPIDEV_REG_IO_RANGE_ISA        0x00000200
 111 #define ACPIDEV_REG_IO_RANGE_FULL       0x00000300
 112 #define ACPIDEV_REG_IO_DECODE16         0x00004000      /* Decode 16bit addr. */
 113 #define ACPIDEV_REG_IO_SPARSE           0x00008000 /* Sparse translation. */
 114 
 115 typedef struct acpidev_ranges {
 116         uint_t  child_hi;               /* child's address, hi word */
 117         uint_t  child_mid;              /* child's address, middle word */
 118         uint_t  child_low;              /* child's address, low word */
 119         uint_t  parent_hi;              /* parent's address, hi word */
 120         uint_t  parent_mid;             /* parent's address, middle word */
 121         uint_t  parent_low;             /* parent's address, low word */
 122         uint_t  size_hi;                /* high word of size field */
 123         uint_t  size_low;               /* low word of size field */
 124 } acpidev_ranges_t;
 125 
 126 #ifdef  _KERNEL
 127 
 128 /* Maximum possible number of IRQs. */
 129 #define ACPIDEV_RES_IRQ_MAX             16
 130 /* Maximum possible number of DMAs. */
 131 #define ACPIDEV_RES_DMA_MAX             8
 132 
 133 /* Forward declaration */
 134 typedef struct acpidev_resource_handle  *acpidev_resource_handle_t;
 135 
 136 /*
 137  * Resource handler relative interfaces.
 138  * Return values of acpidev_resource_get_xxx interfaces:
 139  * AE_OK: succeed with resources stored in buffer and count updated.
 140  * AE_LIMIT: buffer is too small, count updated to number of resources.
 141  * AE_BAD_PARAMETER: invalid parameter
 142  */
 143 extern acpidev_resource_handle_t acpidev_resource_handle_alloc(
 144     boolean_t consumer);
 145 extern void acpidev_resource_handle_free(acpidev_resource_handle_t rhdl);
 146 
 147 extern ACPI_STATUS acpidev_resource_insert_reg(acpidev_resource_handle_t rhdl,
 148     acpidev_regspec_t *regp);
 149 extern ACPI_STATUS acpidev_resource_get_regs(acpidev_resource_handle_t rhdl,
 150     uint_t mask, uint_t value, acpidev_regspec_t *regp, uint_t *cntp);
 151 extern uint_t acpidev_resource_get_reg_count(acpidev_resource_handle_t rhdl,
 152     uint_t mask, uint_t value);
 153 
 154 extern ACPI_STATUS acpidev_resource_insert_range(acpidev_resource_handle_t rhdl,
 155     acpidev_ranges_t *rangep);
 156 extern ACPI_STATUS acpidev_resource_get_ranges(acpidev_resource_handle_t rhdl,
 157     uint_t mask, uint_t value, acpidev_ranges_t *rangep, uint_t *cntp);
 158 extern uint_t acpidev_resource_get_range_count(acpidev_resource_handle_t rhdl,
 159     uint_t mask, uint_t value);
 160 
 161 extern ACPI_STATUS acpidev_resource_insert_bus(acpidev_resource_handle_t rhdl,
 162     acpidev_bus_range_t *busp);
 163 extern ACPI_STATUS acpidev_resource_get_buses(acpidev_resource_handle_t rhdl,
 164     acpidev_bus_range_t *busp, uint_t *cntp);
 165 extern uint_t acpidev_resource_get_bus_count(acpidev_resource_handle_t rhdl);
 166 
 167 extern ACPI_STATUS acpidev_resource_insert_dma(acpidev_resource_handle_t rhdl,
 168     int dma);
 169 extern ACPI_STATUS acpidev_resource_get_dmas(acpidev_resource_handle_t rhdl,
 170     uint_t *dmap, uint_t *cntp);
 171 extern uint_t acpidev_resource_get_dma_count(acpidev_resource_handle_t rhdl);
 172 
 173 extern ACPI_STATUS acpidev_resource_insert_irq(acpidev_resource_handle_t rhdl,
 174     int irq);
 175 extern ACPI_STATUS acpidev_resource_get_irqs(acpidev_resource_handle_t rhdl,
 176     uint_t *irqp, uint_t *cntp);
 177 extern uint_t acpidev_resource_get_irq_count(acpidev_resource_handle_t rhdl);
 178 
 179 /*
 180  * Walk resources returned by 'method' and store parsed resources into rhdlp.
 181  * Caller needs to release rhdlp after using it.
 182  * Return AE_OK on success with resource handle stored in 'rhdlp'.
 183  */
 184 extern ACPI_STATUS acpidev_resource_walk(ACPI_HANDLE hdl, char *method,
 185     boolean_t consumer, acpidev_resource_handle_t *rhdlp);
 186 
 187 /*
 188  * Walk resources returned by the ACPI _CRS method and create device properties.
 189  * Create 'reg', 'assigned-addresses', 'dma-channels' and 'interrupts'
 190  * properties for resource consumer.
 191  * Create 'ranges' and 'bus-range' properties for resource producer.
 192  */
 193 extern ACPI_STATUS acpidev_resource_process(acpidev_walk_info_t *infop,
 194     boolean_t consumer);
 195 
 196 #endif  /* _KERNEL */
 197 
 198 #ifdef __cplusplus
 199 }
 200 #endif
 201 
 202 #endif  /* _SYS_ACPIDEV_RSC_H */