IEC 62530-2:2021

SystemVerilog - Part 2: Universal Verification Methodology Language Reference Manual

IEC 62530-2:2021(E) establishes the Universal Verification Methodology (UVM), a set of application programming
interfaces (APIs) that defines a base class library (BCL) definition used to develop modular, scalable, and reusable components for functional verification environments. The APIs and BCL are based on the IEEE standard for SystemVerilog, IEEE Std 1800™. This publication has the status of a double logo IEC/IEEE standard.

General Information

• Status: Published
• Publication Date: 25-Jul-2021
• ICS: 25.040.01 - Industrial automation systems in general
• ICS: 35.060 - Languages used in information technology
• Technical Committee: TC 91 - Electronics assembly technology
• Current Stage: PPUB - Publication issued
• Completion Date: 26-Jul-2021

Standards Content (sample)

IEC 62530-2
Edition 1.0 2021-07
IEEE Std 1800.2
INTERNATIONAL
STANDARD
SystemVerilog –
Part 2: Universal Verification Methodology Language Reference Manual
IEC 62530-2:2021-07(en) IEEE Std 1800.2-2017
---------------------- Page: 1 ----------------------
THIS PUBLICATION IS COPYRIGHT PROTECTED
Copyright © 2017 IEEE

All rights reserved. IEEE is a registered trademark in the U.S. Patent & Trademark Office, owned by the Institute of

Electrical and Electronics Engineers, Inc. Unless otherwise specified, no part of this publication may be reproduced

or utilized in any form or by any means, electronic or mechanical, including photocopying and microfilm, without

permission in writing from the IEC Central Office. Any questions about IEEE copyright should be addressed to the

IEEE. Enquiri es about obtaining additional rights to this publication and other information requests should be

addressed to the IEC or your local IEC member National Committee.
IEC Central Office Institute of Electrical and Electronics Engineers, Inc.
3, rue de Varembé 3 Park Avenue
CH-1211 Geneva 20 New York, NY 10016-5997
Switzerland United States of America
Tel.: [phone] [e-mail]
[e-mail] www.ieee.org
www.iec.ch
About the IEC

The International Electrotechnical Commission (IEC) is the leading global organization that prepares and publishes

International Standards for all electrical, electronic and related technologies.
About IEC publications

The technical content of IEC publications is kept under constant review by the IEC. Please make sure that you have the

latest edition, a corrigendum or an amendment might have been published.

IEC publications search - webstore.iec.ch/advsearchform IEC online collection - oc.iec.ch

The advanced search enables to find IEC publications by a
Discover our powerful search engine and read freely all the

variety of criteria (reference number, text, technical publications previews. With a subscription you will always

committee, …). It also gives information on projects, replaced have access to up to date content tailored to your needs.

and withdrawn publications.
Electropedia - www.electropedia.org
IEC Just Published - webstore.iec.ch/justpublished
The world's leading online dictionary on electrotechnology,
Stay up to date on all new IEC publications. Just Published
containing more than 22 000 terminological entries in English
details all new publications released. Available online and
and French, with equivalent terms in 18 additional languages.
once a month by email.
Also known as the International Electrotechnical Vocabulary
(IEV) online.
IEC Customer Service Centre - webstore.iec.ch/csc
If you wish to give us your feedback on this publication or
need further assistance, please contact the Customer Service
Centre: [e-mail].
---------------------- Page: 2 ----------------------
IEC 62530-2
Edition 1.0 2021-07
IEEE Std 1800.2™
INTERNATIONAL
STANDARD
SystemVerilog –
Part 2: Universal Verification Methodology Language Reference Manual
INTERNATIONAL
ELECTROTECHNICAL
COMMISSION
ICS 25.040.01; 35.060 ISBN 978-2-8322-9974-6

Warning! Make sure that you obtained this publication from an authorized distributor.

