annotate Use-outside-USA @ 0:6da76097c86e

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