basic_ila_fast_domain.py
#!/usr/bin/env python3
#
# This file is part of LUNA.
#

import sys
from nmigen import Signal, Module, Elaboratable, ClockDomain, ClockSignal, Cat

from luna                             import top_level_cli
from luna.gateware.utils.cdc          import synchronize
from luna.gateware.debug.ila          import SyncSerialILA
from luna.gateware.architecture.car   import LunaECP5DomainGenerator

from luna.apollo                      import create_ila_frontend

#
# Clock frequencies for each of the domains.
# Can be modified to test at faster or slower frequencies.
#
CLOCK_FREQUENCIES = {
    "fast": 240,
    "sync": 120,
    "ulpi": 60
}

class ILAExample(Elaboratable):
    """ Gateware module that demonstrates use of the internal ILA. """

    def __init__(self):
        self.counter = Signal(28)
        self.ila  = SyncSerialILA(signals=[self.counter], sample_depth=32, domain='fast')


    def interactive_display(self):
        frontend = create_ila_frontend(self.ila)
        frontend.interactive_display()


    def elaborate(self, platform):
        m = Module()
        m.submodules += self.ila

        # Generate our clock domains.
        clocking = LunaECP5DomainGenerator(clock_frequencies=CLOCK_FREQUENCIES)
        m.submodules.clocking = clocking

        # Clock divider / counter.
        m.d.fast += self.counter.eq(self.counter + 1)

        # Set our ILA to trigger each time the counter is at a random value.
        # This shows off our example a bit better than counting at zero.
        m.d.comb += self.ila.trigger.eq(self.counter == 7)

        # Grab our I/O connectors.
        leds    = [platform.request("led", i, dir="o") for i in range(0, 6)]
        spi_bus = synchronize(m, platform.request('debug_spi'), o_domain='fast')

        # Attach the LEDs and User I/O to the MSBs of our counter.
        m.d.comb += Cat(leds).eq(self.counter[-7:-1])

        # Connect our ILA up to our board's aux SPI.
        m.d.comb += self.ila.spi.connect(spi_bus)

        # Return our elaborated module.
        return m


if __name__ == "__main__":
    example = top_level_cli(ILAExample)
    example.interactive_display()