From 41cc30ebf626c5c68925c060d80f6c26571fc98e Mon Sep 17 00:00:00 2001 From: tzafrir Date: Mon, 26 Feb 2007 10:13:34 +0000 Subject: The fxotune man page was misleading. Dumping some content into it. Still needs work. git-svn-id: http://svn.digium.com/svn/zaptel/branches/1.4@2229 5390a7c7-147a-4af0-8ec9-7488f05a26cb --- doc/fxotune.8 | 41 ++++++++++++++++++++++++++++++++++++++++- 1 file changed, 40 insertions(+), 1 deletion(-) (limited to 'doc') diff --git a/doc/fxotune.8 b/doc/fxotune.8 index 2236a70..e066132 100644 --- a/doc/fxotune.8 +++ b/doc/fxotune.8 @@ -4,7 +4,7 @@ \(em automatically tune FXO channels on a Digium TDM400 card .SH SYNOPSIS .B fxotune -i -.I +.I OPTIONS \(em detect .B fxotune -s @@ -21,8 +21,20 @@ needs a dial string after which the line(s) will give dial tone. It writes settings to a configuration file (/etc/fxotune.conf , name is hardwired) from which it can be loaded (e.g: at startup) using -s . +You are advised to run fxotune on all FXO ports you have that support +it and that are connected. Note that the tunning is affected by e.g. +the physical parameters of the connection, and thus if it has been +radically changed, you may need to re-run fxotune. + +.B fxotune +has two operation modes: tune (-i) and set (-s). In the tune mode it +generates /etc/fxotune.conf, and in the set mode it merely applies the +parameters from fxotune.conf to device's ports. .SH OPTIONS +.B THIS SECTION CURRENTLY DOCUMENTS THE OLD SYNTAX OF FXOTUNE. RUN fxotune +WITHOUT ANY PARAMETERS TO GET A USAGE MESSAGE. + .B -i .RS .I dialstr @@ -53,6 +65,33 @@ configuration is loaded when .B -s is used. +.SH NOTES +Running fxotune takes approximately a minute per port. If you wish to only +run fxotune for several ports, you can use the options -b and -e to set a +specific range of ports. Another useful trick is to actually keep asterisk +running, and only "destroy" the zaptel channels you wish to tune (zap +destroy channel NNN): other channels will be used by Asterisk, and hence +skipped. This can be useful if you have many FXO ports that are not connected. + +.B fxotune +writes immedietly to +.B /etc/fxo.conf +so if you stop it half-way, you may get a half-configured system. If you +have already tuned your FXO channels and wish to test-run fxotune again, +you are advised to backup /etc/fxotune.conf . + +The default for -m is 18 seconds. This asusmes that you get a clear line +for at least 18 seconds. It is advised that you test that timeout earlier +by connecting a phone to the FXO line, dialing 4 (or whatever dial string +you put with ___) and see how much time of silence you have. + +If you connect your device to a PSTN provider that is not in the US, there +is a similar operation you should apply before even getting to fxotune: +setting the opermode. The opermode sets a number of country-specific +parameters. For the Digium analog cards this is set through the kernel module +parameter 'opermode' . For the Xorcom Astribank this is set through the +variable 'opermode' in /etc/default/zaptel or /etc/sysconfig/zaptel . + .SH SEE ALSO ztcfg(8), zttool(8), ztmonitor(8), asterisk(8). -- cgit v1.2.3