Skip to content

Latest commit

 

History

History
35 lines (22 loc) · 3.88 KB

README.md

File metadata and controls

35 lines (22 loc) · 3.88 KB

owlcms-firmata

This project allows hobbyists to build their own owlcms refereeing devices using Arduino boards. Construction diagrams and configuration files are provided, see below.

owlcms-firmata is a user-configurable software interface to connect refereeing devices with the owlcms Olympic Weightlifting competition management system. Instructions for use are found in the INSTRUCTIONS.md file. The software uses configuration files to change pin assignments as required. No programming is required. See the diagrams/CONFIGURATION.md file for details.

Devices

This project provides hardware diagrams and configuration files for the following:

  • Timekeeper Buttons The buttons can be connected to the announcer laptop and do not interfere, or to a separate timekeeper laptop if one is used.
  • Refereeing Devices This is the typical owlcms setup, used with a laptop provides the down signal and buzzer. The design includes LEDs and buzzers to provide reminders and summon the referees. These can be omitted to create a minimal buttons-only design.
  • Refereeing with External Down Signal Light and Buzzer Two relays control the external light and buzzer. This allows compliance with the traditional competition setup.
  • Jury President Buttons This is the typical owlcms setup, used with a laptop that shows the referee and jury member decisions.
  • Full Jury President Console with Indicator Lights. This diagram shows how a device that has all the indicator lights described in the IWF TCRR can be built.

Since everything is defined by configuration files, you can create your own devices as you wish -- for example, creating an announcer keypad with an additional buttons to pause the competition or signal challenges, etc.

Overview

The driver relays commands from owlcms to the board and sends events from the board back to owlcms. Any board that can be loaded with Firmata can be used. The following illustrates the process using the refereeing devices.

overview

Any board that can be loaded with Firmata can be used. Firmata (see the firmware folder) is loaded once and not touched afterwards. The program also supports the pin assignments for commercial devices being developed by the Blue-Owl project.

The pin configuration for a device is read from an Excel spreadsheet.

  • Each pin number can be mapped to a button and the MQTT message to be sent when the button is pressed is defined.

  • Conversely, an MQTT message received can be mapped to one or more pins. For each pin the expected action is given -- turning the pin on or off, flashing the pin, emitting a tone, triggering a relay.

  • Sample pinout configurations are copied into the installation directory. You can take these files and edit them to change the pin numbers. To run with the modified assignments, copy the files to the installation directory next to the program.

  • Instructions for using the Wokwi Arduino simulator together with this program as also given: this allows running the design live with owlcms before building it.

Credit The idea and incentive for this program come from the Blue-Owl project by Scott González.

98f994541d1871554ba079bfcef355055d24a7584f06703b90550e2649956093