How polarfire-soc/polarfire-soc-bare-metal-examples works
This repository is a collection of PolarFire SoC bare-metal applications and peripheral-driver examples, rather than one application with a single runtime flow. The documented user workflow is to choose an example for a supported board, configure its memory/debug or release variant, and run it on hardware. The graph highlights the blank bare-metal platform’s HAL layers and representative driver families alongside the documented example collections. Source excerpts do not show application-to-driver calls, so those relationships are intentionally omitted.
Main entry points: mss_hal.h MPFS HAL · e51.c Blank application · applications Applications · driver-examples Driver examples
Components 20
Example collections
- Applications
applications - Driver examples
driver-examples
Bare-metal application
- Blank application
applications/mpfs-blank-baremetal/src/application/hart0/e51.c - Board configs
applications/mpfs-blank-baremetal/src/boards
Hardware abstraction
- HAL API
applications/mpfs-blank-baremetal/src/platform/hal/hal.h - MPFS HAL
applications/mpfs-blank-baremetal/src/platform/mpfs_hal/mss_hal.h - CPU encoding
applications/mpfs-blank-baremetal/src/platform/mpfs_hal/common/encoding.h - System registers
applications/mpfs-blank-baremetal/src/platform/mpfs_hal/common/mss_sysreg.h - DDR support
applications/mpfs-blank-baremetal/src/platform/mpfs_hal/common/nwc/mss_ddr.h - IRQ stubs
applications/mpfs-blank-baremetal/src/platform/mpfs_hal/common/mss_irq_handler_stubs.c
MSS drivers
- MSS UART
applications/mpfs-blank-baremetal/src/platform/drivers/mss/mss_mmuart/mss_uart.c - MSS Ethernet
applications/mpfs-blank-baremetal/src/platform/drivers/mss/mss_ethernet_mac/mss_ethernet_mac.c - MSS USB
applications/mpfs-blank-baremetal/src/platform/drivers/mss/mss_usb/mss_usb_device.c - System services
applications/mpfs-blank-baremetal/src/platform/drivers/mss/mss_sys_services/mss_sys_services.h
FPGA IP drivers
- FPGA UART
applications/mpfs-blank-baremetal/src/platform/drivers/fpga_ip/CoreUARTapb/core_uart_apb.c - FPGA I2C
applications/mpfs-blank-baremetal/src/platform/drivers/fpga_ip/CoreI2C/core_i2c.c - FPGA Ethernet
applications/mpfs-blank-baremetal/src/platform/drivers/fpga_ip/CoreTSE/core_tse.c - FPGA services
applications/mpfs-blank-baremetal/src/platform/drivers/fpga_ip/CoreSysServices_PF/core_sysservices_pf.h
Other components
- Developer
- PolarFire board
Connections 12
- Developer → Applications: chooses example
README.md - Developer → Driver examples: chooses example
README.md - Applications → Blank application: includes
README.md - Driver examples → MSS UART: demonstrates drivers
README.md - Developer → Board configs: configures target
README.md - Board configs → PolarFire board: targets
- Blank application → PolarFire board: runs on
- MPFS HAL → CPU encoding: includes
applications/mpfs-blank-baremetal/src/platform/mpfs_hal/mss_hal.h - MPFS HAL → System registers: includes
applications/mpfs-blank-baremetal/src/platform/mpfs_hal/mss_hal.h - MPFS HAL → DDR support: includes
applications/mpfs-blank-baremetal/src/platform/mpfs_hal/mss_hal.h - MPFS HAL → IRQ stubs: uses
applications/mpfs-blank-baremetal/src/platform/mpfs_hal/common/mss_irq_handler_stubs.c - Developer → Blank application: runs example