47 lines
No EOL
3 KiB
Markdown
47 lines
No EOL
3 KiB
Markdown
# Ontmijnen van een Bom vereist Uitstekende Samenwerking
|
|
|
|
You see an armed time bomb but don't know how to disarm it. Your friends found a manual to defuse the bomb and you have them on call. This is the premise of the game OBUS, a hardware project by [Zeus WPI](https://zeus.ugent.be). Inspired by the amazing software game [Keep Talking and Nobody Explodes](https://www.keeptalkinggame.com/).
|
|
|
|
## Get started writing a module
|
|
|
|
These are the instructions for building your own OBUS module with an Arduino Nano v3 and the custom PCB. If
|
|
you're using other hardware, you might need to do some things differently.
|
|
|
|
0. (Read the "[Getting started guide](docs/GETTING_STARTED.md)" to get a general idea of how OBUS works.)
|
|
1. [Install](https://www.arduino.cc/en/Guide/#install-the-arduino-desktop-ide) the Arduino IDE.
|
|
2. Clone this repository with Git in a permanent location on your drive.
|
|
3. Symlink the library: `ln -s /ABSOLUTE/PATH/TO/REPO/lib /PATH/TO/Arduino/libraries/obus`
|
|
(on most Linux distro's, this the Arduino folder is in `$HOME/Arduino`)
|
|
4. Follow [these steps](https://github.com/autowp/arduino-mcp2515/#software-usage) to install the CAN library
|
|
5. Execute `./src/new_module.sh` to create a new module. When asked for a type, you'll probably want to choose 'puzzle'.
|
|
6. Edit the newly generated .ino file, either in the Arduino IDE or in your own editor.
|
|
7. In the Arduino IDE, select the correct board (Arduino Nano) and processor (ATmega328P (Old Bootloader)). After that,
|
|
flash your code to the Arduino and test it out.
|
|
8. On some Linux distributions, you'll need to prevent BRLTTY from taking over the serial adapter because BRLTTY thinks it's a Braille keyboard. You can do this by uninstalling it (`pacman -R brltty`) or by [disabling it and then rebooting](https://unix.stackexchange.com/questions/670636/unable-to-use-usb-dongle-based-on-usb-serial-converter-chip).
|
|
9. If you get permission errors, try adding yourself to the dialout or uucp (Arch Linux) group
|
|
|
|
|
|
|
|
## Background
|
|
### Game
|
|
|
|
The game is played by at least two players. The goal is to defuse a bomb,
|
|
this is accomplished by defusing every module on that bomb before the bomb
|
|
timer runs out.
|
|
|
|
There are two roles:
|
|
|
|
- Expert: this person can read the manual about how to defuse the bomb, but cannot see nor interact with the bomb
|
|
- Defuser: this person can see and interact with the bomb, but cannot read the manual
|
|
|
|
These two roles can communicate with each other. To successfully defuse the bomb, they must
|
|
communicate efficiently and clearly. If a mistake is made, the team gets a strike.
|
|
If they get too many strikes or the timer runs out, the bomb explodes.
|
|
|
|
|
|
## Common wiring between all modules
|
|
|
|
- CAN-H: red on JST 3 pin connectors, purple on CAN wire
|
|
- CAN-L: white on JST 3 pin connectors, brown on CAN wire
|
|
- +12V: red on 2 pin JST connector and power wire
|
|
- ground: black on 2 pin JST connector, no color on power wire |