Verification Academy

Cookbook
Online Methodology Documentation from the Mentor Graphics Verification Methodology Team Contact [email protected]

http://verificationacademy.com

Table of Contents
Articles
Coverage/Block Level Functional Coverage Example 1

Datestamp:
- This document is a snapshot of dynamic content from the Online Methodology Cookbook - Created from http://verificationacademy.com/uvm-ovm on Tue, 20 Nov 2012 07:57:35 UTC

Coverage/Block Level Functional Coverage Example

Coverage/Block Level Functional Coverage Example

Block level functional verification can take full advantage of the the fact that all the block interfaces are exposed and can be stimulated seperately with complete freedom. The desired outcome of the verification process is that the block has been thoroughly tested so that it can reused at a higher level of integration with complete confidence. The functional coverage model is part of the instrumentation used to determine whether the design has been verified to the desired level of quality. The block level design example is a UART, which contains contains registers which allow the DUTto be configured for its different modes of operation, and can also be used to get status information. The UART is verified using a UVMblock level testbench, which contains a UVMregister model.

UARTOverview
The function of an Universal Aysynchronous Receiver Transmitter (UART) is to transmit and receive characters of differing formats over a pair of serial lines asynchronously. With an asynchronous serial link, there is no shared sampling clock, instead the receive channel samples the incoming serial data stream with a clock that is 16x the data rate. When there is no data to transmit the data lines are held high, and transmission of a data character commences by taking the data line low for one bit period to transmit the start bit. The receiving end detects the start bit and then samples and unpacks the serial data stream that can consist of between 5 and 8 bits of data, parity and then a stop bit which is always a 1.

Register Map
The UART design in this example is based on the industry standard 16550a UART. It has 10 registers which control its operation and in a system these are used by software to control the device and to send and receive characters. The transmit and receive paths are buffered with 16 word deep FIFOs. The register map is summarised here:

UVM/OVM Documentation - Copyright (c) 2012 Mentor Graphics Corporation - http://verificationacademy.com/uvm-ovm

Coverage/Block Level Functional Coverage Example

Register Receive Buffer Transmit Buffer Interrupt Enable (IER)

Address Offset 0x0 0x0 0x4

Width 8 8 8 8 8 8 8 8 8 8 8

Access R W R/W R W R/W R/W R R R/W R/W

Description Receive data FIFOoutput Transmit data FIFO input Enables for UARTinterrupts Interrupt status Set receive data FIFOthresholds Sets the format of the UARTdata word Used to control the modem interface outputs Transmit and receive channel status Used to monitor the modem interface inputs LSB of the 16 bit divider MSBof the 16 bit divider

Interrupt Identification (IIR) 0x8 FIFOControl (FCR) Line Control (LCR) Modem Control (MCR) Line Status (LSR) Modem Status (MSR) Divisor 1 Divisor 2 0x8 0xC 0x10 0x14 0x18 0x1C 0x20

For the UVMtestbench, a UVMregister model will be written to abstract stimulus for configuring and controlling the operation of the UART. One benefit of using this register model is that we can reference it for the functional coverage model. For more details on the UART functionality and the detailed register map, please refer to the datasheet.

External Interfaces
The UARTblock has a number of discrete interfaces which need to be driven or monitored. The UART example testbench is implemented using UVM, therefore the driving and monitoring of these interfaces will be done by Universal Verification Components (UVCs) or agents. If the testbench was implemented using another methodology, then BFM or BFM-like models would be used. However, the principles of how you model and collect coverage are essentially the same. The UART has the following external interfaces which will need to be driven and monitored in the testbench. APB Host interface Requires an APB agent TX Serial line Requires a passive UART agent RX Serial line Requires an active UART agent Modem interface Requires a simple parallel I/O agent Interrupt line Requires a monitor

UVM/OVM Documentation - Copyright (c) 2012 Mentor Graphics Corporation - http://verificationacademy.com/uvm-ovm

Coverage/Block Level Functional Coverage Example

Testbench Architecture
The UVM testbench architecture used for this example is shown in the block diagram.

An outline functional test plan for the UART has been created as part of the process of mapping its features to test cases and functional coverage.

Designing The Functional Coverage Model

