In preparation for supporting DRM bridge hotplug, add an event notifier to allow interested parties to be notified about events they need to react to.
For the initial implementation of bridge hotplug, two events are needed: bridge detach (happening in drm_bridge.c) and MIPI device attach to MIPI host (happening in drm_mipi_dsi.c). For this reason implement the event notifier in a new common file that event producers can easily use to send events. Signed-off-by: Luca Ceresoli <[email protected]> --- A different approach I have considered is keeping the event notifier in drm_bridge.c (as in [0]) instead of a new centralized file. But then another notifier would be needed in drm_mipi_dsi.c for the DSI attach event. That would be particularly awkward because the designated component to implement hotplug is the drm_bridge_connector, which would then need to depend on DRM_MIPI_DSI even though it does nothing MIPI specific. [0] https://lore.kernel.org/lkml/[email protected]/ --- drivers/gpu/drm/Kconfig | 3 ++ drivers/gpu/drm/Makefile | 2 ++ drivers/gpu/drm/drm_event_notifier.c | 58 ++++++++++++++++++++++++++++++++++++ include/drm/drm_event_notifier.h | 36 ++++++++++++++++++++++ 4 files changed, 99 insertions(+) diff --git a/drivers/gpu/drm/Kconfig b/drivers/gpu/drm/Kconfig index 8f5a8d3012e4..18eb33e0e5a0 100644 --- a/drivers/gpu/drm/Kconfig +++ b/drivers/gpu/drm/Kconfig @@ -33,6 +33,9 @@ endmenu if DRM +config DRM_EVENT_NOTIFIER + tristate + config DRM_MIPI_DBI tristate depends on DRM diff --git a/drivers/gpu/drm/Makefile b/drivers/gpu/drm/Makefile index e97faabcd783..18c9cceacdaa 100644 --- a/drivers/gpu/drm/Makefile +++ b/drivers/gpu/drm/Makefile @@ -96,6 +96,8 @@ drm-$(CONFIG_DRM_PANIC_SCREEN_QR_CODE) += drm_panic_qr.o drm-$(CONFIG_DRM_RAS) += drm_ras.o drm_ras_nl.o drm_ras_genl_family.o obj-$(CONFIG_DRM) += drm.o +obj-$(CONFIG_DRM_EVENT_NOTIFIER) += drm_event_notifier.o + obj-$(CONFIG_DRM_PANEL_ORIENTATION_QUIRKS) += drm_panel_orientation_quirks.o obj-$(CONFIG_DRM_PANEL_BACKLIGHT_QUIRKS) += drm_panel_backlight_quirks.o diff --git a/drivers/gpu/drm/drm_event_notifier.c b/drivers/gpu/drm/drm_event_notifier.c new file mode 100644 index 000000000000..76af4dd4cdb0 --- /dev/null +++ b/drivers/gpu/drm/drm_event_notifier.c @@ -0,0 +1,58 @@ +// SPDX-License-Identifier: GPL-2.0 +/* + * Internal event notifier for DRM drivers + * + * Copyright (C) 2026 GE HealthCare + * Author: Luca Ceresoli <[email protected]> + */ + +#include <linux/module.h> +#include <linux/notifier.h> + +#include <drm/drm_event_notifier.h> + +static BLOCKING_NOTIFIER_HEAD(drm_event_notifier); + +/** + * drm_event_notifier_register - Register to be notified of DRM events + * @nb: the notifier block to be registered + * + * @nb will be notified of events defined in &drm_event_notifier_event + * + * Returns 0 on success, %-EEXIST on error. + */ +int drm_event_notifier_register(struct notifier_block *nb) +{ + return blocking_notifier_chain_register(&drm_event_notifier, nb); +} +EXPORT_SYMBOL(drm_event_notifier_register); + +/** + * drm_event_notifier_unregister - Unregister from be notified of DRM events + * @nb: the notifier block to be unregistered + * + * @nb will stop being notified of events defined in &drm_event_notifier_event + * + * Returns zero on success or %-ENOENT on failure. + */ +int drm_event_notifier_unregister(struct notifier_block *nb) +{ + return blocking_notifier_chain_unregister(&drm_event_notifier, nb); +} +EXPORT_SYMBOL(drm_event_notifier_unregister); + +/** + * drm_event_notifier_notify - Emit an event to be notified to registered + * entities + * @event: event ID as defined in &drm_event_notifier_event + * @data: metadata associated to the event + */ +void drm_event_notifier_notify(unsigned long event, void *data) +{ + blocking_notifier_call_chain(&drm_event_notifier, event, data); +} +EXPORT_SYMBOL(drm_event_notifier_notify); + +MODULE_LICENSE("GPL"); +MODULE_AUTHOR("Luca Ceresoli <[email protected]>"); +MODULE_DESCRIPTION("Notifier for DRM components addition/removal and attach/detach"); diff --git a/include/drm/drm_event_notifier.h b/include/drm/drm_event_notifier.h new file mode 100644 index 000000000000..78afc014ec9a --- /dev/null +++ b/include/drm/drm_event_notifier.h @@ -0,0 +1,36 @@ +/* SPDX-License-Identifier: GPL-2.0-only */ +/* + * Internal event notifier for DRM drivers + * + * Copyright (C) 2026 GE HealthCare + * Author: Luca Ceresoli <[email protected]> + */ + +#ifndef _DRM_EVENT_NOTIFIER_H_ +#define _DRM_EVENT_NOTIFIER_H_ + +/** + * enum drm_event_notifier_event - DRM bridge events + */ +enum drm_event_notifier_event { + /** + * @DRM_MIPI_DSI_ATTACHED: A MIPI DSI device has just been attached + * to its MIPI DSI host. @data is a pointer to the &struct + * mipi_dsi_device that has just attached. + */ + DRM_MIPI_DSI_ATTACHED, + /** + * @DRM_BRIDGE_NOTIFY_DETACHED: A bridge has just been detached + * from the encoder bridge chain. Emitted at the end of + * drm_bridge_detach(), after removing the bridge from the encoder + * chain. @data is a pointer to the &struct drm_bridge that has + * just been detached. + */ + DRM_BRIDGE_DETACHED, +}; + +int drm_event_notifier_register(struct notifier_block *nb); +int drm_event_notifier_unregister(struct notifier_block *nb); +void drm_event_notifier_notify(unsigned long event, void *data); + +#endif /* _DRM_EVENT_NOTIFIER_H_ */ -- 2.54.0
