Loading...
1// 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/debugfs.h>
17#include <linux/of.h>
18#include <linux/of_device.h>
19#include <linux/clk/clk-conf.h>
20
21/* -------------------------------------------------------------------------- */
22
23int ulpi_read(struct ulpi *ulpi, u8 addr)
24{
25 return ulpi->ops->read(ulpi->dev.parent, addr);
26}
27EXPORT_SYMBOL_GPL(ulpi_read);
28
29int ulpi_write(struct ulpi *ulpi, u8 addr, u8 val)
30{
31 return ulpi->ops->write(ulpi->dev.parent, addr, val);
32}
33EXPORT_SYMBOL_GPL(ulpi_write);
34
35/* -------------------------------------------------------------------------- */
36
37static int ulpi_match(struct device *dev, struct device_driver *driver)
38{
39 struct ulpi_driver *drv = to_ulpi_driver(driver);
40 struct ulpi *ulpi = to_ulpi_dev(dev);
41 const struct ulpi_device_id *id;
42
43 /*
44 * Some ULPI devices don't have a vendor id
45 * or provide an id_table so rely on OF match.
46 */
47 if (ulpi->id.vendor == 0 || !drv->id_table)
48 return of_driver_match_device(dev, driver);
49
50 for (id = drv->id_table; id->vendor; id++)
51 if (id->vendor == ulpi->id.vendor &&
52 id->product == ulpi->id.product)
53 return 1;
54
55 return 0;
56}
57
58static int ulpi_uevent(const struct device *dev, struct kobj_uevent_env *env)
59{
60 const struct ulpi *ulpi = to_ulpi_dev(dev);
61 int ret;
62
63 ret = of_device_uevent_modalias(dev, env);
64 if (ret != -ENODEV)
65 return ret;
66
67 if (add_uevent_var(env, "MODALIAS=ulpi:v%04xp%04x",
68 ulpi->id.vendor, ulpi->id.product))
69 return -ENOMEM;
70 return 0;
71}
72
73static int ulpi_probe(struct device *dev)
74{
75 struct ulpi_driver *drv = to_ulpi_driver(dev->driver);
76 int ret;
77
78 ret = of_clk_set_defaults(dev->of_node, false);
79 if (ret < 0)
80 return ret;
81
82 return drv->probe(to_ulpi_dev(dev));
83}
84
85static void ulpi_remove(struct device *dev)
86{
87 struct ulpi_driver *drv = to_ulpi_driver(dev->driver);
88
89 if (drv->remove)
90 drv->remove(to_ulpi_dev(dev));
91}
92
93static const struct bus_type ulpi_bus = {
94 .name = "ulpi",
95 .match = ulpi_match,
96 .uevent = ulpi_uevent,
97 .probe = ulpi_probe,
98 .remove = ulpi_remove,
99};
100
101/* -------------------------------------------------------------------------- */
102
103static ssize_t modalias_show(struct device *dev, struct device_attribute *attr,
104 char *buf)
105{
106 int len;
107 struct ulpi *ulpi = to_ulpi_dev(dev);
108
109 len = of_device_modalias(dev, buf, PAGE_SIZE);
110 if (len != -ENODEV)
111 return len;
112
113 return sprintf(buf, "ulpi:v%04xp%04x\n",
114 ulpi->id.vendor, ulpi->id.product);
115}
116static DEVICE_ATTR_RO(modalias);
117
118static struct attribute *ulpi_dev_attrs[] = {
119 &dev_attr_modalias.attr,
120 NULL
121};
122
123static const struct attribute_group ulpi_dev_attr_group = {
124 .attrs = ulpi_dev_attrs,
125};
126
127static const struct attribute_group *ulpi_dev_attr_groups[] = {
128 &ulpi_dev_attr_group,
129 NULL
130};
131
132static void ulpi_dev_release(struct device *dev)
133{
134 of_node_put(dev->of_node);
135 kfree(to_ulpi_dev(dev));
136}
137
138static const struct device_type ulpi_dev_type = {
139 .name = "ulpi_device",
140 .groups = ulpi_dev_attr_groups,
141 .release = ulpi_dev_release,
142};
143
144/* -------------------------------------------------------------------------- */
145
146/**
147 * __ulpi_register_driver - register a driver with the ULPI bus
148 * @drv: driver being registered
149 * @module: ends up being THIS_MODULE
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_request_module(ulpi->dev.of_node);
233 return 0;
234}
235
236static int ulpi_regs_show(struct seq_file *seq, void *data)
237{
238 struct ulpi *ulpi = seq->private;
239
240#define ulpi_print(name, reg) do { \
241 int ret = ulpi_read(ulpi, reg); \
242 if (ret < 0) \
243 return ret; \
244 seq_printf(seq, name " %.02x\n", ret); \
245} while (0)
246
247 ulpi_print("Vendor ID Low ", ULPI_VENDOR_ID_LOW);
248 ulpi_print("Vendor ID High ", ULPI_VENDOR_ID_HIGH);
249 ulpi_print("Product ID Low ", ULPI_PRODUCT_ID_LOW);
250 ulpi_print("Product ID High ", ULPI_PRODUCT_ID_HIGH);
251 ulpi_print("Function Control ", ULPI_FUNC_CTRL);
252 ulpi_print("Interface Control ", ULPI_IFC_CTRL);
253 ulpi_print("OTG Control ", ULPI_OTG_CTRL);
254 ulpi_print("USB Interrupt Enable Rising ", ULPI_USB_INT_EN_RISE);
255 ulpi_print("USB Interrupt Enable Falling", ULPI_USB_INT_EN_FALL);
256 ulpi_print("USB Interrupt Status ", ULPI_USB_INT_STS);
257 ulpi_print("USB Interrupt Latch ", ULPI_USB_INT_LATCH);
258 ulpi_print("Debug ", ULPI_DEBUG);
259 ulpi_print("Scratch Register ", ULPI_SCRATCH);
260 ulpi_print("Carkit Control ", ULPI_CARKIT_CTRL);
261 ulpi_print("Carkit Interrupt Delay ", ULPI_CARKIT_INT_DELAY);
262 ulpi_print("Carkit Interrupt Enable ", ULPI_CARKIT_INT_EN);
263 ulpi_print("Carkit Interrupt Status ", ULPI_CARKIT_INT_STS);
264 ulpi_print("Carkit Interrupt Latch ", ULPI_CARKIT_INT_LATCH);
265 ulpi_print("Carkit Pulse Control ", ULPI_CARKIT_PLS_CTRL);
266 ulpi_print("Transmit Positive Width ", ULPI_TX_POS_WIDTH);
267 ulpi_print("Transmit Negative Width ", ULPI_TX_NEG_WIDTH);
268 ulpi_print("Receive Polarity Recovery ", ULPI_POLARITY_RECOVERY);
269
270 return 0;
271}
272DEFINE_SHOW_ATTRIBUTE(ulpi_regs);
273
274static struct dentry *ulpi_root;
275
276static int ulpi_register(struct device *dev, struct ulpi *ulpi)
277{
278 int ret;
279 struct dentry *root;
280
281 ulpi->dev.parent = dev; /* needed early for ops */
282 ulpi->dev.bus = &ulpi_bus;
283 ulpi->dev.type = &ulpi_dev_type;
284 dev_set_name(&ulpi->dev, "%s.ulpi", dev_name(dev));
285
286 ACPI_COMPANION_SET(&ulpi->dev, ACPI_COMPANION(dev));
287
288 ret = ulpi_of_register(ulpi);
289 if (ret)
290 return ret;
291
292 ret = ulpi_read_id(ulpi);
293 if (ret) {
294 of_node_put(ulpi->dev.of_node);
295 return ret;
296 }
297
298 ret = device_register(&ulpi->dev);
299 if (ret) {
300 put_device(&ulpi->dev);
301 return ret;
302 }
303
304 root = debugfs_create_dir(dev_name(&ulpi->dev), ulpi_root);
305 debugfs_create_file("regs", 0444, root, ulpi, &ulpi_regs_fops);
306
307 dev_dbg(&ulpi->dev, "registered ULPI PHY: vendor %04x, product %04x\n",
308 ulpi->id.vendor, ulpi->id.product);
309
310 return 0;
311}
312
313/**
314 * ulpi_register_interface - instantiate new ULPI device
315 * @dev: USB controller's device interface
316 * @ops: ULPI register access
317 *
318 * Allocates and registers a ULPI device and an interface for it. Called from
319 * the USB controller that provides the ULPI interface.
320 */
321struct ulpi *ulpi_register_interface(struct device *dev,
322 const struct ulpi_ops *ops)
323{
324 struct ulpi *ulpi;
325 int ret;
326
327 ulpi = kzalloc(sizeof(*ulpi), GFP_KERNEL);
328 if (!ulpi)
329 return ERR_PTR(-ENOMEM);
330
331 ulpi->ops = ops;
332
333 ret = ulpi_register(dev, ulpi);
334 if (ret) {
335 kfree(ulpi);
336 return ERR_PTR(ret);
337 }
338
339 return ulpi;
340}
341EXPORT_SYMBOL_GPL(ulpi_register_interface);
342
343/**
344 * ulpi_unregister_interface - unregister ULPI interface
345 * @ulpi: struct ulpi_interface
346 *
347 * Unregisters a ULPI device and it's interface that was created with
348 * ulpi_create_interface().
349 */
350void ulpi_unregister_interface(struct ulpi *ulpi)
351{
352 debugfs_lookup_and_remove(dev_name(&ulpi->dev), ulpi_root);
353 device_unregister(&ulpi->dev);
354}
355EXPORT_SYMBOL_GPL(ulpi_unregister_interface);
356
357/* -------------------------------------------------------------------------- */
358
359static int __init ulpi_init(void)
360{
361 int ret;
362
363 ulpi_root = debugfs_create_dir(KBUILD_MODNAME, NULL);
364 ret = bus_register(&ulpi_bus);
365 if (ret)
366 debugfs_remove(ulpi_root);
367 return ret;
368}
369subsys_initcall(ulpi_init);
370
371static void __exit ulpi_exit(void)
372{
373 bus_unregister(&ulpi_bus);
374 debugfs_remove(ulpi_root);
375}
376module_exit(ulpi_exit);
377
378MODULE_AUTHOR("Intel Corporation");
379MODULE_LICENSE("GPL v2");
380MODULE_DESCRIPTION("USB ULPI PHY bus");
1/**
2 * ulpi.c - USB ULPI PHY bus
3 *
4 * Copyright (C) 2015 Intel Corporation
5 *
6 * Author: Heikki Krogerus <heikki.krogerus@linux.intel.com>
7 *
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 as
10 * published by the Free Software Foundation.
11 */
12
13#include <linux/ulpi/interface.h>
14#include <linux/ulpi/driver.h>
15#include <linux/ulpi/regs.h>
16#include <linux/module.h>
17#include <linux/slab.h>
18#include <linux/acpi.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 for (id = drv->id_table; id->vendor; id++)
43 if (id->vendor == ulpi->id.vendor &&
44 id->product == ulpi->id.product)
45 return 1;
46
47 return 0;
48}
49
50static int ulpi_uevent(struct device *dev, struct kobj_uevent_env *env)
51{
52 struct ulpi *ulpi = to_ulpi_dev(dev);
53
54 if (add_uevent_var(env, "MODALIAS=ulpi:v%04xp%04x",
55 ulpi->id.vendor, ulpi->id.product))
56 return -ENOMEM;
57 return 0;
58}
59
60static int ulpi_probe(struct device *dev)
61{
62 struct ulpi_driver *drv = to_ulpi_driver(dev->driver);
63
64 return drv->probe(to_ulpi_dev(dev));
65}
66
67static int ulpi_remove(struct device *dev)
68{
69 struct ulpi_driver *drv = to_ulpi_driver(dev->driver);
70
71 if (drv->remove)
72 drv->remove(to_ulpi_dev(dev));
73
74 return 0;
75}
76
77static struct bus_type ulpi_bus = {
78 .name = "ulpi",
79 .match = ulpi_match,
80 .uevent = ulpi_uevent,
81 .probe = ulpi_probe,
82 .remove = ulpi_remove,
83};
84
85/* -------------------------------------------------------------------------- */
86
87static ssize_t modalias_show(struct device *dev, struct device_attribute *attr,
88 char *buf)
89{
90 struct ulpi *ulpi = to_ulpi_dev(dev);
91
92 return sprintf(buf, "ulpi:v%04xp%04x\n",
93 ulpi->id.vendor, ulpi->id.product);
94}
95static DEVICE_ATTR_RO(modalias);
96
97static struct attribute *ulpi_dev_attrs[] = {
98 &dev_attr_modalias.attr,
99 NULL
100};
101
102static struct attribute_group ulpi_dev_attr_group = {
103 .attrs = ulpi_dev_attrs,
104};
105
106static const struct attribute_group *ulpi_dev_attr_groups[] = {
107 &ulpi_dev_attr_group,
108 NULL
109};
110
111static void ulpi_dev_release(struct device *dev)
112{
113 kfree(to_ulpi_dev(dev));
114}
115
116static struct device_type ulpi_dev_type = {
117 .name = "ulpi_device",
118 .groups = ulpi_dev_attr_groups,
119 .release = ulpi_dev_release,
120};
121
122/* -------------------------------------------------------------------------- */
123
124/**
125 * ulpi_register_driver - register a driver with the ULPI bus
126 * @drv: driver being registered
127 *
128 * Registers a driver with the ULPI bus.
129 */
130int __ulpi_register_driver(struct ulpi_driver *drv, struct module *module)
131{
132 if (!drv->probe)
133 return -EINVAL;
134
135 drv->driver.owner = module;
136 drv->driver.bus = &ulpi_bus;
137
138 return driver_register(&drv->driver);
139}
140EXPORT_SYMBOL_GPL(__ulpi_register_driver);
141
142/**
143 * ulpi_unregister_driver - unregister a driver with the ULPI bus
144 * @drv: driver to unregister
145 *
146 * Unregisters a driver with the ULPI bus.
147 */
148void ulpi_unregister_driver(struct ulpi_driver *drv)
149{
150 driver_unregister(&drv->driver);
151}
152EXPORT_SYMBOL_GPL(ulpi_unregister_driver);
153
154/* -------------------------------------------------------------------------- */
155
156static int ulpi_register(struct device *dev, struct ulpi *ulpi)
157{
158 int ret;
159
160 ulpi->dev.parent = dev; /* needed early for ops */
161
162 /* Test the interface */
163 ret = ulpi_write(ulpi, ULPI_SCRATCH, 0xaa);
164 if (ret < 0)
165 return ret;
166
167 ret = ulpi_read(ulpi, ULPI_SCRATCH);
168 if (ret < 0)
169 return ret;
170
171 if (ret != 0xaa)
172 return -ENODEV;
173
174 ulpi->id.vendor = ulpi_read(ulpi, ULPI_VENDOR_ID_LOW);
175 ulpi->id.vendor |= ulpi_read(ulpi, ULPI_VENDOR_ID_HIGH) << 8;
176
177 ulpi->id.product = ulpi_read(ulpi, ULPI_PRODUCT_ID_LOW);
178 ulpi->id.product |= ulpi_read(ulpi, ULPI_PRODUCT_ID_HIGH) << 8;
179
180 ulpi->dev.bus = &ulpi_bus;
181 ulpi->dev.type = &ulpi_dev_type;
182 dev_set_name(&ulpi->dev, "%s.ulpi", dev_name(dev));
183
184 ACPI_COMPANION_SET(&ulpi->dev, ACPI_COMPANION(dev));
185
186 request_module("ulpi:v%04xp%04x", ulpi->id.vendor, ulpi->id.product);
187
188 ret = device_register(&ulpi->dev);
189 if (ret)
190 return ret;
191
192 dev_dbg(&ulpi->dev, "registered ULPI PHY: vendor %04x, product %04x\n",
193 ulpi->id.vendor, ulpi->id.product);
194
195 return 0;
196}
197
198/**
199 * ulpi_register_interface - instantiate new ULPI device
200 * @dev: USB controller's device interface
201 * @ops: ULPI register access
202 *
203 * Allocates and registers a ULPI device and an interface for it. Called from
204 * the USB controller that provides the ULPI interface.
205 */
206struct ulpi *ulpi_register_interface(struct device *dev,
207 const struct ulpi_ops *ops)
208{
209 struct ulpi *ulpi;
210 int ret;
211
212 ulpi = kzalloc(sizeof(*ulpi), GFP_KERNEL);
213 if (!ulpi)
214 return ERR_PTR(-ENOMEM);
215
216 ulpi->ops = ops;
217
218 ret = ulpi_register(dev, ulpi);
219 if (ret) {
220 kfree(ulpi);
221 return ERR_PTR(ret);
222 }
223
224 return ulpi;
225}
226EXPORT_SYMBOL_GPL(ulpi_register_interface);
227
228/**
229 * ulpi_unregister_interface - unregister ULPI interface
230 * @intrf: struct ulpi_interface
231 *
232 * Unregisters a ULPI device and it's interface that was created with
233 * ulpi_create_interface().
234 */
235void ulpi_unregister_interface(struct ulpi *ulpi)
236{
237 device_unregister(&ulpi->dev);
238}
239EXPORT_SYMBOL_GPL(ulpi_unregister_interface);
240
241/* -------------------------------------------------------------------------- */
242
243static int __init ulpi_init(void)
244{
245 return bus_register(&ulpi_bus);
246}
247subsys_initcall(ulpi_init);
248
249static void __exit ulpi_exit(void)
250{
251 bus_unregister(&ulpi_bus);
252}
253module_exit(ulpi_exit);
254
255MODULE_AUTHOR("Intel Corporation");
256MODULE_LICENSE("GPL v2");
257MODULE_DESCRIPTION("USB ULPI PHY bus");