blob: b4c385d4a6af2ec2568d1f5226aa587da1c220db [file] [log] [blame]
Thierry Reding776dc382013-10-14 14:43:22 +02001/*
2 * Copyright (C) 2012 Avionic Design GmbH
3 * Copyright (C) 2012-2013, NVIDIA Corporation
4 *
5 * This program is free software; you can redistribute it and/or modify it
6 * under the terms and conditions of the GNU General Public License,
7 * version 2, as published by the Free Software Foundation.
8 *
9 * This program is distributed in the hope it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
12 * more details.
13 *
14 * You should have received a copy of the GNU General Public License
15 * along with this program. If not, see <http://www.gnu.org/licenses/>.
16 */
17
18#include <linux/host1x.h>
19#include <linux/of.h>
20#include <linux/slab.h>
Alexandre Courbotc95469a2016-02-26 18:06:53 +090021#include <linux/of_device.h>
Thierry Reding776dc382013-10-14 14:43:22 +020022
Thierry Redingd24b2892013-11-08 13:20:23 +010023#include "bus.h"
Thierry Reding776dc382013-10-14 14:43:22 +020024#include "dev.h"
25
26static DEFINE_MUTEX(clients_lock);
27static LIST_HEAD(clients);
28
29static DEFINE_MUTEX(drivers_lock);
30static LIST_HEAD(drivers);
31
32static DEFINE_MUTEX(devices_lock);
33static LIST_HEAD(devices);
34
35struct host1x_subdev {
36 struct host1x_client *client;
37 struct device_node *np;
38 struct list_head list;
39};
40
41/**
42 * host1x_subdev_add() - add a new subdevice with an associated device node
Thierry Reding466749f2017-04-10 12:27:01 +020043 * @device: host1x device to add the subdevice to
Thierry Reding466749f2017-04-10 12:27:01 +020044 * @np: device node
Thierry Reding776dc382013-10-14 14:43:22 +020045 */
46static int host1x_subdev_add(struct host1x_device *device,
Thierry Reding25ae30d2017-08-15 15:46:22 +020047 struct host1x_driver *driver,
Thierry Reding776dc382013-10-14 14:43:22 +020048 struct device_node *np)
49{
50 struct host1x_subdev *subdev;
Thierry Reding25ae30d2017-08-15 15:46:22 +020051 struct device_node *child;
52 int err;
Thierry Reding776dc382013-10-14 14:43:22 +020053
54 subdev = kzalloc(sizeof(*subdev), GFP_KERNEL);
55 if (!subdev)
56 return -ENOMEM;
57
58 INIT_LIST_HEAD(&subdev->list);
59 subdev->np = of_node_get(np);
60
61 mutex_lock(&device->subdevs_lock);
62 list_add_tail(&subdev->list, &device->subdevs);
63 mutex_unlock(&device->subdevs_lock);
64
Thierry Reding25ae30d2017-08-15 15:46:22 +020065 /* recursively add children */
66 for_each_child_of_node(np, child) {
67 if (of_match_node(driver->subdevs, child) &&
68 of_device_is_available(child)) {
69 err = host1x_subdev_add(device, driver, child);
70 if (err < 0) {
71 /* XXX cleanup? */
72 of_node_put(child);
73 return err;
74 }
75 }
76 }
77
Thierry Reding776dc382013-10-14 14:43:22 +020078 return 0;
79}
80
81/**
82 * host1x_subdev_del() - remove subdevice
Thierry Reding466749f2017-04-10 12:27:01 +020083 * @subdev: subdevice to remove
Thierry Reding776dc382013-10-14 14:43:22 +020084 */
85static void host1x_subdev_del(struct host1x_subdev *subdev)
86{
87 list_del(&subdev->list);
88 of_node_put(subdev->np);
89 kfree(subdev);
90}
91
92/**
93 * host1x_device_parse_dt() - scan device tree and add matching subdevices
Thierry Reding466749f2017-04-10 12:27:01 +020094 * @device: host1x logical device
95 * @driver: host1x driver
Thierry Reding776dc382013-10-14 14:43:22 +020096 */
Thierry Redingf4c5cf82014-12-18 15:29:14 +010097static int host1x_device_parse_dt(struct host1x_device *device,
98 struct host1x_driver *driver)
Thierry Reding776dc382013-10-14 14:43:22 +020099{
100 struct device_node *np;
101 int err;
102
103 for_each_child_of_node(device->dev.parent->of_node, np) {
Thierry Redingf4c5cf82014-12-18 15:29:14 +0100104 if (of_match_node(driver->subdevs, np) &&
Thierry Reding776dc382013-10-14 14:43:22 +0200105 of_device_is_available(np)) {
Thierry Reding25ae30d2017-08-15 15:46:22 +0200106 err = host1x_subdev_add(device, driver, np);
Amitoj Kaur Chawla93ec3022016-01-24 22:02:10 +0530107 if (err < 0) {
108 of_node_put(np);
Thierry Reding776dc382013-10-14 14:43:22 +0200109 return err;
Amitoj Kaur Chawla93ec3022016-01-24 22:02:10 +0530110 }
Thierry Reding776dc382013-10-14 14:43:22 +0200111 }
112 }
113
114 return 0;
115}
116
117static void host1x_subdev_register(struct host1x_device *device,
118 struct host1x_subdev *subdev,
119 struct host1x_client *client)
120{
121 int err;
122
123 /*
124 * Move the subdevice to the list of active (registered) subdevices
125 * and associate it with a client. At the same time, associate the
126 * client with its parent device.
127 */
128 mutex_lock(&device->subdevs_lock);
129 mutex_lock(&device->clients_lock);
130 list_move_tail(&client->list, &device->clients);
131 list_move_tail(&subdev->list, &device->active);
132 client->parent = &device->dev;
133 subdev->client = client;
134 mutex_unlock(&device->clients_lock);
135 mutex_unlock(&device->subdevs_lock);
136
Thierry Reding776dc382013-10-14 14:43:22 +0200137 if (list_empty(&device->subdevs)) {
Thierry Redingf4c5cf82014-12-18 15:29:14 +0100138 err = device_add(&device->dev);
Thierry Reding776dc382013-10-14 14:43:22 +0200139 if (err < 0)
Thierry Redingf4c5cf82014-12-18 15:29:14 +0100140 dev_err(&device->dev, "failed to add: %d\n", err);
Thierry Reding536e1712014-11-05 11:43:26 +0100141 else
Thierry Redingf4c5cf82014-12-18 15:29:14 +0100142 device->registered = true;
Thierry Reding776dc382013-10-14 14:43:22 +0200143 }
144}
145
146static void __host1x_subdev_unregister(struct host1x_device *device,
147 struct host1x_subdev *subdev)
148{
149 struct host1x_client *client = subdev->client;
Thierry Reding776dc382013-10-14 14:43:22 +0200150
151 /*
152 * If all subdevices have been activated, we're about to remove the
153 * first active subdevice, so unload the driver first.
154 */
Thierry Redingf4c5cf82014-12-18 15:29:14 +0100155 if (list_empty(&device->subdevs)) {
156 if (device->registered) {
157 device->registered = false;
158 device_del(&device->dev);
159 }
Thierry Reding776dc382013-10-14 14:43:22 +0200160 }
161
162 /*
163 * Move the subdevice back to the list of idle subdevices and remove
164 * it from list of clients.
165 */
166 mutex_lock(&device->clients_lock);
167 subdev->client = NULL;
168 client->parent = NULL;
169 list_move_tail(&subdev->list, &device->subdevs);
170 /*
171 * XXX: Perhaps don't do this here, but rather explicitly remove it
172 * when the device is about to be deleted.
173 *
174 * This is somewhat complicated by the fact that this function is
175 * used to remove the subdevice when a client is unregistered but
176 * also when the composite device is about to be removed.
177 */
178 list_del_init(&client->list);
179 mutex_unlock(&device->clients_lock);
180}
181
182static void host1x_subdev_unregister(struct host1x_device *device,
183 struct host1x_subdev *subdev)
184{
185 mutex_lock(&device->subdevs_lock);
186 __host1x_subdev_unregister(device, subdev);
187 mutex_unlock(&device->subdevs_lock);
188}
189
Thierry Reding466749f2017-04-10 12:27:01 +0200190/**
191 * host1x_device_init() - initialize a host1x logical device
192 * @device: host1x logical device
193 *
194 * The driver for the host1x logical device can call this during execution of
195 * its &host1x_driver.probe implementation to initialize each of its clients.
196 * The client drivers access the subsystem specific driver data using the
197 * &host1x_client.parent field and driver data associated with it (usually by
198 * calling dev_get_drvdata()).
199 */
Thierry Reding776dc382013-10-14 14:43:22 +0200200int host1x_device_init(struct host1x_device *device)
201{
202 struct host1x_client *client;
203 int err;
204
205 mutex_lock(&device->clients_lock);
206
207 list_for_each_entry(client, &device->clients, list) {
208 if (client->ops && client->ops->init) {
209 err = client->ops->init(client);
210 if (err < 0) {
211 dev_err(&device->dev,
212 "failed to initialize %s: %d\n",
213 dev_name(client->dev), err);
Thierry Reding8f7da152017-11-08 13:08:21 +0100214 goto teardown;
Thierry Reding776dc382013-10-14 14:43:22 +0200215 }
216 }
217 }
218
219 mutex_unlock(&device->clients_lock);
220
221 return 0;
Thierry Reding8f7da152017-11-08 13:08:21 +0100222
223teardown:
224 list_for_each_entry_continue_reverse(client, &device->clients, list)
225 if (client->ops->exit)
226 client->ops->exit(client);
227
228 mutex_unlock(&device->clients_lock);
229 return err;
Thierry Reding776dc382013-10-14 14:43:22 +0200230}
Thierry Redingfae798a2013-11-08 11:41:42 +0100231EXPORT_SYMBOL(host1x_device_init);
Thierry Reding776dc382013-10-14 14:43:22 +0200232
Thierry Reding466749f2017-04-10 12:27:01 +0200233/**
234 * host1x_device_exit() - uninitialize host1x logical device
235 * @device: host1x logical device
236 *
237 * When the driver for a host1x logical device is unloaded, it can call this
238 * function to tear down each of its clients. Typically this is done after a
239 * subsystem-specific data structure is removed and the functionality can no
240 * longer be used.
241 */
Thierry Reding776dc382013-10-14 14:43:22 +0200242int host1x_device_exit(struct host1x_device *device)
243{
244 struct host1x_client *client;
245 int err;
246
247 mutex_lock(&device->clients_lock);
248
249 list_for_each_entry_reverse(client, &device->clients, list) {
250 if (client->ops && client->ops->exit) {
251 err = client->ops->exit(client);
252 if (err < 0) {
253 dev_err(&device->dev,
254 "failed to cleanup %s: %d\n",
255 dev_name(client->dev), err);
256 mutex_unlock(&device->clients_lock);
257 return err;
258 }
259 }
260 }
261
262 mutex_unlock(&device->clients_lock);
263
264 return 0;
265}
Thierry Redingfae798a2013-11-08 11:41:42 +0100266EXPORT_SYMBOL(host1x_device_exit);
Thierry Reding776dc382013-10-14 14:43:22 +0200267
Thierry Reding0c7dfd32014-05-22 11:12:17 +0200268static int host1x_add_client(struct host1x *host1x,
269 struct host1x_client *client)
Thierry Reding776dc382013-10-14 14:43:22 +0200270{
271 struct host1x_device *device;
272 struct host1x_subdev *subdev;
273
274 mutex_lock(&host1x->devices_lock);
275
276 list_for_each_entry(device, &host1x->devices, list) {
277 list_for_each_entry(subdev, &device->subdevs, list) {
278 if (subdev->np == client->dev->of_node) {
279 host1x_subdev_register(device, subdev, client);
280 mutex_unlock(&host1x->devices_lock);
281 return 0;
282 }
283 }
284 }
285
286 mutex_unlock(&host1x->devices_lock);
287 return -ENODEV;
288}
289
Thierry Reding0c7dfd32014-05-22 11:12:17 +0200290static int host1x_del_client(struct host1x *host1x,
291 struct host1x_client *client)
Thierry Reding776dc382013-10-14 14:43:22 +0200292{
293 struct host1x_device *device, *dt;
294 struct host1x_subdev *subdev;
295
296 mutex_lock(&host1x->devices_lock);
297
298 list_for_each_entry_safe(device, dt, &host1x->devices, list) {
299 list_for_each_entry(subdev, &device->active, list) {
300 if (subdev->client == client) {
301 host1x_subdev_unregister(device, subdev);
302 mutex_unlock(&host1x->devices_lock);
303 return 0;
304 }
305 }
306 }
307
308 mutex_unlock(&host1x->devices_lock);
309 return -ENODEV;
310}
311
Thierry Redingf4c5cf82014-12-18 15:29:14 +0100312static int host1x_device_match(struct device *dev, struct device_driver *drv)
313{
314 return strcmp(dev_name(dev), drv->name) == 0;
315}
316
Nipun Gupta07397df2018-04-28 08:21:58 +0530317static int host1x_dma_configure(struct device *dev)
318{
Christoph Hellwig3d6ce862018-05-03 16:25:08 +0200319 return of_dma_configure(dev, dev->of_node, true);
Nipun Gupta07397df2018-04-28 08:21:58 +0530320}
321
Thierry Redingf4c5cf82014-12-18 15:29:14 +0100322static const struct dev_pm_ops host1x_device_pm_ops = {
323 .suspend = pm_generic_suspend,
324 .resume = pm_generic_resume,
325 .freeze = pm_generic_freeze,
326 .thaw = pm_generic_thaw,
327 .poweroff = pm_generic_poweroff,
328 .restore = pm_generic_restore,
Thierry Reding776dc382013-10-14 14:43:22 +0200329};
330
Thierry Redingf4c5cf82014-12-18 15:29:14 +0100331struct bus_type host1x_bus_type = {
332 .name = "host1x",
333 .match = host1x_device_match,
Thierry Reding50bac832018-09-26 16:09:46 +0200334 .dma_configure = host1x_dma_configure,
Thierry Redingf4c5cf82014-12-18 15:29:14 +0100335 .pm = &host1x_device_pm_ops,
336};
Thierry Reding776dc382013-10-14 14:43:22 +0200337
Thierry Reding99d2cd82014-12-18 15:26:02 +0100338static void __host1x_device_del(struct host1x_device *device)
339{
340 struct host1x_subdev *subdev, *sd;
341 struct host1x_client *client, *cl;
342
343 mutex_lock(&device->subdevs_lock);
344
345 /* unregister subdevices */
346 list_for_each_entry_safe(subdev, sd, &device->active, list) {
347 /*
348 * host1x_subdev_unregister() will remove the client from
349 * any lists, so we'll need to manually add it back to the
350 * list of idle clients.
351 *
352 * XXX: Alternatively, perhaps don't remove the client from
353 * any lists in host1x_subdev_unregister() and instead do
354 * that explicitly from host1x_unregister_client()?
355 */
356 client = subdev->client;
357
358 __host1x_subdev_unregister(device, subdev);
359
360 /* add the client to the list of idle clients */
361 mutex_lock(&clients_lock);
362 list_add_tail(&client->list, &clients);
363 mutex_unlock(&clients_lock);
364 }
365
366 /* remove subdevices */
367 list_for_each_entry_safe(subdev, sd, &device->subdevs, list)
368 host1x_subdev_del(subdev);
369
370 mutex_unlock(&device->subdevs_lock);
371
372 /* move clients to idle list */
373 mutex_lock(&clients_lock);
374 mutex_lock(&device->clients_lock);
375
376 list_for_each_entry_safe(client, cl, &device->clients, list)
377 list_move_tail(&client->list, &clients);
378
379 mutex_unlock(&device->clients_lock);
380 mutex_unlock(&clients_lock);
381
382 /* finally remove the device */
383 list_del_init(&device->list);
384}
385
Thierry Reding776dc382013-10-14 14:43:22 +0200386static void host1x_device_release(struct device *dev)
387{
388 struct host1x_device *device = to_host1x_device(dev);
389
Thierry Reding99d2cd82014-12-18 15:26:02 +0100390 __host1x_device_del(device);
Thierry Reding776dc382013-10-14 14:43:22 +0200391 kfree(device);
392}
393
394static int host1x_device_add(struct host1x *host1x,
395 struct host1x_driver *driver)
396{
397 struct host1x_client *client, *tmp;
398 struct host1x_subdev *subdev;
399 struct host1x_device *device;
400 int err;
401
402 device = kzalloc(sizeof(*device), GFP_KERNEL);
403 if (!device)
404 return -ENOMEM;
405
Thierry Redingf4c5cf82014-12-18 15:29:14 +0100406 device_initialize(&device->dev);
407
Thierry Reding776dc382013-10-14 14:43:22 +0200408 mutex_init(&device->subdevs_lock);
409 INIT_LIST_HEAD(&device->subdevs);
410 INIT_LIST_HEAD(&device->active);
411 mutex_init(&device->clients_lock);
412 INIT_LIST_HEAD(&device->clients);
413 INIT_LIST_HEAD(&device->list);
414 device->driver = driver;
415
416 device->dev.coherent_dma_mask = host1x->dev->coherent_dma_mask;
417 device->dev.dma_mask = &device->dev.coherent_dma_mask;
Thierry Redingf4c5cf82014-12-18 15:29:14 +0100418 dev_set_name(&device->dev, "%s", driver->driver.name);
Thierry Reding776dc382013-10-14 14:43:22 +0200419 device->dev.release = host1x_device_release;
Thierry Reding7b1d4182017-01-20 15:57:35 +0100420 device->dev.of_node = host1x->dev->of_node;
Thierry Reding776dc382013-10-14 14:43:22 +0200421 device->dev.bus = &host1x_bus_type;
422 device->dev.parent = host1x->dev;
423
Christoph Hellwig3d6ce862018-05-03 16:25:08 +0200424 of_dma_configure(&device->dev, host1x->dev->of_node, true);
Mikko Perttunen2fb0dce2017-09-24 12:04:53 +0300425
Thierry Redingf4c5cf82014-12-18 15:29:14 +0100426 err = host1x_device_parse_dt(device, driver);
Thierry Reding776dc382013-10-14 14:43:22 +0200427 if (err < 0) {
Thierry Redingf4c5cf82014-12-18 15:29:14 +0100428 kfree(device);
Thierry Reding776dc382013-10-14 14:43:22 +0200429 return err;
430 }
431
Thierry Reding776dc382013-10-14 14:43:22 +0200432 list_add_tail(&device->list, &host1x->devices);
Thierry Reding776dc382013-10-14 14:43:22 +0200433
434 mutex_lock(&clients_lock);
435
436 list_for_each_entry_safe(client, tmp, &clients, list) {
437 list_for_each_entry(subdev, &device->subdevs, list) {
438 if (subdev->np == client->dev->of_node) {
439 host1x_subdev_register(device, subdev, client);
440 break;
441 }
442 }
443 }
444
445 mutex_unlock(&clients_lock);
446
447 return 0;
448}
449
450/*
451 * Removes a device by first unregistering any subdevices and then removing
452 * itself from the list of devices.
453 *
454 * This function must be called with the host1x->devices_lock held.
455 */
456static void host1x_device_del(struct host1x *host1x,
457 struct host1x_device *device)
458{
Thierry Redingf4c5cf82014-12-18 15:29:14 +0100459 if (device->registered) {
460 device->registered = false;
461 device_del(&device->dev);
462 }
463
464 put_device(&device->dev);
Thierry Reding776dc382013-10-14 14:43:22 +0200465}
466
467static void host1x_attach_driver(struct host1x *host1x,
468 struct host1x_driver *driver)
469{
470 struct host1x_device *device;
471 int err;
472
473 mutex_lock(&host1x->devices_lock);
474
475 list_for_each_entry(device, &host1x->devices, list) {
476 if (device->driver == driver) {
477 mutex_unlock(&host1x->devices_lock);
478 return;
479 }
480 }
481
Thierry Reding776dc382013-10-14 14:43:22 +0200482 err = host1x_device_add(host1x, driver);
483 if (err < 0)
484 dev_err(host1x->dev, "failed to allocate device: %d\n", err);
Thierry Reding38d98de2014-12-18 15:06:56 +0100485
486 mutex_unlock(&host1x->devices_lock);
Thierry Reding776dc382013-10-14 14:43:22 +0200487}
488
489static void host1x_detach_driver(struct host1x *host1x,
490 struct host1x_driver *driver)
491{
492 struct host1x_device *device, *tmp;
493
494 mutex_lock(&host1x->devices_lock);
495
496 list_for_each_entry_safe(device, tmp, &host1x->devices, list)
497 if (device->driver == driver)
498 host1x_device_del(host1x, device);
499
500 mutex_unlock(&host1x->devices_lock);
501}
502
Thierry Reding466749f2017-04-10 12:27:01 +0200503/**
504 * host1x_register() - register a host1x controller
505 * @host1x: host1x controller
506 *
507 * The host1x controller driver uses this to register a host1x controller with
508 * the infrastructure. Note that all Tegra SoC generations have only ever come
509 * with a single host1x instance, so this function is somewhat academic.
510 */
Thierry Reding776dc382013-10-14 14:43:22 +0200511int host1x_register(struct host1x *host1x)
512{
513 struct host1x_driver *driver;
514
515 mutex_lock(&devices_lock);
516 list_add_tail(&host1x->list, &devices);
517 mutex_unlock(&devices_lock);
518
519 mutex_lock(&drivers_lock);
520
521 list_for_each_entry(driver, &drivers, list)
522 host1x_attach_driver(host1x, driver);
523
524 mutex_unlock(&drivers_lock);
525
526 return 0;
527}
528
Thierry Reding466749f2017-04-10 12:27:01 +0200529/**
530 * host1x_unregister() - unregister a host1x controller
531 * @host1x: host1x controller
532 *
533 * The host1x controller driver uses this to remove a host1x controller from
534 * the infrastructure.
535 */
Thierry Reding776dc382013-10-14 14:43:22 +0200536int host1x_unregister(struct host1x *host1x)
537{
538 struct host1x_driver *driver;
539
540 mutex_lock(&drivers_lock);
541
542 list_for_each_entry(driver, &drivers, list)
543 host1x_detach_driver(host1x, driver);
544
545 mutex_unlock(&drivers_lock);
546
547 mutex_lock(&devices_lock);
548 list_del_init(&host1x->list);
549 mutex_unlock(&devices_lock);
550
551 return 0;
552}
553
Thierry Redingb0d36da2017-03-22 19:15:18 +0100554static int host1x_device_probe(struct device *dev)
555{
556 struct host1x_driver *driver = to_host1x_driver(dev->driver);
557 struct host1x_device *device = to_host1x_device(dev);
558
559 if (driver->probe)
560 return driver->probe(device);
561
562 return 0;
563}
564
565static int host1x_device_remove(struct device *dev)
566{
567 struct host1x_driver *driver = to_host1x_driver(dev->driver);
568 struct host1x_device *device = to_host1x_device(dev);
569
570 if (driver->remove)
571 return driver->remove(device);
572
573 return 0;
574}
575
576static void host1x_device_shutdown(struct device *dev)
577{
578 struct host1x_driver *driver = to_host1x_driver(dev->driver);
579 struct host1x_device *device = to_host1x_device(dev);
580
581 if (driver->shutdown)
582 driver->shutdown(device);
583}
584
Thierry Reding466749f2017-04-10 12:27:01 +0200585/**
586 * host1x_driver_register_full() - register a host1x driver
587 * @driver: host1x driver
588 * @owner: owner module
589 *
590 * Drivers for host1x logical devices call this function to register a driver
591 * with the infrastructure. Note that since these drive logical devices, the
592 * registration of the driver actually triggers tho logical device creation.
593 * A logical device will be created for each host1x instance.
594 */
Thierry Redingf4c5cf82014-12-18 15:29:14 +0100595int host1x_driver_register_full(struct host1x_driver *driver,
596 struct module *owner)
Thierry Reding776dc382013-10-14 14:43:22 +0200597{
598 struct host1x *host1x;
599
600 INIT_LIST_HEAD(&driver->list);
601
602 mutex_lock(&drivers_lock);
603 list_add_tail(&driver->list, &drivers);
604 mutex_unlock(&drivers_lock);
605
606 mutex_lock(&devices_lock);
607
608 list_for_each_entry(host1x, &devices, list)
609 host1x_attach_driver(host1x, driver);
610
611 mutex_unlock(&devices_lock);
612
Thierry Redingf4c5cf82014-12-18 15:29:14 +0100613 driver->driver.bus = &host1x_bus_type;
614 driver->driver.owner = owner;
Thierry Redingb0d36da2017-03-22 19:15:18 +0100615 driver->driver.probe = host1x_device_probe;
616 driver->driver.remove = host1x_device_remove;
617 driver->driver.shutdown = host1x_device_shutdown;
Thierry Redingf4c5cf82014-12-18 15:29:14 +0100618
619 return driver_register(&driver->driver);
Thierry Reding776dc382013-10-14 14:43:22 +0200620}
Thierry Redingf4c5cf82014-12-18 15:29:14 +0100621EXPORT_SYMBOL(host1x_driver_register_full);
Thierry Reding776dc382013-10-14 14:43:22 +0200622
Thierry Reding466749f2017-04-10 12:27:01 +0200623/**
624 * host1x_driver_unregister() - unregister a host1x driver
625 * @driver: host1x driver
626 *
627 * Unbinds the driver from each of the host1x logical devices that it is
628 * bound to, effectively removing the subsystem devices that they represent.
629 */
Thierry Reding776dc382013-10-14 14:43:22 +0200630void host1x_driver_unregister(struct host1x_driver *driver)
631{
Thierry Redinge3e70812015-08-24 14:51:04 +0200632 driver_unregister(&driver->driver);
633
Thierry Reding776dc382013-10-14 14:43:22 +0200634 mutex_lock(&drivers_lock);
635 list_del_init(&driver->list);
636 mutex_unlock(&drivers_lock);
637}
638EXPORT_SYMBOL(host1x_driver_unregister);
639
Thierry Reding466749f2017-04-10 12:27:01 +0200640/**
641 * host1x_client_register() - register a host1x client
642 * @client: host1x client
643 *
644 * Registers a host1x client with each host1x controller instance. Note that
645 * each client will only match their parent host1x controller and will only be
646 * associated with that instance. Once all clients have been registered with
647 * their parent host1x controller, the infrastructure will set up the logical
648 * device and call host1x_device_init(), which will in turn call each client's
649 * &host1x_client_ops.init implementation.
650 */
Thierry Reding776dc382013-10-14 14:43:22 +0200651int host1x_client_register(struct host1x_client *client)
652{
653 struct host1x *host1x;
654 int err;
655
656 mutex_lock(&devices_lock);
657
658 list_for_each_entry(host1x, &devices, list) {
Thierry Reding0c7dfd32014-05-22 11:12:17 +0200659 err = host1x_add_client(host1x, client);
Thierry Reding776dc382013-10-14 14:43:22 +0200660 if (!err) {
661 mutex_unlock(&devices_lock);
662 return 0;
663 }
664 }
665
666 mutex_unlock(&devices_lock);
667
668 mutex_lock(&clients_lock);
669 list_add_tail(&client->list, &clients);
670 mutex_unlock(&clients_lock);
671
672 return 0;
673}
674EXPORT_SYMBOL(host1x_client_register);
675
Thierry Reding466749f2017-04-10 12:27:01 +0200676/**
677 * host1x_client_unregister() - unregister a host1x client
678 * @client: host1x client
679 *
680 * Removes a host1x client from its host1x controller instance. If a logical
681 * device has already been initialized, it will be torn down.
682 */
Thierry Reding776dc382013-10-14 14:43:22 +0200683int host1x_client_unregister(struct host1x_client *client)
684{
685 struct host1x_client *c;
686 struct host1x *host1x;
687 int err;
688
689 mutex_lock(&devices_lock);
690
691 list_for_each_entry(host1x, &devices, list) {
Thierry Reding0c7dfd32014-05-22 11:12:17 +0200692 err = host1x_del_client(host1x, client);
Thierry Reding776dc382013-10-14 14:43:22 +0200693 if (!err) {
694 mutex_unlock(&devices_lock);
695 return 0;
696 }
697 }
698
699 mutex_unlock(&devices_lock);
700 mutex_lock(&clients_lock);
701
702 list_for_each_entry(c, &clients, list) {
703 if (c == client) {
704 list_del_init(&c->list);
705 break;
706 }
707 }
708
709 mutex_unlock(&clients_lock);
710
711 return 0;
712}
713EXPORT_SYMBOL(host1x_client_unregister);