[PATCH wireless-next 08/10] wifi: cw1200: load the XR819 bootloader into SRAM

From: Arthur Heymans

Date: Thu Nov 19 2026 - 12:51:09 EST


XR819 shares the CW1x60 revision field but needs a first-stage loader
at 0x08000000. Write it before releasing the CPU from reset, then use
the existing firmware download path.

Prepared with OpenAI Codex.

Signed-off-by: Arthur Heymans <arthur@xxxxxxxxxxxx>
---
drivers/net/wireless/st/cw1200/cw1200.h | 8 +++
drivers/net/wireless/st/cw1200/fwio.c | 67 +++++++++++++++++++++++--
drivers/net/wireless/st/cw1200/fwio.h | 3 ++
drivers/net/wireless/st/cw1200/hwio.h | 1 +
drivers/net/wireless/st/cw1200/main.c | 37 +++++++++++---
5 files changed, 105 insertions(+), 11 deletions(-)

diff --git a/drivers/net/wireless/st/cw1200/cw1200.h b/drivers/net/wireless/st/cw1200/cw1200.h
index 6dc85ef6e0fa..b25b60d377f6 100644
--- a/drivers/net/wireless/st/cw1200/cw1200.h
+++ b/drivers/net/wireless/st/cw1200/cw1200.h
@@ -116,7 +116,9 @@ struct cw1200_common {
CW1200_HW_REV_CUT20 = 20,
CW1200_HW_REV_CUT22 = 22,
CW1X60_HW_REV = 40,
+ XR819_HW_REV = 41,
} hw_revision;
+ bool is_xr819;
int hw_refclk;
bool hw_have_5ghz;
const struct firmware *sdd;
@@ -293,6 +295,12 @@ int cw1200_core_probe(const struct hwbus_ops *hwbus_ops,
struct cw1200_common **pself,
int ref_clk, const u8 *macaddr,
const char *sdd_path, bool have_5ghz);
+int cw1200_core_probe_xr819(const struct hwbus_ops *hwbus_ops,
+ struct hwbus_priv *hwbus,
+ struct device *pdev,
+ struct cw1200_common **pself,
+ int ref_clk, const u8 *macaddr,
+ const char *sdd_path);
void cw1200_core_unregister(struct cw1200_common *self);
void cw1200_core_release(struct cw1200_common *self);

diff --git a/drivers/net/wireless/st/cw1200/fwio.c b/drivers/net/wireless/st/cw1200/fwio.c
index 2a03dc533b6a..08b6f02e3ffd 100644
--- a/drivers/net/wireless/st/cw1200/fwio.c
+++ b/drivers/net/wireless/st/cw1200/fwio.c
@@ -14,6 +14,7 @@
#include <linux/vmalloc.h>
#include <linux/sched.h>
#include <linux/firmware.h>
+#include <linux/unaligned.h>

#include "cw1200.h"
#include "fwio.h"
@@ -116,6 +117,11 @@ static int cw1200_load_firmware_cw1200(struct cw1200_common *priv)
if (!priv->sdd_path)
priv->sdd_path = SDD_FILE_CW1X60;
break;
+ case XR819_HW_REV:
+ fw_path = FIRMWARE_XR819;
+ if (!priv->sdd_path)
+ priv->sdd_path = SDD_FILE_XR819;
+ break;
default:
pr_err("Invalid silicon revision %d.\n", priv->hw_revision);
return -EINVAL;
@@ -128,9 +134,11 @@ static int cw1200_load_firmware_cw1200(struct cw1200_common *priv)
APB_WRITE(DOWNLOAD_STATUS_REG, DOWNLOAD_PENDING);
APB_WRITE(DOWNLOAD_FLAGS_REG, 0);

- /* Write the NOP Instruction */
- REG_WRITE(ST90TDS_SRAM_BASE_ADDR_REG_ID, 0xFFF20000);
- REG_WRITE(ST90TDS_AHB_DPORT_REG_ID, 0xEAFFFFFE);
+ if (!priv->is_xr819) {
+ /* Write the NOP Instruction */
+ REG_WRITE(ST90TDS_SRAM_BASE_ADDR_REG_ID, 0xFFF20000);
+ REG_WRITE(ST90TDS_AHB_DPORT_REG_ID, 0xEAFFFFFE);
+ }

/* Release CPU from RESET */
REG_READ(ST90TDS_CONFIG_REG_ID, val32);
@@ -261,6 +269,45 @@ static int cw1200_load_firmware_cw1200(struct cw1200_common *priv)
#undef REG_READ
}

+static int cw1200_load_bootloader_xr819(struct cw1200_common *priv)
+{
+ const struct firmware *bootloader;
+ u32 addr = XR819_BOOT_BASE;
+ size_t i;
+ int ret;
+
+ ret = request_firmware(&bootloader, BOOTLOADER_XR819, priv->pdev);
+ if (ret) {
+ dev_err(priv->pdev, "can't load bootloader file %s\n",
+ BOOTLOADER_XR819);
+ return ret;
+ }
+
+ if (!bootloader->size || bootloader->size > U32_MAX - addr ||
+ !IS_ALIGNED(bootloader->size, sizeof(u32))) {
+ dev_err(priv->pdev, "invalid bootloader size %zu\n", bootloader->size);
+ ret = -EINVAL;
+ goto release;
+ }
+
+ for (i = 0; i < bootloader->size; i += sizeof(u32), addr += sizeof(u32)) {
+ u32 word = get_unaligned_le32(bootloader->data + i);
+
+ ret = cw1200_reg_write_32(priv, ST90TDS_SRAM_BASE_ADDR_REG_ID,
+ addr);
+ if (ret)
+ goto release;
+
+ ret = cw1200_reg_write_32(priv, ST90TDS_AHB_DPORT_REG_ID, word);
+ if (ret)
+ goto release;
+ }
+
+release:
+ release_firmware(bootloader);
+ return ret;
+}
+

