annotate README @ 14:f96153d15889

sipout-test-voice: implement play from file
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 11 May 2024 22:10:38 -0800
parents 372be50488d6
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
12
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 This repository contains a collection of programs that need to be run under
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 the following somewhat constraining conditions:
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 1) The developer-operator running these programs needs to be someone with an
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 active account at BulkVS, AnveoDirect or some other similar provider of SIP
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 trunk access to PSTN;
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 2) The test programs in this collection need to be run on a machine with a
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 direct, non-NAT'ed connection to public Internet, one whose static & public
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 IP address is whitelisted with the service provider from the previous bullet
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 point as a customer host authorized to send outgoing calls to PSTN on the
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 customer's account.
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14 Each of sipout-test-* utilities in this collection is a command line tool that
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15 generates an outbound call on PSTN (G.711 codecs only, either PCMU or PCMA) via
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 one of the just-described SIP trunk providers. The breakdown is as follows:
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18 * sipout-test-voice is intended for testing voice calls and the in-band signals
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19 for GSM 08.62 or 3GPP TS 28.062 TFO;
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 * sipout-test-fsk generates a 300 baud FSK modem call, either Bell103 or V.21;
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 * sipout-test-v22 generates a V.22(bis) modem call at either 1200 or 2400 bps.
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 These programs use SpanDSP library for V-series modulations (required for
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26 compilation) and themwi-rtp-mgr (required at run time) to get a properly aligned
372be50488d6 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27 (even/odd) RTP+RTCP port pair for talking to PSTN-via-SIP.