rpc: lib: samples: API for testing RRAM wear.

Added a library that allows testing if RRAM writes succesfully.
Made an RPC API for invoking this command on server.

Signed-off-by: Marek Porwisz <marek.porwisz@nordicsemi.no>

Author: MarekPorwisz

CODEOWNERS

@@ -339,6 +339,7 @@
 /include/caf/                             @nrfconnect/ncs-si-bluebagel @nrfconnect/ncs-si-muffin @nrfconnect/ncs-si-xcake
 /include/debug/                           @nrfconnect/ncs-co-drivers
 /include/debug/ppi_trace.h                @nrfconnect/ncs-co-drivers @nordic-krch
+/include/debug/rram_wear_test.h           @nrfconnect/ncs-protocols-serialization
 /include/dfu/                             @nrfconnect/ncs-code-owners
 /include/drivers/flash/                   @nrfconnect/ncs-co-drivers
 /include/drivers/gpio/                    @nrfconnect/ncs-co-drivers @nrfconnect/ncs-ll-ursus
@@ -392,6 +393,7 @@
 /lib/fatal_error/                         @nordic-krch
 /lib/fem_al/                              @nrfconnect/ncs-dragoon
 /lib/flash_patch/                         @nrfconnect/ncs-eris
+/lib/rram_wear_test/                     @nrfconnect/ncs-protocols-serialization
 /lib/fprotect/                            @nrfconnect/ncs-eris
 /lib/gcf_sms/                             @nrfconnect/ncs-modem
 /lib/hw_id/                               @nrfconnect/ncs-cia

include/debug/rram_wear_test.h

