Skip to content

And2Ex/VBtelemetry

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 

Repository files navigation

VB Telemetry for EdgeTX (128×64 Monochrome ELRS Radios)

License Telegram Monobank Patreon


Overview

VB Telemetry is a Lua telemetry suite for EdgeTX radios with a 128×64 monochrome display and ELRS telemetry support.

It provides compact and readable flight telemetry designed specifically for small monochrome radio screens.

The interface focuses on:

  • quick readability
  • GPS navigation
  • blind-flying support
  • minimal screen clutter
  • statistics and GPX logging

Beta Status

VB Telemetry is currently available in two beta versions:

  • Lite — open-source lightweight version with only the main telemetry screen
  • Full Beta — full-feature beta version, currently available free of charge

The script has not been tested on real drones by the author, because the author currently does not have drones available for live testing.

Development and verification were done only on the radio and Lua script side.

Because of this:

  • use it at your own risk
  • expect possible bugs or telemetry edge cases
  • verify all functions carefully before real flight

Download

Lite version includes:

  • main telemetry screen only
  • minimal memory usage
  • open-source source code

The Lite source code in this repository is provided as .lua files.

Before running Lite from repository source, you need to precompile the files inside the VBlib folder:

  1. Open the radio file manager
  2. Go to the VBlib folder
  3. Run each file there one by one so EdgeTX compiles them to .luac
  4. Reboot the radio
  5. Start VBtlm

In the Lite release archive, the compiled files are already included.


Full Beta version includes:

  • main telemetry screen
  • GPS screen
  • coordinates QR generator
  • GPX track logging
  • flight statistics

This version is currently available free during beta.


Main Features

1. Main Telemetry Screen

image

The main screen provides the most important flight data in a compact layout.

Displayed data includes:

  • model name
  • radio battery voltage
  • drone battery bar
  • ELRS packet rate or RF mode
  • ARM / DISARM state
  • flight mode
  • timers
  • uplink and downlink signal blocks
  • transmit power
  • Link Quality indicators

Signal direction is separated:

  • left side — radio → drone
  • right side — drone → radio

Each antenna block combines several signal indicators in one compact visual element:

  • outer step bars show Link Quality
  • larger main bars show signal strength in dBm
  • darkened lower bars represent SNR, drawn this way to visually show the noise level relative to the useful signal

The main screen also shows:

  • TX power as compact step bars, from 0W / PIT mode up to 2W
  • RFMD / packet rate as step bars based on frequency: higher frequency = shorter bars

ARM, TURTLE and BEEPER states are read from EdgeTX switches.


2. GPS Screen

image

The GPS screen focuses on navigation.

It displays:

  • Home direction arrow
  • distance to Home
  • absolute altitude (SL)
  • relative altitude (AG)
  • GPS speed
  • satellites count
  • live coordinates

This screen also includes compact signal indicators for:

  • signal levels
  • transmit power
  • packet rate / RFMD

Before the first ARM, altitude is shown as MSL / SL (above mean sea level).
After ARM, altitude switches to AGL / AG relative to the saved Home point.

Even without video feed the pilot can still see:

  • where Home is
  • how far the drone is
  • current altitude
  • movement speed

Supports:

  • Metric
  • Imperial

3. Coordinates QR Screen

image

The script can generate a QR code from current coordinates.

This allows:

  • quickly sharing the location
  • opening coordinates on a phone
  • sending recovery position
  • saving drone location

Latitude and longitude are also displayed as text.


4. Flight Statistics Screen

image

The statistics page stores and displays flight results.

Tracked values include:

  • last flight time
  • total flight time
  • last maximum altitude
  • total maximum altitude
  • last maximum distance
  • total maximum distance
  • last maximum speed
  • total maximum speed
  • number of arms
  • total flights

Both Last and Total values are displayed.


5. GPX Logging

VB Telemetry can record telemetry data into GPX tracks.

Tracks are saved to:

/LOGS/VB_GPX

If this folder does not exist, create it manually.

