2024.12

PolarFire SoC Bare metal Example Projects

• MMS MPFS HAL
  • The MPFS HAL has been enhanced with the following power-saving features in the mpfs-hal-power-saving-demo example project:
    • New Menu Options: Three new menu options are added, including a state-machine feature, a periodic low-power mode, and a current monitoring option.
    • DDR Power Efficiency: Enhancements are made to DDR power efficiency in self-refresh mode, with key updates such as adding DDR PLL control to the menu and improving memory pattern operations.
    • Non-Cached Read/Write Operations: Non-cached read/write operations have been updated to improve performance and power efficiency.
• MSS User Crypto
  • Updated AES GCM 256 message verification operation in mpfs-user-crypto-message-authentication-services example project.

2024.05

PolarFire SoC Bare metal Example Projects

• MMS MPFS HAL
  • mpfs-hal-power-saving-demo project showcasing the implementation of Power Saving Modes using Clock Scaling.
  • This update will demonstrate how an application can dynamically change the MSS CLK frequency to save power.
• MSS USB
  • Update FatFs version from R0.09b to R0.15 in mpfs-usb-host-msc example project.
• Ethernet MAC
  • Maintenance update.
• CoreQSPI
  • Added a sample project.

Driver	Revision
mss-mpfs-hal-example	2.4.103
mss-usb-example	2.2.107
mss-ethernet-mac-examples	1.8.120

2024.01

PolarFire SoC Bare metal Example Projects

• MPFS Discover kit board support added
  • MSS MMUART
  • MSS GPIO
  • MSS RTC
• MPFS HAL
  • A new project to demonstrate Low power features on PolarFire SoC
• C++ Example project
  • A new PolarFire SoC C++ example project
• CorePWM
  • Added a sample project
• Maintenance updates
  • MSS USB - Resolved issue seen while cloning the repo
  • Fixes to run example projects on Renode platform

Driver	Revision
mss-mpfs-hal-examples	2.4.102
mss-usb-examples	2.2.107
mpfs-pmp-demo	2.0.004
mss-user-crypto-examples	3.3.100
mpfs-cpp-helloworld	2.0.100
mss-mmuart-example	2.3.100
mss-rtc-example	2.2.102
mss-gpio-example	2.4.100

2023.10

PolarFire SoC Bare metal Example Projects  

• MSS USB
  • mpfs-usb-device-uvc example project fixes for following issues.
    • After connecting USB UVC device with Linux host machine (ubuntu 22.04), USB UVC device doesn't get probed.
    • Add missing function call to UVC GET_DEF to match the UVC class requirement.
    • When the disconnect and connect event happens, the Image gets corrupted and there is no output image available.
    • When resume event happens, USB doesn't get reset and there is no output image available
• MSS User Crypto (Works on PolarFire SoC Video Kit. Use main branch of polarfire-soc-video-kit-reference-design)
  • Example projects for
    • aes-cryptography
    • ccm-services
    • dsa-services
    • ecdsa-services
    • key-agreement
    • keytree-services
    • message-authentication
    • ndrbg-services
    • rsa-cryptography
    • rsa-services
• Renode emulation
  • Fixes to run the SoftConsole project on Renode Emulation platform for examples projects for MSS-GPIO, MSS-MMUART, MMS-RTC, MSS-PDMA, MSS-Timer, and mpfs-hal-examples
• Readme document improvements in MSS-MMUART, MSS-GPIO, MSS-SPI

Driver	Revision
mss-user-crypto-examples	3.2.101
mss-usb-examples	2.2.104
mss-spi-examples	2.2.100
mss-gpio-examples	2.3.100
mss-mmuart-examples	2.1.112
mss-rtc-examples	2.2.101
mss-pdma-examples	2.1.101
mss-timer-examples	2.1.103
mpfs-hal-examples	2.2.108

2023.06

PolarFire SoC Bare metal Example Projects

• DMA memory access benchmark
  • P-DMA Performance
  • CoreAXI4DMAController (F-DMA) performance
  • P-DMA, F-DMA concurrent access Benchmarking
  • Impact of L2 Cache configuration in DMA performance
• MSS USB
  • First release
  • Example projects for USB class MSC, HID and UVC (device only)
• MSS SPI
  • Initialization issue fix
  • Maintenance update
• MSS MMUART
  • Maintenance
• MMS MPFS HAL
  • Add reference information on the MPFS Video Kit to the related project README.md
  • Running CoreMark on Renode for all build configs
  • Added sample src/boards folder DDR4. Tested on FTD Timeprovider4100 board
    • mpfs-tp4100-666Hz
    • mpfs-tp4100-800Hz
• MSS Watchdog
  • Maintenance
• MSS GPIO
  • Maintenance
• MSS RTC
  • Maintenance

Driver	Revision
MSS USB	2.2.102
MSS SPI	2.1.102
MSS MMUART	2.0.105
MPFS HAL	2.2.106
MSS Watchdog	2.1.101
MSS GPIO	2.0.101
MSS RTC	2.2.100

2022.12

PolarFire SoC Bare metal Example Projects

• PDMA benchmark
  • PDMA performance benchmark for data transfers to and from different memories in the system. Refer mpfs-dma-benchmarking.md.
• MSS QSPI
  • Winbond example
    • Fix incorrect write size in Winbond driver
  • Micron example
    • Fix buffer and length issue in Micron driver
• MSS eMMC
  • Added new example project with FatFS support
• MSS RTC
  • Maintenance update
• MSS Timer
  • Maintenance update
• MSS Watchdog
  • Maintenance update