@@ -0,0 +1,83 @@
+/*
+ * Copyright (c) 2026 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+ */
+
+#ifndef RRAM_WEAR_TEST_H_
+#define RRAM_WEAR_TEST_H_
+
+#include <stdbool.h>
+#include <stddef.h>
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup rram_wear_test RRAM wear test
+ *
+ * Writes 0x00 then 0xFF over a flash partition (or a forced custom range on the
+ * internal flash device) and verifies readback. Intended for bring-up / stress checks.
+ * @{
+ */
+
+/**
+ * @brief Flash partition (or custom range) parameters for wear test.
+ *
+ * For @c name @c "custom", @a addr_start and @a addr_end are byte offsets on the internal
+ * flash device (@a addr_end exclusive). For any other name, offsets describe the partition
+ * span from the flash map (see @ref rram_wear_test_partition_get); the verify path still
+ * opens the area by name and ignores @a addr_* for the actual I/O.
+ *
+ * @a name may be an empty string when the partition has no DTS @c label (unnamed partition);
+ * identification then relies on the flash map / node label.
+ */
+struct rram_wear_test_partition {
+	const char *name;
+	uint64_t addr_start;
+	uint64_t addr_end;
+};
+
+/**
+ * @brief Get the number of entries in the partition table.
+ */
+size_t rram_wear_test_partition_count(void);
+
+/**
+ * @brief Fill @a out with partition name and device byte range from the flash map.
+ *
+ * @param index Row index in <tt>[0, rram_wear_test_partition_count())</tt>.
+ * @param[out] out Filled on success; @a name points at build-time string storage (possibly @c ""
+ *        when the partition has no DTS @c label).
+ *
+ * @retval 0 on success.
+ * @retval -EINVAL if @a out is NULL.
+ * @retval -ENOENT if @a index is out of range or the flash area cannot be opened.
+ */
+int rram_wear_test_partition_get(size_t index, struct rram_wear_test_partition *out);
+
+/**
+ * @brief Run write/readback verify on a named flash region or custom range.
+ *
+ * Uses the internal partition table (see @a index), or
+ * a custom byte range on the internal flash device when @a addr_end is greater than @a addr_start.
+ *
+ * @param index Partition index from the array to test.
+ * @param addr_start Optional start offset for a custom range (used if addr_end > addr_start).
+ * @param addr_end Optional end offset (exclusive) for a custom range.
+ * @param force Must be true for custom ranges or @c -EPERM is returned.
+ *
+ * @retval 0 on success, negative errno otherwise (@c -EIO on pattern mismatch).
+ */
+int rram_wear_test(size_t index, uint64_t addr_start, uint64_t addr_end, bool force);
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RRAM_WEAR_TEST_H_ */

include/nrf_rpc/rpc_utils/rram_wear_test.h

@@ -0,0 +1,78 @@
+/*
+ * Copyright (c) 2026 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+ */
+
+#ifndef NRF_RPC_RRAM_WEAR_TEST_H_
+#define NRF_RPC_RRAM_WEAR_TEST_H_
+
+#include <debug/rram_wear_test.h>
+#include <stdbool.h>
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @addtogroup nrf_rpc_utils nRF RPC utility commands
+ * @{
+ * @defgroup nrf_rpc_rram_wear_test nRF RPC flash wear test
+ * @{
+ */
+
+/** @brief Run write/readback verify on a selected remote flash region.
+ *
+ * @param index Partition index from the array.
+ * @param addr_start Optional start offset for a custom range (used if addr_end > addr_start).
+ * @param addr_end Optional end offset (exclusive) for a custom range.
+ * @param force Must be true for custom ranges or @c -EPERM is returned.
+ *
+ * @retval 0 on success.
+ * @retval -EPERM if @a region is @c custom and @a force is false.
+ * @retval -EINVAL for invalid arguments or an out-of-bounds custom range.
+ * @retval -ENOENT if the named partition is not present in the build.
+ * @retval -ENODEV if the flash device cannot be resolved for a custom range.
+ * @retval Other negative errno from flash operations, or @c -EIO on verify mismatch.
+ * @retval -EBADMSG if the RPC response could not be decoded.
+ */
+int nrf_rpc_rram_wear_test(size_t index, uint64_t addr_start, uint64_t addr_end, bool force);
+
+/** @brief Get the number of partitions from the remote server.
+ *
+ * @param[out] count Pointer to store the number of partitions.
+ *
+ * @retval 0 on success.
+ * @retval -EBADMSG if the RPC response could not be decoded.
+ */
+int nrf_rpc_rram_wear_test_get_partition_count(size_t *count);
+
+/** @brief Get partition details from the remote server.
+ *
+ * @param index Partition index.
+ * @param[out] part Pointer to store the partition details. The name string will be allocated
+ *                  internally and must be freed by the caller using
+ *                  @ref nrf_rpc_rram_wear_test_partition_free.
+ *
+ * @retval 0 on success.
+ * @retval -EBADMSG if the RPC response could not be decoded.
+ */
+int nrf_rpc_rram_wear_test_get_partition(size_t index, struct rram_wear_test_partition *part);
+
+/** @brief Free memory allocated by @ref nrf_rpc_rram_wear_test_get_partition.
+ *
+ * @param part Pointer to the partition structure whose memory should be freed.
+ */
+void nrf_rpc_rram_wear_test_partition_free(struct rram_wear_test_partition *part);
+
+/**
+ * @}
+ * @}
+ */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* NRF_RPC_RRAM_WEAR_TEST_H_ */

lib/CMakeLists.txt

@@ -21,6 +21,7 @@ add_subdirectory_ifdef(CONFIG_ACCEL_TO_ANGLE accel_to_angle)
 add_subdirectory_ifdef(CONFIG_ADP536X adp536x)
 add_subdirectory_ifdef(CONFIG_ST25R3911B_LIB st25r3911b)
 add_subdirectory_ifdef(CONFIG_FPROTECT fprotect)
+add_subdirectory_ifdef(CONFIG_RRAM_WEAR_TEST rram_wear_test)
 add_subdirectory(flash_patch)
 add_subdirectory_ifdef(CONFIG_RAM_POWER_DOWN_LIBRARY ram_pwrdn)
 add_subdirectory(fatal_error)

lib/Kconfig

@@ -14,6 +14,7 @@ rsource "accel_to_angle/Kconfig"
 rsource "at_monitor/Kconfig"
 rsource "st25r3911b/Kconfig"
 rsource "flash_patch/Kconfig"
+rsource "rram_wear_test/Kconfig"
 rsource "lte_link_control/Kconfig"
 rsource "ntn/Kconfig"
 rsource "fprotect/Kconfig"

lib/rram_wear_test/CMakeLists.txt

@@ -0,0 +1,9 @@
+#
+# Copyright (c) 2026 Nordic Semiconductor ASA
+#
+# SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+#
+
+zephyr_library()
+
+zephyr_library_sources(rram_wear_test.c)

lib/rram_wear_test/Kconfig

@@ -0,0 +1,20 @@
+#
+# Copyright (c) 2026 Nordic Semiconductor ASA
+#
+# SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+#
+
+config RRAM_WEAR_TEST
+	bool "RRAM wear test library [EXPERIMENTAL]"
+	depends on FLASH
+	depends on FLASH_MAP
+	depends on SOC_FLASH_NRF_RRAM
+	select EXPERIMENTAL
+	help
+	  Library that writes 0x00 / 0xFF patterns over a flash partition (or a forced
+	  custom range) and verifies readback. Used by nRF RPC utilities and callable
+	  directly from in-tree applications.
+
+module = RRAM_WEAR_TEST
+module-str = rram_wear_test
+source "subsys/logging/Kconfig.template.log_config"