Skip to content

Guide for updating Quectel RG501Q-EU modem firmware on Teltonika TRB500 to fix 5G stability issues

Notifications You must be signed in to change notification settings

PatrickWegmann/TRB500-5G-Modem-Update-Guide

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 

Repository files navigation

Teltonika TRB500 - Modem Firmware Update & 5G Setup Guide

The Problem

Is your TRB500 5G connection unstable? You're not alone.

The Teltonika TRB500 ships with Quectel RG501Q-EU modem firmware A08, which has serious 5G stability issues:

Symptom Description
5G drops constantly Connects to 5G-NSA, then drops back to LTE after 10-20 seconds
High latency spikes Ping jumps from 20ms to 500ms+ during 5G↔LTE handovers
Poor signal metrics SINR stuck at 5-7 dB even with good antenna placement
Unstable speeds Connection speed fluctuates wildly

The Web UI says "Modem updates from server not supported" - but the firmware IS available, Teltonika just doesn't expose it through the UI.

The Solution

This guide shows you how to manually update to modem firmware A11, which:

  • Fixes 5G-NSA stability (connection stays up)
  • Improves SINR dramatically (5-7 dB → 15-18 dB)
  • Includes the "5Ghoul" security patch
  • Delivers stable ~100 Mbit/s speeds on 5G

Prerequisites

  • Teltonika TRB500 with SSH access enabled
  • Root password or SSH key authentication configured
  • Stable internet connection (LTE is fine)

Step 1: Check Current Firmware Versions

# Router firmware
ssh root@192.168.1.1 'cat /etc/version'

# Modem firmware
ssh root@192.168.1.1 'gsmctl -A "AT+QGMR"'

Example output for A08:

RG501QEUAAR12A08M4G_04.200.00.000

Step 2: Update Router Firmware (Optional but Recommended)

Download latest firmware from: https://wiki.teltonika-networks.com/view/TRB500_Firmware_Downloads

Update via Web UI:

  1. Access http://192.168.1.1
  2. Navigate to: System → Firmware → Update Firmware
  3. Upload the .bin file
  4. Check "Keep settings"
  5. Click Update and wait ~5 minutes

Step 3: Download Modem Firmware A11

The full A11 firmware is available on Teltonika's servers (81 MB):

# Download to /overlay (has more space than /tmp)
ssh root@192.168.1.1 'cd /overlay && curl -o modem_a11.tar "https://modemfota.teltonika-networks.com/TRB5/RG501QEUAAR12A11M4G_04.200.04.200"'

Verify download:

ssh root@192.168.1.1 'ls -lh /overlay/modem_a11.tar'
# Should show ~81 MB

Step 4: Validate Firmware

ssh root@192.168.1.1 'modem_upgrade --check --file /overlay/modem_a11.tar'

Expected output:

Image validated successfully

Step 5: Flash Modem Firmware

WARNING: Do not interrupt this process. Do not power off the router.

ssh root@192.168.1.1 'modem_upgrade --file /overlay/modem_a11.tar'

This takes approximately 2 minutes. You'll see output like:

Validating image...
Extracting firmware...
Flashing partition 1...
Flashing partition 2...
...
Firmware update complete

Step 6: Reboot Router

ssh root@192.168.1.1 'reboot'

Wait 2-3 minutes for the router to fully boot.

Step 7: Verify New Firmware

ssh root@192.168.1.1 'gsmctl -A "AT+QGMR"'

Should now show:

RG501QEUAAR12A11M4G_04.200.00.000

Step 8: Enable 5G

After the firmware update, the modem may be in airplane mode. Enable radio and 5G:

# Enable radio
ssh root@192.168.1.1 'gsmctl -A "AT+CFUN=1"'

# Enable 5G-NSA mode
ssh root@192.168.1.1 'gsmctl -A "AT+QNWPREFCFG=\"nr5g_disable_mode\",0"'
ssh root@192.168.1.1 'gsmctl -A "AT+QNWPREFCFG=\"mode_pref\",NR5G:LTE"'

# Restart mobile interface
ssh root@192.168.1.1 'ifdown mob1s1a1 && sleep 3 && ifup mob1s1a1'

Step 9: Verify 5G Connection