static int config_reg_read(struct cw1200_common *priv, u32 *val)
{
@@ -443,8 +490,13 @@ int cw1200_load_firmware(struct cw1200_common *priv)
break;
}
case 4:
- pr_info("CW1x60 silicon detected.\n");
- priv->hw_revision = CW1X60_HW_REV;
+ if (priv->is_xr819) {
+ dev_info(priv->pdev, "XR819 silicon detected\n");
+ priv->hw_revision = XR819_HW_REV;
+ } else {
+ pr_info("CW1x60 silicon detected.\n");
+ priv->hw_revision = CW1X60_HW_REV;
+ }
break;
default:
pr_err("Unsupported silicon major revision %d.\n",
@@ -473,6 +525,11 @@ int cw1200_load_firmware(struct cw1200_common *priv)
ret = -ENOTSUPP;
goto out;
}
+ if (priv->is_xr819) {
+ ret = cw1200_load_bootloader_xr819(priv);
+ if (ret)
+ goto out;
+ }
ret = cw1200_load_firmware_cw1200(priv);
break;
default:
diff --git a/drivers/net/wireless/st/cw1200/fwio.h b/drivers/net/wireless/st/cw1200/fwio.h
index c287160a492e..a3effef6d500 100644
--- a/drivers/net/wireless/st/cw1200/fwio.h
+++ b/drivers/net/wireless/st/cw1200/fwio.h
@@ -25,6 +25,9 @@
#define SDD_FILE_20 "sdd_20.bin"
#define SDD_FILE_11 "sdd_11.bin"
#define SDD_FILE_10 "sdd_10.bin"
+#define BOOTLOADER_XR819 "xr819/boot_xr819.bin"
+#define FIRMWARE_XR819 "xr819/fw_xr819.bin"
+#define SDD_FILE_XR819 "xr819/sdd_xr819.bin"

int cw1200_load_firmware(struct cw1200_common *priv);

diff --git a/drivers/net/wireless/st/cw1200/hwio.h b/drivers/net/wireless/st/cw1200/hwio.h
index d1e629a566c2..376dd1525fe2 100644
--- a/drivers/net/wireless/st/cw1200/hwio.h
+++ b/drivers/net/wireless/st/cw1200/hwio.h
@@ -89,6 +89,7 @@ struct download_cntl_t {


#define SYS_BASE_ADDR_SILICON (0)
+#define XR819_BOOT_BASE 0x08000000
#define PAC_BASE_ADDRESS_SILICON (SYS_BASE_ADDR_SILICON + 0x09000000)
#define PAC_SHARED_MEMORY_SILICON (PAC_BASE_ADDRESS_SILICON)

diff --git a/drivers/net/wireless/st/cw1200/main.c b/drivers/net/wireless/st/cw1200/main.c
index ee9fcecb0100..998b8e45e503 100644
--- a/drivers/net/wireless/st/cw1200/main.c
+++ b/drivers/net/wireless/st/cw1200/main.c
@@ -515,12 +515,13 @@ u32 cw1200_dpll_from_clk(u16 clk_khz)
}
}

-int cw1200_core_probe(const struct hwbus_ops *hwbus_ops,
- struct hwbus_priv *hwbus,
- struct device *pdev,
- struct cw1200_common **core,
- int ref_clk, const u8 *macaddr,
- const char *sdd_path, bool have_5ghz)
+static int __cw1200_core_probe(const struct hwbus_ops *hwbus_ops,
+ struct hwbus_priv *hwbus,
+ struct device *pdev,
+ struct cw1200_common **core,
+ int ref_clk, const u8 *macaddr,
+ const char *sdd_path, bool have_5ghz,
+ bool is_xr819)
{
int err = -EINVAL;
struct ieee80211_hw *dev;
@@ -535,6 +536,7 @@ int cw1200_core_probe(const struct hwbus_ops *hwbus_ops,
goto err;

priv = dev->priv;
+ priv->is_xr819 = is_xr819;
priv->hw_refclk = ref_clk;
if (cw1200_refclk)
priv->hw_refclk = cw1200_refclk;
@@ -590,8 +592,31 @@ int cw1200_core_probe(const struct hwbus_ops *hwbus_ops,
*core = NULL;
return err;
}
+
+int cw1200_core_probe(const struct hwbus_ops *hwbus_ops,
+ struct hwbus_priv *hwbus,
+ struct device *pdev,
+ struct cw1200_common **core,
+ int ref_clk, const u8 *macaddr,
+ const char *sdd_path, bool have_5ghz)
+{
+ return __cw1200_core_probe(hwbus_ops, hwbus, pdev, core, ref_clk,
+ macaddr, sdd_path, have_5ghz, false);
+}
EXPORT_SYMBOL_GPL(cw1200_core_probe);

+int cw1200_core_probe_xr819(const struct hwbus_ops *hwbus_ops,
+ struct hwbus_priv *hwbus,
+ struct device *pdev,
+ struct cw1200_common **core,
+ int ref_clk, const u8 *macaddr,
+ const char *sdd_path)
+{
+ return __cw1200_core_probe(hwbus_ops, hwbus, pdev, core, ref_clk,
+ macaddr, sdd_path, false, true);
+}
+EXPORT_SYMBOL_GPL(cw1200_core_probe_xr819);
+
/*
* Removing the interfaces sends WSM commands, which need the device
* interrupt for their confirmations, so the bus driver calls this before
--
2.56.0