® Registered trademark of the International Electrotechnical Commission
---------------------- Page: 3 ----------------------
IEC 62530-2:2021 © IEC 2021
IEEE Std 1800.2 ™-2017
Contents

1. Overview............................................................................................................................................ 13

1.1 Scope...................................................................................................................................... 13

1.2 Purpose................................................................................................................................... 13

1.3 Conventions used................................................................................................................... 13

2. Normative references......................................................................................................................... 16

3. Definitions, acronyms, and abbreviations.......................................................................................... 16

3.1 Definitions ............................................................................................................................. 16

3.2 Acronyms and abbreviations ................................................................................................. 17

4. UVM class reference ......................................................................................................................... 18

5. Base classes........................................................................................................................................ 20

5.1 Overview................................................................................................................................ 20

5.2 uvm_void ............................................................................................................................... 20

5.3 uvm_object............................................................................................................................. 20

5.4 uvm_transaction..................................................................................................................... 31

5.5 uvm_port_base #(IF).............................................................................................................. 36

5.6 uvm_time ............................................................................................................................... 40

6. Reporting classes ............................................................................................................................... 43

6.1 Overview................................................................................................................................ 43

6.2 uvm_report_message ............................................................................................................. 43

6.3 uvm_report_object ................................................................................................................. 46

6.4 uvm_report_handler............................................................................................................... 52

6.5 Report server.......................................................................................................................... 55

6.6 uvm_report_catcher ............................................................................................................... 59

7. Recording classes............................................................................................................................... 65

7.1 uvm_tr_database .................................................................................................................... 65

7.2 uvm_tr_stream ....................................................................................................................... 67

7.3 UVM links ............................................................................................................................. 71

8. Factory classes ................................................................................................................................... 76

8.1 Overview................................................................................................................................ 76

8.2 Factory component and object wrappers ............................................................................... 76

8.3 UVM factory.......................................................................................................................... 82

This is a copyrighted Published by IEC under licence IEEE Standard. For personal from IEEE. © 2017 IEEE. or standards development All rights reserved.use only.

Copyright © 2017 IEEE. All rights reserved.
---------------------- Page: 4 ----------------------
IEC 62530-2:2021 © IEC 2021
IEEE Std 1800.2 ™-2017

9. Phasing............................................................................................................................................... 89

9.1 Overview................................................................................................................................ 89

9.2 Implementation ...................................................................................................................... 89

9.3 Phasing definition classes ...................................................................................................... 89

9.4 uvm_domain .......................................................................................................................... 98

9.5 uvm_bottomup_phase............................................................................................................ 99

9.6 uvm_task_phase................................................................................................................... 100

9.7 uvm_topdown_phase ........................................................................................................... 101

9.8 Predefined phases ................................................................................................................ 102

10. Synchronization classes ................................................................................................................... 107

10.1 Event classes ........................................................................................................................ 107

10.2 uvm_event_callback ............................................................................................................ 110

10.3 uvm_barrier.......................................................................................................................... 111

10.4 Pool classes .......................................................................................................................... 113

10.5 Objection mechanism .......................................................................................................... 114

10.6 uvm_heartbeat...................................................................................................................... 119

10.7 Callbacks classes.................................................................................................................. 121

11. Container classes.............................................................................................................................. 126

11.1 Overview.............................................................................................................................. 126

11.2 uvm_pool #(KEY,T)............................................................................................................ 126

11.3 uvm_queue #(T)................................................................................................................... 128

12. UVM TLM interfaces ...................................................................................................................... 131

12.1 Overview.............................................................................................................................. 131

12.2 UVM TLM 1........................................................................................................................ 131

12.3 UVM TLM 2........................................................................................................................ 148

13. Predefined component classes ......................................................................................................... 168

13.1 uvm_component................................................................................................................... 168

13.2 uvm_test............................................................................................................................... 181

13.3 uvm_env............................................................................................................................... 182

13.4 uvm_agent............................................................................................................................ 182

