Commit | Line | Data |
---|---|---|
64b85006 SA |
1 | Firmware is required for this device: http://accessrunner.sourceforge.net/ |
2 | ||
3 | While it is capable of managing/maintaining the ADSL connection without the | |
4 | module loaded, the device will sometimes stop responding after unloading the | |
5 | driver and it is necessary to unplug/remove power to the device to fix this. | |
6 | ||
817db5b3 SA |
7 | Note: support for cxacru-cf.bin has been removed. It was not loaded correctly |
8 | so it had no effect on the device configuration. Fixing it could have stopped | |
9 | existing devices working when an invalid configuration is supplied. | |
10 | ||
11 | There is a script cxacru-cf.py to convert an existing file to the sysfs form. | |
12 | ||
64b85006 SA |
13 | Detected devices will appear as ATM devices named "cxacru". In /sys/class/atm/ |
14 | these are directories named cxacruN where N is the device number. A symlink | |
15 | named device points to the USB interface device's directory which contains | |
16 | several sysfs attribute files for retrieving device statistics: | |
17 | ||
18 | * adsl_controller_version | |
19 | ||
20 | * adsl_headend | |
21 | * adsl_headend_environment | |
22 | Information about the remote headend. | |
23 | ||
4ac37208 SA |
24 | * adsl_config |
25 | Configuration writing interface. | |
26 | Write parameters in hexadecimal format <index>=<value>, | |
27 | separated by whitespace, e.g.: | |
28 | "1=0 a=5" | |
29 | Up to 7 parameters at a time will be sent and the modem will restart | |
30 | the ADSL connection when any value is set. These are logged for future | |
31 | reference. | |
32 | ||
64b85006 SA |
33 | * downstream_attenuation (dB) |
34 | * downstream_bits_per_frame | |
35 | * downstream_rate (kbps) | |
36 | * downstream_snr_margin (dB) | |
37 | Downstream stats. | |
38 | ||
39 | * upstream_attenuation (dB) | |
40 | * upstream_bits_per_frame | |
41 | * upstream_rate (kbps) | |
42 | * upstream_snr_margin (dB) | |
43 | * transmitter_power (dBm/Hz) | |
44 | Upstream stats. | |
45 | ||
46 | * downstream_crc_errors | |
47 | * downstream_fec_errors | |
48 | * downstream_hec_errors | |
49 | * upstream_crc_errors | |
50 | * upstream_fec_errors | |
51 | * upstream_hec_errors | |
52 | Error counts. | |
53 | ||
54 | * line_startable | |
55 | Indicates that ADSL support on the device | |
56 | is/can be enabled, see adsl_start. | |
57 | ||
58 | * line_status | |
59 | "initialising" | |
60 | "down" | |
61 | "attempting to activate" | |
62 | "training" | |
63 | "channel analysis" | |
64 | "exchange" | |
65 | "waiting" | |
66 | "up" | |
67 | ||
68 | Changes between "down" and "attempting to activate" | |
69 | if there is no signal. | |
70 | ||
71 | * link_status | |
72 | "not connected" | |
73 | "connected" | |
74 | "lost" | |
75 | ||
76 | * mac_address | |
77 | ||
78 | * modulation | |
1bfbd283 | 79 | "" (when not connected) |
64b85006 SA |
80 | "ANSI T1.413" |
81 | "ITU-T G.992.1 (G.DMT)" | |
82 | "ITU-T G.992.2 (G.LITE)" | |
83 | ||
84 | * startup_attempts | |
85 | Count of total attempts to initialise ADSL. | |
86 | ||
87 | To enable/disable ADSL, the following can be written to the adsl_state file: | |
88 | "start" | |
89 | "stop | |
90 | "restart" (stops, waits 1.5s, then starts) | |
91 | "poll" (used to resume status polling if it was disabled due to failure) | |
92 | ||
93 | Changes in adsl/line state are reported via kernel log messages: | |
94 | [4942145.150704] ATM dev 0: ADSL state: running | |
95 | [4942243.663766] ATM dev 0: ADSL line: down | |
96 | [4942249.665075] ATM dev 0: ADSL line: attempting to activate | |
97 | [4942253.654954] ATM dev 0: ADSL line: training | |
98 | [4942255.666387] ATM dev 0: ADSL line: channel analysis | |
99 | [4942259.656262] ATM dev 0: ADSL line: exchange | |
100 | [2635357.696901] ATM dev 0: ADSL line: up (8128 kb/s down | 832 kb/s up) |