Keycode Access

From Noisebridge
Revision as of 23:33, 21 September 2012 by Flamsmark (Talk | contribs)

Jump to: navigation, search

This page documents the current implementation of the entry keypad, and proposed additions. If you would like to help out, you might want to make this page more accurate, or implement some of the wishlist. This system is a delicate balance of different people's needs and concerns, so changing the basic way that it operates would be poor form. To build an alternative way to access Noiseridge, consider building software that accesses the API.




Please add yourself here if you're a stakeholder on this project.

Implementation Status


A script on Minotaur called baron manages the payphone keypad stationed outside Noisebridge's gate. The payphone is connected to Minotaur by a long blue ethernet cable which runs up the stairwell and across the ceiling. When a use enters a valid code followed by #, baron uses the Noisebridge API to open the gate, while the payphone LED flashes blue, and a "happy" sound is heard. If an incorrect code is entered, or enough time passes between button presses, the payphone LED flashes red, and a "sad" sound is heard. If the gate API throws an error, the light turns red and a sad noise is played three times.


  • The keypad hardware hooked up to Minotaur at /dev/ttyS3
  • /usr/local/share/baron/noisebridge-baron/ - baron script, takes arguments --port=/dev/whatever and --codefile=/var/blablabla/codes
  • /etc/init/baron.conf - jesse's init script
  • /usr/local/share/baron/codes.txt - codes file, any line starting with a 4-7 digit number (ignoring whitespace) is interpreted as a valid code, # is used for comments

Please label your codes so that others know who to contact and when to expire them.

Future Plans

To improve, the code, please issue a pull request against It you improve the hardware, please document the new state here, and make note of your changes in the changelog. If you would like to make changes to how the system works, as opposed to just how elegantly it's implemented, please talk to the people named above.

Keycode Generation

There can be any number of plugins that generate keycodes, as long as they are non-destructively copied to the codes file on Minotaur.


  • Add a "bad" codes list, to block codes from being reused.
  • Add the ability to expire codes - maybe a comment in the codes.txt file?
Personal tools