mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
From: Mattijs Korpershoek <mkorpershoek@kernel.org>
To: Hans Verkuil <hverkuil+cisco@kernel.org>,
	 Laurent Pinchart <laurent.pinchart@ideasonboard.com>,
	 Kieran Bingham <kieran.bingham@ideasonboard.com>,
	 Sakari Ailus <sakari.ailus@linux.intel.com>,
	 Mauro Carvalho Chehab <mchehab@kernel.org>,
	 Andy Walls <awalls@md.metrocast.net>,
	Kees Cook <kees@kernel.org>,
	 "Gustavo A. R. Silva" <gustavoars@kernel.org>
Cc: Mattijs Korpershoek <mkorpershoek@kernel.org>,
	 Nicolas Dufresne <nicolas.dufres@collabora.com>,
	 Hans de Goede <hansg@kernel.org>,
	 Michael Riesch <michael.riesch@collabora.com>,
	 Dave Stevenson <dave.stevenson@raspberrypi.com>,
	 Maxime Ripard <mripard@kernel.org>,
	linux-media@vger.kernel.org,  linux-kernel@vger.kernel.org,
	linux-hardening@vger.kernel.org
Subject: [PATCH RFC v2 13/16] media: mc: Add MEDIA_EVENT_ENTITY_STATUS_CHANGE event
Date: Wed, 18 Nov 2026 13:43:57 +0100	[thread overview]
Message-ID: <20261118-v4l2-sensor-detect-v2-13-1bb1a445b556@kernel.org> (raw)
In-Reply-To: <20261118-v4l2-sensor-detect-v2-0-1bb1a445b556@kernel.org>

Add a media event that notifies userspace when an entity's connection
state changes. This allows userspace to react when a sensor gets
disconnected. For example, by aborting an ongoing stream.

Signed-off-by: Mattijs Korpershoek <mkorpershoek@kernel.org>
---
 .../userspace-api/media/mediactl/media-ioc-dqevent.rst         |  5 +++++
 drivers/media/mc/mc-entity.c                                   | 10 +++++++++-
 include/media/media-entity.h                                   |  3 ++-
 include/uapi/linux/media.h                                     |  7 +++++++
 4 files changed, 23 insertions(+), 2 deletions(-)

diff --git a/Documentation/userspace-api/media/mediactl/media-ioc-dqevent.rst b/Documentation/userspace-api/media/mediactl/media-ioc-dqevent.rst
index f7a2cd2675f5..2ae72523afc7 100644
--- a/Documentation/userspace-api/media/mediactl/media-ioc-dqevent.rst
+++ b/Documentation/userspace-api/media/mediactl/media-ioc-dqevent.rst
@@ -112,6 +112,11 @@ subscribe the events.
 	known to be still missing. This number may be less than the total
 	number of all missing entities. However if this number is zero, then
 	all entities have been registered to the media device.
+    * - ``MEDIA_EVENT_ENTITY_STATUS_CHANGE``
+      - 2
+      - Triggered when a media entity connection status changes. The entity
+        id is in ``entity_id`` and the status is encoded in ``status``.
+        See :ref:`MEDIA_IOC_G_ENTITY_STATUS` for details about entity status.
 
 Return Value
 ============
diff --git a/drivers/media/mc/mc-entity.c b/drivers/media/mc/mc-entity.c
index 2b5fc5d1b0a4..4c6a1c40d698 100644
--- a/drivers/media/mc/mc-entity.c
+++ b/drivers/media/mc/mc-entity.c
@@ -14,6 +14,7 @@
 #include <linux/slab.h>
 #include <media/media-entity.h>
 #include <media/media-device.h>
+#include <media/media-event.h>
 
 static inline const char *intf_type(struct media_interface *intf)
 {
@@ -1540,8 +1541,15 @@ void __media_entity_set_status(struct media_entity *entity, u32 status)
 
 	lockdep_assert_held(&mdev->graph_mutex);
 
-	if (entity->status != status)
+	if (entity->status != status) {
 		entity->status = status;
+
+		media_event_queue(mdev, &(struct media_event){
+			.type = MEDIA_EVENT_ENTITY_STATUS_CHANGE,
+			.u.entity_status.entity_id = entity->graph_obj.id,
+			.u.entity_status.status = status,
+		});
+	}
 }
 EXPORT_SYMBOL_GPL(__media_entity_set_status);
 
diff --git a/include/media/media-entity.h b/include/media/media-entity.h
index 4d66f9823c9d..b0e1fc627d17 100644
--- a/include/media/media-entity.h
+++ b/include/media/media-entity.h
@@ -1042,7 +1042,8 @@ void __media_entity_set_status(struct media_entity *entity, u32 status);
  * @status: The new status (%MEDIA_ENT_STATUS_CONNECTED or
  *	                    %MEDIA_ENT_STATUS_DISCONNECTED)
  *
