Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:6 as permitted sender) client-ip=2620:137:e000::3:6;
Date:   Thu, 19 Oct 2023 17:33:27 +0200
From:   Paul Kocialkowski <paul.kocialkowski@bootlin.com>
To:     Mehdi Djait <mehdi.djait@bootlin.com>
Cc:     mchehab@kernel.org, heiko@sntech.de, hverkuil-cisco@xs4all.nl,
        krzysztof.kozlowski+dt@linaro.org, robh+dt@kernel.org,
        conor+dt@kernel.org, ezequiel@vanguardiasur.com.ar,
        linux-media@vger.kernel.org, devicetree@vger.kernel.org,
        linux-kernel@vger.kernel.org, thomas.petazzoni@bootlin.com,
        alexandre.belloni@bootlin.com, maxime.chevallier@bootlin.com
Subject: Re: [PATCH v8 0/3] media: rockchip: Add a driver for Rockchip's
 camera interface
Message-ID: <ZTFMR7PlcQXpeoQO@aptenodytes>
References: <cover.1697446303.git.mehdi.djait@bootlin.com>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
        protocol="application/pgp-signature"; boundary="Q1VB5kuawAMoF08n"
Content-Disposition: inline
In-Reply-To: <cover.1697446303.git.mehdi.djait@bootlin.com>
Precedence: bulk


--Q1VB5kuawAMoF08n
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

Hi Mehdi,

On Mon 16 Oct 23, 11:00, Mehdi Djait wrote:
> In the BSP, this driver is known as the "cif" driver, but this was
> renamed to "vip" to better fit the controller denomination in the
> datasheet.

So I have spent a bit of time trying to figure out the history of this unit
and in which platform in was used. The takeaway is that the earliest Rockch=
ip
SoC that uses it is the RK3066 (2012) and the latest SoC is the RK3566/RK35=
68
(2020). Earlier SoCs (RK29) do mention VIP but seems quite clear that this =
is
a whole different unit and the recent RK3588 (2021) has a new VICAP_DVP unit
(mixed with VICAP_MIPI) which also seems significantly different.

Over the course of the existence of this unit, it is most often referred to
as CIF. Since this is also the name for the driver in the Rockchip tree,
I feel like it is best to use CIF as the mainline terminology instead of VI=
P.
Note that the unit is also called VICAP in RK3566/RK3568.

Here is the detail of my research on the concerned chips. The + at the begi=
nning
of the line indicate support in Rockchip's 4.4 tree:

- RK3566/RK3568 (2020): CIF pins + VICAP terminology
+ RK1808 (2019): CIF pins + VIP registers + VIP_MIPI registers
+ PX30 (2017): VIP pins + VIP registers
+ RK3328 (2017): CIF pins + VIP terminology
- RK3326 (2017): CIF pins + VIP terminology
- RK3399 (2016): CIF pins
- RK3368 (2015): CIF pins
- PX2 (2014-11): CIF pins + CIF registers
+ RK3126/RK3128 (2014-10): CIF pins + registers
+ RK3288 (2014-05): CIF pins + VIP terminology
- RK3026 (2013): CIF pins + CIF registers
- RK3168/RK3188/PX3 (2012): CIF pins + CIF registers
- RK3066 (2012): CIF pins + CIF registers

Note that there are a few variations over time (added/removed registers), b=
ut
the offsets of crucial registers are always the same, so we can safely
assume this is the same unit in different generations.

Since the RK3066 is the first model starting the RK30 lineup I think we can
safely use that for the "base" compatible to be used for e.g. the bindings
document, instead of px30 which is just one of the many SoCs that use this =
unit.

Cheers,

Paul

