From nobody Sun Feb 8 14:22:42 2026 Received: from mx.gpxsee.org (mx.gpxsee.org [37.205.14.76]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 617064F1EB; Mon, 18 Mar 2024 15:09:38 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=37.205.14.76 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1710774583; cv=none; b=VJkRHCHxieTuP+mPChrgrR05X7yBbf00fpduBCn68wzQKOFmboeyQDGMjlqeYWd9x3uRxAq5VJFsg2FOqC1gGOZOzwNFYt8ZSSMgfquU4Uz6QCEP0zeARQ4z7JJyM98IA7SU+XcLYQ8P/td4y4vRprXKb9yEK7uMv7C6ooj1MNg= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1710774583; c=relaxed/simple; bh=FipI5WsNECJeOw6c7DF39GapkTYB24oPG38+PzmCmUo=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:Content-Type; b=o13HcvXzzJwBgIGpJlv07tDTrT47GgK/2mzOe8+TJrHEf4uRF8WLH00cmrC95GE7xrBXnJFEkF8vQ3hXZX/FVukGjj7C3fxZZRMGm/fCrB7SvQ2+SoSBKIZ6RDt0KH5I58eA5EP+ePEISfcgSl8HtzBgIScpZkfweK1X7h2q6kk= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=gpxsee.org; spf=pass smtp.mailfrom=gpxsee.org; arc=none smtp.client-ip=37.205.14.76 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=gpxsee.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gpxsee.org Received: from mgb4.digiteq.red (unknown [62.77.71.229]) by mx.gpxsee.org (Postfix) with ESMTPSA id 13E7853CF0; Mon, 18 Mar 2024 16:09:32 +0100 (CET) From: tumic@gpxsee.org To: Mauro Carvalho Chehab , Hans Verkuil Cc: linux-media@vger.kernel.org, linux-kernel@vger.kernel.org, =?UTF-8?q?Martin=20T=C5=AFma?= Subject: [PATCH] media: admin-guide: Fix mgb4 driver documentation structure Date: Mon, 18 Mar 2024 17:09:19 +0100 Message-ID: <20240318160919.6144-1-tumic@gpxsee.org> X-Mailer: git-send-email 2.44.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable From: Martin T=C5=AFma Fix the mgb4 driver documentation structure that breaks the "Video4Linux (V= 4L) driver-specific documentation" outline. Signed-off-by: Martin T=C5=AFma --- Documentation/admin-guide/media/mgb4.rst | 35 ++++++++++-------------- 1 file changed, 15 insertions(+), 20 deletions(-) diff --git a/Documentation/admin-guide/media/mgb4.rst b/Documentation/admin= -guide/media/mgb4.rst index 2977f74d7e26..e434d4a9eeb3 100644 --- a/Documentation/admin-guide/media/mgb4.rst +++ b/Documentation/admin-guide/media/mgb4.rst @@ -1,8 +1,10 @@ .. SPDX-License-Identifier: GPL-2.0 =20 -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D -mgb4 sysfs interface -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +The mgb4 driver +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +sysfs interface +--------------- =20 The mgb4 driver provides a sysfs interface, that is used to configure video stream related parameters (some of them must be set properly before the v4= l2 @@ -12,9 +14,8 @@ There are two types of parameters - global / PCI card rel= ated, found under ``/sys/class/video4linux/videoX/device`` and module specific found under ``/sys/class/video4linux/videoX``. =20 - Global (PCI card) parameters -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ =20 **module_type** (R): Module type. @@ -42,9 +43,8 @@ Global (PCI card) parameters =20 where each component is a 8b number. =20 - Common FPDL3/GMSL input parameters -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ =20 **input_id** (R): Input number ID, zero based. @@ -190,9 +190,8 @@ Common FPDL3/GMSL input parameters *Note: This parameter can not be changed while the input v4l2 device is open.* =20 - Common FPDL3/GMSL output parameters -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ =20 **output_id** (R): Output number ID, zero based. @@ -282,9 +281,8 @@ Common FPDL3/GMSL output parameters Number of video lines between the end of the last valid pixel line (ma= rked by DE=3D1) and assertion of the VSYNC signal. The default value is 2. =20 - FPDL3 specific input parameters -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ =20 **fpdl3_input_width** (RW): Number of deserializer input lines. @@ -294,7 +292,7 @@ FPDL3 specific input parameters | 2 - dual =20 FPDL3 specific output parameters -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ =20 **fpdl3_output_width** (RW): Number of serializer output lines. @@ -304,7 +302,7 @@ FPDL3 specific output parameters | 2 - dual =20 GMSL specific input parameters -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ =20 **gmsl_mode** (RW): GMSL speed mode. @@ -328,10 +326,8 @@ GMSL specific input parameters | 0 - disabled | 1 - enabled (default) =20 - -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D -mgb4 mtd partitions -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +MTD partitions +-------------- =20 The mgb4 driver creates a MTD device with two partitions: - mgb4-fw.X - FPGA firmware. @@ -344,9 +340,8 @@ also have a third partition named *mgb4-flash* availabl= e in the system. This partition represents the whole, unpartitioned, card's FLASH memory and one= should not fiddle with it... =20 -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D -mgb4 iio (triggers) -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +IIO (triggers) +-------------- =20 The mgb4 driver creates an Industrial I/O (IIO) device that provides trigg= er and signal level status capability. The following scan elements are available: base-commit: b14257abe7057def6127f6fb2f14f9adc8acabdb --=20 2.44.0