- * Update the entity's connection status.
+ * Update the entity's connection status. If the status has changed, a
+ * %MEDIA_EVENT_ENTITY_STATUS_CHANGE event is queued to the media device.
  *
  * The entity must be registered with a media device. To set the initial
  * status before registration, assign entity->status directly.
diff --git a/include/uapi/linux/media.h b/include/uapi/linux/media.h
index 9f9ced3fb0e0..4ccffe7434c9 100644
--- a/include/uapi/linux/media.h
+++ b/include/uapi/linux/media.h
@@ -385,16 +385,23 @@ struct media_entity_status {
 
 #define MEDIA_EVENT_ALL			0
 #define MEDIA_EVENT_ENTITY_REGISTRATION	1
+#define MEDIA_EVENT_ENTITY_STATUS_CHANGE	2
 
 struct media_event_entity_reg {
 	__u32 entity_id;
 	__u32 pending;
 } __attribute__ ((packed));
 
+struct media_event_entity_status {
+	__u32 entity_id;
+	__u32 status;
+} __attribute__ ((packed));
+
 struct media_event {
 	__u32 type;
 	union {
 		struct media_event_entity_reg entity_reg;
+		struct media_event_entity_status entity_status;
 		__u8 data[64];
 	} u;
 	__u32 reserved[8];

-- 
2.56.0


  parent reply	other threads:[~2026-11-18 12:44 UTC|newest]

Thread overview: 17+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-11-18 12:43 [PATCH RFC v2 00/16] media: Fault-Tolerant V4L2 Mattijs Korpershoek
2026-11-18 12:43 ` [PATCH RFC v2 01/16] media: mc: Add struct media_device_fh pointer to media device IOCTL op Mattijs Korpershoek
2026-11-18 12:43 ` [PATCH RFC v2 02/16] media: mc: Add per-file-handle data support Mattijs Korpershoek
2026-11-18 12:43 ` [PATCH RFC v2 03/16] v4l: event: Separate event related information from struct v4l2_fh Mattijs Korpershoek
2026-11-18 12:43 ` [PATCH RFC v2 04/16] v4l: event: Rework data structures for separating events and V4L2 Mattijs Korpershoek
2026-11-18 12:43 ` [PATCH RFC v2 05/16] v4l: event: Split the event framework into generic and V4L2 bits Mattijs Korpershoek
2026-11-18 12:43 ` [PATCH RFC v2 06/16] media: mc: Maintain a list of open file handles in a media device Mattijs Korpershoek
2026-11-18 12:43 ` [PATCH RFC v2 07/16] media: mc: Add MEDIA_IOC_DQEVENT Mattijs Korpershoek
2026-11-18 12:43 ` [PATCH RFC v2 08/16] media: mc: Add MEDIA_EVENT_ENTITY_REGISTRATION Mattijs Korpershoek
2026-11-18 12:43 ` [PATCH RFC v2 09/16] Documentation: media: Add Media controller event documentation Mattijs Korpershoek
2026-11-18 12:43 ` [PATCH RFC v2 10/16] media: media.h: Add entity connection status Mattijs Korpershoek
2026-11-18 12:43 ` [PATCH RFC v2 11/16] media: mc: Add .detect() to media_entity_operations Mattijs Korpershoek
2026-11-18 12:43 ` [PATCH RFC v2 12/16] media: mc: Add MEDIA_IOC_G_ENTITY_STATUS ioctl Mattijs Korpershoek
2026-11-18 12:43 ` Mattijs Korpershoek [this message]
2026-11-18 12:43 ` [PATCH RFC v2 14/16] media: mc: Add detect polling helpers for drivers Mattijs Korpershoek
2026-11-18 12:43 ` [PATCH RFC v2 15/16] media: imx219: Allow driver probe with missing sensor Mattijs Korpershoek
2026-11-18 12:44 ` [PATCH RFC v2 16/16] media: imx219: Implement .detect() sensor operation Mattijs Korpershoek

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20261118-v4l2-sensor-detect-v2-13-1bb1a445b556@kernel.org \
    --to=mkorpershoek@kernel.org \
    --cc=awalls@md.metrocast.net \
    --cc=dave.stevenson@raspberrypi.com \
    --cc=gustavoars@kernel.org \
    --cc=hansg@kernel.org \
    --cc=hverkuil+cisco@kernel.org \
    --cc=kees@kernel.org \
    --cc=kieran.bingham@ideasonboard.com \
    --cc=laurent.pinchart@ideasonboard.com \
    --cc=linux-hardening@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-media@vger.kernel.org \
    --cc=mchehab@kernel.org \
    --cc=michael.riesch@collabora.com \
    --cc=mripard@kernel.org \
    --cc=nicolas.dufres@collabora.com \
    --cc=sakari.ailus@linux.intel.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox

all inboxes | Powered by JetHome®