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;
Date:   Tue, 8 Mar 2022 10:26:38 +0800
From:   Xin Ji <xji@analogixsemi.com>
To:     Guenter Roeck <linux@roeck-us.net>
Cc:     Heikki Krogerus <heikki.krogerus@linux.intel.com>,
        Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
        Matthias Brugger <matthias.bgg@gmail.com>,
        bliang@analogixsemi.com, qwen@analogixsemi.com,
        jli@analogixsemi.com, linux-usb@vger.kernel.org,
        linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org,
        linux-mediatek@lists.infradead.org
Subject: Re: [PATCH v7 1/3] usb: typec: tcpci: move tcpci.h to
 include/linux/usb/ directory
Message-ID: <20220308022638.GA964343@anxtwsw-Precision-3640-Tower>
References: <20220307090929.701137-1-xji@analogixsemi.com>
 <4252cd9d-a761-e064-58cf-eebc3b9d0bb7@roeck-us.net>
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <4252cd9d-a761-e064-58cf-eebc3b9d0bb7@roeck-us.net>
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?q0JNWVcG3YHIWZ+ozR/dZZQmA7aqzA1AhhKQKJFf5xb4cx0TcyKrkdiTy5wU?=
 =?us-ascii?Q?WPs6aF3dMU9yQSyEEqNcQDUsZNGBCLj9omM+BfNdHWoUxFAUSWkK5k3WKq2s?=
 =?us-ascii?Q?fENrYlJm5lsJhWnxHDzwNCJG6GS+9rgPY0RounuOVNXXzf//Zc90kfWDZ5jU?=
 =?us-ascii?Q?Rq0GJdm4Msabw3WtLepN8G5OHcqjRwbGU7H0Ov1n6pJlqHZ9tdsenjDhD5Tb?=
 =?us-ascii?Q?EQiTpCvTBsHpU3qGDXyEUMR14gz6E9NsfhYY46Tt7FEBJb7a2EEmZxt8g1em?=
 =?us-ascii?Q?YggfP3Zh3bOyPjePGqrE+dcRqBbv7+6CEEugBd3ObrYZbJc+7k3+mM2EvrW6?=
 =?us-ascii?Q?yRzMdzLrMXTS5DlBypIyoMBOwb8rEo1tvVn33k41JgdFlN2Hzl11HyyUoJFM?=
 =?us-ascii?Q?KgvbLMspsVDyEzaIPBnioIp49dxaP23IbbNH1Wc2uda1E5U6VTMU16HsFc8Y?=
 =?us-ascii?Q?NkD7XULG7oWgzLZGGniyrfoN+sp72NtxRp+Q+mM0ljnFm6e9HdE1rSBCBy4o?=
 =?us-ascii?Q?Ow/0S6knZzoBFNGQro1corfClbbf/H7OLk4iDg9jP76OaMPQwP0lalLA69XR?=
 =?us-ascii?Q?pzoPgkHZWSf5SeZxw/SDF8YWNvXWizNSsS+e0awGQEgYJrDNuAy+Wm5FOayq?=
 =?us-ascii?Q?+uksxenoEfraqd3LH6yi2NUwYv8ChIQ8i+g6kC8anxRjbC5sp/uT99TopDfb?=
 =?us-ascii?Q?apmc+F2fHLTq+oia8gapPUCwVwiLG2oBiDVUTpwgnRhAqqan/AhgExMV96Yf?=
 =?us-ascii?Q?vCaL+pZLycyabdpITNCGYY5IvgeipGoB98WA/u1PDARDVvGB8zMkmnhCpKFX?=
 =?us-ascii?Q?nPU5zywW9hiWkSWFfySyYPa7tD64ipy5m7FIW0emrwRx3Dnr8Z6IseClDUqA?=
 =?us-ascii?Q?uR8B5E5FVdpDyC7F6DtCvkasRlz2yKruM36T27hFx5h44OEQSzC8vrI9uhGc?=
 =?us-ascii?Q?9Up0/8UVEQeR6usjJy6aunmhs+4/2li0J7n61YFbi8su5g/qs8FfYqgWkl98?=
 =?us-ascii?Q?eJ8RvOTjdLDwX5Yy+V2G3duU9xUFrcZKN7umTznVu6rpVTPzLU0o3VyZiv4H?=
 =?us-ascii?Q?YAO0ouZ/QSL2B94cPUOc/JyjPuIju5tBBkKOgM1H5dlF05MVsBkFVjyTQefU?=
 =?us-ascii?Q?koglmBn4SXuq0LmygRhSt7EkscyeS1jlNjrudXsnIdhoXp8eosByflwBDhQf?=
 =?us-ascii?Q?1Jo1GRvNmfa4lRH90HP8fMhn0KCFzwbUk6ZGo9L2nGl+muZ/E++ex0zmHw8L?=
 =?us-ascii?Q?rocHC/KWty/2FMaChvicL4LHmWtOhlOjkiJPwEtWMNVnQCBjZ9ZcEawMc5om?=
 =?us-ascii?Q?aMcutnmzWzptmZsLaRX5EEKxuYZnYYdGGdh8UApF/wI07uSnPJlLhwepgFFV?=
 =?us-ascii?Q?FJqShSj9SDFKakRZ9LN6mYmlbdyCpHlyRr5hvGwW+SvKdT/HGlOItw89TBt1?=
 =?us-ascii?Q?xhPRmvG6W+la3SCXZmIfAirg4MyZ1ES31sVww1XYEto1j4jYygrAhId8/TvY?=
 =?us-ascii?Q?DjudBsCWTGiUebKdLxnFvhAKD3+GxqGLW8FowoseQa4UYZUV1aZYmVETgrVT?=
 =?us-ascii?Q?IR+N5+RnEQJFMnw5quu/tq+2U7hFEcQC57bswQp6tkbCk79JUs6TqItCs9wq?=
 =?us-ascii?Q?LeMQaB3+LQTGJBZT0xADJa0=3D?=
