Kelder
/
obus
26
0
Fork 0
Code Issues 3 Pull Requests Packages Projects Releases Wiki Activity
Main development happens at https://github.com/ZeusWPI/OBUS/
259 Commits 3 Branches 0 Tags 4.7 MiB
C++ 39.7%
JavaScript 22%
OpenSCAD 15.1%
Python 12.6%
HTML 7.3%
Other 3.3%
Go to file
Midgard 2d21884f37
Add documentation for needy finetuner 		2022-03-18 21:49:41 +01:00
.github/workflows Implement caching in docs build 2021-07-31 05:55:15 +02:00
docs Add documentation for needy finetuner 2022-03-18 21:49:41 +01:00
lib Add reset_press_count method to Debounced 2022-03-18 21:42:42 +01:00
misc Reverse engineered and wired up R455 timer 2022-02-01 12:56:09 +01:00
moana Assign ID 3 2022-03-15 12:06:45 +01:00
pcb Some more notes for new PCB design 2022-02-11 21:15:08 +01:00
python fixed small errors 2022-03-15 19:11:07 +01:00
src Add documentation for needy finetuner 2022-03-18 21:49:41 +01:00
.editorconfig Add editorconfig 2020-08-10 15:34:15 +02:00
LICENSE Add MIT license, approved by all previous contributors 2020-08-28 03:32:33 +02:00
README.md Wiring info 2022-03-11 11:36:24 +01:00

README.md

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. Inspired by the amazing software game Keep Talking and Nobody Explodes.

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.

  1. (Read the "Getting started guide" to get a general idea of how OBUS works.)
  2. Install the Arduino IDE.
  3. Clone this repository with Git in a permanent location on your drive.
  4. 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)
  5. Follow these steps to install the CAN library
  6. Execute ./src/new_module.sh to create a new module. When asked for a type, you'll probably want to choose 'puzzle'.
  7. Edit the newly generated .ino file, either in the Arduino IDE or in your own editor.
  8. 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.
  9. 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.
  10. If you get permission errors, try adding yourself to the dialout or uucp (Arch Linux) group

A screenshot of the OBUS controller web page, showing a countdown timer, a list of connected modules and the strikes

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