GOWIN PicoRV32 Software Taelo Manual

This manual provides information on the Gowin PicoRV32 Quick Design. It includes details about the software programming reference design and other relevant content.

Software Programming Reference Design

The software programming reference design contains guidelines and instructions for programming the Gowin PicoRV32 Quick Design.
It covers aspects such as MCU support, GPIO configurations, AHB bus interface usage, SPI-Flash operations, hardware stack protection, online debugging, interrupt handling, and software optimization.

Boithorollo

GOWINSEMI assumes no liability and provides no warranty (either expressed or implied) and is not responsible for any damage incurred to your hardware, software, data, or property resulting from usage of the materials or intellectual property except as outlined in the GOWINSEMI Terms and Conditions of Sale. GOWINSEMI may make changes to this document at any time without prior notice.
Anyone relying on this documentation should contact GOWINSEMI for the current documentation and errata.

Nalane ea Phetoho

Letsatsi	Phetolelo	Tlhaloso
01/16/2020	1.0E	Phetolelo ea pele e hatisitsoe.
03/13/2020	1.1E	MCU supports the GPIO of the Wishbone bus interface. MCU supports the extension AHB bus interface. MCU supports off-chip SPI-Flash download and startup. MCU supports the read, write, and erase SPI-Flash. MCU supports Hardware Stack Protection and Trap Stack Overflow.
06/01/2020	1.2E	The MCU online debug function is supported. The MCU core interrupt handler function has been enhanced. The MCU core instruction is optimized.
07/16/2021	1.3E	The synthesis tool, SynplifyPro, was deleted. The version of the FPGA software has been updated.
02/14/2022	1.4E	The register address mapping of the peripheral Simple UART has been updated. The register definitions of the peripheral I2C Master and GPIO have been updated. The driver function definition of the peripheral SPI-Flash has been updated. The interrupt handler has been enhanced. MCU software reference design updated. IDE software options configuration optimized. The online IDE software debug process has improved. The range of ITCM and DTCM sizes for GW2AN-9X/GW2AN-18X has been modified. The reference design of makehex and mergebin has been added.
08/18/2023	1.5E	Lihlahisoa tsa Arora V FPGA li tšehelitsoe.
03/29/2024	1.6E	GW5AT-60 Version A FPGA products supported. The mergebin tool has been updated to support GW2AN-18X/9X FPGA products. Reference designs for software programming and hardware have been updated.
06/14/2024	1.7E	Reference designs for software programming and hardware have been updated.
09/26/2025	1.8E	The version descriptions of Gowin Software and GMD software have been updated.

Mabapi le Bukana ena

Morero

This manual describes the quick design of Gowin_PicoRV32 hardware design and software programming using the DK_START_GW5A-LV25UG324 V2.0 development board reference design in the software development kit, aiming at helping users to quickly develop Gowin_PicoRV32 hardware design and software programming.

Develop Environment Hardware Target

DK_START_GW5A-LV25UG324 V2.0
GW5A-LV25UG324C2/I1
GW5A-25 (Version A)

Software Software

Tested software version: Gowin_V1.9.11.02 (64-bit)
GMD (GOWIN MCU Designer 2025.01, tested)

Reference Design Software Reference Design

Gowin_PicoRV32 provides a software programming reference design for GMD software (2025.01, tested), and you can get the following reference design through the sehokelo: …\ref_design\MCU_RefDesign\picorv32_demo

Hardware Reference Design

Gowin_PicoRV32 provides a hardware reference design, and you can get the following reference design through the sehokelo: …\ref_design\FPGA_RefDesign\DK_START_GW5A25_V2.0\gowin_pi corv32

Software Programming Reference Design

Software Reference Design

Double click to open the MCU software, and select “File > Import… > General > Existing Projects into Workspace” in the menu bar to import the software programming reference design picorv32_demo, as shown in Figure 2-1 and Figure 2-2.

Sebopeho sa Software

Select “ITCM > Boot Mode > MCU boot from external Flash and run in ITCM” in the Gowin_picorv32 hardware reference design.

Tlhophiso ea Mokhoa oa Boot