13.5 uvm_monitor........................................................................................................................ 183

13.6 uvm_scoreboard................................................................................................................... 183

13.7 uvm_driver #(REQ,RSP) ..................................................................................................... 184

13.8 uvm_push_driver #(REQ,RSP) ........................................................................................... 184

13.9 uvm_subscriber.................................................................................................................... 185

This is a copyrighted Published by IEC under licence IEEE Standard. For personal from IEEE. © 2017 IEEE. or standards development All rights reserved.use only.

Copyright © 2017 IEEE. All rights reserved.
---------------------- Page: 5 ----------------------
IEC 62530-2:2021 © IEC 2021
IEEE Std 1800.2 ™-2017

14. Sequences classes ............................................................................................................................ 187

14.1 uvm_sequence_item............................................................................................................. 187

14.2 uvm_sequence_base............................................................................................................. 191

14.3 uvm_sequence #(REQ,RSP)................................................................................................ 200

14.4 uvm_sequence_library ......................................................................................................... 201

15. Sequencer classes............................................................................................................................. 206

15.1 Overview.............................................................................................................................. 206

15.2 Sequencer interface.............................................................................................................. 206

15.3 uvm_sequencer_base ........................................................................................................... 211

15.4 Common sequencer API ...................................................................................................... 217

15.5 uvm_sequencer #(REQ,RSP)............................................................................................... 218

15.6 uvm_push_sequencer #(REQ,RSP) ..................................................................................... 219

16. Policy classes ................................................................................................................................... 220

16.1 uvm_policy .......................................................................................................................... 220

16.2 uvm_printer.......................................................................................................................... 222

16.3 uvm_comparer ..................................................................................................................... 237

16.4 uvm_recorder ....................................................................................................................... 243

16.5 uvm_packer.......................................................................................................................... 251

16.6 uvm_copier .......................................................................................................................... 257

17. Register layer ................................................................................................................................... 260

17.1 Overview.............................................................................................................................. 260

17.2 Global declarations .............................................................................................................. 260

18. Register model ................................................................................................................................. 264

18.1 uvm_reg_block .................................................................................................................... 264

18.2 uvm_reg_map ...................................................................................................................... 276

18.3 uvm_reg_file........................................................................................................................ 284

18.4 uvm_reg ............................................................................................................................... 286

18.5 uvm_reg_field...................................................................................................................... 303

18.6 uvm_mem ............................................................................................................................ 314

18.7 uvm_reg_indirect_data ........................................................................................................ 328

18.8 uvm_reg_fifo ....................................................................................................................... 329

18.9 uvm_vreg ............................................................................................................................. 332

18.10 uvm_vreg_field.................................................................................................................... 342

18.11 uvm_reg_cbs........................................................................................................................ 347

18.12 uvm_mem_mam .................................................................................................................. 352

This is a copyrighted Published by IEC under licence IEEE Standard. For personal from IEEE. © 2017 IEEE. or standards development All rights reserved.use only.

Copyright © 2017 IEEE. All rights reserved.
---------------------- Page: 6 ----------------------
IEC 62530-2:2021 © IEC 2021
IEEE Std 1800.2 ™-2017

19. Register layer interaction with RTL design..................................................................................... 361

19.1 Generic register operation descriptors ................................................................................. 361

19.2 Classes for adapting between register and bus operations................................................... 365

19.3 uvm_reg_predictor............................................................................................................... 367

19.4 Register sequence classes .................................................................................................... 369

19.5 uvm_reg_backdoor .............................................................................................................. 376

19.6 UVM HDL back-door access support routines.................................................................... 379

Annex A (informative) Bibliography .......................................................................................................... 381

Annex B (normative) Macros and defines................................................................................................... 382

Annex C (normative) Configuration and resource classes ..........................................................................407

Annex D (normative) Convenience classes, interface, and methods........................................................... 422

Annex E (normative) Test sequences .......................................................................................................... 431

