Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
Feedback-ID: i8771445c:Fastmail
Date:   Mon, 16 Jan 2023 11:16:51 +0100
From:   Maxime Ripard <maxime@cerno.tech>
To:     Oleg Verych <olecom@gmail.com>
Cc:     wens@kernel.org, devicetree@vger.kernel.org,
        linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org,
        linux-media@vger.kernel.org, mark.rutland@arm.com,
        mchehab@kernel.org, robh+dt@kernel.org,
        sakari.ailus@linux.intel.com, wens@csie.org
Subject: Re: [PATCH 04/14] media: sun4i-csi: Fix [HV]sync polarity handling
Message-ID: <20230116101651.jjzz2rcdehs5wvsi@houat>
References: <20191215165924.28314-5-wens@kernel.org>
 <20230116100359.4479-1-olecom@gmail.com>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha512;
        protocol="application/pgp-signature"; boundary="d42kwkvwzbbj3usb"
Content-Disposition: inline
In-Reply-To: <20230116100359.4479-1-olecom@gmail.com>
Precedence: bulk


--d42kwkvwzbbj3usb
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

Hi,

On Mon, Jan 16, 2023 at 01:03:59PM +0300, Oleg Verych wrote:
> > -	hsync_pol =3D !!(bus->flags & V4L2_MBUS_HSYNC_ACTIVE_HIGH);
> > -	vsync_pol =3D !!(bus->flags & V4L2_MBUS_VSYNC_ACTIVE_HIGH);
> > +	/*
> > +	 * This hardware uses [HV]REF instead of [HV]SYNC. Based on the
> > +	 * provided timing diagrams in the manual, positive polarity
> > +	 * equals active high [HV]REF.
> > +	 *
> > +	 * When the back porch is 0, [HV]REF is more or less equivalent
> > +	 * to [HV]SYNC inverted.
> > +	 */
> > +	href_pol =3D !!(bus->flags & V4L2_MBUS_HSYNC_ACTIVE_LOW);
> > +	vref_pol =3D !!(bus->flags & V4L2_MBUS_VSYNC_ACTIVE_LOW);
>=20
> After this change has been made there is a need of explicit explanation
> of what "Active high" / "Active low" in dts really mean.

Why?

Active high means that the signal is considered active when it is held
high. Active low means that the signal is considered active when it is
low.

> Currently physical high/low voltage levels are like that:
> (I'm not sure about vsync-active)
>=20
> * hsync-active =3D <0>; /* HSYNC active 'low' =3D> wire active is 'high' =
*/

Yes

>   CSI register setting: href_pol: 1,

Not really, no. It's what this patch commit log is saying: HREF is
!HSYNC, so in order to get a hsync pulse active high, you need to set
href_pol to 0.

> That is confusing:
>=20
> [PATCH v6 5/5] DO NOT MERGE: ARM: dts: bananapi: Add Camera support
> https://lore.kernel.org/linux-arm-kernel/cf0e40b0bca9219d2bb023a5b7f23bad=
8baba1e5.1562847292.git-series.maxime.ripard@bootlin.com/#r
>=20
> > +	port {
> > +		csi_from_ov5640: endpoint {
> > +                        remote-endpoint =3D <&ov5640_to_csi>;
> > +                        bus-width =3D <8>;
> > +                        hsync-active =3D <1>; /* Active high */
>=20
> original CSI driver
>=20
> > +                        vsync-active =3D <0>; /* Active low */
> > +                        data-active =3D <1>;  /* Active high */
> > +                        pclk-sample =3D <1>;  /* Rising */
> > +                };
> > +	};
>=20
> [PATCH 13/14] [DO NOT MERGE] ARM: dts: sun7i: cubieboard2: Enable OV7670 =
camera on CSI1
> https://lore.kernel.org/linux-arm-kernel/20191215165924.28314-14-wens@ker=
nel.org/
>=20
> > +	port {
> > +		/* Parallel bus endpoint */
> > +		csi_from_ov7670: endpoint {
> > +			remote-endpoint =3D <&ov7670_to_csi>;
> > +			bus-width =3D <8>;
> > +			/* driver is broken */
> > +			hsync-active =3D <0>; /* Active high */
>=20
> this change patchset
>=20
> > +			vsync-active =3D <1>; /* Active high */
> > +			data-active =3D <1>;  /* Active high */
> > +			pclk-sample =3D <1>;  /* Rising */
> > +		};
>=20
> > +			ov7670_to_csi: endpoint {
> > +				remote-endpoint =3D <&csi_from_ov7670>;
> > +				bus-width =3D <8>;
> > +				hsync-active =3D <1>; /* Active high */
>=20
> this patcheset
>=20
> > +				vsync-active =3D <1>; /* Active high */
> > +				data-active =3D <1>;  /* Active high */
> > +				pclk-sample =3D <1>;  /* Rising */
> > +			};
> > +		};

I'm sorry, it's not clear to me what is confusing in those excerpts?

Maxime

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

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

iHUEABYKAB0WIQRcEzekXsqa64kGDp7j7w1vZxhRxQUCY8UkEwAKCRDj7w1vZxhR
xTMkAP4+TgmiQeIUnqkQdGHMurxhX6R1RMA0WARr69iNcT7I+AD/ZaGQUas8YGRi
CYDPVdJ5hhgKlTctilLgpPIaA55YmwE=
=QilM
-----END PGP SIGNATURE-----

--d42kwkvwzbbj3usb--