rtems/rtems-docs
1
0
Fork 0
mirror of https://git.rtems.org/rtems-docs/ synced 2025-07-25 19:55:58 +08:00
Code Issues Packages Projects Releases Wiki Activity

user: Add documentation for leon2 and leon3 BSP

Browse Source
This commit is contained in:
Daniel Cederman 2022-10-26 12:14:24 +02:00 committed by Daniel Hellstrom
parent 34c40383ab
commit 0f7e3a6c2f
1 changed files with 72 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

74
user/bsps/bsps-sparc.rst
View File

@ -20,11 +20,81 @@ TODO.
leon2
=====
TODO.
This BSP supports LEON2 systems, in particular the `Microchip AT697F
<https://www.microchip.com/en-us/product/AT697F>`_. The following
default build configurations are provided:
* leon2 - A generic LEON2 system with memory at 0x4000000.
* at697f - For the AT697F. Built with ``-mcpu=leon -mfix-at697f``.
The BSP contains UART, timer, and interrupt controller drivers.
Drivers for PCI are available through the :ref:`driver manager <BSP_sparc_leon3_drv_mgr>`.
.. _BSP_sparc_leon3:
leon3
=====
TODO.
This BSP supports the LEON3/4/5 systems from Cobham Gaisler.
The following default build configurations are provided:
* leon3 - A generic `LEON3/4/5 <https://www.gaisler.com/leon5>`_ system with memory at 0x4000000.
* ut700 - For the `UT700 <https://caes.com/product/ut700>`_. Built with ``-mcpu=leon3 -mfix-ut700``.
* ut699 - For the `UT699 <https://caes.com/product/ut699>`_. Built with ``-mcpu=leon -mfix-ut699``.
* gr712rc - For the `GR712RC <https://www.gaisler.com/gr712rc>`_. Built with ``-mcpu=leon3 -mfix-gr712rc``.
* gr740 - For the `GR740 <https://www.gaisler.com/gr740>`_. Memory located at address 0x0.
The BSP contains UART, timer, and interrupt controller drivers. Drivers for additional
peripherals are available through the driver manager.
.. _BSP_sparc_leon3_drv_mgr:
Driver Manager
--------------
The leon3 BSP includes an optional driver manager that handles drivers and
devices on the AMBA and PCI Plug & Play buses. The driver manager can either
be initialized manually by the user, or started automatically on startup by
setting the ``RTEMS_DRVMGR_STARTUP`` option. It can be configured to
automatically instantiate a driver for each hardware device found.
Drivers for the following devices are provided and handled via the driver manager:
* SpaceWire (GRSPW, GRSPW2, GRSPW2_DMA)
* SpaceWire Router (GRSPWROUTER)
* SpaceWire Time Distribution Protocol (SPWTDP)
* CAN - non-DMA (OCCAN) and DMA (GRCAN, GRCANFD)
- GPIO (GRGPIO)
- L2 Cache (L2CACHE)
- IOMMU (GRIOMMU)
- ADC/DAC (GRADCDAC)
- Timers (GPTIMER, GRTIMER)
- 1553 BC, RT and BM support (GR1553B)
- I2C Master (I2CMST)
- PCI (GRPCI2, GRPCI, PCIF)
- Memory Controller (MCTRL)
- Memory Scrubber (MEMSCRUB)
- Pulse Width Modulation Generator (GRPWM)
- CCSDS/ECSS Telemetry Encoder/Decoder (GRTM/GRTC)
- CSDS Time Manager (GRCTM)
- Ethernet (GRETH 10/100/1000) (requires network stack)
- Performance counters (L4STAT)
- Serial Peripheral Interface (AHBSTAT)
- AHB Status (AHBSTAT)
Build Configuration Options
---------------------------
The following options can be used in the BSP section of the ``waf``
configuration INI file. The ``waf`` defaults can be used to inspect the values.
``CONSOLE_USE_INTERRUPTS``
Use the Termios interrupt mode in the console driver (false by default).
``RTEMS_DRVMGR_STARTUP``
Enable the Driver Manager at startup (false by default).