aw/pentabug
1
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

expand readme

Browse Source
This commit is contained in:
gutmet 2022-10-24 20:51:16 +02:00
parent 9400f9e754
commit 4af355762f
1 changed files with 65 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

68
README.md
View File

@ -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). 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.