Site Tools


faq

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
faq [2023/06/04 23:44] – [Netgear R-series] -added "Routers" to heading hogwildfaq [2025/04/15 21:08] (current) – [How Can I Check the Integrity of my Downloaded Build File?] -Change "you shouldn't" to "Don't" hogwild
Line 5: Line 5:
 //Q: I'm new to FreshTomato. Where should I start?// //Q: I'm new to FreshTomato. Where should I start?//
  
- \\+ \\  //A:// You're in the right place.  \\  \\
  
-  * You're in the right place. +  * Check your device is supported by FreshTomato on the [[hardware_compatibility|Hardware compatibility]] \\ page. Read the HW revision and Notes columns there
-  * Go the [[hardware_compatibility|Hardware compatibility]] page and verify check whether your device is supported by FreshTomato. Read the HW revision column and the notes column+  * Overall, the installation process is quite safe. Depending on your hardware, \\ there are recovery procedures if things don't go as planned. However, you're \\ responsible for any risks involved in upgrading your device to FreshTomato. 
-  * Overall, the installation process is relatively safe. Depending on your hardware, there are recovery procedures to try if things don't go as planned. However, please know that you are fully responsible for any risks involved in upgrading your device to FreshTomato. +  * Use an Ethernet connection between the client device and a router LAN port. 
-  * You need to have an Ethernet connection between your client device and a LAN port on the router+  * Read and follow the [[firmware_basics_procedures|Installing FreshTomato]] section. This guides you through \\ the steps needed to install FreshTomato
-  * You must read and follow the [[firmware_basics_procedures|Installing FreshTomato]] section. This will guide you through all the steps needed. +  * There'a lot of information on the wiki. It's not all where you expect to find it. \\ Take a look around.
-  * There is a lot of information on this wiki. Not all of it is where you might expect to find it. Take a good look around.+
  
  
Line 19: Line 18:
 //Q: Does FreshTomato support only old devices or newer ones too?// //Q: Does FreshTomato support only old devices or newer ones too?//
  
-\\ A: FreshTomato supports a variety of devices. See the [[hardware_compatibility|Hardware compatibility]] page for more details. Keep a close eye on CPU speed, Ethernet port speed and WiFi speed.+\\ //A:// FreshTomato supports a variety of devices. See the [[hardware_compatibility|Hardware compatibility]] page for details. Keep a close eye on CPU speed, Ethernet speed and WiFi speed.
  
-Until recently, it would not have been possible to create new releases that support 802.11ax or newer WiFi standards. However, since Broadcom has released some details about their wireless drivers, FreshTomato developers are currently //in the planning stages// of writing firmware for at least one model that supports the 802.11ax protocol. Traditionally, Broadcom's wireless driver source code has been an industry secret.+Until recently, it was not possible to create releases that support 802.11ax or newer WiFi standards. However, Broadcom recently released some details about their wireless drivers. As a result, FreshTomato developers are currently writing code to support the Asus TUF AX3000. Traditionally, Broadcom's wireless driver source code has been an industry secret.
  
  
Line 47: Line 46:
 //Q: What do those cryptic filenames mean? How do I choose the right build for my router?// //Q: What do those cryptic filenames mean? How do I choose the right build for my router?//
  