The purpose of the functional coverage model is to ensure that all the functional test cases simulated with the testbench put the design under test into all of the conditions that are considered to be interesting. The functional coverage model is based on the functionality of the design and is closely related to the way in which the testbench works since it will be relying on data coming from the testbench components and it will be relying on testbench events to sample. The design of the functional coverage model for the UARTwill be discussed in terms of each area of concern within the device. In each case, the necessary tests are considered first, then the functional coverage model required in order to ensure that all conditions have been seen to be tested. Example implementations of the covergroups for each part of the functional coverage model are described separately and are available in the example UART testbench.

UVM/OVM Documentation - Copyright (c) 2012 Mentor Graphics Corporation - http://verificationacademy.com/uvm-ovm

Coverage/Block Level Functional Coverage Example

The Transmit Channel

Testing the transmit channel
The transmit channel needs to be verified by checking that it transmits the correct serially formatted data for each of the possible word formats, this requires the stimulus to configure the design and then to send data by filling the transmit buffer. The UART agent will interpret the transmitted serial stream according to the configuration of the device and send out analysis transactions on reception of a character. The monitor in the UARTagent will perform low level format and parity error checks on the serial data and flag errors if they are detected since it has access to the clock and data signals. If the UART is working correctly, the transmit data path should be error free, there is no scope for the testbench to introduce errors. In order to check that the transmit channel is working correctly we can compare the content of the analysis transaction written by the passive UART monitor when a character is received with the character originally written to the transmit buffer of the UART. This implies scoreboard analysis connections to the UART agent and the APB agent. The UART transmit buffer writes will have to be buffered in a FIFO structure in the scoreboard so that they can be compared with the characters received by the UART. The transmit channel has two buffer status bits (TX empty and TX FIFO empty) which are read back from the Line Status Register, these need to be tested by the stimulus generation path. There is also a TX FIFO empty status interrupt which will be discussed in the section on interrupts.

Functional coverage design for the transmit channel

As the testbench checks that the UARTtransmits serial data correctly, the role of the functional coverage model is to check that each of the word formats has been configured and seen to work correctly. The word format is determined by the contents of the Line Control Register (LCR), therefore the functional coverage model needs to sample the LCRvalues every time a character is transmitted. There are 6 bits in the LCRregister which determine the word format and these are:
LCRBit Field [1:0] 2 [5:3] Function Selects 5,6,7 or 8 bit data Selects 1 or 2 stop bits Enables parity and type of parity

We need to see all possible permutations of these configuration settings in order to say that we have achieved functional coverage for the transmit channel. An example implementation of the SystemVerilog covergroup used to collect this functional coverage is implemented in the example UARTtestbench. Transmit channel coverage summary

UVM/OVM Documentation - Copyright (c) 2012 Mentor Graphics Corporation - http://verificationacademy.com/uvm-ovm

Coverage/Block Level Functional Coverage Example

Coverage Criterion Which values are important?

Transmit Channel Coverage LCR[5:0] - defining all permutations of UART serial word format

What are the dependencies between the values? No dependencies Are there illegal conditions? When is the right time to sample? When is the data invalid? No, all permutations are valid When a character has been transmitted N/A

The Receive Channel

Testing the receive channel
The testbench drives a serial data stream into the UARTusing an active UARTagent. An active agent is a verification component that drives the receive serial data line based on stimulus transactions and monitors the state of the line, converting pin level activity back to transactions. The receive channel has to be able to cope with errors that might be present in the format of the incoming serial data stream, this calls for positive and negative checking of the receive channel and the UARTagents driver is able to insert bit level errors and its monitor is able to detect them. The checking mechanism used by the receive scoreboard is to compare the data sent by the UARTagent with the data read from the receive buffer of the UART device. Any errors inserted by the UARTagent need to be seen to be detected by the design either as bits set in the Line Status Register (LSR) or by the generation of a line status interrupt. The checks that need to be made by the testbench for the receive channel include: That a start bit is detected correctly That parity has been received correctly - if not a parity error is generated That at least one stop bit has been received - if not a framing error is generated That a data overrun condition is detected correctly That the data received flag works correctly That a break condition is detected correctly

There are a number of receive channel interrupt conditions that are considered in the section on interrupts.

Functional coverage design for the receive channel

The functional coverage model for the receive channel needs to collect functional coverage for error free conditions and then for each of the possible error or special conditions. The word format for the receive channel is configured via the LCR and so for error free character formats the same covergroup design as was developed for the transmit channel can be used, except that it would be sampled when a data character is read from the receive buffer of the UART. For the various error conditions, a separate covergroup is used and this would cross the parity error, framing error, overrun error and break condition bits from the Line Status Register (LSR)with the word format bits in the LCR. This ensures that all possible error or special conditions have been detected with all word formats. Example implementations of these covergroups are present in the example UART testbench.

