Metafiles Naming Conventions
This section describes the naming conventions for metafiles used in the Arduino Core for PSOC™ 6. When adding new variables to these metafiles, follow these conventions to maintain consistency and clarity.
Note
Most variables are already defined and likely will not require modification soon. They are documented here to clarify their usage and the rationale behind their values.
The conventions apply to the following files:
boards.txt
platform.txt
package/package_psoc6_index.template.json
boards.txt
Parameter |
Value |
Description |
Example |
---|---|---|---|
|
OPN (Original Part number)
of the board converted to snake_case
|
This defines the
board_unique_id fieldused in arduino-cli.
|
|
|
OPN (Original Part number) of
the board
|
Human readable friendly Board Name
shown in Arduino IDE menus.
|
|
platform.txt
Parameter |
Value |
Description |
---|---|---|
|
|
The name will be shown as the Arduino IDE’s Board
menu section title or the Name field of arduino-cli core
list’s output for the platform.
|
|
Empty.
Automatically set during
release core packaging.
|
The version is currently unused, it is reserved for
future use (probably together with the Boards Manager
to handle dependencies on cores).
|
package_psoc6_index.json
Parameter |
Value |
Description |
---|---|---|
JSON file name |
|
Specification requirement:
package_<YOURNAME_PACKAGENAME>_index.json
|
|
|
This defines the vendor directory name of
the installed package in the Arduino installation
path.
It also defines the vendor field of the
|
|
|
The extended name of the vendor that is displayed
on the Arduino IDE Boards Manager GUI
|
|
The URL to the vendor’s website, appears
on the Arduino IDE Boards Manager as “More info” link.
|
|
|
|
Contact email of the maintainer |
|
|
The extended name of the platform that
is displayed on the Boards Manager GUI.
|
|
|
It defines the architecture field of the
|
|
|
This field is reserved. Third-party
cores must set it to “Contributed.”
|
|
Empty |
Used only in legacy Arduino IDE 1.x.
Not used in Arduino IDE 2.x.
|
|
OPN (Original Part number)
of the board
|
The list of supported boards shown in
the Arduino IDE’s Boards Manager GUI
core entry.
|
|
|
No specification. Use the same name
as the vendor.
|
|
kebab-case naming |
No additional requirements other
than the package index specification.
|