FreeCalypso > hg > themwi-nanp
view README @ 12:1ebc312f4b69
add README
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Wed, 13 Dec 2023 05:53:17 +0000 |
parents | |
children |
line wrap: on
line source
Themyscira Wireless system software (server-side software, add-ons to Osmocom CNI suite) is being split into two principal domains: themwi-csw will be the suite for circuit-switched calls (initially just voice, but later CSD too), mostly unchanged from OsmoDevCall 2023-09-20 presentation; themwi-smsc will be the SMSC for Themyscira Wireless, connecting to Osmocom GSM network via GSUP and to the outside world via SMPP. The one piece which is common between these two domains is the database of locally owned phone numbers per North American Numbering Plan (NANP): whether the task at hand is routing a call or routing SMS, either way we need to be able to look at a phone number and immediately tell (without querying another server or process) if that number belongs in the local fiefdom or in the outside world. Because the set of NANP telephone numbers which belong in the local fiefdom is the same across different service types, the number database is shared between the two domains - and the easiest way to share this database is to factor out and share the code that implements it. The present themwi-nanp package implements the number database part of ThemWi and nothing else. It provides administration utilities, as well as libraries and header files that will be used by both themwi-csw and themwi-smsc; the present package needs to be compiled and installed before the other two. In a departure from other Falconian software, some work has been done to harmonize the dialect of C language with that used by Osmocom. The present suite of software (themwi-*) is unusual in that it has no function by itself, its only function is to serve as an add-on to Osmocom CNI suite - hence it is desirable to have as much harmonization as possible between the base and the add-on.