summaryrefslogtreecommitdiffstats
path: root/Documentation/networking/cxacru.txt
blob: f4fbf4cd592c19db6c3f8041edc8403daf34f57e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
Firmware is required for this device: http://accessrunner.sourceforge.net/

While it is capable of managing/maintaining the ADSL connection without the
module loaded, the device will sometimes stop responding after unloading the
driver and it is necessary to unplug/remove power to the device to fix this.

Detected devices will appear as ATM devices named "cxacru". In /sys/class/atm/
these are directories named cxacruN where N is the device number. A symlink
named device points to the USB interface device's directory which contains
several sysfs attribute files for retrieving device statistics:

* adsl_controller_version

* adsl_headend
* adsl_headend_environment
	Information about the remote headend.

* adsl_config
	Configuration writing interface.
	Write parameters in hexadecimal format <index>=<value>,
	separated by whitespace, e.g.:
		"1=0 a=5"
	Up to 7 parameters at a time will be sent and the modem will restart
	the ADSL connection when any value is set. These are logged for future
	reference.

* downstream_attenuation (dB)
* downstream_bits_per_frame
* downstream_rate (kbps)
* downstream_snr_margin (dB)
	Downstream stats.

* upstream_attenuation (dB)
* upstream_bits_per_frame
* upstream_rate (kbps)
* upstream_snr_margin (dB)
* transmitter_power (dBm/Hz)
	Upstream stats.

* downstream_crc_errors
* downstream_fec_errors
* downstream_hec_errors
* upstream_crc_errors
* upstream_fec_errors
* upstream_hec_errors
	Error counts.

* line_startable
	Indicates that ADSL support on the device
	is/can be enabled, see adsl_start.

* line_status
	"initialising"
	"down"
	"attempting to activate"
	"training"
	"channel analysis"
	"exchange"
	"waiting"
	"up"

	Changes between "down" and "attempting to activate"
	if there is no signal.

* link_status
	"not connected"
	"connected"
	"lost"

* mac_address

* modulation
	"" (when not connected)
	"ANSI T1.413"
	"ITU-T G.992.1 (G.DMT)"
	"ITU-T G.992.2 (G.LITE)"

* startup_attempts
	Count of total attempts to initialise ADSL.

To enable/disable ADSL, the following can be written to the adsl_state file:
	"start"
	"stop
	"restart" (stops, waits 1.5s, then starts)
	"poll" (used to resume status polling if it was disabled due to failure)

Changes in adsl/line state are reported via kernel log messages:
	[4942145.150704] ATM dev 0: ADSL state: running
	[4942243.663766] ATM dev 0: ADSL line: down
	[4942249.665075] ATM dev 0: ADSL line: attempting to activate
	[4942253.654954] ATM dev 0: ADSL line: training
	[4942255.666387] ATM dev 0: ADSL line: channel analysis
	[4942259.656262] ATM dev 0: ADSL line: exchange
	[2635357.696901] ATM dev 0: ADSL line: up (8128 kb/s down | 832 kb/s up)