linux-wireless.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH 0/7] wifi: rtw89: support to load TX power tables from firmware file
@ 2023-09-20  7:43 Ping-Ke Shih
  2023-09-20  7:43 ` [PATCH 1/7] wifi: rtw89: add subband index of primary channel to struct rtw89_chan Ping-Ke Shih
                   ` (6 more replies)
  0 siblings, 7 replies; 9+ messages in thread
From: Ping-Ke Shih @ 2023-09-20  7:43 UTC (permalink / raw)
  To: kvalo; +Cc: kevin_yang, linux-wireless

We proposed firmware elements to have PHY parameters that are simple tuple
of {addr, value}, and this patchset is to add nine kinds of TX power tables
to firmware elements. Since TX power tables can be possibly increasing
dimension or value range in the future, it is much complicated than
parameter tables.

We keep existing WiFi 6 chips use tables built-in arrays in drivers, but
preserve rooms to make it possible to move arrays into firmware file
as well. So, patches in this patchset adjust struct also for this purpose.

About backward/forward compatibility:
This is the most important and complicated stuff of this patchset. The
method basically to achieve compatibility is to pad zeros.

1. encode scheme
   Consider a TX power value in driver
     power[x][y] = a
   The indices part are also encoded into firmware file
     x, y, a
   For example,
     power[5][6] = 9      --> 05 06 09

2. compatibility
   When array dimension is increasing, it could become something like
     power[x][y][z] = b
   For example,
     power[5][6][4] = 9   --> 05 06 09 04
                                       ^^
     (note: the new dimension must be encoded as the last digit)

   (I explain further based on these examples)

2.1. driver backward compatibility (new driver + old firmware)
   From driver point of view, a tuple from firmware is 3 digits, so it
   allocates a expected 4-digit tuple array first, and copy 3 digits into
   the array. Base on above example, tuple in old firmware is recognized as
   05 06 09 00  --> power[5][6][0] = 9
            ^^ This pending zero is existing in firmware, but driver adds it

2.2. driver forward compatibility (old driver + new firmware)
   Like above example, old driver allocates 3-digit tuple array first, and
   only copy 3-digits into the array if remaining digits are zeros. For
   example,
   05 06 09 04 --> only for new driver; don't recognize
   05 06 09 00 --> power[5][6] = 9
            ^^ remaining digits must be zeros

   Summarize the flow:
   1. pre-condition
      n = tuple size in firmware
      m = tuple size expected by driver
   2.1. n == m
        - copy n digits into array
   2.2. n < m (new driver + old firmware)
        - allocate/zero m digits tuple array
        - copy n digits into array
   2.3. n > m (old driver + new firmware)
        - if m + 1 ~ n digits aren't all zeros, ignore this tuple
        - copy m digits into array
   3. from tuple to regular C array.

Patch 1/7~6/7 are to adjust enum and struct, and patch 7/7 is to load
TX power from firmware. The remaining patches in hand are to set TX power
to WiFi 7 chips. I will submit them later.

Firmware elements layout for reference:

  +===========================================+
  |      WiFi CPU multi-firmware              |
  |                             +-------------+
  |                             |   padding   |
  +===========================================+
  | elm ID 1 | elm size |  other header data  |
  +----------+----------+                     |
  |                                           |
  +-------------------------------------------+
  | content (variable length)                 |
  |                             +-------------+
  |                             |   padding   |
  +===========================================+
  | elm ID 2 | elm size |  other header data  |
  +----------+----------+                     |
  |                                           |
  +-------------------------------------------+
  | content (variable length)                 |
  |                   +-----------------------+
  |                   |
  +===================+

Element header:

 +===========================================+
 |  elm ID  | elm size | version  |   rsvd0  |
 +----------+----------+----------+----------+
 |        rsvd1/2      |  element_priv[]     |
 +-------------------------------------------+

Ping-Ke Shih (1):
  wifi: rtw89: add subband index of primary channel to struct rtw89_chan

Zong-Zhe Yang (6):
  wifi: rtw89: indicate TX shape table inside RFE parameter
  wifi: rtw89: indicate TX power by rate table inside RFE parameter
  wifi: rtw89: phy: refine helpers used for raw TX power
  wifi: rtw89: load TX power by rate when RFE parms setup
  wifi: rtw89: phy: extend TX power common stuffs for Wi-Fi 7 chips
  wifi: rtw89: load TX power related tables from FW elements

 drivers/net/wireless/realtek/rtw89/chan.c     |  15 +
 drivers/net/wireless/realtek/rtw89/core.c     |  25 +-
 drivers/net/wireless/realtek/rtw89/core.h     | 152 ++++-
 drivers/net/wireless/realtek/rtw89/fw.c       | 530 ++++++++++++++++++
 drivers/net/wireless/realtek/rtw89/fw.h       | 130 +++++
 drivers/net/wireless/realtek/rtw89/phy.c      |  97 ++--
 drivers/net/wireless/realtek/rtw89/phy.h      |   3 +
 drivers/net/wireless/realtek/rtw89/rtw8851b.c |   6 +-
 .../wireless/realtek/rtw89/rtw8851b_table.c   |   6 +
 .../wireless/realtek/rtw89/rtw8851b_table.h   |   3 -
 drivers/net/wireless/realtek/rtw89/rtw8852a.c |   1 -
 .../wireless/realtek/rtw89/rtw8852a_table.c   |   2 +
 .../wireless/realtek/rtw89/rtw8852a_table.h   |   1 -
 drivers/net/wireless/realtek/rtw89/rtw8852b.c |   6 +-
 .../wireless/realtek/rtw89/rtw8852b_table.c   |   4 +
 .../wireless/realtek/rtw89/rtw8852b_table.h   |   3 -
 drivers/net/wireless/realtek/rtw89/rtw8852c.c |   6 +-
 .../wireless/realtek/rtw89/rtw8852c_table.c   |   4 +
 .../wireless/realtek/rtw89/rtw8852c_table.h   |   3 -
 19 files changed, 910 insertions(+), 87 deletions(-)

-- 
2.25.1


^ permalink raw reply	[flat|nested] 9+ messages in thread

end of thread, other threads:[~2023-09-22  7:46 UTC | newest]

Thread overview: 9+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2023-09-20  7:43 [PATCH 0/7] wifi: rtw89: support to load TX power tables from firmware file Ping-Ke Shih
2023-09-20  7:43 ` [PATCH 1/7] wifi: rtw89: add subband index of primary channel to struct rtw89_chan Ping-Ke Shih
2023-09-22  7:44   ` Kalle Valo
2023-09-20  7:43 ` [PATCH 2/7] wifi: rtw89: indicate TX shape table inside RFE parameter Ping-Ke Shih
2023-09-20  7:43 ` [PATCH 3/7] wifi: rtw89: indicate TX power by rate " Ping-Ke Shih
2023-09-20  7:43 ` [PATCH 4/7] wifi: rtw89: phy: refine helpers used for raw TX power Ping-Ke Shih
2023-09-20  7:43 ` [PATCH 5/7] wifi: rtw89: load TX power by rate when RFE parms setup Ping-Ke Shih
2023-09-20  7:43 ` [PATCH 6/7] wifi: rtw89: phy: extend TX power common stuffs for Wi-Fi 7 chips Ping-Ke Shih
2023-09-20  7:43 ` [PATCH 7/7] wifi: rtw89: load TX power related tables from FW elements Ping-Ke Shih

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).