linux/include/drm/display/drm_dp_aux_bus.h

/* SPDX-License-Identifier: GPL-2.0 */
/*
 * Copyright 2021 Google Inc.
 *
 * The DP AUX bus is used for devices that are connected over a DisplayPort
 * AUX bus. The devices on the far side of the bus are referred to as
 * endpoints in this code.
 */

#ifndef _DP_AUX_BUS_H_
#define _DP_AUX_BUS_H_

#include <linux/device.h>
#include <linux/mod_devicetable.h>

/**
 * struct dp_aux_ep_device - Main dev structure for DP AUX endpoints
 *
 * This is used to instantiate devices that are connected via a DP AUX
 * bus. Usually the device is a panel, but conceivable other devices could
 * be hooked up there.
 */
struct dp_aux_ep_device {
	/** @dev: The normal dev pointer */
	struct device dev;
	/** @aux: Pointer to the aux bus */
	struct drm_dp_aux *aux;
};

struct dp_aux_ep_driver {
	int (*probe)(struct dp_aux_ep_device *aux_ep);
	void (*remove)(struct dp_aux_ep_device *aux_ep);
	void (*shutdown)(struct dp_aux_ep_device *aux_ep);
	struct device_driver driver;
};

static inline struct dp_aux_ep_device *to_dp_aux_ep_dev(struct device *dev)
{
	return container_of(dev, struct dp_aux_ep_device, dev);
}

static inline struct dp_aux_ep_driver *to_dp_aux_ep_drv(struct device_driver *drv)
{
	return container_of(drv, struct dp_aux_ep_driver, driver);
}

int of_dp_aux_populate_bus(struct drm_dp_aux *aux,
			   int (*done_probing)(struct drm_dp_aux *aux));
void of_dp_aux_depopulate_bus(struct drm_dp_aux *aux);
int devm_of_dp_aux_populate_bus(struct drm_dp_aux *aux,
				int (*done_probing)(struct drm_dp_aux *aux));

/* Deprecated versions of the above functions. To be removed when no callers. */
static inline int of_dp_aux_populate_ep_devices(struct drm_dp_aux *aux)
{
	int ret;

	ret = of_dp_aux_populate_bus(aux, NULL);

	/* New API returns -ENODEV for no child case; adapt to old assumption */
	return (ret != -ENODEV) ? ret : 0;
}

static inline int devm_of_dp_aux_populate_ep_devices(struct drm_dp_aux *aux)
{
	int ret;

	ret = devm_of_dp_aux_populate_bus(aux, NULL);

	/* New API returns -ENODEV for no child case; adapt to old assumption */
	return (ret != -ENODEV) ? ret : 0;
}

static inline void of_dp_aux_depopulate_ep_devices(struct drm_dp_aux *aux)
{
	of_dp_aux_depopulate_bus(aux);
}

#define dp_aux_dp_driver_register(aux_ep_drv) \
	__dp_aux_dp_driver_register(aux_ep_drv, THIS_MODULE)
int __dp_aux_dp_driver_register(struct dp_aux_ep_driver *aux_ep_drv,
				struct module *owner);
void dp_aux_dp_driver_unregister(struct dp_aux_ep_driver *aux_ep_drv);

#endif /* _DP_AUX_BUS_H_ */