This example project demonstrates the use of the PolarFire SoC MSS GPIO block. Both the input and output port configurations are demonstrated along with the interrupt handling for the input ports.
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 connected. To use this project configure the COM port interface1 as below:
- 115200 baud
- 8 data bits
- 1 stop bit
- no parity
- no flow control
The example project will display instructions over the serial port. A greeting message and menu instructions are displayed over the UART terminal. Follow the instruction to use different menu options provided by the example project.
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-gpio-interrupt 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-gpio-interrupt 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\[BUILD-CONFIGURATION]\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.