Drone VTX Tables Guide: Finally Make Your FPV Video Transmitter Behave
Imagine finally finishing your FPV build, plugging in your goggles, and seeing nothing but static—even though you know your camera and VTX are powered up.
TLDR; A VTX table is a configuration file in Betaflight that acts like a translator between your flight controller and video transmitter. It tells your FC exactly which bands, channels, and power levels your specific VTX supports so you can change settings through your OSD or radio. Without the correct VTX table, SmartAudio or Tramp won’t work, and you’ll be stuck pressing that tiny button on your VTX to change channels .
Key Takeaways
- VTX tables replaced hardcoded settings in Betaflight 4.1 to make the system more flexible for all types of video transmitters .
- You need the right table for your specific VTX—using the wrong one can make your OSD show the wrong channel, or your VTX just ignores the commands entirely .
- SmartAudio has multiple versions (1.0, 2.0, 2.1), and each needs different power values in the table. Using the wrong version is a super common mistake .
- “Device Ready: Yes” is your success indicator in the Betaflight VTX tab—if it says “No,” your FC can’t talk to your VTX .
- Always load the table before you change settings—otherwise, your OSD might show one channel while your VTX is broadcasting on another .
Wait, What Exactly Is a VTX Table?
Back in the old days (pre-Betaflight 4.1), the FC had all the frequency tables and power levels baked right into the firmware. That worked, but it was a nightmare for developers—every new VTX that came out needed a firmware update.
So Betaflight developers came up with a brilliant solution: VTX tables .
Think of it like this: your flight controller and your VTX speak different languages. The VTX table is a phrasebook that translates commands like “switch to channel 3” into something your specific VTX understands.
The table defines:
- How many bands your VTX supports (max 8)
- How many channels per band (max 8)
- The actual frequencies for each band and channel
- How many power levels your VTX has (max 8)
- What power values to send (these are different depending on SmartAudio version)
- What power labels to show in your OSD
Important note: If you’re using a DJI or Walksnail digital video system, you can ignore VTX tables entirely—they work differently. This is strictly for analog and HDZero VTXs .
How to Set Up Your VTX Table (The Right Way)
There are three main ways to get the VTX table into Betaflight, and I’ll rank them from “easiest” to “you’ll learn something.” Here’s the thing: this is a mandatory step if you want to change channels from your OSD or radio .
1. Load a Pre-made JSON File (Easiest)
This is the method you want. Most VTX manufacturers provide a ready-to-go VTX table file on their website or product page .
Here’s what you do:
- In Betaflight Configurator, go to the Video Transmitter tab .
- At the bottom, click Load from file .
- Select the JSON file for your VTX.
- Click Save to write it to the FC .
When that’s done, check the “Current Values” panel. If it says Device ready: Yes, you’re golden .
2. Copy-Paste CLI Commands (Intermediate)
If you have a text block of vtxtable commands, paste them into the Betaflight CLI and type save .
Here’s what a proper VTX table CLI dump looks like:
vtxtable bands 5
vtxtable channels 8
vtxtable band 1 BOSCAM_A A FACTORY 5865 5845 5825 5805 5785 5765 5745 5725
vtxtable band 2 BOSCAM_B B FACTORY 5733 5752 5771 5790 5809 5828 5847 5866
vtxtable band 3 BOSCAM_E E FACTORY 5705 5685 5665 5645 5885 5905 5925 5945
vtxtable band 4 FATSHARK F FACTORY 5740 5760 5780 5800 5820 5840 5860 5880
vtxtable band 5 RACEBAND R FACTORY 5658 5695 5732 5769 5806 5843 5880 5917
vtxtable powerlevels 4
vtxtable powervalues 14 20 26 30
vtxtable powerlabels 25 100 400 1W
saveA quick word of warning: Many of the default templates enable all channels. Some channels (like E4, E7, E8) aren’t legal in places like the US. Always check local regulations and disable illegal channels by setting their frequency to 0 .
The SmartAudio Version Trap (This Catches Everyone)
Here’s where most pilots get tripped up. “SmartAudio” isn’t one thing—it’s three different things.
| SmartAudio Version | Power Values | Common VTX Examples |
|---|---|---|
| 1.0 | 7, 16, 25, 40 | First-generation TBS devices |
| 2.0 | 0, 1, 2, 3 | Most non-TBS VTXs, older TBS Unify Pro |
| 2.1 | 14, 20, 26, 30 (in dBm) | TBS Pro32, TBS EVO |
If you use a SmartAudio 2.1 table on a 2.0 VTX, the power commands just get ignored. The VTX might still change channels (since those commands are usually compatible), but power control won’t work .
How to Check Your SmartAudio Version
Betaflight has a neat trick to tell you exactly what version you’ve got:
- Go to the Blackbox tab.
- Set Blackbox Debug Mode to
SMARTAUDIO. - Click Save & Reboot.
- Go to the Sensors tab (turn on Expert Mode if needed) .
- Plug in your battery (with the antenna attached!).
- Look at the Debug 0 value .
| Debug Value | SmartAudio Version |
|---|---|
| 100 or 116 | 1.0 |
| 200 or 216 | 2.0 |
| 300 or 316 | 2.1 |
The +16 (e.g., 216 instead of 200) means the VTX is “unlocked” and all frequencies are available .
Troubleshooting: Why Isn’t This Working?
Here are the most common issues and how to fix them:
Problem: “Device Ready: No”
The VTX tab says your device isn’t ready. This means the flight controller can’t talk to your VTX . Check these:
- Wiring: Your SmartAudio/Tramp wire needs to go to a TX pad on your FC, not RX. This is the most common mistake .
- Ports Tab: The UART you connected to needs to have the peripheral set to “TBS SmartAudio” or “IRC Tramp” .
- Battery: You need a battery plugged in for the VTX to power up and communicate with the FC .
- VTX Table: The table might be missing or incorrect for your VTX .
Problem: “The OSD says I’m on R-1, but my goggles see R-3”
Your VTX table is mismatched to the actual VTX. This is super common when people use generic tables . Here’s the fix:
- Find the correct table for your specific VTX model (check the manufacturer’s website).
- Load that specific table, not a generic one.
- The VTX is silently rejecting frequencies it doesn’t understand, and Betaflight “thinks” it moved channels even though the VTX didn’t .
Problem: “It worked on Betaflight 4.4, but not on 4.5”
Betaflight 4.5 introduced stricter protocol compliance checks. Some older VTXs that worked on 4.4 refuse to play nice on 4.5. If you’re comfortable with it, you can add this Custom Define when flashing: USE_NONCOMPLIANT_SMARTAUDIO — this builds a firmware with a more forgiving SmartAudio driver .
The VTX Table Cheat Sheet
Want to save this for later? Here are the clean CLI templates for each major protocol .
IRC Tramp:
vtxtable bands 5
vtxtable channels 8
vtxtable band 1 BOSCAM_A A CUSTOM 5865 5845 5825 5805 5785 5765 5745 5725
vtxtable band 2 BOSCAM_B B CUSTOM 5733 5752 5771 5790 5809 5828 5847 5866
vtxtable band 3 BOSCAM_E E CUSTOM 5705 5685 5665 5645 5885 5905 5925 5945
vtxtable band 4 FATSHARK F CUSTOM 5740 5760 5780 5800 5820 5840 5860 5880
vtxtable band 5 RACEBAND R CUSTOM 5658 5695 5732 5769 5806 5843 5880 5917
vtxtable powerlevels 5
vtxtable powervalues 25 100 200 400 600
vtxtable powerlabels 25 100 200 400 600
saveSmartAudio 2.1:
vtxtable bands 5
vtxtable channels 8
vtxtable band 1 BOSCAM_A A FACTORY 5865 5845 5825 5805 5785 5765 5745 5725
vtxtable band 2 BOSCAM_B B FACTORY 5733 5752 5771 5790 5809 5828 5847 5866
vtxtable band 3 BOSCAM_E E FACTORY 5705 5685 5665 5645 5885 5905 5925 5945
vtxtable band 4 FATSHARK F FACTORY 5740 5760 5780 5800 5820 5840 5860 5880
vtxtable band 5 RACEBAND R FACTORY 5658 5695 5732 5769 5806 5843 5880 5917
vtxtable powerlevels 4
vtxtable powervalues 14 20 26 30
vtxtable powerlabels 25 100 400 1W
saveChart: Understanding VTX Table Performance
VTX Table Setup: Success Rate by Method
Based on community troubleshooting data, here’s how different VTX table setup approaches compare in terms of first-time success rates .
FAQ Section
1. What is a VTX table in Betaflight?
It’s a configuration table that tells your flight controller which bands, channels, and power levels your specific VTX supports. Without it, VTX control via OSD or radio won’t work .
2. Do I need to set up VTX tables for DJI or Walksnail?
No. The VTX table system is only for analog and HDZero video transmitters. Digital systems like DJI and Walksnail work differently .
3. What’s the difference between SmartAudio 2.0 and 2.1?
The main difference is how they handle power levels. SmartAudio 2.1 uses power values in dBm (like 14, 20, 26, 30) while 2.0 uses simple indexes (0, 1, 2, 3). Using the wrong one will break power control .
4. Why does my OSD show the wrong channel?
Your VTX table doesn’t match your actual VTX hardware. The VTX is ignoring commands it doesn’t understand, so Betaflight “thinks” it changed channel but the VTX didn’t .
5. How do I check my SmartAudio version?
Use the Blackbox debug method: set Blackbox Debug Mode to SMARTAUDIO, check the Sensors tab with a battery plugged in, and read the Debug 0 value .
6. What does “Device Ready: No” mean?
The flight controller can’t communicate with your VTX. Check your wiring (SmartAudio to TX pin), Ports tab settings, and that the VTX table is loaded correctly .
References
Sources and Further Reading
- Betaflight Official Docs: Video Transmitter Tab
- Oscar Liang: How to Setup VTX Table in Betaflight
- Betaflight Official Docs: VTX Configuration Guide
- Multirotor Guide: VTX Tables and How to Set Them Up
- Dron.News: VTX Evolution in Betaflight 4.5+
What’s the most frustrating VTX issue you’ve ever fixed? Share your troubleshooting horror stories in the comments below—we’ve all been there, and your experience could save someone else from the same headache!
