						README.OpenSwitch6
VoiceTronix
Powering Open Telephony
ABN 46 076 711 843
Adelaide City Business, 1st Floor, 128 Hindley St, Adelaide 5000
Ph. +61 8 8415 5106 Fax. +61 8 8415 5107
www.voicetronix.com

THE OPEN SWITCH 6 
=================

The VoiceTronix OpenSwitch6 telephony card has 6 ports, configurable in two
groups. Each group 'A' and 'B' can be configured to FXO or FXS modes by
setting jumpers.
 
The first two ports, labeled 0 and 1 make up Group A. (They report as channel
numbers 6 and 7 in the driver.)  These are by default set as Loop Ports ( FXO ).
Each has its own RJ12 socket.

The last four ports, Labeled 2 through 5 make up Group B. (They report as
channel numbers 8 through to 11 in the driver.) These are by default set as
Station Ports ( FXS ). There are two ports on each of the lower RJ12 sockets,
see "Port Connections" below.

Table 2 has the available port configurations.

(please also read README.OpenSwitch12)

THE DRIVER  
==========

The OpenSwitch6 requires the latest driver to be recognized. 

Currently the card will be reported as an OpenSwitch12. The usable ports are
numbered from 7 through to 12 when accessing fron test programs (base 1). This
may be changed in a later driver release to 1 through 6 (more logical for a 6
port card).

DRIVER INSTALL:

1) From this dir 'make' (should make libvpb and hdafifo)

2) then 'make install'

3) cd to src

4) login as root, 'insmod vpbhp.o' - after this step a 'major number' will
   be printed to the console, use this number in the next step.

5) If you dont see anything printed out after 'insmod vpbhp.o', type 'dmesg',
   and look for the 'major number'.

6) 'mknod /dev/vpbhp0 c 254 0' - note this example assumes the major number
   was 254.

7) chmod a+w /dev/vpbhp0 (allows all users to use vpb-driver)

7a) (Optional) If u wish u can logout as root here.

7b) (Check) If you type 'cat /proc/interrupts' a few times you should see the
    number next to the 'vpbhp' entry incrementing about 1000 times every
    second. This tells us that the hda driver is processing interrupts.

8) (Optional) 'export VPB_MODEL=V12PCI', this specifies the hardware type for
   the user-mode driver.  If you have no other Voicetronix cards installed,
   then the hardware card will be detected automatically.

9) cd to unittest, and try these test programs

TEST PROGRAMS
=============

The following unittest programs will run with the OpenSwitch6 card:

./echo
	records, then plays back 3 seconds of audio

./ringstat		
	will ring all the FXS ports.

./tring
	reports events on FXS ports DTMF etc.

./recwav
	records an audio file

./playwav
	play back an audio file

Note:
"tpbx" has not been maintained and therefore may not run as expected.
We would recommend OpenPBX, available in the CTServer download. If you
still want to try it then use:
./tpbx --openswitch6


PORT CONNECTIONS
================

Connections to the card are via 4 Modular RJ12 US style phone sockets at the
back of the card. The top socket is J1, this is the first port which is part of
Group A.

----------------------------------
Group A Ports
----------------------------------   
RJ12	PORT#   CH#     On pin's
----    -----   ---     --------
J1        0      7        3,4

J2        1      8        3,4

----------------------------------
Group B Ports
----------------------------------
RJ12	PORT#  CH#	On pin's
----    -----  ---      --------
J3        2     9         3,4
          3    10         5,2

J4        4    11         3,4
          5    12         5,2

--------------------------------
Table: 1


SETTING PORT MODE
=================
		
---------------------------------------------------------------
Combination of ports available          Group A         Group B
----------------------------------      -------         -------
2 Loop Ports and 4 Station Ports          FXO             FXS
6 Loop Ports and No Station Ports         FXO             FXO
No Loop Ports and 6 Station Ports         FXS             FXS
4 Loop Ports and 2 Station Ports          FXS             FXO
---------------------------------------------------------------
Table: 2


JUMPER CONFIGURATION
====================

---------------------------------------------------------------
Group A (Port 0 and 1)
---------------------------------------------------------------
FXS =	Install Jumpers JS1, JS2, JS5, JS6, H13, H14, H15, H16
---------------------------------------------------------------
FXO =	Remove Jumpers JS1, JS2, JS5, JS6, H13, H14, H15, H16
---------------------------------------------------------------
Table: 3

---------------------------------------------------------------
Group B (Ports 2 to 5)
---------------------------------------------------------------
FXS =	Install Jumpers JS3, JS4, JS7, JS8,
			H17, H18, H19, H20, H21, H22, H23, H24.
---------------------------------------------------------------
FXO =	Remove Jumpers  JS3, JS4, JS7, JS8,
			H17, H18, H19, H20, H21, H22, H23, H24.
---------------------------------------------------------------
Table: 4
	

Fail Over & Power Fail
======================
(Note: Due to design error this function is not available on Rev. 1.x. )
	
Once fixed, this option will bypasses the card in the event of system crash
(watch dog timer expire) or power failure. It will connect two of the station
ports to the loop ports as follows: 

	FXS Port 2 will be patched to FXO Port 0
	FXS Port 3 will be patched to FXO Port 1

This option should ONLY be enabled when Group A = FXO and Group B = FXS.

Warning: For any call established during Fail-Over, the connection will be lost
when power is restored.


RING FREQUENCY
==============

There are two jumpers that set the ring frequency to one of 4 available
frequencies.
These are jumpers H25 and H26. They are verticaly orientated close to the back
edge of the card between the two large modules.

--------------------------------	
Frequency	Jumper Settings
---------	----------------
20 Hz		H25 Removed
		H26 Removed
--------------------------------
25 Hz		H25 Installed
		H26 Removed
--------------------------------
16.7 Hz         H25 Removed
		H26 Installed
--------------------------------
50 Hz		H25 Installed
		H26 Installed
--------------------------------
Table: 6


WARNINGS
========

Warning: Do Not use Jumpers H1 or H2 as these may damage the card or your PC!

Warning: When a port is set to FXS it should only be connected to CE equipment
	 i.e. a telephone.

Should you require any further assistance please visit our website for all your
installation and product information requirements, or contact support by
email: support@voicetronix.com.au

===============================================================================
Australia:
-------------------------------------------------------------------------------
This product has not completed compliance testing in Australia. Therefore until
this product has completed the compliance tests the following non-compliance
statement applies to the card identified as 'OS6' Open Switch 6. 
-------------------------------------------------------------------------------
DO NOT connect this item to any telecommunications network or facility unless:
a) you have written consent of the network or facility manager; or
b) the connection is in accordance with a connection permit issued for this
   item; or
c) a connection rule for this item has been made by the Australian
   communications Authority.
The connection of this item to any telecommunications network or facility may
cause hazard or damage to the network or facility, or to users of the network
or facility, and may result in being consequentially liable to pay substantial
compensation.
===============================================================================

