xobs/foboot
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
129 Commits 2 Branches 1 Tag 2.4 MiB
Verilog 79.3%
C 15.5%
Python 4.7%
Makefile 0.4%
7ee97214e6
Go to file
Sean Cross 7ee97214e6 foboot-bitstream: generate multiboot and print helpful message 
Generate a multiboot version of the bitstream image.  While we're at it,
print a helpful message indicating what each output image is.

Signed-off-by: Sean Cross <sean@xobs.io>
2019-04-06 11:07:39 +08:00
hw foboot-bitstream: generate multiboot and print helpful message 2019-04-06 11:07:39 +08:00
sw sw: spi-gpio: remove unused files 2019-04-06 11:04:43 +08:00
.gitignore gitmodules: add hw deps 2019-03-05 09:16:36 +08:00
.gitmodules gitmodules: add hw deps 2019-03-05 09:16:36 +08:00
LICENSE initial commit 2019-01-01 10:24:08 +08:00
README.md README: add information about sw and hw and building 2019-04-01 10:10:13 +08:00

README.md

Foboot: The Bootloader for Fomu

Foboot is a failsafe bootloader for Fomu. It exposes a DFU interface to the host. Foboot comes in two halves: A Software half and a Hardware half.

Building the Hardware

The hardware half is written in LiteX, and uses lxbuildenv to handle Python dependencies. Hardware is contained within the hw/ directory. You must install software dependencies yourself:

  • Python 3.5+
  • Nextpnr
  • Icestorm
  • Yosys
  • Git

Subproject dependencies will be taken care of with lxbuildenv.

Usage

To build, run foboot-bitstream.py:

python3 .\foboot-bitstream.py

There are multiple build options available. Use --help to list them.

Build files will be generated in the build/ directory. You will probably be most interested in build/gateware/top.bin and build/software/include/generated/.

Tests

You can run tests by using the unittest command:

python .\lxbuildenv.py -r -m unittest -v valentyusb.usbcore.cpu.epfifo_test.TestPerEndpointFifoInterface

Building the Software

Software is contained in the sw/ directory.