8.7. microblaze (MicroBlaze)¶
8.7.1. KCU105 QEMU¶
The basic hardware initialization is performed by the BSP. This BSP supports the QEMU emulated Xilinx AXI Interrupt Controller v4.1.
8.7.1.1. Boot via ELF¶
The executable image is booted by QEMU in ELF format.
8.7.1.2. Clock Driver¶
The clock driver supports the QEMU emulated Xilinx AXI Timer v2.0. It is
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
.
8.7.1.3. Console Driver¶
The console driver supports the QEMU emulated 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
.
8.7.1.4. Network Driver¶
Support for networking is provided by the libbsd library. Network interface configuration is extracted from the device tree binary which, by default, is in <bsp/microblaze-dtb.h>. The device tree source for the default device tree is at dts/system.dts.
To replace the default device tree with your own, assuming my_device_tree.dts
is the name of your device tree source file, first you must convert your device
tree to .dtb format.
$ dtc -I dts -O dtb my_device_tree.dts > my_device_tree.dtb
The device tree blob, my_device_tree.dtb
, can now be converted to a C file.
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
, in the waf INI file
to include it in the BSP build.
BSP_MICROBLAZE_FPGA_DTB_HEADER_PATH = /path/to/my_dtb.c
8.7.1.5. 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
.
8.7.1.6. Running Executables¶
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).
Executables generated by this BSP can be run using the following command:
$ qemu-system-microblazeel -no-reboot -nographic -M microblaze-fdt-plnx -m 256 \
-serial mon:stdio -display none -hw-dtb system.dtb -kernel example.exe
8.7.1.7. Debugging with QEMU¶
To debug an application, add the option -s
to make QEMU listen for GDB
connections on port 1234. Add the -S
option to also stop execution until
a connection is made.
For example, to debug the hello sample and break at Init
, first start QEMU.
$ qemu-system-microblazeel -no-reboot -nographic -M microblaze-fdt-plnx -m 256 \
-serial mon:stdio -display none -hw-dtb system.dtb -kernel \
build/microblaze/kcu105_qemu/testsuites/samples/hello.exe -s -S
Then start GDB and connect to QEMU.
$ microblaze-rtems6-gdb build/microblaze/kcu105_qemu/testsuites/samples/hello.exe
(gdb) target remote localhost:1234
(gdb) break Init
(gdb) continue
8.7.2. KCU105¶
The basic hardware initialization is performed by the BSP. This BSP supports the Xilinx AXI Interrupt Controller v4.1.
This BSP was tested using the Xilinx Kintex UltraScale FPGA KCU105 board configured with the default Petalinux KCU105 MicroBlaze BSP. The defaults may need to be adjusted using BSP configuration options to match the memory layout and configuration of your board.
8.7.2.1. Clock Driver¶
The clock driver supports the Xilinx AXI Timer v2.0. It is 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
.
8.7.2.2. Console Driver¶
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
.
8.7.2.3. Debugging¶
The following debugging procedure was used for debugging RTEMS applications running on the Xilinx KCU105 board using GDB.
First send an FPGA bitstream to the board using OpenOCD.
$ openocd -f board/kcu105.cfg -c "init; pld load 0 system.bit; exit"
After the board has been programmed, start the Vivado hw_server
application
to serve as the debug server. Leave it running in the background for the rest of
the process.
$ tools/Xilinx/Vivado/2020.2/bin/hw_server
With the debug server running, connect to the debug server with GDB, load the application, and debug as usual. By default the GDB server listens on port 3002.
$ microblaze-rtems6-gdb example.exe
(gdb) target extended-remote localhost:3002
(gdb) load
(gdb) break Init
(gdb) continue