10.3. Running a Design on Arty¶
10.3.1. Basic Arty Design¶
The default Xilinx Arty 35T harness is setup to have JTAG available over the board’s PMOD pins, and UART available over its FTDI serial USB adapter. The pin mappings for JTAG signals are identical to those described in the SiFive Freedom E310 Arty 35T Getting Started Guide.
The JTAG interface allows a user to connect to the core via OpenOCD, run bare-metal applications, and debug these applications with gdb. UART allows a user to communicate with the core over a USB connection and serial console running on a PC.
To extend this design, a user may create their own Chipyard configuration and add the
WithArtyTweaks located in
Adding this config. fragment will enable and connect the JTAG and UART interfaces to your Chipyard design.
class WithArtyTweaks extends Config( new WithArtyJTAGHarnessBinder ++ new WithArtyUARTHarnessBinder ++ new WithArtyResetHarnessBinder ++ new WithDebugResetPassthrough ++ new WithDefaultPeripherals ++ new freechips.rocketchip.subsystem.WithNBreakpoints(2)) class TinyRocketArtyConfig extends Config( new WithArtyTweaks ++ new chipyard.TinyRocketConfig)
Future peripherals to be supported include the Arty 35T SPI Flash EEPROM, and I2C/PWM/SPI over the Arty 35T GPIO pins. These peripherals are available as part of sifive-blocks.
10.3.2. Brief Implementation Description and Guidance for Adding/Changing Xilinx Collateral¶
Like the VCU118, the basis for the Arty 35T design is the creation of a special test harness that connects the external IO (which exist as Xilinx IP blackboxes) to the Chipyard design.
This is done with the
ArtyTestHarness in the basic default Arty 35T target. However, unlike the
ArtyTestHarness uses no
Overlays, and instead directly connects chip top IO to the ports of the external IO blackboxes, using functions such as
IOBUF provided by
Unlike the VCU118 and other more complicated test harnesses, the Arty 35T Vivado collateral is not generated by
Overlays, but rather are a static collection of
set_properties statements located in the files within
If the user wishes to re-map FPGA package pins to different harness-level IO, this may be changed within
fpga/fpga-shells/xilinx/arty/constraints/arty-master.xdc. The addition of new Xilinx IP blocks may be done in
fpga-shells/xilinx/arty/tcl/ip.tcl, mapped to harness-level IOs in
arty-master.xdc, and wired through from the test harness to the chip top using
Examples of a simple
HarnessBinder for routing signals (in this case the debug and JTAG resets) from the core to the test harness are the