From 4af355762fc7cdccff6fee864d4747e00d5fdccd Mon Sep 17 00:00:00 2001
From: gutmet <me.git@gutmet.org>
Date: Mon, 24 Oct 2022 20:51:16 +0200
Subject: [PATCH] expand readme

---
 README.md | 68 ++++++++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 65 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index fb5141c..d22be36 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,68 @@
-pentabug
-========
+# pentabug
+
+
+This is a fork of https://github.com/c3d2/pentabug
 
 The pentabug is a small microcontroller soldering project. It's especially suited for young hackers and beginners of all ages. Assembly requires no prior soldering skills and can be accomplished - with a little help for the tricky parts - by children old enough to savely hold a soldering iron (thats about 7 years and up).
 
-A complete walktrough of the assembly process is given in ["Pentabug - The Movie"](http://www.c3d2.de/news/video-pentabug-bauen.html "Pentabug - The Movie"), courtesy of [C3D2 - Chaos Computer Club Dresden](http://c3d2.de "C3D2 - Chaos Computer Club Dresden").
+## Assembly
+
+Assembly instructions can be found in /doc/anleiungsflyer (German). The motor can be tricky. Parts for JP3-5 may not be included, but are not needed for the standard apps.
+
+## Programming
+
+Install binutils-avr, gcc-avr, avr-libc, avrdude
+
+Pre-flashed versions of the processor ship with a test firmware, not the final apps! You need an ISP to upload the apps to the Pentabug. An Arduino Uno can be used as such:
+
+### Flash Arduino Uno with ArduinoISP
+
+Make sure you have a recent Arduino IDE, then...
+
+1. Open Arduino IDE
+1. Select Tools > Board and Port
+1. Open File > Examples > ArduinoISP
+1. Upload
+
+### Connect Arduino Pins to ISP-Header on target
+
+| PIN on ArduinoISP | Function | PIN on ISP 2x3 header |
+|-------------------|----------|-----------------------|
+| D12               | MISO     | 1 (upper right)       |
+| 5V                | 5V       | 2 (lower right)       |
+| D13               | SCK      | 3 (upper mid)         |
+| D11               | MOSI     | 4 (lower mid)         |
+| D10               | Reset    | 5 (upper left)        |
+| GND               | GND      | 6 (lower left)        |
+
+### Flash the apps to the pentabug
+
+```
+make flash
+```
+
+## Apps
+
+### buggy
+
+Roach mode - pentabug reacts to light and flashed LEDs, beeps, vibrates
+
+### jumpy
+
+Similar to buggy, but reacts to loud sound
+
+### mariotheme
+
+Play Super Mario theme tune
+
+### geiger
+
+Reacts to light and produces sound like a Geiger counter. If you briefly press one button, you switch to a second mode that changes pitch depending on light.
+
+### ducklings
+
+Pentabug sings "Alle meine Entchen".
+
+### blinker
+
+Pentabug flashed its LEDs. If you briefly press one button, you can switch the motor on/off.