Annex F (normative) Package scope functionality...................................................................................... 443

Annex G (normative) Command line arguments......................................................................................... 466

Annex H (informative) Participants............................................................................................................. 471

This is a copyrighted Published by IEC under licence IEEE Standard. For personal from IEEE. © 2017 IEEE. or standards development All rights reserved.use only.

Copyright © 2017 IEEE. All rights reserved.
---------------------- Page: 7 ----------------------
IEC 62530-2:2021 © IEC 2021
IEEE Std 1800.2 ™-2017
SystemVerilog –
Part 2: Universal Verification Methodology Language Reference Manual
FOREWORD

1) The International Electrotechnical Commission (IEC) is a worldwide organization for standardization comprising

all national electrotechnical committees (IEC National Committees). The object of IEC is to promote international

co-operation on all questions concerning standardization in the electrical and electronic fields. To this end and

in addition to other activities, IEC publishes International Standards, Technical Specifications, Technical Reports,

Publicly Available Specifications (PAS) and Guides (hereafter referred to as "IEC document(s)"). Their

preparation is entrusted to technical committees; any IEC National Committee interested in the subject dealt with

may participate in this preparatory work. International, governmental and non-governmental organizations liaising

with the IEC also participate in this preparation.

IEEE Standards documents are developed within IEEE Societies and Standards Coordinating Committees of the

IEEE Standards Association (IEEE SA) Standards Board. IEEE develops its standards through a consensus

development process, approved by the American National Standards Institute, which brings together volunteers

representing varied viewpoints and interests to achieve the final product. Volunteers are not necessarily members

of IEEE and serve without compensation. While IEEE administers the process and establishes rules to promote

fairness in the consensus development process, IEEE does not independently evaluate, test, or verify the

accuracy of any of the information contained in its standards. Use of IEEE Standards documents is wholly

voluntary. IEEE documents are made available for use subject to important notices and legal disclaimers (see

http://standards.ieee.org/ipr/disclaimers.html for more information).

IEC collaborates closely with IEEE in accordance with conditions determined by agreement between the two

organizations. This Dual Logo International Standard was jointly developed by the IEC and IEEE under the terms

of that agreement.

2) The formal decisions of IEC on technical matters express, as nearly as possible, an international consensus of

opinion on the relevant subjects since each technical committee has representation from all interested IEC

National Committees. The formal decisions of IEEE on technical matters, once consensus within IEEE Societies

and Standards Coordinating Committees has been reached, is determined by a balanced ballot of materially

interested parties who indicate interest in reviewing the proposed standard. Final approval of the IEEE standards

document is given by the IEEE Standards Association (IEEE SA) Standards Board.

3) IEC/IEEE Publications have the form of recommendations for international use and are accepted by IEC National

Committees/IEEE Societies in that sense. While all reasonable efforts are made to ensure that the technical

content of IEC/IEEE Publications is accurate, IEC or IEEE cannot be held responsible for the way in which they

are used or for any misinterpretation by any end user.

4) In order to promote international uniformity, IEC National Committees undertake to apply IEC Publications

(including IEC/IEEE Publications) transparently to the maximum extent possible in their national and regional

publications. Any divergence between any IEC/IEEE Publication and the corresponding national or regional

publication shall be clearly indicated in the latter.

5) IEC and IEEE do not provide any attestation of conformity. Independent certification bodies provide conformity

assessment services and, in some areas, access to IEC marks of conformity. IEC and IEEE are not responsible

for any services carried out by independent certification bodies.

6) All users should ensure that they have the latest edition of this publication.

7) No liability shall attach to IEC or IEEE or their directors, employees, servants or agents including individual

experts and members of technical committees and IEC National Committees, or volunteers of IEEE Societies and

the Standards Coordinating Committees of the IEEE Standards Association (IEEE SA) Standards Board, for any

personal injury, property damage or other damage of any nature whatsoever, whether direct or indirect, or for

