Changeset 9f24b6e in rtems-docs


Ignore:
Timestamp:
Feb 13, 2019, 7:05:33 AM (5 months ago)
Author:
Sebastian Huber <sebastian.huber@…>
Branches:
master
Children:
924b9ef
Parents:
f7384cc
git-author:
Sebastian Huber <sebastian.huber@…> (02/13/19 07:05:33)
git-committer:
Sebastian Huber <sebastian.huber@…> (02/18/19 07:45:54)
Message:

user: Add basic Intel Cyclone V documentation

File:
1 edited

Legend:

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

    rf7384cc r9f24b6e  
    11.. SPDX-License-Identifier: CC-BY-SA-4.0
    22
    3 .. Copyright (C) 2017, 2018 embedded brains GmbH
     3.. Copyright (C) 2017, 2019 embedded brains GmbH
     4.. Copyright (C) 2017, 2019 Sebastian Huber
    45
    56arm (ARM)
     
    910================
    1011
    11 TODO.
     12This BSP offers only one variant, the `altcycv_devkit`.  This variant supports
     13the Intel Cyclone V system on chip.  The basic hardware initialization is not
     14performed by the BSP.  A boot loader with device tree support must be used to
     15start the BSP, e.g. U-Boot.
     16
     17The BSP is known to run on these boards:
     18
     19* `Cyclone V SoC Development Kit <https://www.intel.com/content/www/us/en/programmable/products/boards_and_kits/dev-kits/altera/kit-cyclone-v-soc.html>`_
     20
     21* `Enclustra Mars MA3 SoC Module <https://www.enclustra.com/en/products/system-on-chip-modules/mars-ma3/>`_
     22
     23* `Terasic DE10-Standard Development Kit <https://www.terasic.com.tw/cgi-bin/page/archive.pl?Language=English&CategoryNo=165&No=1081>`_
     24
     25Boot via U-Boot
     26---------------
     27
     28The application executable file (ELF file) must be converted to an U-Boot
     29image.  Use the following commands:
     30
     31::
     32
     33    arm-rtems5-objcopy -O binary app.exe app.bin
     34    gzip -9 -f -c app.bin > app.bin.gz
     35    mkimage -A arm -O linux -T kernel -a 0x00300000 -e 0x00300000 -n RTEMS -d app.bin.gz app.img
     36
     37Use the following U-Boot commands to boot an application via TFTP download:
     38
     39::
     40
     41    tftpboot ${loadaddr} app.img && run loadfdt && bootm ${loadaddr} - ${fdt_addr} ; reset
     42
     43Clock Driver
     44------------
     45
     46The clock driver uses the `Cortex-A9 MPCore Global Timer`.
     47
     48Console Driver
     49--------------
     50
     51The console driver supports up to two on-chip NS16550 UARTs.  The console
     52driver does not configure the pins.
     53
     54I2C Driver
     55----------
     56
     57There is a legacy I2C driver.  It should be converted to the I2C driver framework.
     58
     59Network Interface Driver
     60------------------------
     61
     62The network interface driver is provided by the `libbsd`.  It is initialized
     63according to the device tree.  It supports checksum offload.
     64
     65MMC/SDCard Driver
     66-----------------
     67
     68The MMC/SDCard driver is provided by the `libbsd`.  It is
     69initialized according to the device tree.  Pin re-configuration according to
     70the serial clock frequency is not supported.  DMA transfers are supported.
     71
     72USB Host Driver
     73---------------
     74
     75The USB host driver is provided by the `libbsd`.  It is initialized according
     76to the device tree.  The driver works in polled mode.
     77
     78Caveats
     79-------
     80
     81The clock and pin configuration support is quite rudimentary and mostly relies
     82on the boot loader.
    1283
    1384atsam
Note: See TracChangeset for help on using the changeset viewer.