-\\ A: The naming scheme for ARM-based models (//with some exceptions//) is roughly as follows: \\  \\+\\ //A:// The naming scheme for ARM-based models (//with some exceptions//) is roughly as follows: \\  \\ \\
  
 |  **Build Name Term**  |  **Description**  | |  **Build Name Term**  |  **Description**  |
-| FreshTomato | The Tomato mod name. This is always FreshTomato, as currently it's the only fork in development. |+| FreshTomato | The Tomato mod name. This is always FreshTomato. |
 | Hardware model | Specifies the router or access point model number. | | Hardware model | Specifies the router or access point model number. |
 | ARM/MIPS | Specifies the build is intended for devices with ARM or MIPS CPU architecture. | | ARM/MIPS | Specifies the build is intended for devices with ARM or MIPS CPU architecture. |
 | Wireless Driver (optional) | NG  -  Indicates whether the New Generation Broadcom binary wireless driver is in the build. \\ Broadcom never released the driver source code, so developers rely on binary drivers. \\ Builds for newer hardware required the newer wireless driver and a newer software development\\ kit (SDK).  These builds were called "NG" ("New Generation") driver builds.\\ RT-N - indicates the build's driver supports 802.11n. \\ RT-AC - indicates the build's driver supports 802.11ac. | | Wireless Driver (optional) | NG  -  Indicates whether the New Generation Broadcom binary wireless driver is in the build. \\ Broadcom never released the driver source code, so developers rely on binary drivers. \\ Builds for newer hardware required the newer wireless driver and a newer software development\\ kit (SDK).  These builds were called "NG" ("New Generation") driver builds.\\ RT-N - indicates the build's driver supports 802.11n. \\ RT-AC - indicates the build's driver supports 802.11ac. |
 | Release name | e.g. 2021.3  - indicates the third release in the year 2021. \\ It does NOT indicate the 3rd month of 2021! | | Release name | e.g. 2021.3  - indicates the third release in the year 2021. \\ It does NOT indicate the 3rd month of 2021! |
-| Build Type | e.g. (Mini / AIO / VPN) - indicates the features included in the build. See [[:feature_matrix|Feature matrix]] to learn more. |+| Build Type | e.g. (Mini / AIO / VPN) - indicates the features included. See [[:feature_matrix|Feature matrix]] to learn more. |
 | NVRAM size | (32K / 64K / 128K)  -  Optional. For models with multiple hardware revisions \\ where each revision may include more or less NVRAM. | | NVRAM size | (32K / 64K / 128K)  -  Optional. For models with multiple hardware revisions \\ where each revision may include more or less NVRAM. |
-| NOSMP  | (Optional)  -  This is a special build with single core CPU where SMP (Symmetric Multi Processingis intentionally disabled. +| NOSMP  | (Optional)  -  This is a special build with single core CPU where Symmetric Multi Processing is intentionally disabled. 
-| Custom  | (Optional) - identifies a build which includes or excludes a certain feature (set).  |+| Custom  | (Optional) - identifies a build that includes or excludes a certain feature (set).  |
 |   | Reserved for future use  | |   | Reserved for future use  |
 |   | Reserved for future use  | |   | Reserved for future use  |
Line 67: Line 66:
  
 ''freshtomato-RT-AC3200-ARM-2021.3-AIO-128K.zip_no_media_server'' ''freshtomato-RT-AC3200-ARM-2021.3-AIO-128K.zip_no_media_server''
 +
 + \\
  
   * Fork name: FreshTomato. \\    * Fork name: FreshTomato. \\ 
Line 73: Line 74:
   * Release name: 2021.3  (The third release of 2021. NOT the third month). \\    * Release name: 2021.3  (The third release of 2021. NOT the third month). \\ 
   * Build features: AIO (All-in-one).  The build includes all features. \\    * Build features: AIO (All-in-one).  The build includes all features. \\ 
-  * NVRAM size: 128K (this is optional but indicates the NVRAM size of the routers, 128K in this case). \\ +  * NVRAM size: 128K (this is optional but indicates NVRAM size of the router). \\ 
   * no_media_server: The build doesn't include the Media Server. \\ \\   * no_media_server: The build doesn't include the Media Server. \\ \\
 +
 + \\
  
  
-==== Which Build Folders should I Look In for the Right Builds? ====+==== Which Build Folders should I Look in for the Right Builds? ====
  
 For more help choosing a build, see the [[:firmware_basics_procedures|Installing Firmware-Basic Concepts and Procedures]] page in the HOWTOs section. \\ For more help choosing a build, see the [[:firmware_basics_procedures|Installing Firmware-Basic Concepts and Procedures]] page in the HOWTOs section. \\
  
-When browsing through firmware folders on the website, a subfolder named "K26" indicates that the build includes Linux kernel 2.6.x . These folders generally contain generic builds for MIPSR1 and MIPSR2 routers. Generally, only very old models (before 2010) use the MIPSR1 architecture. Most routers made after 2010 use MIPSR2 or ARM architectures.+When browsing firmware folders on the website, a subfolder named "K26" indicates the build includes Linux kernel 2.6.x . Such folders generally contain generic builds for MIPSR1/MIPSR2 routers. Generally, only old models (before 2010) use the MIPSR1 architecture. Most routers made after 2010 use MIPSR2 or ARM architectures.
  
-The other subfolders such as K26RT-AC and K26RT-N contain dedicated builds, meant for specific router models. Unless you're experienced, It's recommended you install specific hardware builds. If no specific builds exist for your model, select a generic build in the K26 folder. Think carefully before deciding if it should be a MIPSR1 or MIPSR2 build.+The other subfolderssuch as K26RT-AC and K26RT-N contain dedicated builds, meant for specific router models. Unless you're experienced, it's recommended you install specific hardware builds. If there is no specific builds for your model, choose a generic build in the K26 folder. Think carefully before deciding if it should be a MIPSR1 or MIPSR2 build.
  
 If you have a Netgear R-series router with Netgear firmware installed, you must first flash with one of the "Netgear R-series initial" files. Once you have an R-series initial build installed, you can then upgrade FreshTomato to newer versions using regular build files. The initial .zip file contains a firmware file with a .chk file extension. The original Netgear firmware can use that file to install FreshTomato. If you have a Netgear R-series router with Netgear firmware installed, you must first flash with one of the "Netgear R-series initial" files. Once you have an R-series initial build installed, you can then upgrade FreshTomato to newer versions using regular build files. The initial .zip file contains a firmware file with a .chk file extension. The original Netgear firmware can use that file to install FreshTomato.
Line 92: Line 95:
 ==== How Can I Check the Integrity of my Downloaded Build File? ==== ==== How Can I Check the Integrity of my Downloaded Build File? ====
  
-MD5SUM files are available in each website folder containing firmware. It'strongly recommended that you run a hash program against the .zip file of the build you downloaded. Then, compare the value in that program with the hash value listed for that build in the MD5SUM file. If the two don't match, your download is corrupt, and you shouldn't flash with that file or you could damage your router. Try downloading it again and performing the hash check again until the hashes match.+MD5SUM files are available in each website folder containing firmware. You are strongly advised to run a hash program against the .zip file of the build you downloaded. Then, compare the value in that program with the listed hash value for that build in the MD5SUM file. If the two don't match, your download is corrupt. **Don't flash with that file** or you could damage your router. Try downloading it again and performing the hash check until the hashes match.
  
  
Line 99: Line 102:
 //Q: How can I make temporary changes to FreshTomato's settings that aren't saved unless I want them to be?// //Q: How can I make temporary changes to FreshTomato's settings that aren't saved unless I want them to be?//
  
-\\ A:  In the [[:admin-debug|Debugging]]** **menu, enable the "//Avoid commiting to NVRAM//" setting. If you don't want to keep the settings changes, just reboot FreshTomato and settings will return to what they were before you made them. If you later decide you want to save the changes, uncheck the //Avoid performing an NVRAM commit//  button. This make experimentation fun and safe.+\\ A:  In the [[:admin-debug|Debugging]]** **menu, enable "//Avoid committing to NVRAM//". If you don't want to keep the setting changes, just reboot FreshTomato and settings will return to what they were before you made them. If you decide later to save the changes, uncheck //Avoid performing an NVRAM commit//  button. This make experimentation fun and safe.
  
-Another option while debugging is to make a backup configuration and then make your changes, if you decide you messed things up, just restore the backed-up configuration. NOTE that configuration backup files do not work across different releases of FreshTomato.+Another option while debugging is to make a backup configuration and then make your changes, if you decide you messed things up, just restore the backed-up configuration. NOTE that **configuration backup files do not work across different releases of FreshTomato**.
  
  
Line 110: Line 113:
  \\ This can become a complex topic rather quickly. In general, there will be physical interfaces, such as "eth" and "wl", and logical interfaces, like "br" and "vlan". When using FreshTomato's VPN technologies, other interface names may appear. For example, a VPN interface might be named "tun11", "tinc", "ppp0", or "wg0".  \\ This can become a complex topic rather quickly. In general, there will be physical interfaces, such as "eth" and "wl", and logical interfaces, like "br" and "vlan". When using FreshTomato's VPN technologies, other interface names may appear. For example, a VPN interface might be named "tun11", "tinc", "ppp0", or "wg0".
  
-  * ethXis a physical interface. It can be used to represent Ethernet of WiFi interfaces. +  * ethX is a physical interface. \\ It can represent either Ethernet or WiFi interfaces. \\ \\  
-  * wlX: identifies a physical wireless interface. It is often associated with an eth reference. +  * wlX - is a physical wireless interface. \\ It is often associated represented with an "ethreference. \\ \\  
-  * brXis a logical interface. It bridges together two physical interfaces. +  * brX is a logical interface bridging together two physical interfaces. \\ \\  
-  * vlanXidentifies a VLAN (a logical separation). +  * vlanX identifies a VLAN (a logical separation). \\ \\  
-  * tunXXis an OpenVPN interface. (for example, tun13 = client3, tun21 = server1) +  * tunXX is an OpenVPN interface.\\ (For example, tun13 = client3, tun21 = server1). \\ \\  
-  * tincis a logical tunnel interface used by tinc VPN technology+  * tinc is a logical tunnel interface used by the tinc function\\ \\  
-  * wg0is an interface used by Wireguard.+  * wg0 is an interface used by the Wireguard function.
  
-Some structures, like additional SSIDs (Virtual Wireless) will create sub-interfaces. For this reason, it's common to see interfaces with periods in them. For example, wl0.2 would represent the second alias of the first WiFi radio.+ \\ 
 + 
 +Some structures, like additional SSIDs (Virtual Wireless LANs) will create sub-interfaces. Thus, it's common to see interfaces with periods in them. For example, "wl0.2would represent the second alias of the first WiFi radio.
  
  
 ===== Log Location Default ===== ===== Log Location Default =====
  
-// Q:   Where is FreshTomato System log file located? How are logs stored?//+// Q:   Where is the System log file located? How are logs stored?//
  
  \\  \\
  
- A:   The logfile is located in /var/log/messages.+ A:   By default, the logfile is located in "/var/log/messages".
  
-If you happen to have specified a different path/filname under //Custom Log File Path// /var/log/message is still relevant but will be available in form os symlink. The only exception occurs if you configure remote storage e.g. external syslog.\\ Unless a sort of permanent storage is configured /var/log/messages is stored in RAM hence unable to survive a device reboot.((+If you've set a different path/filename under //Custom Log File Path,// "/var/log/messages" is still valid, but will be available in the form of a symbolic link. The only exception occurs if you configure remote (external) storage, that is, external syslog. 
 + 
 +Unless some type of permanent storage is configured, "/var/log/messagesis stored in RAM. As a result, it will not survive a router reboot.((
 If you enabled **Log To Remote System** your logs are obviously retained on the remote server as well. If you enabled **Log To Remote System** your logs are obviously retained on the remote server as well.
 )) ))
 +
  
 ===== BusyBox ===== ===== BusyBox =====
