Tiliqua Project

The Tiliqua Project aims to make FPGA-based audio and video synthesis more accessible.

TLQ-MODULE and (optional) matching TLQ-SCREEN patched in a Eurorack System

Tiliqua is a Eurorack Module, which contains a debugger, FPGA and high-fidelity DC-coupled audio IOs, amongst lots of other features. It can store multiple bitstreams, and has a bootloader to select between them - making the hardware fully reconfigurable during live performance.

Note

If you just received Tiliqua hardware – Quickstart is where you should begin!

Quickstart

• Tiliqua Module [TLQ-MODULE]
  • Connecting Power
  • Connecting a Display
  • Bootloader
  • Menu / Help system
  • Using Bitstreams
  • Jack LEDs
  • Touch Sensors
  • Flashing/Updating Bitstreams
  • Calibration
  • Hardware Block Diagram
  • Instructions for Safe Use
• Tiliqua Screen [TLQ-SCREEN]
  • Connecting Power
  • Connecting Video
  • Display Timings
  • Native Rotation
  • Firmware Updates
  • Hardware Block Diagram
  • Instructions for Safe Use
• Expander / Euro-PMOD [TLQ-EXPANDER]
  • Use Cases
  • Cables
  • Connecting to Tiliqua
  • Hardware Block Diagram
  • Instructions for Safe Use
• Soldiercrab SoM [TLQ-SOLDIERCRAB]
  • Use Cases
  • Factory Bitstream
  • Use with TLQ-MODULE
  • Use in your own project
  • Hardware Block Diagram
  • Instructions for Safe Use

Development Guide

• Setup
  • 1. The Basics
  • 2. Check Installation
  • 3. Check USB device permissions
  • 4. Initialize submodules
  • 5. Set up python environment
  • 6. (optional, for CPU Bitstreams) A Rust toolchain
• Building and Flashing
  • Overview
  • Building
  • Logs and useful flags
  • Flashing to a Bitstream Slot
  • Webflasher
  • Flashing to SRAM
  • Flash Status
  • Debug / Serial logs
• Tutorial 1: Audio cores (top.dsp)
  • The Basics
  • CLI and CoreTop wrapper
  • Simulation
    • Test Suite (amaranth.sim)
    • Integration Tests (verilator)
• Tutorial 2: DSP blocks (tiliqua.dsp)
  • Fixed-point Lorenz Attractor
  • Oscillator Skeleton
  • Implementing Lorenz
  • Testing with amaranth.sim
  • Running on hardware
  • Side quest: squashing multipliers
    • Multiplies can be shifts
    • Sharing multipliers
  • Adding more blocks
• Tutorial 3: Video cores (top.beamrace)
  • Simulation
  • Building and --modeline
  • Structure
  • TODO
• Tutorial 4: SoC/CPU bitstreams
  • Background: Tiliqua SoC designs
  • Building
  • Flashing, Logs
  • Faster builds - only updating firmware
  • Parallel builds
  • Simulation
  • TODO
• Bootloader
  • User Interface
  • Bitstream Archives and Flash Memory Layout
  • Flashing the RP2040 and bootloader bitstream
    • Flashing Steps
  • Technical Details
    • Bootloader bitstream: ECP5
    • apfbug debugger firmware: RP2040
    • Recording new JTAG streams for RP2040

Reference

• Example Projects
  • SoC Projects
    • All Projects
  • non-SoC projects
    • All Projects
• DSP Library
  • Philosophy
  • Interconnect
  • ‘Basic’ and ‘Specialized’ components
  • Basic DSP Components
    • Delay Lines
    • Filters
    • Oscillators
    • Effects
    • VCAs
    • Mixing
    • Resampling
    • One-shot
    • Stream utilities
    • Miscellaneous utilities
  • Specialized Modules
    • Delay Effects
    • FFT Processing
    • Spectral Processing
    • Multiplier sharing (dsp.mac)
    • Block-based Processing
    • Complex Numbers
    • Trigonometry / CORDIC
• Calibration
  • Background
  • Calibrating the ADCs/DACs
• USB troubleshooting
  • dbg USB port (top, for flashing)
    • Webflasher doesn’t work
  • usb2 USB port (bottom, audio/MIDI)
    • USB audio - nothing enumerates
    • USB audio - glitchy audio (any OS)
    • USB audio - Windows / WASAPI shows separate input and output devices
    • USB MIDI Host - Device is never powered up
    • USB MIDI Host - Device powers up but no response to MIDI events
    • USB MIDI Host - Device powers up but MIDI events are glitchy / have missing notes

Hardware Details

• Electrical Design
  • Block Diagram (Tiliqua R5)
  • Pinouts and schematics
  • Tiliqua Motherboard (and panel)
  • FPGA SoM (soldiercrab)
  • Audio Interface (eurorack-pmod R3.5)
• Changelist
  • Tiliqua R5.1
  • Tiliqua R4
  • Tiliqua R3
  • Tiliqua R2
  • Tiliqua R1

Keep Updated

• Community
• Funding & Open Source
  • Where do I get a Tiliqua?
  • Funding
  • Open Hardware
  • License
  • Derivative works
• Development Blog
  • [Devlog 1] EMC Adventures

Links

• Tiliqua Webflasher
• Tiliqua on Crowd Supply
• Tiliqua on GitHub
• Homepage (apf.audio)