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