Added generic BSP framework and PolarFire SoC Icicle Kit target

.github/workflows/ci.yml

@@ -0,0 +1,103 @@
+#
+# Copyright (c) 2026 Eclipse ThreadX contributors
+#
+# This program and the accompanying materials are made available
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+#
+# SPDX-License-Identifier: MIT
+#
+
+name: SampleX CI Verification Pipeline
+
+on:
+ push:
+ branches: [ main, master, dev, 'feat/**' ]
+ pull_request:
+ branches: [ main, master, dev ]
+
+jobs:
+ build-riscv-polarfire:
+ name: Build PolarFire SoC Icicle Kit (64-Bit RISC-V)
+ runs-on: ubuntu-24.04
+ timeout-minutes: 20
+ steps:
+ - name: Checkout Repository
+ uses: actions/checkout@v4
+ with:
+ submodules: recursive
+
+ - name: Install CMake and Ninja
+ run: |
+ sudo apt-get update
+ sudo apt-get install -y cmake ninja-build
+
+ - name: Install Pinned xPack RISC-V GCC 14.2.0
+ env:
+ XPACK_TARBALL: xpack-riscv-none-elf-gcc-14.2.0-1-linux-x64.tar.gz
+ XPACK_SHA256: a5eb707595e1424ff4127cc8b21b8b8cb076e6f0070b670485e72b9f74806200
+ run: |
+ set -euo pipefail
+ wget -q "https://github.com/xpack-dev-tools/riscv-none-elf-gcc-xpack/releases/download/v14.2.0-1/${XPACK_TARBALL}"
+ echo "${XPACK_SHA256} ${XPACK_TARBALL}" | sha256sum --check --strict
+ mkdir -p $HOME/riscv-gcc
+ tar -xzf "${XPACK_TARBALL}" -C $HOME/riscv-gcc --strip-components=1
+ rm "${XPACK_TARBALL}"
+ echo "$HOME/riscv-gcc/bin" >> $GITHUB_PATH
+
+ - name: Build SampleX PolarFire Condition-Monitoring Demo
+ run: |
+ bash targets/Microchip/POLARFIRE_ICICLE_RENODE/scripts/build.sh --rebuild
+
+ - name: Verify SampleX Demo ELF
+ run: |
+ test -f targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app/polarfire_icicle_demo.elf
+ echo "[OK] PolarFire SampleX demo ELF verified."
+
+ - name: Archive Built PolarFire ELF
+ uses: actions/upload-artifact@v4
+ with:
+ name: polarfire-demo-elf
+ path: targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app/polarfire_icicle_demo.elf
+ retention-days: 1
+
+ test-polarfire-renode:
+ name: Headless Renode Emulation & Assertion Test
+ needs: build-riscv-polarfire
+ runs-on: ubuntu-24.04
+ # Backstop in case Renode itself wedges before the in-script deadline fires.
+ timeout-minutes: 15
+ steps:
+ - name: Checkout Repository
+ uses: actions/checkout@v4
+ with:
+ submodules: recursive
+
+ - name: Set Up Python
+ uses: actions/setup-python@v5
+ with:
+ python-version: "3.11"
+
+ - name: Download Built PolarFire ELF
+ uses: actions/download-artifact@v4
+ with:
+ name: polarfire-demo-elf
+ path: targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app
+
+ - name: Install Pinned Portable Renode Emulation Environment
+ env:
+ RENODE_VERSION: 1.16.1
+ RENODE_SHA256: 1a532d4b5b82de0dd154970c401e0c7b0e498d17304b2cecc007e306c8f9617c
+ run: |
+ set -euo pipefail
+ TARBALL="renode-${RENODE_VERSION}.linux-portable.tar.gz"
+ wget -q "https://github.com/renode/renode/releases/download/v${RENODE_VERSION}/${TARBALL}"
+ echo "${RENODE_SHA256} ${TARBALL}" | sha256sum --check --strict
+ mkdir -p $HOME/renode
+ tar -xzf "${TARBALL}" -C $HOME/renode --strip-components=1
+ rm "${TARBALL}"
+ echo "$HOME/renode" >> $GITHUB_PATH
+
+ - name: Run Deterministic Headless Renode Test
+ run: |
+ python3 targets/Microchip/POLARFIRE_ICICLE_RENODE/scripts/test_renode.py

bsp/include/bsp/board.h

@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_BOARD_H
+#define BSP_BOARD_H
+
+/**
+ * @brief Initialize the system core (clocks, flash latency, system configuration).
+ */
+void bsp_board_init(void);
+
+#endif /* BSP_BOARD_H */

bsp/include/bsp/console.h

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_CONSOLE_H
+#define BSP_CONSOLE_H
+
+#include <stddef.h>
+
+/**
+ * @brief Initialize the serial console peripheral and pin muxing.
+ */
+void bsp_console_init(void);
+
+/**
+ * @brief Write a buffer of data to the serial console.
+ * 
+ * @param data Pointer to the character buffer to send.
+ * @param length Number of characters to transmit.
+ */
+void bsp_console_write(const char *data, size_t length);
+
+#endif /* BSP_CONSOLE_H */

bsp/include/bsp/led.h

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_LED_H
+#define BSP_LED_H
+
+/**
+ * @brief Initialize the user LED hardware pin/peripherals.
+ */
+void bsp_led_init(void);
+
+/**
+ * @brief Turn the user LED on.
+ */
+void bsp_led_on(void);
+
+/**
+ * @brief Turn the user LED off.
+ */
+void bsp_led_off(void);
+
+/**
+ * @brief Toggle the state of the user LED.
+ */
+void bsp_led_toggle(void);
+
+#endif /* BSP_LED_H */

cmake/utilities.cmake

@@ -0,0 +1,50 @@
+# Copyright (c) Microsoft
+# Copyright (c) 2024 Eclipse Foundation
+# 
+# This program and the accompanying materials are made available 
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+# 
+# SPDX-License-Identifier: MIT
+# 
+# Contributors: 
+# Microsoft - Initial version
+# Frédéric Desbiens - 2024 version.
+
+function(post_build TARGET)
+ if(CMAKE_C_COMPILER_ID STREQUAL "IAR")
+ add_custom_target(${TARGET}.bin ALL 
+ DEPENDS ${TARGET}
+ COMMAND ${CMAKE_IAR_ELFTOOL} --bin ${TARGET}.elf ${TARGET}.bin)
+ elseif(CMAKE_C_COMPILER_ID STREQUAL "GNU")
+ add_custom_target(${TARGET}.bin ALL 
+ DEPENDS ${TARGET}
+ COMMAND ${CMAKE_OBJCOPY} -Obinary ${TARGET}.elf ${TARGET}.bin
+ COMMAND ${CMAKE_OBJCOPY} -Oihex ${TARGET}.elf ${TARGET}.hex)
+ else()
+ message(FATAL_ERROR "Unknown CMAKE_C_COMPILER_ID ${CMAKE_C_COMPILER_ID}")
+ endif()
+endfunction()
+
+function(set_target_linker TARGET LINKER_SCRIPT)
+ if(CMAKE_C_COMPILER_ID STREQUAL "IAR")
+ target_link_options(${TARGET} PRIVATE --config ${LINKER_SCRIPT})
+ target_link_options(${TARGET} PRIVATE --map=${TARGET}.map)
+ elseif(CMAKE_C_COMPILER_ID STREQUAL "GNU")
+ target_link_options(${TARGET} PRIVATE -T${LINKER_SCRIPT})
+ target_link_options(${TARGET} PRIVATE -Wl,-Map=${TARGET}.map)
+ set_target_properties(${TARGET} PROPERTIES SUFFIX ".elf") 
+
+ else()
+ message(FATAL_ERROR "Unknown CMAKE_C_COMPILER_ID ${CMAKE_C_COMPILER_ID}")
+ endif()
+endfunction()
+
+macro(print_all_variables)
+ message(STATUS "print_all_variables------------------------------------------{")
+ get_cmake_property(_variableNames VARIABLES)
+ foreach (_variableName ${_variableNames})
+ message(STATUS "${_variableName}=${${_variableName}}")
+ endforeach()
+ message(STATUS "print_all_variables------------------------------------------}")
+endmacro()

docs/architecture.md

@@ -0,0 +1,67 @@
+# Eclipse ThreadX BSP Framework Architecture
+
+This document describes the architecture, design philosophy, directory structure, and onboarding process for the reusable Board Support Package (BSP) framework.
+
+---
+
+## 1. Design Philosophy
+
+The BSP framework is designed to be **additive and non-invasive**, allowing new boards to be integrated without modifying existing board implementations.
+
+1. **Legacy Isolation**: The board directories that predate this framework (`/MXChip`, `/OpenHW`, `/STMicroelectronics`) remain completely untouched, preserving their drivers, submodules, and build systems.
+2. **Platform-Independent Applications**: Target applications use only the abstract BSP interfaces and have no compile-time dependency on vendor-specific HALs, SDKs, or hardware registers.
+3. **Reusable Infrastructure**: Shared CMake toolchains and build utilities are centralized under `/cmake` to eliminate duplicated build configuration across supported boards.
+
+---
+
+## 2. Directory Structure
+
+```text
+samplex/ (repository root)
+├── libs/ # Shared RTOS components (ThreadX, NetX Duo, FileX, USBX)
+├── scripts/ # Repository-wide helper scripts
+├── MXChip/ # [Pre-framework] Standalone board sample
+├── OpenHW/ # [Pre-framework] Standalone board sample
+├── STMicroelectronics/ # [Pre-framework] Standalone board samples
+├── targets/ # [Framework] Supported BSP target boards
+│ └── Microchip/
+│ └── POLARFIRE_ICICLE_RENODE/ # Board-specific BSP implementation & Renode target
+├── bsp/ # [Framework] Abstract BSP interface definitions
+│ └── include/bsp/ # board.h, led.h, console.h
+├── cmake/ # [Framework] Shared CMake configuration and utilities
+├── docs/ # [Framework] Architecture and onboarding documentation
+└── templates/ # [Framework] Templates for onboarding new boards
+```
+
+---
+
+## 3. BSP Interface Contract
+
+Every board added to the framework under `/targets` must implement the abstract APIs defined in `/bsp/include/bsp/`.
+
+### Core Board Control (`board.h`)
+
+* `void bsp_board_init(void)`: Initializes the board, including system clocks, GPIO, and required peripherals.
+
+### LED Control (`led.h`)
+
+* `void bsp_led_init(void)`: Configures the board's user LED.
+* `void bsp_led_on(void)`: Turns the LED on.
+* `void bsp_led_off(void)`: Turns the LED off.
+* `void bsp_led_toggle(void)`: Toggles the LED state.
+
+### Serial Console (`console.h`)
+
+* `void bsp_console_init(void)`: Initializes the default UART console.
+* `void bsp_console_write(const char *data, size_t length)`: Transmits a block of data over the console interface.
+
+---
+
+## 4. How to Onboard a New Board
+
+1. **Create the Target Folder**: Create a new directory under `targets/<Vendor>/<Board_Name>/` using `/templates/target/` as the starting point.
+2. **Define Local Configuration**: Create a `board_config.h` file containing board-specific settings such as clock configuration, UART parameters, and ThreadX memory allocation.
+3. **Implement the BSP APIs**: Implement the interfaces defined in `/bsp/include/bsp/` using the vendor SDK or direct register access.
+4. **Configure CMake**: Add the board target to `CMakeLists.txt`, build the BSP as a static library, and link it with the desired application from `/apps/`.
+
+Once a board implements the required BSP interfaces, any compatible application under `/apps` can be built for that board without modifying the application source.

targets/Microchip/POLARFIRE_ICICLE_RENODE/CMakeLists.txt

