This example project demonstrates the use of the PolarFire SoC MSS RTC driver to configure the MSS RTC block as real time clock in calendar mode. The messages are displayed over the UART terminal after every second.
On connecting Icicle kit J11 to the host PC, you should see 4 COM port interfaces. On connecting Discovery kit J4 to the host PC, you should see 3 COM port interfaces. To use this project, configure the COM port interface1 as below:
- 115200 baud
- 8 data bits
- 1 stop bit
- no parity
- no flow control
This is a self contained example project. A greeting message is displayed over the UART terminal. The example project takes care of configuring and initiating the MSS RTC block. User can observe the UART messages displayed over the terminal which indicates every second passed.
This project provides build configurations and debug launchers as explained here.
This example can be run on the Renode emulation platform. Build the application as normal, and then launch it using mpfs-rtc-time renode all-harts start-platform-and-debug.launch
UART console display and logging options can be found under the Startup tab in Debug Configurations > mpfs-rtc-time renode all-harts debug. More information about using Renode is available on https://renode.readthedocs.io
If the firmware has DDR training enabled, then the application will take significantly longer to start up in Renode. Training has no practical impact in this environment as the emulated DDR memory is already reliable.
Training can be controlled by removing #define DDR_SUPPORT in your mss_sw_config.h file. This change should be made in src\boards\[BOARD]\platform_config\mpfs_hal_config\
If your project uses the default configuration file in src\platform\platform_config_reference\ to enable DDR training, it is recommended to create a copy under the boards directory and disable DDR_SUPPORT there.