Creating a custom platform to pack a modified version of GCC for RISC-V

maxgerhardt · May 22, 2025, 8:12am

What exactly doesn’t work? A example firmware fails to be compiled? It can be compiled but fails to run? The platform can’t be installed?

Please read through:

Arduino Due (or other SAM3/4) upload fails with ATMEL ICE JTAG on VSCode with PlatformIO - #8 by maxgerhardt
Custom Platform & Board — PlatformIO latest documentation
platform-gd32/platform.json at main · CommunityGD32Cores/platform-gd32 · GitHub

The toolchain and framework packages usually do not reside within the platform. They are however referenced by the platform’s platform.json with the version expression detailing how to obtain that package; for examle

github.com/Leonardofili00/platform-MacCoreV

platform.json

428dc09e3


      
          "framework-maccorev": {
            "type": "framework",
            "optional" : false
          }

Doesn’t have a version expression (?)

github.com/platformio/platform-ststm32

platform.json

b8c4ff4af


      
          "framework-arduinoststm32": {
            "type": "framework",
            "optional": true,
            "owner": "platformio",
            "version": "~4.21001.0"
          },

Tells it to get it from the PIO Registry (https://registry.platformio.org/, pio pkg publish — PlatformIO latest documentation) matching SemVer 4.21001.xxx

github.com/CommunityGD32Cores/platform-gd32

platform.json

060c0b7e6


      
          "toolchain-riscv-nuclei": {
            "type": "toolchain",
            "optional": true,
            "version": "https://github.com/CommunityGD32Cores/toolchain-riscv-nuclei.git#windows_x64"
          },

Tells it to get it from a certain repository and branch.

Anything from pio pkg install — PlatformIO latest documentation is accepted version.

When the platform is installed, it installs its declared needed (non-optional) packages automatically.

Platforms or packages can be installed also from the commandline: pio pkg install — PlatformIO latest documentation