Additional Experimental Features

Although the telnet features in RouterStats are designed primarily around the Netgear DG834 series of routers, many other routers share the same basic chipsets. The experimental features have been added which may provide some telnet support for some of these routers. Please read these notes in conjunction with the main Configuring Telnet page.

In addition, some features may be useful for use with the Netgear routers, such as the Telnet Port number and the Data Retry feature.

Overview

RouterStats automatically enables telnet using the http url: 'http://<IP Address> /setup.cgi?todo=debug' and then, after opening a telnet session, issues commands based on the router's chipset. For example, for the AR7 chipset, RouterStats issues this command - 'cat /proc/avalanche/avsar_modem_stats' to retrieve the stats page. For routers with one of the Broadcom chisets, the command is usually 'adslctl info --stats' or 'adsl info --stats'.

Some other router manufacturers use the todo=debug method so RouterStats telnet may work with those routers "out of the box" provided the correct chipset is chosen.

Other routers use the more conventional Username and Password method to open a telnet session while still using the same AR7 or Broadcom chipset as the Netgear. Many of these routers should be able to make use of this Experimental Tab

For some routers, the http options in RouterStats will never work. Sometimes, the HTML layout is too difficult for RouterStats to understand. And sometimes, the router uses a webpage-based login method which won't work.

The Experimental Tab tries to address some of these issues in order to widen its scope beyond the Netgear DG834 series of routers.

The Netgear routers enable telnet access using a "quirky" process through http (todo=debug). Other routers use a more conventional process requiring entry of a Username and Password. Sometimes the Username is a router operating system standard called 'root', sometimes it is the normal web interface Username.

In the top section of the Experimental page, you can force RouterStats to login to telnet conventionally and you can enter a Username in the Telnet Username edit box. The password is always the same as that entered in the main Router Login & Logout configuration section.

Additionally, there is a checkbox option to provide the todo=debug method as well.


Http Debug Command

The HTTPdebug command can be selelcted from a drop-down list (or you can type your own). RouterStats will use the command selected here regardless of whether the 'normal' Netgear telnet or the 'Experimemtal' login is active.

For example, the manual for the DG632 (which uses the AR7 chipset) appears to indicate that telnet is identical to the DG834(G) v1, 2 or 3 except for the use of the alternative Http Debug Command.


Telnet Port

The standard TCP/IP port used for telnet is 23 but this can be changed in the Telnet Port edit box. Often, remote telnet access uses a different port.


Telnet Prompt

If you can see data in the terminal window when you press the green Run button but nothing is showing on the Telnet Summary page, it may be because the router's telnet prompt is different. Usually, it's either '#' or '>' - which you can selelct form the drop down list; or you can type in your own, if it's different.


Data Timeout & Retry

If you find the Telnet Summary Page frequently has missing or corrupt data, this feature may help.

The Data Timeout xxx milliseconds edit box and the Retry if timeout checkbox work together.

When telnet data is requested from the router and if the checkbox is checked, RouterStats will wait for the selected number of milliseconds and then test the Terminal Window to see if valid data is available. If data is not available, RouterStats will request it again. It will repeat the process a maximum of twice for each initial request.


Disable http Access

Some routers use a webpage-based authentication instead of the more usual http popup authentication dialogue box. As these are all different, it's impossible to write RouterStats to handle the http interface with these routers - making http access impossible.

By checking the Disable http access checkbox, RouterStats won't attempt to use HTTP. This means, of course, that none of the top row of RouterStats graphs will actually plot anything - since these are all http-based.

Please bear in mind that, as this feature is experimental, attempting to use some of the http features may cause unexpected problems or not work as expected although I have tried to catch the ones I can see. Similarly, some telnet features may not work if the router provides telnet data in a different format than the Netgear.

Normally, the Rx Noise value shown in the RouterStats Icon, the Rx Noise and Rx Sync values on the Toolbar and the IP address shown on the StatusBar are obtained through http. When this checkbox is checked, these values will be obtained via telnet instead.


Disconnect when Stop button is pressed

When the main black Stop button is pressed, the default action is for RouterStats to leave the telnet connection open in order to keep the terminal window "alive". If you prefer the Stop button to disconnect the telnet session, check the Disconnect when Stop button is pressed checkbox.


Chipset & Chipset Command Selection

If the Broadcom chipset radio button is selected, two chipset command sets are available. In essence, they are adsl and adslctl.


ADSL Connection Mode

RouterStats should detetct the router's connection mode automatically but some lines connect in ADSL2+ mode even though they seem to operate with the ADSL (G.DMT) number of Tones (Bins). It should only affect the Bits/Tone and SNR/Tone graphs. You can force the graphs into a particular mode using the radio buttons: ADSL (G.DMT), ADSL2+ and Auto. Note that these radio buttons simply change how the graphs are plotted - they don't make any changes to the router or to the connection mode itself.


If you can get sensible data to display on the telnet summary page, you should be home and dry. The monitoring options on the Netgear Settings tab apply equally to other routers.

Finally, please remember that I cannot provide any support for these features but I will try to modify or adapt the way it works if you can provide enough detail of what's required.