GNU Linux-libre 6.8.9-gnu
[releases.git] / drivers / tty / serdev / core.c
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * Copyright (C) 2016-2017 Linaro Ltd., Rob Herring <robh@kernel.org>
4  *
5  * Based on drivers/spmi/spmi.c:
6  * Copyright (c) 2012-2015, The Linux Foundation. All rights reserved.
7  */
8
9 #include <linux/acpi.h>
10 #include <linux/errno.h>
11 #include <linux/idr.h>
12 #include <linux/kernel.h>
13 #include <linux/module.h>
14 #include <linux/of.h>
15 #include <linux/of_device.h>
16 #include <linux/pm_domain.h>
17 #include <linux/pm_runtime.h>
18 #include <linux/property.h>
19 #include <linux/sched.h>
20 #include <linux/serdev.h>
21 #include <linux/slab.h>
22
23 #include <linux/platform_data/x86/apple.h>
24
25 static bool is_registered;
26 static DEFINE_IDA(ctrl_ida);
27
28 static ssize_t modalias_show(struct device *dev,
29                              struct device_attribute *attr, char *buf)
30 {
31         int len;
32
33         len = acpi_device_modalias(dev, buf, PAGE_SIZE - 1);
34         if (len != -ENODEV)
35                 return len;
36
37         return of_device_modalias(dev, buf, PAGE_SIZE);
38 }
39 static DEVICE_ATTR_RO(modalias);
40
41 static struct attribute *serdev_device_attrs[] = {
42         &dev_attr_modalias.attr,
43         NULL,
44 };
45 ATTRIBUTE_GROUPS(serdev_device);
46
47 static int serdev_device_uevent(const struct device *dev, struct kobj_uevent_env *env)
48 {
49         int rc;
50
51         /* TODO: platform modalias */
52
53         rc = acpi_device_uevent_modalias(dev, env);
54         if (rc != -ENODEV)
55                 return rc;
56
57         return of_device_uevent_modalias(dev, env);
58 }
59
60 static void serdev_device_release(struct device *dev)
61 {
62         struct serdev_device *serdev = to_serdev_device(dev);
63         kfree(serdev);
64 }
65
66 static const struct device_type serdev_device_type = {
67         .groups         = serdev_device_groups,
68         .uevent         = serdev_device_uevent,
69         .release        = serdev_device_release,
70 };
71
72 static bool is_serdev_device(const struct device *dev)
73 {
74         return dev->type == &serdev_device_type;
75 }
76
77 static void serdev_ctrl_release(struct device *dev)
78 {
79         struct serdev_controller *ctrl = to_serdev_controller(dev);
80         ida_free(&ctrl_ida, ctrl->nr);
81         kfree(ctrl);
82 }
83
84 static const struct device_type serdev_ctrl_type = {
85         .release        = serdev_ctrl_release,
86 };
87
88 static int serdev_device_match(struct device *dev, struct device_driver *drv)
89 {
90         if (!is_serdev_device(dev))
91                 return 0;
92
93         /* TODO: platform matching */
94         if (acpi_driver_match_device(dev, drv))
95                 return 1;
96
97         return of_driver_match_device(dev, drv);
98 }
99
100 /**
101  * serdev_device_add() - add a device previously constructed via serdev_device_alloc()
102  * @serdev:     serdev_device to be added
103  */
104 int serdev_device_add(struct serdev_device *serdev)
105 {
106         struct serdev_controller *ctrl = serdev->ctrl;
107         struct device *parent = serdev->dev.parent;
108         int err;
109
110         dev_set_name(&serdev->dev, "%s-%d", dev_name(parent), serdev->nr);
111
112         /* Only a single slave device is currently supported. */
113         if (ctrl->serdev) {
114                 dev_err(&serdev->dev, "controller busy\n");
115                 return -EBUSY;
116         }
117         ctrl->serdev = serdev;
118
119         err = device_add(&serdev->dev);
120         if (err < 0) {
121                 dev_err(&serdev->dev, "Can't add %s, status %pe\n",
122                         dev_name(&serdev->dev), ERR_PTR(err));
123                 goto err_clear_serdev;
124         }
125
126         dev_dbg(&serdev->dev, "device %s registered\n", dev_name(&serdev->dev));
127
128         return 0;
129
130 err_clear_serdev:
131         ctrl->serdev = NULL;
132         return err;
133 }
134 EXPORT_SYMBOL_GPL(serdev_device_add);
135
136 /**
137  * serdev_device_remove(): remove an serdev device
138  * @serdev:     serdev_device to be removed
139  */
140 void serdev_device_remove(struct serdev_device *serdev)
141 {
142         struct serdev_controller *ctrl = serdev->ctrl;
143
144         device_unregister(&serdev->dev);
145         ctrl->serdev = NULL;
146 }
147 EXPORT_SYMBOL_GPL(serdev_device_remove);
148
149 int serdev_device_open(struct serdev_device *serdev)
150 {
151         struct serdev_controller *ctrl = serdev->ctrl;
152         int ret;
153
154         if (!ctrl || !ctrl->ops->open)
155                 return -EINVAL;
156
157         ret = ctrl->ops->open(ctrl);
158         if (ret)
159                 return ret;
160
161         ret = pm_runtime_get_sync(&ctrl->dev);
162         if (ret < 0) {
163                 pm_runtime_put_noidle(&ctrl->dev);
164                 goto err_close;
165         }
166
167         return 0;
168
169 err_close:
170         if (ctrl->ops->close)
171                 ctrl->ops->close(ctrl);
172
173         return ret;
174 }
175 EXPORT_SYMBOL_GPL(serdev_device_open);
176
177 void serdev_device_close(struct serdev_device *serdev)
178 {
179         struct serdev_controller *ctrl = serdev->ctrl;
180
181         if (!ctrl || !ctrl->ops->close)
182                 return;
183
184         pm_runtime_put(&ctrl->dev);
185
186         ctrl->ops->close(ctrl);
187 }
188 EXPORT_SYMBOL_GPL(serdev_device_close);
189
190 static void devm_serdev_device_close(void *serdev)
191 {
192         serdev_device_close(serdev);
193 }
194
195 int devm_serdev_device_open(struct device *dev, struct serdev_device *serdev)
196 {
197         int ret;
198
199         ret = serdev_device_open(serdev);
200         if (ret)
201                 return ret;
202
203         return devm_add_action_or_reset(dev, devm_serdev_device_close, serdev);
204 }
205 EXPORT_SYMBOL_GPL(devm_serdev_device_open);
206
207 void serdev_device_write_wakeup(struct serdev_device *serdev)
208 {
209         complete(&serdev->write_comp);
210 }
211 EXPORT_SYMBOL_GPL(serdev_device_write_wakeup);
212
213 /**
214  * serdev_device_write_buf() - write data asynchronously
215  * @serdev:     serdev device
216  * @buf:        data to be written
217  * @count:      number of bytes to write
218  *
219  * Write data to the device asynchronously.
220  *
221  * Note that any accepted data has only been buffered by the controller; use
222  * serdev_device_wait_until_sent() to make sure the controller write buffer
223  * has actually been emptied.
224  *
225  * Return: The number of bytes written (less than count if not enough room in
226  * the write buffer), or a negative errno on errors.
227  */
228 int serdev_device_write_buf(struct serdev_device *serdev, const u8 *buf, size_t count)
229 {
230         struct serdev_controller *ctrl = serdev->ctrl;
231
232         if (!ctrl || !ctrl->ops->write_buf)
233                 return -EINVAL;
234
235         return ctrl->ops->write_buf(ctrl, buf, count);
236 }
237 EXPORT_SYMBOL_GPL(serdev_device_write_buf);
238
239 /**
240  * serdev_device_write() - write data synchronously
241  * @serdev:     serdev device
242  * @buf:        data to be written
243  * @count:      number of bytes to write
244  * @timeout:    timeout in jiffies, or 0 to wait indefinitely
245  *
246  * Write data to the device synchronously by repeatedly calling
247  * serdev_device_write() until the controller has accepted all data (unless
248  * interrupted by a timeout or a signal).
249  *
250  * Note that any accepted data has only been buffered by the controller; use
251  * serdev_device_wait_until_sent() to make sure the controller write buffer
252  * has actually been emptied.
253  *
254  * Note that this function depends on serdev_device_write_wakeup() being
255  * called in the serdev driver write_wakeup() callback.
256  *
257  * Return: The number of bytes written (less than count if interrupted),
258  * -ETIMEDOUT or -ERESTARTSYS if interrupted before any bytes were written, or
259  * a negative errno on errors.
260  */
261 ssize_t serdev_device_write(struct serdev_device *serdev, const u8 *buf,
262                             size_t count, long timeout)
263 {
264         struct serdev_controller *ctrl = serdev->ctrl;
265         size_t written = 0;
266         ssize_t ret;
267
268         if (!ctrl || !ctrl->ops->write_buf || !serdev->ops->write_wakeup)
269                 return -EINVAL;
270
271         if (timeout == 0)
272                 timeout = MAX_SCHEDULE_TIMEOUT;
273
274         mutex_lock(&serdev->write_lock);
275         do {
276                 reinit_completion(&serdev->write_comp);
277
278                 ret = ctrl->ops->write_buf(ctrl, buf, count);
279                 if (ret < 0)
280                         break;
281
282                 written += ret;
283                 buf += ret;
284                 count -= ret;
285
286                 if (count == 0)
287                         break;
288
289                 timeout = wait_for_completion_interruptible_timeout(&serdev->write_comp,
290                                                                     timeout);
291         } while (timeout > 0);
292         mutex_unlock(&serdev->write_lock);
293
294         if (ret < 0)
295                 return ret;
296
297         if (timeout <= 0 && written == 0) {
298                 if (timeout == -ERESTARTSYS)
299                         return -ERESTARTSYS;
300                 else
301                         return -ETIMEDOUT;
302         }
303
304         return written;
305 }
306 EXPORT_SYMBOL_GPL(serdev_device_write);
307
308 void serdev_device_write_flush(struct serdev_device *serdev)
309 {
310         struct serdev_controller *ctrl = serdev->ctrl;
311
312         if (!ctrl || !ctrl->ops->write_flush)
313                 return;
314
315         ctrl->ops->write_flush(ctrl);
316 }
317 EXPORT_SYMBOL_GPL(serdev_device_write_flush);
318
319 int serdev_device_write_room(struct serdev_device *serdev)
320 {
321         struct serdev_controller *ctrl = serdev->ctrl;
322
323         if (!ctrl || !ctrl->ops->write_room)
324                 return 0;
325
326         return serdev->ctrl->ops->write_room(ctrl);
327 }
328 EXPORT_SYMBOL_GPL(serdev_device_write_room);
329
330 unsigned int serdev_device_set_baudrate(struct serdev_device *serdev, unsigned int speed)
331 {
332         struct serdev_controller *ctrl = serdev->ctrl;
333
334         if (!ctrl || !ctrl->ops->set_baudrate)
335                 return 0;
336
337         return ctrl->ops->set_baudrate(ctrl, speed);
338
339 }
340 EXPORT_SYMBOL_GPL(serdev_device_set_baudrate);
341
342 void serdev_device_set_flow_control(struct serdev_device *serdev, bool enable)
343 {
344         struct serdev_controller *ctrl = serdev->ctrl;
345
346         if (!ctrl || !ctrl->ops->set_flow_control)
347                 return;
348
349         ctrl->ops->set_flow_control(ctrl, enable);
350 }
351 EXPORT_SYMBOL_GPL(serdev_device_set_flow_control);
352
353 int serdev_device_set_parity(struct serdev_device *serdev,
354                              enum serdev_parity parity)
355 {
356         struct serdev_controller *ctrl = serdev->ctrl;
357
358         if (!ctrl || !ctrl->ops->set_parity)
359                 return -EOPNOTSUPP;
360
361         return ctrl->ops->set_parity(ctrl, parity);
362 }
363 EXPORT_SYMBOL_GPL(serdev_device_set_parity);
364
365 void serdev_device_wait_until_sent(struct serdev_device *serdev, long timeout)
366 {
367         struct serdev_controller *ctrl = serdev->ctrl;
368
369         if (!ctrl || !ctrl->ops->wait_until_sent)
370                 return;
371
372         ctrl->ops->wait_until_sent(ctrl, timeout);
373 }
374 EXPORT_SYMBOL_GPL(serdev_device_wait_until_sent);
375
376 int serdev_device_get_tiocm(struct serdev_device *serdev)
377 {
378         struct serdev_controller *ctrl = serdev->ctrl;
379
380         if (!ctrl || !ctrl->ops->get_tiocm)
381                 return -EOPNOTSUPP;
382
383         return ctrl->ops->get_tiocm(ctrl);
384 }
385 EXPORT_SYMBOL_GPL(serdev_device_get_tiocm);
386
387 int serdev_device_set_tiocm(struct serdev_device *serdev, int set, int clear)
388 {
389         struct serdev_controller *ctrl = serdev->ctrl;
390
391         if (!ctrl || !ctrl->ops->set_tiocm)
392                 return -EOPNOTSUPP;
393
394         return ctrl->ops->set_tiocm(ctrl, set, clear);
395 }
396 EXPORT_SYMBOL_GPL(serdev_device_set_tiocm);
397
398 int serdev_device_break_ctl(struct serdev_device *serdev, int break_state)
399 {
400         struct serdev_controller *ctrl = serdev->ctrl;
401
402         if (!ctrl || !ctrl->ops->break_ctl)
403                 return -EOPNOTSUPP;
404
405         return ctrl->ops->break_ctl(ctrl, break_state);
406 }
407 EXPORT_SYMBOL_GPL(serdev_device_break_ctl);
408
409 static int serdev_drv_probe(struct device *dev)
410 {
411         const struct serdev_device_driver *sdrv = to_serdev_device_driver(dev->driver);
412         int ret;
413
414         ret = dev_pm_domain_attach(dev, true);
415         if (ret)
416                 return ret;
417
418         ret = sdrv->probe(to_serdev_device(dev));
419         if (ret)
420                 dev_pm_domain_detach(dev, true);
421
422         return ret;
423 }
424
425 static void serdev_drv_remove(struct device *dev)
426 {
427         const struct serdev_device_driver *sdrv = to_serdev_device_driver(dev->driver);
428         if (sdrv->remove)
429                 sdrv->remove(to_serdev_device(dev));
430
431         dev_pm_domain_detach(dev, true);
432 }
433
434 static struct bus_type serdev_bus_type = {
435         .name           = "serial",
436         .match          = serdev_device_match,
437         .probe          = serdev_drv_probe,
438         .remove         = serdev_drv_remove,
439 };
440
441 /**
442  * serdev_device_alloc() - Allocate a new serdev device
443  * @ctrl:       associated controller
444  *
445  * Caller is responsible for either calling serdev_device_add() to add the
446  * newly allocated controller, or calling serdev_device_put() to discard it.
447  */
448 struct serdev_device *serdev_device_alloc(struct serdev_controller *ctrl)
449 {
450         struct serdev_device *serdev;
451
452         serdev = kzalloc(sizeof(*serdev), GFP_KERNEL);
453         if (!serdev)
454                 return NULL;
455
456         serdev->ctrl = ctrl;
457         device_initialize(&serdev->dev);
458         serdev->dev.parent = &ctrl->dev;
459         serdev->dev.bus = &serdev_bus_type;
460         serdev->dev.type = &serdev_device_type;
461         init_completion(&serdev->write_comp);
462         mutex_init(&serdev->write_lock);
463         return serdev;
464 }
465 EXPORT_SYMBOL_GPL(serdev_device_alloc);
466
467 /**
468  * serdev_controller_alloc() - Allocate a new serdev controller
469  * @host:       serial port hardware controller device
470  * @parent:     parent device
471  * @size:       size of private data
472  *
473  * Caller is responsible for either calling serdev_controller_add() to add the
474  * newly allocated controller, or calling serdev_controller_put() to discard it.
475  * The allocated private data region may be accessed via
476  * serdev_controller_get_drvdata()
477  */
478 struct serdev_controller *serdev_controller_alloc(struct device *host,
479                                                   struct device *parent,
480                                                   size_t size)
481 {
482         struct serdev_controller *ctrl;
483         int id;
484
485         if (WARN_ON(!parent))
486                 return NULL;
487
488         ctrl = kzalloc(sizeof(*ctrl) + size, GFP_KERNEL);
489         if (!ctrl)
490                 return NULL;
491
492         id = ida_alloc(&ctrl_ida, GFP_KERNEL);
493         if (id < 0) {
494                 dev_err(parent,
495                         "unable to allocate serdev controller identifier.\n");
496                 goto err_free;
497         }
498
499         ctrl->nr = id;
500
501         device_initialize(&ctrl->dev);
502         ctrl->dev.type = &serdev_ctrl_type;
503         ctrl->dev.bus = &serdev_bus_type;
504         ctrl->dev.parent = parent;
505         ctrl->host = host;
506         device_set_node(&ctrl->dev, dev_fwnode(host));
507         serdev_controller_set_drvdata(ctrl, &ctrl[1]);
508
509         dev_set_name(&ctrl->dev, "serial%d", id);
510
511         pm_runtime_no_callbacks(&ctrl->dev);
512         pm_suspend_ignore_children(&ctrl->dev, true);
513
514         dev_dbg(&ctrl->dev, "allocated controller 0x%p id %d\n", ctrl, id);
515         return ctrl;
516
517 err_free:
518         kfree(ctrl);
519
520         return NULL;
521 }
522 EXPORT_SYMBOL_GPL(serdev_controller_alloc);
523
524 static int of_serdev_register_devices(struct serdev_controller *ctrl)
525 {
526         struct device_node *node;
527         struct serdev_device *serdev = NULL;
528         int err;
529         bool found = false;
530
531         for_each_available_child_of_node(ctrl->dev.of_node, node) {
532                 if (!of_get_property(node, "compatible", NULL))
533                         continue;
534
535                 dev_dbg(&ctrl->dev, "adding child %pOF\n", node);
536
537                 serdev = serdev_device_alloc(ctrl);
538                 if (!serdev)
539                         continue;
540
541                 device_set_node(&serdev->dev, of_fwnode_handle(node));
542
543                 err = serdev_device_add(serdev);
544                 if (err) {
545                         dev_err(&serdev->dev,
546                                 "failure adding device. status %pe\n",
547                                 ERR_PTR(err));
548                         serdev_device_put(serdev);
549                 } else
550                         found = true;
551         }
552         if (!found)
553                 return -ENODEV;
554
555         return 0;
556 }
557
558 #ifdef CONFIG_ACPI
559
560 #define SERDEV_ACPI_MAX_SCAN_DEPTH 32
561
562 struct acpi_serdev_lookup {
563         acpi_handle device_handle;
564         acpi_handle controller_handle;
565         int n;
566         int index;
567 };
568
569 /**
570  * serdev_acpi_get_uart_resource - Gets UARTSerialBus resource if type matches
571  * @ares:       ACPI resource
572  * @uart:       Pointer to UARTSerialBus resource will be returned here
573  *
574  * Checks if the given ACPI resource is of type UARTSerialBus.
575  * In this case, returns a pointer to it to the caller.
576  *
577  * Return: True if resource type is of UARTSerialBus, otherwise false.
578  */
579 bool serdev_acpi_get_uart_resource(struct acpi_resource *ares,
580                                    struct acpi_resource_uart_serialbus **uart)
581 {
582         struct acpi_resource_uart_serialbus *sb;
583
584         if (ares->type != ACPI_RESOURCE_TYPE_SERIAL_BUS)
585                 return false;
586
587         sb = &ares->data.uart_serial_bus;
588         if (sb->type != ACPI_RESOURCE_SERIAL_TYPE_UART)
589                 return false;
590
591         *uart = sb;
592         return true;
593 }
594 EXPORT_SYMBOL_GPL(serdev_acpi_get_uart_resource);
595
596 static int acpi_serdev_parse_resource(struct acpi_resource *ares, void *data)
597 {
598         struct acpi_serdev_lookup *lookup = data;
599         struct acpi_resource_uart_serialbus *sb;
600         acpi_status status;
601
602         if (!serdev_acpi_get_uart_resource(ares, &sb))
603                 return 1;
604
605         if (lookup->index != -1 && lookup->n++ != lookup->index)
606                 return 1;
607
608         status = acpi_get_handle(lookup->device_handle,
609                                  sb->resource_source.string_ptr,
610                                  &lookup->controller_handle);
611         if (ACPI_FAILURE(status))
612                 return 1;
613
614         /*
615          * NOTE: Ideally, we would also want to retrieve other properties here,
616          * once setting them before opening the device is supported by serdev.
617          */
618
619         return 1;
620 }
621
622 static int acpi_serdev_do_lookup(struct acpi_device *adev,
623                                  struct acpi_serdev_lookup *lookup)
624 {
625         struct list_head resource_list;
626         int ret;
627
628         lookup->device_handle = acpi_device_handle(adev);
629         lookup->controller_handle = NULL;
630         lookup->n = 0;
631
632         INIT_LIST_HEAD(&resource_list);
633         ret = acpi_dev_get_resources(adev, &resource_list,
634                                      acpi_serdev_parse_resource, lookup);
635         acpi_dev_free_resource_list(&resource_list);
636
637         if (ret < 0)
638                 return -EINVAL;
639
640         return 0;
641 }
642
643 static int acpi_serdev_check_resources(struct serdev_controller *ctrl,
644                                        struct acpi_device *adev)
645 {
646         struct acpi_serdev_lookup lookup;
647         int ret;
648
649         if (acpi_bus_get_status(adev) || !adev->status.present)
650                 return -EINVAL;
651
652         /* Look for UARTSerialBusV2 resource */
653         lookup.index = -1;      // we only care for the last device
654
655         ret = acpi_serdev_do_lookup(adev, &lookup);
656         if (ret)
657                 return ret;
658
659         /*
660          * Apple machines provide an empty resource template, so on those
661          * machines just look for immediate children with a "baud" property
662          * (from the _DSM method) instead.
663          */
664         if (!lookup.controller_handle && x86_apple_machine &&
665             !acpi_dev_get_property(adev, "baud", ACPI_TYPE_BUFFER, NULL))
666                 acpi_get_parent(adev->handle, &lookup.controller_handle);
667
668         /* Make sure controller and ResourceSource handle match */
669         if (!device_match_acpi_handle(ctrl->host, lookup.controller_handle))
670                 return -ENODEV;
671
672         return 0;
673 }
674
675 static acpi_status acpi_serdev_register_device(struct serdev_controller *ctrl,
676                                                struct acpi_device *adev)
677 {
678         struct serdev_device *serdev;
679         int err;
680
681         serdev = serdev_device_alloc(ctrl);
682         if (!serdev) {
683                 dev_err(&ctrl->dev, "failed to allocate serdev device for %s\n",
684                         dev_name(&adev->dev));
685                 return AE_NO_MEMORY;
686         }
687
688         ACPI_COMPANION_SET(&serdev->dev, adev);
689         acpi_device_set_enumerated(adev);
690
691         err = serdev_device_add(serdev);
692         if (err) {
693                 dev_err(&serdev->dev,
694                         "failure adding ACPI serdev device. status %pe\n",
695                         ERR_PTR(err));
696                 serdev_device_put(serdev);
697         }
698
699         return AE_OK;
700 }
701
702 static const struct acpi_device_id serdev_acpi_devices_blacklist[] = {
703         { "INT3511", 0 },
704         { "INT3512", 0 },
705         { },
706 };
707
708 static acpi_status acpi_serdev_add_device(acpi_handle handle, u32 level,
709                                           void *data, void **return_value)
710 {
711         struct acpi_device *adev = acpi_fetch_acpi_dev(handle);
712         struct serdev_controller *ctrl = data;
713
714         if (!adev || acpi_device_enumerated(adev))
715                 return AE_OK;
716
717         /* Skip if black listed */
718         if (!acpi_match_device_ids(adev, serdev_acpi_devices_blacklist))
719                 return AE_OK;
720
721         if (acpi_serdev_check_resources(ctrl, adev))
722                 return AE_OK;
723
724         return acpi_serdev_register_device(ctrl, adev);
725 }
726
727
728 static int acpi_serdev_register_devices(struct serdev_controller *ctrl)
729 {
730         acpi_status status;
731         bool skip;
732         int ret;
733
734         if (!has_acpi_companion(ctrl->host))
735                 return -ENODEV;
736
737         /*
738          * Skip registration on boards where the ACPI tables are known to
739          * contain buggy devices. Note serdev_controller_add() must still
740          * succeed in this case, so that the proper serdev devices can be
741          * added "manually" later.
742          */
743         ret = acpi_quirk_skip_serdev_enumeration(ctrl->host, &skip);
744         if (ret)
745                 return ret;
746         if (skip)
747                 return 0;
748
749         status = acpi_walk_namespace(ACPI_TYPE_DEVICE, ACPI_ROOT_OBJECT,
750                                      SERDEV_ACPI_MAX_SCAN_DEPTH,
751                                      acpi_serdev_add_device, NULL, ctrl, NULL);
752         if (ACPI_FAILURE(status))
753                 dev_warn(&ctrl->dev, "failed to enumerate serdev slaves\n");
754
755         if (!ctrl->serdev)
756                 return -ENODEV;
757
758         return 0;
759 }
760 #else
761 static inline int acpi_serdev_register_devices(struct serdev_controller *ctrl)
762 {
763         return -ENODEV;
764 }
765 #endif /* CONFIG_ACPI */
766
767 /**
768  * serdev_controller_add() - Add an serdev controller
769  * @ctrl:       controller to be registered.
770  *
771  * Register a controller previously allocated via serdev_controller_alloc() with
772  * the serdev core.
773  */
774 int serdev_controller_add(struct serdev_controller *ctrl)
775 {
776         int ret_of, ret_acpi, ret;
777
778         /* Can't register until after driver model init */
779         if (WARN_ON(!is_registered))
780                 return -EAGAIN;
781
782         ret = device_add(&ctrl->dev);
783         if (ret)
784                 return ret;
785
786         pm_runtime_enable(&ctrl->dev);
787
788         ret_of = of_serdev_register_devices(ctrl);
789         ret_acpi = acpi_serdev_register_devices(ctrl);
790         if (ret_of && ret_acpi) {
791                 dev_dbg(&ctrl->dev, "no devices registered: of:%pe acpi:%pe\n",
792                         ERR_PTR(ret_of), ERR_PTR(ret_acpi));
793                 ret = -ENODEV;
794                 goto err_rpm_disable;
795         }
796
797         dev_dbg(&ctrl->dev, "serdev%d registered: dev:%p\n",
798                 ctrl->nr, &ctrl->dev);
799         return 0;
800
801 err_rpm_disable:
802         pm_runtime_disable(&ctrl->dev);
803         device_del(&ctrl->dev);
804         return ret;
805 };
806 EXPORT_SYMBOL_GPL(serdev_controller_add);
807
808 /* Remove a device associated with a controller */
809 static int serdev_remove_device(struct device *dev, void *data)
810 {
811         struct serdev_device *serdev = to_serdev_device(dev);
812         if (dev->type == &serdev_device_type)
813                 serdev_device_remove(serdev);
814         return 0;
815 }
816
817 /**
818  * serdev_controller_remove(): remove an serdev controller
819  * @ctrl:       controller to remove
820  *
821  * Remove a serdev controller.  Caller is responsible for calling
822  * serdev_controller_put() to discard the allocated controller.
823  */
824 void serdev_controller_remove(struct serdev_controller *ctrl)
825 {
826         if (!ctrl)
827                 return;
828
829         device_for_each_child(&ctrl->dev, NULL, serdev_remove_device);
830         pm_runtime_disable(&ctrl->dev);
831         device_del(&ctrl->dev);
832 }
833 EXPORT_SYMBOL_GPL(serdev_controller_remove);
834
835 /**
836  * __serdev_device_driver_register() - Register client driver with serdev core
837  * @sdrv:       client driver to be associated with client-device.
838  * @owner:      client driver owner to set.
839  *
840  * This API will register the client driver with the serdev framework.
841  * It is typically called from the driver's module-init function.
842  */
843 int __serdev_device_driver_register(struct serdev_device_driver *sdrv, struct module *owner)
844 {
845         sdrv->driver.bus = &serdev_bus_type;
846         sdrv->driver.owner = owner;
847
848         /* force drivers to async probe so I/O is possible in probe */
849         sdrv->driver.probe_type = PROBE_PREFER_ASYNCHRONOUS;
850
851         return driver_register(&sdrv->driver);
852 }
853 EXPORT_SYMBOL_GPL(__serdev_device_driver_register);
854
855 static void __exit serdev_exit(void)
856 {
857         bus_unregister(&serdev_bus_type);
858         ida_destroy(&ctrl_ida);
859 }
860 module_exit(serdev_exit);
861
862 static int __init serdev_init(void)
863 {
864         int ret;
865
866         ret = bus_register(&serdev_bus_type);
867         if (ret)
868                 return ret;
869
870         is_registered = true;
871         return 0;
872 }
873 /* Must be before serial drivers register */
874 postcore_initcall(serdev_init);
875
876 MODULE_AUTHOR("Rob Herring <robh@kernel.org>");
877 MODULE_LICENSE("GPL v2");
878 MODULE_DESCRIPTION("Serial attached device bus");