• MSS SPI
  • Maintenance update
• MSS System services
  • Improved handling of user input
• MSS MMUART
  • Maintenance update

Driver	Revision
mss-mmc-examples	2.0.103
mss-mpfs-hal-examples	2.0.101
mss-qspi-examples	2.0.106
mss-rtc-examples	2.1.102
mss-spi-examples	2.1.101
mss-sys-services-examples	2.1.100
mss-timer-examples	2.1.101
mss-watchdog-examples	2.1.101

2022.08

PolarFire SoC Bare metal Example projects v2022.08

Changes since last release

• MPFS HAL 

  • Added application running from multiple U54s. Can be directly used as a payload for HSS. Refer to the MPFS HAL Example Projects. 
  • Enhance DDR-Demo project. Refer to the mpfs-hal-ddr-demo.

• MSS QSPI

  • Winbond example

    • Added flash_info structure, which will be used to get the flash parameter values.

    • Added list of menu options over the UART terminal to perform specific flash operation.

    • Add support for bad_block checking 

  • Micron flash driver updates

    • Added list of menu options over the UART terminal to perform specific flash operation.

    • Added update_io_format() API to switch to normal mode when using the readid, status and other probing commands.

• MSS GPIO

  • Added mss_configuration folder under boards/ directory. This will be used with Integrated MSS configurator in SoftConsole v2022.2 (Soon to be released). Refer to the Readme.

• Updated following driver example projects to use MPFS-HAL to version 2.0.102

  • RTC, MMUART, eMMC, MPFS HAL, System Services, QSPI, GPIO, SPI

Examples	Version
mss-gpio	2.0.101
mss-mmc	2.0.107
mss-mmuart	2.0.105
mss-mpfs-hal	2.0.101
mss-ethernet-mac	1.8.119
mss-qspi	2.0.105
mss-rtc	2.0.100
mss-spi	2.0.100
mss-sys-serivces	2.0.106

2021.11

PolarFire SoC Bare metal Example projects 2021.11

Driver examples

• MSS GPIO

  • Uses latest MSS GPIO driver 1.8.105
  • Uses MPFS HAL 1.8.134 (includes SAR121797 fix)

• MSS System service

  • Uses latest MSS SYS Services driver 1.8.111
  • Uses MPFS HAL 1.8.134 (includes SAR121797 fix)

• MSS PDMA 2.0.103

  • Uses MSS PDMA driver v2.0.101
  • Uses MPFS HAL 1.8.134 (includes SAR121797 fix)

• MSS QSPI 2.0.103

  • Uses improved Winbond flash driver
  • Uses MPFS HAL 1.8.134 (includes SAR121797 fix)

• MPFS HAL 1.8.136

  • Added linker scripts for Coremark running from different DDR locations
  • Updated the Coremark readme with details on loading binaries.
  • Uses MPFS HAL 1.8.134 (includes SAR121797 fix)

Examples	Revision
mss-gpio examples	1.9.100
mss-sys-services examples	1.8.111
mss-pdma examples	2.0.103
mss-qspi examples	2.0.103
mss-mpfs-hal examples	1.8.136

2021.08

PolarFire SoC Bare Metal Examples v2021.08 Release note

Applications

• Physical Memory protection (PMP) demo v2.0.

Driver examples

• MPFS HAL
  • Update examples with mpfs-hal-src-1.8.131
  • Folder structure compliance and general code cleanup
• MSS QSPI
  • Example project supporting Microchip SST26VF064B connected on Flash5 click board
  • Example project supporting Micron MT25Q Flash
• MSS System services
  • Project updated with latest mss_sys_services driver 1.8.106
• MSS Timer
  • Example project demonstrating different timer modes
• MSS MMC
  • Enhanced example projects demonstrating eMMC and SD features
• MSS ethernet MAC
  • Enhanced example projects
• MSS RTC, PDMA
  • SAR 120887 -- Fix the error introduced with previous release

Examples	Revision
mss-ethernet-mac examples	1.8.111
mss-mmc examples	1.9.100
mss-mpfs-hal examples	1.8.133
mss-pdma examples	1.8.105
mss-qspi examples	1.8.105
mss-rtc examples	1.8.106
mss-sys-services examples	1.8.108
mss-timer examples	1.9.100

2021.05

• Example projects are moved to a separate repository polarfire-soc-bare-metal-examples

• The polarfire-soc-bare-metal-library is now deprecated. It will still exists for some time.

• Example projects use enhanced project folder structure. Updated to polarfire-soc-configuration-generator sricpt v0.6.3.

• mss-i2c - Added new example projects

• Interface with RTC 6 click board demonstrating the use of mikroBUS® extension boards

• MSS I2C0 and MSS I2C1 master-slave

• mss-spi - Added new example project

• MSS SPI0 and MSS SPI1 master-slave

• mss-can - Added new example project

• MSS CAN0 and MSS CAN1 loopback

• All examples updated to use mss-mpfs-hal-src 1.8.125

• All examples updated to use platform-config-reference-src 1.8.15

• Added multiple build configurations with all the example project. Refer polarfire-soc-bare-metal-examples

• Application code moved to U54 instead of E51.

Examples	Revision
mss-gpio examples	1.8.103
mss-i2c examples	1.8.102
mss-mmuart examples	1.8.102
mss-mpfs-hal examples	1.8.109
mss-pdma examples	1.8.104
mss-rtc examples	1.8.105
mss-spi examples	1.8.101
mss-sys-services examples	1.8.103
mss-watchdog examples	1.8.102
mss-can examples	1.8.105