# Teltonika RUT/RUTX upgrade procedure ## Preface Currently, the following Teltonika RUT/RUTX routers are supported: ```{list-table} For the full list of supported device production codes, see [Production Codes](#production-codes). :header-rows: 1 :class: full-width * - RUT Routers - RUTX Routers * - * [RUT241](https://wiki.teltonika-networks.com/view/QSG_RUT241) * [RUT950](https://wiki.teltonika-networks.com/view/QSG_RUT950) * [RUT951](https://wiki.teltonika-networks.com/view/QSG_RUT951) * [RUT955](https://wiki.teltonika-networks.com/view/QSG_RUT955) * [RUT956](https://wiki.teltonika-networks.com/view/QSG_RUT956) - * [RUTX11](https://wiki.teltonika-networks.com/view/QSG_RUTX11) * [RUTX12](https://wiki.teltonika-networks.com/view/QSG_RUTX12) * [RUTX14](https://wiki.teltonika-networks.com/view/QSG_RUTX14) * [RUTX50](https://wiki.teltonika-networks.com/view/QSG_RUTX50) ``` ```{hint} This guide on how to upgrade the firmware showcases the upgrade procedure on RUTX12. \ It works for all supported RUT and RUTX routers with minimal changes. ``` The RUTX12 is a dual-modem router that recently got support for **Unwired Edge Cloud OS**. ```{admonition} RUTX12 Specs - E-Mark Certified - Quad-core ARM Cortex A7, 717 MHz - 256 MB, DDR3 RAM - Integrated 256 MB, SPI Flash - 1x WAN port, 3x LAN ports, 10/100/1000 Mbps - 2x 4G Modem, Quectel EG06-E Cat 6 up to 300 Mbps, 2x SIM slots ``` ## First setup - [Quick setup page for RUTX12 (Teltonika's website)](https://wiki.teltonika-networks.com/view/QSG_RUTX12) - [Quick setup video for RutOS (YouTube)](https://www.youtube.com/watch?v=n7TF5MRYiEo) ```{warning} The password you setup is unimportant as we are going to install **Unwired Edge Cloud OS**. It will NOT persist the firmware upgrade! ``` ```{hint} You might need to fully reset the device if it was already flashed to a different OS, or want a clean device. ``` ### Factory reset Please refer to the official docs for factory resetting the devices: - [RUT](https://wiki.teltonika-networks.com/view/RUT955_Device_Recovery_Options) - [RUTX](https://wiki.teltonika-networks.com/view/RUTX11_Device_Recovery_Options) The reset procedure you need to follow is the one at the bottom of the document, named `Bootloader menu`. This ensures a full reset of the device, even if it's not accessible or bootable. ```{hint} On RUTX devices, the suggested time you need to hold the reset button during startup is too short. You actually need to hold it down for around 10 seconds. ``` ## Upgrade procedure ### Firmware image download You can find the firmware images for RUT/RUTX routers at [this link.](https://dl.unwirednetworks.com/?prefix=teltonika/) Make sure to get the latest one for your device. ```{hint} Please use images ending with `-factory.ubi` to avoid upgrade rejection issues. the filename has the following syntax. `unwired-21.02-NN-ipq40xx-generic-teltonika_rutx12-squashfs-nand-factory.ubi` - `unwired`, indicating it's an **Unwired Edge Cloud OS** build - `21.02`, the major revision number - `NN` (for example, `118`), the minor revision number (**pick the highest one!**) - Device architecture - `ipq40xx-generic` for RUTX routers - `ramips-mt76x8` for RUT routers - Device model type, e.g. `teltonika_rutx12` - The rest of the string contains package type and info ``` ```{important} - **RUT950 and RUT955** share image: `*teltonika_rut950_rut955-squashfs-factory.bin` - Revision **H7V3C0** requires the `h7v3c0` image: `*teltonika_rut950_rut955-h7v3c0-squashfs-factory.bin` - **RUT951 and RUT956** share image: `*teltonika_rut951_rut956-squashfs-factory.bin` ``` ### Firmware installation Login to the RutOS Admin, then head over to the `System` section on the left hand side menu. \ There, you'll find a `Firmware` submenu. Hover on it, and `Upgrade` should appear. Click on it to open the firmware upgrade page. ```{warning} **The lowest supported RutOS firmware version is `RUTX_R_00.07.04.3` for RUTX devices.** If your device is running an older firmware version, it must be upgraded to a recent RutOS version first. ```
There could be slight differences in style for the admin panel, depending on the preinstalled RutOS version.
```{important} In the firmware upgrade page, under the `FLASH NEW FIRMWARE IMAGE` section, make sure the settings are as follow: - Update from: **File** - Keep settings: **off** or **unchecked** ``` Then, press on the `BROWSE` button, to select the firmware image you downloaded in the previous document section. Make sure it ends with `-factory.ubi` to avoid upgrade rejection issues. If the file provided is correct, you'll be prompted with a confirmation page. \ Confirm by pressing the `PROCEED` button and continue. ```{hint} Depending on your needs, you might want to update the Modem's firmware. This is optional, needs a very stable internet connection (can't be done on 4G/5G) and there is currently no way of updating the Modem through **Unwired Edge Cloud OS**. If you need to update it after upgrading to the **Unwired Edge Cloud OS**, you will have to downgrade back to the stock firmware. Please refer to [this section](#factory-reset). The procedure is carried out on the same page as the regular firmware update; however, it will only be available if there actually is a new firmware for the Modem. Before you start, select the Modem updater from the update type selector and repeat the procedure as shown in the previous section. ``` ### Post-upgrade checks After confirming the upgrade, you will be redirected to a generic loading page. The only indication of the upgrade status now are the LEDs on the device itself. Signal indicator bars (the ones with "growing" bars on top, directly over the SIM1 slot), should start blinking back and forth for a short period of time, [like KITT](https://www.youtube.com/watch?v=bMVbaCiy_XE). To verify that the upgrade was successful: 1. The LEDs integrated in the switch should quickly flash for around 1 second. 1. Look for the modem status LEDs: - They should start blinking first, indicating bootup - The left one should blink, the center one should blink too, a little slower. 1. After the first successful boot, the `WiFi` LED should start blinking rapidly, then slower. 1. If you've got (a) SIM(s) inserted, there's no PIN to unlock the SIM(s), and it's known to be working on the operator's default APN settings, the LEDs surrounding the related slot should light up and indicate signal, plus wireless tech used. 1. Once the device is up and running, the `WiFi` LED should permanently stay on. ## Register the device Once the firmware upgrade goes through, you can register the device in the [Unwired Edge Cloud Console](https://admin.wifi.unwired.at). Make sure to either: - have a supported SIM inserted in one of the slots, or - connect the device through the WAN port to a network with DHCP and Internet access, just like you would connect a regular computer. Please refer to [this section](adding-a-device) for instructions on how to add your device. ```{warning} Due to technical limitations, for all **RUTX** devices **the `lan1` interface** in the Unwired Edge Cloud Console represents **all physical LAN ports** on the device. Also, using the **same VLAN ID** on both **LAN and Uplink interfaces** is currently NOT possible. This will change in future firmware releases, all ports (`lan2`, `lan3`, `lan4` if present) should be selected in the `Unwired Edge Cloud Console`. ``` For registering your device, you'll have to use the MAC printed on it and the correct type. Refer to the following table to get the exact device model type for your device: | Device | Unwired Edge Cloud Console model type | | - | - | | RUT241 | UW-RUT241 | | RUT950 | UW-RUT950 | | RUT951 | UW-RUT951 | | RUT955 | UW-RUT955 | | RUT956 | UW-RUT956 | | RUTX11 | UW-RUTX11 | | RUTX12 | UW-RUTX12 | | RUTX14 | UW-RUTX14 | | RUTX50 | UW-RUTX50 | ```{hint} You can find the MAC address on the box your device came in, or on a label on its underside (see picture). ``` ## Production Codes Currently, the following Teltonika RUT/RUTX routers are supported: ### RUT Production Codes ```{list-table} :header-rows: 1 :class: full-width * - Router Model - Production Codes * - [RUT241](https://wiki.teltonika-networks.com/view/RUT241_TAC_codes) - RUT241 *0**** \ RUT241 *1**** *(unverified)* \ RUT241 *2**** *(unverified)* \ RUT241 *3**** *(unverified)* \ RUT241 *5**** *(unverified)* \ RUT241 *6**** *(unverified)* * - [RUT950](https://wiki.teltonika-networks.com/view/RUT950_TAC_codes) - RUT950 **0******* \ RUT950 **H******* \ RUT950 **H7V3C0** **(use `h7v3c0` image)** \ RUT950 **T******* *(unverified)* \ RUT950 **U******* *(unverified)* * - [RUT951](https://wiki.teltonika-networks.com/view/RUT951_TAC_codes) - RUT951 **0******* \ RUT951 **1******* * - [RUT955](https://wiki.teltonika-networks.com/view/RUT955_TAC_codes) - RUT955 **0******* \ RUT955 **H******* \ RUT955 **H7V3C0** **(use `h7v3c0` image)** \ RUT950 **T******* *(unverified)* * - [RUT956](https://wiki.teltonika-networks.com/view/RUT956_TAC_codes) - RUT956 **0******* \ RUT956 **1******* \ RUT956 **2******* \ RUT956 **3******* *(unverified)* ``` ### RUTX Production Codes ```{list-table} :header-rows: 1 :class: full-width * - Router Model - Production Codes * - [RUTX11](https://wiki.teltonika-networks.com/view/RUTX11_TAC_codes) - RUTX11 **0******* * - [RUTX12](https://wiki.teltonika-networks.com/view/RUTX12_TAC_codes) - RUTX12 **0******* * - [RUTX14](https://wiki.teltonika-networks.com/view/RUTX14_TAC_codes) - RTUX14 **0******* * - [RUTX50](https://wiki.teltonika-networks.com/view/RUTX50_TAC_codes) - RUTX50 **0******* ```