circuitpython/ports/litex
Scott Shawcroft 796373b8be
A number of small ESP32S2 fixes:
* Fix flash writes that don't end on a sector boundary. Fixes #2944
* Fix enum incompatibility with IDF.
* Fix printf output so it goes out debug UART.
* Increase stack size to 8k.
* Fix sleep of less than a tick so it doesn't crash.
2020-05-28 15:43:55 -07:00
..
boards linker scripts: Re-align at ":" 2020-04-27 17:17:42 -05:00
common-hal Update digitalio api for other ports 2020-05-20 09:23:42 -07:00
hw ports: litex: add port and fomu board 2020-03-31 09:40:38 +08:00
supervisor Initial ESP32S2 port. 2020-05-15 15:36:16 -07:00
.gitignore Update LiteX APIs for new tick 2020-03-31 17:52:23 -07:00
Makefile A number of small ESP32S2 fixes: 2020-05-28 15:43:55 -07:00
README.rst Update the supported ports 2020-03-31 18:27:55 -07:00
background.c ports: litex: add port and fomu board 2020-03-31 09:40:38 +08:00
background.h ports: litex: add port and fomu board 2020-03-31 09:40:38 +08:00
crt0-vexriscv.S ports: litex: add port and fomu board 2020-03-31 09:40:38 +08:00
fatfs_port.c ports: litex: add port and fomu board 2020-03-31 09:40:38 +08:00
irq.h ports: litex: add port and fomu board 2020-03-31 09:40:38 +08:00
mpconfigport.h litex: enable binascii and ujson modules 2020-04-16 10:02:08 +08:00
mpconfigport.mk refactor countio based on feedback 2020-05-05 15:23:38 +10:00
mphalport.c Merge remote-tracking branch 'adafruit/master' into lower_power 2020-04-27 16:45:10 -07:00
mphalport.h ports: litex: add port and fomu board 2020-03-31 09:40:38 +08:00
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.