> This version of the driver supports ONLY the parallel interface BT656
> and was tested/implemented using an SDTV video decoder
>=20
> media_tree, base-commit: 2c1bae27df787c9535e48cc27bbd11c3c3e0a235
>=20
> V7 =3D> V8:
> vip/capture.c:
> - fixed a warning: unused variable reported by the kernel test robot
>=20
> V6 =3D> V7:
> vip/capture.c vip/dev.c vip/dev.h
> - renamed all struct rk_vip_dev dev =3D> struct rk_vip_dev vip_dev
> - added some error when rk_vip_get_buffer() returns NULL
> - removed a WARN_ON
> - made the irq NOT shared
> - dropped of_match_ptr
> - added the rk_vip_get_resource() function
>=20
> rockchip,px30-vip.yaml:
> - changed filename to match the compatible
> - dropped the mention of the other rockchip SoC in the dt-binding
>   description and added a more detailed description of VIP
> - removed unused labels in the example
>=20
>=20
> V5 [1] =3D> V6:
> vip/capture.c vip/dev.c vip/dev.h
> - added a video g_input_status subdev call, V4L2_IN_CAP_STD and the
>   supported stds in rk_vip_enum_input callback
> - added rk_vip_g_std, rk_vip_s_std and rk_vip_querystd callbacks
> - added the supported video_device->tvnorms
> - s_std will now update the format as this depends on the standard
>   NTSC/PAL (as suggested by Hans in [1])
> - removed STD_ATSC
> - moved the colorimetry information to come from the subdev
> - removed the core s_power subdev calls
> - dropped cropping in rk_vip_stream struct
>=20
> rockchip-vip.yaml:
> - fixed a mistake in the name of third clock plckin -> plck
> - changed the reg maxItems 2 -> 1
>=20
> [1] https://lore.kernel.org/linux-media/20201229161724.511102-1-maxime.ch=
evallier@bootlin.com/
>=20
> I used v4l-utils with HEAD: commit 1ee258e5bb91a12df378e19eb255c5219d6bc3=
6b
>=20
> # v4l2-compliance=20
> v4l2-compliance 1.25.0, 64 bits, 64-bit time_t
>=20
> Compliance test for rk_vip device /dev/video0:
>=20
> Driver Info:
>         Driver name      : rk_vip
>         Card type        : rk_vip
>         Bus info         : platform:ff490000.vip
>         Driver version   : 6.6.0
>         Capabilities     : 0x84201000
>                 Video Capture Multiplanar
>                 Streaming
>                 Extended Pix Format
>                 Device Capabilities
>         Device Caps      : 0x04201000
>                 Video Capture Multiplanar
>                 Streaming
>                 Extended Pix Format
> Media Driver Info:
>         Driver name      : rk_vip
>         Model            : rk_vip
>         Serial           :=20
>         Bus info         : platform:ff490000.vip
>         Media version    : 6.6.0
>         Hardware revision: 0x00000000 (0)
>         Driver version   : 6.6.0
> Interface Info:
>         ID               : 0x03000002
>         Type             : V4L Video
> Entity Info:
>         ID               : 0x00000001 (1)
>         Name             : video_rkvip
>         Function         : V4L2 I/O
>         Pad 0x01000004   : 0: Sink
>           Link 0x02000009: from remote pad 0x1000006 of entity 'tw9900 2-=
0044' (Digital Video Decoder): Data, Enabled
>=20
> Required ioctls:
>         test MC information (see 'Media Driver Info' above): OK
>         test VIDIOC_QUERYCAP: OK
>         test invalid ioctls: OK
>=20
> Allow for multiple opens:
>         test second /dev/video0 open: OK
>         test VIDIOC_QUERYCAP: OK
>         test VIDIOC_G/S_PRIORITY: OK
>         test for unlimited opens: OK
>=20
> Debug ioctls:
>         test VIDIOC_DBG_G/S_REGISTER: OK (Not Supported)
>         test VIDIOC_LOG_STATUS: OK (Not Supported)
>=20
> Input ioctls:
>         test VIDIOC_G/S_TUNER/ENUM_FREQ_BANDS: OK (Not Supported)
>         test VIDIOC_G/S_FREQUENCY: OK (Not Supported)
>         test VIDIOC_S_HW_FREQ_SEEK: OK (Not Supported)
>         test VIDIOC_ENUMAUDIO: OK (Not Supported)
>         test VIDIOC_G/S/ENUMINPUT: OK
>         test VIDIOC_G/S_AUDIO: OK (Not Supported)
>         Inputs: 1 Audio Inputs: 0 Tuners: 0
>=20
> Output ioctls:
>         test VIDIOC_G/S_MODULATOR: OK (Not Supported)
>         test VIDIOC_G/S_FREQUENCY: OK (Not Supported)
>         test VIDIOC_ENUMAUDOUT: OK (Not Supported)
>         test VIDIOC_G/S/ENUMOUTPUT: OK (Not Supported)
>         test VIDIOC_G/S_AUDOUT: OK (Not Supported)
>         Outputs: 0 Audio Outputs: 0 Modulators: 0
>=20
> Input/Output configuration ioctls:
>         test VIDIOC_ENUM/G/S/QUERY_STD: OK
>         test VIDIOC_ENUM/G/S/QUERY_DV_TIMINGS: OK (Not Supported)
>         test VIDIOC_DV_TIMINGS_CAP: OK (Not Supported)
>         test VIDIOC_G/S_EDID: OK (Not Supported)
>=20
> Control ioctls (Input 0):
>         test VIDIOC_QUERY_EXT_CTRL/QUERYMENU: OK (Not Supported)
>         test VIDIOC_QUERYCTRL: OK (Not Supported)
>         test VIDIOC_G/S_CTRL: OK (Not Supported)
>         test VIDIOC_G/S/TRY_EXT_CTRLS: OK (Not Supported)
>         test VIDIOC_(UN)SUBSCRIBE_EVENT/DQEVENT: OK (Not Supported)
>         test VIDIOC_G/S_JPEGCOMP: OK (Not Supported)
>         Standard Controls: 0 Private Controls: 0
>=20
> Format ioctls (Input 0):
>         test VIDIOC_ENUM_FMT/FRAMESIZES/FRAMEINTERVALS: OK
>         test VIDIOC_G/S_PARM: OK (Not Supported)
>         test VIDIOC_G_FBUF: OK (Not Supported)
>         test VIDIOC_G_FMT: OK
>         test VIDIOC_TRY_FMT: OK
>         test VIDIOC_S_FMT: OK
>         test VIDIOC_G_SLICED_VBI_CAP: OK (Not Supported)
>         test Cropping: OK (Not Supported)
>         test Composing: OK (Not Supported)
>         test Scaling: OK (Not Supported)
>=20
> Codec ioctls (Input 0):
>         test VIDIOC_(TRY_)ENCODER_CMD: OK (Not Supported)
>         test VIDIOC_G_ENC_INDEX: OK (Not Supported)
>         test VIDIOC_(TRY_)DECODER_CMD: OK (Not Supported)
>=20
> Buffer ioctls (Input 0):
>         test VIDIOC_REQBUFS/CREATE_BUFS/QUERYBUF: OK
>         test VIDIOC_EXPBUF: OK
>         test Requests: OK (Not Supported)
>=20
> Total for rk_vip device /dev/video0: 46, Succeeded: 46, Failed: 0, Warnin=
gs: 0
>=20
> Mehdi Djait (3):
>   media: dt-bindings: media: add bindings for Rockchip VIP
>   media: rockchip: Add a driver for Rockhip's camera interface
>   arm64: dts: rockchip: Add the camera interface
>=20
>  .../bindings/media/rockchip,px30-vip.yaml     |   93 ++
>  arch/arm64/boot/dts/rockchip/px30.dtsi        |   12 +
>  drivers/media/platform/rockchip/Kconfig       |    1 +
>  drivers/media/platform/rockchip/Makefile      |    1 +
>  drivers/media/platform/rockchip/vip/Kconfig   |   14 +
>  drivers/media/platform/rockchip/vip/Makefile  |    3 +
>  drivers/media/platform/rockchip/vip/capture.c | 1210 +++++++++++++++++
>  drivers/media/platform/rockchip/vip/dev.c     |  346 +++++
>  drivers/media/platform/rockchip/vip/dev.h     |  163 +++
>  drivers/media/platform/rockchip/vip/regs.h    |  260 ++++
>  10 files changed, 2103 insertions(+)
>  create mode 100644 Documentation/devicetree/bindings/media/rockchip,px30=
-vip.yaml
>  create mode 100644 drivers/media/platform/rockchip/vip/Kconfig
>  create mode 100644 drivers/media/platform/rockchip/vip/Makefile
>  create mode 100644 drivers/media/platform/rockchip/vip/capture.c
>  create mode 100644 drivers/media/platform/rockchip/vip/dev.c
>  create mode 100644 drivers/media/platform/rockchip/vip/dev.h
>  create mode 100644 drivers/media/platform/rockchip/vip/regs.h
>=20
> --=20
> 2.41.0
>=20

--=20
Paul Kocialkowski, Bootlin
Embedded Linux and kernel engineering
https://bootlin.com

--Q1VB5kuawAMoF08n
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQEzBAEBCAAdFiEEJZpWjZeIetVBefti3cLmz3+fv9EFAmUxTEcACgkQ3cLmz3+f
v9F2Ewf9HigOw2S+9EGfiZ0Q7hf2r+leWQqojcR6KTjqJxvPZWFneFI+GjqPIyER
XjgSv5zjHav2nbGgkw6sFvcEm4KUokyfhMwjUXifuPulj7D1Oz5b7ynhuS/vAoKQ
T9uLtN//iX/KPghprf0lMB/FVSh2VkOvYVQ0MortfbsbxH3rQkXvPnxL8O9IyDGG
Jpj5onXB97g1yo/8kc0Y4FXvakWZARAhyzKrv9kPTSdBwDU0+lLDQgER38PUNds4
Qf6teYYXJ9JdUiuc9b2L2AuCK7XTBL2i4jU7K/AbMXxMTLD//IiB4JgQDHlF6plB
CnCGtOe3DsHyhKmNscf5v25XD3fxqw==
=6P2K
-----END PGP SIGNATURE-----

--Q1VB5kuawAMoF08n--