Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dmcinnes/lunpus
A hand-held 7-segement display game based on the ATtiny84
https://github.com/dmcinnes/lunpus
7-segment 7-segment-display arduino attiny84 handheld-electronic-game
Last synced: 25 days ago
JSON representation
A hand-held 7-segement display game based on the ATtiny84
- Host: GitHub
- URL: https://github.com/dmcinnes/lunpus
- Owner: dmcinnes
- Created: 2021-10-17T23:59:09.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-11-28T00:20:11.000Z (about 2 months ago)
- Last Synced: 2024-12-16T22:33:26.106Z (27 days ago)
- Topics: 7-segment, 7-segment-display, arduino, attiny84, handheld-electronic-game
- Language: C++
- Homepage:
- Size: 126 KB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Hunt the Lunpus
A hand-held 7-segment display game based on the ATtiny84.
Based on the old [Hunt the Wumpus](https://en.wikipedia.org/wiki/Hunt_the_Wumpus) text-based computer game originally published as BASIC source code in [Creative Computing](https://en.wikipedia.org/wiki/Creative_Computing_(magazine)). The original is based on a dodecahedron maze but I first came across it as a grid-based cave game on the [TI-99/4A](https://en.wikipedia.org/wiki/TI-99/4A) we had as kids.
This handheld version has been renamed Hunt the _Lunpus_ for obvious reasons once you consider the constraints of the display 😉
**[Video of the game in action!](https://youtu.be/uNveLRCgQw0)**
## Rules
You find yourself in a dark cave with the elusive Lunpus! You have your trusty bow and four arrows, let's see if you can defeat the Lunpus before it eats you!
There are dangers in the cave:
* *Superbats* will pick you up and drop you into a random location.
* *Slime Pits* are certain death if you accidently stumble upon one!
* *The Lunpus* may eat you if you bother its sleep.
You can only see walls that are next to you, however the dangers
* Blinking decimal points will warn you there is a *Buperbat* nearby.
* The sound of wind will warn you there is a *Slime Pit* nearby.
* The sound of snoring will warn you *The Lunpus* is nearby.
You only have 4 arrows, use them wisely! Once you have shot them all you lose. The Lunpus eventally finds and eats you.
## Directions
* Press `ARROW` to start a game.
* Use the direction buttons (`NORTH`, `SOUTH`, `EAST`, `WEST`) to move around the cave. Walls appear as glowing segments.
* Press `ARROW` to show you how many arrows you have left. Press a direction to fire one, otherwise press `ARROW` again to cancel.
* Once you win (or more likely die) press `ARROW` again to start a new game.
## Flashing the ATtiny84
### Requirements
* The latest [Arduino IDE](https://www.arduino.cc/en/software).
* [SevSegShift library](https://github.com/bridystone/SevSegShift) (install this under `Tools > Manage Libraries...` inside of the Arduino IDE).
* [ATTinyCore](https://github.com/SpenceKonde/ATTinyCore) to add Arduino support for ATtiny chips (Install this under `Tools > Board: "xxx" > Boards Manager...` of the Arduino IDE).
* [Arduino-Makefile](https://github.com/sudar/Arduino-Makefile) to use the [included Makefile](Makefile) for CLI development.
Once these are installed, wire up your ATtiny with a programmer. I use the [AVR Pocket Programmer](https://www.sparkfun.com/products/9825). If you use something different you will need to change settings in the [Makefile](Makefile).
First set the fuses to get the proper 8 MHz internal clock:
```cli
make set_fuses
```
Once that is successful you can flash the chip:
```cli
make ispload
```
The `ispload` command flashes the program and will also flash the EEPROM which is where all the music, text and "graphics" reside. The 8K flash memory is almost entirely taken up by the program (8146 bytes 99.4% Full) and the EEPROM is alsmot full as well (465 bytes 90.8% Full).
## PCB
The [pcb directory](https://github.com/dmcinnes/lunpus/tree/main/pcb) contains [EasyEDA](https://easyeda.com/) project files that define the schematic and PCB construction. Also in this directory is the latest generation of Gerber files for fabracation.
## Schematic
[](https://youtu.be/uNveLRCgQw0)
## Components
U1: 14-pin chip socket
U1: ATTiny84 microprocessor
U2: SN74HC595N microchip
U3: Piezoelectric Speaker
R1: 470Ω resistor
R2, R3: 330Ω resistor
C1, C2: 1nF ceramic capacitor
SW1: DPDT Switch
H1: 3xAAA Battery Holder
LED1, LED2: 5611AS single digit 7-segment display
NORTH, SOUTH, EAST, WEST, ARROW: tac switches (buttons)
## Construction
All of the components should rest on the top of the circuit board with the
silkscreen, the side with the word "Lunpus". All soldering happens on the
reverse side, without the words.
1. First solder on the resistors, R1, R2 and R3. Clip the excess leads.
R1 is 470Ω, yellow, purple, brown, gold.
R2 and R3 are 330Ω, orange, orange, brown, gold.
2. Next solder on the capacitors C1 and C2, both are 1nF. Clip the excess leads.
3. Solder on the five buttons.
They will fit in the holes in one orientation.
4. Solder the 14-pin chip socket in the U1 position. This is for the
microcontroller. Ensure the notch on one end of the socket matches the notch
on the circuit board.
5. Solder on the SN74HC595N chip in the U2 position.
Ensure the notch on one end of the chip matches the notch on the circuit
board.
6. Solder the speaker in the round position marked "Speaker". Clip the excess
leads. Ensure the positive pin (+) matches what's on the circuit board.
7. Solder the two 7-segment displays to the areas marked LED1 and LED2.
IMPORTANT NOTE! The display on the right, LED2, needs to be soldered in
upside down, with the decimal point on the top. Make sure the display
matches what's printed on the circuit board.
8. Solder the three-pin switch to SW1.
9. Strip the leads from the battery holder to about 1.5 cm. Strip ends of the
insulation of the last 1/2 cm to bare wire.
10. Solder the battery holder leads to the + and - of H1. The red lead goes to +.
11. Attach the battery holder to the back of the circuit board using
double-sided foam tape.
12. Insert the ATtiny84 into the chip socket after it has been flashed.
Ensure the notch on the chip matches the notch of the socket. Be careful
when inserting as pins can easily fold up underneath the chip.
Add 3 AAA batteries, turn on the switch and enjoy!
# License
Lunpus by Doug McInnes is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License.