sathya
Version:
An xPack with a blinky application running on HiFive1
54 lines (32 loc) • 2.38 kB
Markdown
# HiFive1 'blinky' project
This project was generated by the GNU MCU Eclipse SiFive 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
- `sifive-devices` SiFive Core Complex IP devices files
- `sifive-hifive1-board` SiFive Freedom E310 HiFive1 files
## Debug
An OpenOCD debug launch file is automatically generated.
The HiFive1 board has an on board JTAG programmer. The OpenOCD configuration
is available as a single file `-f "board/sifive-hifive1.cfg"`.
The referred files are available in the GNU MCU Eclipse OpenOCD distribution.
If you use other distributions, you can get the files from [GitHub](https://github.com/gnu-mcu-eclipse/openocd/tree/gnu-mcu-eclipse-dev/tcl/board); download the `sifive-*.cfg` files and
copy them in the `scripts/board` OpenOCD folder.
## Semihosting
Starting with GNU MCU Eclipse plug-ins 4.3.2, the SiFive 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
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.