Basic configuration

Configuration --> Login --> Normal Login

Here you set up the basic factors for logging into the router and getting data from the CLI.

Basic configuration


(Note that this page is greyed out when DSLstats is recording data. To make changes to the login configuration you must stop or pause recording first).

Click on the Configuration tab, and select the Login section. Fill in the appropriate details. If you have a Netgear modem/router, see the note at the bottom of this page.

Modem/router model - You can select your modem/router model from the drop-down list, and this will result in the default login details being filled in. After doing this, you should check the details and edit if necessary. It's not essential to use this selector - you can just fill in the details manually if you wish (or if your router isn't included in the list).

If you're trying to get DSLstats to work with an unrecognised modem, please read "Checking a new modem".

Router is Thomson/Technicolor model - These models don't provide access to the Broadcom CLI, but have their own custom CLI instead. When this option is enabled DSLstats will use the custom CLI commands to obtain its data.

IP address - The same address as you enter into a browser to access the web interface of the router (this will be something like 192.168.0.1).

Telnet login name - The name which you use when logging into the router (probably "admin", but could be something else).

Telnet password - The password which you use when logging into the router by telnet. In most cases this will be the same as the password which you use when logging into the router's web interface, but in some cases it may not - with the HG612, for example, if you change the password for the web interface this does not also change the telnet password, which remains "admin".

Telnet port - The port through which the router accepts telnet logins. In most cases the standard port 23 will be the correct choice, but some routers may be configured to use a different port. If you enter a wrong number here, no data will be received from the router.

Requires command to enter shell - Leave this option unticked for most routers, but a few routers, such as the HG612, have a second stage of logging into the CLI, and require it to be ticked.

Shell command - If the extra command is required as above, enter it here.

Stats command prefix - The base part of the telnet commands which are used to obtain data from the router. The options are:
  • adsl - used by many Broadcom-based ADSL routers
  • adslcfg - some ADSL routers
  • adslcmd - some ADSL routers
  • adslctl - used by Netgear ADSL routers (and maybe some others)
  • xdslcfg - some ADSL/VDSL2 routers
  • xdslcmd - used by Huawei and some other ADSL/VDSL2 routers
  • xdslctl - some ADSL/VDSL2 routers
  • adslphxcmd - used in some Ralink-based ADSL routers which mimic the Broadcom CLI
  • Custom - selecting this option allows you to enter a prefix which isn't in the above list
Connection is Annex M - Annex M uses different tone bands to the default Annex A arrangement, so if your connection is of this type you need to tick this option to ensure that the Bitloading graph is displayed correctly. It's also necessary if you want to use the tweaking utility to tweak the SNRM or just to force a re-sync. Without this option being enabled, an Annex M connection will not reconnect after dropping the connection.

Reset login configuration - When you press this button, all the login details are set to their default (unconfigured) state.

Modem/router is HG622 type - The telnet interface of this model (and maybe some others) requires a slightly different login approach. If you use this model or another of the same type, tick this option.

Special login is enabled - This message is shown if "Enable special login" is ticked on the Special login page, and you can disable that option by ticking "Disable special login".

After entering the data, press the Start or resume recording "Start or resume recording" button at the left of the toolbar. After this you can pause the recording by pressing the Pause recording "Pause recording" button, or stop the recording by pressing the Stop recording "Stop recording" button. When a recording is paused, you can resume it by pressing the Start or resume
              recording "Start or resume recording" button. A message to the right of these buttons indicates the current status. The buttons are enabled or disabled, depending on the status.

If the Pause, Stop or Exit buttons are pressed while the word "Sampling" is being displayed, the relevant action is delayed until the sampling process is complete. During this period, the word "Sampling" is replaced by "Pausing...", "Stopping..." or "Closing...".

** Note about Netgear modem/routers

Netgear routers need to be put in debug mode to enable telnet access. In most cases you can do this by pointing your browser at http://192.168.0.1/setup.cgi?todo=debug (edit this as necessary if your router's IP address has been changed from the default). The result should be the message "Debug enable", after which DSLstats should work normally. If you reboot the router or power cycle it, you will need to repeat the above process.

A few Netgear models use a different process for enabling debug mode. There is a utility which you can download to enable telnet access on these models: http://www.myopenrouter.com/download/10602/NETGEAR-Telnet-Enable-Utility/

I'm not able to test this personally, but many messages on the net suggest that it works reliably.