From bd82336f22299d1dd9817bfd7644bdad77f41812 Mon Sep 17 00:00:00 2001
From: Tom Verbeure <hombre+github@gmail.com>
Date: Sun, 18 Mar 2018 05:01:13 +0000
Subject: [PATCH] blink readme

---
 blink/readme.md | 42 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 blink/readme.md

diff --git a/blink/readme.md b/blink/readme.md
new file mode 100644
index 0000000..0032f4b
--- /dev/null
+++ b/blink/readme.md
@@ -0,0 +1,42 @@
+
+# Blink
+
+This 'Hello World' equivalent simply blinks the RGB LED. They're high intensity LEDs that will almost
+burn your eyeballs if you stare at it long enough.
+
+# Requirements
+
+* Yosys
+* Arachne-pnr
+* Project IceStorm
+
+# Usage
+
+* ```make```
+
+    Builds ```chip.bin``` bitstream
+
+* ```make flash```
+
+    Program the bitstream to the device.
+
+Expected output during flashing:
+
+```
+ubuntu@ubuntu-xenial:~/projects/upduino$ sudo make flash
+iceprog chip.bin
+init..
+cdone: high
+reset..
+cdone: high
+flash ID: 0xEF 0x40 0x16 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
+file size: 104090
+erase 64kB sector at 0x000000..
+erase 64kB sector at 0x010000..
+programming..
+reading..
+VERIFY OK
+cdone: high
+Bye.
+```
+