comparison README @ 29:dffcae9bc8a3

add README
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 02 Jul 2022 11:17:11 -0800
parents
children 97317ede320a
comparison
equal deleted inserted replaced
28:660126bd5f59 29:dffcae9bc8a3
1 This Hg repository contains a work-in-progress named Themyscira Wireless system
2 software. Themyscira Wireless (ThemWi) is an experimental GSM network operated
3 by Mother Mychaela of FreeCalypso at a semi-urban/semi-rural location in
4 Southern California, USA; this GSM network is operated with Osmocom CNI software
5 components, all running on a single Slackware Linux server. ThemWi system sw
6 is going to be a suite of daemon processes and command line tools that run on
7 the same machine as all those Osmocom sw components and provide some additional
8 functionality that is not provided "out of the box" by Osmocom, most important
9 of which is outside connectivity to USA PSTN.
10
11 Right now we have a themwi-mncc daemon process that connects to OsmoMSC via the
12 MNCC socket interface provided by the latter and takes the place of OsmoMSC's
13 mncc_builtin. themwi-mncc switches local calls (from one GSM subscriber to
14 another) just like mncc_builtin, but it also provides a hook (mtcall_socket)
15 for routing externally originated calls to GSM (which then become MT calls),
16 and it will later have a similar interface for routing MO calls to the outside
17 world. Additional daemon processes that will interface with USA PSTN via SIP
18 (one process accepting SIP INVITEs from bulkvs.com servers, turning them into
19 MNCC and sending the calls toward GSM, and another process going the other way)
20 remain to be implemented.
21
22 We are currently experimenting with using bulkvs.com as our USA PSTN
23 connectivity provider. Like most low-cost PSTN connectivity providers, they
24 provide the interface to PSTN in the form of a SIP trunk - while I would
25 absolutely love to get a traditional TDM trunk instead, with SS7 signaling,
26 such a toy would be far beyond my budget, hence I have to settle for SIP.
27 Our current status is:
28
29 * We have already obtained a block of USA phone numbers (NANP, chosen numbers
30 from an exchange area local to us) from bulkvs.com;
31
32 * These bulkvs-sourced real NANP numbers have been entered as MSISDNs into
33 OsmoHLR records for our test SIMs operating on ThemWi GSM;
34
35 * We can successfully dial calls from one ThemWi GSM phone to another, with
36 themwi-mncc understanding all dialing formats that are considered standard
37 for cellular phone networks in USA (full international, or 11 digits starting
38 with '1' but no '+', or 10 digits only), as well as our own non-standard
39 shorthand dialing method with only 4 digits;
40
41 * Whenever someone dials one of our NANP numbers from the outside world, bulkvs
42 servers send UDP SIP INVITE packets to our server, and by dumping them with
43 our sip-udp-dump utility, we can see exactly what we have to work with;
44
45 * The rest remains to be implemented.