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