The Acorn Wishbone bridges test¶
This page explains the two ways a host reaches the registers of an Acorn that runs the fpgas.online design, and what tests each.
It is for someone who wants to know what the check does over each bridge, on a Raspberry Pi 5 or in a Compute Blade. The page gives no steps.
What it is¶
The bridges are part of the fpgas.online Acorn design, in both its images. From the
design’s source
(acorn_pcie_soc.py),
the design is reachable two ways, with the same registers behind both:
PCIe BAR0 to Wishbone: PCIe Gen2 x1, with one DMA channel beside it (
ndmas=1in the design’s source).UARTBone on the P2 serial pair, K2 (FPGA TX) and J2 (FPGA RX). The link comes out of reset at 1200 baud. The host writes the PHY’s
tuning_wordregister to move it to 921600. A UART break (J2 low for 50 ms) resets the PHY and the bridge, which puts it back. A command has 1 s to complete, so that transfers of several words work at 1200 baud.The BIOS console is on the crossover UART, so it can be read through either bridge.
BAR0 is read from a host with aligned 32-bit reads only, after memory decoding is enabled. The steps are in How to install the fpgas.online images on an Acorn. Where the P2 pair lands on each carrier is on the wiring pages: Raspberry Pi 5, Compute Blade.
How the check tests it¶
From the check’s document (fpgas-verify: what an Acorn check tests):
Test |
Over |
Passes when |
|---|---|---|
|
BAR0 |
the operational build runs, the flash identifies itself, the device DNA is neither all zeros nor all ones, and the XADC temperature and voltages are in range |
|
P2 |
the UARTBone identifier at 1200 baud is BAR0’s; at 921600 baud the identifier, DNA and XADC readings are right and the DNA is BAR0’s. The link is left at 1200 baud |
|
BAR0 and P2 |
the |
On a Raspberry Pi 5, a p2-uart test needs the header’s serial port on (/dev/ttyAMA0) and the kernel console off it:
the Pi’s settings.
The check runs these tests alone as sudo fpgas-acorn-verify --test pcie-bar0 --test p2-uart --test scratch, on either carrier: on a Raspberry Pi 5, on a Compute Blade. On a Compute Blade the P2 tests need a boot with the header’s serial port on (why).
More: the design’s own document is in fpgas.online-test-designs: designs/acorn-pcie.