return Resource.family(*args, default_name="i2c", ios=ios)
-def recurse_down(asicpad, jtagpad):
- """recurse_down: messy ASIC-to-JTAG pad matcher which expects
- at some point some Records named i, o and oe, and wires them
- up in the right direction according to those names. "i" for
- input must come *from* the ASIC pad and connect *to* the JTAG pad
- """
- eqs = []
- for asiclayout, jtaglayout in zip(asicpad.layout, jtagpad.layout):
- apad = getattr(asicpad, asiclayout[0])
- jpad = getattr(jtagpad, jtaglayout[0])
- print ("recurse_down", asiclayout, jtaglayout, apad, jpad)
- if isinstance(asiclayout[1], Layout):
- eqs += recurse_down(apad, jpad)
- elif asiclayout[0] == 'i':
- eqs.append(jpad.eq(apad))
- elif asiclayout[0] in ['o', 'oe']:
- eqs.append(apad.eq(jpad))
- return eqs
-
-
# top-level demo module.
class Blinker(Elaboratable):
def __init__(self, pinset, resources):
- self.jtag = JTAG({}, "sync")
- self.jtag.pad_mgr = ResourceManager([], [])
- self.jtag.core_mgr = ResourceManager([], [])
- self.jtag.pad_mgr.add_resources(resources)
- self.jtag.core_mgr.add_resources(resources)
- # record resource lookup between core IO names and pads
- self.jtag.padlookup = {}
- self.jtag.requests_made = []
- self.jtag.boundary_scan_pads = []
- self.jtag.resource_table = {}
- self.jtag.resource_table_pads = {}
- self.jtag.eqs = []
+ self.jtag = JTAG({}, "sync", resources=resources)
memory = Memory(width=32, depth=16)
self.sram = SRAM(memory=memory, bus=self.jtag.wb)
- # allocate all resources in advance in pad/core ResourceManagers
- for resource in resources:
- print ("JTAG resource", resource)
- if resource.name in ['clk', 'rst']: # hack
- continue
- self.add_jtag_request(resource.name, resource.number)
-
def elaborate(self, platform):
jtag_resources = self.jtag.pad_mgr.resources
- core_resources = self.jtag.core_mgr.resources
m = Module()
m.submodules.jtag = self.jtag
m.submodules.sram = self.sram
count = Signal(5)
m.d.sync += count.eq(count+1)
print ("resources", platform, jtag_resources.items())
- gpio = self.jtag_request('gpio')
+ gpio = self.jtag.request('gpio')
print (gpio, gpio.layout, gpio.fields)
# get the GPIO bank, mess about with some of the pins
m.d.comb += gpio.gpio0.o.eq(1)
m.d.comb += gpio.gpio1.oe.eq(count[4])
m.d.sync += count[0].eq(gpio.gpio1.i)
# get the UART resource, mess with the output tx
- uart = self.jtag_request('uart')
+ uart = self.jtag.request('uart')
print (uart, uart.fields)
intermediary = Signal()
m.d.comb += uart.tx.eq(intermediary)
m.d.comb += intermediary.eq(uart.rx)
- # platform requested: make the exact same requests,
- # then add JTAG afterwards
- if platform is not None:
- for (name, number, dir, xdr) in self.jtag.requests_made:
- asicpad = platform.request(name, number, dir=dir, xdr=xdr)
- jtagpad = self.jtag.resource_table_pads[(name, number)]
- print ("jtagpad", jtagpad, jtagpad.layout)
- m.d.comb += recurse_down(asicpad, jtagpad)
-
- # wire up JTAG otherwise we are in trouble (no clock)
- jtag = platform.request('jtag')
- m.d.comb += self.jtag.bus.tdi.eq(jtag.tdi)
- m.d.comb += self.jtag.bus.tck.eq(jtag.tck)
- m.d.comb += self.jtag.bus.tms.eq(jtag.tms)
- m.d.comb += jtag.tdo.eq(self.jtag.bus.tdo)
-
- # add the eq assignments connecting up JTAG boundary scan to core
- m.d.comb += self.jtag.eqs
- return m
+ return self.jtag.boundary_elaborate(m, platform)
def ports(self):
return list(self)
def __iter__(self):
- yield self.jtag.bus.tdi
- yield self.jtag.bus.tdo
- yield self.jtag.bus.tck
- yield self.jtag.bus.tms
- yield from self.jtag.boundary_scan_pads
-
- def jtag_request(self, name, number=0, *, dir=None, xdr=None):
- return self.jtag.resource_table[(name, number)]
-
- def add_jtag_request(self, name, number=0, *, dir=None, xdr=None):
- """request a Resource (e.g. name="uart", number=0) which will
- return a data structure containing Records of all the pins.
-
- this override will also - automatically - create a JTAG Boundary Scan
- connection *without* any change to the actual Platform.request() API
- """
- pad_mgr = self.jtag.pad_mgr
- core_mgr = self.jtag.core_mgr
- padlookup = self.jtag.padlookup
- # okaaaay, bit of shenanigens going on: the important data structure
- # here is Resourcemanager._ports. requests add to _ports, which is
- # what needs redirecting. therefore what has to happen is to
- # capture the number of ports *before* the request. sigh.
- start_ports = len(core_mgr._ports)
- value = core_mgr.request(name, number, dir=dir, xdr=xdr)
- end_ports = len(core_mgr._ports)
-
- # take a copy of the requests made
- self.jtag.requests_made.append((name, number, dir, xdr))
-
- # now make a corresponding (duplicate) request to the pad manager
- # BUT, if it doesn't exist, don't sweat it: all it means is, the
- # application did not request Boundary Scan for that resource.
- pad_start_ports = len(pad_mgr._ports)
- pvalue = pad_mgr.request(name, number, dir=dir, xdr=xdr)
- pad_end_ports = len(pad_mgr._ports)
-
- # ok now we have the lengths: now create a lookup between the pad
- # and the core, so that JTAG boundary scan can be inserted in between
- core = core_mgr._ports[start_ports:end_ports]
- pads = pad_mgr._ports[pad_start_ports:pad_end_ports]
- # oops if not the same numbers added. it's a duplicate. shouldn't happen
- assert len(core) == len(pads), "argh, resource manager error"
- print ("core", core)
- print ("pads", pads)
-
- # pad/core each return a list of tuples of (res, pin, port, attrs)
- for pad, core in zip(pads, core):
- # create a lookup on pin name to get at the hidden pad instance
- # this pin name will be handed to get_input, get_output etc.
- # and without the padlookup you can't find the (duplicate) pad.
- # note that self.padlookup and self.jtag.ios use the *exact* same
- # pin.name per pin
- padpin = pad[1]
- corepin = core[1]
- if padpin is None: continue # skip when pin is None
- assert corepin is not None # if pad was None, core should be too
- print ("iter", pad, padpin.name)
- print ("existing pads", padlookup.keys())
- assert padpin.name not in padlookup # no overwrites allowed!
- assert padpin.name == corepin.name # has to be the same!
- padlookup[padpin.name] = pad # store pad by pin name
-
- # now add the IO Shift Register. first identify the type
- # then request a JTAG IOConn. we can't wire it up (yet) because
- # we don't have a Module() instance. doh. that comes in get_input
- # and get_output etc. etc.
- iotype = resiotypes[padpin.dir] # look up the C4M-JTAG IOType
- io = self.jtag.add_io(iotype=iotype, name=padpin.name) # IOConn
- self.jtag.ios[padpin.name] = io # store IOConn Record by pin name
-
- # and connect up core to pads based on type. could create
- # Modules here just like in Platform.get_input/output but
- # in some ways it is clearer by being simpler to wire them globally
-
- if padpin.dir == 'i':
- print ("jtag_request add input pin", padpin)
- print (" corepin", corepin)
- print (" jtag io core", io.core)
- print (" jtag io pad", io.pad)
- # corepin is to be returned, here. so, connect jtag corein to it
- self.jtag.eqs += [corepin.i.eq(io.core.i)]
- # and padpin to JTAG pad
- self.jtag.eqs += [io.pad.i.eq(padpin.i)]
- self.jtag.boundary_scan_pads.append(padpin.i)
- elif padpin.dir == 'o':
- print ("jtag_request add output pin", padpin)
- print (" corepin", corepin)
- print (" jtag io core", io.core)
- print (" jtag io pad", io.pad)
- # corepin is to be returned, here. connect it to jtag core out
- self.jtag.eqs += [io.core.o.eq(corepin.o)]
- # and JTAG pad to padpin
- self.jtag.eqs += [padpin.o.eq(io.pad.o)]
- self.jtag.boundary_scan_pads.append(padpin.o)
- elif padpin.dir == 'io':
- print ("jtag_request add io pin", padpin)
- print (" corepin", corepin)
- print (" jtag io core", io.core)
- print (" jtag io pad", io.pad)
- # corepin is to be returned, here. so, connect jtag corein to it
- self.jtag.eqs += [corepin.i.eq(io.core.i)]
- # and padpin to JTAG pad
- self.jtag.eqs += [io.pad.i.eq(padpin.i)]
- # corepin is to be returned, here. connect it to jtag core out
- self.jtag.eqs += [io.core.o.eq(corepin.o)]
- # and JTAG pad to padpin
- self.jtag.eqs += [padpin.o.eq(io.pad.o)]
- # corepin is to be returned, here. connect it to jtag core out
- self.jtag.eqs += [io.core.oe.eq(corepin.oe)]
- # and JTAG pad to padpin
- self.jtag.eqs += [padpin.oe.eq(io.pad.oe)]
-
- self.jtag.boundary_scan_pads.append(padpin.i)
- self.jtag.boundary_scan_pads.append(padpin.o)
- self.jtag.boundary_scan_pads.append(padpin.oe)
-
- # finally record the *CORE* value just like ResourceManager.request()
- # so that the module using this can connect to *CORE* i/o to the
- # resource. pads are taken care of
- self.jtag.resource_table[(name, number)] = value
-
- # and the *PAD* value so that it can be wired up externally as well
- self.jtag.resource_table_pads[(name, number)] = pvalue
-
+ yield from self.jtag.iter_ports()
'''
_trellis_command_templates = [
resources = create_resources(pinset)
top = Blinker(pinset, resources)
-#vl = rtlil.convert(top, ports=top.ports())
-#with open("test_jtag_blinker.il", "w") as f:
-# f.write(vl)
+vl = rtlil.convert(top, ports=top.ports())
+with open("test_jtag_blinker.il", "w") as f:
+ f.write(vl)
if True:
# XXX these modules are all being added *AFTER* the build process links