1.. _qomu:
2
3Qomu
4####
5
6Overview
7********
8
9The Qomu board is a platform with an on-board QuickLogic EOS S3 Sensor Processing Platform.
10
11
12.. figure:: img/qomu-board.png
13   :align: center
14   :alt: Qomu
15
16   Qomu (Credit: QuickLogic)
17
18Hardware
19********
20
21- QuickLogic EOS S3 MCU Platform
22- 16 Mbit of on-board flash memory
23- Touchpads (4)
24- RGB LED
25- Powered from USB
26
27Detailed information about the board can be found in a `Qomu repository`_ and `Qomu User Guide`_.
28
29Connections and IOs
30===================
31
32Detailed information about pinouts is available in the `schematics document`_.
33
34Programming
35***********
36
37The Qomu platform by default boots from flash.
38
39Below are steps to run Qomu sample application:
40
41#. Build the sample in an usual way:
42
43   .. zephyr-app-commands::
44      :zephyr-app: samples/boards/qomu
45      :board: qomu
46      :goals: build
47
48#. Remove Qomu board from USB port.
49#. Insert Qomu board to USB port.
50#. While the blue LED is blinking (for 5 seconds), touch the touch-pads with your finger.
51   On success, the green led will start flashing.
52#. Use TinyFpgaProgrammer application to load the target application:
53
54   .. code-block:: console
55
56      python3 /path/to/TinyFPGA-Programmer-Application/tinyfpga-programmer-gui.py --mode m4 --m4app build/zephyr/zephyr.bin --reset
57
58   Refer to `TinyFPGA Programmer Application repo`_ for detailed information on installation
59   and program usage.
60
61
62References
63**********
64
65.. target-notes::
66
67.. _Qomu repository:
68    https://github.com/QuickLogic-Corp/qomu-dev-board
69
70.. _Qomu User Guide:
71    https://github.com/QuickLogic-Corp/qomu-dev-board/blob/master/doc/Qomu_UserGuide.pdf
72
73.. _schematics document:
74    https://github.com/QuickLogic-Corp/qomu-dev-board/blob/master/doc/qomu-board.pdf
75
76.. _TinyFPGA Programmer Application repo:
77    https://github.com/QuickLogic-Corp/TinyFPGA-Programmer-Application
78