From patchwork Tue Jun 28 09:46:24 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mauro Carvalho Chehab X-Patchwork-Id: 12897974 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 788E2CCA479 for ; Tue, 28 Jun 2022 09:47:10 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344402AbiF1JrJ (ORCPT ); Tue, 28 Jun 2022 05:47:09 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39336 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1344324AbiF1Jqj (ORCPT ); Tue, 28 Jun 2022 05:46:39 -0400 Received: from ams.source.kernel.org (ams.source.kernel.org [IPv6:2604:1380:4601:e00::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 8040425C76; Tue, 28 Jun 2022 02:46:36 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id CB98DB81D98; Tue, 28 Jun 2022 09:46:32 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 71C7DC341E9; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=lh6o/QFPtVGrO1ZYX3PjI7UAR4mnHtfCksAmlyGH4Z0=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=g0TTrjSTKMtxLlo0c0qbNEDt5h7tfXmjrOPlCioBph0Q3Clxqg5W3k0D74JiDGVl6 A6QC2NeDyEg8wLQzcPvnwzmQtkS8PaC5yODnbPogbGVA33BARCCW2vXa7WeBabj1DH b4S+oMCu2pQ2XwDZlt29QztuJ0rvPzzqRm5/SFjL5lvTfxYYGGkJ0bL5arOrBQ3NvY QqOqFmsX+zviJUWFpvdmrpwh9XscBs8BIbSsOQ4d9zdcMZhBY1AGYGJTUwmMCbtcZS FsMtMP3H4EerCmVVnZpbVS0My5r57HN8R4fv3zXxMJagGqEqFkZX8GZLGlCvhe3T9m ujZqMN04z1z1g== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67ng-005HFq-0w; Tue, 28 Jun 2022 10:46:28 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , "Mauro Carvalho Chehab" , Greg Kroah-Hartman , Heikki Krogerus , linux-kernel@vger.kernel.org, linux-usb@vger.kernel.org Subject: [PATCH 20/22] usb: typec_altmode: add a missing "@" at a kernel-doc parameter Date: Tue, 28 Jun 2022 10:46:24 +0100 Message-Id: <70dc4c5d744cf1fe9a0efe6b85deaa0489628282.1656409369.git.mchehab@kernel.org> X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-usb@vger.kernel.org Without that, the parameter is not properly parsed: include/linux/usb/typec_altmode.h:132: warning: Function parameter or member 'altmode' not described in 'typec_altmode_get_orientation' Signed-off-by: Mauro Carvalho Chehab Acked-by: Heikki Krogerus --- To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mchehab@kernel.org/ include/linux/usb/typec_altmode.h | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/include/linux/usb/typec_altmode.h b/include/linux/usb/typec_altmode.h index 65933cbe9129..350d49012659 100644 --- a/include/linux/usb/typec_altmode.h +++ b/include/linux/usb/typec_altmode.h @@ -124,7 +124,7 @@ struct typec_altmode *typec_match_altmode(struct typec_altmode **altmodes, /** * typec_altmode_get_orientation - Get cable plug orientation - * altmode: Handle to the alternate mode + * @altmode: Handle to the alternate mode */ static inline enum typec_orientation typec_altmode_get_orientation(struct typec_altmode *altmode) From patchwork Tue Jun 28 09:46:25 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mauro Carvalho Chehab X-Patchwork-Id: 12897976 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id A7BEFCCA480 for ; Tue, 28 Jun 2022 09:47:21 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344441AbiF1JrU (ORCPT ); Tue, 28 Jun 2022 05:47:20 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39516 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1344328AbiF1Jqj (ORCPT ); Tue, 28 Jun 2022 05:46:39 -0400 Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 1952A25C68; Tue, 28 Jun 2022 02:46:36 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id B22A2B81D99; Tue, 28 Jun 2022 09:46:32 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 599F9C341E4; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=iaQdNc88ElygWwpOBXidr0c6SZkvYula3SyEYHKlyDA=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Y+A91k9QbTLFzrmkI3RA2LnkHMLtZfcQO9njDmN3DctNkjWrqagq+CmvGs8WYGbpZ m/7ldVT+IG1AQq0oS6cBVmvYlg9QbCTUUbjxItk3WS0ZBDTLqYCDBe4ENl0I5zFLdT aQU+nQH2TiOz9PWkRAEHYt+DLyV8YJYWQ9xMkAGkG/zbVyDJy6H488gAkK/zON4Qf5 GDo9okXLAvXrupP8UoeGtu9f39bEHhXm4GSOcFMzMXar+pTxSi4K7esbzrscu/d48q YMAyji5yDkB9NVj4Of1MlqGZ5LbmqMXl9i/p3uL9LuFyEJurX25dcd4xHFRQumV3qA FmOdClokY4UPw== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67ng-005HFu-1W; Tue, 28 Jun 2022 10:46:28 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , "Mauro Carvalho Chehab" , Felipe Balbi , Greg Kroah-Hartman , linux-kernel@vger.kernel.org, linux-usb@vger.kernel.org Subject: [PATCH 21/22] usb: dwc3: document async_callbacks field Date: Tue, 28 Jun 2022 10:46:25 +0100 Message-Id: <2c3de5935934baec097286f525ce4beff0a31ec0.1656409369.git.mchehab@kernel.org> X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-usb@vger.kernel.org Avoid a kernel-doc warning by documenting it: drivers/usb/dwc3/core.h:1328: warning: Function parameter or member 'async_callbacks' not described in 'dwc3' Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mchehab@kernel.org/ drivers/usb/dwc3/core.h | 2 ++ 1 file changed, 2 insertions(+) diff --git a/drivers/usb/dwc3/core.h b/drivers/usb/dwc3/core.h index 722808d8c0af..4fe4287dc934 100644 --- a/drivers/usb/dwc3/core.h +++ b/drivers/usb/dwc3/core.h @@ -1087,6 +1087,8 @@ struct dwc3_scratchpad_array { * @dis_u1_entry_quirk: set if link entering into U1 state needs to be disabled. * @dis_u2_entry_quirk: set if link entering into U2 state needs to be disabled. * @dis_rxdet_inp3_quirk: set if we disable Rx.Detect in P3 + * @async_callbacks: if set, indicate that async callbacks will be used. + * * @dis_u2_freeclk_exists_quirk : set if we clear u2_freeclk_exists * in GUSB2PHYCFG, specify that USB2 PHY doesn't * provide a free-running PHY clock. From patchwork Tue Jun 28 09:46:26 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mauro Carvalho Chehab X-Patchwork-Id: 12897975 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 67949C43334 for ; Tue, 28 Jun 2022 09:47:20 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344433AbiF1JrT (ORCPT ); Tue, 28 Jun 2022 05:47:19 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39388 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S242161AbiF1JrD (ORCPT ); Tue, 28 Jun 2022 05:47:03 -0400 Received: from ams.source.kernel.org (ams.source.kernel.org [IPv6:2604:1380:4601:e00::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 8066525E80; Tue, 28 Jun 2022 02:46:36 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id C39C4B81D9B; Tue, 28 Jun 2022 09:46:32 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 6CBCDC341E7; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=31LxezsefKWZxd2OhNR0VkL1vX8zivhz/ovRCJXS1V8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=gx5qWDseQpempDJEgIyEp6tY0x8uPqoKAF6nAL+ChrVCh33s5wvQuhSiIWcWHyG0N YWI+xRKJBFgONvz3tMBF074eCzeDTciulZR7MGMuTj07STlXze6fcq0WdOZg+g+cdr Vxaq4L3TyoMXXj0CiYbB255haA97E+JIQLiH0HkrjJwBB3ZJLt6bTBS0ok/FgEHozg f9UtpHP19mqsah7nLxN4AtDISWQPMBDPwpVKmQ9hBCg7TcUtkwxABS6OHi1NMVH1jl Ai5XD3MXgspBGGbSKrXzb2Yls4d6aXnEaXGPn6kkZZnHTOV1p1XNDFvTy2qq04oK7j c17OAh4XOSArQ== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67ng-005HFx-23; Tue, 28 Jun 2022 10:46:28 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , "Mauro Carvalho Chehab" , Felipe Balbi , Greg Kroah-Hartman , linux-kernel@vger.kernel.org, linux-usb@vger.kernel.org Subject: [PATCH 22/22] usb: dwc3: gadget: fix a kernel-doc warning Date: Tue, 28 Jun 2022 10:46:26 +0100 Message-Id: X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-usb@vger.kernel.org The multiplier parameter of dwc3_gadget_calc_tx_fifo_size() was not documented: drivers/usb/dwc3/gadget.c:675: warning: Function parameter or member 'mult' not described in 'dwc3_gadget_calc_tx_fifo_size' Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mchehab@kernel.org/ drivers/usb/dwc3/gadget.c | 1 + 1 file changed, 1 insertion(+) diff --git a/drivers/usb/dwc3/gadget.c b/drivers/usb/dwc3/gadget.c index 8716bece1072..a944c7a6c83a 100644 --- a/drivers/usb/dwc3/gadget.c +++ b/drivers/usb/dwc3/gadget.c @@ -657,6 +657,7 @@ static int dwc3_gadget_set_ep_config(struct dwc3_ep *dep, unsigned int action) /** * dwc3_gadget_calc_tx_fifo_size - calculates the txfifo size value * @dwc: pointer to the DWC3 context + * @mult: multiplier to be used when calculating the fifo_size * * Calculates the size value based on the equation below: *