@@ -0,0 +1,41 @@
+#
+# Copyright (c) 2026 Eclipse ThreadX contributors
+#
+# This program and the accompanying materials are made available
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+#
+# SPDX-License-Identifier: MIT
+#
+
+cmake_minimum_required(VERSION 3.20)
+
+set(CMAKE_SYSTEM_NAME Generic)
+set(CMAKE_SYSTEM_PROCESSOR riscv64)
+
+# Set 64-bit RISC-V Cross Compiler
+if(DEFINED ENV{RISCV64_TOOLCHAIN_PATH})
+ set(TOOLCHAIN_BIN_DIR "$ENV{RISCV64_TOOLCHAIN_PATH}/bin")
+ find_program(CMAKE_C_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+ find_program(CMAKE_CXX_COMPILER NAMES riscv-none-elf-g++ riscv64-none-elf-g++ riscv64-unknown-elf-g++ PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+ find_program(CMAKE_ASM_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+else()
+ find_program(CMAKE_C_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc REQUIRED)
+ find_program(CMAKE_CXX_COMPILER NAMES riscv-none-elf-g++ riscv64-none-elf-g++ riscv64-unknown-elf-g++ REQUIRED)
+ find_program(CMAKE_ASM_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc REQUIRED)
+endif()
+
+project(polarfire_icicle_renode C ASM)
+
+# Root Directories
+set(SAMPLEX_ROOT_DIR "${CMAKE_CURRENT_LIST_DIR}/../../..")
+set(THREADX_DIR "${SAMPLEX_ROOT_DIR}/libs/threadx")
+
+# Architecture flags for SiFive U54 64-Bit RISC-V Core (RV64GC / lp64d)
+set(RISCV_FLAGS "-march=rv64gc -mabi=lp64d -mcmodel=medany")
+set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${RISCV_FLAGS} -O2 -g -Wall -Wextra")
+set(CMAKE_ASM_FLAGS "${CMAKE_ASM_FLAGS} ${RISCV_FLAGS}")
+set(CMAKE_EXE_LINKER_FLAGS "${RISCV_FLAGS} -T${CMAKE_CURRENT_LIST_DIR}/app/common/linker/linker.ld -nostartfiles -Wl,--gc-sections")
+
+add_subdirectory(lib)
+add_subdirectory(app)

.github/workflows/ci.yml

@@ -0,0 +1,103 @@
+#
+# Copyright (c) 2026 Eclipse ThreadX contributors
+#
+# This program and the accompanying materials are made available
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+#
+# SPDX-License-Identifier: MIT
+#
+
+name: SampleX CI Verification Pipeline
+
+on:
+ push:
+ branches: [ main, master, dev, 'feat/**' ]
+ pull_request:
+ branches: [ main, master, dev ]
+
+jobs:
+ build-riscv-polarfire:
+ name: Build PolarFire SoC Icicle Kit (64-Bit RISC-V)
+ runs-on: ubuntu-24.04
+ timeout-minutes: 20
+ steps:
+ - name: Checkout Repository
+ uses: actions/checkout@v4
+ with:
+ submodules: recursive
+
+ - name: Install CMake and Ninja
+ run: |
+ sudo apt-get update
+ sudo apt-get install -y cmake ninja-build
+
+ - name: Install Pinned xPack RISC-V GCC 14.2.0
+ env:
+ XPACK_TARBALL: xpack-riscv-none-elf-gcc-14.2.0-1-linux-x64.tar.gz
+ XPACK_SHA256: a5eb707595e1424ff4127cc8b21b8b8cb076e6f0070b670485e72b9f74806200
+ run: |
+ set -euo pipefail
+ wget -q "https://github.com/xpack-dev-tools/riscv-none-elf-gcc-xpack/releases/download/v14.2.0-1/${XPACK_TARBALL}"
+ echo "${XPACK_SHA256} ${XPACK_TARBALL}" | sha256sum --check --strict
+ mkdir -p $HOME/riscv-gcc
+ tar -xzf "${XPACK_TARBALL}" -C $HOME/riscv-gcc --strip-components=1
+ rm "${XPACK_TARBALL}"
+ echo "$HOME/riscv-gcc/bin" >> $GITHUB_PATH
+
+ - name: Build SampleX PolarFire Condition-Monitoring Demo
+ run: |
+ bash targets/Microchip/POLARFIRE_ICICLE_RENODE/scripts/build.sh --rebuild
+
+ - name: Verify SampleX Demo ELF
+ run: |
+ test -f targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app/polarfire_icicle_demo.elf
+ echo "[OK] PolarFire SampleX demo ELF verified."
+
+ - name: Archive Built PolarFire ELF
+ uses: actions/upload-artifact@v4
+ with:
+ name: polarfire-demo-elf
+ path: targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app/polarfire_icicle_demo.elf
+ retention-days: 1
+
+ test-polarfire-renode:
+ name: Headless Renode Emulation & Assertion Test
+ needs: build-riscv-polarfire
+ runs-on: ubuntu-24.04
+ # Backstop in case Renode itself wedges before the in-script deadline fires.
+ timeout-minutes: 15
+ steps:
+ - name: Checkout Repository
+ uses: actions/checkout@v4
+ with:
+ submodules: recursive
+
+ - name: Set Up Python
+ uses: actions/setup-python@v5
+ with:
+ python-version: "3.11"
+
+ - name: Download Built PolarFire ELF
+ uses: actions/download-artifact@v4
+ with:
+ name: polarfire-demo-elf
+ path: targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app
+
+ - name: Install Pinned Portable Renode Emulation Environment
+ env:
+ RENODE_VERSION: 1.16.1
+ RENODE_SHA256: 1a532d4b5b82de0dd154970c401e0c7b0e498d17304b2cecc007e306c8f9617c
+ run: |
+ set -euo pipefail
+ TARBALL="renode-${RENODE_VERSION}.linux-portable.tar.gz"
+ wget -q "https://github.com/renode/renode/releases/download/v${RENODE_VERSION}/${TARBALL}"
+ echo "${RENODE_SHA256} ${TARBALL}" | sha256sum --check --strict
+ mkdir -p $HOME/renode
+ tar -xzf "${TARBALL}" -C $HOME/renode --strip-components=1
+ rm "${TARBALL}"
+ echo "$HOME/renode" >> $GITHUB_PATH
+
+ - name: Run Deterministic Headless Renode Test
+ run: |
+ python3 targets/Microchip/POLARFIRE_ICICLE_RENODE/scripts/test_renode.py

bsp/include/bsp/board.h

@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_BOARD_H
+#define BSP_BOARD_H
+
+/**
+ * @brief Initialize the system core (clocks, flash latency, system configuration).
+ */
+void bsp_board_init(void);
+
+#endif /* BSP_BOARD_H */

bsp/include/bsp/console.h

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_CONSOLE_H
+#define BSP_CONSOLE_H
+
+#include <stddef.h>
+
+/**
+ * @brief Initialize the serial console peripheral and pin muxing.
+ */
+void bsp_console_init(void);
+
+/**
+ * @brief Write a buffer of data to the serial console.
+ * 
+ * @param data Pointer to the character buffer to send.
+ * @param length Number of characters to transmit.
+ */
+void bsp_console_write(const char *data, size_t length);
+
+#endif /* BSP_CONSOLE_H */

bsp/include/bsp/led.h

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_LED_H
+#define BSP_LED_H
+
+/**
+ * @brief Initialize the user LED hardware pin/peripherals.
+ */
+void bsp_led_init(void);
+
+/**
+ * @brief Turn the user LED on.
+ */
+void bsp_led_on(void);
+
+/**
+ * @brief Turn the user LED off.
+ */
+void bsp_led_off(void);
+
+/**
+ * @brief Toggle the state of the user LED.
+ */
+void bsp_led_toggle(void);
+
+#endif /* BSP_LED_H */

cmake/utilities.cmake

@@ -0,0 +1,50 @@
+# Copyright (c) Microsoft
+# Copyright (c) 2024 Eclipse Foundation
+# 
+# This program and the accompanying materials are made available 
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+# 
+# SPDX-License-Identifier: MIT
+# 
+# Contributors: 
+# Microsoft - Initial version
+# Frédéric Desbiens - 2024 version.
+
+function(post_build TARGET)
+ if(CMAKE_C_COMPILER_ID STREQUAL "IAR")
+ add_custom_target(${TARGET}.bin ALL 
+ DEPENDS ${TARGET}
+ COMMAND ${CMAKE_IAR_ELFTOOL} --bin ${TARGET}.elf ${TARGET}.bin)
+ elseif(CMAKE_C_COMPILER_ID STREQUAL "GNU")
+ add_custom_target(${TARGET}.bin ALL 
+ DEPENDS ${TARGET}
+ COMMAND ${CMAKE_OBJCOPY} -Obinary ${TARGET}.elf ${TARGET}.bin
+ COMMAND ${CMAKE_OBJCOPY} -Oihex ${TARGET}.elf ${TARGET}.hex)
+ else()
+ message(FATAL_ERROR "Unknown CMAKE_C_COMPILER_ID ${CMAKE_C_COMPILER_ID}")
+ endif()
+endfunction()
+
+function(set_target_linker TARGET LINKER_SCRIPT)
+ if(CMAKE_C_COMPILER_ID STREQUAL "IAR")
+ target_link_options(${TARGET} PRIVATE --config ${LINKER_SCRIPT})
+ target_link_options(${TARGET} PRIVATE --map=${TARGET}.map)
+ elseif(CMAKE_C_COMPILER_ID STREQUAL "GNU")
+ target_link_options(${TARGET} PRIVATE -T${LINKER_SCRIPT})
+ target_link_options(${TARGET} PRIVATE -Wl,-Map=${TARGET}.map)
+ set_target_properties(${TARGET} PROPERTIES SUFFIX ".elf") 
+
+ else()
+ message(FATAL_ERROR "Unknown CMAKE_C_COMPILER_ID ${CMAKE_C_COMPILER_ID}")
+ endif()
+endfunction()
+
+macro(print_all_variables)
+ message(STATUS "print_all_variables------------------------------------------{")
+ get_cmake_property(_variableNames VARIABLES)
+ foreach (_variableName ${_variableNames})
+ message(STATUS "${_variableName}=${${_variableName}}")
+ endforeach()
+ message(STATUS "print_all_variables------------------------------------------}")
+endmacro()

docs/architecture.md

@@ -0,0 +1,67 @@
+# Eclipse ThreadX BSP Framework Architecture
+
+This document describes the architecture, design philosophy, directory structure, and onboarding process for the reusable Board Support Package (BSP) framework.
+
+---
+
+## 1. Design Philosophy
+
+The BSP framework is designed to be **additive and non-invasive**, allowing new boards to be integrated without modifying existing board implementations.
+
+1. **Legacy Isolation**: The board directories that predate this framework (`/MXChip`, `/OpenHW`, `/STMicroelectronics`) remain completely untouched, preserving their drivers, submodules, and build systems.
+2. **Platform-Independent Applications**: Target applications use only the abstract BSP interfaces and have no compile-time dependency on vendor-specific HALs, SDKs, or hardware registers.
+3. **Reusable Infrastructure**: Shared CMake toolchains and build utilities are centralized under `/cmake` to eliminate duplicated build configuration across supported boards.
+
+---
+
+## 2. Directory Structure
+
+```text
+samplex/ (repository root)
+├── libs/ # Shared RTOS components (ThreadX, NetX Duo, FileX, USBX)
+├── scripts/ # Repository-wide helper scripts
+├── MXChip/ # [Pre-framework] Standalone board sample
+├── OpenHW/ # [Pre-framework] Standalone board sample
+├── STMicroelectronics/ # [Pre-framework] Standalone board samples
+├── targets/ # [Framework] Supported BSP target boards
+│ └── Microchip/
+│ └── POLARFIRE_ICICLE_RENODE/ # Board-specific BSP implementation & Renode target
+├── bsp/ # [Framework] Abstract BSP interface definitions
+│ └── include/bsp/ # board.h, led.h, console.h
+├── cmake/ # [Framework] Shared CMake configuration and utilities
+├── docs/ # [Framework] Architecture and onboarding documentation
+└── templates/ # [Framework] Templates for onboarding new boards
+```
+
+---
+
+## 3. BSP Interface Contract
+
+Every board added to the framework under `/targets` must implement the abstract APIs defined in `/bsp/include/bsp/`.
+
+### Core Board Control (`board.h`)
+
+* `void bsp_board_init(void)`: Initializes the board, including system clocks, GPIO, and required peripherals.
+
+### LED Control (`led.h`)
+
+* `void bsp_led_init(void)`: Configures the board's user LED.
+* `void bsp_led_on(void)`: Turns the LED on.
+* `void bsp_led_off(void)`: Turns the LED off.
+* `void bsp_led_toggle(void)`: Toggles the LED state.
+
+### Serial Console (`console.h`)
+
+* `void bsp_console_init(void)`: Initializes the default UART console.
+* `void bsp_console_write(const char *data, size_t length)`: Transmits a block of data over the console interface.
+
+---
+
+## 4. How to Onboard a New Board
+
+1. **Create the Target Folder**: Create a new directory under `targets/<Vendor>/<Board_Name>/` using `/templates/target/` as the starting point.
+2. **Define Local Configuration**: Create a `board_config.h` file containing board-specific settings such as clock configuration, UART parameters, and ThreadX memory allocation.
+3. **Implement the BSP APIs**: Implement the interfaces defined in `/bsp/include/bsp/` using the vendor SDK or direct register access.
+4. **Configure CMake**: Add the board target to `CMakeLists.txt`, build the BSP as a static library, and link it with the desired application from `/apps/`.
+
+Once a board implements the required BSP interfaces, any compatible application under `/apps` can be built for that board without modifying the application source.

targets/Microchip/POLARFIRE_ICICLE_RENODE/CMakeLists.txt

@@ -0,0 +1,41 @@
+#
+# Copyright (c) 2026 Eclipse ThreadX contributors
+#
+# This program and the accompanying materials are made available
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+#
+# SPDX-License-Identifier: MIT
+#
+
+cmake_minimum_required(VERSION 3.20)
+
+set(CMAKE_SYSTEM_NAME Generic)
+set(CMAKE_SYSTEM_PROCESSOR riscv64)
+
+# Set 64-bit RISC-V Cross Compiler
+if(DEFINED ENV{RISCV64_TOOLCHAIN_PATH})
+ set(TOOLCHAIN_BIN_DIR "$ENV{RISCV64_TOOLCHAIN_PATH}/bin")
+ find_program(CMAKE_C_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+ find_program(CMAKE_CXX_COMPILER NAMES riscv-none-elf-g++ riscv64-none-elf-g++ riscv64-unknown-elf-g++ PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+ find_program(CMAKE_ASM_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+else()
+ find_program(CMAKE_C_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc REQUIRED)
+ find_program(CMAKE_CXX_COMPILER NAMES riscv-none-elf-g++ riscv64-none-elf-g++ riscv64-unknown-elf-g++ REQUIRED)
+ find_program(CMAKE_ASM_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc REQUIRED)
+endif()
+
+project(polarfire_icicle_renode C ASM)
+
+# Root Directories
+set(SAMPLEX_ROOT_DIR "${CMAKE_CURRENT_LIST_DIR}/../../..")
+set(THREADX_DIR "${SAMPLEX_ROOT_DIR}/libs/threadx")
+
+# Architecture flags for SiFive U54 64-Bit RISC-V Core (RV64GC / lp64d)
+set(RISCV_FLAGS "-march=rv64gc -mabi=lp64d -mcmodel=medany")
+set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${RISCV_FLAGS} -O2 -g -Wall -Wextra")
+set(CMAKE_ASM_FLAGS "${CMAKE_ASM_FLAGS} ${RISCV_FLAGS}")
+set(CMAKE_EXE_LINKER_FLAGS "${RISCV_FLAGS} -T${CMAKE_CURRENT_LIST_DIR}/app/common/linker/linker.ld -nostartfiles -Wl,--gc-sections")
+
+add_subdirectory(lib)
+add_subdirectory(app)

.github/workflows/ci.yml

@@ -0,0 +1,103 @@
+#
+# Copyright (c) 2026 Eclipse ThreadX contributors
+#
+# This program and the accompanying materials are made available
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+#
+# SPDX-License-Identifier: MIT
+#
+
+name: SampleX CI Verification Pipeline
+
+on:
+ push:
+ branches: [ main, master, dev, 'feat/**' ]
+ pull_request:
+ branches: [ main, master, dev ]
+
+jobs:
+ build-riscv-polarfire:
+ name: Build PolarFire SoC Icicle Kit (64-Bit RISC-V)
+ runs-on: ubuntu-24.04
+ timeout-minutes: 20
+ steps:
+ - name: Checkout Repository
+ uses: actions/checkout@v4
+ with:
+ submodules: recursive
+
+ - name: Install CMake and Ninja
+ run: |
+ sudo apt-get update
+ sudo apt-get install -y cmake ninja-build
+
+ - name: Install Pinned xPack RISC-V GCC 14.2.0
+ env:
+ XPACK_TARBALL: xpack-riscv-none-elf-gcc-14.2.0-1-linux-x64.tar.gz
+ XPACK_SHA256: a5eb707595e1424ff4127cc8b21b8b8cb076e6f0070b670485e72b9f74806200
+ run: |
+ set -euo pipefail
+ wget -q "https://github.com/xpack-dev-tools/riscv-none-elf-gcc-xpack/releases/download/v14.2.0-1/${XPACK_TARBALL}"
+ echo "${XPACK_SHA256} ${XPACK_TARBALL}" | sha256sum --check --strict
+ mkdir -p $HOME/riscv-gcc
+ tar -xzf "${XPACK_TARBALL}" -C $HOME/riscv-gcc --strip-components=1
+ rm "${XPACK_TARBALL}"
+ echo "$HOME/riscv-gcc/bin" >> $GITHUB_PATH
+
+ - name: Build SampleX PolarFire Condition-Monitoring Demo
+ run: |
+ bash targets/Microchip/POLARFIRE_ICICLE_RENODE/scripts/build.sh --rebuild
+
+ - name: Verify SampleX Demo ELF
+ run: |
+ test -f targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app/polarfire_icicle_demo.elf
+ echo "[OK] PolarFire SampleX demo ELF verified."
+
+ - name: Archive Built PolarFire ELF
+ uses: actions/upload-artifact@v4
+ with:
+ name: polarfire-demo-elf
+ path: targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app/polarfire_icicle_demo.elf
+ retention-days: 1
+
+ test-polarfire-renode:
+ name: Headless Renode Emulation & Assertion Test
+ needs: build-riscv-polarfire
+ runs-on: ubuntu-24.04
+ # Backstop in case Renode itself wedges before the in-script deadline fires.
+ timeout-minutes: 15
+ steps:
+ - name: Checkout Repository
+ uses: actions/checkout@v4
+ with:
+ submodules: recursive
+
+ - name: Set Up Python
+ uses: actions/setup-python@v5
+ with:
+ python-version: "3.11"
+
+ - name: Download Built PolarFire ELF
+ uses: actions/download-artifact@v4
+ with:
+ name: polarfire-demo-elf
+ path: targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app
+
+ - name: Install Pinned Portable Renode Emulation Environment
+ env:
+ RENODE_VERSION: 1.16.1
+ RENODE_SHA256: 1a532d4b5b82de0dd154970c401e0c7b0e498d17304b2cecc007e306c8f9617c
+ run: |
+ set -euo pipefail
+ TARBALL="renode-${RENODE_VERSION}.linux-portable.tar.gz"
+ wget -q "https://github.com/renode/renode/releases/download/v${RENODE_VERSION}/${TARBALL}"
+ echo "${RENODE_SHA256} ${TARBALL}" | sha256sum --check --strict
+ mkdir -p $HOME/renode
+ tar -xzf "${TARBALL}" -C $HOME/renode --strip-components=1
+ rm "${TARBALL}"
+ echo "$HOME/renode" >> $GITHUB_PATH
+
+ - name: Run Deterministic Headless Renode Test
+ run: |
+ python3 targets/Microchip/POLARFIRE_ICICLE_RENODE/scripts/test_renode.py

bsp/include/bsp/board.h

@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_BOARD_H
+#define BSP_BOARD_H
+
+/**
+ * @brief Initialize the system core (clocks, flash latency, system configuration).
+ */
+void bsp_board_init(void);
+
+#endif /* BSP_BOARD_H */

bsp/include/bsp/console.h

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_CONSOLE_H
+#define BSP_CONSOLE_H
+
+#include <stddef.h>
+
+/**
+ * @brief Initialize the serial console peripheral and pin muxing.
+ */
+void bsp_console_init(void);
+
+/**
+ * @brief Write a buffer of data to the serial console.
+ * 
+ * @param data Pointer to the character buffer to send.
+ * @param length Number of characters to transmit.
+ */
+void bsp_console_write(const char *data, size_t length);
+
+#endif /* BSP_CONSOLE_H */

bsp/include/bsp/led.h

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_LED_H
+#define BSP_LED_H
+
+/**
+ * @brief Initialize the user LED hardware pin/peripherals.
+ */
+void bsp_led_init(void);
+
+/**
+ * @brief Turn the user LED on.
+ */
+void bsp_led_on(void);
+
+/**
+ * @brief Turn the user LED off.
+ */
+void bsp_led_off(void);
+
+/**
+ * @brief Toggle the state of the user LED.
+ */
+void bsp_led_toggle(void);
+
+#endif /* BSP_LED_H */

cmake/utilities.cmake

@@ -0,0 +1,50 @@
+# Copyright (c) Microsoft
+# Copyright (c) 2024 Eclipse Foundation
+# 
+# This program and the accompanying materials are made available 
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+# 
+# SPDX-License-Identifier: MIT
+# 
+# Contributors: 
+# Microsoft - Initial version
+# Frédéric Desbiens - 2024 version.
+
+function(post_build TARGET)
+ if(CMAKE_C_COMPILER_ID STREQUAL "IAR")
+ add_custom_target(${TARGET}.bin ALL 
+ DEPENDS ${TARGET}
+ COMMAND ${CMAKE_IAR_ELFTOOL} --bin ${TARGET}.elf ${TARGET}.bin)
+ elseif(CMAKE_C_COMPILER_ID STREQUAL "GNU")
+ add_custom_target(${TARGET}.bin ALL 
+ DEPENDS ${TARGET}
+ COMMAND ${CMAKE_OBJCOPY} -Obinary ${TARGET}.elf ${TARGET}.bin
+ COMMAND ${CMAKE_OBJCOPY} -Oihex ${TARGET}.elf ${TARGET}.hex)
+ else()
+ message(FATAL_ERROR "Unknown CMAKE_C_COMPILER_ID ${CMAKE_C_COMPILER_ID}")
+ endif()
+endfunction()
+
+function(set_target_linker TARGET LINKER_SCRIPT)
+ if(CMAKE_C_COMPILER_ID STREQUAL "IAR")
+ target_link_options(${TARGET} PRIVATE --config ${LINKER_SCRIPT})
+ target_link_options(${TARGET} PRIVATE --map=${TARGET}.map)
+ elseif(CMAKE_C_COMPILER_ID STREQUAL "GNU")
+ target_link_options(${TARGET} PRIVATE -T${LINKER_SCRIPT})
+ target_link_options(${TARGET} PRIVATE -Wl,-Map=${TARGET}.map)
+ set_target_properties(${TARGET} PROPERTIES SUFFIX ".elf") 
+
+ else()
+ message(FATAL_ERROR "Unknown CMAKE_C_COMPILER_ID ${CMAKE_C_COMPILER_ID}")
+ endif()
+endfunction()
+
+macro(print_all_variables)
+ message(STATUS "print_all_variables------------------------------------------{")
+ get_cmake_property(_variableNames VARIABLES)
+ foreach (_variableName ${_variableNames})
+ message(STATUS "${_variableName}=${${_variableName}}")
+ endforeach()
+ message(STATUS "print_all_variables------------------------------------------}")
+endmacro()

docs/architecture.md

@@ -0,0 +1,67 @@
+# Eclipse ThreadX BSP Framework Architecture
+
+This document describes the architecture, design philosophy, directory structure, and onboarding process for the reusable Board Support Package (BSP) framework.
+
+---
+
+## 1. Design Philosophy
+
+The BSP framework is designed to be **additive and non-invasive**, allowing new boards to be integrated without modifying existing board implementations.
+
+1. **Legacy Isolation**: The board directories that predate this framework (`/MXChip`, `/OpenHW`, `/STMicroelectronics`) remain completely untouched, preserving their drivers, submodules, and build systems.
+2. **Platform-Independent Applications**: Target applications use only the abstract BSP interfaces and have no compile-time dependency on vendor-specific HALs, SDKs, or hardware registers.
+3. **Reusable Infrastructure**: Shared CMake toolchains and build utilities are centralized under `/cmake` to eliminate duplicated build configuration across supported boards.
+
+---
+
+## 2. Directory Structure
+
+```text
+samplex/ (repository root)
+├── libs/ # Shared RTOS components (ThreadX, NetX Duo, FileX, USBX)
+├── scripts/ # Repository-wide helper scripts
+├── MXChip/ # [Pre-framework] Standalone board sample
+├── OpenHW/ # [Pre-framework] Standalone board sample
+├── STMicroelectronics/ # [Pre-framework] Standalone board samples
+├── targets/ # [Framework] Supported BSP target boards
+│ └── Microchip/
+│ └── POLARFIRE_ICICLE_RENODE/ # Board-specific BSP implementation & Renode target
+├── bsp/ # [Framework] Abstract BSP interface definitions
+│ └── include/bsp/ # board.h, led.h, console.h
+├── cmake/ # [Framework] Shared CMake configuration and utilities
+├── docs/ # [Framework] Architecture and onboarding documentation
+└── templates/ # [Framework] Templates for onboarding new boards
+```
+
+---
+
+## 3. BSP Interface Contract
+
+Every board added to the framework under `/targets` must implement the abstract APIs defined in `/bsp/include/bsp/`.
+
+### Core Board Control (`board.h`)
+
+* `void bsp_board_init(void)`: Initializes the board, including system clocks, GPIO, and required peripherals.
+
+### LED Control (`led.h`)
+
+* `void bsp_led_init(void)`: Configures the board's user LED.
+* `void bsp_led_on(void)`: Turns the LED on.
+* `void bsp_led_off(void)`: Turns the LED off.
+* `void bsp_led_toggle(void)`: Toggles the LED state.
+
+### Serial Console (`console.h`)
+
+* `void bsp_console_init(void)`: Initializes the default UART console.
+* `void bsp_console_write(const char *data, size_t length)`: Transmits a block of data over the console interface.
+
+---
+
+## 4. How to Onboard a New Board
+
+1. **Create the Target Folder**: Create a new directory under `targets/<Vendor>/<Board_Name>/` using `/templates/target/` as the starting point.
+2. **Define Local Configuration**: Create a `board_config.h` file containing board-specific settings such as clock configuration, UART parameters, and ThreadX memory allocation.
+3. **Implement the BSP APIs**: Implement the interfaces defined in `/bsp/include/bsp/` using the vendor SDK or direct register access.
+4. **Configure CMake**: Add the board target to `CMakeLists.txt`, build the BSP as a static library, and link it with the desired application from `/apps/`.
+
+Once a board implements the required BSP interfaces, any compatible application under `/apps` can be built for that board without modifying the application source.

targets/Microchip/POLARFIRE_ICICLE_RENODE/CMakeLists.txt

@@ -0,0 +1,41 @@
+#
+# Copyright (c) 2026 Eclipse ThreadX contributors
+#
+# This program and the accompanying materials are made available
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+#
+# SPDX-License-Identifier: MIT
+#
+
+cmake_minimum_required(VERSION 3.20)
+
+set(CMAKE_SYSTEM_NAME Generic)
+set(CMAKE_SYSTEM_PROCESSOR riscv64)
+
+# Set 64-bit RISC-V Cross Compiler
+if(DEFINED ENV{RISCV64_TOOLCHAIN_PATH})
+ set(TOOLCHAIN_BIN_DIR "$ENV{RISCV64_TOOLCHAIN_PATH}/bin")
+ find_program(CMAKE_C_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+ find_program(CMAKE_CXX_COMPILER NAMES riscv-none-elf-g++ riscv64-none-elf-g++ riscv64-unknown-elf-g++ PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+ find_program(CMAKE_ASM_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+else()
+ find_program(CMAKE_C_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc REQUIRED)
+ find_program(CMAKE_CXX_COMPILER NAMES riscv-none-elf-g++ riscv64-none-elf-g++ riscv64-unknown-elf-g++ REQUIRED)
+ find_program(CMAKE_ASM_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc REQUIRED)
+endif()
+
+project(polarfire_icicle_renode C ASM)
+
+# Root Directories
+set(SAMPLEX_ROOT_DIR "${CMAKE_CURRENT_LIST_DIR}/../../..")
+set(THREADX_DIR "${SAMPLEX_ROOT_DIR}/libs/threadx")
+
+# Architecture flags for SiFive U54 64-Bit RISC-V Core (RV64GC / lp64d)
+set(RISCV_FLAGS "-march=rv64gc -mabi=lp64d -mcmodel=medany")
+set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${RISCV_FLAGS} -O2 -g -Wall -Wextra")
+set(CMAKE_ASM_FLAGS "${CMAKE_ASM_FLAGS} ${RISCV_FLAGS}")
+set(CMAKE_EXE_LINKER_FLAGS "${RISCV_FLAGS} -T${CMAKE_CURRENT_LIST_DIR}/app/common/linker/linker.ld -nostartfiles -Wl,--gc-sections")
+
+add_subdirectory(lib)
+add_subdirectory(app)

.github/workflows/ci.yml

@@ -0,0 +1,103 @@
+#
+# Copyright (c) 2026 Eclipse ThreadX contributors
+#
+# This program and the accompanying materials are made available
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+#
+# SPDX-License-Identifier: MIT
+#
+
+name: SampleX CI Verification Pipeline
+
+on:
+ push:
+ branches: [ main, master, dev, 'feat/**' ]
+ pull_request:
+ branches: [ main, master, dev ]
+
+jobs:
+ build-riscv-polarfire:
+ name: Build PolarFire SoC Icicle Kit (64-Bit RISC-V)
+ runs-on: ubuntu-24.04
+ timeout-minutes: 20
+ steps:
+ - name: Checkout Repository
+ uses: actions/checkout@v4
+ with:
+ submodules: recursive
+
+ - name: Install CMake and Ninja
+ run: |
+ sudo apt-get update
+ sudo apt-get install -y cmake ninja-build
+
+ - name: Install Pinned xPack RISC-V GCC 14.2.0
+ env:
+ XPACK_TARBALL: xpack-riscv-none-elf-gcc-14.2.0-1-linux-x64.tar.gz
+ XPACK_SHA256: a5eb707595e1424ff4127cc8b21b8b8cb076e6f0070b670485e72b9f74806200
+ run: |
+ set -euo pipefail
+ wget -q "https://github.com/xpack-dev-tools/riscv-none-elf-gcc-xpack/releases/download/v14.2.0-1/${XPACK_TARBALL}"
+ echo "${XPACK_SHA256} ${XPACK_TARBALL}" | sha256sum --check --strict
+ mkdir -p $HOME/riscv-gcc
+ tar -xzf "${XPACK_TARBALL}" -C $HOME/riscv-gcc --strip-components=1
+ rm "${XPACK_TARBALL}"
+ echo "$HOME/riscv-gcc/bin" >> $GITHUB_PATH
+
+ - name: Build SampleX PolarFire Condition-Monitoring Demo
+ run: |
+ bash targets/Microchip/POLARFIRE_ICICLE_RENODE/scripts/build.sh --rebuild
+
+ - name: Verify SampleX Demo ELF
+ run: |
+ test -f targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app/polarfire_icicle_demo.elf
+ echo "[OK] PolarFire SampleX demo ELF verified."
+
+ - name: Archive Built PolarFire ELF
+ uses: actions/upload-artifact@v4
+ with:
+ name: polarfire-demo-elf
+ path: targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app/polarfire_icicle_demo.elf
+ retention-days: 1
+
+ test-polarfire-renode:
+ name: Headless Renode Emulation & Assertion Test
+ needs: build-riscv-polarfire
+ runs-on: ubuntu-24.04
+ # Backstop in case Renode itself wedges before the in-script deadline fires.
+ timeout-minutes: 15
+ steps:
+ - name: Checkout Repository
+ uses: actions/checkout@v4
+ with:
+ submodules: recursive
+
+ - name: Set Up Python
+ uses: actions/setup-python@v5
+ with:
+ python-version: "3.11"
+
+ - name: Download Built PolarFire ELF
+ uses: actions/download-artifact@v4
+ with:
+ name: polarfire-demo-elf
+ path: targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app
+
+ - name: Install Pinned Portable Renode Emulation Environment
+ env:
+ RENODE_VERSION: 1.16.1
+ RENODE_SHA256: 1a532d4b5b82de0dd154970c401e0c7b0e498d17304b2cecc007e306c8f9617c
+ run: |
+ set -euo pipefail
+ TARBALL="renode-${RENODE_VERSION}.linux-portable.tar.gz"
+ wget -q "https://github.com/renode/renode/releases/download/v${RENODE_VERSION}/${TARBALL}"
+ echo "${RENODE_SHA256} ${TARBALL}" | sha256sum --check --strict
+ mkdir -p $HOME/renode
+ tar -xzf "${TARBALL}" -C $HOME/renode --strip-components=1
+ rm "${TARBALL}"
+ echo "$HOME/renode" >> $GITHUB_PATH
+
+ - name: Run Deterministic Headless Renode Test
+ run: |
+ python3 targets/Microchip/POLARFIRE_ICICLE_RENODE/scripts/test_renode.py

bsp/include/bsp/board.h

@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_BOARD_H
+#define BSP_BOARD_H
+
+/**
+ * @brief Initialize the system core (clocks, flash latency, system configuration).
+ */
+void bsp_board_init(void);
+
+#endif /* BSP_BOARD_H */

bsp/include/bsp/console.h

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_CONSOLE_H
+#define BSP_CONSOLE_H
+
+#include <stddef.h>
+
+/**
+ * @brief Initialize the serial console peripheral and pin muxing.
+ */
+void bsp_console_init(void);
+
+/**
+ * @brief Write a buffer of data to the serial console.
+ * 
+ * @param data Pointer to the character buffer to send.
+ * @param length Number of characters to transmit.
+ */
+void bsp_console_write(const char *data, size_t length);
+
+#endif /* BSP_CONSOLE_H */

bsp/include/bsp/led.h

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_LED_H
+#define BSP_LED_H
+
+/**
+ * @brief Initialize the user LED hardware pin/peripherals.
+ */
+void bsp_led_init(void);
+
+/**
+ * @brief Turn the user LED on.
+ */
+void bsp_led_on(void);
+
+/**
+ * @brief Turn the user LED off.
+ */
+void bsp_led_off(void);
+
+/**
+ * @brief Toggle the state of the user LED.
+ */
+void bsp_led_toggle(void);
+
+#endif /* BSP_LED_H */

cmake/utilities.cmake

@@ -0,0 +1,50 @@
+# Copyright (c) Microsoft
+# Copyright (c) 2024 Eclipse Foundation
+# 
+# This program and the accompanying materials are made available 
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+# 
+# SPDX-License-Identifier: MIT
+# 
+# Contributors: 
+# Microsoft - Initial version
+# Frédéric Desbiens - 2024 version.
+
+function(post_build TARGET)
+ if(CMAKE_C_COMPILER_ID STREQUAL "IAR")
+ add_custom_target(${TARGET}.bin ALL 
+ DEPENDS ${TARGET}
+ COMMAND ${CMAKE_IAR_ELFTOOL} --bin ${TARGET}.elf ${TARGET}.bin)
+ elseif(CMAKE_C_COMPILER_ID STREQUAL "GNU")
+ add_custom_target(${TARGET}.bin ALL 
+ DEPENDS ${TARGET}
+ COMMAND ${CMAKE_OBJCOPY} -Obinary ${TARGET}.elf ${TARGET}.bin
+ COMMAND ${CMAKE_OBJCOPY} -Oihex ${TARGET}.elf ${TARGET}.hex)
+ else()
+ message(FATAL_ERROR "Unknown CMAKE_C_COMPILER_ID ${CMAKE_C_COMPILER_ID}")
+ endif()
+endfunction()
+
+function(set_target_linker TARGET LINKER_SCRIPT)
+ if(CMAKE_C_COMPILER_ID STREQUAL "IAR")
+ target_link_options(${TARGET} PRIVATE --config ${LINKER_SCRIPT})
+ target_link_options(${TARGET} PRIVATE --map=${TARGET}.map)
+ elseif(CMAKE_C_COMPILER_ID STREQUAL "GNU")
+ target_link_options(${TARGET} PRIVATE -T${LINKER_SCRIPT})
+ target_link_options(${TARGET} PRIVATE -Wl,-Map=${TARGET}.map)
+ set_target_properties(${TARGET} PROPERTIES SUFFIX ".elf") 
+
+ else()
+ message(FATAL_ERROR "Unknown CMAKE_C_COMPILER_ID ${CMAKE_C_COMPILER_ID}")
+ endif()
+endfunction()
+
+macro(print_all_variables)
+ message(STATUS "print_all_variables------------------------------------------{")
+ get_cmake_property(_variableNames VARIABLES)
+ foreach (_variableName ${_variableNames})
+ message(STATUS "${_variableName}=${${_variableName}}")
+ endforeach()
+ message(STATUS "print_all_variables------------------------------------------}")
+endmacro()

docs/architecture.md

@@ -0,0 +1,67 @@
+# Eclipse ThreadX BSP Framework Architecture
+
+This document describes the architecture, design philosophy, directory structure, and onboarding process for the reusable Board Support Package (BSP) framework.
+
+---
+
+## 1. Design Philosophy
+
+The BSP framework is designed to be **additive and non-invasive**, allowing new boards to be integrated without modifying existing board implementations.
+
+1. **Legacy Isolation**: The board directories that predate this framework (`/MXChip`, `/OpenHW`, `/STMicroelectronics`) remain completely untouched, preserving their drivers, submodules, and build systems.
+2. **Platform-Independent Applications**: Target applications use only the abstract BSP interfaces and have no compile-time dependency on vendor-specific HALs, SDKs, or hardware registers.
+3. **Reusable Infrastructure**: Shared CMake toolchains and build utilities are centralized under `/cmake` to eliminate duplicated build configuration across supported boards.
+
+---
+
+## 2. Directory Structure
+
+```text
+samplex/ (repository root)
+├── libs/ # Shared RTOS components (ThreadX, NetX Duo, FileX, USBX)
+├── scripts/ # Repository-wide helper scripts
+├── MXChip/ # [Pre-framework] Standalone board sample
+├── OpenHW/ # [Pre-framework] Standalone board sample
+├── STMicroelectronics/ # [Pre-framework] Standalone board samples
+├── targets/ # [Framework] Supported BSP target boards
+│ └── Microchip/
+│ └── POLARFIRE_ICICLE_RENODE/ # Board-specific BSP implementation & Renode target
+├── bsp/ # [Framework] Abstract BSP interface definitions
+│ └── include/bsp/ # board.h, led.h, console.h
+├── cmake/ # [Framework] Shared CMake configuration and utilities
+├── docs/ # [Framework] Architecture and onboarding documentation
+└── templates/ # [Framework] Templates for onboarding new boards
+```
+
+---
+
+## 3. BSP Interface Contract
+
+Every board added to the framework under `/targets` must implement the abstract APIs defined in `/bsp/include/bsp/`.
+
+### Core Board Control (`board.h`)
+
+* `void bsp_board_init(void)`: Initializes the board, including system clocks, GPIO, and required peripherals.
+
+### LED Control (`led.h`)
+
+* `void bsp_led_init(void)`: Configures the board's user LED.
+* `void bsp_led_on(void)`: Turns the LED on.
+* `void bsp_led_off(void)`: Turns the LED off.
+* `void bsp_led_toggle(void)`: Toggles the LED state.
+
+### Serial Console (`console.h`)
+
+* `void bsp_console_init(void)`: Initializes the default UART console.
+* `void bsp_console_write(const char *data, size_t length)`: Transmits a block of data over the console interface.
+
+---
+
+## 4. How to Onboard a New Board
+
+1. **Create the Target Folder**: Create a new directory under `targets/<Vendor>/<Board_Name>/` using `/templates/target/` as the starting point.
+2. **Define Local Configuration**: Create a `board_config.h` file containing board-specific settings such as clock configuration, UART parameters, and ThreadX memory allocation.
+3. **Implement the BSP APIs**: Implement the interfaces defined in `/bsp/include/bsp/` using the vendor SDK or direct register access.
+4. **Configure CMake**: Add the board target to `CMakeLists.txt`, build the BSP as a static library, and link it with the desired application from `/apps/`.
+
+Once a board implements the required BSP interfaces, any compatible application under `/apps` can be built for that board without modifying the application source.

targets/Microchip/POLARFIRE_ICICLE_RENODE/CMakeLists.txt

@@ -0,0 +1,41 @@
+#
+# Copyright (c) 2026 Eclipse ThreadX contributors
+#
+# This program and the accompanying materials are made available
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+#
+# SPDX-License-Identifier: MIT
+#
+
+cmake_minimum_required(VERSION 3.20)
+
+set(CMAKE_SYSTEM_NAME Generic)
+set(CMAKE_SYSTEM_PROCESSOR riscv64)
+
+# Set 64-bit RISC-V Cross Compiler
+if(DEFINED ENV{RISCV64_TOOLCHAIN_PATH})
+ set(TOOLCHAIN_BIN_DIR "$ENV{RISCV64_TOOLCHAIN_PATH}/bin")
+ find_program(CMAKE_C_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+ find_program(CMAKE_CXX_COMPILER NAMES riscv-none-elf-g++ riscv64-none-elf-g++ riscv64-unknown-elf-g++ PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+ find_program(CMAKE_ASM_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+else()
+ find_program(CMAKE_C_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc REQUIRED)
+ find_program(CMAKE_CXX_COMPILER NAMES riscv-none-elf-g++ riscv64-none-elf-g++ riscv64-unknown-elf-g++ REQUIRED)
+ find_program(CMAKE_ASM_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc REQUIRED)
+endif()
+
+project(polarfire_icicle_renode C ASM)
+
+# Root Directories
+set(SAMPLEX_ROOT_DIR "${CMAKE_CURRENT_LIST_DIR}/../../..")
+set(THREADX_DIR "${SAMPLEX_ROOT_DIR}/libs/threadx")
+
+# Architecture flags for SiFive U54 64-Bit RISC-V Core (RV64GC / lp64d)
+set(RISCV_FLAGS "-march=rv64gc -mabi=lp64d -mcmodel=medany")
+set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${RISCV_FLAGS} -O2 -g -Wall -Wextra")
+set(CMAKE_ASM_FLAGS "${CMAKE_ASM_FLAGS} ${RISCV_FLAGS}")
+set(CMAKE_EXE_LINKER_FLAGS "${RISCV_FLAGS} -T${CMAKE_CURRENT_LIST_DIR}/app/common/linker/linker.ld -nostartfiles -Wl,--gc-sections")
+
+add_subdirectory(lib)
+add_subdirectory(app)

.github/workflows/ci.yml

@@ -0,0 +1,103 @@
+#
+# Copyright (c) 2026 Eclipse ThreadX contributors
+#
+# This program and the accompanying materials are made available
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+#
+# SPDX-License-Identifier: MIT
+#
+
+name: SampleX CI Verification Pipeline
+
+on:
+ push:
+ branches: [ main, master, dev, 'feat/**' ]
+ pull_request:
+ branches: [ main, master, dev ]
+
+jobs:
+ build-riscv-polarfire:
+ name: Build PolarFire SoC Icicle Kit (64-Bit RISC-V)
+ runs-on: ubuntu-24.04
+ timeout-minutes: 20
+ steps:
+ - name: Checkout Repository
+ uses: actions/checkout@v4
+ with:
+ submodules: recursive
+
+ - name: Install CMake and Ninja
+ run: |
+ sudo apt-get update
+ sudo apt-get install -y cmake ninja-build
+
+ - name: Install Pinned xPack RISC-V GCC 14.2.0
+ env:
+ XPACK_TARBALL: xpack-riscv-none-elf-gcc-14.2.0-1-linux-x64.tar.gz
+ XPACK_SHA256: a5eb707595e1424ff4127cc8b21b8b8cb076e6f0070b670485e72b9f74806200
+ run: |
+ set -euo pipefail
+ wget -q "https://github.com/xpack-dev-tools/riscv-none-elf-gcc-xpack/releases/download/v14.2.0-1/${XPACK_TARBALL}"
+ echo "${XPACK_SHA256} ${XPACK_TARBALL}" | sha256sum --check --strict
+ mkdir -p $HOME/riscv-gcc
+ tar -xzf "${XPACK_TARBALL}" -C $HOME/riscv-gcc --strip-components=1
+ rm "${XPACK_TARBALL}"
+ echo "$HOME/riscv-gcc/bin" >> $GITHUB_PATH
+
+ - name: Build SampleX PolarFire Condition-Monitoring Demo
+ run: |
+ bash targets/Microchip/POLARFIRE_ICICLE_RENODE/scripts/build.sh --rebuild
+
+ - name: Verify SampleX Demo ELF
+ run: |
+ test -f targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app/polarfire_icicle_demo.elf
+ echo "[OK] PolarFire SampleX demo ELF verified."
+
+ - name: Archive Built PolarFire ELF
+ uses: actions/upload-artifact@v4
+ with:
+ name: polarfire-demo-elf
+ path: targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app/polarfire_icicle_demo.elf
+ retention-days: 1
+
+ test-polarfire-renode:
+ name: Headless Renode Emulation & Assertion Test
+ needs: build-riscv-polarfire
+ runs-on: ubuntu-24.04
+ # Backstop in case Renode itself wedges before the in-script deadline fires.
+ timeout-minutes: 15
+ steps:
+ - name: Checkout Repository
+ uses: actions/checkout@v4
+ with:
+ submodules: recursive
+
+ - name: Set Up Python
+ uses: actions/setup-python@v5
+ with:
+ python-version: "3.11"
+
+ - name: Download Built PolarFire ELF
+ uses: actions/download-artifact@v4
+ with:
+ name: polarfire-demo-elf
+ path: targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app
+
+ - name: Install Pinned Portable Renode Emulation Environment
+ env:
+ RENODE_VERSION: 1.16.1
+ RENODE_SHA256: 1a532d4b5b82de0dd154970c401e0c7b0e498d17304b2cecc007e306c8f9617c
+ run: |
+ set -euo pipefail
+ TARBALL="renode-${RENODE_VERSION}.linux-portable.tar.gz"
+ wget -q "https://github.com/renode/renode/releases/download/v${RENODE_VERSION}/${TARBALL}"
+ echo "${RENODE_SHA256} ${TARBALL}" | sha256sum --check --strict
+ mkdir -p $HOME/renode
+ tar -xzf "${TARBALL}" -C $HOME/renode --strip-components=1
+ rm "${TARBALL}"
+ echo "$HOME/renode" >> $GITHUB_PATH
+
+ - name: Run Deterministic Headless Renode Test
+ run: |
+ python3 targets/Microchip/POLARFIRE_ICICLE_RENODE/scripts/test_renode.py

bsp/include/bsp/board.h

@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_BOARD_H
+#define BSP_BOARD_H
+
+/**
+ * @brief Initialize the system core (clocks, flash latency, system configuration).
+ */
+void bsp_board_init(void);
+
+#endif /* BSP_BOARD_H */

bsp/include/bsp/console.h

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_CONSOLE_H
+#define BSP_CONSOLE_H
+
+#include <stddef.h>
+
+/**
+ * @brief Initialize the serial console peripheral and pin muxing.
+ */
+void bsp_console_init(void);
+
+/**
+ * @brief Write a buffer of data to the serial console.
+ * 
+ * @param data Pointer to the character buffer to send.
+ * @param length Number of characters to transmit.
+ */
+void bsp_console_write(const char *data, size_t length);
+
+#endif /* BSP_CONSOLE_H */

bsp/include/bsp/led.h

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_LED_H
+#define BSP_LED_H
+
+/**
+ * @brief Initialize the user LED hardware pin/peripherals.
+ */
+void bsp_led_init(void);
+
+/**
+ * @brief Turn the user LED on.
+ */
+void bsp_led_on(void);
+
+/**
+ * @brief Turn the user LED off.
+ */
+void bsp_led_off(void);
+
+/**
+ * @brief Toggle the state of the user LED.
+ */
+void bsp_led_toggle(void);
+
+#endif /* BSP_LED_H */

cmake/utilities.cmake

@@ -0,0 +1,50 @@
+# Copyright (c) Microsoft
+# Copyright (c) 2024 Eclipse Foundation
+# 
+# This program and the accompanying materials are made available 
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+# 
+# SPDX-License-Identifier: MIT
+# 
+# Contributors: 
+# Microsoft - Initial version
+# Frédéric Desbiens - 2024 version.
+
+function(post_build TARGET)
+ if(CMAKE_C_COMPILER_ID STREQUAL "IAR")
+ add_custom_target(${TARGET}.bin ALL 
+ DEPENDS ${TARGET}
+ COMMAND ${CMAKE_IAR_ELFTOOL} --bin ${TARGET}.elf ${TARGET}.bin)
+ elseif(CMAKE_C_COMPILER_ID STREQUAL "GNU")
+ add_custom_target(${TARGET}.bin ALL 
+ DEPENDS ${TARGET}
+ COMMAND ${CMAKE_OBJCOPY} -Obinary ${TARGET}.elf ${TARGET}.bin
+ COMMAND ${CMAKE_OBJCOPY} -Oihex ${TARGET}.elf ${TARGET}.hex)
+ else()
+ message(FATAL_ERROR "Unknown CMAKE_C_COMPILER_ID ${CMAKE_C_COMPILER_ID}")
+ endif()
+endfunction()
+
+function(set_target_linker TARGET LINKER_SCRIPT)
+ if(CMAKE_C_COMPILER_ID STREQUAL "IAR")
+ target_link_options(${TARGET} PRIVATE --config ${LINKER_SCRIPT})
+ target_link_options(${TARGET} PRIVATE --map=${TARGET}.map)
+ elseif(CMAKE_C_COMPILER_ID STREQUAL "GNU")
+ target_link_options(${TARGET} PRIVATE -T${LINKER_SCRIPT})
+ target_link_options(${TARGET} PRIVATE -Wl,-Map=${TARGET}.map)
+ set_target_properties(${TARGET} PROPERTIES SUFFIX ".elf") 
+
+ else()
+ message(FATAL_ERROR "Unknown CMAKE_C_COMPILER_ID ${CMAKE_C_COMPILER_ID}")
+ endif()
+endfunction()
+
+macro(print_all_variables)
+ message(STATUS "print_all_variables------------------------------------------{")
+ get_cmake_property(_variableNames VARIABLES)
+ foreach (_variableName ${_variableNames})
+ message(STATUS "${_variableName}=${${_variableName}}")
+ endforeach()
+ message(STATUS "print_all_variables------------------------------------------}")
+endmacro()

docs/architecture.md

@@ -0,0 +1,67 @@
+# Eclipse ThreadX BSP Framework Architecture
+
+This document describes the architecture, design philosophy, directory structure, and onboarding process for the reusable Board Support Package (BSP) framework.
+
+---
+
+## 1. Design Philosophy
+
+The BSP framework is designed to be **additive and non-invasive**, allowing new boards to be integrated without modifying existing board implementations.
+
+1. **Legacy Isolation**: The board directories that predate this framework (`/MXChip`, `/OpenHW`, `/STMicroelectronics`) remain completely untouched, preserving their drivers, submodules, and build systems.
+2. **Platform-Independent Applications**: Target applications use only the abstract BSP interfaces and have no compile-time dependency on vendor-specific HALs, SDKs, or hardware registers.
+3. **Reusable Infrastructure**: Shared CMake toolchains and build utilities are centralized under `/cmake` to eliminate duplicated build configuration across supported boards.
+
+---
+
+## 2. Directory Structure
+
+```text
+samplex/ (repository root)
+├── libs/ # Shared RTOS components (ThreadX, NetX Duo, FileX, USBX)
+├── scripts/ # Repository-wide helper scripts
+├── MXChip/ # [Pre-framework] Standalone board sample
+├── OpenHW/ # [Pre-framework] Standalone board sample
+├── STMicroelectronics/ # [Pre-framework] Standalone board samples
+├── targets/ # [Framework] Supported BSP target boards
+│ └── Microchip/
+│ └── POLARFIRE_ICICLE_RENODE/ # Board-specific BSP implementation & Renode target
+├── bsp/ # [Framework] Abstract BSP interface definitions
+│ └── include/bsp/ # board.h, led.h, console.h
+├── cmake/ # [Framework] Shared CMake configuration and utilities
+├── docs/ # [Framework] Architecture and onboarding documentation
+└── templates/ # [Framework] Templates for onboarding new boards
+```
+
+---
+
+## 3. BSP Interface Contract
+
+Every board added to the framework under `/targets` must implement the abstract APIs defined in `/bsp/include/bsp/`.
+
+### Core Board Control (`board.h`)
+
+* `void bsp_board_init(void)`: Initializes the board, including system clocks, GPIO, and required peripherals.
+
+### LED Control (`led.h`)
+
+* `void bsp_led_init(void)`: Configures the board's user LED.
+* `void bsp_led_on(void)`: Turns the LED on.
+* `void bsp_led_off(void)`: Turns the LED off.
+* `void bsp_led_toggle(void)`: Toggles the LED state.
+
+### Serial Console (`console.h`)
+
+* `void bsp_console_init(void)`: Initializes the default UART console.
+* `void bsp_console_write(const char *data, size_t length)`: Transmits a block of data over the console interface.
+
+---
+
+## 4. How to Onboard a New Board
+
+1. **Create the Target Folder**: Create a new directory under `targets/<Vendor>/<Board_Name>/` using `/templates/target/` as the starting point.
+2. **Define Local Configuration**: Create a `board_config.h` file containing board-specific settings such as clock configuration, UART parameters, and ThreadX memory allocation.
+3. **Implement the BSP APIs**: Implement the interfaces defined in `/bsp/include/bsp/` using the vendor SDK or direct register access.
+4. **Configure CMake**: Add the board target to `CMakeLists.txt`, build the BSP as a static library, and link it with the desired application from `/apps/`.
+
+Once a board implements the required BSP interfaces, any compatible application under `/apps` can be built for that board without modifying the application source.

targets/Microchip/POLARFIRE_ICICLE_RENODE/CMakeLists.txt

@@ -0,0 +1,41 @@
+#
+# Copyright (c) 2026 Eclipse ThreadX contributors
+#
+# This program and the accompanying materials are made available
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+#
+# SPDX-License-Identifier: MIT
+#
+
+cmake_minimum_required(VERSION 3.20)
+
+set(CMAKE_SYSTEM_NAME Generic)
+set(CMAKE_SYSTEM_PROCESSOR riscv64)
+
+# Set 64-bit RISC-V Cross Compiler
+if(DEFINED ENV{RISCV64_TOOLCHAIN_PATH})
+ set(TOOLCHAIN_BIN_DIR "$ENV{RISCV64_TOOLCHAIN_PATH}/bin")
+ find_program(CMAKE_C_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+ find_program(CMAKE_CXX_COMPILER NAMES riscv-none-elf-g++ riscv64-none-elf-g++ riscv64-unknown-elf-g++ PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+ find_program(CMAKE_ASM_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+else()
+ find_program(CMAKE_C_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc REQUIRED)
+ find_program(CMAKE_CXX_COMPILER NAMES riscv-none-elf-g++ riscv64-none-elf-g++ riscv64-unknown-elf-g++ REQUIRED)
+ find_program(CMAKE_ASM_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc REQUIRED)
+endif()
+
+project(polarfire_icicle_renode C ASM)
+
+# Root Directories
+set(SAMPLEX_ROOT_DIR "${CMAKE_CURRENT_LIST_DIR}/../../..")
+set(THREADX_DIR "${SAMPLEX_ROOT_DIR}/libs/threadx")
+
+# Architecture flags for SiFive U54 64-Bit RISC-V Core (RV64GC / lp64d)
+set(RISCV_FLAGS "-march=rv64gc -mabi=lp64d -mcmodel=medany")
+set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${RISCV_FLAGS} -O2 -g -Wall -Wextra")
+set(CMAKE_ASM_FLAGS "${CMAKE_ASM_FLAGS} ${RISCV_FLAGS}")
+set(CMAKE_EXE_LINKER_FLAGS "${RISCV_FLAGS} -T${CMAKE_CURRENT_LIST_DIR}/app/common/linker/linker.ld -nostartfiles -Wl,--gc-sections")
+
+add_subdirectory(lib)
+add_subdirectory(app)

.github/workflows/ci.yml

@@ -0,0 +1,103 @@
+#
+# Copyright (c) 2026 Eclipse ThreadX contributors
+#
+# This program and the accompanying materials are made available
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+#
+# SPDX-License-Identifier: MIT
+#
+
+name: SampleX CI Verification Pipeline
+
+on:
+ push:
+ branches: [ main, master, dev, 'feat/**' ]
+ pull_request:
+ branches: [ main, master, dev ]
+
+jobs:
+ build-riscv-polarfire:
+ name: Build PolarFire SoC Icicle Kit (64-Bit RISC-V)
+ runs-on: ubuntu-24.04
+ timeout-minutes: 20
+ steps:
+ - name: Checkout Repository
+ uses: actions/checkout@v4
+ with:
+ submodules: recursive
+
+ - name: Install CMake and Ninja
+ run: |
+ sudo apt-get update
+ sudo apt-get install -y cmake ninja-build
+
+ - name: Install Pinned xPack RISC-V GCC 14.2.0
+ env:
+ XPACK_TARBALL: xpack-riscv-none-elf-gcc-14.2.0-1-linux-x64.tar.gz
+ XPACK_SHA256: a5eb707595e1424ff4127cc8b21b8b8cb076e6f0070b670485e72b9f74806200
+ run: |
+ set -euo pipefail
+ wget -q "https://github.com/xpack-dev-tools/riscv-none-elf-gcc-xpack/releases/download/v14.2.0-1/${XPACK_TARBALL}"
+ echo "${XPACK_SHA256} ${XPACK_TARBALL}" | sha256sum --check --strict
+ mkdir -p $HOME/riscv-gcc
+ tar -xzf "${XPACK_TARBALL}" -C $HOME/riscv-gcc --strip-components=1
+ rm "${XPACK_TARBALL}"
+ echo "$HOME/riscv-gcc/bin" >> $GITHUB_PATH
+
+ - name: Build SampleX PolarFire Condition-Monitoring Demo
+ run: |
+ bash targets/Microchip/POLARFIRE_ICICLE_RENODE/scripts/build.sh --rebuild
+
+ - name: Verify SampleX Demo ELF
+ run: |
+ test -f targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app/polarfire_icicle_demo.elf
+ echo "[OK] PolarFire SampleX demo ELF verified."
+
+ - name: Archive Built PolarFire ELF
+ uses: actions/upload-artifact@v4
+ with:
+ name: polarfire-demo-elf
+ path: targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app/polarfire_icicle_demo.elf
+ retention-days: 1
+
+ test-polarfire-renode:
+ name: Headless Renode Emulation & Assertion Test
+ needs: build-riscv-polarfire
+ runs-on: ubuntu-24.04
+ # Backstop in case Renode itself wedges before the in-script deadline fires.
+ timeout-minutes: 15
+ steps:
+ - name: Checkout Repository
+ uses: actions/checkout@v4
+ with:
+ submodules: recursive
+
+ - name: Set Up Python
+ uses: actions/setup-python@v5
+ with:
+ python-version: "3.11"
+
+ - name: Download Built PolarFire ELF
+ uses: actions/download-artifact@v4
+ with:
+ name: polarfire-demo-elf
+ path: targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app
+
+ - name: Install Pinned Portable Renode Emulation Environment
+ env:
+ RENODE_VERSION: 1.16.1
+ RENODE_SHA256: 1a532d4b5b82de0dd154970c401e0c7b0e498d17304b2cecc007e306c8f9617c
+ run: |
+ set -euo pipefail
+ TARBALL="renode-${RENODE_VERSION}.linux-portable.tar.gz"
+ wget -q "https://github.com/renode/renode/releases/download/v${RENODE_VERSION}/${TARBALL}"
+ echo "${RENODE_SHA256} ${TARBALL}" | sha256sum --check --strict
+ mkdir -p $HOME/renode
+ tar -xzf "${TARBALL}" -C $HOME/renode --strip-components=1
+ rm "${TARBALL}"
+ echo "$HOME/renode" >> $GITHUB_PATH
+
+ - name: Run Deterministic Headless Renode Test
+ run: |
+ python3 targets/Microchip/POLARFIRE_ICICLE_RENODE/scripts/test_renode.py

bsp/include/bsp/board.h

@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_BOARD_H
+#define BSP_BOARD_H
+
+/**
+ * @brief Initialize the system core (clocks, flash latency, system configuration).
+ */
+void bsp_board_init(void);
+
+#endif /* BSP_BOARD_H */

bsp/include/bsp/console.h

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_CONSOLE_H
+#define BSP_CONSOLE_H
+
+#include <stddef.h>
+
+/**
+ * @brief Initialize the serial console peripheral and pin muxing.
+ */
+void bsp_console_init(void);
+
+/**
+ * @brief Write a buffer of data to the serial console.
+ * 
+ * @param data Pointer to the character buffer to send.
+ * @param length Number of characters to transmit.
+ */
+void bsp_console_write(const char *data, size_t length);
+
+#endif /* BSP_CONSOLE_H */

bsp/include/bsp/led.h

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_LED_H
+#define BSP_LED_H
+
+/**
+ * @brief Initialize the user LED hardware pin/peripherals.
+ */
+void bsp_led_init(void);
+
+/**
+ * @brief Turn the user LED on.
+ */
+void bsp_led_on(void);
+
+/**
+ * @brief Turn the user LED off.
+ */
+void bsp_led_off(void);
+
+/**
+ * @brief Toggle the state of the user LED.
+ */
+void bsp_led_toggle(void);
+
+#endif /* BSP_LED_H */

cmake/utilities.cmake

@@ -0,0 +1,50 @@
+# Copyright (c) Microsoft
+# Copyright (c) 2024 Eclipse Foundation
+# 
+# This program and the accompanying materials are made available 
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+# 
+# SPDX-License-Identifier: MIT
+# 
+# Contributors: 
+# Microsoft - Initial version
+# Frédéric Desbiens - 2024 version.
+
+function(post_build TARGET)
+ if(CMAKE_C_COMPILER_ID STREQUAL "IAR")
+ add_custom_target(${TARGET}.bin ALL 
+ DEPENDS ${TARGET}
+ COMMAND ${CMAKE_IAR_ELFTOOL} --bin ${TARGET}.elf ${TARGET}.bin)
+ elseif(CMAKE_C_COMPILER_ID STREQUAL "GNU")
+ add_custom_target(${TARGET}.bin ALL 
+ DEPENDS ${TARGET}
+ COMMAND ${CMAKE_OBJCOPY} -Obinary ${TARGET}.elf ${TARGET}.bin
+ COMMAND ${CMAKE_OBJCOPY} -Oihex ${TARGET}.elf ${TARGET}.hex)
+ else()
+ message(FATAL_ERROR "Unknown CMAKE_C_COMPILER_ID ${CMAKE_C_COMPILER_ID}")
+ endif()
+endfunction()
+
+function(set_target_linker TARGET LINKER_SCRIPT)
+ if(CMAKE_C_COMPILER_ID STREQUAL "IAR")
+ target_link_options(${TARGET} PRIVATE --config ${LINKER_SCRIPT})
+ target_link_options(${TARGET} PRIVATE --map=${TARGET}.map)
+ elseif(CMAKE_C_COMPILER_ID STREQUAL "GNU")
+ target_link_options(${TARGET} PRIVATE -T${LINKER_SCRIPT})
+ target_link_options(${TARGET} PRIVATE -Wl,-Map=${TARGET}.map)
+ set_target_properties(${TARGET} PROPERTIES SUFFIX ".elf") 
+
+ else()
+ message(FATAL_ERROR "Unknown CMAKE_C_COMPILER_ID ${CMAKE_C_COMPILER_ID}")
+ endif()
+endfunction()
+
+macro(print_all_variables)
+ message(STATUS "print_all_variables------------------------------------------{")
+ get_cmake_property(_variableNames VARIABLES)
+ foreach (_variableName ${_variableNames})
+ message(STATUS "${_variableName}=${${_variableName}}")
+ endforeach()
+ message(STATUS "print_all_variables------------------------------------------}")
+endmacro()

docs/architecture.md

@@ -0,0 +1,67 @@
+# Eclipse ThreadX BSP Framework Architecture
+
+This document describes the architecture, design philosophy, directory structure, and onboarding process for the reusable Board Support Package (BSP) framework.
+
+---
+
+## 1. Design Philosophy
+
+The BSP framework is designed to be **additive and non-invasive**, allowing new boards to be integrated without modifying existing board implementations.
+
+1. **Legacy Isolation**: The board directories that predate this framework (`/MXChip`, `/OpenHW`, `/STMicroelectronics`) remain completely untouched, preserving their drivers, submodules, and build systems.
+2. **Platform-Independent Applications**: Target applications use only the abstract BSP interfaces and have no compile-time dependency on vendor-specific HALs, SDKs, or hardware registers.
+3. **Reusable Infrastructure**: Shared CMake toolchains and build utilities are centralized under `/cmake` to eliminate duplicated build configuration across supported boards.
+
+---
+
+## 2. Directory Structure
+
+```text
+samplex/ (repository root)
+├── libs/ # Shared RTOS components (ThreadX, NetX Duo, FileX, USBX)
+├── scripts/ # Repository-wide helper scripts
+├── MXChip/ # [Pre-framework] Standalone board sample
+├── OpenHW/ # [Pre-framework] Standalone board sample
+├── STMicroelectronics/ # [Pre-framework] Standalone board samples
+├── targets/ # [Framework] Supported BSP target boards
+│ └── Microchip/
+│ └── POLARFIRE_ICICLE_RENODE/ # Board-specific BSP implementation & Renode target
+├── bsp/ # [Framework] Abstract BSP interface definitions
+│ └── include/bsp/ # board.h, led.h, console.h
+├── cmake/ # [Framework] Shared CMake configuration and utilities
+├── docs/ # [Framework] Architecture and onboarding documentation
+└── templates/ # [Framework] Templates for onboarding new boards
+```
+
+---
+
+## 3. BSP Interface Contract
+
+Every board added to the framework under `/targets` must implement the abstract APIs defined in `/bsp/include/bsp/`.
+
+### Core Board Control (`board.h`)
+
+* `void bsp_board_init(void)`: Initializes the board, including system clocks, GPIO, and required peripherals.
+
+### LED Control (`led.h`)
+
+* `void bsp_led_init(void)`: Configures the board's user LED.
+* `void bsp_led_on(void)`: Turns the LED on.
+* `void bsp_led_off(void)`: Turns the LED off.
+* `void bsp_led_toggle(void)`: Toggles the LED state.
+
+### Serial Console (`console.h`)
+
+* `void bsp_console_init(void)`: Initializes the default UART console.
+* `void bsp_console_write(const char *data, size_t length)`: Transmits a block of data over the console interface.
+
+---
+
+## 4. How to Onboard a New Board
+
+1. **Create the Target Folder**: Create a new directory under `targets/<Vendor>/<Board_Name>/` using `/templates/target/` as the starting point.
+2. **Define Local Configuration**: Create a `board_config.h` file containing board-specific settings such as clock configuration, UART parameters, and ThreadX memory allocation.
+3. **Implement the BSP APIs**: Implement the interfaces defined in `/bsp/include/bsp/` using the vendor SDK or direct register access.
+4. **Configure CMake**: Add the board target to `CMakeLists.txt`, build the BSP as a static library, and link it with the desired application from `/apps/`.
+
+Once a board implements the required BSP interfaces, any compatible application under `/apps` can be built for that board without modifying the application source.

targets/Microchip/POLARFIRE_ICICLE_RENODE/CMakeLists.txt

@@ -0,0 +1,41 @@
+#
+# Copyright (c) 2026 Eclipse ThreadX contributors
+#
+# This program and the accompanying materials are made available
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+#
+# SPDX-License-Identifier: MIT
+#
+
+cmake_minimum_required(VERSION 3.20)
+
+set(CMAKE_SYSTEM_NAME Generic)
+set(CMAKE_SYSTEM_PROCESSOR riscv64)
+
+# Set 64-bit RISC-V Cross Compiler
+if(DEFINED ENV{RISCV64_TOOLCHAIN_PATH})
+ set(TOOLCHAIN_BIN_DIR "$ENV{RISCV64_TOOLCHAIN_PATH}/bin")
+ find_program(CMAKE_C_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+ find_program(CMAKE_CXX_COMPILER NAMES riscv-none-elf-g++ riscv64-none-elf-g++ riscv64-unknown-elf-g++ PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+ find_program(CMAKE_ASM_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+else()
+ find_program(CMAKE_C_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc REQUIRED)
+ find_program(CMAKE_CXX_COMPILER NAMES riscv-none-elf-g++ riscv64-none-elf-g++ riscv64-unknown-elf-g++ REQUIRED)
+ find_program(CMAKE_ASM_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc REQUIRED)
+endif()
+
+project(polarfire_icicle_renode C ASM)
+
+# Root Directories
+set(SAMPLEX_ROOT_DIR "${CMAKE_CURRENT_LIST_DIR}/../../..")
+set(THREADX_DIR "${SAMPLEX_ROOT_DIR}/libs/threadx")
+
+# Architecture flags for SiFive U54 64-Bit RISC-V Core (RV64GC / lp64d)
+set(RISCV_FLAGS "-march=rv64gc -mabi=lp64d -mcmodel=medany")
+set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${RISCV_FLAGS} -O2 -g -Wall -Wextra")
+set(CMAKE_ASM_FLAGS "${CMAKE_ASM_FLAGS} ${RISCV_FLAGS}")
+set(CMAKE_EXE_LINKER_FLAGS "${RISCV_FLAGS} -T${CMAKE_CURRENT_LIST_DIR}/app/common/linker/linker.ld -nostartfiles -Wl,--gc-sections")
+
+add_subdirectory(lib)
+add_subdirectory(app)

.github/workflows/ci.yml

@@ -0,0 +1,103 @@
+#
+# Copyright (c) 2026 Eclipse ThreadX contributors
+#
+# This program and the accompanying materials are made available
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+#
+# SPDX-License-Identifier: MIT
+#
+
+name: SampleX CI Verification Pipeline
+
+on:
+ push:
+ branches: [ main, master, dev, 'feat/**' ]
+ pull_request:
+ branches: [ main, master, dev ]
+
+jobs:
+ build-riscv-polarfire:
+ name: Build PolarFire SoC Icicle Kit (64-Bit RISC-V)
+ runs-on: ubuntu-24.04
+ timeout-minutes: 20
+ steps:
+ - name: Checkout Repository
+ uses: actions/checkout@v4
+ with:
+ submodules: recursive
+
+ - name: Install CMake and Ninja
+ run: |
+ sudo apt-get update
+ sudo apt-get install -y cmake ninja-build
+
+ - name: Install Pinned xPack RISC-V GCC 14.2.0
+ env:
+ XPACK_TARBALL: xpack-riscv-none-elf-gcc-14.2.0-1-linux-x64.tar.gz
+ XPACK_SHA256: a5eb707595e1424ff4127cc8b21b8b8cb076e6f0070b670485e72b9f74806200
+ run: |
+ set -euo pipefail
+ wget -q "https://github.com/xpack-dev-tools/riscv-none-elf-gcc-xpack/releases/download/v14.2.0-1/${XPACK_TARBALL}"
+ echo "${XPACK_SHA256} ${XPACK_TARBALL}" | sha256sum --check --strict
+ mkdir -p $HOME/riscv-gcc
+ tar -xzf "${XPACK_TARBALL}" -C $HOME/riscv-gcc --strip-components=1
+ rm "${XPACK_TARBALL}"
+ echo "$HOME/riscv-gcc/bin" >> $GITHUB_PATH
+
+ - name: Build SampleX PolarFire Condition-Monitoring Demo
+ run: |
+ bash targets/Microchip/POLARFIRE_ICICLE_RENODE/scripts/build.sh --rebuild
+
+ - name: Verify SampleX Demo ELF
+ run: |
+ test -f targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app/polarfire_icicle_demo.elf
+ echo "[OK] PolarFire SampleX demo ELF verified."
+
+ - name: Archive Built PolarFire ELF
+ uses: actions/upload-artifact@v4
+ with:
+ name: polarfire-demo-elf
+ path: targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app/polarfire_icicle_demo.elf
+ retention-days: 1
+
+ test-polarfire-renode:
+ name: Headless Renode Emulation & Assertion Test
+ needs: build-riscv-polarfire
+ runs-on: ubuntu-24.04
+ # Backstop in case Renode itself wedges before the in-script deadline fires.
+ timeout-minutes: 15
+ steps:
+ - name: Checkout Repository
+ uses: actions/checkout@v4
+ with:
+ submodules: recursive
+
+ - name: Set Up Python
+ uses: actions/setup-python@v5
+ with:
+ python-version: "3.11"
+
+ - name: Download Built PolarFire ELF
+ uses: actions/download-artifact@v4
+ with:
+ name: polarfire-demo-elf
+ path: targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app
+
+ - name: Install Pinned Portable Renode Emulation Environment
+ env:
+ RENODE_VERSION: 1.16.1
+ RENODE_SHA256: 1a532d4b5b82de0dd154970c401e0c7b0e498d17304b2cecc007e306c8f9617c
+ run: |
+ set -euo pipefail
+ TARBALL="renode-${RENODE_VERSION}.linux-portable.tar.gz"
+ wget -q "https://github.com/renode/renode/releases/download/v${RENODE_VERSION}/${TARBALL}"
+ echo "${RENODE_SHA256} ${TARBALL}" | sha256sum --check --strict
+ mkdir -p $HOME/renode
+ tar -xzf "${TARBALL}" -C $HOME/renode --strip-components=1
+ rm "${TARBALL}"
+ echo "$HOME/renode" >> $GITHUB_PATH
+
+ - name: Run Deterministic Headless Renode Test
+ run: |
+ python3 targets/Microchip/POLARFIRE_ICICLE_RENODE/scripts/test_renode.py

bsp/include/bsp/board.h

@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_BOARD_H
+#define BSP_BOARD_H
+
+/**
+ * @brief Initialize the system core (clocks, flash latency, system configuration).
+ */
+void bsp_board_init(void);
+
+#endif /* BSP_BOARD_H */

bsp/include/bsp/console.h

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_CONSOLE_H
+#define BSP_CONSOLE_H
+
+#include <stddef.h>
+
+/**
+ * @brief Initialize the serial console peripheral and pin muxing.
+ */
+void bsp_console_init(void);
+
+/**
+ * @brief Write a buffer of data to the serial console.
+ * 
+ * @param data Pointer to the character buffer to send.
+ * @param length Number of characters to transmit.
+ */
+void bsp_console_write(const char *data, size_t length);
+
+#endif /* BSP_CONSOLE_H */

bsp/include/bsp/led.h

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_LED_H
+#define BSP_LED_H
+
+/**
+ * @brief Initialize the user LED hardware pin/peripherals.
+ */
+void bsp_led_init(void);
+
+/**
+ * @brief Turn the user LED on.
+ */
+void bsp_led_on(void);
+
+/**
+ * @brief Turn the user LED off.
+ */
+void bsp_led_off(void);
+
+/**
+ * @brief Toggle the state of the user LED.
+ */
+void bsp_led_toggle(void);
+
+#endif /* BSP_LED_H */

cmake/utilities.cmake

@@ -0,0 +1,50 @@
+# Copyright (c) Microsoft
+# Copyright (c) 2024 Eclipse Foundation
+# 
+# This program and the accompanying materials are made available 
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+# 
+# SPDX-License-Identifier: MIT
+# 
+# Contributors: 
+# Microsoft - Initial version
+# Frédéric Desbiens - 2024 version.
+
+function(post_build TARGET)
+ if(CMAKE_C_COMPILER_ID STREQUAL "IAR")
+ add_custom_target(${TARGET}.bin ALL 
+ DEPENDS ${TARGET}
+ COMMAND ${CMAKE_IAR_ELFTOOL} --bin ${TARGET}.elf ${TARGET}.bin)
+ elseif(CMAKE_C_COMPILER_ID STREQUAL "GNU")
+ add_custom_target(${TARGET}.bin ALL 
+ DEPENDS ${TARGET}
+ COMMAND ${CMAKE_OBJCOPY} -Obinary ${TARGET}.elf ${TARGET}.bin
+ COMMAND ${CMAKE_OBJCOPY} -Oihex ${TARGET}.elf ${TARGET}.hex)
+ else()
+ message(FATAL_ERROR "Unknown CMAKE_C_COMPILER_ID ${CMAKE_C_COMPILER_ID}")
+ endif()
+endfunction()
+
+function(set_target_linker TARGET LINKER_SCRIPT)
+ if(CMAKE_C_COMPILER_ID STREQUAL "IAR")
+ target_link_options(${TARGET} PRIVATE --config ${LINKER_SCRIPT})
+ target_link_options(${TARGET} PRIVATE --map=${TARGET}.map)
+ elseif(CMAKE_C_COMPILER_ID STREQUAL "GNU")
+ target_link_options(${TARGET} PRIVATE -T${LINKER_SCRIPT})
+ target_link_options(${TARGET} PRIVATE -Wl,-Map=${TARGET}.map)
+ set_target_properties(${TARGET} PROPERTIES SUFFIX ".elf") 
+
+ else()
+ message(FATAL_ERROR "Unknown CMAKE_C_COMPILER_ID ${CMAKE_C_COMPILER_ID}")
+ endif()
+endfunction()
+
+macro(print_all_variables)
+ message(STATUS "print_all_variables------------------------------------------{")
+ get_cmake_property(_variableNames VARIABLES)
+ foreach (_variableName ${_variableNames})
+ message(STATUS "${_variableName}=${${_variableName}}")
+ endforeach()
+ message(STATUS "print_all_variables------------------------------------------}")
+endmacro()

docs/architecture.md

@@ -0,0 +1,67 @@
+# Eclipse ThreadX BSP Framework Architecture
+
+This document describes the architecture, design philosophy, directory structure, and onboarding process for the reusable Board Support Package (BSP) framework.
+
+---
+
+## 1. Design Philosophy
+
+The BSP framework is designed to be **additive and non-invasive**, allowing new boards to be integrated without modifying existing board implementations.
+
+1. **Legacy Isolation**: The board directories that predate this framework (`/MXChip`, `/OpenHW`, `/STMicroelectronics`) remain completely untouched, preserving their drivers, submodules, and build systems.
+2. **Platform-Independent Applications**: Target applications use only the abstract BSP interfaces and have no compile-time dependency on vendor-specific HALs, SDKs, or hardware registers.
+3. **Reusable Infrastructure**: Shared CMake toolchains and build utilities are centralized under `/cmake` to eliminate duplicated build configuration across supported boards.
+
+---
+
+## 2. Directory Structure
+
+```text
+samplex/ (repository root)
+├── libs/ # Shared RTOS components (ThreadX, NetX Duo, FileX, USBX)
+├── scripts/ # Repository-wide helper scripts
+├── MXChip/ # [Pre-framework] Standalone board sample
+├── OpenHW/ # [Pre-framework] Standalone board sample
+├── STMicroelectronics/ # [Pre-framework] Standalone board samples
+├── targets/ # [Framework] Supported BSP target boards
+│ └── Microchip/
+│ └── POLARFIRE_ICICLE_RENODE/ # Board-specific BSP implementation & Renode target
+├── bsp/ # [Framework] Abstract BSP interface definitions
+│ └── include/bsp/ # board.h, led.h, console.h
+├── cmake/ # [Framework] Shared CMake configuration and utilities
+├── docs/ # [Framework] Architecture and onboarding documentation
+└── templates/ # [Framework] Templates for onboarding new boards
+```
+
+---
+
+## 3. BSP Interface Contract
+
+Every board added to the framework under `/targets` must implement the abstract APIs defined in `/bsp/include/bsp/`.
+
+### Core Board Control (`board.h`)
+
+* `void bsp_board_init(void)`: Initializes the board, including system clocks, GPIO, and required peripherals.
+
+### LED Control (`led.h`)
+
+* `void bsp_led_init(void)`: Configures the board's user LED.
+* `void bsp_led_on(void)`: Turns the LED on.
+* `void bsp_led_off(void)`: Turns the LED off.
+* `void bsp_led_toggle(void)`: Toggles the LED state.
+
+### Serial Console (`console.h`)
+
+* `void bsp_console_init(void)`: Initializes the default UART console.
+* `void bsp_console_write(const char *data, size_t length)`: Transmits a block of data over the console interface.
+
+---
+
+## 4. How to Onboard a New Board
+
+1. **Create the Target Folder**: Create a new directory under `targets/<Vendor>/<Board_Name>/` using `/templates/target/` as the starting point.
+2. **Define Local Configuration**: Create a `board_config.h` file containing board-specific settings such as clock configuration, UART parameters, and ThreadX memory allocation.
+3. **Implement the BSP APIs**: Implement the interfaces defined in `/bsp/include/bsp/` using the vendor SDK or direct register access.
+4. **Configure CMake**: Add the board target to `CMakeLists.txt`, build the BSP as a static library, and link it with the desired application from `/apps/`.
+
+Once a board implements the required BSP interfaces, any compatible application under `/apps` can be built for that board without modifying the application source.

targets/Microchip/POLARFIRE_ICICLE_RENODE/CMakeLists.txt

@@ -0,0 +1,41 @@
+#
+# Copyright (c) 2026 Eclipse ThreadX contributors
+#
+# This program and the accompanying materials are made available
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+#
+# SPDX-License-Identifier: MIT
+#
+
+cmake_minimum_required(VERSION 3.20)
+
+set(CMAKE_SYSTEM_NAME Generic)
+set(CMAKE_SYSTEM_PROCESSOR riscv64)
+
+# Set 64-bit RISC-V Cross Compiler
+if(DEFINED ENV{RISCV64_TOOLCHAIN_PATH})
+ set(TOOLCHAIN_BIN_DIR "$ENV{RISCV64_TOOLCHAIN_PATH}/bin")
+ find_program(CMAKE_C_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+ find_program(CMAKE_CXX_COMPILER NAMES riscv-none-elf-g++ riscv64-none-elf-g++ riscv64-unknown-elf-g++ PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+ find_program(CMAKE_ASM_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+else()
+ find_program(CMAKE_C_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc REQUIRED)
+ find_program(CMAKE_CXX_COMPILER NAMES riscv-none-elf-g++ riscv64-none-elf-g++ riscv64-unknown-elf-g++ REQUIRED)
+ find_program(CMAKE_ASM_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc REQUIRED)
+endif()
+
+project(polarfire_icicle_renode C ASM)
+
+# Root Directories
+set(SAMPLEX_ROOT_DIR "${CMAKE_CURRENT_LIST_DIR}/../../..")
+set(THREADX_DIR "${SAMPLEX_ROOT_DIR}/libs/threadx")
+
+# Architecture flags for SiFive U54 64-Bit RISC-V Core (RV64GC / lp64d)
+set(RISCV_FLAGS "-march=rv64gc -mabi=lp64d -mcmodel=medany")
+set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${RISCV_FLAGS} -O2 -g -Wall -Wextra")
+set(CMAKE_ASM_FLAGS "${CMAKE_ASM_FLAGS} ${RISCV_FLAGS}")
+set(CMAKE_EXE_LINKER_FLAGS "${RISCV_FLAGS} -T${CMAKE_CURRENT_LIST_DIR}/app/common/linker/linker.ld -nostartfiles -Wl,--gc-sections")
+
+add_subdirectory(lib)
+add_subdirectory(app)

.github/workflows/ci.yml

@@ -0,0 +1,103 @@
+#
+# Copyright (c) 2026 Eclipse ThreadX contributors
+#
+# This program and the accompanying materials are made available
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+#
+# SPDX-License-Identifier: MIT
+#
+
+name: SampleX CI Verification Pipeline
+
+on:
+ push:
+ branches: [ main, master, dev, 'feat/**' ]
+ pull_request:
+ branches: [ main, master, dev ]
+
+jobs:
+ build-riscv-polarfire:
+ name: Build PolarFire SoC Icicle Kit (64-Bit RISC-V)
+ runs-on: ubuntu-24.04
+ timeout-minutes: 20
+ steps:
+ - name: Checkout Repository
+ uses: actions/checkout@v4
+ with:
+ submodules: recursive
+
+ - name: Install CMake and Ninja
+ run: |
+ sudo apt-get update
+ sudo apt-get install -y cmake ninja-build
+
+ - name: Install Pinned xPack RISC-V GCC 14.2.0
+ env:
+ XPACK_TARBALL: xpack-riscv-none-elf-gcc-14.2.0-1-linux-x64.tar.gz
+ XPACK_SHA256: a5eb707595e1424ff4127cc8b21b8b8cb076e6f0070b670485e72b9f74806200
+ run: |
+ set -euo pipefail
+ wget -q "https://github.com/xpack-dev-tools/riscv-none-elf-gcc-xpack/releases/download/v14.2.0-1/${XPACK_TARBALL}"
+ echo "${XPACK_SHA256} ${XPACK_TARBALL}" | sha256sum --check --strict
+ mkdir -p $HOME/riscv-gcc
+ tar -xzf "${XPACK_TARBALL}" -C $HOME/riscv-gcc --strip-components=1
+ rm "${XPACK_TARBALL}"
+ echo "$HOME/riscv-gcc/bin" >> $GITHUB_PATH
+
+ - name: Build SampleX PolarFire Condition-Monitoring Demo
+ run: |
+ bash targets/Microchip/POLARFIRE_ICICLE_RENODE/scripts/build.sh --rebuild
+
+ - name: Verify SampleX Demo ELF
+ run: |
+ test -f targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app/polarfire_icicle_demo.elf
+ echo "[OK] PolarFire SampleX demo ELF verified."
+
+ - name: Archive Built PolarFire ELF
+ uses: actions/upload-artifact@v4
+ with:
+ name: polarfire-demo-elf
+ path: targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app/polarfire_icicle_demo.elf
+ retention-days: 1
+
+ test-polarfire-renode:
+ name: Headless Renode Emulation & Assertion Test
+ needs: build-riscv-polarfire
+ runs-on: ubuntu-24.04
+ # Backstop in case Renode itself wedges before the in-script deadline fires.
+ timeout-minutes: 15
+ steps:
+ - name: Checkout Repository
+ uses: actions/checkout@v4
+ with:
+ submodules: recursive
+
+ - name: Set Up Python
+ uses: actions/setup-python@v5
+ with:
+ python-version: "3.11"
+
+ - name: Download Built PolarFire ELF
+ uses: actions/download-artifact@v4
+ with:
+ name: polarfire-demo-elf
+ path: targets/Microchip/POLARFIRE_ICICLE_RENODE/build/app
+
+ - name: Install Pinned Portable Renode Emulation Environment
+ env:
+ RENODE_VERSION: 1.16.1
+ RENODE_SHA256: 1a532d4b5b82de0dd154970c401e0c7b0e498d17304b2cecc007e306c8f9617c
+ run: |
+ set -euo pipefail
+ TARBALL="renode-${RENODE_VERSION}.linux-portable.tar.gz"
+ wget -q "https://github.com/renode/renode/releases/download/v${RENODE_VERSION}/${TARBALL}"
+ echo "${RENODE_SHA256} ${TARBALL}" | sha256sum --check --strict
+ mkdir -p $HOME/renode
+ tar -xzf "${TARBALL}" -C $HOME/renode --strip-components=1
+ rm "${TARBALL}"
+ echo "$HOME/renode" >> $GITHUB_PATH
+
+ - name: Run Deterministic Headless Renode Test
+ run: |
+ python3 targets/Microchip/POLARFIRE_ICICLE_RENODE/scripts/test_renode.py

bsp/include/bsp/board.h

@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_BOARD_H
+#define BSP_BOARD_H
+
+/**
+ * @brief Initialize the system core (clocks, flash latency, system configuration).
+ */
+void bsp_board_init(void);
+
+#endif /* BSP_BOARD_H */

bsp/include/bsp/console.h

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_CONSOLE_H
+#define BSP_CONSOLE_H
+
+#include <stddef.h>
+
+/**
+ * @brief Initialize the serial console peripheral and pin muxing.
+ */
+void bsp_console_init(void);
+
+/**
+ * @brief Write a buffer of data to the serial console.
+ * 
+ * @param data Pointer to the character buffer to send.
+ * @param length Number of characters to transmit.
+ */
+void bsp_console_write(const char *data, size_t length);
+
+#endif /* BSP_CONSOLE_H */

bsp/include/bsp/led.h

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2026 Eclipse ThreadX contributors
+ *
+ * This program and the accompanying materials are made available
+ * under the terms of the MIT license which is available at
+ * https://opensource.org/licenses/MIT.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef BSP_LED_H
+#define BSP_LED_H
+
+/**
+ * @brief Initialize the user LED hardware pin/peripherals.
+ */
+void bsp_led_init(void);
+
+/**
+ * @brief Turn the user LED on.
+ */
+void bsp_led_on(void);
+
+/**
+ * @brief Turn the user LED off.
+ */
+void bsp_led_off(void);
+
+/**
+ * @brief Toggle the state of the user LED.
+ */
+void bsp_led_toggle(void);
+
+#endif /* BSP_LED_H */

cmake/utilities.cmake

@@ -0,0 +1,50 @@
+# Copyright (c) Microsoft
+# Copyright (c) 2024 Eclipse Foundation
+# 
+# This program and the accompanying materials are made available 
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+# 
+# SPDX-License-Identifier: MIT
+# 
+# Contributors: 
+# Microsoft - Initial version
+# Frédéric Desbiens - 2024 version.
+
+function(post_build TARGET)
+ if(CMAKE_C_COMPILER_ID STREQUAL "IAR")
+ add_custom_target(${TARGET}.bin ALL 
+ DEPENDS ${TARGET}
+ COMMAND ${CMAKE_IAR_ELFTOOL} --bin ${TARGET}.elf ${TARGET}.bin)
+ elseif(CMAKE_C_COMPILER_ID STREQUAL "GNU")
+ add_custom_target(${TARGET}.bin ALL 
+ DEPENDS ${TARGET}
+ COMMAND ${CMAKE_OBJCOPY} -Obinary ${TARGET}.elf ${TARGET}.bin
+ COMMAND ${CMAKE_OBJCOPY} -Oihex ${TARGET}.elf ${TARGET}.hex)
+ else()
+ message(FATAL_ERROR "Unknown CMAKE_C_COMPILER_ID ${CMAKE_C_COMPILER_ID}")
+ endif()
+endfunction()
+
+function(set_target_linker TARGET LINKER_SCRIPT)
+ if(CMAKE_C_COMPILER_ID STREQUAL "IAR")
+ target_link_options(${TARGET} PRIVATE --config ${LINKER_SCRIPT})
+ target_link_options(${TARGET} PRIVATE --map=${TARGET}.map)
+ elseif(CMAKE_C_COMPILER_ID STREQUAL "GNU")
+ target_link_options(${TARGET} PRIVATE -T${LINKER_SCRIPT})
+ target_link_options(${TARGET} PRIVATE -Wl,-Map=${TARGET}.map)
+ set_target_properties(${TARGET} PROPERTIES SUFFIX ".elf") 
+
+ else()
+ message(FATAL_ERROR "Unknown CMAKE_C_COMPILER_ID ${CMAKE_C_COMPILER_ID}")
+ endif()
+endfunction()
+
+macro(print_all_variables)
+ message(STATUS "print_all_variables------------------------------------------{")
+ get_cmake_property(_variableNames VARIABLES)
+ foreach (_variableName ${_variableNames})
+ message(STATUS "${_variableName}=${${_variableName}}")
+ endforeach()
+ message(STATUS "print_all_variables------------------------------------------}")
+endmacro()

docs/architecture.md

@@ -0,0 +1,67 @@
+# Eclipse ThreadX BSP Framework Architecture
+
+This document describes the architecture, design philosophy, directory structure, and onboarding process for the reusable Board Support Package (BSP) framework.
+
+---
+
+## 1. Design Philosophy
+
+The BSP framework is designed to be **additive and non-invasive**, allowing new boards to be integrated without modifying existing board implementations.
+
+1. **Legacy Isolation**: The board directories that predate this framework (`/MXChip`, `/OpenHW`, `/STMicroelectronics`) remain completely untouched, preserving their drivers, submodules, and build systems.
+2. **Platform-Independent Applications**: Target applications use only the abstract BSP interfaces and have no compile-time dependency on vendor-specific HALs, SDKs, or hardware registers.
+3. **Reusable Infrastructure**: Shared CMake toolchains and build utilities are centralized under `/cmake` to eliminate duplicated build configuration across supported boards.
+
+---
+
+## 2. Directory Structure
+
+```text
+samplex/ (repository root)
+├── libs/ # Shared RTOS components (ThreadX, NetX Duo, FileX, USBX)
+├── scripts/ # Repository-wide helper scripts
+├── MXChip/ # [Pre-framework] Standalone board sample
+├── OpenHW/ # [Pre-framework] Standalone board sample
+├── STMicroelectronics/ # [Pre-framework] Standalone board samples
+├── targets/ # [Framework] Supported BSP target boards
+│ └── Microchip/
+│ └── POLARFIRE_ICICLE_RENODE/ # Board-specific BSP implementation & Renode target
+├── bsp/ # [Framework] Abstract BSP interface definitions
+│ └── include/bsp/ # board.h, led.h, console.h
+├── cmake/ # [Framework] Shared CMake configuration and utilities
+├── docs/ # [Framework] Architecture and onboarding documentation
+└── templates/ # [Framework] Templates for onboarding new boards
+```
+
+---
+
+## 3. BSP Interface Contract
+
+Every board added to the framework under `/targets` must implement the abstract APIs defined in `/bsp/include/bsp/`.
+
+### Core Board Control (`board.h`)
+
+* `void bsp_board_init(void)`: Initializes the board, including system clocks, GPIO, and required peripherals.
+
+### LED Control (`led.h`)
+
+* `void bsp_led_init(void)`: Configures the board's user LED.
+* `void bsp_led_on(void)`: Turns the LED on.
+* `void bsp_led_off(void)`: Turns the LED off.
+* `void bsp_led_toggle(void)`: Toggles the LED state.
+
+### Serial Console (`console.h`)
+
+* `void bsp_console_init(void)`: Initializes the default UART console.
+* `void bsp_console_write(const char *data, size_t length)`: Transmits a block of data over the console interface.
+
+---
+
+## 4. How to Onboard a New Board
+
+1. **Create the Target Folder**: Create a new directory under `targets/<Vendor>/<Board_Name>/` using `/templates/target/` as the starting point.
+2. **Define Local Configuration**: Create a `board_config.h` file containing board-specific settings such as clock configuration, UART parameters, and ThreadX memory allocation.
+3. **Implement the BSP APIs**: Implement the interfaces defined in `/bsp/include/bsp/` using the vendor SDK or direct register access.
+4. **Configure CMake**: Add the board target to `CMakeLists.txt`, build the BSP as a static library, and link it with the desired application from `/apps/`.
+
+Once a board implements the required BSP interfaces, any compatible application under `/apps` can be built for that board without modifying the application source.

targets/Microchip/POLARFIRE_ICICLE_RENODE/CMakeLists.txt

@@ -0,0 +1,41 @@
+#
+# Copyright (c) 2026 Eclipse ThreadX contributors
+#
+# This program and the accompanying materials are made available
+# under the terms of the MIT license which is available at
+# https://opensource.org/licenses/MIT.
+#
+# SPDX-License-Identifier: MIT
+#
+
+cmake_minimum_required(VERSION 3.20)
+
+set(CMAKE_SYSTEM_NAME Generic)
+set(CMAKE_SYSTEM_PROCESSOR riscv64)
+
+# Set 64-bit RISC-V Cross Compiler
+if(DEFINED ENV{RISCV64_TOOLCHAIN_PATH})
+ set(TOOLCHAIN_BIN_DIR "$ENV{RISCV64_TOOLCHAIN_PATH}/bin")
+ find_program(CMAKE_C_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+ find_program(CMAKE_CXX_COMPILER NAMES riscv-none-elf-g++ riscv64-none-elf-g++ riscv64-unknown-elf-g++ PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+ find_program(CMAKE_ASM_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc PATHS ${TOOLCHAIN_BIN_DIR} NO_DEFAULT_PATH REQUIRED)
+else()
+ find_program(CMAKE_C_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc REQUIRED)
+ find_program(CMAKE_CXX_COMPILER NAMES riscv-none-elf-g++ riscv64-none-elf-g++ riscv64-unknown-elf-g++ REQUIRED)
+ find_program(CMAKE_ASM_COMPILER NAMES riscv-none-elf-gcc riscv64-none-elf-gcc riscv64-unknown-elf-gcc REQUIRED)
+endif()
+
+project(polarfire_icicle_renode C ASM)
+
+# Root Directories
+set(SAMPLEX_ROOT_DIR "${CMAKE_CURRENT_LIST_DIR}/../../..")
+set(THREADX_DIR "${SAMPLEX_ROOT_DIR}/libs/threadx")
+
+# Architecture flags for SiFive U54 64-Bit RISC-V Core (RV64GC / lp64d)
+set(RISCV_FLAGS "-march=rv64gc -mabi=lp64d -mcmodel=medany")
+set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${RISCV_FLAGS} -O2 -g -Wall -Wextra")
+set(CMAKE_ASM_FLAGS "${CMAKE_ASM_FLAGS} ${RISCV_FLAGS}")
+set(CMAKE_EXE_LINKER_FLAGS "${RISCV_FLAGS} -T${CMAKE_CURRENT_LIST_DIR}/app/common/linker/linker.ld -nostartfiles -Wl,--gc-sections")
+
+add_subdirectory(lib)
+add_subdirectory(app)