zephyr/samples/boards/qomu
Michal Sieron 702caf1c7e samples: boards: Add Qomu board sample
First pads are being configured for use by the FPGA.
Then CPU loads usbserial bitstream.
Finally it reenables clocks, sets up USB PID and waits for device to
enumerate.

Also disable software resets in used clocks.

Signed-off-by: Michal Sieron <msieron@antmicro.com>
2022-10-20 15:41:09 +02:00
..
src
CMakeLists.txt
README.rst
prj.conf
qomu.overlay

README.rst

.. _qomu_usbserial:

Zephyr usbserial driver on Qomu
###############################

This sample demonstrates how to load bitstream on EOS-S3 FPGA and use the
usbserial driver.

Requirements
************
* Zephyr RTOS with printk enabled
* `QuickLogic Qomu board <https://github.com/QuickLogic-Corp/qomu-feather-dev-board>`_

Building
********

.. zephyr-app-commands::
   :zephyr-app: samples/boards/qomu
   :host-os: unix
   :board: qomu
   :goals: build
   :compact:

Flashing
********

To load example into Qomu you can use `TinyFPGA-Programmer-Application <https://github.com/QuickLogic-Corp/TinyFPGA-Programmer-Application>`_.

.. code-block:: console

   python3 /PATH/TO/BASE/DIR/TinyFPGA-Programmer-Application/tinyfpga-programmer-gui.py --mode m4 --m4app build/zephyr/zephyr.bin --reset

See `Qomu User Guide <https://github.com/QuickLogic-Corp/qomu-dev-board/blob/662f8841bdc1ed35c1539ac381182159d7cd5914/doc/Qomu_UserGuide.pdf>`_ on how to load an image to the board.

Running
*******

After connecting to the shell console you should see the following output:

.. code-block:: console

   ####################
   I am Zephyr on Qomu!
   ####################