92d0b9aa2d994f9f903027d0c9c0c0e1aa8868e4
3 """ pin interface declaration.
4 * name is the name of the pin
5 * ready, enabled and io all create a (* .... *) prefix
6 * action changes it to an "in" if true
9 def __init__(self
, name
,
17 self
.enabled
= enabled
20 self
.bitspec
= bitspec
if bitspec
else '1'
22 def ifacefmt(self
, fmtfn
=None):
26 status
.append('always_ready')
28 status
.append('always_enabled')
30 status
.append('result="io"')
33 res
+= ','.join(status
)
38 name
= fmtfn(self
.name
)
42 res
+= ' (Bit#(%s) in)' % self
.bitspec
44 res
+= " Bit#(%s) " % self
.bitspec
49 def ifacedef(self
, fmtoutfn
=None, fmtinfn
=None, fmtdecfn
=None):
52 fmtname
= fmtinfn(self
.name
)
54 res
+= fmtdecfn(self
.name
)
55 res
+= '(Bit#(%s) in);\n' % self
.bitspec
56 res
+= ' %s<=in;\n' % fmtname
59 fmtname
= fmtoutfn(self
.name
)
60 res
+= "%s=%s;" % (self
.name
, fmtname
)
64 class Interface(object):
65 """ create an interface from a list of pinspecs.
66 each pinspec is a dictionary, see Pin class arguments
69 def __init__(self
, pinspecs
):
72 if p
.get('outen') is True: # special case, generate 3 pins
76 for psuffix
in ['out', 'outen', 'in']:
77 _p
['name'] = "%s_%s" % (p
['name'], psuffix
)
78 _p
['action'] = psuffix
!= 'in'
79 self
.pins
.append(Pin(**_p
))
81 self
.pins
.append(Pin(**p
))
83 def ifacefmt(self
, *args
):
84 res
= '\n'.join(map(self
.ifacefmtdecpin
, self
.pins
)).format(*args
)
87 def ifacefmtdecfn(self
, name
):
90 def ifacefmtdecfn2(self
, name
):
93 def ifacefmtoutfn(self
, name
):
96 def ifacefmtinfn(self
, name
):
99 def ifacefmtdecpin(self
, pin
):
100 return pin
.ifacefmt(self
.ifacefmtdecfn
)
102 def ifacefmtpin(self
, pin
):
103 return pin
.ifacedef(self
.ifacefmtoutfn
, self
.ifacefmtinfn
,
106 def ifacedef(self
, *args
):
107 res
= '\n'.join(map(self
.ifacefmtpin
, self
.pins
)).format(*args
)
108 return '\n' + res
+ '\n'
111 class MuxInterface(Interface
):
113 def ifacefmtdecfn2(self
, name
):
116 def ifacefmtdecfn(self
, name
):
119 def ifacefmtinfn(self
, name
):
122 class IOInterface(Interface
):
124 #def ifacefmtdecfn(self, name):
125 # return "cell{0}_mux"
127 def ifacefmtoutfn(self
, name
):
128 return "cell{0}_out.%s" % (name
[3:-4])
130 def ifacefmtinfn(self
, name
):
134 # ========= Interface declarations ================ #
136 mux_interface
= MuxInterface([{'name': 'cell{0}', 'ready':False,
138 'bitspec': '{1}', 'action': True}])
140 io_interface
= IOInterface([{'name': 'io_outputval_{0}', 'enabled': False},
141 {'name': 'io_output_en_{0}', 'enabled': False},
142 {'name': 'io_input_en_{0}', 'enabled': False},
143 {'name': 'io_pullup_en_{0}', 'enabled': False},
144 {'name': 'io_pulldown_en_{0}', 'enabled': False},
145 {'name': 'io_drivestrength_{0}', 'enabled': False},
146 {'name': 'io_pushpull_en_{0}', 'enabled': False},
147 {'name': 'io_opendrain_en_{0}', 'enabled': False},
148 {'name': 'io_inputval_{0}', 'action': True, 'io': True},
151 # == Peripheral Interface definitions == #
152 # these are the interface of the peripherals to the pin mux
153 # Outputs from the peripherals will be inputs to the pinmux
154 # module. Hence the change in direction for most pins
156 uartinterface_decl
= Interface([{'name': 'tx_{0}', 'action': True},
160 spiinterface_decl
= Interface([{'name': 'sclk_{0}', 'action': True},
161 {'name': 'mosi_{0}', 'action': True},
162 {'name': 'ss_{0}', 'action': True},
163 {'name': 'miso_{0}'},
166 twiinterface_decl
= Interface([{'name': 'sda{0}', 'outen': True},
167 {'name': 'scl{0}', 'outen': True},
170 sdinterface_decl
= Interface([{'name': 'sd{0}_clk', 'action': True},
171 {'name': 'sd{0}_cmd', 'action': True},
172 {'name': 'sd{0}_d0', 'outen': True},
173 {'name': 'sd{0}_d1', 'outen': True},
174 {'name': 'sd{0}_d2', 'outen': True},
175 {'name': 'sd{0}_d3', 'outen': True}
178 jtaginterface_decl
= Interface([{'name': 'jtag{0}_tdi'},
179 {'name': 'jtag{0}_tms'},
180 {'name': 'jtag{0}_tclk'},
181 {'name': 'jtag{0}_trst'},
182 {'name': 'jtag{0}_tdo', 'action': True}])
184 pwminterface_decl
= Interface([{'name': "pwm{0}", 'action': True}])
186 # ======================================= #
189 if __name__
== '__main__':
191 def _pinmunge(p
, sep
, repl
, dedupe
=True):
192 """ munges the text so it's easier to compare.
193 splits by separator, strips out blanks, re-joins.
198 p
= filter(lambda x
: x
, p
) # filter out blanks
202 """ munges the text so it's easier to compare.
204 # first join lines by semicolons, strip out returns
206 p
= map(lambda x
: x
.replace('\n', ''), p
)
208 # now split first by brackets, then spaces (deduping on spaces)
209 p
= _pinmunge(p
, "(", " ( ", False)
210 p
= _pinmunge(p
, ")", " ) ", False)
211 p
= _pinmunge(p
, " ", " ")
214 from interface_def
import io_interface_def
215 print io_interface_def
.format(0)
216 print io_interface
.ifacedef(0)
217 assert io_interface_def
.format(0) == io_interface
.ifacedef(0)
219 mux_interfacetest
= '''
220 method Action cell{0}_mux(Bit#({1}) in);'''
221 print pinmunge(mux_interfacetest
.format(0,1))
222 print pinmunge(mux_interface
.ifacefmt(0, 1))
223 from interface_def
import mux_interface_def
224 print repr(mux_interface_def
.format(0, 1))
225 print repr(mux_interface
.ifacedef(0, 1))
226 assert mux_interface_def
.format(0,1) == mux_interface
.ifacedef(0,1)