This repository (and its companion wiki) contains tutorial code and documentation for the Chip Hack events. Most recently the ChipHack/EDSAC Challenge, held in Hebden Bridge from the 6th to the 8th of September 2017.
All the tutorial slide decks can be found in the tutorials directory. Many
of these are prepared using
Hieroglyph a derivative of . Being
based on reStructuredText the
content is plain text, making it easy to transfer to other formats.
Each tutorial slide deck has its own directory.
All slide decks are provided under a Creative Commons Attribution-ShareAlike 4.0 license, so you are free to share and modify the slides, so long as you attribute the original authors and give the same rights to others.
There are guidelines online for setting up hieroglyph. I used version 0.7.1 on top of Sphinx 1.4.1 (there can be an issue with newer versions). With this installed, each set of slides can be built from the individual tutorial directory by running
make slides
The slides will be found as HTML in the build/slides directory. Just open
index.html in your browser.
The tutorial code is in individual subdirectories within the basic_verilog
and cheat_sheet directories, with one sub-directory for each exercise.
directory.
The files are mostly empty, for you to complete.
Full solutionns corresponding to the basic_verilog files, if you get stuck.
A full project, with a chip.bin, so that you can test your installation of the tools
To install everything you need follow the guides on chiphack.org:
Full guidance is provided in the setup presentation (HTML, slides)