circuitpython/ports/litex
Jeff Epler 57fde2e07b sdcardio: implement new library for SD card I/O
Testing performed: That a card is successfully mounted on Pygamer with
the built in SD card slot

This module is enabled for most FULL_BUILD boards, but is disabled for
samd21 ("M0"), litex, and pca10100 for various reasons.
2020-06-26 11:50:23 -05:00
..
boards supervisor.mk: Compute USB_DEVICES; remove from boards and ports 2020-06-23 12:59:01 -05:00
common-hal Fix up end of file and trailing whitespace. 2020-06-03 10:56:35 +01:00
hw Fix up end of file and trailing whitespace. 2020-06-03 10:56:35 +01:00
supervisor Fix up end of file and trailing whitespace. 2020-06-03 10:56:35 +01:00
.gitignore Update LiteX APIs for new tick 2020-03-31 17:52:23 -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 Fix up end of file and trailing whitespace. 2020-06-03 10:56:35 +01:00
Makefile A number of small ESP32S2 fixes: 2020-05-28 15:43:55 -07:00
mpconfigport.h litex: enable binascii and ujson modules 2020-04-16 10:02:08 +08:00
mpconfigport.mk sdcardio: implement new library for SD card I/O 2020-06-26 11:50:23 -05: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 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.