GPX logging is intended for post-flight review and route analysis.

Logged values may include:

  • relative altitude
  • GPS speed
  • radio battery voltage
  • RSS values
  • link quality
  • transmit power
  • satellites count

Logging starts on first ARM after Home is established and stops when Home is reset.

Resetting Home

image
  • Select Reset Home in script settings
  • Replace drone battery
  • Reboot the radio

6. Blind-Flying Support

The script allows navigation even without FPV video.

This can help during:

  • video signal loss
  • fog
  • poor visibility
  • dusk
  • stabilization-mode flight

Telemetry still shows:

  • home direction
  • distance to home
  • altitude
  • speed

This does not replace failsafe systems or safe flight procedures.


7. Quick Screen Switching

The script allows fast switching between telemetry screens.

To switch screens quickly:
Double press ENTER

Pressing ENTER twice quickly toggles between available telemetry screens.


8. Quick Menu

The script includes an internal menu for quick navigation.

Menu items include:

  • main screen
  • reset Home point
  • coordinates QR
  • statistics
  • GPX tracks
  • info page
  • settings

9. Script Settings

image

The settings page allows configuration of:

  • Arm switch
  • Turtle switch
  • Beeper switch
  • Units
  • Invert UI

For radios with inverted OLED displays you can enable Invert UI so the interface is rendered correctly.


Supported Hardware

VB Telemetry is designed for radios with:

  • EdgeTX firmware
  • 128×64 monochrome display
  • ELRS internal or external module

Memory and RAM Limitations

EdgeTX monochrome radios have very limited Lua memory.

Because of this, the current Full Beta is distributed as a precompiled build.

At the moment this is necessary for stable operation on constrained hardware.

These features are especially memory-sensitive:

  • Statistics
  • GPX logging

If RAM is insufficient:

  • the main telemetry screen may still work
  • statistics or GPX logging may not function

This is a hardware limitation of small radios.


Installation

Extract the contents of the archive to the root of the SD card.

For Lite source files from the repository, precompile the files in VBlib first as described in the Download section above.


Enabling the Script in EdgeTX

image
  1. Open Model Menu
  2. Go to DISPLAY
  3. Select a screen
  4. Choose:
    • Type: Script
    • Script: VBtlm

Timers

image

Flight timers must be configured in the model SETUP page of EdgeTX.

The script reads and displays timer data from the radio.


Restrictions and Usage Policy

Use of this project is prohibited by the author's policy for launches from:

russia, belarus, iran, north korea, syria, iraq, afghanistan, yemen, kazakhstan, turkmenistan, uzbekistan, kyrgyzstan, tajikistan, china, mongolia, myanmar, eritrea, ethiopia, somalia, south sudan, sudan, libya, chad, niger, mali, burkina faso, guinea, democratic republic of congo, congo, zimbabwe, cuba, nicaragua, venezuela, temporarily occupied territories of ukraine.

This reflects the author's ethical position.

The author assumes no responsibility for misuse.


Safety Notice

This project is not a certified safety system.

It does not replace:

  • pilot training
  • legal compliance
  • failsafe configuration
  • Return-to-Home logic
  • visual awareness

Always verify telemetry and system behavior before real flight.


Support the Project

If you want to support development:

Supporting this project helps continued development of VB Telemetry.

Your support allows:

  • improving the current monochrome version
  • fixing bugs and optimizing performance
  • adding new telemetry features
  • developing a more advanced version designed for EdgeTX radios with color displays

The color display version will allow more complex interfaces, additional telemetry visualizations and extended functionality that are not possible on small monochrome screens.

Note: a portion of donations may also be used to support Ukraine and the Armed Forces of Ukraine.

Ukraine (Monobank)

https://send.monobank.ua/jar/7VF9b8mPJj


International (Patreon)

https://patreon.com/VBtelemetry


Telegram

Project updates:

https://t.me/VBtelemetry

About

Advanced EdgeTX telemetry suite for RadioMaster transmitters

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages