1 | // SPDX-License-Identifier: GPL-2.0 |
2 | /* |
3 | * support.c - standard functions for the use of pnp protocol drivers |
4 | * |
5 | * Copyright 2003 Adam Belay <ambx1@neo.rr.com> |
6 | * Copyright (C) 2008 Hewlett-Packard Development Company, L.P. |
7 | * Bjorn Helgaas <bjorn.helgaas@hp.com> |
8 | */ |
9 | |
10 | #include <linux/module.h> |
11 | #include <linux/ctype.h> |
12 | #include <linux/pnp.h> |
13 | #include "base.h" |
14 | |
15 | /** |
16 | * pnp_is_active - Determines if a device is active based on its current |
17 | * resources |
18 | * @dev: pointer to the desired PnP device |
19 | */ |
20 | int pnp_is_active(struct pnp_dev *dev) |
21 | { |
22 | /* |
23 | * I don't think this is very reliable because pnp_disable_dev() |
24 | * only clears out auto-assigned resources. |
25 | */ |
26 | if (!pnp_port_start(dev, bar: 0) && pnp_port_len(dev, bar: 0) <= 1 && |
27 | !pnp_mem_start(dev, bar: 0) && pnp_mem_len(dev, bar: 0) <= 1 && |
28 | pnp_irq(dev, bar: 0) == -1 && pnp_dma(dev, bar: 0) == -1) |
29 | return 0; |
30 | else |
31 | return 1; |
32 | } |
33 | EXPORT_SYMBOL(pnp_is_active); |
34 | |
35 | /* |
36 | * Functionally similar to acpi_ex_eisa_id_to_string(), but that's |
37 | * buried in the ACPI CA, and we can't depend on it being present. |
38 | */ |
39 | void pnp_eisa_id_to_string(u32 id, char *str) |
40 | { |
41 | id = be32_to_cpu(id); |
42 | |
43 | /* |
44 | * According to the specs, the first three characters are five-bit |
45 | * compressed ASCII, and the left-over high order bit should be zero. |
46 | * However, the Linux ISAPNP code historically used six bits for the |
47 | * first character, and there seem to be IDs that depend on that, |
48 | * e.g., "nEC8241" in the Linux 8250_pnp serial driver and the |
49 | * FreeBSD sys/pc98/cbus/sio_cbus.c driver. |
50 | */ |
51 | str[0] = 'A' + ((id >> 26) & 0x3f) - 1; |
52 | str[1] = 'A' + ((id >> 21) & 0x1f) - 1; |
53 | str[2] = 'A' + ((id >> 16) & 0x1f) - 1; |
54 | str[3] = hex_asc_hi(id >> 8); |
55 | str[4] = hex_asc_lo(id >> 8); |
56 | str[5] = hex_asc_hi(id); |
57 | str[6] = hex_asc_lo(id); |
58 | str[7] = '\0'; |
59 | } |
60 | |
61 | char *pnp_resource_type_name(struct resource *res) |
62 | { |
63 | switch (pnp_resource_type(res)) { |
64 | case IORESOURCE_IO: |
65 | return "io" ; |
66 | case IORESOURCE_MEM: |
67 | return "mem" ; |
68 | case IORESOURCE_IRQ: |
69 | return "irq" ; |
70 | case IORESOURCE_DMA: |
71 | return "dma" ; |
72 | case IORESOURCE_BUS: |
73 | return "bus" ; |
74 | } |
75 | return "unknown" ; |
76 | } |
77 | |
78 | void dbg_pnp_show_resources(struct pnp_dev *dev, char *desc) |
79 | { |
80 | struct pnp_resource *pnp_res; |
81 | |
82 | if (list_empty(head: &dev->resources)) |
83 | pnp_dbg(&dev->dev, "%s: no current resources\n" , desc); |
84 | else { |
85 | pnp_dbg(&dev->dev, "%s: current resources:\n" , desc); |
86 | list_for_each_entry(pnp_res, &dev->resources, list) |
87 | pnp_dbg(&dev->dev, "%pr\n" , &pnp_res->res); |
88 | } |
89 | } |
90 | |
91 | char *pnp_option_priority_name(struct pnp_option *option) |
92 | { |
93 | switch (pnp_option_priority(option)) { |
94 | case PNP_RES_PRIORITY_PREFERRED: |
95 | return "preferred" ; |
96 | case PNP_RES_PRIORITY_ACCEPTABLE: |
97 | return "acceptable" ; |
98 | case PNP_RES_PRIORITY_FUNCTIONAL: |
99 | return "functional" ; |
100 | } |
101 | return "invalid" ; |
102 | } |
103 | |
104 | void dbg_pnp_show_option(struct pnp_dev *dev, struct pnp_option *option) |
105 | { |
106 | char buf[128]; |
107 | int len = 0, i; |
108 | struct pnp_port *port; |
109 | struct pnp_mem *mem; |
110 | struct pnp_irq *irq; |
111 | struct pnp_dma *dma; |
112 | |
113 | if (pnp_option_is_dependent(option)) |
114 | len += scnprintf(buf: buf + len, size: sizeof(buf) - len, |
115 | fmt: " dependent set %d (%s) " , |
116 | pnp_option_set(option), |
117 | pnp_option_priority_name(option)); |
118 | else |
119 | len += scnprintf(buf: buf + len, size: sizeof(buf) - len, |
120 | fmt: " independent " ); |
121 | |
122 | switch (option->type) { |
123 | case IORESOURCE_IO: |
124 | port = &option->u.port; |
125 | len += scnprintf(buf: buf + len, size: sizeof(buf) - len, fmt: "io min %#llx " |
126 | "max %#llx align %lld size %lld flags %#x" , |
127 | (unsigned long long) port->min, |
128 | (unsigned long long) port->max, |
129 | (unsigned long long) port->align, |
130 | (unsigned long long) port->size, port->flags); |
131 | break; |
132 | case IORESOURCE_MEM: |
133 | mem = &option->u.mem; |
134 | len += scnprintf(buf: buf + len, size: sizeof(buf) - len, fmt: "mem min %#llx " |
135 | "max %#llx align %lld size %lld flags %#x" , |
136 | (unsigned long long) mem->min, |
137 | (unsigned long long) mem->max, |
138 | (unsigned long long) mem->align, |
139 | (unsigned long long) mem->size, mem->flags); |
140 | break; |
141 | case IORESOURCE_IRQ: |
142 | irq = &option->u.irq; |
143 | len += scnprintf(buf: buf + len, size: sizeof(buf) - len, fmt: "irq" ); |
144 | if (bitmap_empty(src: irq->map.bits, PNP_IRQ_NR)) |
145 | len += scnprintf(buf: buf + len, size: sizeof(buf) - len, |
146 | fmt: " <none>" ); |
147 | else { |
148 | for (i = 0; i < PNP_IRQ_NR; i++) |
149 | if (test_bit(i, irq->map.bits)) |
150 | len += scnprintf(buf: buf + len, |
151 | size: sizeof(buf) - len, |
152 | fmt: " %d" , i); |
153 | } |
154 | len += scnprintf(buf: buf + len, size: sizeof(buf) - len, fmt: " flags %#x" , |
155 | irq->flags); |
156 | if (irq->flags & IORESOURCE_IRQ_OPTIONAL) |
157 | len += scnprintf(buf: buf + len, size: sizeof(buf) - len, |
158 | fmt: " (optional)" ); |
159 | break; |
160 | case IORESOURCE_DMA: |
161 | dma = &option->u.dma; |
162 | len += scnprintf(buf: buf + len, size: sizeof(buf) - len, fmt: "dma" ); |
163 | if (!dma->map) |
164 | len += scnprintf(buf: buf + len, size: sizeof(buf) - len, |
165 | fmt: " <none>" ); |
166 | else { |
167 | for (i = 0; i < 8; i++) |
168 | if (dma->map & (1 << i)) |
169 | len += scnprintf(buf: buf + len, |
170 | size: sizeof(buf) - len, |
171 | fmt: " %d" , i); |
172 | } |
173 | len += scnprintf(buf: buf + len, size: sizeof(buf) - len, fmt: " (bitmask %#x) " |
174 | "flags %#x" , dma->map, dma->flags); |
175 | break; |
176 | } |
177 | pnp_dbg(&dev->dev, "%s\n" , buf); |
178 | } |
179 | |