""" 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 * 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) 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 = [] else: tready_int.next = True if tvalid_int: 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)) 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 = [] return logic, pause_logic