The PandABlocks-sim image runs a whole PandA in simulation — no hardware and
no Vivado required. It bundles three services under supervisord:
the FPGA simulation (
make run_sim_server), an NVC simulation of thetesttargetapp driven by cocotb, serving register reads/writes on port 9999 inside the container;the PandABlocks-server
sim_server, which talks to that simulation instead of real hardware and offers the usual control (8888) and data (8889) ports;the web control interface on port
8008.
The image is built from Dockerfile_sim and published to GHCR.
Run it¶
docker run -p 8008:8008 ghcr.io/pandablocks/pandablocks-sim:latestThen open http://
To make long timers usable despite the slow simulation, the FPGA simulation “time travels”: it models every tick-counting entity in the design (CLOCK and SEQ timers, PULSE queues and trains, PCAP timestamps and sample counts, FILTER averages) and, when the next event is far enough away, advances all of them together by the number of ticks until that event, paced so that the jump happens once the corresponding wall-clock time has elapsed. A CLOCK with a one second period therefore toggles about once a second, and every other block sees the same elapsed time as that CLOCK. Short timers (below a few hundred ticks) still run cycle by cycle.
Expose the server ports as well¶
To talk to the simulated PandA with the Python client or any other TCP client, publish the control and data ports too:
docker run -p 8008:8008 -p 8888:8888 -p 8889:8889 \
ghcr.io/pandablocks/pandablocks-sim:mainnc localhost 8888 then gets you an interactive control connection, on which
*IDN? reports the software and FPGA versions.
The FPGA simulation’s own port 9999 is deliberately bound to localhost
inside the container: it is the private interface between sim_server and the
simulation, not a client interface.
Waveforms¶
The FPGA simulation is started with dump_waveform=1, so NVC writes a
wave.fst into /repos/PandABlocks-FPGA/build/sim_sim_server/ inside the
container. To get at it from the host, mount a directory over the build
directory or copy the file out:
docker cp panda-sim:/repos/PandABlocks-FPGA/build/sim_sim_server/wave.fst .Open the result in GTKWave (or NVC’s own viewer).
Build the image locally¶
docker build -f Dockerfile_sim -t pandablocks-sim .The build clones PandABlocks-server and PandABlocks-webcontrol from GitHub
and compiles the server, so it needs network access and takes a while. The
repository working tree is copied in as /repos/PandABlocks-FPGA, which makes
this the way to try local FPGA changes in the full simulated system.