# {{ boardDescription }} '{{ content }}' project
TODO
This project was generated by the GNU MCU Eclipse 	 template.

## Application specific files

The application specific files are in the `src`, `include` and `ldscripts` folders. Edit them to implement the desired application functionality.

## Framework common packages

The _system_ files, common to many applications, are grouped in the `xpacks` folder. **xPacks** are separate small projects used as building blocks of modular applications.

Most of the xPacks are part of the [µOS++](http://micro-os-plus.github.io) project.

### Portable files

- `micro-os-plus-diag` - diagnostic trace functions
- `micro-os-plus-c-libs` - functions to complement the C library
- `micro-os-plus-cpp-libs` -  functions to complement the C++ library
- `micro-os-plus-startup` - portable startup
- `micro-os-plus-semihosting` - portable semihosting

### Architecture/device/board files

- `micro-os-plus-riscv-arch` RISC-V architecture files
- `shakti-devices` Shakti Core Complex IP devices files
{% if boardName == 'artix7' -%}
- `arty-boards` Shakti Core Complex IP Arty FPGA files
{% endif -%}

## Debug
TODO

## Semihosting

Starting with GNU MCU Eclipse plug-ins 4.3.2, the Shakti Template project supports semihosting, both for trace output and for fully semihosted projects.

To run them, GNU MCU Eclipse OpenOCD 0.10.0-7 or later is required. Attempts to use older versions of OpenOCD will simply break into the debugger.

## Eclipse preferences

If you do not like the large number of source folders shown by Eclipse in the Project Explorer, you can go to Eclipse menu -> Preferences... -> C/C++ -> Appearance and disable **Show source roots at top of project**.

## License
TODO

Unless otherwise mentioned, all **µOS++** components are provided **free of charge** 
under the terms of the [MIT License](https://opensource.org/licenses/MIT) with all rights reserved to Liviu Ionescu.