Blame view

Documentation/networking/cxacru.txt 2.89 KB
64b85006f   Simon Arlott   USB: cxacru: add ...
1
2
3
4
5
  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.
817db5b34   Simon Arlott   USB: cxacru: remo...
6
7
8
9
10
  Note: support for cxacru-cf.bin has been removed. It was not loaded correctly
  so it had no effect on the device configuration. Fixing it could have stopped
  existing devices working when an invalid configuration is supplied.
  
  There is a script cxacru-cf.py to convert an existing file to the sysfs form.
64b85006f   Simon Arlott   USB: cxacru: add ...
11
12
13
14
15
16
17
18
19
20
  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.
4ac37208e   Simon Arlott   USB: cxacru: add ...
21
22
23
24
25
26
27
28
  * 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.
64b85006f   Simon Arlott   USB: cxacru: add ...
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
  * 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
1bfbd283c   Simon Arlott   USB: cxacru: retu...
75
  	"" (when not connected)
64b85006f   Simon Arlott   USB: cxacru: add ...
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
  	"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)