mirror of
https://github.com/corundum/corundum.git
synced 2025-01-16 08:12:53 +08:00
337 lines
11 KiB
Python
337 lines
11 KiB
Python
"""
|
|
|
|
Copyright (c) 2014 Alex Forencich
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
in the Software without restriction, including without limitation the rights
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
all copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
THE SOFTWARE.
|
|
|
|
"""
|
|
|
|
from myhdl import *
|
|
|
|
skip_asserts = False
|
|
|
|
class AXIStreamFrame(object):
|
|
def __init__(self, data=b'', keep=None, user=None):
|
|
self.B = 0
|
|
self.N = 8
|
|
self.M = 1
|
|
self.WL = 8
|
|
self.data = b''
|
|
self.keep = None
|
|
self.user = None
|
|
|
|
if type(data) is bytes or type(data) is bytearray:
|
|
self.data = bytearray(data)
|
|
elif type(data) is AXIStreamFrame:
|
|
self.N = data.N
|
|
self.WL = data.WL
|
|
if type(data.data) is bytearray:
|
|
self.data = bytearray(data.data)
|
|
else:
|
|
self.data = list(data.data)
|
|
if data.keep is not None:
|
|
self.keep = list(data.keep)
|
|
if data.user is not None:
|
|
if type(data.user) is int or type(data.user) is bool:
|
|
self.user = data.user
|
|
else:
|
|
self.user = list(data.user)
|
|
else:
|
|
self.data = list(data)
|
|
|
|
def build(self):
|
|
if self.data is None:
|
|
return
|
|
|
|
f = list(self.data)
|
|
tdata = []
|
|
tkeep = []
|
|
tuser = []
|
|
i = 0
|
|
|
|
assert_tuser = False
|
|
if (type(self.user) is int or type(self.user) is bool) and self.user:
|
|
assert_tuser = True
|
|
self.user = None
|
|
|
|
if self.B == 0:
|
|
while len(f) > 0:
|
|
data = 0
|
|
keep = 0
|
|
for j in range(self.M):
|
|
data = data | (f.pop(0) << (j*self.WL))
|
|
keep = keep | (1 << j)
|
|
if len(f) == 0: break
|
|
tdata.append(data)
|
|
if self.keep is None:
|
|
tkeep.append(keep)
|
|
else:
|
|
tkeep.append(self.keep[i])
|
|
if self.user is None:
|
|
tuser.append(0)
|
|
else:
|
|
tuser.append(self.user[i])
|
|
i += 1
|
|
else:
|
|
# multiple tdata signals
|
|
while len(f) > 0:
|
|
data = 0
|
|
tdata.append(f.pop(0))
|
|
tkeep.append(0)
|
|
if self.user is None:
|
|
tuser.append(0)
|
|
else:
|
|
tuser.append(self.user[i])
|
|
i += 1
|
|
|
|
if assert_tuser:
|
|
tuser[-1] = 1
|
|
self.user = 1
|
|
|
|
return tdata, tkeep, tuser
|
|
|
|
def parse(self, tdata, tkeep, tuser):
|
|
if tdata is None or tkeep is None or tuser is None:
|
|
return
|
|
if len(tdata) != len(tkeep) or len(tdata) != len(tuser):
|
|
raise Exception("Invalid data")
|
|
|
|
self.data = []
|
|
self.keep = []
|
|
self.user = []
|
|
|
|
if self.B == 0:
|
|
mask = 2**self.WL-1
|
|
|
|
for i in range(len(tdata)):
|
|
for j in range(self.M):
|
|
if tkeep[i] & (1 << j):
|
|
self.data.append((tdata[i] >> (j*self.WL)) & mask)
|
|
self.keep.append(tkeep[i])
|
|
self.user.append(tuser[i])
|
|
else:
|
|
for i in range(len(tdata)):
|
|
self.data.append(tdata[i])
|
|
self.keep.append(tkeep[i])
|
|
self.user.append(tuser[i])
|
|
|
|
if self.WL == 8:
|
|
self.data = bytearray(self.data)
|
|
|
|
def __eq__(self, other):
|
|
if type(other) is AXIStreamFrame:
|
|
return self.data == other.data
|
|
|
|
def __repr__(self):
|
|
return 'AXIStreamFrame(data=%s, keep=%s, user=%s)' % (repr(self.data), repr(self.keep), repr(self.user))
|
|
|
|
def __iter__(self):
|
|
return self.data.__iter__()
|
|
|
|
def AXIStreamSource(clk, rst,
|
|
tdata=None,
|
|
tkeep=Signal(bool(True)),
|
|
tvalid=Signal(bool(False)),
|
|
tready=Signal(bool(True)),
|
|
tlast=Signal(bool(False)),
|
|
tuser=Signal(bool(False)),
|
|
fifo=None,
|
|
pause=0,
|
|
name=None):
|
|
|
|
tready_int = Signal(bool(False))
|
|
tvalid_int = Signal(bool(False))
|
|
|
|
@always_comb
|
|
def pause_logic():
|
|
tready_int.next = tready and not pause
|
|
tvalid.next = tvalid_int and not pause
|
|
|
|
@instance
|
|
def logic():
|
|
frame = AXIStreamFrame()
|
|
data = []
|
|
keep = []
|
|
user = []
|
|
B = 0
|
|
N = len(tdata)
|
|
M = len(tkeep)
|
|
WL = int((len(tdata)+M-1)/M)
|
|
|
|
if type(tdata) is list or type(tdata) is tuple:
|
|
# multiple tdata signals
|
|
B = len(tdata)
|
|
N = [len(b) for b in tdata]
|
|
M = 1
|
|
WL = [1]*B
|
|
|
|
while True:
|
|
yield clk.posedge, rst.posedge
|
|
|
|
if rst:
|
|
if B > 0:
|
|
for s in tdata:
|
|
s.next = 0
|
|
else:
|
|
tdata.next = 0
|
|
tkeep.next = 0
|
|
tvalid_int.next = False
|
|
tlast.next = False
|
|
else:
|
|
if tready_int and tvalid:
|
|
if len(data) > 0:
|
|
if B > 0:
|
|
l = data.pop(0)
|
|
for i in range(B):
|
|
tdata[i].next = l[i]
|
|
else:
|
|
tdata.next = data.pop(0)
|
|
tkeep.next = keep.pop(0)
|
|
tuser.next = user.pop(0)
|
|
tvalid_int.next = True
|
|
tlast.next = len(data) == 0
|
|
else:
|
|
tvalid_int.next = False
|
|
tlast.next = False
|
|
if (tlast and tready_int and tvalid) or not tvalid_int:
|
|
if not fifo.empty():
|
|
frame = fifo.get()
|
|
frame = AXIStreamFrame(frame)
|
|
frame.B = B
|
|
frame.N = N
|
|
frame.M = M
|
|
frame.WL = WL
|
|
data, keep, user = frame.build()
|
|
if name is not None:
|
|
print("[%s] Sending frame %s" % (name, repr(frame)))
|
|
if B > 0:
|
|
l = data.pop(0)
|
|
for i in range(B):
|
|
tdata[i].next = l[i]
|
|
else:
|
|
tdata.next = data.pop(0)
|
|
tkeep.next = keep.pop(0)
|
|
tuser.next = user.pop(0)
|
|
tvalid_int.next = True
|
|
tlast.next = len(data) == 0
|
|
|
|
return logic, pause_logic
|
|
|
|
|
|
def AXIStreamSink(clk, rst,
|
|
tdata=None,
|
|
tkeep=Signal(bool(True)),
|
|
tvalid=Signal(bool(True)),
|
|
tready=Signal(bool(True)),
|
|
tlast=Signal(bool(True)),
|
|
tuser=Signal(bool(False)),
|
|
fifo=None,
|
|
pause=0,
|
|
name=None):
|
|
|
|
tready_int = Signal(bool(False))
|
|
tvalid_int = Signal(bool(False))
|
|
|
|
@always_comb
|
|
def pause_logic():
|
|
tready.next = tready_int and not pause
|
|
tvalid_int.next = tvalid and not pause
|
|
|
|
@instance
|
|
def logic():
|
|
frame = AXIStreamFrame()
|
|
data = []
|
|
keep = []
|
|
user = []
|
|
B = 0
|
|
N = len(tdata)
|
|
M = len(tkeep)
|
|
WL = int((len(tdata)+M-1)/M)
|
|
first = True
|
|
|
|
if type(tdata) is list or type(tdata) is tuple:
|
|
# multiple tdata signals
|
|
B = len(tdata)
|
|
N = [len(b) for b in tdata]
|
|
M = 1
|
|
WL = [1]*B
|
|
|
|
while True:
|
|
yield clk.posedge, rst.posedge
|
|
|
|
if rst:
|
|
tready_int.next = False
|
|
frame = AXIStreamFrame()
|
|
data = []
|
|
keep = []
|
|
user = []
|
|
first = True
|
|
else:
|
|
tready_int.next = True
|
|
|
|
if tvalid_int:
|
|
|
|
if not skip_asserts:
|
|
# zero tkeep not allowed
|
|
assert int(tkeep) != 0
|
|
# tkeep must be contiguous
|
|
# i.e. 0b00011110 allowed, but 0b00011010 not allowed
|
|
b = int(tkeep)
|
|
while b & 1 == 0:
|
|
b = b >> 1
|
|
while b & 1 == 1:
|
|
b = b >> 1
|
|
assert b == 0
|
|
# tkeep must not have gaps across cycles
|
|
if not first:
|
|
# not first cycle; lowest bit must be set
|
|
assert int(tkeep) & 1
|
|
if not tlast:
|
|
# not last cycle; highest bit must be set
|
|
assert int(tkeep) & (1 << len(tkeep)-1)
|
|
|
|
if B > 0:
|
|
l = []
|
|
for i in range(B):
|
|
l.append(int(tdata[i]))
|
|
data.append(l)
|
|
else:
|
|
data.append(int(tdata))
|
|
keep.append(int(tkeep))
|
|
user.append(int(tuser))
|
|
first = False
|
|
if tlast:
|
|
frame.B = B
|
|
frame.N = N
|
|
frame.M = M
|
|
frame.WL = WL
|
|
frame.parse(data, keep, user)
|
|
if fifo is not None:
|
|
fifo.put(frame)
|
|
if name is not None:
|
|
print("[%s] Got frame %s" % (name, repr(frame)))
|
|
frame = AXIStreamFrame()
|
|
data = []
|
|
keep = []
|
|
user = []
|
|
first = True
|
|
|
|
return logic, pause_logic
|
|
|