[Asterisk-doc] VoiceTronix Additions
Chris Tooley
asterisk-doc@lists.digium.com
Thu, 15 Jul 2004 19:01:20 -0500
--=-GiUVULVi+3Wdb7Ejyajz
Content-Transfer-Encoding: 7bit
Content-Type: text/plain
Ok, with modifications and after running them by VoiceTronix.
On Thu, 2004-07-15 at 17:57 -0500, Chris Tooley wrote:
> Really, really rough drafts... more updates coming soon.
>
--
Chris Tooley / Network and Development Services
Networking Technologies Resource Center, LLC (NTRC)
8650 Spicewood Springs Road, Suite 105
Austin TX 78759
512-250-8985 / Fax 512-250-5909
www.ntrc.net / www.ntrcstore.com
--=-GiUVULVi+3Wdb7Ejyajz
Content-Transfer-Encoding: 7bit
Content-Type: text/x-patch; name=voicetronix-hardware.diff; charset=iso-8859-1
Content-Disposition: attachment; filename=voicetronix-hardware.diff
Index: other-hardware.xml
===================================================================
RCS file: /cvsroot/asterisk/docs/other-hardware.xml,v
retrieving revision 1.5
diff -u -r1.5 other-hardware.xml
--- other-hardware.xml 12 Jun 2004 04:13:14 -0000 1.5
+++ other-hardware.xml 15 Jul 2004 22:53:16 -0000
@@ -5,7 +5,34 @@
<sect2>
<title>VoiceTronix OpenLine and OpenSwitch Cards</title>
- <para/>
+ <para>
+ The VoiceTronix OpenLine and OpenSwitch Cards are an inexpensive line of
+ FXO and FXS cards for standard analog lines. In low density implmentations
+ they can be a highly effective solution. The OpenLine 4 has 4 FXO ports,
+ the OpenSwitch 6 has 6 user-configurable ports that can either be FXO or FXS,
+ and the OpenSwitch 12 has 12 user-configurable ports that can either be FXO
+ or FXS.
+ </para>
+
+ <para>
+ The VoiceTronix hardware is supported by the chan_vpb channel driver in
+ Asterisk. The driver is part of the standard Asterisk source distribution
+ and is compiled as part of the standard build. The ring type code can be
+ modified to specifically support either US (United States) or AU (Australia)
+ ring tones. With the improvements in indications.conf this will be deprecated.
+ </para>
+
+ <para>
+ The chan_vpb channel driver is loaded by the use of the vpb directives in
+ either the extensions.conf or somewhere that the channel is used. To configure
+ a specific card, you edit the vpb.conf as per that section of the documentation.
+ The VoiceTronix hardware needs a kernel module to operate, vpb, and that must
+ be acquired from VoiceTronix:
+ <itemizedlist>
+ <listitem><para>http://www.voicetronix.com/downloads.htm</para></listitem>
+ </itemizedlist>
+ </para>
+
</sect2>
<sect2>
--=-GiUVULVi+3Wdb7Ejyajz
Content-Transfer-Encoding: 7bit
Content-Type: text/x-patch; name=vpb.conf.diff; charset=iso-8859-1
Content-Disposition: attachment; filename=vpb.conf.diff
Index: conf-files.xml
===================================================================
RCS file: /cvsroot/asterisk/docs/conf-files.xml,v
retrieving revision 1.8
diff -u -r1.8 conf-files.xml
--- conf-files.xml 15 Jun 2004 01:01:13 -0000 1.8
+++ conf-files.xml 15 Jul 2004 23:59:44 -0000
@@ -334,7 +334,7 @@
By default Asterisk will accept RTP messages in the range of 10000 through
20000. Many people may not need this large of a range, and very well may
not want to open that many ports on their firewall. If you want to change
- the range the Asterisk will listen for the RTP stream on, you simply
+ the range that Asterisk will listen for the RTP stream on, you simply
need to change the start and stop range. The following is the default
example that comes with the sample configuration files
</para>
@@ -384,7 +384,7 @@
<informalexample>
<programlisting>
- general]
+ [general]
format=wav|wav49|gsm
serveremail=root@localhost
attach=yes
@@ -474,7 +474,96 @@
</sect2>
<sect2>
<title>vpb.conf</title>
- <para/>
+ <para>
+ vpb.conf holds the configuration for the VoiceTronix line of OpenLine and OpenSwitch
+ hardware. The VoiceTronix hardware can be either FXO or FXS channels, depending on
+ how the card is set up. The OpenSwitch 6 OpenSwitch 12 have 6 or 12 respective
+ Loop-Start (FXO) or Station (FXS) user-configurable analogue ports. The OpenLine 4
+ has 4 Loop-Start (FXO) ports.
+ </para>
+ <para>
+ All of the options in the configuration file are shown in the example configuration file
+ that comes with the driver. The one configuration file can handle all of the voicetronix
+ cards/boards in the machine.
+ </para>
+ <informalexample>
+ <programlisting>
+ [general]
+ cards = 1
+ type = v6pci
+
+ [interfaces]
+ board = 1
+ echocancel = on
+ callerid = on
+ context = default
+ txhwgain = 6
+ rxhwgain = -3
+ txgain = 12
+ rxgain = 6
+ mode = fxo
+ channel = 1
+ channel = 2
+ channel = 3
+ ;channel = 4
+ ;mode = fxs
+ ;channel = 5
+ ;channel = 6
+
+ board = 2
+ echocancel = on
+ callerid = on
+ context = default
+ txhwgain = 6
+ rxhwgain = -3
+ txgain = 12
+ rxgain = 6
+ mode = fxo
+ channel = 1
+ channel = 2
+ channel = 3
+ ;channel = 4
+ ;mode = fxs
+ ;channel = 5
+ ;channel = 6
+
+ </programlisting>
+ </informalexample>
+ <para>
+ The general section allows you to make settings that affect all boards, as
+ well as define the number of boards (cards),of the same type, in the machine.
+ The <varname>type</varname> variable setting lets you define the card types
+ that are in the system, valid entries are: v4pci (OpenLine 4) and v12pci
+ (OpenSwitch 6 and 12). The <varname>cards</varname> variable is the number
+ of VoiceTronix cards in the server.
+ </para>
+ <para>
+ The interfaces section contains the information about the specific cards in
+ the system. The interfaces section is broken up by <varname>board</varname>
+ variables. Everything from a board = line to the next board = line is
+ considered part of that board definition. The <varname>echocancel</varname>
+ variable can be turned on (or off) to effect echo cancellation. This
+ can compensate for lower quality lines when working with a channel in FXO
+ mode. The <varname>callerid</varname> variable can be turned on for the
+ detection of callerid data on the FXO channels of a card. The <varname>context</varname>
+ variable is the Asterisk context that incoming calls will be put into.
+ This should point to a context that can answer incoming calls.
+ The <varname>txhwgain</varname> <varname>rxhwgain</varname> variables control
+ the amount of gain on the transmit and recieve volumes that is performed
+ in the hardware DSP. The <varname>txgain</varname> and <varname>rxgain</varname>
+ variables control the amount of gain on the transmit and recieve volumes
+ performed in software. The <varname>channel</varname> variable is used to
+ define the existance of a particular channel. If channels 1, 2, and 3 are
+ available on an OpenSwitch 6 card, the above example will work.
+ </para>
+ <para>
+ Card configurations of 0 FXS and 6 FXO, 2 FXS and 4 FXO, 4 FXS and 2 FXO,
+ 6 FXS and 0 FXO are available for the OpenSwitch 6. Configurations of
+ 0 FXS and 12 FXO, 4 FXS and 8 FXO, 8 FXS and 4 FXO, 12 FXS and 4 FXO are
+ available on the OpenSwitch 12. These must be setup with onboard jumpers
+ before Asterisk can use them. For more information about how to configure
+ the OpenLine and OpenSwitch cards please refer to the driver documentation
+ that comes with the card.
</sect2>
<sect2>
<title>zapata.conf</title>
--=-GiUVULVi+3Wdb7Ejyajz--