xref: /dflybsd-src/sys/dev/acpica/acpi_pcib.c (revision 9d1f0c52aa26c5bd75507a9e9829044549b681e5)
1*5db2f26eSSascha Wildner /*-
2*5db2f26eSSascha Wildner  * Copyright (c) 2000 Michael Smith
3*5db2f26eSSascha Wildner  * Copyright (c) 2000 BSDi
4*5db2f26eSSascha Wildner  * All rights reserved.
5*5db2f26eSSascha Wildner  *
6*5db2f26eSSascha Wildner  * Redistribution and use in source and binary forms, with or without
7*5db2f26eSSascha Wildner  * modification, are permitted provided that the following conditions
8*5db2f26eSSascha Wildner  * are met:
9*5db2f26eSSascha Wildner  * 1. Redistributions of source code must retain the above copyright
10*5db2f26eSSascha Wildner  *    notice, this list of conditions and the following disclaimer.
11*5db2f26eSSascha Wildner  * 2. Redistributions in binary form must reproduce the above copyright
12*5db2f26eSSascha Wildner  *    notice, this list of conditions and the following disclaimer in the
13*5db2f26eSSascha Wildner  *    documentation and/or other materials provided with the distribution.
14*5db2f26eSSascha Wildner  *
15*5db2f26eSSascha Wildner  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16*5db2f26eSSascha Wildner  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17*5db2f26eSSascha Wildner  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18*5db2f26eSSascha Wildner  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19*5db2f26eSSascha Wildner  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20*5db2f26eSSascha Wildner  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21*5db2f26eSSascha Wildner  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22*5db2f26eSSascha Wildner  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23*5db2f26eSSascha Wildner  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24*5db2f26eSSascha Wildner  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25*5db2f26eSSascha Wildner  * SUCH DAMAGE.
26*5db2f26eSSascha Wildner  *
27*5db2f26eSSascha Wildner  * $FreeBSD: src/sys/dev/acpica/acpi_pcib.c,v 1.60.8.1 2009/04/15 03:14:26 kensmith Exp $
28*5db2f26eSSascha Wildner  */
29*5db2f26eSSascha Wildner 
30*5db2f26eSSascha Wildner #include "opt_acpi.h"
31*5db2f26eSSascha Wildner #include <sys/param.h>
32*5db2f26eSSascha Wildner #include <sys/bus.h>
33*5db2f26eSSascha Wildner #include <sys/malloc.h>
34*5db2f26eSSascha Wildner #include <sys/kernel.h>
35*5db2f26eSSascha Wildner #include <sys/machintr.h>
36*5db2f26eSSascha Wildner #include <machine/smp.h>
37*5db2f26eSSascha Wildner 
38*5db2f26eSSascha Wildner #include "acpi.h"
39*5db2f26eSSascha Wildner #include <dev/acpica/acpivar.h>
40*5db2f26eSSascha Wildner #include <dev/acpica/acpi_pcibvar.h>
41*5db2f26eSSascha Wildner 
42*5db2f26eSSascha Wildner #include <bus/pci/pcivar.h>
43*5db2f26eSSascha Wildner #include <bus/pci/pcireg.h>
44*5db2f26eSSascha Wildner #include <bus/pci/pci_cfgreg.h>
45*5db2f26eSSascha Wildner #include "pcib_if.h"
46*5db2f26eSSascha Wildner 
47*5db2f26eSSascha Wildner /* Hooks for the ACPICA debugging infrastructure. */
48*5db2f26eSSascha Wildner #define _COMPONENT	ACPI_BUS
49*5db2f26eSSascha Wildner ACPI_MODULE_NAME("PCI")
50*5db2f26eSSascha Wildner 
51*5db2f26eSSascha Wildner ACPI_SERIAL_DECL(pcib, "ACPI PCI bus methods");
52*5db2f26eSSascha Wildner 
53*5db2f26eSSascha Wildner /*
54*5db2f26eSSascha Wildner  * For locking, we assume the caller is not concurrent since this is
55*5db2f26eSSascha Wildner  * triggered by newbus methods.
56*5db2f26eSSascha Wildner  */
57*5db2f26eSSascha Wildner 
58*5db2f26eSSascha Wildner struct prt_lookup_request {
59*5db2f26eSSascha Wildner     ACPI_PCI_ROUTING_TABLE *pr_entry;
60*5db2f26eSSascha Wildner     u_int	pr_pin;
61*5db2f26eSSascha Wildner     u_int	pr_slot;
62*5db2f26eSSascha Wildner };
63*5db2f26eSSascha Wildner 
64*5db2f26eSSascha Wildner typedef	void prt_entry_handler(ACPI_PCI_ROUTING_TABLE *entry, void *arg);
65*5db2f26eSSascha Wildner 
66*5db2f26eSSascha Wildner static void	prt_attach_devices(ACPI_PCI_ROUTING_TABLE *entry, void *arg);
67*5db2f26eSSascha Wildner static void	prt_lookup_device(ACPI_PCI_ROUTING_TABLE *entry, void *arg);
68*5db2f26eSSascha Wildner static void	prt_walk_table(ACPI_BUFFER *prt, prt_entry_handler *handler,
69*5db2f26eSSascha Wildner 		    void *arg);
70*5db2f26eSSascha Wildner 
71*5db2f26eSSascha Wildner static void
prt_walk_table(ACPI_BUFFER * prt,prt_entry_handler * handler,void * arg)72*5db2f26eSSascha Wildner prt_walk_table(ACPI_BUFFER *prt, prt_entry_handler *handler, void *arg)
73*5db2f26eSSascha Wildner {
74*5db2f26eSSascha Wildner     ACPI_PCI_ROUTING_TABLE *entry;
75*5db2f26eSSascha Wildner     char *prtptr;
76*5db2f26eSSascha Wildner 
77*5db2f26eSSascha Wildner     /* First check to see if there is a table to walk. */
78*5db2f26eSSascha Wildner     if (prt == NULL || prt->Pointer == NULL)
79*5db2f26eSSascha Wildner 	return;
80*5db2f26eSSascha Wildner 
81*5db2f26eSSascha Wildner     /* Walk the table executing the handler function for each entry. */
82*5db2f26eSSascha Wildner     prtptr = prt->Pointer;
83*5db2f26eSSascha Wildner     entry = (ACPI_PCI_ROUTING_TABLE *)prtptr;
84*5db2f26eSSascha Wildner     while (entry->Length != 0) {
85*5db2f26eSSascha Wildner 	handler(entry, arg);
86*5db2f26eSSascha Wildner 	prtptr += entry->Length;
87*5db2f26eSSascha Wildner 	entry = (ACPI_PCI_ROUTING_TABLE *)prtptr;
88*5db2f26eSSascha Wildner     }
89*5db2f26eSSascha Wildner }
90*5db2f26eSSascha Wildner 
91*5db2f26eSSascha Wildner static void
prt_attach_devices(ACPI_PCI_ROUTING_TABLE * entry,void * arg)92*5db2f26eSSascha Wildner prt_attach_devices(ACPI_PCI_ROUTING_TABLE *entry, void *arg)
93*5db2f26eSSascha Wildner {
94*5db2f26eSSascha Wildner     ACPI_HANDLE handle;
95*5db2f26eSSascha Wildner     device_t child, pcib;
96*5db2f26eSSascha Wildner     int error;
97*5db2f26eSSascha Wildner 
98*5db2f26eSSascha Wildner     /* We only care about entries that reference a link device. */
99*5db2f26eSSascha Wildner     if (entry->Source == NULL || entry->Source[0] == '\0')
100*5db2f26eSSascha Wildner 	return;
101*5db2f26eSSascha Wildner 
102*5db2f26eSSascha Wildner     /*
103*5db2f26eSSascha Wildner      * In practice, we only see SourceIndex's of 0 out in the wild.
104*5db2f26eSSascha Wildner      * When indices != 0 have been found, they've been bugs in the ASL.
105*5db2f26eSSascha Wildner      */
106*5db2f26eSSascha Wildner     if (entry->SourceIndex != 0)
107*5db2f26eSSascha Wildner 	return;
108*5db2f26eSSascha Wildner 
109*5db2f26eSSascha Wildner     /* Lookup the associated handle and device. */
110*5db2f26eSSascha Wildner     pcib = (device_t)arg;
111*5db2f26eSSascha Wildner     if (ACPI_FAILURE(AcpiGetHandle(ACPI_ROOT_OBJECT, entry->Source, &handle)))
112*5db2f26eSSascha Wildner 	return;
113*5db2f26eSSascha Wildner     child = acpi_get_device(handle);
114*5db2f26eSSascha Wildner     if (child == NULL)
115*5db2f26eSSascha Wildner 	return;
116*5db2f26eSSascha Wildner 
117*5db2f26eSSascha Wildner     /* If the device hasn't been probed yet, force it to do so. */
118*5db2f26eSSascha Wildner     error = device_probe_and_attach(child);
119*5db2f26eSSascha Wildner     if (error != 0) {
120*5db2f26eSSascha Wildner 	device_printf(pcib, "failed to force attach of %s\n",
121*5db2f26eSSascha Wildner 	    acpi_name(handle));
122*5db2f26eSSascha Wildner 	return;
123*5db2f26eSSascha Wildner     }
124*5db2f26eSSascha Wildner 
125*5db2f26eSSascha Wildner     /* Add a reference for a specific bus/device/pin tuple. */
126*5db2f26eSSascha Wildner     acpi_pci_link_add_reference(child, entry->SourceIndex, pcib,
127*5db2f26eSSascha Wildner 	ACPI_ADR_PCI_SLOT(entry->Address), entry->Pin);
128*5db2f26eSSascha Wildner }
129*5db2f26eSSascha Wildner 
130*5db2f26eSSascha Wildner int
acpi_pcib_attach(device_t dev,ACPI_BUFFER * prt,int busno)131*5db2f26eSSascha Wildner acpi_pcib_attach(device_t dev, ACPI_BUFFER *prt, int busno)
132*5db2f26eSSascha Wildner {
133*5db2f26eSSascha Wildner     device_t			child;
134*5db2f26eSSascha Wildner     ACPI_STATUS			status;
135*5db2f26eSSascha Wildner 
136*5db2f26eSSascha Wildner     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
137*5db2f26eSSascha Wildner 
138*5db2f26eSSascha Wildner     if (!acpi_DeviceIsPresent(dev)) {
139*5db2f26eSSascha Wildner     	/* Caller should already have checked it */
140*5db2f26eSSascha Wildner 	panic("%s device is not present", __func__);
141*5db2f26eSSascha Wildner     }
142*5db2f26eSSascha Wildner 
143*5db2f26eSSascha Wildner     ACPI_SERIAL_INIT(pcib);
144*5db2f26eSSascha Wildner 
145*5db2f26eSSascha Wildner     /*
146*5db2f26eSSascha Wildner      * Get the PCI interrupt routing table for this bus.  If we can't
147*5db2f26eSSascha Wildner      * get it, this is not an error but may reduce functionality.  There
148*5db2f26eSSascha Wildner      * are several valid bridges in the field that do not have a _PRT, so
149*5db2f26eSSascha Wildner      * only warn about missing tables if bootverbose is set.
150*5db2f26eSSascha Wildner      */
151*5db2f26eSSascha Wildner     prt->Length = ACPI_ALLOCATE_BUFFER;
152*5db2f26eSSascha Wildner     status = AcpiGetIrqRoutingTable(acpi_get_handle(dev), prt);
153*5db2f26eSSascha Wildner     if (ACPI_FAILURE(status) && (bootverbose || status != AE_NOT_FOUND))
154*5db2f26eSSascha Wildner 	device_printf(dev,
155*5db2f26eSSascha Wildner 	    "could not get PCI interrupt routing table for %s - %s\n",
156*5db2f26eSSascha Wildner 	    acpi_name(acpi_get_handle(dev)), AcpiFormatException(status));
157*5db2f26eSSascha Wildner 
158*5db2f26eSSascha Wildner     /*
159*5db2f26eSSascha Wildner      * Attach the PCI bus proper.
160*5db2f26eSSascha Wildner      */
161*5db2f26eSSascha Wildner     if ((child = device_add_child(dev, "pci", busno)) == NULL) {
162*5db2f26eSSascha Wildner 	device_printf(device_get_parent(dev), "couldn't attach pci bus\n");
163*5db2f26eSSascha Wildner 	return_VALUE(ENXIO);
164*5db2f26eSSascha Wildner     }
165*5db2f26eSSascha Wildner 
166*5db2f26eSSascha Wildner     /*
167*5db2f26eSSascha Wildner      * Now go scan the bus.
168*5db2f26eSSascha Wildner      */
169*5db2f26eSSascha Wildner     prt_walk_table(prt, prt_attach_devices, dev);
170*5db2f26eSSascha Wildner 
171*5db2f26eSSascha Wildner     return_VALUE (bus_generic_attach(dev));
172*5db2f26eSSascha Wildner }
173*5db2f26eSSascha Wildner 
174*5db2f26eSSascha Wildner int
acpi_pcib_resume(device_t dev)175*5db2f26eSSascha Wildner acpi_pcib_resume(device_t dev)
176*5db2f26eSSascha Wildner {
177*5db2f26eSSascha Wildner 
178*5db2f26eSSascha Wildner     return (bus_generic_resume(dev));
179*5db2f26eSSascha Wildner }
180*5db2f26eSSascha Wildner 
181*5db2f26eSSascha Wildner static void
prt_lookup_device(ACPI_PCI_ROUTING_TABLE * entry,void * arg)182*5db2f26eSSascha Wildner prt_lookup_device(ACPI_PCI_ROUTING_TABLE *entry, void *arg)
183*5db2f26eSSascha Wildner {
184*5db2f26eSSascha Wildner     struct prt_lookup_request *pr;
185*5db2f26eSSascha Wildner 
186*5db2f26eSSascha Wildner     pr = (struct prt_lookup_request *)arg;
187*5db2f26eSSascha Wildner     if (pr->pr_entry != NULL)
188*5db2f26eSSascha Wildner 	return;
189*5db2f26eSSascha Wildner 
190*5db2f26eSSascha Wildner     /*
191*5db2f26eSSascha Wildner      * Compare the slot number (high word of Address) and pin number
192*5db2f26eSSascha Wildner      * (note that ACPI uses 0 for INTA) to check for a match.
193*5db2f26eSSascha Wildner      *
194*5db2f26eSSascha Wildner      * Note that the low word of the Address field (function number)
195*5db2f26eSSascha Wildner      * is required by the specification to be 0xffff.  We don't risk
196*5db2f26eSSascha Wildner      * checking it here.
197*5db2f26eSSascha Wildner      */
198*5db2f26eSSascha Wildner     if (ACPI_ADR_PCI_SLOT(entry->Address) == pr->pr_slot &&
199*5db2f26eSSascha Wildner 	entry->Pin == pr->pr_pin)
200*5db2f26eSSascha Wildner 	    pr->pr_entry = entry;
201*5db2f26eSSascha Wildner }
202*5db2f26eSSascha Wildner 
203*5db2f26eSSascha Wildner /*
204*5db2f26eSSascha Wildner  * Route an interrupt for a child of the bridge.
205*5db2f26eSSascha Wildner  */
206*5db2f26eSSascha Wildner int
acpi_pcib_route_interrupt(device_t pcib,device_t dev,int pin,ACPI_BUFFER * prtbuf)207*5db2f26eSSascha Wildner acpi_pcib_route_interrupt(device_t pcib, device_t dev, int pin,
208*5db2f26eSSascha Wildner     ACPI_BUFFER *prtbuf)
209*5db2f26eSSascha Wildner {
210*5db2f26eSSascha Wildner     ACPI_PCI_ROUTING_TABLE *prt;
211*5db2f26eSSascha Wildner     struct prt_lookup_request pr;
212*5db2f26eSSascha Wildner     ACPI_HANDLE lnkdev;
213*5db2f26eSSascha Wildner     int interrupt;
214*5db2f26eSSascha Wildner 
215*5db2f26eSSascha Wildner     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
216*5db2f26eSSascha Wildner 
217*5db2f26eSSascha Wildner     interrupt = PCI_INVALID_IRQ;
218*5db2f26eSSascha Wildner 
219*5db2f26eSSascha Wildner     /* ACPI numbers pins 0-3, not 1-4 like the BIOS. */
220*5db2f26eSSascha Wildner     pin--;
221*5db2f26eSSascha Wildner 
222*5db2f26eSSascha Wildner     ACPI_SERIAL_BEGIN(pcib);
223*5db2f26eSSascha Wildner 
224*5db2f26eSSascha Wildner     /* Search for a matching entry in the routing table. */
225*5db2f26eSSascha Wildner     pr.pr_entry = NULL;
226*5db2f26eSSascha Wildner     pr.pr_pin = pin;
227*5db2f26eSSascha Wildner     pr.pr_slot = pci_get_slot(dev);
228*5db2f26eSSascha Wildner     prt_walk_table(prtbuf, prt_lookup_device, &pr);
229*5db2f26eSSascha Wildner     if (pr.pr_entry == NULL) {
230*5db2f26eSSascha Wildner 	device_printf(pcib, "no PRT entry for %d.%d.INT%c\n", pci_get_bus(dev),
231*5db2f26eSSascha Wildner 	    pci_get_slot(dev), 'A' + pin);
232*5db2f26eSSascha Wildner 	goto out;
233*5db2f26eSSascha Wildner     }
234*5db2f26eSSascha Wildner     prt = pr.pr_entry;
235*5db2f26eSSascha Wildner 
236*5db2f26eSSascha Wildner     if (bootverbose) {
237*5db2f26eSSascha Wildner 	device_printf(pcib, "matched entry for %d.%d.INT%c",
238*5db2f26eSSascha Wildner 	    pci_get_bus(dev), pci_get_slot(dev), 'A' + pin);
239*5db2f26eSSascha Wildner 	if (prt->Source != NULL && prt->Source[0] != '\0')
240*5db2f26eSSascha Wildner 		kprintf(" (src %s:%u)", prt->Source, prt->SourceIndex);
241*5db2f26eSSascha Wildner 	kprintf("\n");
242*5db2f26eSSascha Wildner     }
243*5db2f26eSSascha Wildner 
244*5db2f26eSSascha Wildner     /*
245*5db2f26eSSascha Wildner      * If source is empty/NULL, the source index is a GSI and it's hardwired
246*5db2f26eSSascha Wildner      * so we're done.
247*5db2f26eSSascha Wildner      *
248*5db2f26eSSascha Wildner      * XXX: If the source index is non-zero, ignore the source device and
249*5db2f26eSSascha Wildner      * assume that this is a hardwired entry.
250*5db2f26eSSascha Wildner      */
251*5db2f26eSSascha Wildner     if (prt->Source == NULL || prt->Source[0] == '\0' ||
252*5db2f26eSSascha Wildner 	prt->SourceIndex != 0) {
253*5db2f26eSSascha Wildner 	if (prt->SourceIndex) {
254*5db2f26eSSascha Wildner 	    interrupt = machintr_legacy_intr_find_bygsi(prt->SourceIndex,
255*5db2f26eSSascha Wildner 	        INTR_TRIGGER_LEVEL, INTR_POLARITY_LOW);
256*5db2f26eSSascha Wildner 	    if (interrupt < 0) {
257*5db2f26eSSascha Wildner 		device_printf(pcib, "slot %d INT%c hardwired to "
258*5db2f26eSSascha Wildner 		    "invalid GSI %d\n", pci_get_slot(dev), 'A' + pin,
259*5db2f26eSSascha Wildner 		    prt->SourceIndex);
260*5db2f26eSSascha Wildner 		interrupt = PCI_INVALID_IRQ;
261*5db2f26eSSascha Wildner 		goto out;
262*5db2f26eSSascha Wildner 	    }
263*5db2f26eSSascha Wildner 	    if (bootverbose) {
264*5db2f26eSSascha Wildner 		device_printf(pcib, "slot %d INT%c hardwired to "
265*5db2f26eSSascha Wildner 		    "GSI %d, IRQ %d\n", pci_get_slot(dev), 'A' + pin,
266*5db2f26eSSascha Wildner 		    prt->SourceIndex, interrupt);
267*5db2f26eSSascha Wildner 	    }
268*5db2f26eSSascha Wildner 
269*5db2f26eSSascha Wildner 	    BUS_CONFIG_INTR(device_get_parent(dev), dev, interrupt,
270*5db2f26eSSascha Wildner 		INTR_TRIGGER_LEVEL, INTR_POLARITY_LOW);
271*5db2f26eSSascha Wildner 	} else {
272*5db2f26eSSascha Wildner 	    device_printf(pcib, "invalid hardwired GSI 0\n");
273*5db2f26eSSascha Wildner 	}
274*5db2f26eSSascha Wildner 	goto out;
275*5db2f26eSSascha Wildner     }
276*5db2f26eSSascha Wildner 
277*5db2f26eSSascha Wildner     /*
278*5db2f26eSSascha Wildner      * We have to find the source device (PCI interrupt link device).
279*5db2f26eSSascha Wildner      */
280*5db2f26eSSascha Wildner     if (ACPI_FAILURE(AcpiGetHandle(ACPI_ROOT_OBJECT, prt->Source, &lnkdev))) {
281*5db2f26eSSascha Wildner 	device_printf(pcib, "couldn't find PCI interrupt link device %s\n",
282*5db2f26eSSascha Wildner 	    prt->Source);
283*5db2f26eSSascha Wildner 	goto out;
284*5db2f26eSSascha Wildner     }
285*5db2f26eSSascha Wildner     interrupt = acpi_pci_link_route_interrupt(acpi_get_device(lnkdev),
286*5db2f26eSSascha Wildner 	prt->SourceIndex);
287*5db2f26eSSascha Wildner 
288*5db2f26eSSascha Wildner     if (bootverbose && PCI_INTERRUPT_VALID(interrupt)) {
289*5db2f26eSSascha Wildner 	device_printf(pcib, "slot %d INT%c routed to irq %d via %s\n",
290*5db2f26eSSascha Wildner 	    pci_get_slot(dev), 'A' + pin, interrupt, acpi_name(lnkdev));
291*5db2f26eSSascha Wildner     }
292*5db2f26eSSascha Wildner 
293*5db2f26eSSascha Wildner out:
294*5db2f26eSSascha Wildner     ACPI_SERIAL_END(pcib);
295*5db2f26eSSascha Wildner 
296*5db2f26eSSascha Wildner     return_VALUE (interrupt);
297*5db2f26eSSascha Wildner }
298*5db2f26eSSascha Wildner 
299*5db2f26eSSascha Wildner int
acpi_pcib_probe(device_t dev)300*5db2f26eSSascha Wildner acpi_pcib_probe(device_t dev)
301*5db2f26eSSascha Wildner {
302*5db2f26eSSascha Wildner     /*
303*5db2f26eSSascha Wildner      * Don't attach if we're not really there.
304*5db2f26eSSascha Wildner      *
305*5db2f26eSSascha Wildner      * XXX: This isn't entirely correct since we may be a PCI bus
306*5db2f26eSSascha Wildner      * on a hot-plug docking station, etc.
307*5db2f26eSSascha Wildner      */
308*5db2f26eSSascha Wildner     if (!acpi_DeviceIsPresent(dev))
309*5db2f26eSSascha Wildner 	return ENXIO;
310*5db2f26eSSascha Wildner 
311*5db2f26eSSascha Wildner     if (pci_cfgregopen() == 0)
312*5db2f26eSSascha Wildner 	return ENXIO;
313*5db2f26eSSascha Wildner 
314*5db2f26eSSascha Wildner     return 0;
315*5db2f26eSSascha Wildner }
316