| 1 | \author: Cesar Fuguet |
|---|
| 2 | \date : July 24, 2014 |
|---|
| 3 | |
|---|
| 4 | TSAR BOOT-LOADER |
|---|
| 5 | |
|---|
| 6 | Files: |
|---|
| 7 | src/ Source files |
|---|
| 8 | The entry point of this boot loader is the file reset.S |
|---|
| 9 | |
|---|
| 10 | include/ Header files |
|---|
| 11 | |
|---|
| 12 | driver/ Drivers source files and headers |
|---|
| 13 | |
|---|
| 14 | conf/ Platform specific files |
|---|
| 15 | For each platform, we must define a new directory. |
|---|
| 16 | Mandatory files: |
|---|
| 17 | |
|---|
| 18 | - hard_config.h (can be generated using giet-vm genmap tool) |
|---|
| 19 | |
|---|
| 20 | This file contains all physical segments addresses and sizes of the |
|---|
| 21 | hardware platform. It also contains other configuration definitions |
|---|
| 22 | as the disk controller type, mesh size, etc. Examples can be found |
|---|
| 23 | in the conf/ directory. |
|---|
| 24 | |
|---|
| 25 | Optional files: |
|---|
| 26 | |
|---|
| 27 | - platform.dts (platform device tree) |
|---|
| 28 | |
|---|
| 29 | Makefile Makefile to compile the boot loader. |
|---|
| 30 | Mandatory arguments: |
|---|
| 31 | |
|---|
| 32 | - HARD_CONFIG_PATH=<platform_dir> |
|---|
| 33 | |
|---|
| 34 | Defines the directory where to find the hard_config.h file |
|---|
| 35 | |
|---|
| 36 | Optional arguments: |
|---|
| 37 | |
|---|
| 38 | - USE_DT=<value> |
|---|
| 39 | |
|---|
| 40 | Value can be 1 or 0. |
|---|
| 41 | If a device tree file is not used, set this flag to 0. It is |
|---|
| 42 | set by default to 1. |
|---|
| 43 | |
|---|
| 44 | - SYSTEM_CLK=<platform clock frequency> |
|---|
| 45 | |
|---|
| 46 | Platform clock frequency in KHz |
|---|
| 47 | |
|---|
| 48 | - DTS=<file.dts> |
|---|
| 49 | |
|---|
| 50 | Platform device tree (by default is platform.dts) |
|---|
| 51 | |
|---|
| 52 | Important characteristics of this preloader: |
|---|
| 53 | |
|---|
| 54 | - Processor 0 performs loading of Operating System Boot Loader which must |
|---|
| 55 | be an ELF file located at the third block of the disk. |
|---|
| 56 | |
|---|
| 57 | - Other processors wait to be waken up through an interruption generated |
|---|
| 58 | from a XICU mailbox. Each processor other than 0 has its own mailbox |
|---|
| 59 | in the local XICU. |
|---|
| 60 | |
|---|
| 61 | - Stack allocation is only made for processor 0. The loaded Operating System |
|---|
| 62 | boot loader or kernel must perform stack allocation for other processors. |
|---|
| 63 | |
|---|
| 64 | - Stack for processor 0 is allocated at the end of RAM segment in the |
|---|
| 65 | cluster (0,0). |
|---|
| 66 | |
|---|
| 67 | Examples: |
|---|
| 68 | |
|---|
| 69 | make HARD_CONFIG_PATH=<platform_dir> USE_DT=0 |
|---|
| 70 | |
|---|
| 71 | Compile for <platform_dir> and do not compile device tree file |
|---|
| 72 | |
|---|
| 73 | make HARD_CONFIG_PATH=<platform_dir> DTS=platform_fpga.dts SYSTEM_CLK=25000 |
|---|
| 74 | |
|---|
| 75 | Compile for <platform_dir> and compile the 'platform_dpga.dts' |
|---|
| 76 | device tree file. System clock frequency is 25 MHz |
|---|
| 77 | |
|---|
| 78 | make HARD_CONFIG_PATH=<platform_conf> SYSTEM_CLK=25000 |
|---|
| 79 | |
|---|
| 80 | Compile for <platform_dir> and compile the 'platform.dts' |
|---|
| 81 | device tree file (default name). System clock frequency is 25 MHz |
|---|
| 82 | |
|---|
