Open Source
Hardware & Art

GfxHax DrinkDuino

Welcome to the DrinkDuino Game Page

This game is to be used with the DrinkShield or any product that supports the DrinkShields API.  This game is 100% open source under the GPL license.  The DrinkDuino is developed on Linux but we use open source and multi-platform libraries wherever we can.  Once the Linux version is stable we will begin porting efforts to other platforms.

WARNING:  This is a drinking game!  You must be legally permitted to drink in your country to play.  Due to the nature of this game, it is likely you will get drunk very quickly.  If you are playing this game at a party (recommended) make sure that you have adequate means of transportation arranged ahead of time.  Also, be sure to take lots of pictures and send them to [email protected].  You’ve been warned.

Download  (This is being prepared for publication as we speak…work in progress)

Screenshots

DrinkDuino Splash Screen

Splash Screen

Preparing the DrinkShield

To prepare the drink shield you need to load the game firmware into the device.  If you haven’t already done so you will need to download the firmware from: http://code.google.com/p/drinkshield/downloads/list Follow the instructions to install the Arduino libraries, then load up the Arduino program.  In the Arduino software goto File->Examples->DrinkShield->DrinkDuinoGame.  Upload to your board.  When the board resets the player ready lights should flash a few times, then turn red.

Playing

Start the game from the command line (or create a shortcut).  You probably won’t need any command line options but some are available and are useful if you have your drinkshield plugged into the non-default port or you want to use more than one drinkshield (hehe).

Some command line options:

-p|--port <serial> Serial port. Default: /dev/ttyUSB0
-e|--emulate       Emulate a drinkShield (debug mode)
-f|--fullscreen    Initialize in fullscreen mode

You can specify more than one -p|–port option to support multiple drink shields.

Once the game finishes running you will be brought to a screen that has two columns.  The column on the left is the players you have added to the DB, the players on the right are the ones that will be playing the game with you this session.  If this is your first time running, both columns will be empty.

Add players by pressing the road sign with the Plus symbol on it at the bottom of the screen.  This will take you to the photo booth.  If you do not have a webcam attached or do not want to use a picture of yourself then simply do not press the ‘Smile’ button.  If you do press the ‘Smile’ button the camera will countdown and take 4 pictures of you.  You need to enter a name for yourself (just start typing) then press done.  If you enter a name w/o pressing smile or if you don’t have a webcam then an anonymous picture will be used instead.

Go ahead and add all the users in your party.  They should now show up on the left column (users in your DB).  Click on all the users that are ready to play (You can add more later) then click the arrow that points to the Active Players column.  The users will pop over, and you can press done to start playing.

When somebody is ready to test their scores, select their player in the top profile bar.  If you have taken pictures, the active player will animate.  Press the giant Ready button at the bottom and the Green light on the Drink Shield(s) should turn on.  When the player is ready they should take a drink then blow onto the MQ-3 sensor (the part that is marked “Blow Me”).  The light bar should raise up.  When it reaches it’s peak, the score should register with the game.  A little dancing guy will pop up along with your score indicating how well you did.  If the person is not drunk enough to register or just backs down you can press the small red button in the lower right corner to abort that person’s turn.

If you ever need to recalibrate the device to the current air conditions you can click on the spinning gears in the lower left corner.  The drink shield should blink both ready lights as it takes some air samples.  Once they are done blinking you should be ready to play.

Pressing ESC exits the game.   All scores are automatically saved in the DB.

Compiling

Check the README file for any dependencies.  This game is developed on Linux Debian/Ubuntu, but will be ported elsewhere.  When using SVN, it should compile fine on these platforms.

  • ./configure
  • make
  • make install

You should specify where you want the data files to be installed using –with-data-path.  To run druinkduino out of the src directory you should specify ./configure –with-data-path=../data

make install is one of the last things I test so use with caution if using SVN.

Contact Us

If you have patches, flames, suggestions, comments, etc.  You can email them to [email protected]

Pics or video links goto: [email protected]