UVM/OVM Documentation - Copyright (c) 2012 Mentor Graphics Corporation - http://verificationacademy.com/uvm-ovm

Coverage/Block Level Functional Coverage Example Receive channel coverage summary

Coverage Criterion Which values are important? Receive Channel Coverage LCR[5:0] - defining all permutations of the UARTserial word format LSR[4:0] - Status bits for Break Interrupt (BI), Framing Error (FE), Parity Error (PE), Overrun Error (OE) and Data Received (DR)

What are the dependencies between the values? For error free RX conditions DR and all word formats For injected error RX, cross product of LCR &LSRbits Are there illegal conditions? When is the right time to sample? When is the data invalid? Cannot have OEwith no DR valid When a RX character has been received and DR is valid N/A

The Modem Interface

Testing the modem interface
The modem interface is a group of 4 input and 4 output signals which are used to implement hardware handshaking between two UARTs. In some UART designs these lines have a hardware interlock with the UART state machines to enable/disable transmission and reception of data, but this is not the case with this UART design. The modem outputs are driven as a result of a write to the Modem Control Register (MCR) and changes to the modem inputs are read back from the Modem Status Register (MSR). There is a loop-back mode which also needs to be checked. In this mode writes to the MCR are reflected back in the MSR and none of the external signals change or cause any changes. The modem scoreboard checks this functionality separately from the normal mode of operation. The testbench contains a modem agent that has a driver for the modem inputs and a monitor which sends transactions to the modem scoreboard when any of the modem signals (inputs or outputs) change. The scoreboard also receives transactions from the APB agent's monitor so that it can keep track of UART register accesses, this allows it to know when a modem output should have changed due to a write to the MCR and when a modem input change should be reflected in a read from the MSR.

Functional coverage design for the modem interface

The modem scoreboard checks that the modem interface works correctly, and in overall terms this includes the path between the modem registers and the modem signals. For the modem outputs, all possible output signal combinations need to be observed with or without loopback, this means that the contents of the MCRcan be sampled when they are written by the testbench. The functional coverage required consists of all permutations of the signal conditions. The modem inputs are read back from the MSR, there are four signal sample values and four signal change values which need to be seen to have been read back in all possible states. The loopback bit affects whether the MSRvalues are derived from the modem interface signals or the MCR signals, so this needs to be part of the coverage model. The modem input coverage model is sampled when the MSRis read, and the coverage required is a cross product of all possible values for the MSRplus the value of the MCRloopback bit.

UVM/OVM Documentation - Copyright (c) 2012 Mentor Graphics Corporation - http://verificationacademy.com/uvm-ovm

Coverage/Block Level Functional Coverage Example Example implementations of these coverage models are present in the uart_modem_coverage_monitor in the example UARTtestbench. Modem interface coverage summary
Coverage Criterion Which values are important? Modem Interface Coverage MCR[4:0] - Controlling outputs and loopback mode MSR[7:0] - input status and changes to input values

What are the dependencies between the values? Each of the modem signals are orthogonal, but the loopback mode creates a dependency between the MCR bits and the MSRbits. For coverage all permutations are relevant. Are there illegal conditions? When is the right time to sample? No When a change occurs on the Modem interface, or there is a write to the MCR, determined by the modem scoreboard. Immediately after a change in the loopback mode, handled by the scoreboard

When is the data invalid?

UARTInterrupts
Testing UARTinterrupts
The testbench contains a monitor for the UART interrupt line and some of the test cases have stimulus which enables the various interrupts and then handles the interrupt conditions as they occur. The scoreboarding within the testbench checks the validity of the interrupt conditions dependent on its source. Interrupts can be generated by the UARTfor the following conditions: Transmit FIFO empty Receive data FIFOthreshold reached (1, 4, 8, 14 characters) Receiver line status - Parity error, Framing error or Break condition Receiver timeout - At least one character in the FIFO, but no receive channel activity for at least 4 character times Modem status change

Functional coverage design for the UARTinterrupts

