Received-SPF: pass (google.com: domain of linux-wireless+bounces-4120-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.48.161 as permitted sender) client-ip=147.75.48.161;
From: Fiona Klute <fiona.klute@gmx.de>
To: linux-wireless@vger.kernel.org,
	pkshih@realtek.com
Cc: Fiona Klute <fiona.klute@gmx.de>,
	kvalo@kernel.org,
	ulf.hansson@linaro.org,
	linux-mmc@vger.kernel.org,
	pavel@ucw.cz,
	megi@xff.cz
Subject: [PATCH v2 4/9] wifi: rtw88: Add rtw8703b.h
Date: Wed, 28 Feb 2024 00:54:58 +0100
Message-ID: <20240227235507.781615-5-fiona.klute@gmx.de>
In-Reply-To: <20240227235507.781615-1-fiona.klute@gmx.de>
References: <20240227235507.781615-1-fiona.klute@gmx.de>
Precedence: bulk
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable
UI-OutboundReport: notjunk:1;M01:P0:4F2Xr+DjWaI=;/6FreK3V6lvZH2daxg9WPtWlA9W
 oncxsuKuKz9VUdITLHHRhCHJrkhY2vnQt4+lIhhNDNDJpIilLYrW9AnYvUEYbhIJutDee8AZD
 r1Pn1bXXTi4CXE1ncgYO0joJYHcYqXOn8pyC6t0MywK0rqqerS0j825DqJit6qMjhULf42TSm
 yZQNwiFng2iTMs9jPOF07Kbt4uk5i1dvXvhVHx3FfuexusgH56PqU0mNfPPwD3Xc4h6vrRd0m
 NzGldwVH9C3XvmO8ooYYg1Rlso00bqy1el1/b1JVlqLuq45bZi41M3PMYRLqiamXmljyK1dem
 g3b744velZAklcg/QN5Ap9GrNfzoar/k3mwOZ4gVNJMkSmQLMr3qRsmHR6czrcHoLbk8ig8AI
 1v2gDDW/wIGbI1JXONsgUEM6FAh+oDrsm6KnVEw/MF8L9UwqkPt494KX3QQ0RmnSPablLn0zT
 0iIDBLSwsX7FpWVTD4aiRZlmPsY6i8idnbarEWoEifR+7MaTlq7glJZoB03dMsnb92cCFCj97
 VNvEsWz55B/b+LMuyRg3STFPzIq7AjOPqR8B9tDSir1dzs4CU8ks1jW0NmUkkWN94Sy61sr8E
 9NPsuw9WX0gQgNtd9AXl0zzyuhs+eL4R5ZmBtE1LAXD7s8lt4Iv6McbQJgGxTTW+x8yzQpxhQ
 9++R4zwq7bOTUfW+s8l0K30z3/B6Ep0edRUaQbM8KEThAEdl5s+SBszwDFR1CHs3AC9gJm8bV
 29PfTBffDpRP6ZznyVTGzyya/4P/k4GSIe8yJ5eJIoDfghYHgYUqY4OlRGw9kPuvqxUkyclJy
 jC9wzGzDnpXyNW0BGiOBtB7KxSzDIDoo3CAsaktlJCS/g=

This is the main header for the new rtw88_8703b chip driver.

Acked-by: Ping-Ke Shih <pkshih@realtek.com>
Tested-by: Pavel Machek <pavel@ucw.cz>
Signed-off-by: Fiona Klute <fiona.klute@gmx.de>
=2D--
 drivers/net/wireless/realtek/rtw88/rtw8703b.h | 103 ++++++++++++++++++
 1 file changed, 103 insertions(+)
 create mode 100644 drivers/net/wireless/realtek/rtw88/rtw8703b.h

