15.3. ETHMOD diagnostics, statistics, logs and debug
Prev Chapter 15. ADSL/VDSL Ethernet modem Next

15.3. ETHMOD diagnostics, statistics, logs and debug

15.3.1. ETHMOD diagnostics

This command shows the modems currently connected:

[17:06:25] ABILIS_CPX:d d ethmod

RES:EthMod --------------------------------------------------------------------
       Ethernet_Modems_Control
       STATE:ACTIVE
       - Ethernet Modems ------------------------------------------------------
       Res:       ModSt: LineSt:   Mode:           Prof:    SpDown:     SpUp:
       ------------------------------------------------------------------------
       Eth-2      UP     UP        VDSL2 Annex B   12a    88.740 M  60.015 M
       ------------------------------------------------------------------------
       EthUsb-3   UP     UP        ADSL2+ Annex A  -      27.439 M   1.291 M
       ------------------------------------------------------------------------

[17:06:29] ABILIS_CPX:d de ethmod

RES:EthMod --------------------------------------------------------------------
       Ethernet_Modems_Control
       STATE:ACTIVE
       - Ethernet Modems ------------------------------------------------------
       Res:       ModSt: LineSt:   Mode:           Prof:    SpDown:     SpUp:
       ModMac:           LineStDetail:             Vpi:    SnrDown:    SnrUp:
                                                   Vci:    AttDown:    AttUp:
       ------------------------------------------------------------------------
       Eth-2      UP     UP        VDSL2 Annex B   12a    88.740 M  60.015 M
       52-54-4D-00-00-A3 Showtime                  8        11.4 dB    9.4 dB
                                                   35        0.0 dB    0.0 dB
       ------------------------------------------------------------------------
       EthUsb-3   UP     UP        ADSL2+ Annex A  -      27.439 M   1.291 M
       52-54-4D-00-00-54 Showtime                  8         8.7 dB    6.1 dB
                                                   35        0.0 dB    3.0 dB
       ------------------------------------------------------------------------

The meaning:

STATE

The ETHMOD driver state.

  • ACTIVE - driver is fully ready to work (configuration parameter ACT:YES).

  • INACTIVE - driver is disabled (configuration parameter ACT:NO).

Res

Ethernet resource.

ModMac

The MAC address of the modem.

ModSt

The Ethernet modem state.

LineSt

The state of the DSL line:

  • DOWN - The port is DOWN.

  • SYNC - The port tries to synchronise with the remote side.

  • UP - The port is synchronised with the remote counterpart. The data transmission is possible.

Mode

Current line mode for the DSL line:

  • ADSL - ADSL mode is used.

  • VDSL - VDSL mode is used.

Annex currently in use in ADSL mode:

  • UNKNOWN - Used when the modem is disconnected, and in any situation where a valid diagnostic wasn't loaded from the modem.

  • A - Annex-A.

  • B - Annex-B.

  • C - Annex-C.

  • I - Annex-I.

  • J - Annex-J.

  • L - Annex-L.

  • M - Annex-M

  • ANSI-T1.413 - ANSI T1.413.

  • N/A - Mode diagnostic isn't available on this modem.

Prof

VDSL profile currently in use:

  • 8a - Profile 8a.

  • 8b - Profile 8b.

  • 8c - Profile 8c.

  • 8d - Profile 8d.

  • 12a - Profile 12a.

  • 12b - Profile 12b.

  • 17a - Profile 17a.

  • 30a - Profile 30a.

  • N/A - Mode diagnostic isn't available on this modem.

[Note]Note

When MODE is not VDSL the displayed value is "-".

SpDown/SpUp

Indicates the current bit rate of the downstream/upstream direction.

LineStDetail

The detailed state of the DSL line.

Vpi

VPI part of the VPI/VCI identifier. Only when MODE is ADSL.

Vci

VCI part of the VPI/VCI identifier. Only when MODE is ADSL.

SnrDown/SnrUp

Indicates the current RX/TX SN margin detected by the device.

AttDown/AttUp

Indicates the current RX/TX attenuation detected by the device.

[Tip]Tip

Interesting chapters:

Section 3.6, “Ethernet modem connection”;

Section 83.8, “How to configure ADSL/VDSL connections using Ethernet modems”.

15.3.2. ETHMOD statistics

This command can help to understand what is happening, in case of troubles:

[17:06:32] ABILIS_CPX:d s ethmod

RES:EthMod --------------------------------------------------------------------
       Ethernet_Modems_Control
       --- Cleared 0 days 00:01:16 ago, on 26/03/2019 at 17:05:22 -------------
       ------------------------------------------------------------------------
       RES:Eth-2      MAC:52-54-4D-00-00-A3   ModSt:UP
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       LINE-DOWN  |          0|           |MODEM-DISC |          0|           |
       LINE-UP    |          1|           |MODEM-CONN |          1|           |
       ------------------------------------------------------------------------
       RES:EthUsb-3   MAC:52-54-4D-00-00-54   ModSt:UP
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       LINE-DOWN  |          0|           |MODEM-DISC |          0|           |
       LINE-UP    |          1|           |MODEM-CONN |          1|           |
       ------------------------------------------------------------------------

