| 1 |
/* SPDX-License-Identifier: GPL-2.0 */ |
| 2 |
/* |
| 3 |
* Copyright 2021 Google Inc. |
| 4 |
* |
| 5 |
* The DP AUX bus is used for devices that are connected over a DisplayPort |
| 6 |
* AUX bus. The devices on the far side of the bus are referred to as |
| 7 |
* endpoints in this code. |
| 8 |
*/ |
| 9 |
|
| 10 |
#ifndef _DP_AUX_BUS_H_ |
| 11 |
#define _DP_AUX_BUS_H_ |
| 12 |
|
| 13 |
#include <linux/device.h> |
| 14 |
#include <linux/mod_devicetable.h> |
| 15 |
|
| 16 |
/** |
| 17 |
* struct dp_aux_ep_device - Main dev structure for DP AUX endpoints |
| 18 |
* |
| 19 |
* This is used to instantiate devices that are connected via a DP AUX |
| 20 |
* bus. Usually the device is a panel, but conceivable other devices could |
| 21 |
* be hooked up there. |
| 22 |
*/ |
| 23 |
struct dp_aux_ep_device { |
| 24 |
/** @dev: The normal dev pointer */ |
| 25 |
struct device dev; |
| 26 |
/** @aux: Pointer to the aux bus */ |
| 27 |
struct drm_dp_aux *aux; |
| 28 |
}; |
| 29 |
|
| 30 |
struct dp_aux_ep_driver { |
| 31 |
int (*probe)(struct dp_aux_ep_device *aux_ep); |
| 32 |
void (*remove)(struct dp_aux_ep_device *aux_ep); |
| 33 |
void (*shutdown)(struct dp_aux_ep_device *aux_ep); |
| 34 |
struct device_driver driver; |
| 35 |
}; |
| 36 |
|
| 37 |
static inline struct dp_aux_ep_device *to_dp_aux_ep_dev(struct device *dev) |
| 38 |
{ |
| 39 |
return container_of(dev, struct dp_aux_ep_device, dev); |
| 40 |
} |
| 41 |
|
| 42 |
static inline struct dp_aux_ep_driver *to_dp_aux_ep_drv(struct device_driver *drv) |
| 43 |
{ |
| 44 |
return container_of(drv, struct dp_aux_ep_driver, driver); |
| 45 |
} |
| 46 |
|
| 47 |
int of_dp_aux_populate_bus(struct drm_dp_aux *aux, |
| 48 |
int (*done_probing)(struct drm_dp_aux *aux)); |
| 49 |
void of_dp_aux_depopulate_bus(struct drm_dp_aux *aux); |
| 50 |
int devm_of_dp_aux_populate_bus(struct drm_dp_aux *aux, |
| 51 |
int (*done_probing)(struct drm_dp_aux *aux)); |
| 52 |
|
| 53 |
/* Deprecated versions of the above functions. To be removed when no callers. */ |
| 54 |
static inline int of_dp_aux_populate_ep_devices(struct drm_dp_aux *aux) |
| 55 |
{ |
| 56 |
int ret; |
| 57 |
|
| 58 |
ret = of_dp_aux_populate_bus(aux, NULL); |
| 59 |
|
| 60 |
/* New API returns -ENODEV for no child case; adapt to old assumption */ |
| 61 |
return (ret != -ENODEV) ? ret : 0; |
| 62 |
} |
| 63 |
|
| 64 |
static inline int devm_of_dp_aux_populate_ep_devices(struct drm_dp_aux *aux) |
| 65 |
{ |
| 66 |
int ret; |
| 67 |
|
| 68 |
ret = devm_of_dp_aux_populate_bus(aux, NULL); |
| 69 |
|
| 70 |
/* New API returns -ENODEV for no child case; adapt to old assumption */ |
| 71 |
return (ret != -ENODEV) ? ret : 0; |
| 72 |
} |
| 73 |
|
| 74 |
static inline void of_dp_aux_depopulate_ep_devices(struct drm_dp_aux *aux) |
| 75 |
{ |
| 76 |
of_dp_aux_depopulate_bus(aux); |
| 77 |
} |
| 78 |
|
| 79 |
#define dp_aux_dp_driver_register(aux_ep_drv) \ |
| 80 |
__dp_aux_dp_driver_register(aux_ep_drv, THIS_MODULE) |
| 81 |
int __dp_aux_dp_driver_register(struct dp_aux_ep_driver *aux_ep_drv, |
| 82 |
struct module *owner); |
| 83 |
void dp_aux_dp_driver_unregister(struct dp_aux_ep_driver *aux_ep_drv); |
| 84 |
|
| 85 |
#endif /* _DP_AUX_BUS_H_ */ |