# HG changeset patch # User Mychaela Falconia # Date 1656789431 28800 # Node ID dffcae9bc8a336572bb47b2a370c1594105f5fee # Parent 660126bd5f599235a9b73d7c10d1507a4ea0c86a add README diff -r 660126bd5f59 -r dffcae9bc8a3 README --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/README Sat Jul 02 11:17:11 2022 -0800 @@ -0,0 +1,45 @@ +This Hg repository contains a work-in-progress named Themyscira Wireless system +software. Themyscira Wireless (ThemWi) is an experimental GSM network operated +by Mother Mychaela of FreeCalypso at a semi-urban/semi-rural location in +Southern California, USA; this GSM network is operated with Osmocom CNI software +components, all running on a single Slackware Linux server. ThemWi system sw +is going to be a suite of daemon processes and command line tools that run on +the same machine as all those Osmocom sw components and provide some additional +functionality that is not provided "out of the box" by Osmocom, most important +of which is outside connectivity to USA PSTN. + +Right now we have a themwi-mncc daemon process that connects to OsmoMSC via the +MNCC socket interface provided by the latter and takes the place of OsmoMSC's +mncc_builtin. themwi-mncc switches local calls (from one GSM subscriber to +another) just like mncc_builtin, but it also provides a hook (mtcall_socket) +for routing externally originated calls to GSM (which then become MT calls), +and it will later have a similar interface for routing MO calls to the outside +world. Additional daemon processes that will interface with USA PSTN via SIP +(one process accepting SIP INVITEs from bulkvs.com servers, turning them into +MNCC and sending the calls toward GSM, and another process going the other way) +remain to be implemented. + +We are currently experimenting with using bulkvs.com as our USA PSTN +connectivity provider. Like most low-cost PSTN connectivity providers, they +provide the interface to PSTN in the form of a SIP trunk - while I would +absolutely love to get a traditional TDM trunk instead, with SS7 signaling, +such a toy would be far beyond my budget, hence I have to settle for SIP. +Our current status is: + +* We have already obtained a block of USA phone numbers (NANP, chosen numbers + from an exchange area local to us) from bulkvs.com; + +* These bulkvs-sourced real NANP numbers have been entered as MSISDNs into + OsmoHLR records for our test SIMs operating on ThemWi GSM; + +* We can successfully dial calls from one ThemWi GSM phone to another, with + themwi-mncc understanding all dialing formats that are considered standard + for cellular phone networks in USA (full international, or 11 digits starting + with '1' but no '+', or 10 digits only), as well as our own non-standard + shorthand dialing method with only 4 digits; + +* Whenever someone dials one of our NANP numbers from the outside world, bulkvs + servers send UDP SIP INVITE packets to our server, and by dumping them with + our sip-udp-dump utility, we can see exactly what we have to work with; + +* The rest remains to be implemented.