samples: subsys: crc: add samples for CRC subsystem

Add samples for CRC subsystem

Signed-off-by: Duy Vo <duy.vo.xc@bp.renesas.com>

Author: Duy Vo

samples/subsys/crc/CMakeLists.txt

@@ -0,0 +1,7 @@
+# SPDX-License-Identifier: Apache-2.0
+
+cmake_minimum_required(VERSION 3.20.0)
+find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
+project(subsys_crc_example)
+
+target_sources(app PRIVATE src/main.c)

samples/subsys/crc/README.rst

@@ -0,0 +1,61 @@
+.. zephyr:code-sample:: crc_subsys
+   :name: Cyclic Redundancy Check Subsystem (CRC Subsys)
+   :relevant-api: crc_new_interface
+
+   Compute and verify a CRC computation using the CRC subsys API.
+
+Overview
+********
+
+This sample demonstrates how to use the :ref:`CRC New Function API`
+If the board does not have a CRC chosen node, the sample will use a software-based
+CRC implementation from ``zephyr/lib/crc``.
+
+Configuration Options
+*********************
+
+This sample supports the following Kconfig options:
+
+- ``CONFIG_CRC_NEW``: Enable CRC functionality.
+- ``CONFIG_CRC_SOFTWARE_BASED``: Use a software-based CRC implementation if a CRC chosen node is present.
+- ``CONFIG_CRC_HARDWARE_ACCELERATOR``: Use hardware acceleration for CRC if a CRC chosen node is not present.
+
+These options can be modified in the project's ``prj.conf`` file or passed via CMake arguments.
+
+Building and Running
+********************
+
+Building and Running for Renesas RA8M1
+======================================
+
+The sample can be built and executed for the
+:zephyr:board:`ek_ra8m1` as follows:
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/subsys/crc
+   :board: ek_ra8m1
+   :goals: build flash
+   :compact:
+
+To build for another board, change "ek_ra8m1" above to that board's name.
+
+Sample Output
+=============
+
+.. code-block:: console
+
+   subsys_crc_example: Result of CRC32 IEEE: 0xCEA4A6C2
+   subsys_crc_example: Result of CRC8 CCITT: 0x96
+   subsys_crc_example: CRC computation completed successfully
+
+.. note::
+   If the board does not support a hardware CRC driver, the computation will fall
+   back to a software-based implementation.
+
+Expected Behavior
+*****************
+
+When the sample runs, it should:
+
+1. Compute the CRC32 and CRC8 values of predefined data.
+2. Print the computed CRC values.

samples/subsys/crc/prj.conf

@@ -0,0 +1,2 @@
+CONFIG_CRC_NEW=y
+CONFIG_LOG=y

samples/subsys/crc/sample.yaml

@@ -0,0 +1,13 @@
+sample:
+  name: CRC Subsystem
+tests:
+  samples.subsys.crc:
+    depends_on: crc
+    tags:
+      - subsys
+      - crc
+    harness: console
+    harness_config:
+      type: one_line
+      regex:
+        - "CRC computation completed successfully"

samples/subsys/crc/src/main.c

@@ -0,0 +1,41 @@
+/*
+ * Copyright (c) 2025 Renesas Electronics Corporation
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <zephyr/logging/log.h>
+LOG_MODULE_REGISTER(subsys_crc_example, CONFIG_LOG_DEFAULT_LEVEL);
+
+#include <zephyr/crc_new/crc_new.h>
+
+int main(void)
+{
+	uint32_t result;
+	uint8_t data[8] = {0x0A, 0x2B, 0x4C, 0x6D, 0x8E, 0x49, 0x00, 0xC4};
+	int ret;
+
+	/* CRC computation */
+	ret = crc32_ieee_new(data, sizeof(data), &result);
+
+	if (ret != 0) {
+		LOG_ERR("Failed compute CRC32_IEEE: %d", ret);
+		return ret;
+	}
+
+	LOG_INF("Result of CRC32 IEEE: 0x%08X", result);
+
+	/* CRC computation */
+	ret = crc8_ccitt_new(0xFF, data, sizeof(data), (uint8_t *)&result);
+
+	if (ret != 0) {
+		LOG_ERR("Failed compute CRC8_CCITT: %d", ret);
+		return ret;
+	}
+
+	LOG_INF("Result of CRC8 CCITT: 0x%02X", result & 0xFF);
+
+	LOG_INF("CRC computation completed successfully");
+
+	return 0;
+}