The system consists of three elements: The game server, the bridge and the l0dable r_player.

The game server uses the bridge to announce the game, receive button presses and (in the future) send text to the display of a player.

The bridge is a r0ket running a special firmware. It is attached via USB to the computer running the game server. It can receive and send on any channel and with any address.

The l0dable runs on the r0kets of the players. It displays a list of available games and lets the player join a game. It can also transmit the nickname of the player to the game. In a future version it will be able to display text on the LCD.

To implement your own game server you can use our python library r0ketrem0te. It is located in the git at https://github.com/r0ket/r0ket/tree/master/tools/game .

It depends on the python library crcmod. You can use pypi to install it. With Ubuntu run:

sudo apt-get install python-stdeb
sudo pypi-install crcmod

Now you can install the library:

cd tools/game
sudo python setup.py install

The py-pong directory contains a sample implementation for a multi-player pong using the game server. Run it with:

cd tools/game/py-pong
python main.py

The game will wait until two players have connected and transmitted their nick name. It will then start the game until one of the players shuts down the l0dable or gets out of reach.

You need to have pygame installed for py-pong.

The library is currently only tested with Linux.

The firmware for the bridge is located in the file firmware/applications/bridge.c

To build it you have to edit firmware/core/projectconfig.h and

1. deactivate CFG_USBMSC
2. activate CFG_USBCDC

Then run:

cd firmware
make APP=bridge

Now flash it using

../tools/bootloader/autoflash

A precompiled image can be found at https://brezn.muc.ccc.de/~schneider/bridge.bin

The l0dable is located at firmware/l0dables/r_player.c

To build it run:

cd firmware
make APP=final
make APP=final l0dables

Then copy l0dables/r_player.c0d to the r0ket. We will put up a pre compiled l0dable before 28C3. We are still actively developing for it.

If you have a game server running in the vicinity the l0dable will show you the games it found. Select the game you want to play and press right. The game can now request your nickname. The l0dable then transmits it to the game and starts to send the state of the button. You can now interact with the game. The l0dable transmits the state of the button on a regular basis. Currently about every 50ms.

Currently there is no way to exit the l0dable and there is no code to display text.

To write your own game server you can use the r0ketrem0te Python library. Have a look at the main.py and pypong/player.py for an example application. The r0ketrem0te.game.Game class implements most of the things that have to be taken care of.

In the constructor you have to specify the following parameters:

1. The channel on which the game runs. For now we recommend channel 83
2. The channel to announce the game. For now we recommend channel 81
3. The mac on which the game should be announced. For now we recommend “REM0T” (as list of ASCII values. See py-pong/main.py)
4. The maximum number of players
5. If the game should ask for the names of the players

The Game class keeps track of active players. If a player does not send a packet for 10 seconds she is removed from the list of active players.

There are callbacks for

1. the addition and removal of players
2. new packets sent by players. This includes joins, nicknames and the state of the button