From patchwork Fri Dec 20 13:24:13 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sakari Ailus X-Patchwork-Id: 852678 Received: from mgamail.intel.com (mgamail.intel.com [192.198.163.9]) (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 2B24F215707 for ; Fri, 20 Dec 2024 13:24:43 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=192.198.163.9 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1734701084; cv=none; b=Mpwa5T8+xqrELtfZduk3504SM44aqNiCMmhNup6OUqyuNYiOEV/hcCIDCq5pDDLu316ouOv3VK2dFY+wYvrocsZjQ91nIZfgAT3qXyDEHHminW0UsA+QpleHM2PMRr2EbWeZoovv6D+3m0ZxN1GFdJ/CeWgXUyZiWrS77dTlijQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1734701084; c=relaxed/simple; bh=iBppAmcg/4oeQmFNol3/v5Tdg5CR//+q6p+zX2mWQUI=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=EZjhv+gWD5W52S7p/ohf+WHKHRU1x2g+Fq3Jij98o71U7aOKLnycxdKMQiX8tRsMnU/CxzYRM4e5O0B56JtgzVWTP8Qapow3+xONQOCe6o0feuNy2bkEG/wMwVH2nvZ9sDHQEzvXG8Z0DHyMT3NB5wZ6gallhwUN+9K5GGd1UyI= 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=YNG5+icO; arc=none smtp.client-ip=192.198.163.9 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="YNG5+icO" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1734701083; x=1766237083; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=iBppAmcg/4oeQmFNol3/v5Tdg5CR//+q6p+zX2mWQUI=; b=YNG5+icO9IzUDa2R/Ba5oSE4/zrOzGd4wc0ke8XO2D0SiIJeGb2saoIC rrOjQ45F0wypKcL853muIzQbHy/22wAkm9wzs4GJUrOEEN/tni0KXybaP FMCkorv7UIoXLkAiA33ntRw8MMHLwQq8PQX4hWkp/O87yO1sFmzF54rYi 0x+uBai5pHDYCARjeD8HlxucMXGFViUyne/lzGnnwawF0Ee2mdAqZscfO snJBRESy4KxX7wfnw9l9bXD2oVjklojKqlWBI1Y6T7ljrKly6w1h4kJe/ EgpKMKFitScAHjG0hH0LU+sdEfCeXfLSqBfSXF5NWSfcHDXWZ4xzNPt4i Q==; X-CSE-ConnectionGUID: O10yUD4ESeWyeY1txE9CcA== X-CSE-MsgGUID: vJqxlqOcTm62NFIcIMoMMQ== X-IronPort-AV: E=McAfee;i="6700,10204,11292"; a="45937583" X-IronPort-AV: E=Sophos;i="6.12,250,1728975600"; d="scan'208";a="45937583" Received: from fmviesa007.fm.intel.com ([10.60.135.147]) by fmvoesa103.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 20 Dec 2024 05:24:43 -0800 X-CSE-ConnectionGUID: sRA5njW9Q8mot5Gut8EaSA== X-CSE-MsgGUID: nvhYWyR9TgK6UwwF9N6mYA== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.12,250,1728975600"; d="scan'208";a="98333251" Received: from turnipsi.fi.intel.com (HELO kekkonen.fi.intel.com) ([10.237.72.44]) by fmviesa007-auth.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 20 Dec 2024 05:24:37 -0800 Received: from svinhufvud.intel.com (maa-artisokka.localdomain [192.168.240.50]) by kekkonen.fi.intel.com (Postfix) with ESMTP id 28513120B3E; Fri, 20 Dec 2024 15:24:32 +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 Subject: [RFC v4 3/9] media: Documentation: Reword split of sensor driver to two classes Date: Fri, 20 Dec 2024 15:24:13 +0200 Message-Id: <20241220132419.1027206-4-sakari.ailus@linux.intel.com> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20241220132419.1027206-1-sakari.ailus@linux.intel.com> References: <20241220132419.1027206-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 --- .../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 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~