Welcome to AVL-QEMU's Documentation
===================================

What is AVL?
------------

**AVL** is the Apheleia Verification Library.

For full details see `AVL Documentation <https://avl-core.readthedocs.io/en/latest/>`_.

What is AXI-QEMU?
-----------------

**AXI-QEMU** is the  `QEMU <https://www.qemu.org/>`_ integration to AVL.


Why Use AVL-QEMU?
-----------------

AVL-QEMU allows the user to emulate a CPU system into a block or system-level test-bench.

c-tests that would normally be developed on a large system environment can be developed early in the process. Sections \
of the memory map can be carved out to have custom read / write callbacks allowing integration with bus VIP, such allows
`AVL-AXI <https://avl-axi.readthedocs.io/en/latest/>`_ or `AVL-APB <https://avl-apb.readthedocs.io/en/latest/>`_.

For designs which have use cases often limited to a small feature set, completely defined by a software driver (I2C, SPI, etc) \
this can allow the user to have a block-level test-bench capable of running system-level test cases without the need of a full \
SoC and/or at block-level performance.