powerpc/virtex/README.md

0001 virtex
0002 ======
0003 ```
0004 BSP NAME:           Virtex
0005 BOARD:              Xilinx ML-403 and (hopefully) any vitex/PPC based board
0006 BUS:                N/A
0007 CPU FAMILY:         ppc
0008 CPU:                PowerPC 405GP
0009 COPROCESSORS:       N/A
0010 MODE:               32 bit mode
0011
0012 DEBUG MONITOR:
0013 ```
0014
0015 PERIPHERALS
0016 -----------
0017 ```
0018 TIMERS:             405GP internal
0019 SERIAL PORTS:       Xilinx consolelite
0020 REAL-TIME CLOCK:    none
0021 DMA:                Xilinx vitex internal
0022 VIDEO:              none
0023 SCSI:               none
0024 NETWORKING:         Xilinx TEMAC
0025 ```
0026
0027 DRIVER INFORMATION
0028 ------------------
0029 ```
0030 CLOCK DRIVER:       PPC Decrementer
0031 IOSUPP DRIVER:      N/A
0032 SHMSUPP:            N/A
0033 TIMER DRIVER:       N/A
0034 TTY DRIVER:         consoleelite
0035 ```
0036
0037 STDIO
0038 -----
0039 ```
0040 PORT:               Console port 0
0041 ELECTRICAL:         RS-232
0042 BAUD:               as defined in FPGA design
0043 BITS PER CHARACTER: 8
0044 PARITY:             None
0045 STOP BITS:          1
0046 ```
0047
0048 Board description
0049 -----------------
0050 ```
0051 clock rate:     234 MHz
0052 ROM:            16MByte FLASH
0053 RAM:            64MByte DRAM
0054 ```
0055
0056 Virtex only supports single processor operations.
0057
0058 Configuration
0059 -------------
0060 This board support package is written for a typical virtex/PPC FPGA
0061 system. The rough features of such a board are described above.
0062
0063 When a new virtex FPGA system is created (using the Xilinx design
0064 software), a parameter file "xparameters.h" is also created, which
0065 describes the basic features of the hardware (like peripherals
0066 included, interrupt routing etc.).
0067
0068 This BSP normally takes its basic HW description for the file
0069 "xparameters_dflt.h", which describes my FPGA system. When this BSP
0070 should run on a different hardware, a path to the proper
0071 "xparameters.h" can be provided on the "configure" command line.
0072
0073 For adapting this BSP to other boards, you can specify several configuration
0074 options at the configure command line (use "./configure --help" in this
0075 directory).  Here is an example for the top-level configure invocation:
0076
0077 ```shell
0078 /path/to/rtems/sources/configure \
0079   --target=powerpc-rtems4.11 \
0080   --enable-rtemsbsp=virtex \
0081   --enable-maintainer-mode \
0082   --enable-posix \
0083   --enable-tests \
0084   --disable-networking \
0085   'RTEMS_XPARAMETERS_H="/path/to/xparameters.h"' \
0086   VIRTEX_RAM_ORIGIN=0xfffc0000 \
0087   VIRTEX_RAM_LENGTH=0x3ffec \
0088   VIRTEX_RESET_ORIGIN=0xffffffec
0089 ```