circuitpython/ports/litex
Artyom Skrobov 4e3c1d4a4c [build] Allow USB to be set to 0
Unify USB-related makefile var and C def as CIRCUITPY_USB.

Always define it as 0 or 1, same as all other settings.

USB_AVAILABLE was conditionally defined in supervisor.mk,
but never actually used to #ifdef USB-related code.

Loosely related to #4546
2021-04-23 11:13:34 -04:00
..
boards/fomu run code formatting script 2021-03-15 19:27:36 +05:30
common-hal run code formatting script 2021-03-15 19:27:36 +05:30
hw run code formatting script 2021-03-15 19:27:36 +05:30
supervisor [build] Allow USB to be set to 0 2021-04-23 11:13:34 -04:00
.gitignore Update LiteX APIs for new tick 2020-03-31 17:52:23 -07:00
Makefile [build] Allow USB to be set to 0 2021-04-23 11:13:34 -04:00
README.rst Update the supported ports 2020-03-31 18:27:55 -07:00
background.c run code formatting script 2021-03-15 19:27:36 +05:30
background.h supervisor: factor supervisor_background_tasks from sundry ports 2020-07-15 11:49:44 -05:00
crt0-vexriscv.S ports: litex: add port and fomu board 2020-03-31 09:40:38 +08:00
fatfs_port.c run code formatting script 2021-03-15 19:27:36 +05:30
irq.h run code formatting script 2021-03-15 19:27:36 +05:30
mpconfigport.h run code formatting script 2021-03-15 19:27:36 +05:30
mpconfigport.mk usb descriptors all set; rework of enabling for USB devices 2021-02-04 19:23:40 -05:00
mphalport.c run code formatting script 2021-03-15 19:27:36 +05:30
mphalport.h run code formatting script 2021-03-15 19:27:36 +05:30
qstrdefsport.h ports: litex: add port and fomu board 2020-03-31 09:40:38 +08:00

README.rst

LiteX (FPGA)
============

`LiteX <https://github.com/enjoy-digital/litex>`_ is a Python-based System on a Chip (SoC) designer
for open source supported Field Programmable Gate Array (FPGA) chips. This means that the CPU
core(s) and peripherals are not defined by the physical chip. Instead, they are loaded as separate
"gateware". Once this gateware is loaded, CircuitPython can be loaded on top of it to work as
expected.

Installation
-------------

You'll need ``dfu-util`` to install CircuitPython on the Fomu.

Make sure the foboot bootloader is updated. Instructions are here: https://github.com/im-tomu/fomu-workshop/blob/master/docs/bootloader.rst

Once you've updated the bootloader, you should know how to use ``dfu-util``. It's pretty easy!

To install CircuitPython do:

.. code-block:: shell

  dfu-util -D adafruit-circuitpython-fomu-en_US-<version>.dfu

It will install and then restart. CIRCUITPY should appear as it usually does and work the same.