diff options
Diffstat (limited to '')
-rw-r--r-- | user/bsps/bsps-microblaze.rst | 49 |
1 files changed, 39 insertions, 10 deletions
diff --git a/user/bsps/bsps-microblaze.rst b/user/bsps/bsps-microblaze.rst index e20df53..6fe4891 100644 --- a/user/bsps/bsps-microblaze.rst +++ b/user/bsps/bsps-microblaze.rst @@ -1,6 +1,6 @@ .. SPDX-License-Identifier: CC-BY-SA-4.0 -.. Copyright (C) 2018 embedded brains GmbH +.. Copyright (C) 2018 embedded brains GmbH & Co. KG .. Copyright (C) 2022 On-Line Applications Research Corporation (OAR) microblaze (MicroBlaze) @@ -21,13 +21,21 @@ Clock Driver ------------ The clock driver supports the QEMU emulated Xilinx AXI Timer v2.0. It is -implemented as a simple downcounter. +implemented as a simple downcounter. If device tree support is enabled in the +build configuration, the clock driver will use the node that is compatible with +`xlnx,xps-timer-1.00.a` from the device tree to configure the clock. The +following device tree node properties are used to configure the clock driver: +``reg``, ``clock-frequency``, and ``interrupts``. Console Driver -------------- The console driver supports the QEMU emulated Xilinx AXI UART Lite v2.0. It is -initialized to a baud rate of 115200. +initialized to a baud rate of 115200. If device tree support is enabled in the +build configuration, the console driver will use the node that is compatible +with `xlnx,xps-uartlite-1.00.a` from the device tree to configure the console. +The following device tree node properties are used to configure the console +driver: ``reg``, ``status``, ``port-number``, and ``interrupts``. Network Driver -------------- @@ -53,18 +61,30 @@ The name ``system_dtb`` is significant as it is the name expected by the BSP. $ rtems-bin2c -C -A 8 -N system_dtb my_device_tree.dtb my_dtb The ``BSP_MICROBLAZE_FPGA_DTB_HEADER_PATH`` BSP configuration option can then be -set to the path of the resulting source file, ``my_dtb.c``, to include it in the -BSP build. +set to the path of the resulting source file, ``my_dtb.c``, in the waf INI file +to include it in the BSP build. .. code-block:: none BSP_MICROBLAZE_FPGA_DTB_HEADER_PATH = /path/to/my_dtb.c +QSPI NOR JFFS2 Driver +--------------------- + +The QSPI NOR JFFS2 driver supports the QEMU emulated n25q512a11 QSPI NOR flash +device. It is initialized to a page size of 256 bytes and a sector size of 64 +KiB. If device tree support is enabled in the build configuration, the QSPI NOR +JFFS2 driver will use the node that is compatible with `xlnx,xps-spi-2.00.a` +from the device tree to configure the QSPI NOR JFFS2 driver. The following +device tree node properties are used to configure the QSPI NOR JFFS2 driver: +``reg`` and ``interrupts``. + + Running Executables ------------------- -A .dtb (device tree blob) file should be provided to QEMU via the ``-hw-dtb`` +A ``.dtb`` (device tree blob) file should be provided to QEMU via the ``-hw-dtb`` option. In the example command below, the device tree blob comes from the Xilinx Petalinux KCU105 MicroBlaze BSP (https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools.html). @@ -94,7 +114,7 @@ Then start GDB and connect to QEMU. .. code-block:: none - $ microblaze-rtems6-gdb build/microblaze/kcu105_qemu/testsuites/samples/hello.exe + $ microblaze-rtems@rtems-ver-major@-gdb build/microblaze/kcu105_qemu/testsuites/samples/hello.exe (gdb) target remote localhost:1234 (gdb) break Init (gdb) continue @@ -114,12 +134,21 @@ Clock Driver ------------ The clock driver supports the Xilinx AXI Timer v2.0. It is implemented as a -simple downcounter. +simple downcounter. If device tree support is enabled in the +build configuration, the clock driver will use the node that is compatible with +`xlnx,xps-timer-1.00.a` from the device tree to configure the clock. The +following device tree node properties are used to configure the clock driver: +``reg``, ``clock-frequency``, and ``interrupts``. Console Driver -------------- -The console driver supports the Xilinx AXI UART Lite v2.0. +The console driver supports the Xilinx AXI UART Lite v2.0. It is initialized to +a baud rate of 115200. If device tree support is enabled in the build +configuration, the console driver will use the node that is compatible with +`xlnx,xps-uartlite-1.00.a` from the device tree to configure the console. The +following device tree node properties are used to configure the console driver: +``reg``, ``status``, ``port-number``, and ``interrupts``. Debugging --------- @@ -146,7 +175,7 @@ application, and debug as usual. By default the GDB server listens on port 3002. .. code-block:: none - $ microblaze-rtems6-gdb example.exe + $ microblaze-rtems@rtems-ver-major@-gdb example.exe (gdb) target extended-remote localhost:3002 (gdb) load (gdb) break Init |