The software programming reference design picorv32_demo defines the macro definition for configh as BUILD_BURN (#define BUILD_MODE BUILD_BURN), as shown in Figure 2-3.

Flash Linker Script File Tlhophiso

Select the current project, and right-click “Properties > C/C++ Build > Settings > Tool Settings > GNU RISC-V Cross C Linker > General”, and select “sections.lds” as the Flash linker script file, joalokaha ho bontšitsoe ho Setšoantšo sa 2-4.

Build Projects

Click the Build” button on the toolbar to build the software programming reference design and generate the executable file, joalokaha ho bontšitsoe ho Setšoantšo sa 2-5.

Download Projects

Click “Run > Programmer” on the menu bar or “Programmer” on the toolbar to open the download tool “Programmer”.
Click “Edit > Configure Device” on the Programmer menu bar or “Configure Device” on the toolbar to open “Device configuration”, as shown in Figure 2-6.
Select the “External Flash Mode 5A” option from the “Access Mode” drop-down list.
Select “exFlash C Bin Erase, Program 5A” or “exFlash C Bin Erase, Program, Verify 5A” option from the “Operation” drop-down list.
Click “FW/MCU/Binary Input Options > Firmware/Binary File” option to import the software executable file ho jarollwa.
Khetha "Generic Flash" ho tloha "External Flash Options > Sesebediswa" kgetho.
Configure the start address as “0x100000” using the “External Flash Options > Start Address” option.
Tobetsa "Save" ho phethela tlhophiso.
After device configuration, click “Program/Configure” () on the Programmer toolbar to complete the downloading of the executable file.

Bukana ea Litšupiso

For the Gowin_PicoRV32 software programming design method, please refer to the following manuals.
IPUG911, Gowin_PicoRV32 Software Programming Reference Manual
IPUG910, Gowin_PicoRV32 IDE Software Reference Manual
IPUG913, Gowin_PicoRV32 Software Download Reference Manual
SUG502, Gowin Programmer User Guide

Hardware Reference Design

Tikoloho ea Hardware

Double click to open Gowin Software, select “File > Open…” in the menu bar to import Gowin_picorv32 hardware reference design.
Gowin_PicoRV32 can be reconfigured to generate Gowin_PicoRV32 based on application requirements.
The description of the hardware reference design is shown in Table 3-1.

Table 3-1 Hardware Reference Design Examples

File	Tlhaloso
gowin_picorv32.v	Gowin_PicoRV32 IP design generated by IP Core Generator
picorv32_demo.v	Gowin_PicoRV32 Top Module instantiation and user design
wbreg.v	Example of Open Wishbone bus extension external device
ahbreg.v	Example of the Open AHB bus extension external device
button.v	Example of external interrupt
cnt.v	Counter delay
key_debounce.v	Reset key debounce
picorv32.cst	Tšitiso ea 'mele
picorv32.sdc	Khatello ea Nako

Kopanya

Run the synthesis tool GowinSynthesis to synthesize a hardware reference design and generate the netlist file, joalokaha ho bontšitsoe ho Setšoantšo sa 3-1.

Sebaka & Tsela

Run the Place & Route tool to generate the bitstream files of the hardware design, as shown in Figure 3-2.

Khoasolla

Run Programmer, the download tool of Gowin Software, to download the hardware design bitstream file.
Click “Edit > Configure Device” on the menu bar or “Configure Device” () on the toolbar to open the “Device configuration”, as shown in Figure 3-3.
Select “External Flash Mode 5A” from the “Access Mode” drop-down list.
Select “exFlash Erase, Program 5AT” or “exFlash Erase, Program, Verify 5AT” from the “Operation” drop-down list.
Kenya sebopeho sa hardware bitstream file to be downloaded using the “Programming Options > File lebitso" kgetho.
Khetha "Generic Flash" ho tloha "External Flash Options > Sesebediswa" kgetho.
Configure the start address as “0x000000” using the “External Flash Options > Start Address” option.
Tobetsa "Save" ho phethela tlhophiso.
After device configuration, click “Program/Configure” () on the Programmer toolbar to complete the download of the bitstream files for hardware design.

Bukana ea Litšupiso

For Gowin_PicoRV32 hardware design, please refer to the following manuals.
IPUG914, Gowin_PicoRV32 Hardware Design Reference Manual
SUG100, Gowin Software User Guide
SUG935 Gowin Design Physical Constraints User Guide,
SUG1018 Arora Ⅴ Design Physical Constraints User Guide
SUG502, Gowin Programmer User Guide

Copyright

and GOWIN are trademarks of Guangdong Gowin Semiconductor Corporation and are registered in China, the U.S. Patent and Trademark Office, and other countries.
All other words and logos identified as trademarks or service marks are the property of their respective holders.
No part of this document may be reproduced or transmitted in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written consent of GOWINSEMI.

Lipotso Tse Botsoang Hangata

A na nka hlahisa kapa ho fetisa karolo efe kapa efe ea tokomane?

No, you cannot reproduce or transmit any part of the document without prior written consent from GOWINSEMI.

Is GOWINSEMI liable for any damage incurred during product usage?

GOWINSEMI assumes no liability and provides no warranty for any damage incurred to hardware, software, data, or property resulting from product usage.

Litokomane / Lisebelisoa

GOWIN PicoRV32 Software [pdf] Buka ea Taelo
GW2AN-9X, GW2AN-18X, PicoRV32 Software, PicoRV32, Software

Litšupiso

Bukana ea Mosebelisi

GOWIN PicoRV32 Software

Litlhaloso

Litaelo tsa Tšebeliso ea Sehlahisoa