Integration
===========

.. image:: /images/QEMU_Hierachy.png
   :align: center


Python Integration
------------------

AVL-QEMU is simple to integrate by:

- Instancing the Agent :doc:`/modules/avl_qemu._x86`

- Implementing async read and write callbacks

- Declaring active memory ranges associated with the callbacks


.. literalinclude:: ../../../examples/x86/cocotb/example.py
    :language: python


Developing C-Tests
------------------

C-Tests are written and developed exactly as you would for any embedded software. The provided example \
uses bare-metal, but using any of the OS libraries supported in QEMU is equally valid.

The example provides:

- boot.s (simple boot script)

- linker.ld (linker with defined memory range for AVL integration)

- main.c (the test case)

- Makefile