verilog-apple-one/boards/ice40updevboard/README.md

# ICE40UPDev Board support

![ICE40UPDevBoard board render](images/ICE40UPDevBoard.png)

This adds support for building apple one design for [Aslak3's ICE40UP Development Board](http://github.com/aslak3/ICE40UPDevBoard). The board contains a [ADV7123](https://www.analog.com/media/en/technical-documentation/data-sheets/ADV7123-EP.pdf) (PDF) RGB DAC and PS/2 port, and some I2C hardware that this Apple 1 implementation does not yet make use of. The single push button on the board is mapped to the reset line. The PS/2 port on the board is actually wired to two PS/2 connections, but this project makes only use of the first ("default") wiring for the keyboard.

## Building
Install a recent toolchain and:

```
$ cd yosys
$ make
```

Unlike other boards in this project nextpnr-ice4 is used for routing, since it has been the current tool for some years now and arachne-pnr was deprecated in 2015.

Program the board using any suitable method.
Update README.md 2024-04-21 22:56:44 +00:00			`# ICE40UPDev Board support`
Added support for ICE40UPDevBoard My board features an ICE40UP5K in QFN and the usual flash, PS/2 port etc. Thought it would be fun to port this Apple One implementation, and it was super easy considering I'm quite new to Verilog. 2024-04-18 09:28:55 +00:00
			`![ICE40UPDevBoard board render](images/ICE40UPDevBoard.png)`

			This adds support for building apple one design for [Aslak3's ICE40UP Development Board](http://github.com/aslak3/ICE40UPDevBoard). The board contains a [ADV7123](https://www.analog.com/media/en/technical-documentation/data-sheets/ADV7123-EP.pdf) (PDF) RGB DAC and PS/2 port, and some I2C hardware that this Apple 1 implementation does not yet make use of. The single push button on the board is mapped to the reset line. The PS/2 port on the board is actually wired to two PS/2 connections, but this project makes only use of the first ("default") wiring for the keyboard.

			`## Building`
			`Install a recent toolchain and:`

			```
			`$ cd yosys`
			`$ make`
			```

			`Unlike other boards in this project nextpnr-ice4 is used for routing, since it has been the current tool for some years now and arachne-pnr was deprecated in 2015.`

			`Program the board using any suitable method.`