source: trunk/softs/tsar_boot/README @ 758

Last change on this file since 758 was 758, checked in by cfuguet, 10 years ago

tsar_boot: improving configuration infrastructure

  • Using hard_config.h which respects the same sintax that the hard_config.h file of all TSAR platforms. This file can be then generated by the GIET-VM genmap tool or written manually.
  • All peripheral drivers have been moved to a drivers directory and they are compiled as a static library. This allows GCC to only include in the final .ELF the object files of used peripherals and not all of them.
  • Example hard_config.h and ldscripts have been introduced in the conf directory.
  • Improving comments in all files
File size: 1.7 KB
Line 
1\author: Cesar Fuguet
2\date  : July 24, 2014
3
4TSAR BOOT-LOADER
5
6Files:
7src/        Source files
8            The entry point of this boot loader is the file reset.S
9
10include/    Header files
11
12driver/     Drivers source files and headers
13
14conf/       Platform specific files and ldscript
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              - ldscript
21
22            Optional files:
23
24              - platform.dts (platform device tree)
25
26Makefile    Makefile to compile the boot loader.
27            Mandatory arguments:
28
29              - PLATFORM_DIR=<platform_dir>
30
31                Defines the directory where to find the plateform specific
32                files
33
34           Optional arguments:
35
36              - USE_DT=<value>
37
38                Value can be 1 or 0.
39                If a device tree file is not used, set this flag to 0. It is
40                set by default to 1.
41
42              - SYSTEM_CLK=<platform clock frequency>
43
44                Platform clock frequency in KHz
45
46              - DTS=<file.dts>
47
48                Platform device tree (by default is platform.dts)
49
50Examples:
51
52    make PLATFORM_DIR=<platform_dir> USE_DT=0
53
54        Compile for <platform_dir> and do not compile device tree file
55
56    make PLATFORM_DIR=<platform_dir> DTS=platform_fpga.dts SYSTEM_CLK=25000
57
58        Compile for <platform_dir> and compile the 'platform_dpga.dts'
59        device tree file. System clock frequency is 25 MHz
60
61    make PLATFORM_DIR=<platform_conf> SYSTEM_CLK=25000
62
63        Compile for <platform_dir> and compile the 'platform.dts'
64        device tree file (default name). System clock frequency is 25 MHz
65
Note: See TracBrowser for help on using the repository browser.