← All books

The cover: a brown hat over a block diagram of the parts, on dark teal (In preparation)

The TxHDL Runtime

A Tour of the Library, Its Macros and Its Parts

by Filip Filmar and Dragiša Janković

This book is a tour of the open parts of TxHDL, the hardware description language that is a Rust library. It goes through the runtime crate, the macros, and the library of parts, one component at a time: what each one does, how it is built, and how a design uses it.

The tour starts with the runtime: values, wires and channels, registers and memories, the model of time, traces and formal checks. It shows how the lowering and the macros turn a design into Verilog and VHDL, and what they refuse. It then covers the parts: streams and clock crossings, AXI4 and AXI-Lite with routing and arbitration, and a network on chip. After those come the peripherals: serial masters, an interrupt controller, burst engines, an SD host, Sv32 address translation, a debugger, an Ethernet MAC, and video out. About 290 diagrams show each component and how the components connect. The appendices list every public item, the tests, and the register maps.

It is an optional companion to TxHDL: Hardware in Rust, from Code to Silicon. That book teaches the language; this one does not teach it again, and describes the library you build with it.

In preparation, in paperback and as an ebook. The language itself is on GitHub.

About 630 pages in the current draft.

Notify me when it's out