drivers: firmware: nrf_ironside: Update the spelling

57300 · danieldegrasse · commit 75dd614437d8 · 2025-07-02T17:57:45.000-05:00
s/IRONside/IronSide/g

Signed-off-by: Grzegorz Swiderski &lt;grzegorz.swiderski@nordicsemi.no&gt;
diff --git a/boards/nordic/nrf54h20dk/nrf54h20dk_nrf54h20_cpuapp_iron_0_9_0.yaml b/boards/nordic/nrf54h20dk/nrf54h20dk_nrf54h20_cpuapp_iron_0_9_0.yaml
@@ -2,7 +2,7 @@
 # SPDX-License-Identifier: Apache-2.0
 
 identifier: nrf54h20dk/nrf54h20/cpuapp/iron
-name: nRF54H20-DK-nRF54H20-Application (IRONside compatible) (revision 0.9.0)
+name: nRF54H20-DK-nRF54H20-Application (IronSide compatible) (revision 0.9.0)
 type: mcu
 arch: arm
 toolchain:
diff --git a/boards/nordic/nrf54h20dk/nrf54h20dk_nrf54h20_cpurad_iron_0_9_0.yaml b/boards/nordic/nrf54h20dk/nrf54h20dk_nrf54h20_cpurad_iron_0_9_0.yaml
@@ -2,7 +2,7 @@
 # SPDX-License-Identifier: Apache-2.0
 
 identifier: nrf54h20dk/nrf54h20/cpurad/iron
-name: nRF54H20-DK-nRF54H20-Radio (IRONside SE compatible) (revision 0.9.0)
+name: nRF54H20-DK-nRF54H20-Radio (IronSide SE compatible) (revision 0.9.0)
 type: mcu
 arch: arm
 toolchain:
diff --git a/drivers/firmware/nrf_ironside/Kconfig b/drivers/firmware/nrf_ironside/Kconfig
@@ -5,7 +5,7 @@ config NRF_IRONSIDE
 	bool
 	depends on SOC_NRF54H20_IRON || SOC_NRF9280_IRON
 	help
-	  This is selected by drivers interacting with Nordic IRONside firmware.
+	  This is selected by drivers interacting with Nordic IronSide firmware.
 
 config NRF_IRONSIDE_CALL
 	bool
@@ -14,44 +14,44 @@ config NRF_IRONSIDE_CALL
 	select EVENTS
 	select MBOX
 	help
-	  This is selected by features that require support for IRONside calls.
+	  This is selected by features that require support for IronSide calls.
 
 if NRF_IRONSIDE_CALL
 
 config NRF_IRONSIDE_CALL_INIT_PRIORITY
-	int "IRONside calls' initialization priority"
+	int "IronSide calls' initialization priority"
 	default 41
 	help
-	  Initialization priority of IRONside calls. It must be below MBOX_INIT_PRIORITY,
+	  Initialization priority of IronSide calls. It must be below MBOX_INIT_PRIORITY,
 	  but higher than the priority of any feature that selects NRF_IRONSIDE_CALL.
 
 endif # NRF_IRONSIDE_CALL
 
-menu "Nordic IRONside services"
+menu "Nordic IronSide services"
 	depends on SOC_NRF54H20_IRON || SOC_NRF9280_IRON
 
 config NRF_IRONSIDE_CPUCONF_SERVICE
-	bool "IRONside CPUCONF service"
+	bool "IronSide CPUCONF service"
 	depends on SOC_NRF54H20_CPUAPP || SOC_NRF9280_CPUAPP
 	select NRF_IRONSIDE_CALL
 	help
 	  Service used to boot local domain cores.
 
 config NRF_IRONSIDE_UPDATE_SERVICE
-	bool "IRONside update service"
+	bool "IronSide update service"
 	select NRF_IRONSIDE_CALL
 	help
-	  Service used to update the IRONside SE firmware.
+	  Service used to update the IronSide SE firmware.
 
 config NRF_IRONSIDE_BOOT_REPORT
-	bool "IRONside boot report"
+	bool "IronSide boot report"
 	depends on $(dt_nodelabel_exists,ironside_se_boot_report)
 	select NRF_IRONSIDE
 	help
-	  Support for parsing the Boot Report populated by Nordic IRONside firmware.
+	  Support for parsing the Boot Report populated by Nordic IronSide firmware.
 
 config NRF_IRONSIDE_DVFS_SERVICE
