122 lines
4.5 KiB
ReStructuredText
122 lines
4.5 KiB
ReStructuredText
.. zephyr:board:: generic_leon3
|
|
|
|
Overview
|
|
********
|
|
|
|
This board configuration is designed to work with LEON3 processor template
|
|
designs available in the GRLIB GPL distribution.
|
|
It can also be used with the evaluation version of the TSIM3 LEON3 simulator.
|
|
|
|
Hardware
|
|
********
|
|
|
|
The board configuration is compatible with most GRLIB LEON3 FPGA template
|
|
designs such as the Digilent Arty A7, Terasic DE0-Nano and Microsemi
|
|
M2GL-EVAL-KIT.
|
|
|
|
Programming and Debugging
|
|
*************************
|
|
|
|
Building
|
|
========
|
|
|
|
Applications for the ``generic_leon3`` board configuration can be built as usual
|
|
(see :ref:`build_an_application`).
|
|
In order to build the application for ``generic_leon3``, set the ``BOARD`` variable
|
|
to ``generic_leon3``.
|
|
|
|
Running on hardware
|
|
===================
|
|
|
|
Connect with GRMON, then load and run the application. The example below uses
|
|
the Terasic DE2-115 Cyclone IV FPGA board.
|
|
|
|
.. code-block:: console
|
|
|
|
$ grmon -altjtag -u
|
|
GRMON debug monitor v3.2.8 eval version
|
|
|
|
Copyright (C) 2020 Cobham Gaisler - All rights reserved.
|
|
For latest updates, go to http://www.gaisler.com/
|
|
Comments or bug-reports to support@gaisler.com
|
|
|
|
JTAG chain (1): EP3C120/EP4CE115
|
|
GRLIB build version: 4250
|
|
Detected frequency: 50.0 MHz
|
|
|
|
Component Vendor
|
|
LEON3 SPARC V8 Processor Cobham Gaisler
|
|
AHB Debug UART Cobham Gaisler
|
|
JTAG Debug Link Cobham Gaisler
|
|
GR Ethernet MAC Cobham Gaisler
|
|
GRDMAC DMA Controller Cobham Gaisler
|
|
LEON2 Memory Controller European Space Agency
|
|
AHB/APB Bridge Cobham Gaisler
|
|
LEON3 Debug Support Unit Cobham Gaisler
|
|
Generic UART Cobham Gaisler
|
|
Multi-processor Interrupt Ctrl. Cobham Gaisler
|
|
Modular Timer Unit Cobham Gaisler
|
|
General Purpose I/O port Cobham Gaisler
|
|
SPI Controller Cobham Gaisler
|
|
AHB Status Register Cobham Gaisler
|
|
|
|
Use command 'info sys' to print a detailed report of attached cores
|
|
|
|
grmon3> load zephyr/zephyr.elf
|
|
40000000 text 16.2kB / 16.2kB [===============>] 100%
|
|
400040A8 initlevel 40B [===============>] 100%
|
|
400040D0 rodata 484B [===============>] 100%
|
|
400042B4 datas 20B [===============>] 100%
|
|
400042C8 sw_isr_table 256B [===============>] 100%
|
|
400043C8 devices 36B [===============>] 100%
|
|
Total size: 16.98kB (1.91Mbit/s)
|
|
Entry point 0x40000000
|
|
Image zephyr/zephyr.elf loaded
|
|
|
|
grmon3> run
|
|
*** Booting Zephyr OS build zephyr-v2.4.0-30-ga124c31ec4cf ***
|
|
Hello World! generic_leon3
|
|
|
|
|
|
Running in simulation
|
|
=====================
|
|
|
|
The same application binary can be simulated with the TSIM3 LEON3 simulator.
|
|
|
|
.. code-block:: console
|
|
|
|
$ tsim-leon3
|
|
TSIM3 LEON3 SPARC simulator, version 3.0.2 (evaluation version)
|
|
|
|
Copyright (C) 2020, Cobham Gaisler - all rights reserved.
|
|
This software may only be used with a valid license.
|
|
For latest updates, go to https://www.gaisler.com/
|
|
Comments or bug-reports to support@gaisler.com
|
|
|
|
Number of CPUs: 2
|
|
system frequency: 50.000 MHz
|
|
icache: 1 * 4 KiB, 16 bytes/line (4 KiB total)
|
|
dcache: 1 * 4 KiB, 16 bytes/line (4 KiB total)
|
|
Allocated 4096 KiB SRAM memory, in 1 bank at 0x40000000
|
|
Allocated 32 MiB SDRAM memory, in 1 bank at 0x60000000
|
|
Allocated 2048 KiB ROM memory at 0x00000000
|
|
|
|
tsim> load zephyr/zephyr.elf
|
|
section: text, addr: 0x40000000, size 16552 bytes
|
|
section: initlevel, addr: 0x400040a8, size 40 bytes
|
|
section: rodata, addr: 0x400040d0, size 484 bytes
|
|
section: datas, addr: 0x400042b4, size 20 bytes
|
|
section: sw_isr_table, addr: 0x400042c8, size 256 bytes
|
|
section: devices, addr: 0x400043c8, size 36 bytes
|
|
Read 436 symbols
|
|
tsim> run
|
|
Initializing and starting from 0x40000000
|
|
*** Booting Zephyr OS build zephyr-v2.4.0-30-ga124c31ec4cf ***
|
|
Hello World! generic_leon3
|
|
|
|
References
|
|
**********
|
|
* `GRLIB IP Library and LEON3, GPL version <https://www.gaisler.com/index.php/downloads/leongrlib>`_
|
|
* `TSIM3 LEON3 simulator <https://www.gaisler.com/index.php/products/simulators/tsim3/tsim3-leon3>`_
|
|
* `GRMON3 debug monitor <https://www.gaisler.com/index.php/products/debug-tools/grmon3>`_
|