blue-owl-core
Advanced tools
Readme
Blue Owl provides Technical Official device integration for owlcms via a microcontroller powered by Johnny-Five.
Referee control boxes may be used in compliance with the IWF Referee Light System as documented in TCRR 3.3.6. The referee control boxes support:
For competitions run with only one referee, simply configure all three referees with the same buttons. This will cause the single referee control box to send a decision for all three referees.
The down signal box may be used in compliance with the IWF Referee Lifht System as documented in TCRR 3.3.6.5. The down signal box supports:
The timekeeper control box may be used to fully control the timing clock as documented in TCRR 7.10. The timekeeper control box supports:
The jury control panel and jury control units may be used to fulfill all jury member requiremensts as documented in TCRR 3.3.6.11, TCRR 3.3.6.12, and TCRR 7.5. The jury control panel supports:
Each technical official is represented by a model, e.g., Referee. These models provide the logic and APIs necessary for the official, but do not provide any hardware-specific implementations. Instead, the models provide methods for actions that the official can perform and emits events for information provided by owlcms. Each model must be instantiated with a set of modules which provide the hardware-specific implementations.
The documentation uses a few custom types:
The strings aqua, cyan, fuchsia, lime, magenta, white, and yellow.
The strings bad and good.
The strings bad, good, and hidden.
The numbers 1, 2, 3, 4, and 5.
The numbers 1, 2, and 3.
The Owlcms class provides the necessary APIs for two way communication between the models and owlcms. Unless you are building a custom integration with owlcms that does not use the provided models, the API provided by Owlcms will not be used directly.
options: Configuration options for owlcms.
mqttHost (string): The host for the MQTT server that owlcms is connected to.mqttPassword (optional; string): The password for authenticating to the MQTT server.mqttPort (optional; string): The port for the MQTT server.mqttUserName (optional; string): The username for authenticating to the MQTT server.options: Configuration options for the jury.
modules (Array<(jury: Jury) => void>): A set of modules that provide hardware-specific implementations.owlcms (Owlcms): An instance of Owlcms.platform (string): The name of the platform.Provides functionality for starting and stopping the competition, including summoning other officials.
options: Configuration options for the buttons.
badLiftButton (number | string): Which pin the bad lift button is connected to.badLiftButtonPullUp (optional; boolean): Whether the bad lift button should use an internal pull-up resistor.board (optional; Board): Which Johnny-Five board the buttons are connected to.challengeButton (optional; number | string): Which pin the challenge button is connected to.challengeButtonPullUp (optional; boolean): Whether the challenge button should use an internal pull-up resistor.deliberationButton (number | string): Which pin the deliberation break button is connected to.deliberationButtonPullUp (optional; boolean): Whether the deliberation break button should use an internal pull-up resistor.goodLiftButton (number | string): Which pin the good lift button is connected to.goodLiftButtonPullUp (optional; boolean): Whether the good lift button should use an internal pull-up resistor.resumeCompetitionButton (number | string): Which pin the resume competition button is connected to.resumeCompetitionButtonPullUp (optional; boolean): Whether the resume competition button should use an internal pull-up resistor.summonAllRefereesButton (optional; number | string): Which pin the summon all referees button is connected to.summonAllRefereesButtonPullUp (optional; boolean): Whether the summon all referees button should use an internal pull-up resistor.summonReferee1Button (number | string): Which pin the summon referee 1 button is connected to.summonReferee1ButtonPullUp (optional; boolean): Whether the summon referee 1 button should use an internal pull-up resistor.summonReferee2Button (number | string): Which pin the summon referee 2 button is connected to.summonReferee2ButtonPullUp (optional; boolean): Whether the summon referee 2 button should use an internal pull-up resistor.summonReferee3Button (number | string): Which pin the summon referee 3 button is connected to.summonReferee3ButtonPullUp (optional; boolean): Whether the summon referee 3 button should use an internal pull-up resistor.summonTechnicalControllerButton (optional; number | string): Which pin the summon technical controller button is connected to.summonTechnicalControllerButtonPullUp (optional; boolean): Whether the summon technical controller button should use an internal pull-up resistor.technicalBreakButton (number | string): Which pin the technical break button is connected to.technicalBreakButtonPullUp (optional; boolean): Whether the technical break button should use an internal pull-up resistor.Provides functionality for real-time referee decision LEDs.
options: Configuration options for the LEDs.
board (optional; Board): Which Johnny-Five board the LEDs are connected to.referee1BadLiftLed (number | string): Which pin the referee 1 bad lift LED is connected to.referee1GoodLiftLed (number | string): Which pin the referee 1 good lift LED is connected to.referee2BadLiftLed (number | string): Which pin the referee 2 bad lift LED is connected to.referee2GoodLiftLed (number | string): Which pin the referee 2 good lift LED is connected to.referee3BadLiftLed (number | string): Which pin the referee 3 bad lift LED is connected to.referee3GoodLiftLed (number | string): Which pin the referee 3 good lift LED is connected to.Provides functionality for real-time referee decision RGB LEDs.
options: Configuration options for the RGB LEDs.
anode (optional; boolean): Whether the RGB LEDs are common anode.board (optional; Board): Which Johnny-Five board the LEDs are connected to.referee1Pins (object with red, green, and blue keys): Which pin each of the referee 1 RGB LED leads is connected to.referee2Pins (object with red, green, and blue keys): Which pin each of the referee 2 RGB LED leads is connected to.referee3Pins (object with red, green, and blue keys): Which pin each of the referee 3 RGB LED leads is connected to.The model has been initialized.
A referee decision has been made.
data: Data about the decision.
decision (Decision): The referee's decision.number (RefereeNumber): The number indicating which referee made the decision.The referee decisions should be cleared because a clock has started for a new attempt.
Publish the jury's decision for the lift under deliberation.
decision (Decision): The jury's decision of whether the lift was good or bad.Resume the competition.
Stop the competition for the jury to deliberate about the previous attempt due to a challenge.
Stop the competition for the jury to deliberate about the previous attempt.
Stop the competition for a technical break.
Summon a referee to the jury table.
referee (RefereeNumber): The number of the referee to summon.Summon the technical controller to the jury table.
options: Configuration options for the jury member.
modules (Array<(juryMember: JuryMember) => void>): A set of modules that provide hardware-specific implementations.number (JuryMemberNumber): The jury memeber number.owlcms (Owlcms): An instance of Owlcms.platform (string): The name of the platform.Provides functionality for good and bad lift buttons to submit the jury member's decision.
options: Configuration options for the buttons.
badLiftButton (number | string): Which pin the bad lift button is connected to.badLiftButtonPullUp (optional; boolean): Whether the bad lift button should use an internal pull-up resistor.board (optional; Board): Which Johnny-Five board the buttons are connected to.goodLiftButton (number | string): Which pin the good lift button is connected to.goodLiftButtonPullUp (optional; boolean): Whether the good lift button should use an internal pull-up resistor.Provides functionality for displaying the jury member's decision on the jury panel using three individual LEDs for each jury member.
options: Configuration options for the LEDs.
board (optional; Board): Which Johnny-Five board the LEDs are connected to.badLiftLed (number | string): Which pin the bad lift LED is connected to.goodLiftLed (number | string): Which pin the good lift LED is connected to.maskedLed (number | string): Which pin the masked (green) LED is connected to.Provides functionality for displaying the jury member's decision on the jury panel using a single RGB LED for each jury member. When a decision is made, the light will turn green and when all jury members have made a decision, the light will chnge to white or red to indicate a good or bad lift.
options: Configuration options for the RGB LED.
anode (optional; boolean): Whether the RGB LED is common anode.board (optional; Board): Which Johnny-Five board the RGB LED is connected to.pins (object with red, green, and blue keys): Which pin each of the RGB LED leads is connected to.The jury member has made a decision about the current attempt.
data: Data about the decision being revealed.
decision (JuryMemberDecision): Whether the lift was good or bad (or should be hidden).Publish the jury member's decision for the current attempt.
decision (Decision): The jury members's decision of whether the lift was good or bad.Reset the decision because a clock has started for a new attempt.
options: Configuration options for the referee.
modules (Array<(referee: Referee) => void>): A set of modules that provide hardware-specific implementations.number (RefereeNumber): The referee number, with 1 being the referee on the left.owlcms (Owlcms): An instance of Owlcms.platform (string): The name of the platform.Provides functionality for good and bad lift buttons to submit the referee's decision.
options: Configuration options for the buttons.
badLiftButton (number | string): Which pin the bad lift button is connected to.badLiftButtonPullUp (optional; boolean): Whether the bad lift button should use an internal pull-up resistor.board (optional; Board): Which Johnny-Five board the buttons are connected to.goodLiftButton (number | string): Which pin the good lift button is connected to.goodLiftButtonPullUp (optional; boolean): Whether the good lift button should use an internal pull-up resistor.Provides audible feedback to the referee, via a piezo buzzer, when a decision is required and when the jury summons the referee.
options: Configuration options for the buzzer.
board (optional; Board): Which Johnny-Five board the buzzer is connected to.piezo (number | string): Which pin the buzzer is connected to.Provides visual confirmation that OWLCMS has acknowledged the decision.
options: Configuration options for the LEDs.
badLiftLed (number | string): Which pin the bad lift LED is connected to.board (optional; Board): Which Johnny-Five board the LEDs are connected to.goodLiftLed (number | string): Which pin the good lift LED is connected to.NOTE: badLiftLed and goodLiftLed may be set to the same pin if a single LED is being used to confirm the decision was submitted, without indicating which decision was submitted.
Provides visual feedback to the referee, via an RGB LED, when a decision is required, when OWLCMS has acknowledged the decision, and when the jury summons the referee.
options: Configuration options for the RGB LED.
anode (optional; boolean): Whether the RGB LEDs are common anode.board (optional; Board): Which Johnny-Five board the RGB LED is connected to.decisionRequestColor (optional; Color): The color to show when a decision is requested. Defaults to "blue".pins: (object with red, green, and blue keys): Which pin each of the RGB LED leads is connected to.summonColor (optional; Color): The color to show when a decision is requested. Defaults to "yellow".Provides visual feedback to the referee, via an LED, when a decision is required and when the jury summons the referee.
options: Configuration options for the LED.
board (optional; Board): Which Johnny-Five board the LED is connected to.led (number | string): Which pin the warning LED is connected to.Provides tactile feedback to the referee, via a vibration motor, when a decision is required and when the jury summons the referee.
options: Configuration options for the vibration motor.
board (optional; Board): Which Johnny-Five board the vibration motor is connected to.vibrationMotor (number | string): Which pin the vibration motor is connected to.The Referee class emits the following events:
OWLCMS has acknowledged the referee's decision.
data: Data about the decision confirmation.
decision (Decision): The decision that was acknowledged by OWLCMS.The other two referees have made a decision and the athlete is waiting for a decision from the final referee.
The model has been initialized.
The jury has summoned the referee to the jury table.
Publish a decision for the current attempt.
decision (Decision): The referee's decision of whether the lift was good or bad.options: Configuration options for the down signal.
modules (Array<(downSignal: DownSignal) => void>): A set of modules that provide hardware-specific implementations.owlcms (Owlcms): An instance of Owlcms.platform (string): The name of the platform.Provides functionality for controlling electrical power to a device via a relay when the clock reaches 90, 30, or 0 seconds.
options: Configuration options for the relay.
board (optional; Board): Which Johnny-Five board the relay is connected to.pin (number | string): Which pin the relay is connected to.type (optional; "NC" | "NO"): Whether the relay is normally closed (NC) or normally open (NO). Defaults to "NO".Provides functionality for controlling electrical power to a device via a relay.
options: Configuration options for the relay.
board (optional; Board): Which Johnny-Five board the relay is connected to.duration (number): The duration (in milliseconds) that the relay is closed when the down signal is given.pin (number | string): Which pin the relay is connected to.type (optional; "NC" | "NO"): Whether the relay is normally closed (NC) or normally open (NO). Defaults to "NO".The model has been initialized.
The down signal should be shown.
options: Configuration options for the timekeeper.
modules (Array<(timekeeper: Timekeeper) => void>): A set of modules that provide hardware-specific implementations.owlcms (Owlcms): An instance of Owlcms.platform (string): The name of the platform.Provides functionality for controlling the clock.
options: Configuration options for the buttons.
board (optional; Board): Which Johnny-Five board the buttons are connected to.oneMinuteButton (number | string): Which pin the one minute button is connected to.oneMinuteButtonPullUp (optional; boolean): Whether the one minute button should use an internal pull-up resistor.startButton (number | string): Which pin the start button is connected to.startButtonPullUp (optional; boolean): Whether the start button should use an internal pull-up resistor.stopButton (number | string): Which pin the stop button is connected to.stopButtonPullUp (optional; boolean): Whether the stop button should use an internal pull-up resistor.twoMinuteButton (number | string): Which pin the two minute button is connected to.twoMinuteButtonPullUp (optional; boolean): Whether the two minute button should use an internal pull-up resistor.The model has been initialized.
Reset the clock to one minute.
Start (resume) the clock.
Stop (pause) the clock.
Reset the clock to two minutes.
Copyright Scott González. Released under the terms of the ISC license.
FAQs
Technical Official device integration for owlcms
The npm package blue-owl-core receives a total of 20 weekly downloads. As such, blue-owl-core popularity was classified as not popular.
We found that blue-owl-core demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.