circuitpython/ports/litex
Neradoc d021d9ae4a Move build extensions to board directories
- define CIRCUITPY_BUILD_EXTENSIONS to predefined values
- set CIRCUITPY_BUILD_EXTENSIONS in port and board config
- reuse the support matrix "get_settings_from_makefile" to get it
- move the existing port and board specific values
- remove the C3 specific board values because it's not the default
- update build_release_files.py to use get_settings_from_makefile
2022-07-26 18:15:50 +02:00
..
boards/fomu Board definition clean up 2022-03-21 17:58:43 -07:00
common-hal Conditionalize LTO 2022-05-27 12:59:54 -07:00
hw run code formatting script 2021-03-15 19:27:36 +05:30
supervisor litex: Enable -Werror=missing-prototypes 2021-11-12 19:13:51 -06:00
.gitignore Update LiteX APIs for new tick 2020-03-31 17:52:23 -07:00
background.c litex: Enable -Werror=missing-prototypes 2021-11-12 19:13:51 -06:00
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
Makefile Conditionalize LTO 2022-05-27 12:59:54 -07:00
mpconfigport.h run code formatting script 2021-03-15 19:27:36 +05:30
mpconfigport.mk Move build extensions to board directories 2022-07-26 18:15:50 +02:00
mphalport.c Start of USB host API 2022-03-07 18:07:25 -08:00
mphalport.h Merge tag 'v1.17' into merge-1.17 2021-10-15 08:20:54 -05:00
qstrdefsport.h Merge MicroPython 1.13 into CircuitPython 2021-05-04 18:06:33 -07:00
README.rst Update the supported ports 2020-03-31 18:27:55 -07:00

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.