PlatformIO has pre-built settings for many popular embedded boards. The list of these boards is available as a web page at PlatformIO Boards Explorer or through the CLI command pio boards.
Custom boards can also be defined from scratch or by overriding settings of existing boards. All data is declared using the JSON syntax via associative array name/value pairs.
The key fields are:
build data is handed over to the Development Platforms and Frameworks builders
frameworks is the list with supported Frameworks. Each working environment for each project that uses the board will choose one of the frameworks declared here.
platform name of Development Platforms
upload upload settings which depend on the platform
For details, see existing boards as examples, available under .platformio/platforms/*/boards/.
{
"build": {
"extra_flags": "-DHELLO_PLATFORMIO",
"f_cpu": "16000000L",
"hwids": [
[
"0x1234",
"0x0013"
],
[
"0x4567",
"0x0013"
]
],
"mcu": "%MCU_TYPE_HERE%"
},
"frameworks": ["%LIST_WITH_SUPPORTED_FRAMEWORKS%"],
"platforms": ["%LIST_WITH_COMPATIBLE_PLATFORMS%"],
"name": "My Test Board",
"upload": {
"maximum_ram_size": 2048,
"maximum_size": 32256
},
"url": "http://example.com",
"vendor": "MyCompany"
}
Create boards directory in core_dir if it
doesn’t exist.
Create myboard.json file in this boards directory.
Search available boards via pio boards command. You should see
myboard board.
Now, you can use myboard for the board option in
“platformio.ini” (Project Configuration File).
Note
You can have custom boards per project. In this case, please put your board’s JSON files to boards_dir.
Please take a look at the source code of
PlatformIO Development Platforms
and navigate to boards folder of the repository.