Ignore:
Timestamp:
May 26, 2014, 9:41:05 AM (11 years ago)
Author:
cfuguet
Message:

tsar_boot:

  • Fixing bug introduced in commit r688. Missing double quotes while calling echo command. The SVN revision was not correctly taken because of this.
  • Renaming version in VERSION. Convention: Text files name is in capital letters.
File:
1 moved

Legend:

Unmodified
Added
Removed

  • trunk/softs/tsar_boot/README

    r701 r702  
    1111            For each platform, we must define a new directory.
    1212
    13       ---> defs_platform.h:
     13            - defs_platform.h:
    1414
    15              This file is mandatory. This file defines the
    16              NB_PROCS per cluster, the NB_CLUSTERS and the base address of
    17              the TTY, IOC, XICU and MEMC (config) devices.
    18              It defines also:
     15              This file is mandatory. This file defines the NB_PROCS per
     16              cluster, the NB_CLUSTERS and the base address of the TTY, IOC,
     17              XICU and MEMC (config) devices. It defines also:
    1918
    20               -> USE_IOB
    21                  This constant is used by the boot_ioc_read function to know
    22                  if the buffer used to store the blocks from the
    23                  block_device must be invalidated in the memory cache after
    24                  the transfert has finished.
     19                #define USE_IOB
    2520
    26               -> CACHE_COHERENCE
    27                  This constant is used by the boot_ioc_read function to know
    28                  if the buffer used to store the blocks from the block_device
    29                  must be invalidated in the dcache after the transfert has
    30                  finished.
     21                  This constant is used by the boot_ioc_read function to know
     22                  if the buffer used to store the blocks from the block_device
     23                  must be invalidated in the memory cache after the transfert
     24                  has finished.
    3125
    32               -> CACHE_LINE_SIZE
    33                  This constant is mandatory if CACHE_COHERENCE=0 or USE_IOB=1
    34                  This constant defines the size in bytes of a cache line.
     26                #define CACHE_COHERENCE
    3527
    36               -> RESET_DEBUG
    37                  Set value to 1 to show some debug messages during loading
     28                  This constant is used by the boot_ioc_read function to know
     29                  if the buffer used to store the blocks from the block_device
     30                  must be invalidated in the dcache after the transfert has
     31                  finished.
    3832
    39               -> IRQ_PER_PROC
    40                  This constant is used to know how many XICU irq outputs are
    41                  connected to each processor.
     33                #define CACHE_LINE_SIZE
     34                 
     35                  This constant is mandatory if CACHE_COHERENCE=0 or USE_IOB=1
     36                  This constant defines the size in bytes of a cache line.
    4237
    43       --->  platform_soclib.dts:
     38                #define RESET_DEBUG
    4439
    45              Device tree file. It is mandatory if compiling for a SOCLIB
    46              platform and USE_DT=1.
     40                  Set value to 1 to show some debug messages during loading
    4741
    48       --->  platform_fpga.dts:
     42                #define IRQ_PER_PROC
    4943
    50              Device tree file. It is mandatory if compiling for a FPGA platform
    51              and USE_DT=1.
     44                  This constant is used to know how many XICU irq outputs are
     45                  connected to each processor.
    5246
    53       --->  ldscript:
     47            - platform_soclib.dts:
    5448
    55              LD script defining the segments of this boot loader.
    56              We define two segments:
    57                 seg_stack_base: Base address of the stack used by processor 0
    58                 during the boot process. read-write data and bss will also
    59                 be there.
     49              Device tree file. It is mandatory if compiling for a SOCLIB
     50              platform and USE_DT=1.
    6051
    61                 seg_boot_base: Base address of the code and read-only data
    62                 defined for this loader
     52            - platform_fpga.dts:
     53
     54              Device tree file. It is mandatory if compiling for a FPGA
     55              platform and USE_DT=1.
     56
     57            - ldscript:
     58
     59              LD script defining the segments of this boot loader.
     60              We define two segments:
     61
     62                seg_stack_base:
     63
     64                  Base address of the stack used by processor 0 during the boot
     65                  process. read-write data and bss will also be there.
     66
     67                seg_boot_base:
     68               
     69                  Base address of the code and read-only data defined for this
     70                  loader
    6371           
    64 Makefile    Makefile for compile the boot loader.
    65             Arguments to pass:
     72Makefile    Makefile to compile the boot loader. Arguments to pass:
    6673
    67              ---> PLATFORM_DIR=<platform_dir>
     74              PLATFORM_DIR=<platform_dir>
    6875   
    69                    Defines the directory where to find the plateform specific
    70                    files
     76                Defines the directory where to find the plateform specific
     77                files
    7178
    72              ---> SOCLIB=1
     79              SOCLIB=1
    7380
    74                    If using SOCLIB, define this flag to use the BLOCK DEVICE
    75                    driver and to choose the platform_soclib device tree.
     81                If using SOCLIB, define this flag to use the BLOCK DEVICE
     82                driver and to choose the platform_soclib device tree.
    7683
    77              ---> RAMDISK=1
     84              RAMDISK=1
    7885
    79                    If using SOCLIB, define this flag to use a RAMDISK instead
    80                    of BLOCK DEVICE (Set this flag when the SOCLIB flag is also set)
     86                If using SOCLIB, define this flag to use a RAMDISK instead of
     87                BLOCK DEVICE (Set this flag when the SOCLIB flag is also set)
    8188
    82              ---> USE_DT=0
     89              USE_DT=0
    8390
    84                    If a device tree file is not used, set this flag to 0. It
    85                    is set by default to 1.
     91                If a device tree file is not used, set this flag to 0. It is
     92                set by default to 1.
    8693
    87               e.g. make PLATFORM_DIR=conf/<platform_dir> SOCLIB=1 USE_DT=0
     94              e.g. make PLATFORM_DIR=<platform_conf> \
     95                        SOCLIB=1 \
     96                        USE_DT=0 \
     97                        RAMDISK=0
Note: See TracChangeset for help on using the changeset viewer.