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 */
20int 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}
33EXPORT_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 */
39void 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
61char *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
78void 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
91char *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
104void 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