Received-SPF: pass (google.com: domain of linux-kernel+bounces-51235-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249;
Date: Sat, 3 Feb 2024 19:18:13 +0100
From: =?utf-8?Q?Ond=C5=99ej?= Jirman <megi@xff.cz>
To: Pavel Machek <pavel@ucw.cz>
Cc: phone-devel@vger.kernel.org, 
	kernel list <linux-kernel@vger.kernel.org>, fiona.klute@gmx.de, martijn@brixit.nl, samuel@sholland.org, 
	heikki.krogerus@linux.intel.com, gregkh@linuxfoundation.org, linux-usb@vger.kernel.org
Subject: Re: [PATCH] usb: typec: anx7688: Add driver for ANX7688 USB-C HDMI
 bridge
Message-ID: <iikhv7e2z3pk7nr6bvtuepwyrmukym5fjtc2xspsmhxzz5jlwe@5vfs4i3w66kc>
Mail-Followup-To: =?utf-8?Q?Ond=C5=99ej?= Jirman <megi@xff.cz>, 
	Pavel Machek <pavel@ucw.cz>, phone-devel@vger.kernel.org, 
	kernel list <linux-kernel@vger.kernel.org>, fiona.klute@gmx.de, martijn@brixit.nl, samuel@sholland.org, 
	heikki.krogerus@linux.intel.com, gregkh@linuxfoundation.org, linux-usb@vger.kernel.org
References: <Zbt1dIByBZ2stzjm@mobian>
Precedence: bulk
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <Zbt1dIByBZ2stzjm@mobian>

Hi Pavel,

On Thu, Feb 01, 2024 at 11:41:56AM +0100, Pavel Machek wrote:
> From: Ondrej Jirman <megi@xff.cz>
> 
> This is driver for ANX7688 USB-C HDMI, with flashing and debugging
> features removed. ANX7688 is rather criticial piece on PinePhone,
> there's no display and no battery charging without it.

Don't remove the flashing part. Some Pinephones come without the firmware
in the past. Even recently, I've seen some people in the Pine chat
asking how to flash the firmware on some old PinePhone.

It's a safe operation that can be done at any time and can only be done
from the kernel driver.

> There's likely more work to be done here, but having basic support
> in mainline is needed to be able to work on the other stuff
> (networking, cameras, power management).
> 
> Signed-off-by: Ondrej Jirman <megi@xff.cz>

I should be second in order of sign-offs. Martijn wrote a non-working skeleton
https://megous.com/git/linux/commit/?h=pp-5.7&id=30e33cefd7956a2b49fb27008b4af9d868974e58
driver. Then I picked it up and developed it over years to a working thing.
Almost none of the skeleton remains.

License is GPLv2.

> Signed-off-by: Martijn Braam <martijn@brixit.nl>
> Signed-off-by: Samuel Holland <samuel@sholland.org>
> Signed-off-by: Pavel Machek <pavel@ucw.cz>
> 
> [...]
>
> +static int anx7688_i2c_probe(struct i2c_client *client)
> +{
> +        struct anx7688 *anx7688;
> +        struct device *dev = &client->dev;
> +        struct typec_capability typec_cap = { };
> +        int i, vid_h, vid_l;
> +        int irq_cabledet;
> +        int ret = 0;
> +
> +        anx7688 = devm_kzalloc(dev, sizeof(*anx7688), GFP_KERNEL);
> +        if (!anx7688)
> +                return -ENOMEM;
> +
> +        i2c_set_clientdata(client, anx7688);
> +        anx7688->client = client;
> +        anx7688->dev = &client->dev;
> +        mutex_init(&anx7688->lock);
> +        INIT_DELAYED_WORK(&anx7688->work, anx7688_work);
> +	anx7688->last_extcon_state = -1;
> +
> +	ret = of_property_read_variable_u32_array(dev->of_node, "source-caps",
> +						  anx7688->src_caps,
> +						  1, ARRAY_SIZE(anx7688->src_caps));
> +	if (ret < 0) {
> +		dev_err(dev, "failed to get source-caps from DT\n");
> +		return ret;
> +	}
> +	anx7688->n_src_caps = ret;
> +
> +	ret = of_property_read_variable_u32_array(dev->of_node, "sink-caps",
> +						  anx7688->snk_caps,
> +						  1, ARRAY_SIZE(anx7688->snk_caps));
> +	if (ret < 0) {
> +		dev_err(dev, "failed to get sink-caps from DT\n");
> +		return ret;
> +	}

^^^ The driver will need to follow usb-c-connector bindings and it will need
a bindings documentation for itself.

That's one of the missing things that I did not implement, yet.

Kind regards,
	o.