X-OriginatorOrg: analogixsemi.com
X-MS-Exchange-CrossTenant-Network-Message-Id: ae1c30c0-8f1d-4cb1-3629-08da00ab15f4
X-MS-Exchange-CrossTenant-AuthSource: BY5PR04MB6739.namprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 08 Mar 2022 02:26:43.6736
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: b099b0b4-f26c-4cf5-9a0f-d5be9acab205
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: gqmVQY1IZotZlcmS1bHJc+8cCfRrzKKiHzua84eQPnYUjUBmYt2RfNdv/UU0ye1QeEHxGWDoPq34vKBPSNP/kA==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN4PR0401MB3551
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,DKIM_SIGNED,
        DKIM_VALID,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS,
        T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

On Mon, Mar 07, 2022 at 06:49:03AM -0800, Guenter Roeck wrote:
> On 3/7/22 01:09, Xin Ji wrote:
> > Move tcpci.h as a global file, better for other USB Type-C driver
> > access.
> > 
> 
> The idea was to have tcpci compliant drivers in the tcpm/ subdirectory.
> If I recall correctly, the reason for having this driver elsewhere is
> that it doesn't support tcpm. That should be explained here.
> "better for other USB Type-C driver" is not a reason for moving
> a header file.
> 
> > Fix compiling error after moving tcpci.h to include/linux/usb/.
> > 
> I don't think this should be part of the commit description.
> 
> Guenter

Hi Guenter, OK, got it, this patch is recommended by Heikki, as our
driver will refer some TCPCI registers, he prefer to move tcpci.h in to
global directory.

Hi Heikki, please help to give your opinion, thanks!

