| Simon Arlott | 64b8500 | 2007-05-10 23:04:09 -0700 | [diff] [blame] | 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 | |
| Simon Arlott | 817db5b | 2009-11-21 15:15:47 +0000 | [diff] [blame] | 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 | |
| Simon Arlott | 64b8500 | 2007-05-10 23:04:09 -0700 | [diff] [blame] | 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 | |
| Simon Arlott | 4ac3720 | 2009-11-21 15:14:01 +0000 | [diff] [blame] | 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 | |
| Simon Arlott | 64b8500 | 2007-05-10 23:04:09 -0700 | [diff] [blame] | 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 |
| Simon Arlott | 1bfbd28 | 2009-11-21 15:03:23 +0000 | [diff] [blame] | 79 | "" (when not connected) |
| Simon Arlott | 64b8500 | 2007-05-10 23:04:09 -0700 | [diff] [blame] | 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) |