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.