Repository and Wiki for Chip Hack events.
Verilog Makefile Python Batchfile C CSS Other
Switch branches/tags
Nothing to show
Clone or download
jeremybennett Updated biloader.c for mini-edsac
Files changed:

	* mini-edsac/README: Add notes from Bill.
	* mini-edsac/biloader.c: Created.
Latest commit 3530514 Oct 24, 2017
Permalink
Failed to load latest commit information.
basic_verilog
cheat_sheet added DIP switch definitions Sep 8, 2017
mini-edsac
minimal-edsac
pretty_colours
tutorials
.gitignore
LICENSE.CCBYSA
LICENSE.GPL3
LICENSE.Solderpad
README.md

README.md

Chip Hack

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.

Tutorial slides

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.

Using Hieroglyph

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.

Tutorial code

The tutorial code is in individual subdirectories within the basic_verilog and cheat_sheet directories, with one sub-directory for each exercise. directory.

basic_verilog

The files are mostly empty, for you to complete.

cheat_sheet

Full solutionns corresponding to the basic_verilog files, if you get stuck.

pretty_colours

A full project, with a chip.bin, so that you can test your installation of the tools

Prerequisites

To install everything you need follow the guides on chiphack.org:

To compile and upload programs

Full guidance is provided in the setup presentation (HTML, slides)