2020-10-12 17:58:16 +00:00
.. _required-hardware:
Required Hardware
#################
2020-11-07 23:34:10 +00:00
- For this workshop, you will need a `Fomu board <https://github.com/im-tomu/fomu-hardware> `_ .
- Aside from that, you need a computer with a USB port that can run the :ref: `required-software` .
2020-10-12 17:58:16 +00:00
2020-11-07 23:34:10 +00:00
.. NOTE ::
You should not need any special drivers, though on Linux you may need `` sudo ``
access, or special `` udev `` rules for granting permission to use the USB device from a
non-privileged account.
2020-10-12 17:58:16 +00:00
2020-11-07 23:34:10 +00:00
.. ATTENTION ::
This workshop may be competed with any model of Fomu, though there are some
parts that require you to identify which model you have. See the
:ref: `which-fomu` below.
2020-10-12 17:58:16 +00:00
.. _which-fomu:
Which Fomu do I have?
=====================
2020-11-07 23:34:10 +00:00
+------------------+---------------------------------------------------------------------+-------------------------------------------------------------------+
| | Hacker | Production |
+==================+=====================================================================+===================================================================+
| **String** | hacker | pvt |
+------------------+---------------------------------------------------------------------+-------------------------------------------------------------------+
| **Bash Command** | `` export FOMU_REV=hacker `` | `` export FOMU_REV=pvt `` |
+------------------+---------------------------------------------------------------------+-------------------------------------------------------------------+
| **Front** | |Hacker Hardware Front without case| | |Production Hardware Front without case| |
+------------------+---------------------------------------------------------------------+-------------------------------------------------------------------+
| **Back** | |Hacker Hardware Back without case| | |Production Hardware Back without case| |
+------------------+---------------------------------------------------------------------+-------------------------------------------------------------------+
| **In Case** | |Hacker Hardware Back with case| | |Production Hardware Back with case| |
+------------------+---------------------------------------------------------------------+-------------------------------------------------------------------+
| **Parts** | |Hacker Hardware Annotated Diagram| | |Production Hardware Annotated Diagram| |
+------------------+---------------------------------------------------------------------+-------------------------------------------------------------------+
| **Color** | |Dark Blue| | |Cyan Light Blue| |
+------------------+---------------------------------------------------------------------+-------------------------------------------------------------------+
| **Bootloader** | Fomu **Hacker** running DFU Bootloader vX.X.X | Fomu **PVT** running DFU Bootloader vX.X.X |
+------------------+---------------------------------------------------------------------+-------------------------------------------------------------------+
| **Description** | These are the original design and cut corners to make it easier to | If you ordered a Fomu from Crowd Supply, this is the model you'll |
| | manufacture. If you received one directly from Tim before 36C3, you | receive. It is small, and fits in a USB port. There is no |
| | probably have one of these. Hacker boards have white silkscreen on | silkscreen on it. This model of Fomu has a large silver crystal |
| | the back. | oscillator that is the tallest component on the board. |
+------------------+---------------------------------------------------------------------+-------------------------------------------------------------------+
| **Schematic** | `schematic-hacker.pdf <_static/reference/schematic-hacker.pdf> `__ | `schematic-pvt.pdf <_static/reference/schematic-pvt.pdf> `__ |
+------------------+---------------------------------------------------------------------+-------------------------------------------------------------------+
| **Received at** | From Tim at 35C3, CCCamp19, HackADay Supercon 2019 | At RISC-V Summit 2019, 36C3, Crowdsupply, Mouser |
+------------------+---------------------------------------------------------------------+-------------------------------------------------------------------+
| **Buy more** | End of Life | `CrowdSupply <https://j.mp/fomu-cs> `__ , |
+------------------+---------------------------------------------------------------------+-------------------------------------------------------------------+
2020-10-12 17:58:16 +00:00
.. |Dark Blue| raw :: html
<span style="background-color: #051b70; color: white;">dark blue</span>
.. |Cyan Light Blue| raw :: html
<span style="background-color: #03b1c4;">cyan / light blue</span>
.. |Hacker Hardware Front without case| image :: ../_static/hw-hacker-front-bare-small.jpg
.. |Production Hardware Front without case| image :: ../_static/hw-pvt-front-bare-small.jpg
.. |Hacker Hardware Back without case| image :: ../_static/hw-hacker-back-bare-small.jpg
.. |Production Hardware Back without case| image :: ../_static/hw-pvt-back-bare-small.jpg
.. |Hacker Hardware Back with case| image :: ../_static/hw-hacker-back-case-small.jpg
.. |Production Hardware Back with case| image :: ../_static/hw-pvt-back-case-small.jpg
.. |Hacker Hardware Annotated Diagram| image :: ../_static/hw-hacker-annotated.png
.. |Production Hardware Annotated Diagram| image :: ../_static/hw-pvt-annotated.png
.. note ::
There are also Fomu EVT boards which were shipped to early backers of
the Fomu crowd funding campaign. This model of Fomu is about the size
of a credit card. It should have the text “Fomu EVT3” written across
it in white silkscreen. If you have a different EVT board such as
2020-11-07 23:34:10 +00:00
EVT2 or EVT1, they should also work.