-	bool "IRONside DVFS service"
+	bool "IronSide DVFS service"
 	depends on SOC_NRF54H20_CPUAPP
 	select NRF_IRONSIDE_CALL
 	help
diff --git a/drivers/firmware/nrf_ironside/dvfs.c b/drivers/firmware/nrf_ironside/dvfs.c
@@ -15,7 +15,7 @@ static enum ironside_dvfs_oppoint current_dvfs_oppoint = IRONSIDE_DVFS_OPP_HIGH;
 #define ABB_STATUSANA_LOCKED_L_Msk (0x1UL << ABB_STATUSANA_LOCKED_L_Pos)
 #define ABB_STATUSANA_REG_OFFSET   (0x102UL)
 #else
-#error "Unsupported SoC series for IRONside DVFS"
+#error "Unsupported SoC series for IronSide DVFS"
 #endif
 
 struct dvfs_hsfll_data_t {
@@ -133,8 +133,8 @@ static inline bool ironside_dvfs_is_abb_locked(NRF_ABB_Type *abb)
 }
 
 /**
- * @brief Request DVFS oppoint change from IRONside secure domain.
- * This function will send a request over IPC to the IRONside secure domain
+ * @brief Request DVFS oppoint change from IronSide secure domain.
+ * This function will send a request over IPC to the IronSide secure domain
  * This function is synchronous and will return when the request is completed.
  *
  * @param oppoint @ref enum ironside_dvfs_oppoint
diff --git a/dts/bindings/firmware/nordic,ironside-call.yaml b/dts/bindings/firmware/nordic,ironside-call.yaml
@@ -1,7 +1,7 @@
 # Copyright (c) 2025 Nordic Semiconductor ASA
 # SPDX-License-Identifier: Apache-2.0
 
-description: IPC configuration for Nordic IRONside calls
+description: IPC configuration for Nordic IronSide calls
 
 compatible: "nordic,ironside-call"
 
diff --git a/include/zephyr/drivers/firmware/nrf_ironside/boot_report.h b/include/zephyr/drivers/firmware/nrf_ironside/boot_report.h
@@ -9,14 +9,14 @@
 #include <stdint.h>
 #include <stddef.h>
 
-/** Constant used to check if an Nordic IRONside SE boot report has been written. */
+/** Constant used to check if an Nordic IronSide SE boot report has been written. */
 #define IRONSIDE_BOOT_REPORT_MAGIC                     (0x4d69546fUL)
 /** Length of the local domain context buffer in bytes. */
 #define IRONSIDE_BOOT_REPORT_LOCAL_DOMAIN_CONTEXT_SIZE (16UL)
 /** Length of the random data buffer in bytes. */
 #define IRONSIDE_BOOT_REPORT_RANDOM_DATA_SIZE          (32UL)
 
-/** @brief IRONside version structure. */
+/** @brief IronSide version structure. */
 struct ironside_version {
 	/** Wrapping sequence number ranging from 1-126, incremented for each release. */
 	uint8_t seqnum;
@@ -43,13 +43,13 @@ struct ironside_boot_report_uicr_error {
 	} description;
 };
 
