Broadcom CLI

From kitz wiki
Jump to: navigation, search

Routers using Broadcom chipsets

Broadcom chipsets are widely used in DSL routers, and most incorporate a very similar CLI command set, accessed through its telnet interface. It should be noted though that a number of ISP customised versions of these routers have the telnet interface disabled. See Broadcom-based modem routers for a list of models.

CLI commands for Broadcom-based routers

All Broadcom-based DSL routers have very similar CLI command sets. Listed below are a few of the more frequently used commands. In most cases, the CLI can be accessed via the telnet interface.

Note regarding the 'adsl' command

This is the command which is commonly used to obtain information from the router, and to set its connection parameters. A number of routers use a different form of the command:

ADSL routers
adsl
adslcfg
adslcmd
adslctl
VDSL2 routers
xdslcfg
xdslcmd
xdslctl


In this article we will use 'adsl', but depending on your router you may need to use one of these alternative forms.

help command

  • help - gives a list of the available commands
  • one of those commands with no parameters - gives a synopsis of the usage of that command

adsl command

  • adsl info --show - displays a brief set of router stats
  • adsl info --stats - displays a full set of router stats including error rates over various periods
  • adsl info --SNR - displays the current SNR for each ADSL tone
  • adsl info --Bits - displays the bitloading for each ADSL tone
  • adsl configure --snr N - sets the target signal to noise ratio margin to a new value and triggers a re-sync. The value of N determines by how much the target SNRM changes from the default value set at the DSLAM (or MSAN). The following graph gives some approximate values:


Delta-snrm.png


Note that a value of N = 0 is not a valid value, and will cause the target SNRM to return to the value set in the exchange. The smallest official value is 1.

Although this graph shows some negative values of N, it's not possible to enter negative values directly in the command. However it's possible to produce the same result by entering very large positive values. To do this, subtract the negative value from 65536; e.g. to simulate the effect of a value of -50, enter 65536 - 50 = 65486.


Warning

Be careful when making changes to the target SNRM, in particular when reducing it. The smaller the SNRM, the less stable the router is likely to be and if you make it too small the router may not be able to make a connection at all.


-- Thanks to burakkucat for his suggestions for improving this section --

--Roseway 08:20, 10 October 2012 (GMT)