blob: c42c152bbc33570fd8e69c82688090de4de737dc [file] [log] [blame]
b.liue9582032025-04-17 19:18:16 +08001// SPDX-License-Identifier: GPL-2.0
2/**
3 * ulpi.c - USB ULPI PHY bus
4 *
5 * Copyright (C) 2015 Intel Corporation
6 *
7 * Author: Heikki Krogerus <heikki.krogerus@linux.intel.com>
8 */
9
10#include <linux/ulpi/interface.h>
11#include <linux/ulpi/driver.h>
12#include <linux/ulpi/regs.h>
13#include <linux/module.h>
14#include <linux/slab.h>
15#include <linux/acpi.h>
16#include <linux/of.h>
17#include <linux/of_device.h>
18#include <linux/clk/clk-conf.h>
19
20/* -------------------------------------------------------------------------- */
21
22int ulpi_read(struct ulpi *ulpi, u8 addr)
23{
24 return ulpi->ops->read(ulpi->dev.parent, addr);
25}
26EXPORT_SYMBOL_GPL(ulpi_read);
27
28int ulpi_write(struct ulpi *ulpi, u8 addr, u8 val)
29{
30 return ulpi->ops->write(ulpi->dev.parent, addr, val);
31}
32EXPORT_SYMBOL_GPL(ulpi_write);
33
34/* -------------------------------------------------------------------------- */
35
36static int ulpi_match(struct device *dev, struct device_driver *driver)
37{
38 struct ulpi_driver *drv = to_ulpi_driver(driver);
39 struct ulpi *ulpi = to_ulpi_dev(dev);
40 const struct ulpi_device_id *id;
41
42 /*
43 * Some ULPI devices don't have a vendor id
44 * or provide an id_table so rely on OF match.
45 */
46 if (ulpi->id.vendor == 0 || !drv->id_table)
47 return of_driver_match_device(dev, driver);
48
49 for (id = drv->id_table; id->vendor; id++)
50 if (id->vendor == ulpi->id.vendor &&
51 id->product == ulpi->id.product)
52 return 1;
53
54 return 0;
55}
56
57static int ulpi_uevent(struct device *dev, struct kobj_uevent_env *env)
58{
59 struct ulpi *ulpi = to_ulpi_dev(dev);
60 int ret;
61
62 ret = of_device_uevent_modalias(dev, env);
63 if (ret != -ENODEV)
64 return ret;
65
66 if (add_uevent_var(env, "MODALIAS=ulpi:v%04xp%04x",
67 ulpi->id.vendor, ulpi->id.product))
68 return -ENOMEM;
69 return 0;
70}
71
72static int ulpi_probe(struct device *dev)
73{
74 struct ulpi_driver *drv = to_ulpi_driver(dev->driver);
75 int ret;
76
77 ret = of_clk_set_defaults(dev->of_node, false);
78 if (ret < 0)
79 return ret;
80
81 return drv->probe(to_ulpi_dev(dev));
82}
83
84static int ulpi_remove(struct device *dev)
85{
86 struct ulpi_driver *drv = to_ulpi_driver(dev->driver);
87
88 if (drv->remove)
89 drv->remove(to_ulpi_dev(dev));
90
91 return 0;
92}
93
94static struct bus_type ulpi_bus = {
95 .name = "ulpi",
96 .match = ulpi_match,
97 .uevent = ulpi_uevent,
98 .probe = ulpi_probe,
99 .remove = ulpi_remove,
100};
101
102/* -------------------------------------------------------------------------- */
103
104static ssize_t modalias_show(struct device *dev, struct device_attribute *attr,
105 char *buf)
106{
107 int len;
108 struct ulpi *ulpi = to_ulpi_dev(dev);
109
110 len = of_device_modalias(dev, buf, PAGE_SIZE);
111 if (len != -ENODEV)
112 return len;
113
114 return sprintf(buf, "ulpi:v%04xp%04x\n",
115 ulpi->id.vendor, ulpi->id.product);
116}
117static DEVICE_ATTR_RO(modalias);
118
119static struct attribute *ulpi_dev_attrs[] = {
120 &dev_attr_modalias.attr,
121 NULL
122};
123
124static struct attribute_group ulpi_dev_attr_group = {
125 .attrs = ulpi_dev_attrs,
126};
127
128static const struct attribute_group *ulpi_dev_attr_groups[] = {
129 &ulpi_dev_attr_group,
130 NULL
131};
132
133static void ulpi_dev_release(struct device *dev)
134{
135 of_node_put(dev->of_node);
136 kfree(to_ulpi_dev(dev));
137}
138
139static const struct device_type ulpi_dev_type = {
140 .name = "ulpi_device",
141 .groups = ulpi_dev_attr_groups,
142 .release = ulpi_dev_release,
143};
144
145/* -------------------------------------------------------------------------- */
146
147/**
148 * ulpi_register_driver - register a driver with the ULPI bus
149 * @drv: driver being registered
150 *
151 * Registers a driver with the ULPI bus.
152 */
153int __ulpi_register_driver(struct ulpi_driver *drv, struct module *module)
154{
155 if (!drv->probe)
156 return -EINVAL;
157
158 drv->driver.owner = module;
159 drv->driver.bus = &ulpi_bus;
160
161 return driver_register(&drv->driver);
162}
163EXPORT_SYMBOL_GPL(__ulpi_register_driver);
164
165/**
166 * ulpi_unregister_driver - unregister a driver with the ULPI bus
167 * @drv: driver to unregister
168 *
169 * Unregisters a driver with the ULPI bus.
170 */
171void ulpi_unregister_driver(struct ulpi_driver *drv)
172{
173 driver_unregister(&drv->driver);
174}
175EXPORT_SYMBOL_GPL(ulpi_unregister_driver);
176
177/* -------------------------------------------------------------------------- */
178
179static int ulpi_of_register(struct ulpi *ulpi)
180{
181 struct device_node *np = NULL, *child;
182 struct device *parent;
183
184 /* Find a ulpi bus underneath the parent or the grandparent */
185 parent = ulpi->dev.parent;
186 if (parent->of_node)
187 np = of_get_child_by_name(parent->of_node, "ulpi");
188 else if (parent->parent && parent->parent->of_node)
189 np = of_get_child_by_name(parent->parent->of_node, "ulpi");
190 if (!np)
191 return 0;
192
193 child = of_get_next_available_child(np, NULL);
194 of_node_put(np);
195 if (!child)
196 return -EINVAL;
197
198 ulpi->dev.of_node = child;
199
200 return 0;
201}
202
203static int ulpi_read_id(struct ulpi *ulpi)
204{
205 int ret;
206
207 /* Test the interface */
208 ret = ulpi_write(ulpi, ULPI_SCRATCH, 0xaa);
209 if (ret < 0)
210 goto err;
211
212 ret = ulpi_read(ulpi, ULPI_SCRATCH);
213 if (ret < 0)
214 return ret;
215
216 if (ret != 0xaa)
217 goto err;
218
219 ulpi->id.vendor = ulpi_read(ulpi, ULPI_VENDOR_ID_LOW);
220 ulpi->id.vendor |= ulpi_read(ulpi, ULPI_VENDOR_ID_HIGH) << 8;
221
222 ulpi->id.product = ulpi_read(ulpi, ULPI_PRODUCT_ID_LOW);
223 ulpi->id.product |= ulpi_read(ulpi, ULPI_PRODUCT_ID_HIGH) << 8;
224
225 /* Some ULPI devices don't have a vendor id so rely on OF match */
226 if (ulpi->id.vendor == 0)
227 goto err;
228
229 request_module("ulpi:v%04xp%04x", ulpi->id.vendor, ulpi->id.product);
230 return 0;
231err:
232 of_device_request_module(&ulpi->dev);
233 return 0;
234}
235
236static int ulpi_register(struct device *dev, struct ulpi *ulpi)
237{
238 int ret;
239
240 ulpi->dev.parent = dev; /* needed early for ops */
241 ulpi->dev.bus = &ulpi_bus;
242 ulpi->dev.type = &ulpi_dev_type;
243 dev_set_name(&ulpi->dev, "%s.ulpi", dev_name(dev));
244
245 ACPI_COMPANION_SET(&ulpi->dev, ACPI_COMPANION(dev));
246
247 ret = ulpi_of_register(ulpi);
248 if (ret)
249 return ret;
250
251 ret = ulpi_read_id(ulpi);
252 if (ret) {
253 of_node_put(ulpi->dev.of_node);
254 return ret;
255 }
256
257 ret = device_register(&ulpi->dev);
258 if (ret) {
259 put_device(&ulpi->dev);
260 return ret;
261 }
262
263 dev_dbg(&ulpi->dev, "registered ULPI PHY: vendor %04x, product %04x\n",
264 ulpi->id.vendor, ulpi->id.product);
265
266 return 0;
267}
268
269/**
270 * ulpi_register_interface - instantiate new ULPI device
271 * @dev: USB controller's device interface
272 * @ops: ULPI register access
273 *
274 * Allocates and registers a ULPI device and an interface for it. Called from
275 * the USB controller that provides the ULPI interface.
276 */
277struct ulpi *ulpi_register_interface(struct device *dev,
278 const struct ulpi_ops *ops)
279{
280 struct ulpi *ulpi;
281 int ret;
282
283 ulpi = kzalloc(sizeof(*ulpi), GFP_KERNEL);
284 if (!ulpi)
285 return ERR_PTR(-ENOMEM);
286
287 ulpi->ops = ops;
288
289 ret = ulpi_register(dev, ulpi);
290 if (ret) {
291 kfree(ulpi);
292 return ERR_PTR(ret);
293 }
294
295 return ulpi;
296}
297EXPORT_SYMBOL_GPL(ulpi_register_interface);
298
299/**
300 * ulpi_unregister_interface - unregister ULPI interface
301 * @intrf: struct ulpi_interface
302 *
303 * Unregisters a ULPI device and it's interface that was created with
304 * ulpi_create_interface().
305 */
306void ulpi_unregister_interface(struct ulpi *ulpi)
307{
308 device_unregister(&ulpi->dev);
309}
310EXPORT_SYMBOL_GPL(ulpi_unregister_interface);
311
312/* -------------------------------------------------------------------------- */
313
314static int __init ulpi_init(void)
315{
316 return bus_register(&ulpi_bus);
317}
318subsys_initcall(ulpi_init);
319
320static void __exit ulpi_exit(void)
321{
322 bus_unregister(&ulpi_bus);
323}
324module_exit(ulpi_exit);
325
326MODULE_AUTHOR("Intel Corporation");
327MODULE_LICENSE("GPL v2");
328MODULE_DESCRIPTION("USB ULPI PHY bus");