coelner/fomu-toolchain
1
0
Fork 0
mirror of https://github.com/im-tomu/fomu-toolchain.git synced 2024-09-19 18:30:16 +00:00
Code Issues Packages Projects Releases Wiki Activity
A collection of tools for developing for Fomu
13 Commits 1 Branch 21 Tags 77 KiB
Shell 89.6%
Dockerfile 10.4%
3f5b33c43a
Go to file
Andy Boyett 3f5b33c43a build: generate checksums for build files 
SHA1, SHA256, and SHA512 checksums are now generated (and uploaded to
releases) for toolchains on all arches. This will allow checksums of
artifacts to be verified as coming from CI. This is particularly useful
during Fomu workshops where the toolchain is distributed on USB drives
to work around local bandwidth limitations.

`set +x` is used to clean up the output by disabling the echo of
commands while checksum calculation is performed and enabled again with
`set -x` once checksums calcs are complete.
2019-08-23 15:32:11 +02:00
.gitattributes initial commit 2019-08-17 22:06:39 +08:00
.gitignore initial commit 2019-08-17 22:06:39 +08:00
.travis.yml build: generate checksums for build files 2019-08-23 15:32:11 +02:00
build.sh build: generate checksums for build files 2019-08-23 15:32:11 +02:00
README.md README: indicate which tools are installed 2019-08-19 14:55:15 +08:00

README.md

Fomu Toolchain

Fomu is an FPGA in your USB port. This repository contains prebuilt versions of all the tools you will need to develop for Fomu.

Usage

Download the latest release for your platform and extract it somewhere on your disk. Then set your PATH:

  • MacOS: export PATH=[path-to-bin]:$PATH
  • Linux: export PATH=[path-to-bin]:$PATH
  • Windows Powershell: $ENV:PATH = "[path-to-bin];" + $ENV:PATH
  • Windows cmd.exe: PATH=[path-to-bin];%PATH

To confirm installation, run a command such as nextpnr-ice40 or yosys.

What's included

This contains almost everything you'll need to develop on Fomu:

  • yosys -- synthesis
  • nextpnr-ice40 -- place-and-route
  • dfu-util -- upload bitstream to the FPGA
  • python3 -- required for nextpnr-ice40 and to build litex projects
  • riscv-gcc -- compile code for RISC-V CPUs, such as the Fomu softcore
  • wishbone-tool -- access the debug bus on Fomu

Additionally, the macOS and Windows versions include make.

It is strongly recommended that you install git to manage repositories and check out code, though it is not strictly necessary.