circuitpython/ports/litex
Dan Halbert 68a2927385 MP_REGISTER_ROOT_POINTER for port-specific root pointers 2023-09-29 15:46:42 -04:00
..
boards/fomu initial merge from v1.20.0; just satisifying conflicts 2023-09-19 11:10:12 -04:00
common-hal initial merge from v1.20.0; just satisifying conflicts 2023-09-19 11:10:12 -04:00
hw
supervisor finish converting to MP_REGISTER_ROOT_POINTER() 2023-09-29 10:49:34 -04:00
Makefile finish converting to MP_REGISTER_ROOT_POINTER() 2023-09-29 10:49:34 -04:00
README.rst
background.c
background.h
crt0-vexriscv.S
irq.h
mpconfigport.h MP_REGISTER_ROOT_POINTER for port-specific root pointers 2023-09-29 15:46:42 -04:00
mpconfigport.mk
mphalport.c
mphalport.h
qstrdefsport.h

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.