There are several areas where functional coverage needs to be collected. The first concerns checking that all possible combinations of interrupt enables and interrupt sources have been tested. The Interrupt Enable Register (IER) is a four bit register which is used to enable the different interrupt types, when an interrupt occurs this needs to be sampled for all possible active states - i.e. at least one interrupt is enabled. If an interrupt occurs with no active enables, then this is an error condition. The Interrupt Identification Register (IIR) prioritizes active interrupt status. The value of this register needs to be sampled when an interrupt occurs followed by a read to the IIR. All IIRvalues need to be observed, but which ones are observable at any point in time is determined by interrupt priority and the content of the IER. Therefore, the IIRstatus codes need to be crossed with the IER values, but filtered for conditions that cannot occur - for instance a receive status interrupt will not occur unless the receive status interrupt is enabled.

UVM/OVM Documentation - Copyright (c) 2012 Mentor Graphics Corporation - http://verificationacademy.com/uvm-ovm

Coverage/Block Level Functional Coverage Example The receiver FIFOthreshold level interrupt needs to have been seen to occur for the four possible values of the receive FIFO threshold, crossed with all the possible word formats. This covergroup needs to be sampled when a receive FIFO threshold interrupt occurs. The receive line status interrupt has several potential sources, the functional coverage for this needs to be sampled when a line status interrupt occurs. The data that needs to be sampled is the Line Status for Parity errors, Framing errors, Overrun errors or break condition, together with the FIFOerror bit, these bits need to be crossed, but with some illegal conditions filtered - for instance a line status interrupt with no active line status bits repesents an error, or a break condition will invalidate the parity and framing errors. The transmitter empty interrupt should be checked for all possible word formats. The modem status interrupt can come from one of the four signal change detected bits of the MSR. These bits are crossed for all permutations, and also with the MCRloopback bit. The modem status interrupt source covergroup is sampled when a modem status interrupt occurs. Example implementations of covergroups used to capture functional coverage for the UART Interrupts can be found here. UARTinterrupt coverage summary
Interrupt handling Coverage Criterion Which values are important? UART interrupt coverage summary IER[3:0] - Enables for the four sources of interrupts IIR[[3:0] - Identifying the interrupt source

What are the dependencies between the values? Interrupts should only occur if they are enabled Need to see all valid permutations of interrupt enables and interrupt sources Are there illegal conditions? When is the right time to sample? Invalid conditions are interrupt sources reported when an interrupt type is not enabled For the interrupt enables, when an interrupt occurs. For interrupt ids, when an interrupt occurs, followed by a read from the IIRregister N/A

When is the data invalid?

Receiver FIFOThreshold Interrupt Coverage Criterion Which values are important? UART interrupt coverage summary LCR[5:0] - Definining the different word formats FC[7:6] - Defining the different FIFOthreshold values

What are the dependencies between the values? Need a cross between the LCR and FCR bits to ensure that FIFOthreshold interrupts have occurred for all possible permutations. Are there illegal conditions? When is the right time to sample? When is the data invalid? None When an RXFIFOthreshold interrupt occurs N/A

UVM/OVM Documentation - Copyright (c) 2012 Mentor Graphics Corporation - http://verificationacademy.com/uvm-ovm

Coverage/Block Level Functional Coverage Example

Receiver Line Status Interrupt Coverage Criterion Which values are important? UART interrupt coverage summary LSR[4:1] - Defining the different types of RXline status

What are the dependencies between the values? None, each status bit has a distinct source Are there illegal conditions? When is the right time to sample? When is the data invalid? When the break condition occurs, PE and FE are not valid When a line status interrupt occurs, followed by a read from the LSR N/A

Transmitter Empty Interrupt Coverage Criterion Which values are important? UART interrupt coverage summary LCR[5:0] - Defining the UARTserial format

What are the dependencies between the values? Cross product defining all permutations of the word format Are there illegal conditions? When is the right time to sample? When is the data invalid? None When a TXempty interrupt occurs, followed by a read from the LSR N/A

Modem Status Interrupt Coverage Criterion Which values are important? UART interrupt coverage summary MSR[3:0] - The modem i/p signal change flags

What are the dependencies between the values? None, each signal is orthogonal Are there illegal conditions? When is the right time to sample? When is the data invalid? None When a modem status interrupt occurs, followed by a read from the MSR The MSRflags are reset on read, so a second read will return invalid status

Baud Rate Divisor

Testing the baud rate divisor
The UART serial stream is sampled at 16x the data rate. Inside the UART there is a 16 bit divider which divides down the APB PCLK to generate the 16x data rate clock. It is important to check that data can be received and transmitted correctly at different data rates, but it would take too long to check all functionality at all the possible divider values (i.e. 2**16 (65536)). The larger the divider value, the slower the data rate, so most of the UART functionality is tested at a high data rate in order to save simulation time. The UART has a data rate divider output BAUD_O. This can be checked at different rates separately from checking the rest of the UART functionality using a specialised checker component that looks at this signal and the APB PCLK counting the interval between BAUD_O transitions. The component also receives APB bus analysis transactions so that it can determine when the divider values are changed. Functional coverage for the divider can be collected inside this component.

UVM/OVM Documentation - Copyright (c) 2012 Mentor Graphics Corporation - http://verificationacademy.com/uvm-ovm

Coverage/Block Level Functional Coverage Example

10

Functional coverage design for the baud rate divisor

The baud rate divisor can have 65536 possible values, it is unnecessary to check that all of them work. However, a number of strategic values should be chosen to ensure that specific corner cases have been seen to work. Exactly which values are important is dependent on the implementation of the divider, but what we know is that the divider value is programmed via two 8 bit registers. The covergroup is sampled on each BAUD_O transition. If we knew the frequency of the APB PCLK in the target application we could also target the divider ratios for the standard Baud rates such as 1200, 2400, 4800, 9600, 14400, 19200, 38400, 57600 and 115200 bits per second. Baud rate divisor coverage summary
Coverage Criterion Which values are important? Receive Channel Coverage DIV1 and DIV2 register contents, potentially all possible values

What are the dependencies between the values? DIV1 & DIVare concatonated, otherwise no dependencies Are there illegal conditions? When is the right time to sample? When is the data invalid? The divider cannot have a value of 0 On the rising edge of the BAUD_O signal If the divider registers are being programmed, or have just been programmed in which case the divide ratio will not match the register content (this is not an error)

Register Interface
Testing the register interface
The register interface is implicitly tested by the functional stimulus for each of the various test cases. There is a specific test case to check that the register reset values are correct.

Functional coverage design for the register interface

In order to check that all possible register accesses have taken place, a cross of the register addresses and the value of the read/write bit is used. The register access covergroup is sampled at the end of each register transfer. Registers which are read only or write only are excluded from the cross for write and read accesses. This type of register interface coverage is often generated automatically by register generators. Register interface coverage summary

UVM/OVM Documentation - Copyright (c) 2012 Mentor Graphics Corporation - http://verificationacademy.com/uvm-ovm

Coverage/Block Level Functional Coverage Example

11

Coverage Criterion Which values are important?

Receive Channel Coverage Address bits [7:0] and read/write bit Only interested in valid register addresses

What are the dependencies between the values? Need to cross the valid addresses with the read/write bit to get the register access space Are there illegal conditions? When is the right time to sample? When is the data invalid? The MSR and LSR registers are read only, so writes to these registers are invalid When an APBbus transaction completes N/A

UVM/OVM Documentation - Copyright (c) 2012 Mentor Graphics Corporation - http://verificationacademy.com/uvm-ovm

Verification Academy

Cookbook

For the latest product information, call us or visit:

www.mentor.com

2012-13 Mentor Graphics Corporation, all rights reserved. This document contains information that is proprietary to Mentor Graphics Corporation and may be duplicated in whole or in part by the original recipient for internal business purposes only, provided that this entire notice appears in all copies. In accepting this document, the recipient agrees to make every reasonable effort to prevent unauthorized use of this information. All trademarks mentioned are this document are trademarks of their respective owners.
Corporate Headquarters Mentor Graphics Corporation 8005 SW Boeckman Road Wilsonville, OR 97070-7777 Phone: 503.685.7000 Fax: 503.685.1204 Sales and Product Information Phone: 800.547.3000 Silicon Valley Mentor Graphics Corporation 46871 Bayside Parkway Fremont, California 94538 USA Phone: 510.354.7400 Fax: 510.354.1501 North American Support Center Phone: 800.547.4303 Europe Mentor Graphics Deutschland GmbH Arnulfstrasse 201 80634 Munich Germany Phone: +49.89.57096.0 Fax: +49.89.57096.400 Pacific Rim Mentor Graphics (Taiwan) Room 1001, 10F International Trade Building No. 333, Section 1, Keelung Road Taipei, Taiwan, ROC Phone: 886.2.87252000 Fax: 886.2.27576027 Japan Mentor Graphics Japan Co., Ltd. Gotenyama Garden 7-35, Kita-Shinagawa 4-chome Shinagawa-Ku, Tokyo 140-0001 Japan Phone: +81.3.5488.3030 Fax: +81.3.5488.3021