costs (including legal fees) and expenses arising out of the publication, use of, or reliance upon, this IEC/IEEE

Publication or any other IEC or IEEE Publications.

8) Attention is drawn to the normative references cited in this publication. Use of the referenced publications is

indispensable for the correct application of this publication.

9) Attention is drawn to the possibility that implementation of this IEC/IEEE Publication may require use of material

covered by patent rights. By publication of this standard, no position is taken with respect to the existence or

validity of any patent rights in connection therewith. IEC or IEEE shall not be held responsible for identifying

Essential Patent Claims for which a license may be required, for conducting inquiries into the legal validity or

scope of Patent Claims or determining whether any licensing terms or conditions provided in connection with

submission of a Letter of Assurance, if any, or in any licensing agreements are reasonable or non-discriminatory.

Users of this standard are expressly advised that determination of the validity of any patent rights, and the risk

of infringement of such rights, is entirely their own responsibility.

IEC 62530-2/IEEE Std 1800.2 was processed through IEC technical committee 91: Electronics

assembly technology, under the IEC/IEEE Dual Logo Agreement. It is an International Standard.

---------------------- Page: 8 ----------------------
IEC 62530-2:2021 © IEC 2021
IEEE Std 1800.2 ™-2017
The text of this International Standard is based on the following documents:
IEEE Std FDIS Report on voting
1800.2 (2017) 91/1713/FDIS 91/1725/RVD

Full information on the voting for its approval can be found in the report on voting indicated in

the above table.
The language used for the development of this International Standard is English.

The IEC Technical Committee and IEEE Technical Committee have decided that the contents

of this document will remain unchanged until the stability date indicated on the IEC website

under webstore.iec.ch in the data related to the specific document. At this date, the document

will be
• reconfirmed,
• withdrawn,
• replaced by a revised edition, or
• amended.
---------------------- Page: 9 ----------------------
IEEE Std 1800.2™-2017
IEEE Standard for Universal
Verification Methodology Language
Reference Manual
Sponsor
Design Automation Standards Committee
of the
IEEE Computer Society
Approved 14 February 2017
IEEE-SA Standards Board

This is a copyrighted Published by IEC under licence IEEE Standard. For personal from IEEE. © 2017 IEEE. or standards development All rights reserved.use only.

---------------------- Page: 10 ----------------------
IEC 62530-2:2021 © IEC 2021
IEEE Std 1800.2 ™-2017

Grateful acknowledgment is made for permission to use the following source material:

Accellera Systems Initiative—The Universal Verification Methodology (UVM)
pre-IEEE Class Reference.

Abstract: The Universal Verification Methodology (UVM) that can improve interoperability, reduce

the cost of using intellectual property (IP) for new projects or electronic design automation (EDA)

tools, and make it easier to reuse verification components is provided. Overall, using this standard

will lower verification costs and improve design quality throughout the industry. The primary

audiences for this standard are the implementors of the UVM base class library, the implementors

of tools supporting the UVM base class library, and the users of the UVM base class library.

Keywords: agent, blocking, callback, class, component, consumer, driver, event, export, factory,

function, generator, IEEE 1800.2™, member, method, monitor, non-blocking, phase, port, register,

resource, sequence, sequencer, transaction level modeling, verification methodology

Copyright © 2017 IEEE. All rights reserved.

This is a copyrighted Published by IEC under licence IEEE Standard. For personal from IEEE. © 2017 IEEE. or standards development All rights reserved.use only.

---------------------- Page: 11 ----------------------
IEC 62530-2:2021 © IEC 2021
IEEE Std 1800.2 ™-2017
Important Notices and Disclaimers Concerning IEEE Standards Documents

IEEE documents are made available for use subject to important notices and legal disclaimers. These notices

and disclaimers, or a reference to this page, appear in all standards and may be found under the heading

“Important Notices and Disclaimers Concerning
...