v0.0.31

switchboard 0.0.31 (2023-12-05)

Major:

• Switchboard can now be installed from PyPI: pip install switchboard-hw

v0.0.17: switchboard 0.0.17 SB-447 SB-450 SB-451 SB-452 (#100)

Updates:

• New umi_loopback() function that sends a sequence of UMI packets into a block and checks that the sequence coming back is equivalent under the split/merge rules. This can be used for testing UMI packet splitters, packet aggregators, etc. The simplest way to use it is with umi_loopback(umi, N), where umi is a UmiTxRx object and N is the number of packets to send, which are generated randomly with random_umi_packet. You can also pass in your own sequence of packets to send with umi_loopback(umi, LIST_OF_UMI_PACKETS). To see an example, check out examples/umi_fifo_flex/test.py.
• Address alignment: random_umi_packet generates properly aligned addresses, and read/write check that addresses are aligned.
• max_bytes parameter in random_umi_packet: if you pass the optional max_bytes parameter to random_umi_packet, it will not return packets with more than that number of data bytes. For example, you could set max_bytes=16 if you want to generate packets that can be sent with a 128b data bus.
• There is a new method, merge() available on UMI packets. For example, if you have two PyUmiPacket objects, p and other, you can call p.merge(other), which will merge other into p according to the UMI merge rules. The method returns True if successful and False otherwise (in which case the merge is not performed).
• The == and != operators are now implemented for PyUmiPacket objects. This makes it easier to implement some kinds of tests - to see one example, check out examples/umi_fifo/test.py.

Tag version used for November 2022 tapeout

Merge pull request #26 from zeroasiccorp/umi_new

remove unintentional submodule

tools

This is not a true release, but rather a place to store binaries for tools used for CI testing - particularly those that can't be installed via apt-get. In the future, we might want to think about creating a Docker container with verification tools, since that would be useful for both CI testing and local development.