Sangoma S503 Manuel utilisateur
December 2001
FRAME RELAY SUPPORT FOR
SANGOMA CARDS
Hardware Interface Manual
LIMITED USE LICENSE AGREEMENT
Sangoma Technologies Inc. provides the computer software program contained on the medium in this package (hereinafter called the Program) and licenses its use.
THE LICENSEE SHOULD CAREFULLY READ THE FOLLOWING TERMS AND CONDITIONS BEFORE ATTEMPTING TO USE THIS PRODUCT. INSERTION OF ANY OF
THE DISKETTES IN THIS PACKAGE INTO ANY MACHINE INDICATES THE LICENSEE'S ACCEPTANCE OF THESE TERMS AND CONDITIONS. IF THE LICENSEE
DOES NOT AGREE WITH THE TERMS AND CONDITIONS, THE LICENSEE SHOULD PROMPTLY RETURN THE PACKAGE WITHIN 15 DAYS UNUSED AND
UNCOPIED IN ANY WAY SHAPE OR FORM, AND MONIES WILL BE REFUNDED.
LICENSE:
a. The purchaser of this license (hereinafter called the Licensee) is granted a personal, non-exclusive license to use the Program in accordance with the terms and conditions set
out in this agreement.
b. The Program may be used only on a single computer per license granted.
c. The Licensee and the Licensee's agents and employees shall protect the confidentiality of the Program and shall not distribute or make available the Program or
documentation to any third party.
d. The Licensee may copy the programs into machine readable or printed form for backup or modification purposes only in support of the Licensee's use on a single machine.
The Licensee must reproduce and include the copyright notice on any copy, modification or portion merged into another program.
e. Any portion of the Program merged into or used in conjunction with another program will continue to be subject to the terms and conditions of this agreement.
f. The Licensee may not assign or transfer the license or the program to any third party without the express prior consent of Sangoma Technologies Inc.
g. The licensee acknowledges that this license is only a limited license to use the Program and documentation, and that Sangoma Technologies Inc. retains full title to the
program and documentation.
h. The Licensee shall not use, copy, modify or transfer the Program or documentation or any copy, modification or merged portion, in whole or in part, except as expressly
provided for in this license. If the Licensee transfers possession of any copy, modification or merged portion of the program to a third party, the license is automatically
terminated under this agreement.
TERM:
The license is effective until terminated. The licensee may terminate the license at any time by destroying the Program together with all copies, modifications and merged portion in any
form. The Licensee agrees upon such termination to destroy the Program together with all copies, modifications and merged portion in any form.
LIMITED WARRANTY:
The Program is provided "as is" without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular
purpose. The entire risk as to the performance of the Program is with the Licensee. Should the Program prove defective, the Licensee (and not Sangoma Technologies Inc. or an authorized
dealer) shall assume the entire cost of all necessary servicing, or correction. However, Sangoma Technologies Inc. warrants the diskettes on which the Program is furnished will be free of
defects in materials or workmanship under normal use for a period of 90 days from the date of delivery to the Licensee. In no event will Sangoma Technologies Inc. be liable for any
damages, including incidental or consequential damages arising out of the use or inability to use the Program, even if Sangoma Technologies Inc. or an authorized dealer have been advised
of the possibility
of such damages, or for any claim by any other party.
The Licensee acknowledges that the Licensee has read this agreement, understands it, and agrees to be bound by its terms and conditions. The Licensee further agrees that it is the complete
and exclusive statement of the agreement between the parties and supersedes any proposal or prior agreement, oral or written, and any other communications between the parties relating
to the subject matter of this agreement.
3Frame Relay for Sangoma Cards (C) Sangoma Technologies Inc. 1999,2000,2001 Page 3 of 78
1. Introduction
The Sangoma cards are general co-processor communication adapters capable of supporting any
communication protocol autonomously, and providing information transfer into PC work space.
This document describes the support of the Frame Relay protocol on the card, and the hardware level
PC to Card API required for development of device drivers. Where drivers have been developed, the
details of the hardware interface are transparent to the user, and this document becomes a reference for
command and return codes. The hardware/software solution handles the link Information Rates and
local signalling autonomously, without PC intervention. The PC accesses the system as required to send
or receive data, configure the link or to obtain statistics.
The implementation of Frame Relay on the S508 adapter includes the following features:
!ANSI T1.617, Annex D, LMI or Q.933 Local in-channel signalling.
!Up to 100 DLCIs are supported.
!A maximum information packet length of 15356 bytes.
!Line speeds up to 4Mbps.
!Control of transmission Information Rates on a per DLCI basis to maximize line utilization while
keeping each DLCI data rate strictly inside the set parameters.
!Dynamic Frame Relay configuration facilities.
!Complete Frame Relay statistics package.
!A built in datascope with frame time stamping.
!Configurable as both a CPE (customer premises equipment) and an Access Node.
4Frame Relay for Sangoma Cards (C) Sangoma Technologies Inc. 1999,2000,2001 Page 4 of 78
Conventions used in this manual
Programming conventions used are as follows:
Variables described with an 0x prefix or an hsuffix are hexadecimal values. All other variables
are decimal.
For bit mapping, the least significant (low) bit is denoted as bit 0.
5Frame Relay for Sangoma Cards (C) Sangoma Technologies Inc. 1999,2000,2001 Page 5 of 78
2. Hardware
S503
This is a short 4 layer card, compatible with the ISA bus and it supports hardware interrupts as well as
operating in a passive polled mode. The RS232 or V.35/X.21 interface is jumper selectable.
Clock speed:
This is factory set by Jumper JP1. Do not change without consulting your Sangoma dealer.
I/O port address:
This is set by Jumper JP3.
Pins 5-6 Pins 3-4 Pins 1-2 I/O Address Selection
Not Jumpered Jumpered Jumpered 250-252 (Hex)
Jumpered Jumpered Jumpered 254-256 (Hex)
Not Jumpered Jumpered Not
Jumpered 300-302 (Hex)
Jumpered Jumpered Not
Jumpered 304-306 (Hex)
Not Jumpered Not
Jumpered Jumpered 350-352 (Hex)
Jumpered Not
Jumpered Jumpered 354-356 (Hex)
Not Jumpered Not
Jumpered Not
Jumpered 360-362 (Hex)?
Jumpered Not
Jumpered Not
Jumpered 364-366 (Hex)
?Factory default.
6Frame Relay for Sangoma Cards (C) Sangoma Technologies Inc. 1999,2000,2001 Page 6 of 78
IRQ Selection
The optional IRQ is set using JP2.
Pins 1-2 Pins 3-4 Pins 5-6 Pins 7-8 Pins 9-10 Selection
In Out Out Out Out IRQ 2
Out In Out Out Out IRQ 3
Out Out In Out Out IRQ 4
Out Out Out In Out IRQ 5
Out Out Out Out In IRQ 7?
?
Factory default.
Interface Level Selection
This is set by Jumper JP3.
Pins 9-10 Interface Level
Jumpered RS-232
Not Jumpered V.35
S514 PCI card
No jumpers need to be set on this card as it is configured by the PC BIOS.
S508 ISA Card
Jumpers JP1 on the S508 define the card I/O address range as specified in Table 3-1. The specified
card I/O addresses must not conflict with I/O addresses in use by any other hardware installed on the
server. Use the SNOOPER utility if you are in any doubt as to hardware settings.
Note that JP1-1 on the S508 is furthest to the left if the board is held such that the connectors are to
the right. JP1-4 is reserved.
7Frame Relay for Sangoma Cards (C) Sangoma Technologies Inc. 1999,2000,2001 Page 7 of 78
The 8k (2000 Hex) byte shared memory address and the IRQ level are set in software for the S508.
Internal Line Clocking
For back-to-back connections, the cards can provide their own Transmit and Receive clock signals,
which, with the appropriate cable, can also provide the clock for third party devices.
All cards are capable of generating the transmit and receive clocks as long as the appropriate back-to-
back cable is used. The generated line speed is set by software.
However, the cards have a very large configurable range and therefore cannot easily be tabulated.
When asked for the line speed during setup, you may specify any value in kbps from 1 to 2600. The
actual generated line speed will be reasonably close the specified value, but will deviate more as the line
speed increases.
S514 Port Pinouts
NB: Port PA is the Primary 4Mbps port
Port PB is the Secondary 512Kbps port.
PIN # PA:RS232 PA:V.35 PB:RS232 PB:V.35
1RTS RTS
2CTS CTS
3GND GND GND GND
4DCD DCD
5DTR DTR (V.10)
6TXD
7RXD
8TXC
9RXC
10 RTS RTS
11 CTS CTS
12 DCD DCD
13 DTR DTR (V.10)
14 TXD
15 RXD
16 TXC
17 RXC
PIN # PA:RS232 PA:V.35 PB:RS232 PB:V.35
8Frame Relay for Sangoma Cards (C) Sangoma Technologies Inc. 1999,2000,2001 Page 8 of 78
18 TXA
19 TXB
20 RXA
21 RXB
22 TX Clock A
23 TX Clock B
24 RX Clock A
25 RX Clock B
26 DTR A (V.11)
27 DTR B (V.11)
28 TXA
29 TXB
30 RXA
31 RXB
32 TX Clock A
33 TX Clock B
34 RX Clock A
35 RX Clock B
36 DTR A (V.11)
37 DTR B (V.11)
9Frame Relay for Sangoma Cards (C) Sangoma Technologies Inc. 1999,2000,2001 Page 9 of 78
S503/S508 Port Pinouts
RS232
Pin # Function
2TxD
3RxD
7GND
4RTS
5CTS
20 DTR
6DSR
8DCD
15 TxC
17 RxC
24 BxC
V.35/X.21
Pin # Function
4RTS
5CTS
6DSR
7GND
8DCD
10 TxA
9TxB
12 RxA
11 RxB
19 Tx Clock A
20 DTR (V10 signal)
13 DTRA (V11 signal)
14 DTRB (V11 signal)
21 Tx Clock B
22 RI
23 Rx Clock A
25 Rx Clock B
18 Aux. Clock A (On board clock
source)
16 Aux. Clock B (On board clock
source)
10Frame Relay for Sangoma Cards (C) Sangoma Technologies Inc. 1999,2000,2001 Page 10 of 78
3. The programmer's interface
Using the Frame Relay Shared Memory Interface
The SDLA card is operated by reading and writing structures to positions in the shared memory
window. For details of moving the structures to/from the board, see the section “Example Code”.
The application program accesses the frame relay software by completing the required parameters
within the control block defined below and then setting the OPP_FLAG. The SDLA processor will
carry out the defined command and then update this control block with the required return code and, if
applicable, the associated data buffer, data length etc. Once the command has been completed, the
OPP_FLAG will be reset by the SDLA processor.
This control block structure is found at the physical offset 0xE000 on the adapter. For example if
S508LOAD is executed with a command line definition of '- mDC', then the physical address of the
control block is 0xDC00:0xE0000.
Table des matières
