blob: 3532ceecd2c321c62588cd83961fb479e7dc4e99 [file] [log] [blame]
Simon Arlott64b85002007-05-10 23:04:09 -07001Firmware is required for this device: http://accessrunner.sourceforge.net/
2
3While it is capable of managing/maintaining the ADSL connection without the
4module loaded, the device will sometimes stop responding after unloading the
5driver and it is necessary to unplug/remove power to the device to fix this.
6
7Detected devices will appear as ATM devices named "cxacru". In /sys/class/atm/
8these are directories named cxacruN where N is the device number. A symlink
9named device points to the USB interface device's directory which contains
10several sysfs attribute files for retrieving device statistics:
11
12* adsl_controller_version
13
14* adsl_headend
15* adsl_headend_environment
16 Information about the remote headend.
17
18* downstream_attenuation (dB)
19* downstream_bits_per_frame
20* downstream_rate (kbps)
21* downstream_snr_margin (dB)
22 Downstream stats.
23
24* upstream_attenuation (dB)
25* upstream_bits_per_frame
26* upstream_rate (kbps)
27* upstream_snr_margin (dB)
28* transmitter_power (dBm/Hz)
29 Upstream stats.
30
31* downstream_crc_errors
32* downstream_fec_errors
33* downstream_hec_errors
34* upstream_crc_errors
35* upstream_fec_errors
36* upstream_hec_errors
37 Error counts.
38
39* line_startable
40 Indicates that ADSL support on the device
41 is/can be enabled, see adsl_start.
42
43* line_status
44 "initialising"
45 "down"
46 "attempting to activate"
47 "training"
48 "channel analysis"
49 "exchange"
50 "waiting"
51 "up"
52
53 Changes between "down" and "attempting to activate"
54 if there is no signal.
55
56* link_status
57 "not connected"
58 "connected"
59 "lost"
60
61* mac_address
62
63* modulation
Simon Arlott1bfbd282009-11-21 15:03:23 +000064 "" (when not connected)
Simon Arlott64b85002007-05-10 23:04:09 -070065 "ANSI T1.413"
66 "ITU-T G.992.1 (G.DMT)"
67 "ITU-T G.992.2 (G.LITE)"
68
69* startup_attempts
70 Count of total attempts to initialise ADSL.
71
72To enable/disable ADSL, the following can be written to the adsl_state file:
73 "start"
74 "stop
75 "restart" (stops, waits 1.5s, then starts)
76 "poll" (used to resume status polling if it was disabled due to failure)
77
78Changes in adsl/line state are reported via kernel log messages:
79 [4942145.150704] ATM dev 0: ADSL state: running
80 [4942243.663766] ATM dev 0: ADSL line: down
81 [4942249.665075] ATM dev 0: ADSL line: attempting to activate
82 [4942253.654954] ATM dev 0: ADSL line: training
83 [4942255.666387] ATM dev 0: ADSL line: channel analysis
84 [4942259.656262] ATM dev 0: ADSL line: exchange
85 [2635357.696901] ATM dev 0: ADSL line: up (8128 kb/s down | 832 kb/s up)