2 # Copyright (c) 2000 Doug Rabson
5 # Redistribution and use in source and binary forms, with or without
6 # modification, are permitted provided that the following conditions
8 # 1. Redistributions of source code must retain the above copyright
9 # notice, this list of conditions and the following disclaimer.
10 # 2. Redistributions in binary form must reproduce the above copyright
11 # notice, this list of conditions and the following disclaimer in the
12 # documentation and/or other materials provided with the distribution.
14 # THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 # ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 # ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 # FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 # DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 # OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 # HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 # LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 # OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31 #include <dev/pci/pcivar.h>
32 #include <dev/pci/pcib_private.h>
38 null_route_interrupt(device_t pcib, device_t dev, int pin)
40 return (PCI_INVALID_IRQ);
44 pcib_null_ari_enabled(device_t pcib)
52 # Return the number of slots on the attached PCI bus.
60 # Return the number of functions on the attached PCI bus.
64 } DEFAULT pcib_maxfuncs;
67 # Read configuration space on the PCI bus. The bus, slot and func
68 # arguments determine the device which is being read and the reg
69 # argument is a byte offset into configuration space for that
70 # device. The width argument (which should be 1, 2 or 4) specifies how
71 # many byte of configuration space to read from that offset.
73 METHOD u_int32_t read_config {
83 # Write configuration space on the PCI bus. The bus, slot and func
84 # arguments determine the device which is being written and the reg
85 # argument is a byte offset into configuration space for that
86 # device. The value field is written to the configuration space, with
87 # the number of bytes written depending on the width argument.
89 METHOD void write_config {
100 # Route an interrupt. Returns a value suitable for stuffing into
101 # a device's interrupt register.
103 METHOD int route_interrupt {
107 } DEFAULT null_route_interrupt;
110 # Allocate 'count' MSI messsages mapped onto 'count' IRQs. 'irq' points
111 # to an array of at least 'count' ints. The max number of messages this
112 # device supports is included so that the MD code can take that into
113 # account when assigning resources so that the proper number of low bits
114 # are clear in the resulting message data value.
116 METHOD int alloc_msi {
125 # Release 'count' MSI messages mapped onto 'count' IRQs stored in the
126 # array pointed to by 'irqs'.
128 METHOD int release_msi {
136 # Allocate a single MSI-X message mapped onto '*irq'.
138 METHOD int alloc_msix {
145 # Release a single MSI-X message mapped onto 'irq'.
147 METHOD int release_msix {
154 # Determine the MSI/MSI-X message address and data for 'irq'. The address
155 # is returned in '*addr', and the data in '*data'.
166 # Return the device power state to be used during a system sleep state
167 # transition such as suspend and resume.
169 METHOD int power_for_sleep {
176 # Return the PCI Routing Identifier (RID) for the device.
178 METHOD uint16_t get_rid {
181 } DEFAULT pcib_get_rid;
184 # Enable Alternative RID Interpretation if both the downstream port (pcib)
185 # and the endpoint device (dev) both support it.
187 METHOD int try_enable_ari {
193 # Return non-zero if PCI ARI is enabled, or zero otherwise
195 METHOD int ari_enabled {
197 } DEFAULT pcib_null_ari_enabled;
200 # Decode a PCI Routing Identifier (RID) into PCI bus/slot/function
202 METHOD void decode_rid {
208 } DEFAULT pcib_decode_rid;