Thanks,
Xin
> 
> > Signed-off-by: Xin Ji <xji@analogixsemi.com>
> > ---
> >   drivers/usb/typec/tcpm/tcpci.c                        | 3 +--
> >   drivers/usb/typec/tcpm/tcpci_maxim.c                  | 3 +--
> >   drivers/usb/typec/tcpm/tcpci_mt6360.c                 | 3 +--
> >   drivers/usb/typec/tcpm/tcpci_rt1711h.c                | 2 +-
> >   {drivers/usb/typec/tcpm => include/linux/usb}/tcpci.h | 1 +
> >   5 files changed, 5 insertions(+), 7 deletions(-)
> >   rename {drivers/usb/typec/tcpm => include/linux/usb}/tcpci.h (99%)
> > 
> > diff --git a/drivers/usb/typec/tcpm/tcpci.c b/drivers/usb/typec/tcpm/tcpci.c
> > index e07d26a3cd8e..9c907296596f 100644
> > --- a/drivers/usb/typec/tcpm/tcpci.c
> > +++ b/drivers/usb/typec/tcpm/tcpci.c
> > @@ -13,11 +13,10 @@
> >   #include <linux/property.h>
> >   #include <linux/regmap.h>
> >   #include <linux/usb/pd.h>
> > +#include <linux/usb/tcpci.h>
> >   #include <linux/usb/tcpm.h>
> >   #include <linux/usb/typec.h>
> > -#include "tcpci.h"
> > -
> >   #define	PD_RETRY_COUNT_DEFAULT			3
> >   #define	PD_RETRY_COUNT_3_0_OR_HIGHER		2
> >   #define	AUTO_DISCHARGE_DEFAULT_THRESHOLD_MV	3500
> > diff --git a/drivers/usb/typec/tcpm/tcpci_maxim.c b/drivers/usb/typec/tcpm/tcpci_maxim.c
> > index df2505570f07..4b6705f3d7b7 100644
> > --- a/drivers/usb/typec/tcpm/tcpci_maxim.c
> > +++ b/drivers/usb/typec/tcpm/tcpci_maxim.c
> > @@ -11,11 +11,10 @@
> >   #include <linux/module.h>
> >   #include <linux/regmap.h>
> >   #include <linux/usb/pd.h>
> > +#include <linux/usb/tcpci.h>
> >   #include <linux/usb/tcpm.h>
> >   #include <linux/usb/typec.h>
> > -#include "tcpci.h"
> > -
> >   #define PD_ACTIVITY_TIMEOUT_MS				10000
> >   #define TCPC_VENDOR_ALERT				0x80
> > diff --git a/drivers/usb/typec/tcpm/tcpci_mt6360.c b/drivers/usb/typec/tcpm/tcpci_mt6360.c
> > index f1bd9e09bc87..9e0338bce7ef 100644
> > --- a/drivers/usb/typec/tcpm/tcpci_mt6360.c
> > +++ b/drivers/usb/typec/tcpm/tcpci_mt6360.c
> > @@ -11,10 +11,9 @@
> >   #include <linux/of.h>
> >   #include <linux/platform_device.h>
> >   #include <linux/regmap.h>
> > +#include <linux/usb/tcpci.h>
> >   #include <linux/usb/tcpm.h>
> > -#include "tcpci.h"
> > -
> >   #define MT6360_REG_VCONNCTRL1	0x8C
> >   #define MT6360_REG_MODECTRL2	0x8F
> >   #define MT6360_REG_SWRESET	0xA0
> > diff --git a/drivers/usb/typec/tcpm/tcpci_rt1711h.c b/drivers/usb/typec/tcpm/tcpci_rt1711h.c
> > index b56a0880a044..3291ca4948da 100644
> > --- a/drivers/usb/typec/tcpm/tcpci_rt1711h.c
> > +++ b/drivers/usb/typec/tcpm/tcpci_rt1711h.c
> > @@ -10,9 +10,9 @@
> >   #include <linux/i2c.h>
> >   #include <linux/interrupt.h>
> >   #include <linux/gpio/consumer.h>
> > +#include <linux/usb/tcpci.h>
> >   #include <linux/usb/tcpm.h>
> >   #include <linux/regmap.h>
> > -#include "tcpci.h"
> >   #define RT1711H_VID		0x29CF
> >   #define RT1711H_PID		0x1711
> > diff --git a/drivers/usb/typec/tcpm/tcpci.h b/include/linux/usb/tcpci.h
> > similarity index 99%
> > rename from drivers/usb/typec/tcpm/tcpci.h
> > rename to include/linux/usb/tcpci.h
> > index b2edd45f13c6..20c0bedb8ec8 100644
> > --- a/drivers/usb/typec/tcpm/tcpci.h
> > +++ b/include/linux/usb/tcpci.h
> > @@ -9,6 +9,7 @@
> >   #define __LINUX_USB_TCPCI_H
> >   #include <linux/usb/typec.h>
> > +#include <linux/usb/tcpm.h>
> >   #define TCPC_VENDOR_ID			0x0
> >   #define TCPC_PRODUCT_ID			0x2