ssh root@192.168.1.1 'gsmctl -t && gsmctl -q'

Expected output:

5G-NSA
RSSI: -61
RSRP: -88
SINR: 16
RSRQ: -9

Step 10: Make Settings Persist After Reboot

The AT command settings don't survive reboots. Create a startup script:

ssh root@192.168.1.1 'cat > /etc/rc.local << "EOF"
#!/bin/sh
# Wait for modem to initialize after boot
sleep 30

# Enable radio (exit airplane mode)
gsmctl -A "AT+CFUN=1"

# Enable 5G
gsmctl -A "AT+QNWPREFCFG=\"nr5g_disable_mode\",0"
gsmctl -A "AT+QNWPREFCFG=\"mode_pref\",NR5G:LTE"

# Wait and restart mobile interface to establish connection
sleep 10
ifdown mob1s1a1
sleep 3
ifup mob1s1a1

exit 0
EOF
chmod +x /etc/rc.local'

Step 11: Sync Web UI Settings (Optional)

To make the Web UI show the correct network mode:

ssh root@192.168.1.1 'uci set simcard.@sim[0].service="nr5g_pref" && uci commit simcard'

Step 12: Cleanup

Remove the firmware file to free up space:

ssh root@192.168.1.1 'rm /overlay/modem_a11.tar'

Verification Commands

Check network type

ssh root@192.168.1.1 'gsmctl -t'
# Output: 5G-NSA

Check signal quality

ssh root@192.168.1.1 'gsmctl -q'

Check carrier aggregation

ssh root@192.168.1.1 'gsmctl -A "AT+QCAINFO"'

Check serving cell (5G details)

ssh root@192.168.1.1 'gsmctl -A "AT+QENG=\"servingcell\""'

Check antenna RSRP (per antenna)

# Note: Shows -140 dBm when idle. Run during download to see all antennas:
ssh root@192.168.1.1 'curl -o /dev/null http://speedtest.tele2.net/1MB.zip 2>/dev/null & sleep 1 && gsmctl -A "AT+QRSRP"'

Expected Results After Update

Metric Before (A08) After (A11)
5G Stability Drops after 10-20s Stays connected
SINR 5-7 dB 15-18 dB
RSRP -94 dBm -88 dBm
Speed Unstable ~100 Mbit/s

Troubleshooting

Modem stuck in airplane mode after reboot

ssh root@192.168.1.1 'gsmctl -A "AT+CFUN=1"'

No internet after enabling radio

ssh root@192.168.1.1 'ifdown mob1s1a1 && sleep 3 && ifup mob1s1a1'

Download killed (out of memory)

Use /overlay instead of /tmp - it has more available space.

DFOTA methods don't work

The RG501Q-EU modem doesn't support DFOTA (delta updates). Use the full firmware method described above.

5G-SA not working ("N1 mode not allowed")

This is a network/SIM issue. Contact your carrier to enable 5G SA on your account.

Technical Notes

Why the startup script is needed

After a modem firmware update, the modem's NVM (non-volatile memory) is reset. The 5G mode settings (AT+QNWPREFCFG) need to be re-applied after each boot.

5G-NSA behavior

5G-NSA uses LTE as an "anchor" connection. The 5G NR layer is added dynamically when:

  • There's high data demand (downloads, streaming)
  • Cell load permits
  • Signal quality is sufficient

When idle, you may see LTE-only - this is normal.

Antenna configuration

The TRB500 has 4 SMA connectors for 4x4 MIMO. All antennas are wideband (LTE + 5G). The modem powers down unused RX chains when idle to save power.

Firmware URLs

Resource URL
Full A11 firmware https://modemfota.teltonika-networks.com/TRB5/RG501QEUAAR12A11M4G_04.200.04.200
Firmware list https://modemfota.teltonika-networks.com/TRB5/fwlist.txt
Router firmware https://wiki.teltonika-networks.com/view/TRB500_Firmware_Downloads

References


Guide created: 2025-12-21 Tested on: TRB500 with Router Firmware 07.20, Modem A08 → A11

About

Guide for updating Quectel RG501Q-EU modem firmware on Teltonika TRB500 to fix 5G stability issues

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published