diff --git a/drivers/net/wireless/realtek/rtw88/rtw8703b.h b/drivers/net/w=
ireless/realtek/rtw88/rtw8703b.h
new file mode 100644
index 00000000000..69dac101d33
=2D-- /dev/null
+++ b/drivers/net/wireless/realtek/rtw88/rtw8703b.h
@@ -0,0 +1,103 @@
+/* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
+/* Copyright Fiona Klute <fiona.klute@gmx.de> */
+
+#ifndef __RTW8703B_H__
+#define __RTW8703B_H__
+
+#include <linux/types.h>
+#include <linux/compiler_attributes.h>
+
+extern const struct rtw_chip_info rtw8703b_hw_spec;
+
+/* phy status parsing */
+#define VGA_BITS GENMASK(4, 0)
+#define LNA_L_BITS GENMASK(7, 5)
+#define LNA_H_BIT BIT(7)
+/* masks for assembling LNA index from high and low bits */
+#define BIT_LNA_H_MASK BIT(3)
+#define BIT_LNA_L_MASK GENMASK(2, 0)
+
+struct phy_rx_agc_info {
+#ifdef __LITTLE_ENDIAN
+	u8 gain: 7;
+	u8 trsw: 1;
+#else
+	u8 trsw: 1;
+	u8 gain: 7;
+#endif
+} __packed;
+
+/* This struct is called phy_status_rpt_8192cd in the vendor driver,
+ * there might be potential to share it with drivers for other chips
+ * of the same generation.
+ */
+struct phy_status_8703b {
+	struct phy_rx_agc_info path_agc[2];
+	u8 ch_corr[2];
+	u8 cck_sig_qual_ofdm_pwdb_all;
+	/* for CCK: bits 0:4: VGA index, bits 5:7: LNA index (low) */
+	u8 cck_agc_rpt_ofdm_cfosho_a;
+	/* for CCK: bit 7 is high bit of LNA index if long report type */
+	u8 cck_rpt_b_ofdm_cfosho_b;
+	u8 reserved_1;
+	u8 noise_power_db_msb;
+	s8 path_cfotail[2];
+	u8 pcts_mask[2];
+	s8 stream_rxevm[2];
+	u8 path_rxsnr[2];
+	u8 noise_power_db_lsb;
+	u8 reserved_2[3];
+	u8 stream_csi[2];
+	u8 stream_target_csi[2];
+	s8 sig_evm;
+	u8 reserved_3;
+
+#ifdef __LITTLE_ENDIAN
+	u8 antsel_rx_keep_2: 1;
+	u8 sgi_en: 1;
+	u8 rxsc: 2;
+	u8 idle_long: 1;
+	u8 r_ant_train_en: 1;
+	u8 ant_sel_b: 1;
+	u8 ant_sel: 1;
+#else /* __BIG_ENDIAN */
+	u8 ant_sel: 1;
+	u8 ant_sel_b: 1;
+	u8 r_ant_train_en: 1;
+	u8 idle_long: 1;
+	u8 rxsc: 2;
+	u8 sgi_en: 1;
+	u8 antsel_rx_keep_2: 1;
+#endif
+} __packed;
+
+/* Baseband registers */
+#define REG_BB_PWR_SAV5_11N 0x0818
+/* BIT(11) should be 1 for 8703B *and* 8723D, which means LNA uses 4
+ * bit for CCK rates in report, not 3. Vendor driver logs a warning if
+ * it's 0, but handles the case.
+ *
+ * Purpose of other parts of this register is unknown, 8723cs driver
+ * code indicates some other chips use certain bits for antenna
+ * diversity.
+ */
+#define REG_BB_AMP 0x0950
+#define BIT_MASK_RX_LNA (BIT(11))
+
+/* 0xaXX: 40MHz channel settings */
+#define REG_CCK_TXSF2 0x0a24  /* CCK TX filter 2 */
+#define REG_CCK_DBG 0x0a28  /* debug port */
+#define REG_OFDM0_A_TX_AFE 0x0c84
+#define REG_TXIQK_MATRIXB_LSB2_11N 0x0c9c
+#define REG_OFDM0_TX_PSD_NOISE 0x0ce4  /* TX pseudo noise weighting */
+#define REG_IQK_RDY 0x0e90  /* is !=3D 0 when IQK is done */
+
+/* RF registers */
+#define RF_RCK1 0x1E
+
+#define AGG_BURST_NUM 3
+#define AGG_BURST_SIZE 0 /* 1K */
+#define BIT_MASK_AGG_BURST_NUM (GENMASK(3, 2))
+#define BIT_MASK_AGG_BURST_SIZE (GENMASK(5, 4))
+
+#endif /* __RTW8703B_H__ */
=2D-
2.43.0