LUNA: an Amaranth HDL library for USB

LUNA is a toolkit for working with USB using FPGA technology, providing gateware and software to enable USB applications.

Some things you can use LUNA for, currently:

Protocol analysis for Low-, Full-, or High- speed USB. LUNA provides gateware that allow passive USB monitoring when combined with Cynthion and Packetry.
Creating your own Low-, Full-, High-, or (experimentally) Super- speed USB device. LUNA provides a collection of Amaranth gateware that allows you to easily create USB devices in gateware, software, or a combination of the two.
Building USB functionality into a new or existing System-on-a-Chip (SoC). LUNA is capable of generating custom peripherals targeting the common Wishbone bus; allowing it to easily be integrated into SoC designs; and the luna-soc library provides simple automation for developing simple SoC designs.

Some things you'll be able to use LUNA for in the future:

Man-in-the-middle'ing USB communications. The LUNA toolkit will be able to act as a USB proxy, transparently modifying USB data as it flows between a host and a device.
USB reverse engineering and security research. The LUNA toolkit will serve as an ideal backend for tools like Facedancer; allowing easy emulation and rapid prototyping of compliant and non-compliant USB devices.

Project Structure

This project is broken down into several directories:

luna -- the primary LUNA python toolkit; generates gateware and provides USB functionality
- luna/gateware -- the core gateware components for LUNA; and utilities for stitching them together
examples -- simple LUNA-related examples; mostly gateware-targeted, currently
docs -- sources for the LUNA Sphinx documentation
contrib -- contributed/non-core components; such as udev rules
applets -- pre-made gateware applications that provide useful functionality on their own (e.g., are more than examples)

LUNA's documentation is captured on Read the Docs. Raw documentation sources are in the docs folder.

Cynthion: an open source hardware USB test instrument
Apollo: the firmware that runs on Cynthion's debug controller and which is responsible for configuring its FPGA
Saturn-V: a DFU bootloader created for Cynthion
Packetry: software for USB analysis
Facedancer: software to create USB devices in Python