With reference to the shown interval of time («Cleared 0 days 00:01:16 ago»), these counters show the number of:

LINE-DOWNTimes DSL line went down.
LINE-UP Times DSL went up.
MODEM-DISCDisconnections of Ethernet modem.
MODEM-CONNConnections of Ethernet modem.
[Tip]Tip

Interesting chapters:

Section 3.6, “Ethernet modem connection”;

Section 83.8, “How to configure ADSL/VDSL connections using Ethernet modems”.

15.3.3. ETHMOD logs

To show the system log for ETHMOD events type the following command:

[17:06:38] ABILIS_CPX:d l | ethmod

26/03/2019 17:05:21 [00629] I: EthMod-1 ST:RD
26/03/2019 17:05:21 [00630] I: EthMod-1 RES:Eth-2 MAC:52-54-4D-00-00-A3 M:UP L:UP
26/03/2019 17:05:21 [00639] I: EthMod-1 RES:Eth-2 MAC:52-54-4D-00-00-A3 RX/TX:88.740/60.015 M
26/03/2019 17:05:28 [00630] I: EthMod-1 RES:EthUsb-3 MAC:52-54-4D-00-00-54 M:dn L:n/a
26/03/2019 17:05:28 [00630] I: EthMod-1 RES:EthUsb-3 MAC:52-54-4D-00-00-54 M:UP L:UP
26/03/2019 17:05:28 [00639] I: EthMod-1 RES:EthUsb-3 MAC:52-54-4D-00-00-54 RX/TX:27.439/1.291 M

To show the ETHMOD log type the following command:

[09:10:20] ABILIS_CPX:d ethmod-1 log

Current Local Time: Monday 15/07/2024 09:30:36 (UTC+02:00)

Date   Time   Event Event detail
------ ------ ----- -----------------------------------------------------------
150724 073554   0 Info  Eth-6      52-54-4D-00-00-54 Registering to LAN using VLAN-ID:UNTAG
150724 073559   0 Info  Eth-6      52-54-4D-00-00-54 IP-STATE: NOTPRESENT -> OPENING
150724 073559   0 Info  Eth-6      52-54-4D-00-00-54 IP-STATE: OPENING -> OPEN
150724 073559   0 Info  Eth-6      52-54-4D-00-00-54 ARP-STATE: NOTPRESENT -> OPENING
150724 073559   0 Info  Eth-6      52-54-4D-00-00-54 ARP-STATE: OPENING -> OPEN
150724 073601   0 Info  Eth-6      52-54-4D-00-00-54 Using local IP 192.168.168.169
150724 073601   0 Info  Eth-6      52-54-4D-00-00-54 Device found for MAC
150724 073601   0 Info  Eth-6      52-54-4D-00-00-54 Modem using IP 192.168.168.168
150724 073601   0 Info  Eth-6      52-54-4D-00-00-54 BIND TCP session to LAN
150724 073601   0 Info  Eth-6      52-54-4D-00-00-54 TCP-STATE: DOWN -> CALLING
150724 073601   0 Info  Eth-6      52-54-4D-00-00-54 TCP-STATE: CALLING -> CONNECTED
150724 073601   0 Info  Eth-6      52-54-4D-00-00-54 CMD:"wan show" [OK]
150724 073601   0 Info  Eth-6      52-54-4D-00-00-54 CMD:"wan show interface" [OK]
150724 073601   0 Info  Eth-6      52-54-4D-00-00-54 CMD:"adsl info --show" [begin, OK]
150724 085534   0 Info  Eth-6      52-54-4D-00-00-54 CMD:"adsl info --show" [end, OK]
150724 085534   0 Info  Eth-6      52-54-4D-00-00-54 DEBUG-CMD:"uptime" [OK]

15.3.4. ETHMOD debug

Type the following command to display the syntax of the command:

[09:13:20] ABILIS_CPX:debug res:ethmod-1

RES:EthMod-1 ------------------------------------------------------------------
       EthMod-1                                                                
       BufferLength:64512  Date/Time:15/07/2024 08:54:00 TraceTime:4680689

USAGE:
 LSN:0               - This help
 LSN:1  CMD:"cmd"  - Arbitrary command execution. Be careful!
 LSN:2               - Execute "adsl info --show"
 LSN:3               - Execute "adsl info --stats"

For example, to see the modem uptime,type the following command:

[09:14:50] ABILIS_CPX:debug res:ethmod-1 lsn:1 "uptime"

RES:EthMod-1 ------------------------------------------------------------------
       EthMod-1                                                                
       BufferLength:64512  Date/Time:15/07/2024 08:55:34 TraceTime:4774517

5D 17H 9M 56S

15.3.5. ETHMOD restart

To restart the Ethernet modem, type the following command:

[09:24:50] ABILIS_CPX:r res:ethmod-1 

RES:EthMod-1
    Eth-6  Done: modem reset (MAC:52-54-4D-00-00-54)

COMMAND EXECUTED
Prev Up Next
15.2. ETHMOD resource Home Chapter 16. VDSL USB modem