Table of Contents
general settings
these are settings on the top layer that effect the whole project.
vendor_name
Name of the company that sells the micro controller. As listed on https://chipselect.org
type: string
chip_name
Model number of the micro controller. As listed on https://chipselect.org
type: string
Model number is truncated so that it only contains relevant differences for code generation: flash and ram sizes are relevant, temperature range or package are not.
project_type
what type of project to generate.
type: enum
default: “make”
Possible values are:
- “hal only” : only creates the hardware driver files (in the hal/ folder) and hardware definitions (in the hal/hw/ folder)
- “embeetle” : create an Embeetle IDE project
- “make” : creates a makefile based “blinky” project.
file_comment
defines the comment at the top of each generated file.
type: enum
default: “created”
Possible values are:
- “created” : file comment list date and time of file creation as well as configuration file name.
- “minimal” : short comment only stating the file name and that it was automatically created.
run_from
defines the location of the firmware code when run.
type: enum
default: “flash”
Possible values are:
- “flash” : firmware is located and run from the flash memory.
- “ram” : firmware is located and run from the RAM.
- “flash2ram” : firmware is located in flash, copied to RAM on boot and then executed from RAM.
path_prefix
if you use a “hal only” MBSP project located in a sub folder of your project then the name of the sub folder goes here.
type: string
default: “”
error_handling
if something unexpected (like a hard fault) happens this defines what should happen:
type: enum
default: “halt”
Possible values are:
- “halt” : firmware stops executing.
- “reset” : firmware resets.