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