From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mgamail.intel.com (mgamail.intel.com [198.175.65.10]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 3003C3D88E1 for ; Wed, 8 Apr 2026 15:40:26 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.175.65.10 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1775662829; cv=none; b=KalJnn+jcn0PldFk6kq9p3JKzuFq7mHd8aCQhZRvbQf2V4Y5zi0oTnY5MRdETz4SdHBjMXEf/ap/bhFx2KB7pSmIbG28QiKCdt9wfw8wGZDtyBmS7mhnpdhJwcDalpXwUnGcpC1Ee0TOO99TijhRZsxBUy2zp7KhC9+JY3rkv0E= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1775662829; c=relaxed/simple; bh=fLE2L9wVPZbgOglahBC2yifL9AoLHijzvqlQUVhRg2w=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=JBB/pw5x52VFUmEQGeAGi2hMT4P458pNw67psJDLJjd4ma4iYZpVDlqwLqihd+8XtyvTRRC9UPnkd66CytaW2YmszHycrXrYPmtjaJcvNblLR4hlnDirhICjVq/d/3H/TfdAuHv4ipAsZuhgZeLd+RHXMtDIyU+5DvhURkj3Duk= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.intel.com; spf=pass smtp.mailfrom=linux.intel.com; dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com header.b=ZXMGxccH; arc=none smtp.client-ip=198.175.65.10 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.intel.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linux.intel.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com header.b="ZXMGxccH" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1775662827; x=1807198827; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=fLE2L9wVPZbgOglahBC2yifL9AoLHijzvqlQUVhRg2w=; b=ZXMGxccHIwYYnyTMTp6xxH8WbNiyg1dicc6GzjG3xaz/9IOpNJxrDrZz 7lJDQBR+3G3RCQ73a1RGbRig/WyOtzfu90cfkcwDA87hJwQnX8S8DIOLT F9dZVczESsbdSd8WiExFw0wMDVulnMe40kPVu3Vf/YLTvfUC6/aLAdllj tw5f5UAAuin/CXahW1v6XRrTlwhJ8+H+2KPyNp7BD2s1XM2VUozqnrhR/ mu/t+tf81TG1cLpnZV3b6Tn8ClMwn0k/BcwwaAzppW77kaitw6eiuGCYo OSblsDdCz5eyR3YPTJ40lW0a2bAezqAjbtA1PO8ucSRA+nqq71KEhPVYW Q==; X-CSE-ConnectionGUID: 5CxR+2zTQ2e/C3o6sTQ/tQ== X-CSE-MsgGUID: yJufMIlLQU+c92fWnnafqw== X-IronPort-AV: E=McAfee;i="6800,10657,11753"; a="94038526" X-IronPort-AV: E=Sophos;i="6.23,167,1770624000"; d="scan'208";a="94038526" Received: from fmviesa006.fm.intel.com ([10.60.135.146]) by orvoesa102.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 08 Apr 2026 08:40:02 -0700 X-CSE-ConnectionGUID: DU65cD8HR1SQdyajJUzU3w== X-CSE-MsgGUID: z5Jyiko9SMKgxn2Dg4qOZQ== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.23,167,1770624000"; d="scan'208";a="223740396" Received: from hrotuna-mobl2.ger.corp.intel.com (HELO kekkonen.fi.intel.com) ([10.245.245.104]) by fmviesa006-auth.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 08 Apr 2026 08:39:53 -0700 Received: from punajuuri.localdomain (unknown [192.168.240.130]) by kekkonen.fi.intel.com (Postfix) with ESMTP id 387741220BD; Wed, 08 Apr 2026 18:39:51 +0300 (EEST) Received: from sailus by punajuuri.localdomain with local (Exim 4.98.2) (envelope-from ) id 1wAV0F-000000044Dj-2iG1; Wed, 08 Apr 2026 18:39:39 +0300 Organization: Intel Finland Oy - BIC 0357606-4 - c/o Alberga Business Park, 6 krs, Bertel Jungin Aukio 5, 02600 Espoo From: Sakari Ailus To: linux-media@vger.kernel.org Cc: hans@jjverkuil.nl, laurent.pinchart@ideasonboard.com, Prabhakar , Kate Hsuan , Dave Stevenson , Tommaso Merciai , Benjamin Mugnier , Sylvain Petinot , Christophe JAILLET , Julien Massot , Naushir Patuck , "Yan, Dongcheng" , "Cao, Bingbu" , "Qiu, Tian Shu" , Stefan Klug , Mirela Rabulea , =?UTF-8?q?Andr=C3=A9=20Apitzsch?= , Heimir Thor Sverrisson , Kieran Bingham , Mehdi Djait , Ricardo Ribalda Delgado , Hans de Goede , Jacopo Mondi , Tomi Valkeinen , David Plowman , "Yu, Ong Hock" , "Ng, Khai Wen" , Jai Luthra , Rishikesh Donadkar Subject: [PATCH v4 22/29] media: mc: Add MEDIA_LNK_FL_VALIDATE_LATE Date: Wed, 8 Apr 2026 18:39:31 +0300 Message-ID: <20260408153939.969381-23-sakari.ailus@linux.intel.com> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20260408153939.969381-1-sakari.ailus@linux.intel.com> References: <20260408153939.969381-1-sakari.ailus@linux.intel.com> Precedence: bulk X-Mailing-List: linux-media@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Add MEDIA_LNK_FL_VALIDATE_LATE flag to support late validation of links. This is serving the use case where video devices are configured and started streaming indepenently of each other but this sequence may be run in series, in such a way that a video device in a pipeline starts streaming before another one is configured. Before this flag, drivers have resorted to implementing the link validation separately for the video nodes as part of streaming start sequence. media_pipeline_start() shall be called on each leaf entity connected to the graph with a link where MEDIA_LNK_FL_VALIDATE_LATE is set before uphardware operation. Signed-off-by: Sakari Ailus --- .../media/mediactl/media-ioc-setup-link.rst | 4 + .../media/mediactl/media-types.rst | 5 ++ drivers/media/mc/mc-entity.c | 82 ++++++++++++++++++- include/uapi/linux/media.h | 1 + 4 files changed, 88 insertions(+), 4 deletions(-) diff --git a/Documentation/userspace-api/media/mediactl/media-ioc-setup-link.rst b/Documentation/userspace-api/media/mediactl/media-ioc-setup-link.rst index 23208300cb61..7c2bced57e77 100644 --- a/Documentation/userspace-api/media/mediactl/media-ioc-setup-link.rst +++ b/Documentation/userspace-api/media/mediactl/media-ioc-setup-link.rst @@ -49,6 +49,10 @@ Only links marked with the ``DYNAMIC`` link flag can be enabled/disabled while streaming media data. Attempting to enable or disable a streaming non-dynamic link will return an ``EBUSY`` error code. +Pipeline validation may be delayed for links marked with the ``VALIDATE_LATE`` +flag until actual hardware operation even if the rest of the pipeline would be +validated at an earlier point of time. + If the specified link can't be found the driver returns with an ``EINVAL`` error code. diff --git a/Documentation/userspace-api/media/mediactl/media-types.rst b/Documentation/userspace-api/media/mediactl/media-types.rst index 6332e8395263..d6a690655a01 100644 --- a/Documentation/userspace-api/media/mediactl/media-types.rst +++ b/Documentation/userspace-api/media/mediactl/media-types.rst @@ -391,6 +391,7 @@ must be set for every pad. .. _MEDIA-LNK-FL-ENABLED: .. _MEDIA-LNK-FL-IMMUTABLE: .. _MEDIA-LNK-FL-DYNAMIC: +.. _MEDIA-LNK-FL-VALIDATE-LATE: .. _MEDIA-LNK-FL-LINK-TYPE: .. flat-table:: Media link flags @@ -410,6 +411,10 @@ must be set for every pad. - The link enabled state can be modified during streaming. This flag is set by drivers and is read-only for applications. + * - ``MEDIA_LNK_FL_VALIDATE_LATE`` + - The validation of the link may be delayed up to until the start of + hardware operation. + * - ``MEDIA_LNK_FL_LINK_TYPE`` - This is a bitmask that defines the type of the link. The following link types are currently supported: diff --git a/drivers/media/mc/mc-entity.c b/drivers/media/mc/mc-entity.c index 287eded356bb..5b0162f81425 100644 --- a/drivers/media/mc/mc-entity.c +++ b/drivers/media/mc/mc-entity.c @@ -771,7 +771,7 @@ static int media_pipeline_populate(struct media_pipeline *pipe, static int __media_pipeline_validate_one(struct media_pad *origin, struct media_pad *pad, struct media_link *link, - bool *has_enabled_link) + bool *has_enabled_link, bool skip_validation) { struct media_device *mdev = origin->graph_obj.mdev; struct media_entity *entity = pad->entity; @@ -784,6 +784,9 @@ __media_pipeline_validate_one(struct media_pad *origin, if (has_enabled_link) *has_enabled_link = true; + if (skip_validation) + return 0; + /* Skip validation if the current pad isn't the sink pad of the link. */ if (link->sink != pad) return 0; @@ -825,11 +828,48 @@ __must_check int __media_pipeline_start(struct media_pad *origin, return -EINVAL; /* - * If the pipeline has already been started, it is guaranteed to be - * valid, so just increase the start count. + * Increase start count on pipelines that have been validated + * earlier. Also check links with the VALIDATE_LATE flag here. */ if (pipe->start_count) { + struct media_link *link; + + link = __media_entity_next_link(origin->entity, NULL, + MEDIA_LNK_FL_DATA_LINK); + if (link && link->flags & MEDIA_LNK_FL_VALIDATE_LATE) { + struct media_link *link2 = + __media_entity_next_link(origin->entity, link, + MEDIA_LNK_FL_DATA_LINK); + bool has_enabled_link = false; + + /* + * Only a single pad is allowed for VALIDATE_LATE + * links. That pad needs to have exactly one link. + */ + if (origin->entity->num_pads != 1) + return -EINVAL; + + if (!link || link2) + return -EINVAL; + + dev_dbg(mdev->dev, + "Validating pad '%s':%u late\n", + origin->entity->name, origin->index); + + ret = __media_pipeline_validate_one(link->sink, + link->sink, link, + &has_enabled_link, + false); + if (ret) + return ret; + + if (origin->flags & MEDIA_PAD_FL_MUST_CONNECT && + !has_enabled_link) + return -ENOLINK; + } + pipe->start_count++; + return 0; } @@ -873,12 +913,19 @@ __must_check int __media_pipeline_start(struct media_pad *origin, * the connected sink pad to avoid duplicating checks. */ for_each_media_entity_data_link(entity, link) { + /* Skip late-validated links not connected to origin. */ + bool skip_validation = + link->flags & MEDIA_LNK_FL_VALIDATE_LATE && + link->sink != origin && + link->source != origin; + /* Skip links unrelated to the current pad. */ if (link->sink != pad && link->source != pad) continue; ret = __media_pipeline_validate_one(origin, pad, link, - &has_enabled_link); + &has_enabled_link, + skip_validation); if (ret) goto error; } @@ -1158,6 +1205,33 @@ media_create_pad_link(struct media_entity *source, u16 source_pad, if (WARN_ON(!(sink->pads[sink_pad].flags & MEDIA_PAD_FL_SINK))) return -EINVAL; + /* + * With the late validate flag, either source or sink shall have exactly + * one pad and no links before this one. Similarly, no links may be + * added to entities with a single pad and an existing late-validated + * link. + */ + if (flags & MEDIA_LNK_FL_VALIDATE_LATE) { + if (!(source->num_pads == 1 && !source->num_links) && + !(sink->num_pads == 1 && !sink->num_links)) + return -EINVAL; + } else { + struct media_entity *entities[] = { source, sink }; + + for (unsigned int i = 0; i < ARRAY_SIZE(entities); i++) { + if (entities[i]->num_pads != 1) + continue; + + struct media_link *__link = + __media_entity_next_link(entities[i], NULL, + MEDIA_LNK_FL_DATA_LINK); + + if (__link && + __link->flags & MEDIA_LNK_FL_VALIDATE_LATE) + return -EINVAL; + } + } + link = media_add_link(&source->links); if (link == NULL) return -ENOMEM; diff --git a/include/uapi/linux/media.h b/include/uapi/linux/media.h index 1c80b1d6bbaf..c96e2118ea99 100644 --- a/include/uapi/linux/media.h +++ b/include/uapi/linux/media.h @@ -219,6 +219,7 @@ struct media_pad_desc { #define MEDIA_LNK_FL_ENABLED (1U << 0) #define MEDIA_LNK_FL_IMMUTABLE (1U << 1) #define MEDIA_LNK_FL_DYNAMIC (1U << 2) +#define MEDIA_LNK_FL_VALIDATE_LATE (1U << 3) #define MEDIA_LNK_FL_LINK_TYPE (0xf << 28) # define MEDIA_LNK_FL_DATA_LINK (0U << 28) -- 2.47.3