-/** @brief IRONside boot report. */
+/** @brief IronSide boot report. */
 struct ironside_boot_report {
 	/** Magic value used to identify valid boot report */
 	uint32_t magic;
-	/** Firmware version of IRONside SE. */
+	/** Firmware version of IronSide SE. */
 	struct ironside_version ironside_se_version;
-	/** Firmware version of IRONside SE recovery firmware. */
+	/** Firmware version of IronSide SE recovery firmware. */
 	struct ironside_version ironside_se_recovery_version;
 	/** Copy of SICR.UROT.UPDATE.STATUS.*/
 	uint32_t ironside_update_status;
@@ -64,9 +64,9 @@ struct ironside_boot_report {
 };
 
 /**
- * @brief Get a pointer to the IRONside boot report.
+ * @brief Get a pointer to the IronSide boot report.
  *
- * @param[out] report Will be set to point to the IRONside boot report.
+ * @param[out] report Will be set to point to the IronSide boot report.
  *
  * @retval 0 if successful.
  * @retval -EFAULT if the magic field in the report is incorrect.
diff --git a/include/zephyr/drivers/firmware/nrf_ironside/call.h b/include/zephyr/drivers/firmware/nrf_ironside/call.h
@@ -8,7 +8,7 @@
 
 #include <stdint.h>
 
-/** @brief Maximum number of arguments to an IRONside call.
+/** @brief Maximum number of arguments to an IronSide call.
  *
  * This is chosen so that the containing message buffer size is minimal but
  * cache line aligned.
@@ -50,7 +50,7 @@ struct ironside_call_buf {
  */
 
 /**
- * @brief Allocate memory for an IRONside call.
+ * @brief Allocate memory for an IronSide call.
  *
  * This function will block when no buffers are available, until one is
  * released by another thread on the client side.
@@ -60,7 +60,7 @@ struct ironside_call_buf {
 struct ironside_call_buf *ironside_call_alloc(void);
 
 /**
- * @brief Dispatch an IRONside call.
+ * @brief Dispatch an IronSide call.
  *
  * This function will block until a response is received from the server.
  *
@@ -71,7 +71,7 @@ struct ironside_call_buf *ironside_call_alloc(void);
 void ironside_call_dispatch(struct ironside_call_buf *buf);
 
 /**
- * @brief Release an IRONside call buffer.
+ * @brief Release an IronSide call buffer.
  *
  * This function must be called after processing the response.
  *
diff --git a/include/zephyr/drivers/firmware/nrf_ironside/cpuconf.h b/include/zephyr/drivers/firmware/nrf_ironside/cpuconf.h
@@ -63,7 +63,7 @@ BUILD_ASSERT(IRONSIDE_CPUCONF_NUM_ARGS <= NRF_IRONSIDE_CALL_NUM_ARGS);
  * If the given msg_size is less than that, the remaining bytes are set to zero.
  *
  * @retval 0 on success or if the CPU has already booted.
- * @retval Positive non-0 error status if reported by IRONside call.
+ * @retval Positive non-0 error status if reported by IronSide call.
  * @retval -IRONSIDE_CPUCONF_ERROR_WRONG_CPU if cpu is unrecognized
  * @retval -IRONSIDE_CPUCONF_ERROR_MESSAGE_TOO_LARGE if msg_size is greater than
  * IRONSIDE_CPUCONF_SERVICE_MSG_MAX_SIZE.
diff --git a/include/zephyr/drivers/firmware/nrf_ironside/dvfs.h b/include/zephyr/drivers/firmware/nrf_ironside/dvfs.h
@@ -18,15 +18,15 @@ enum ironside_dvfs_oppoint {
 };
 
 /**
- * @brief Number of DVFS oppoints supported by IRONside.
+ * @brief Number of DVFS oppoints supported by IronSide.
  *
- * This is the number of different DVFS oppoints that can be set on IRONside.
+ * This is the number of different DVFS oppoints that can be set on IronSide.
  * The oppoints are defined in the `ironside_dvfs_oppoint` enum.
  */
 #define IRONSIDE_DVFS_OPPOINT_COUNT (3)
 
 /**
- * @name IRONside DVFS service error codes.
+ * @name IronSide DVFS service error codes.
  * @{
  */
 
@@ -49,10 +49,10 @@ enum ironside_dvfs_oppoint {
  * @}
  */
 
-/* IRONside call identifiers with implicit versions.
+/* IronSide call identifiers with implicit versions.
  *
  * With the initial "version 0", the service ABI is allowed to break until the
- * first production release of IRONside SE.
+ * first production release of IronSide SE.
  */
 #define IRONSIDE_CALL_ID_DVFS_SERVICE_V0 3
 
diff --git a/include/zephyr/drivers/firmware/nrf_ironside/update.h b/include/zephyr/drivers/firmware/nrf_ironside/update.h
@@ -30,10 +30,10 @@
 /** Length of the update signature in bytes. */
 #define IRONSIDE_UPDATE_SIGNATURE_LENGTH (64)
 
-/* IRONside call identifiers with implicit versions.
+/* IronSide call identifiers with implicit versions.
  *
  * With the initial "version 0", the service ABI is allowed to break until the
- * first production release of IRONside SE.
+ * first production release of IronSide SE.
  */
 #define IRONSIDE_CALL_ID_UPDATE_SERVICE_V0 1
 
@@ -43,7 +43,7 @@
 #define IRONSIDE_UPDATE_SERVICE_RETCODE_IDX (0)
 
 /**
- * @brief IRONside update blob.
+ * @brief IronSide update blob.
  */
 struct ironside_update_blob {
 	uint8_t manifest[IRONSIDE_UPDATE_MANIFEST_LENGTH];
@@ -53,17 +53,17 @@ struct ironside_update_blob {
 };
 
 /**
- * @brief Request a firmware upgrade of the IRONside SE.
+ * @brief Request a firmware upgrade of the IronSide SE.
  *
- * This invokes the IRONside SE update service. The device must be restarted for the update
+ * This invokes the IronSide SE update service. The device must be restarted for the update
  * to be installed. Check the update status in the application boot report to see if the update
  * was successfully installed.
  *
  * @param update Pointer to update blob
  *
  * @retval -IRONSIDE_UPDATE_ERROR_NOT_PERMITTED if missing access to the update candidate.
  * @retval -IRONSIDE_UPDATE_ERROR_SICR_WRITE_FAILED if writing update parameters to SICR failed.
- * @returns Positive non-0 error status if reported by IRONside call.
+ * @returns Positive non-0 error status if reported by IronSide call.
  * @returns 0 on a successful request (although the update itself may still fail).
  *
  */
diff --git a/samples/boards/nordic/nrf_ironside/update/Kconfig b/samples/boards/nordic/nrf_ironside/update/Kconfig
@@ -6,6 +6,6 @@ config UPDATE_BLOB_ADDRESS
 	default 0xe100000
 	help
 	  Address of the update blob. The default value matches the placement of the
-	  update blobs delivered with the IRONside SE firmware.
+	  update blobs delivered with the IronSide SE firmware.
 
 source "Kconfig.zephyr"
diff --git a/samples/boards/nordic/nrf_ironside/update/README.rst b/samples/boards/nordic/nrf_ironside/update/README.rst
@@ -1,24 +1,24 @@
 .. zephyr:code-sample:: nrf_ironside_update
-   :name: Nordic IRONside SE firmware update
+   :name: Nordic IronSide SE firmware update
 
-   Update the Nordic IRONside SE firmware.
+   Update the Nordic IronSide SE firmware.
 
 Overview
 ********
 
-The Nordic IRONside SE Update sample updates the IRONside SE firmware on a SoC that already has IRONside SE installed.
-It can update both the main image and the recovery image of IRONside SE using the IRONside SE firmware release ZIP file.
+The Nordic IronSide SE Update sample updates the IronSide SE firmware on a SoC that already has IronSide SE installed.
+It can update both the main image and the recovery image of IronSide SE using the IronSide SE firmware release ZIP file.
 
 Update procedure
 ****************
 
 The update procedure works as follows:
 
-1. The application invokes the IRONside SE update service and passes the parameters that correspond to the location of the HEX file of the IRONside SE firmware update.
+1. The application invokes the IronSide SE update service and passes the parameters that correspond to the location of the HEX file of the IronSide SE firmware update.
 
 #. The application prints the return value of the service call and outputs information from the update HEX file.
 
-#. After the service call completes, the IRONside SE firmware updates the internal state of the device.
+#. After the service call completes, the IronSide SE firmware updates the internal state of the device.
 
 #. The firmware installs the update during the next device boot.
    This operation can take several seconds.
@@ -29,23 +29,23 @@ Building and running the application for nrf54h20dk/nrf54h20/cpuapp/iron
 ************************************************************************
 
 .. note::
-   You can use this application only when there is already a version of IRONside SE installed on the device.
+   You can use this application only when there is already a version of IronSide SE installed on the device.
 
-1. Unzip the IRONside SE release ZIP to get the update hex file:
+1. Unzip the IronSide SE release ZIP to get the update hex file:
 
    .. code-block:: console
 
       unzip nrf54h20_soc_binaries_v.*.zip
 
 #. Program the appropriate update hex file from the release ZIP using one (not both) of the following commands:
 
-   a) To update IRONside SE firmware:
+   a) To update IronSide SE firmware:
 
       .. code-block:: console
 
          nrfutil device program --traits jlink --firmware update/ironside_se_update.hex
 
