Bare-metal Rust on the Xilinx Zynq ZC706 devkit
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Astro 191abf6b8f mpidr: wrap with proper bitfield getters 4 days ago
.cargo update rust + smoltcp 8 months ago
experiments fix exception vectors 6 days ago
libasync TcpStream: add send_slice() 3 weeks ago
libboard_zynq libboard_zynq: add fpgax_clk_ctrl registers 5 days ago
libcortex_a9 mpidr: wrap with proper bitfield getters 4 days ago
libregister finished register definitions 2 months ago
libsupport_zynq mpidr: wrap with proper bitfield getters 4 days ago
openocd openocd: fix cora z7-10 PL_TAPID 1 month ago
.gitignore remove zc706.elf from gitignore 5 months ago
Cargo.lock Cargo.lock: cargo update 2 months ago
Cargo.toml Cargo.toml: flip LTO back on to fit OCM 3 months ago default.nix: fix 5 months ago
armv7-none-eabihf.json define custom target, use with cargo-xbuild 11 months ago improved the development process 5 months ago
channel-rust-nightly.toml Cargo.lock: fix 2 months ago
default.nix update cargoSha256 2 months ago
qemu.gdb PoC: boot, uart output in qemu 1 year ago add remote run script 1 month ago PoC: boot, uart output in qemu 1 year ago
shell.nix default.nix: build zc706 9 months ago add support for cora z7 in tmux script 5 months ago


nix-shell --command "cargo xbuild --release"

Currently the ELF output is placed at target/armv7-none-eabihf/release/experiments


Using the Xilinx toolchain

Tested with the ZC706 board.

Run the Xilinx Microprocessor Debugger:


Connect to target (given it is connected and you have permissions):

connect arm hw

Leave xmd running.

Start the Xilinx version of the GNU debugger with your latest build:

/opt/Xilinx/14.7/ISE_DS/EDK/gnu/arm/lin/bin/arm-xilinx-linux-gnueabi-gdb zc706

Connect the debugger to xmd over TCP on localhost:

target remote :1234

Proceed using gdb with load, c

Using OpenOCD

Running on the ZC706

nix-shell --command "cargo xbuild --release"
cd openocd
openocd -f zc706.cfg

Running on the Cora Z7-10

nix-shell --command "cd experiments && cargo xbuild --release --no-default-features --features=target_cora_z7_10"
cd openocd
openocd -f cora-z7-10.cfg

Loading a bitstream into volatile memory

  openocd -f zc706.cfg -c "pld load 0 blinker_migen.bit; exit"

Development Process

Clone this repo onto your development/build machine and the raspberry pi that controls the Xilinx 7000 board

On the dev machine, the below script builds zc706 and secure copies it to the target pi (in your pi $HOME directory)

cd ~/zc706
./ $your_user/ssh_id

On the pi, we need an information rich environment that includes a relatively reliable gdb experience (that includes ctrl-p and ctrl-n command history that persists across cgdb executions), run:

ssh pi4
cd zc706

Time to run your code with:


or, for a more succinct experience, (identical to above)


After every build on your dev machine, simply run:


Sometimes you might need to type load after dr.