Changeset c476cce in rtems-docs


Ignore:
Timestamp:
Aug 29, 2018, 5:47:14 AM (9 months ago)
Author:
Sebastian Huber <sebastian.huber@…>
Branches:
master
Children:
d90c813
Parents:
859096b
Message:

user: Add qoriq BSP section

Update #2854.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • user/bsps/bsps-powerpc.rst

    r859096b rc476cce  
    55*****************
    66
    7 TODO.
     7QorIQ
     8=====
     9
     10The BSP for the `QorIQ <https://en.wikipedia.org/wiki/QorIQ>`_ chip family
     11offers three variants.  The `qoriq_e500` variant supports the P-series chips
     12such as P1020, P2010 and P2020.  The `qoriq_e6500_32` (32-bit ISA) and
     13`qoriq_e6500_64` (64-bit ISA) variants support the T-series chips such as T2080
     14and T4240.  The basic hardware initialization is not performed by the BSP.  A
     15boot loader with device tree support must be used to start the BSP, e.g.
     16U-Boot.
     17
     18The BSP is known to run on these boards:
     19
     20* NXP P1020RDB
     21
     22* MicroSys miriac MPX2020 (System on Module)
     23
     24* Artesyn MVME2500 (VME64x SBC)
     25
     26* NXP T2080RDB
     27
     28* NXP T4240RDB
     29
     30* MEN G52A (CompactPCI Serial)
     31
     32Boot via U-Boot
     33---------------
     34
     35The application executable file (ELF file) must be converted to an U-Boot
     36image.  Use the following commands:
     37
     38::
     39
     40    powerpc-rtems5-objcopy -O binary app.exe app.bin
     41    gzip -9 -f -c app.bin > app.bin.gz
     42    mkimage -A ppc -O linux -T kernel -a 0x4000 -e 0x4000 -n RTEMS -d app.bin.gz app.img
     43
     44Use the following U-Boot commands to boot an application via TFTP download:
     45
     46::
     47
     48    tftpboot ${loadaddr} app.img && run loadfdt && bootm ${loadaddr} - ${fdt_addr} ; reset
     49
     50Clock Driver
     51------------
     52
     53The clock driver uses two MPIC global timer (``QORIQ_CLOCK_TIMER`` and
     54``QORIQ_CLOCK_TIMECOUNTER``).  In case ``QORIQ_IS_HYPERVISOR_GUEST`` is
     55defined, then the PowerPC decrementer is used.
     56
     57Console Driver
     58--------------
     59
     60The console driver supports the on-chip NS16550 compatible UARTs.  In case
     61``QORIQ_IS_HYPERVISOR_GUEST`` is defined, then the EPAPR byte channel is used
     62for the console device.
     63
     64Network Interface Driver
     65------------------------
     66
     67The network interface driver is provided by the `libbsd`.  The DPAA is
     68supported including 10Gbit/s Ethernet.
     69
     70Topaz Hypervisor Guest
     71----------------------
     72
     73For a Topaz hypervisor guest configuration use:
     74
     75::
     76
     77    ../configure --enable-rtemsbsp=qoriq_e6500_32 \
     78        QORIQ_IS_HYPERVISOR_GUEST=1 \
     79        QORIQ_UART_0_ENABLE=0 \
     80        QORIQ_UART_1_ENABLE=0 \
     81        QORIQ_TLB1_ENTRY_COUNT=16
     82
     83You may have to adjust the linker command file according to your partition
     84configuration.
Note: See TracChangeset for help on using the changeset viewer.