Line 143: Line 151:
 (See [[https://busybox.net/]]) (See [[https://busybox.net/]])
  
-BusyBox combines tiny versions of many common UNIX/Linux utilities into a single small executable. It provides minimal replacements for most of the utilities you usually find in GNU coreutils, util-linux, etcetera. Generally, BusyBox utilities have fewer options than their full GNU equivalents. However, the options included provide the expected functionality and behave much like their GNU equivalents.+BusyBox combines tiny versions of many common UNIX/Linux utilities into a single small executable. It provides minimal replacements for most utilities you find in GNU coreutils, util-linux, etcetera. 
 + 
 +Generally, BusyBox utilities have fewer options than their GNU equivalents. However, the options included provide the expected functionality and behave much like their GNU equivalents.
  
 Read more at: [[https://www.commandlinux.com/man-page/man1/busybox.1.html]] Read more at: [[https://www.commandlinux.com/man-page/man1/busybox.1.html]]
  
-===== The Web Interface (GUI) is Slow or not Responding =====+ 
 +===== The Web Interface (GUI) is Slow not Responding =====
  
 //Q: The GUI is slow. Is this normal?// //Q: The GUI is slow. Is this normal?//
Line 155: Line 166:
 No. FreshTomato was specifically built for speed and simplicity. There are some very rare cases where the GUI might become slow/unresponsive. This is almost always related to browser issues. No. FreshTomato was specifically built for speed and simplicity. There are some very rare cases where the GUI might become slow/unresponsive. This is almost always related to browser issues.
  
-  - First, try to clear the browser cache either manually via the browser setting or reloading the page using CTRL-F5 on the keyboard.+To resolve these issues, please do the following: 
 + 
 + \\ 
 + 
 +  - First, clear the browser cache either via the web interface, \\ or by reloading the page using \\ CTRL-F5 on the keyboard.
   - Try a different browser.   - Try a different browser.
-  - Rarely, you might have multiple copies of FreshTomato's administration interface certificate stored in the browser. If this happens, simply remove any unwanted FreshTomato certificates stored in your browser (or even all of them) before reconnecting to the web interface.+  - Rarely, multiple copies of the web interface certificate \\ are stored in the browser. If this happens, remove any \\ or all unwanted FreshTomato certificates stored in your browser \\ before reconnecting to the web interface.
  
-If the GUI is completely unresponsive, log in via SSH (preferred) or telnet and verify:+ \\ 
 + 
 +If the GUI is completely unresponsive, log in via SSH (preferred) or telnet and check: 
 + 
 + \\
  
   - CPU utilization. You can check this by running the "top" command.   - CPU utilization. You can check this by running the "top" command.
-  - The presence of content in the "/www" folder. Check this by issuing the command "ls -l /www" . +  - The presence of content in the "/www" folder. Check this by \\ issuing the command "ls -l /www" . 
-  - The httpd daemon is running. Check this by typing "ps | grep [h]ttpd" at a command line.+  - The httpd daemon is running. Check this by typing: \\ "ps | grep [h]ttpd" at a command line.
  
  
Line 187: Line 206:
 Next, in FreshTomato's [[nas-usb|USB Support]] menu, verify that USB support is enabled. Then, enable the //3G/4G USB modem support// option in that same menu. Next, in FreshTomato's [[nas-usb|USB Support]] menu, verify that USB support is enabled. Then, enable the //3G/4G USB modem support// option in that same menu.
  
-If you don't know the make/model of your modem, connect it to your router and ensure USB Support and 3G/4G USB mode support are enabled. Then log on to FreshTomato and use the lsusb command to check to if its output lists your modem's Vendor ID (make) and Product ID (model).+If you don't know the make/model of your modem, connect it to your router and ensure USB Support and 3G/4G USB mode support are enabled. Then log on to FreshTomato and use the lsusb command to check if its output lists your modem's Vendor ID (make) and Product ID (model).
  
 You should NOT enable a PIN on your modem's SIM card. Doing so may prevent it from working with FreshTomato. You should NOT enable a PIN on your modem's SIM card. Doing so may prevent it from working with FreshTomato.
Line 198: Line 217:
   * Modem (only) mode   * Modem (only) mode
   * Storage emulation mode   * Storage emulation mode
 +
 + \\
  
 In modem mode, the device operates normally, and allows the host device to communicate with most modem functions. In modem mode, the device operates normally, and allows the host device to communicate with most modem functions.
Line 213: Line 234:
 For more advanced users, you can get detailed information about usb_modeswitch here: [[https://www.draisberghof.de/usb_modeswitch/|Draisberghof Software-usb_modeswitch]] For more advanced users, you can get detailed information about usb_modeswitch here: [[https://www.draisberghof.de/usb_modeswitch/|Draisberghof Software-usb_modeswitch]]
  
- + \\
-==== Huawei modems (and HiLink mode) ==== +
- +
-Some Huawei modems have two modes of operation: HiLink mode and Stick mode. Confusingly, two different "models" may use the same hardware, but different firmware. One modem's firmware includes HiLink mode, and the other's doesn't. HiLink models may have a HiLink logo on the device. Sometimes a modem can be (re)flashed with a firmware version that supports / doesn't support HiLink mode. A HiLink model can become a non-HiLink model and vice versa. +
- +
-HiLink mode has the following characteristics: +
- +
-  * Includes storage emulation, (described above). +
-  * The modem will self-mount as a storage device with drivers on the device itself. +
-  * Presents the modem to the host as a network device with a web interface. +
-  * Makes the modem act as a router +
-  * Directs traffic through NAT +
-  * Provides no IP pass through support (for the IP address assigned by the carrier to pass through to the attached device. +
-  * Does not support port forwarding. +
-  * Because of this, HiLink mode won't work with remote access applications, where hosts on the Internet initiate inbound connections. +
-    * This includes applications like RDP, VNC, and Web servers. +
-    * To use HiLink mode, your application must use only outbound-initiated connections (such as web browsing or email). +
-  * Alternatively, implement a VPN to another device which is initiated by the router with the HiLink mode modem connected. +
- +
-Stick Mode presents the USB dongle to the host as a regular modem. When in stick mode, the host device to which the modem is connected (usually a PC) has to deal with all of the networking setup (PPP session, routing, and so on). +
- +
-The term "Stick mode" could be confusing, since many refer to a flash drive as a "USB stick". This might suggest the modem was in storage mode, when it's actually in modem mode. +
- +
- +
-==== Modem Install Process (TBD) ==== +
- +
-Assuming there is no pin enabled, FreshTomato sets the //modem_pin// nvram variable to null, like this: +
- +
-'' +
-nvram set modem_pin= "" \\ +
- +
-nvram commit'' +
- +
-If the card does have a PIN set, the variable must be set in nvram: +
- +
-''nvram set modem_pin= "1234"''+
  
  
faq.1685918695.txt.gz · Last modified: 2023/06/04 23:44 by hogwild