diff options
author | Daniel Cederman <cederman@gaisler.com> | 2022-10-26 12:13:55 +0200 |
---|---|---|
committer | Daniel Cederman <cederman@gaisler.com> | 2022-11-15 16:01:41 +0100 |
commit | 34c40383ab8bae26c9a7612cf34efef1337521df (patch) | |
tree | 122899406c9c296bd7688c03a724f27666fa8f34 /user/bsps | |
parent | eng, user: update bsp_list to bsplist (diff) | |
download | rtems-docs-34c40383ab8bae26c9a7612cf34efef1337521df.tar.bz2 |
user: Add documentation for NOEL-V BSP
Diffstat (limited to 'user/bsps')
-rw-r--r-- | user/bsps/bsps-riscv.rst | 57 |
1 files changed, 57 insertions, 0 deletions
diff --git a/user/bsps/bsps-riscv.rst b/user/bsps/bsps-riscv.rst index d8491ee..2ef8327 100644 --- a/user/bsps/bsps-riscv.rst +++ b/user/bsps/bsps-riscv.rst @@ -261,6 +261,63 @@ Serial terminal UART1 displays the SMP example messages *** END OF TEST SMP 1 *** +noel +==== + +This BSP supports the `NOEL-V <https://gaisler.com/noel-v>`_ systems from Cobham +Gaisler. The NOEL-V is a synthesizable VHDL model of a processor that +implements the RISC-V architecture. It is part of the open source +`GRLIB <https://gaisler.com/grlib>`_ IP Library. The following BSP +variants correspond to common NOEL-V configurations: + +* noel32im + +* noel32imafd + +* noel64imac + +* noel64imafd + +* noel64imafdc + +The start of the memory is set to 0x0 to match a standard NOEL-V system, +but can be changed using the ``RISCV_RAM_REGION_BEGIN`` configuration +option. The size of the memory is taken from the information available +in the device tree. + +Reference Designs +----------------- + +The BSP has been tested with NOEL-V reference designs for +`Digilent Arty A7 <https://gaisler.com/noel-artya7>`_, +`Microchip PolarFire Splash Kit <https://gaisler.com/noel-pf>`_, +and `Xilinx KCU105 <https://gaisler.com/noel-xcku>`_. +See the accompanying quickstart guide for each reference design +to determine which BSP configuration to use. + +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. + +``BSP_CONSOLE_USE_INTERRUPTS`` + Use the Termios interrupt mode in the console driver (true by default). + +``BSP_FDT_BLOB_SIZE_MAX`` + The maximum size of the device tree blob in bytes (262144 by default). + +``RISCV_CONSOLE_MAX_APBUART_DEVICES`` + The maximum number of APBUART devices supported by the console driver + (2 by default). + +``RISCV_RAM_REGION_BEGIN`` + The begin of the RAM region for linker command file (0x0 by default). + +``RISCV_MAXIMUM_EXTERNAL_INTERRUPTS`` + The maximum number of external interrupts supported by the BSP (64 by + default). + griscv ====== |