-   b) To update IRONside SE recovery firmware:
+   b) To update IronSide SE recovery firmware:
 
       .. code-block:: console
 
diff --git a/samples/boards/nordic/nrf_ironside/update/sample.yaml b/samples/boards/nordic/nrf_ironside/update/sample.yaml
@@ -1,6 +1,6 @@
 sample:
-  name: Nordic IRONside SE update service
-  description: Demonstrates how to update the Nordic IRONside SE firmware
+  name: Nordic IronSide SE update service
+  description: Demonstrates how to update the Nordic IronSide SE firmware
 common:
   build_only: true
   tags: nrf_ironside
diff --git a/samples/boards/nordic/nrf_ironside/update/src/main.c b/samples/boards/nordic/nrf_ironside/update/src/main.c
@@ -28,7 +28,7 @@ int main(void)
 	LOG_HEXDUMP_INF((void *)report->random_data, sizeof(report->random_data), "random data");
 
 	err = ironside_update(update);
-	LOG_INF("IRONside update retval: 0x%x", err);
+	LOG_INF("IronSide update retval: 0x%x", err);
 
 	if (err == 0) {
 		LOG_HEXDUMP_INF(update->manifest, sizeof(update->manifest), "Update manifest:");
diff --git a/soc/nordic/nrf54h/Kconfig.soc b/soc/nordic/nrf54h/Kconfig.soc
@@ -36,7 +36,7 @@ config SOC_NRF54H20_CPUFLPR
 config SOC_NRF54H20_IRON
 	bool
 	help
-	  Indicates that local domain firmware is compatible with Nordic IRONside SE.
+	  Indicates that local domain firmware is compatible with Nordic IronSide SE.
 
 config SOC
 	default "nrf54h20" if SOC_NRF54H20
diff --git a/soc/nordic/nrf92/Kconfig.soc b/soc/nordic/nrf92/Kconfig.soc
@@ -65,7 +65,7 @@ config SOC_NRF9280_CPUPPR
 config SOC_NRF9280_IRON
 	bool
 	help
-	  Indicates that local domain firmware is compatible with Nordic IRONside SE.
+	  Indicates that local domain firmware is compatible with Nordic IronSide SE.
 
 config SOC
 	default "nrf9280" if SOC_NRF9280

Original file line number	Diff line number	Diff line change
`@@ -8,7 +8,7 @@`
`8`	`8`
`9`	`9`	`#include <stdint.h>`
`10`	`10`
`11`		`-/** @brief Maximum number of arguments to an IRONside call.`
	`11`	`+/** @brief Maximum number of arguments to an IronSide call.`
`12`	`12`	`*`
`13`	`13`	`* This is chosen so that the containing message buffer size is minimal but`
`14`	`14`	`* cache line aligned.`
`@@ -50,7 +50,7 @@ struct ironside_call_buf {`
`50`	`50`	`*/`
`51`	`51`
`52`	`52`	`/**`
`53`		`- * @brief Allocate memory for an IRONside call.`
	`53`	`+ * @brief Allocate memory for an IronSide call.`
`54`	`54`	`*`
`55`	`55`	`* This function will block when no buffers are available, until one is`
`56`	`56`	`* released by another thread on the client side.`
`@@ -60,7 +60,7 @@ struct ironside_call_buf {`
`60`	`60`	`struct ironside_call_buf *ironside_call_alloc(void);`
`61`	`61`
`62`	`62`	`/**`
`63`		`- * @brief Dispatch an IRONside call.`
	`63`	`+ * @brief Dispatch an IronSide call.`
`64`	`64`	`*`
`65`	`65`	`* This function will block until a response is received from the server.`
`66`	`66`	`*`
`@@ -71,7 +71,7 @@ struct ironside_call_buf *ironside_call_alloc(void);`
`71`	`71`	`void ironside_call_dispatch(struct ironside_call_buf *buf);`
`72`	`72`
`73`	`73`	`/**`
`74`		`- * @brief Release an IRONside call buffer.`
	`74`	`+ * @brief Release an IronSide call buffer.`
`75`	`75`	`*`
`76`	`76`	`* This function must be called after processing the response.`
`77`	`77`	`*`
Original file line number	Diff line number	Diff line change
`@@ -63,7 +63,7 @@ BUILD_ASSERT(IRONSIDE_CPUCONF_NUM_ARGS <= NRF_IRONSIDE_CALL_NUM_ARGS);`
`63`	`63`	`* If the given msg_size is less than that, the remaining bytes are set to zero.`
`64`	`64`	`*`
`65`	`65`	`* @retval 0 on success or if the CPU has already booted.`
`66`		`- * @retval Positive non-0 error status if reported by IRONside call.`
	`66`	`+ * @retval Positive non-0 error status if reported by IronSide call.`
`67`	`67`	`* @retval -IRONSIDE_CPUCONF_ERROR_WRONG_CPU if cpu is unrecognized`
`68`	`68`	`* @retval -IRONSIDE_CPUCONF_ERROR_MESSAGE_TOO_LARGE if msg_size is greater than`
`69`	`69`	`* IRONSIDE_CPUCONF_SERVICE_MSG_MAX_SIZE.`