FreeCalypso > hg > themwi-system-sw
comparison doc/Use-outside-USA @ 268:d6630a2d6e80
doc: beginning of numbering plan documentation
| author | Mychaela Falconia <falcon@freecalypso.org> |
|---|---|
| date | Mon, 13 Nov 2023 18:20:57 -0800 |
| parents | |
| children | def9f6e4f49e |
comparison
equal
deleted
inserted
replaced
| 267:81958b35f74d | 268:d6630a2d6e80 |
|---|---|
| 1 Themyscira Wireless system sw was written for deployment in USA, with a key goal | |
| 2 of full interconnection with USA PSTN. However, as the software grows in | |
| 3 functionality and becomes more interesting, there is a growing possibility that | |
| 4 someone some day may be interested in running our sw outside of USA, or outside | |
| 5 of North American continent in general. This document outlines some thoughts | |
| 6 for how it might be possible to adapt the present software for use in other | |
| 7 geopolitical regions. | |
| 8 | |
| 9 The first point that needs to be made clear is that software has no extrasensory | |
| 10 psychic powers - it cannot divine where you are located in physical geography, | |
| 11 and it doesn't care. Instead the aspects which telephony software cares about | |
| 12 are dialing formats and numbering plans - and in the case of Themyscira Wireless | |
| 13 system sw, the "thing" to which our sw is tied is NANP, the telephone numbering | |
| 14 plan of +1 country code. | |
| 15 | |
| 16 If anyone is contemplating the idea of running ThemWi system sw in a country | |
| 17 other than USA, the first question that needs to be answered is: are you looking | |
| 18 to interconnect with your country's national public telephone network similarly | |
| 19 to how we (ThemWi) interconnect with USA PSTN, or are you only interested in | |
| 20 running an isolated (test or toy) network without interconnection to PSTN? | |
| 21 | |
| 22 Interconnecting with PSTN outside of USA | |
| 23 ======================================== | |
| 24 | |
| 25 Suppose that your country has SIP trunk providers who operate similarly to those | |
| 26 in USA: you rent a range of numbers in your country's national telephone | |
| 27 numbering plan, calls addressed to those numbers are delivered to your Internet- | |
| 28 connected server via SIP, and you can likewise use SIP to dial outbound calls. | |
| 29 At this point our current software will NOT work as-is - it will require | |
| 30 modifications to work with the local numbering plan being some other than NANP. | |
| 31 | |
| 32 Please read our NANP-specifics article for the explanation of why our current | |
| 33 software is tied to NANP, and in exactly what ways. That article also gives an | |
| 34 outline of what changes would need to be made to support other national | |
| 35 telephone numbering plans. | |
| 36 | |
| 37 Running an isolated instance of Osmocom CNI + ThemWi system sw | |
| 38 ============================================================== | |
| 39 | |
| 40 If you are not interconnecting with your country's public phone network with | |
| 41 real phone numbers from your country's national telephone numbering plan, then | |
| 42 it doesn't matter where you are located in terms of physical geography - your | |
| 43 network will be either fully isolated (self-contained) or perhaps interconnected | |
| 44 with other hobbyist or community networks - but not with general PSTN. | |
| 45 | |
| 46 If you would like to run ThemWi system sw in such non-PSTN-connected | |
| 47 configuration, the easiest way is to use fake NANP numbers - see | |
| 48 Fake-NANP-numbers article (to be written) for more info. |