From nobody Sat Jun 27 22:29:30 2026 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 EB393C433EF for ; Fri, 18 Feb 2022 09:23:18 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233482AbiBRJXc (ORCPT ); Fri, 18 Feb 2022 04:23:32 -0500 Received: from mxb-00190b01.gslb.pphosted.com ([23.128.96.19]:33672 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233301AbiBRJXb (ORCPT ); Fri, 18 Feb 2022 04:23:31 -0500 Received: from viti.kaiser.cx (viti.kaiser.cx [IPv6:2a01:238:43fe:e600:cd0c:bd4a:7a3:8e9f]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9DA7A2C12E for ; Fri, 18 Feb 2022 01:23:14 -0800 (PST) Received: from dslb-178-004-174-047.178.004.pools.vodafone-ip.de ([178.4.174.47] helo=martin-debian-2.paytec.ch) by viti.kaiser.cx with esmtpsa (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.89) (envelope-from ) id 1nKzTo-0005Qj-Nr; Fri, 18 Feb 2022 10:23:08 +0100 From: Martin Kaiser To: Greg Kroah-Hartman Cc: Larry Finger , Phillip Potter , Michael Straube , linux-staging@lists.linux.dev, linux-kernel@vger.kernel.org, Martin Kaiser Subject: [PATCH RFC] staging: r8188eu: comment about the chip's packet format Date: Fri, 18 Feb 2022 10:22:53 +0100 Message-Id: <20220218092252.853807-1-martin@kaiser.cx> X-Mailer: git-send-email 2.30.2 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" The structs phy_rx_agc_info and phy_status_rpt define parts of the header data that the r8188eu chipset sends to this driver via usb. Add a comment to clarify that we cannot modify the content of these structures and remove seemingly unused fields. Signed-off-by: Martin Kaiser --- Dear all, I experimented with "cleaning up" these structures and related code before discovering that their content comes from usb packets we receive from the r8188eu chipset. Would it make sense to add a word of warning to prevent others from repeating this exercise? Thanks, Martin drivers/staging/r8188eu/include/odm_HWConfig.h | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/drivers/staging/r8188eu/include/odm_HWConfig.h b/drivers/stagi= ng/r8188eu/include/odm_HWConfig.h index b37962edb2ed..35a562372a1a 100644 --- a/drivers/staging/r8188eu/include/odm_HWConfig.h +++ b/drivers/staging/r8188eu/include/odm_HWConfig.h @@ -14,6 +14,13 @@ =20 /* structure and define */ =20 +/* + * Attention: struct phy_status_rpt and struct phy_rx_agc_info describe + * data structures that this driver receives from the r8188eu chip via usb. + * Do not change the content of these structures, do not remove seemingly + * unused entries. + */ + struct phy_rx_agc_info { #ifdef __LITTLE_ENDIAN u8 gain:7, trsw:1; --=20 2.30.2