From patchwork Mon Feb 3 08:58:41 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sakari Ailus X-Patchwork-Id: 13957068 Received: from mgamail.intel.com (mgamail.intel.com [192.198.163.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 CCDC01FE47D for ; Mon, 3 Feb 2025 08:59:19 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=192.198.163.10 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1738573161; cv=none; b=o6VMWQ0UAd/Yh+Kv6kaLebQGaSgfxJWW/JcoSxSvXuqnPV7uOjp/p7UhyNkSz0rMiLgBrwxHkxK9MuK+VQNF8c21sxn8Rt0u3gwkSVN0qFP7ewhHmhXGl8QJnmAZDI9tdqaWZj+rQDywXEvSaWmcw6K3CEVDws1djHl+JRIychM= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1738573161; c=relaxed/simple; bh=1hEYM8/y3YkSsR//oPssUvzHYFPdQm1A4na53VRF+kw=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=YPZXLWAF1nSWisP2GHOTo8Ke7Nfb9L1k1T6wsng8yxrazH1GPDHChVhFX0Ut5lpnjuv7C5xg76aKdw8hTLe/CWb14iHFECjIoIvA/d3UwgTzzaWl9tbOEm+CDW2Ti+er2gGzeRPT7LEAj4ZvqZXEq4+4zkjQxV0Hrbm3slqlRyo= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.intel.com; spf=none smtp.mailfrom=linux.intel.com; dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com header.b=CjJTnRbI; arc=none smtp.client-ip=192.198.163.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=none 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="CjJTnRbI" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1738573160; x=1770109160; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=1hEYM8/y3YkSsR//oPssUvzHYFPdQm1A4na53VRF+kw=; b=CjJTnRbINTzk6z3ESpWC3KvqJZe297IA072lc9spxSq3OZu2BqEXhcxI QgEfCZFDaMspyYleLbge6GpnN6+/GsGoVBt1XmykLXHZARL7htktd4o2W A3B6x69uHagKed1aITBX/rXyOZf/ETAzr5mjuTOE6eZMZ5UwSyz8uJriB u14F1aFrXsMeqveLVxOYmJw3NaAJo+vE9pZRfwv9Kh6zRXBK6JCbLR2oT L3YCUY/Q/B+ZBIYWnHkygyfpnEKCf+tmC2QVOSnZbT8eWoUxSmVddLbqk 8HLZCUpUYYPjsM92YgZpV2Cr+TeLRQTqEmA4HKVhZCyqJmAlS5EJlmhMC w==; X-CSE-ConnectionGUID: Qx8+4q9eQMqTtVIEYQ8TRg== X-CSE-MsgGUID: 64VYO5zNToOtZPsYPBDWPw== X-IronPort-AV: E=McAfee;i="6700,10204,11314"; a="50472602" X-IronPort-AV: E=Sophos;i="6.12,310,1728975600"; d="scan'208";a="50472602" Received: from fmviesa008.fm.intel.com ([10.60.135.148]) by fmvoesa104.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 03 Feb 2025 00:59:20 -0800 X-CSE-ConnectionGUID: 4eTnF31WQyGi4w9pUxXGOw== X-CSE-MsgGUID: I0VLOyCiS8q5bM5pZx5Atw== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.13,255,1732608000"; d="scan'208";a="110382945" Received: from turnipsi.fi.intel.com (HELO kekkonen.fi.intel.com) ([10.237.72.44]) by fmviesa008-auth.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 03 Feb 2025 00:59:13 -0800 Received: from svinhufvud.intel.com (maa-artisokka.localdomain [192.168.240.50]) by kekkonen.fi.intel.com (Postfix) with ESMTP id 8D6B011F9C3; Mon, 3 Feb 2025 10:59:07 +0200 (EET) Organization: Intel Finland Oy - BIC 0357606-4 - Westendinkatu 7, 02160 Espoo From: Sakari Ailus To: linux-media@vger.kernel.org Cc: hverkuil@xs4all.nl, laurent.pinchart@ideasonboard.com, Prabhakar , Kate Hsuan , Alexander Shiyan , Mikhail Rudenko , Dave Stevenson , Tommaso Merciai , Umang Jain , Benjamin Mugnier , Sylvain Petinot , Christophe JAILLET , Julien Massot , Naushir Patuck , "Yan, Dongcheng" , "Cao, Bingbu" , "Qiu, Tian Shu" , "Wang, Hongju" , Stefan Klug , Mirela Rabulea , =?utf-8?q?Andr=C3=A9_Apitzsch?= , Heimir Thor Sverrisson , Kieran Bingham , Stanislaw Gruszka , Mehdi Djait , Ricardo Ribalda Delgado , Hans de Goede Subject: [RFC v5 03/15] media: Documentation: Reword split of sensor driver to two classes Date: Mon, 3 Feb 2025 10:58:41 +0200 Message-Id: <20250203085853.1361401-4-sakari.ailus@linux.intel.com> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250203085853.1361401-1-sakari.ailus@linux.intel.com> References: <20250203085853.1361401-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 The sensor drivers do not configure the output size of the sensors but the entire internal pipeline. Reflect this in the documentation. Signed-off-by: Sakari Ailus Reviewed-by: Laurent Pinchart Reviewed-by: Jacopo Mondi Reviewed-by: Tomi Valkeinen Reviewed-by: Lad Prabhakar --- .../userspace-api/media/drivers/camera-sensor.rst | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/Documentation/userspace-api/media/drivers/camera-sensor.rst b/Documentation/userspace-api/media/drivers/camera-sensor.rst index 9a1e8aa9fc77..bc55c861fb69 100644 --- a/Documentation/userspace-api/media/drivers/camera-sensor.rst +++ b/Documentation/userspace-api/media/drivers/camera-sensor.rst @@ -10,11 +10,13 @@ used to control the camera sensor drivers. You may also find :ref:`media_writing_camera_sensor_drivers` useful. -Frame size ----------- +Sensor internal pipeline configuration +-------------------------------------- -There are two distinct ways to configure the frame size produced by camera -sensors. +Camera sensors have an internal processing pipeline including cropping and +binning functionality. The sensor drivers belong to two distinct classes, freely +configurable and register list-based drivers, depending on how the driver +configures this functionality. Freely configurable camera sensor drivers ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~