Cheesy Arena

A field management system that just works.

Key features

Check out a video overview of Cheesy Arena's functionality.

For participants and spectators:

Same network isolation and security as the official FIRST FMS
No-lag realtime scoring
Team stack lights and sevent-segment display are replaced by an LCD screen, which shows team info before the match and realtime scoring and timer during the match
Smooth-scrolling rankings display
Direct publishing of schedule, results, and rankings to The Blue Alliance

For scorekeepers:

Runs on Windows, Mac OS X, and Linux
No install prerequisites
No "pre-start" – hardware is configured automatically and in the background
Flexible and quick match schedule generation
Streamlined realtime score entry
Reports, results, and logs can be viewed from any computer

License

Teams may use Cheesy Arena freely for practice, scrimmages, and off-season events. See LICENSE for more details.

Installation and use

Via binaries:

Download the latest release for OS X or Windows
Unzip the file
On Mac OS X, run cheesy-arena.command, and on Windows, run cheesy-arena.exe
Navigate to http://localhost:8080 in your browser (Google Chrome recommended)

From source:

Download Go
Set up your Go workspace
If you're using Windows and don't already have a working version of GCC (needed to compile a dependency), install TDM-GCC.
Download the Cheesy Arena source and dependencies with go get github.com/Team254/cheesy-arena
Compile the code with go build
Run the cheesy-arena or cheesy-arena.exe binary
Navigate to http://localhost:8080 in your browser (Google Chrome recommended)

Configuration:

Set the IP address of the computer running Cheesy Arena to 10.0.100.5. Driver stations will broadcast their presence on the network to this hardcoded address so that the FMS does not need to discover them by some other method.

Under the hood

Cheesy Arena is written using Go, a relatively new language developed by Google. Go excels in the areas of concurrency, networking, performance, and portability, which makes it ideal for a field management system.

Cheesy Arena is implemented as a web server, with all human interaction done via browser. The graphical interfaces are implemented in HTML, JavaScript, and CSS. There are many advantages to this approach – development of new graphical elements is rapid, and no software needs to be installed other than on the server. Client web pages send commands and receive updates using WebSockets.

SQLite3 is used as the datastore, and making backups or transferring data from one installation to another is as simple as copying the database file.

Schedule generation is fast because pregenerated schedules are included with the code. Each schedule contains a certain number of matches per team for placeholder teams 1 through N, so generating the actual match schedule becomes a simple exercise in permuting the mapping of real teams to placeholder teams. The pregenerated schedules are checked into this repository and can be vetted in advance of any events for deviations from the randomness (and other) requirements.

Cheesy Arena includes support for, but doesn't require, networking hardware similar to that used in official FRC events. Teams are issued their own SSIDs and WPA keys, and when connected to Cheesy Arena are isolated to a VLAN which prevents any communication other than between the driver station, robot, and event server. The network hardware is configured via SSH and Telnet commands for the new set of teams when each mach is loaded.

PLC integration

Cheesy Arena has the ability to integrate with an Allen-Bradley PLC setup similar to the one that FIRST uses, to read field sensors and control lights and motors. The PLC hardware travels with the Chezy Champs field.

LED hardware

Due to the prohibitive cost of the LEDs and LED controllers used on official fields, a custom solution was developed for Chezy Champs using consumer-grade LED strips and embedded microcontrollers.

Advanced networking

See the Advanced Networking wiki page for instructions on what equipment to obtain and how to configure it in order to support advanced network security.

Contributing

Cheesy Arena is far from finished! You can help by:

Checking out the TODO list, writing a missing feature, and sending a pull request
Filing any bugs or feature requests using the issue tracker
Contributing documentation to the wiki
Sending baked goods to Pat

Acknowledgements

Several folks have contributed pull requests. Thanks!

In addition, the following individuals have contributed to make Cheesy Arena a reality:

Tom Bottiglieri
James Cerar
Kiet Chau
Travis Covington
Nick Eyre
Patrick Fairbank
Eugene Fang
Thad House
Karthik Kanagasabapathy
Ken Mitchell
Andrew Nabors
Jared Russell
Austin Schuh
Colin Wilson

themacman/cheesy-arena