themperek/apbi2c_cocotb_example

An example Python-based MDV testbench for apbi2c core

This is an example testbench using the cocotb framework with cocotb-coverage extension for the apbi2c controller verification from FreeCores. The intention is to present advanced metric-driven and constrained-random functional verification techniques using a pure Python-based implementation. No support of hardware verification languages such as e or SystemVerilog is required, which enables the use of an arbitrary basic HDL simulator for the entire verification process.

• cocotb documentation http://cocotb.readthedocs.org
• cocotb-coverage documentation http://cocotb-coverage.readthedocs.org
• Freecores repository http://freecores.github.io

This testbench is used as an example in the Article published in Journal of Electronic Testing.

To run the example you need to install the cocotb and cocotb-coverage pip packages.

To download the example code with the apbi2c controller submodule, use

git clone --recurse-submodules https://github.com/mciepluc/apbi2c_cocotb_example.git

The testbench contains all important parts of an advanced verification environment:

• external interface agents (for APB and I2C, in files apb.py and i2c.py),
• functional coverage as a verification plan (coverage.py),
• simple data integrity checking between interfaces (elementary scoreboarding),
• test sequences (for I2C read, I2C write and APB R/W operations),
• constrained randomization (for generating sequences),
• coverage-driven test scenario adjustment.

Additionally, the testbench presents the idea of checkpointing, which is storing a specific simulation state of the DUT, to be used later as a new starting point of the following test sequences. This option can be disabled (global variables ENABLE_CHECKPOINTS and CHECKPOINTS_TREE_STRUCTURE in tb/test_i2c.py) as it may not work properly under all simulation platforms.

There are a number of issues with the apbi2c controller, discovered with this testbench. The test completes successfully only with the checkpointing option enabled, as this prevents from continuing operation of the DUT at lock-up state. There are a number of errors discovered, such as:

• problems with APB read operations ('x' on the interface),
• incorrect handling of I2C read operations (probably the controller does not recognize a start bit correctly),
• not all clock divider settings are working correctly,
• FIFO overflow is not reported.