Skip to content

RotorHazard/RotorHazard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RotorHazard Logo

RotorHazard

FPV Race Timing and Event Management

Uses 5.8GHz video signals broadcast by FPV racing drones for lap timing. Video receiver hardware listens on specified frequencies and communicates times to a central server (usually a Raspberry pi). The server offers race organizer management, pilot/spectator information and results, is accessed with a web browser, and communcates with external systems. Supports up to 16 simultaneous racers.

Tip

Join a community to discuss RotorHazard: Discord | Facebook

Contributions to RotorHazard can be made on Patreon.

Features

  • Self-contained on local hardware, no internet connection needed
  • Hardware synchronized with user interface for accurate start/end signals; compensates for poor network connectivity
  • Connect other systems and extend functionality via plugins
  • Server runs on any device supporting Python

Timing

  • Verified accuracy by independent 3rd party testing
  • Never miss a lap; Recover laps with full accuracy when reviewing race history
  • Accurately tracks analog and digital (HD) video transmitters
  • Simple, visual system calibration before or after a race has completed
  • Learns which calibration values work for each pilot and automatically applies them to new races (adaptive calibration)
  • Advanced signal filtering allows accurate reading both indoors and outdoors, even in difficult multipathing environments

Event Management

  • Run events with hundreds of pilots and race heats
  • Manage pilots, heats, classes, and race formats before or after races are run
  • Supports common event/race formats and ranking structures; extensible by plugin
  • Statistics broken out by event, class, heat, and round
  • Generates overlay displays and results pages for use with live streaming software such as OBS
  • LED and audio support to indicate race staging, starts, lap times, and other events
  • Send live updates of lap times and split times to external systems such as pilot OSD

Getting Started

RotorHazard consists of three primary components: Timing hardware, server, and frontend interface. Most users will begin with RotorHazard by building or buying timing hardware and then installing the server software on it.

Important

Live documentation may contain information that does not apply to the current release. For documentation relating to the current stable version only, follow the Documentation link on the latest-release page.

Timing Hardware

RotorHazard makes use of a collection of RX5808 video receiver modules. Receivers are tuned to active FPV race channels and monitor their signal strength. A small processor (Arduino or STM32) is used to monitor the modules and communicate with the server. Timer builds generally include hardware to run the server as well, making a self-contained unit.

Server

The RotorHazard server aggregates timing signals, handles event structure, calculates results, provides the management interface, and communicates with external timers and systems. It can be run on most systems where Python can be installed, but the recommended and best supported installation is to a Raspberry Pi.

Note

The RotorHazard Install Manager can greatly simplify installation. Once you have installed the operating system to your SD card, download and run the install manager.

Important

The 'main' branch in the GitHub repository will usually contain the latest development code, which may not be stable. To install or upgrade to the latest stable release, please visit the latest-release page.

Frontend (Event Management) Interface

The frontend interface is used for event management and viewing results. The server can be accessed by any device (laptop, phone, tablet) with a modern web browser (Firefox, Chrome, Safari) on any operating system (Windows, MacOS, Android, iOS).

  • Once the server is running, connect to the server's address using standard IP-based networking.
  • All event management is done through the interface.
  • No dedicated software or app is necessary to access the interface.

Additional Resources

RotorHazard's features and functionality can be greatly extended beyond the core system.

Plugins

Plugins allow 3rd parties to develop code which runs on the RotorHazard server.

  • A list of Available Plugins is maintained in the Wiki.
  • See Plugins for information on installing and running.
  • Individual plugins may have specific setup requirements. Be sure to read each plugin's documentation before use.

Wiki

Many additional resources are available from the Wiki, including extended tutorials, build tools, SD card images, and video content. Browsing these resources is strongly recommended for new users.


Feedback

To report bugs or request features, please post a GitHub issue. When reporting issues, use the "Download Logs" button and include the generated '.zip' file.

Community contributions are welcome and encouraged; see Development for more info.