Skip to content

RotorHazard/VRxC-Fusion

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 

Repository files navigation

RotorHazard VRx Control for TBS Fusion

This system allows RotorHazard to communicate with TBS Fusion modules, sending race status messages, lap times, and split data in real time to the pilot's OSD. In the future, this system may be extended to provide race directors with module status information, and set pilot's frequency and video transmitter power level from within the RotorHazard interface.

Installation and Setup

The system is composed of a RotorHazard plugin and a hardware communicator.

RotorHazard Plugin

RotorHazard 4.0 or later is required.

Copy the vrx_tbs plugin into the src/server/plugins directory in your RotorHazard install.

If installation is successful, the RotorHazard log will contain the message Loaded plugin module vrx_tbs and Importing VRx Controller tbs.

Communicator

The communicator code should be installed on an ESP32. ESP32 development modules are widely available and include a USB interface.

Flash the code to the ESP32 using the Arduino IDE:

  • Install Arduino IDE
  • Install ESP32 board definitions for Arduino
  • Plug in the ESP32 module
  • Load the code from tbs-fusion-vrxc/tbs-fusion-vrxc.ino
  • Select the proper board and port from the dropdown in the toolbar (Try ESP32 Dev Module if not sure)
  • Select "Upload" (right arrow button) in the toolbar

The development code contains defines to enable an OLED display and serial debug monitoring. It is not recommended to install support for and enable these features unless you will be working on the code, as they considerably reduce performance of the communications module.

Plug the flashed module into the timer via any USB port and restart RotorHazard. The plugin will automatically detect the connected module on startup. If this step is successful, you will see Found Fusion comms module at /dev/ttyUSB0 in the log.

Usage

For Pilots

Update the TBS Fusion module to at least v2.30 and the Fusion WiFi to at least v2.06.

Enable ESPNOW communication on the Fusion Wifi module.

  • Open menu
  • Select Settings
  • Select CRSF
  • Select Fusion WiFi
  • Select Pro
  • Change ESP NOW to Enable
  • Exit the menu
  • Restart the Fusion

Find your MAC address to give to the race director.

  • Ensure WiFi is ON (Menu -> Settings -> WiFi)
  • Using any WiFi-capable device (phone, laptop), view the available network list. Find the network name beginning with tbs_fusion_.
  • The 12-character code at the end of the network name is the MAC address.

For example, if the network name is tbs_fusion_ABCDEF123456, then your MAC Address is ABCDEF123456.

For Race Directors

The Fusion plugin will add a Fusion MAC Address data field to each pilot in the Pilots panel of the Format page. For each pilot, fill this field with the 12-character MAC Address provided by the pilot. (Valid hex characters are digits 0–9 and letters a–f).