[PATCH v7 0/2] drm/bridge: add docs and kunit test for devm_drm_bridge_alloc()

[Luca Ceresoli <luca.ceresoli@bootlin.com>]

This small series adds documentation and a simple kunit test for the new
DRM bridge allocation flow, based on the recently introduced
devm_drm_bridge_alloc() [0].

This work was formerly a part of my v6 DRM bridge hotplug series [1], now
split as a standalone series, hence the "v7" version number.

The overall goal is supporting Linux devices with a DRM pipeline whose
final components can be hot-plugged and hot-unplugged, including one or
more bridges. For more details see the big picture [0].

Current plan and status of the DRM bridge refcounting work:

 A. ✔ add new alloc API and refcounting -> (now in drm-misc-next)
 B. convert all bridge drivers to new API (v1 under review [2])
 C. ➜ documentation, kunit tests (this series)
 D. after (B), add get/put to drm_bridge_add/remove() + attach/detech()
 E. after (B), convert accessors; this is a large work and can be done
    in chunks
 F. debugfs improvements

[0] https://gitlab.freedesktop.org/drm/misc/kernel/-/commit/0cc6aadd7fc1e629b715ea3d1ba537ef2da95eec
[1] https://lore.kernel.org/dri-devel/20250206-hotplug-drm-bridge-v6-0-9d6f2c9c3058@bootlin.com/
[2] https://lore.kernel.org/lkml/20250407-drm-bridge-convert-to-alloc-api-v1-0-42113ff8d9c0@bootlin.com/

Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>
---
Luca Ceresoli (2):
      drm/bridge: documentat bridge allocation and lifecycle
      drm/tests: bridge: add a KUnit test for devm_drm_bridge_alloc()

 Documentation/gpu/drm-kms-helpers.rst   |  6 +++
 drivers/gpu/drm/drm_bridge.c            | 73 +++++++++++++++++++++++++++++++++
 drivers/gpu/drm/tests/drm_bridge_test.c | 60 +++++++++++++++++++++++++++
 3 files changed, 139 insertions(+)
---
base-commit: e8bf4a1bdaeadb28d13b9a2bcfd5910fda06eede
change-id: 20250408-drm-bridge-alloc-doc-test-267df0def880

Best regards,
-- 
Luca Ceresoli <luca.ceresoli@bootlin.com>