view doc/Use-outside-USA @ 275:def9f6e4f49e default tip

doc/Use-outside-USA: Fake-NANP-numbers article is here
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 27 Nov 2023 21:49:19 -0800
parents d6630a2d6e80
children
line wrap: on
line source

Themyscira Wireless system sw was written for deployment in USA, with a key goal
of full interconnection with USA PSTN.  However, as the software grows in
functionality and becomes more interesting, there is a growing possibility that
someone some day may be interested in running our sw outside of USA, or outside
of North American continent in general.  This document outlines some thoughts
for how it might be possible to adapt the present software for use in other
geopolitical regions.

The first point that needs to be made clear is that software has no extrasensory
psychic powers - it cannot divine where you are located in physical geography,
and it doesn't care.  Instead the aspects which telephony software cares about
are dialing formats and numbering plans - and in the case of Themyscira Wireless
system sw, the "thing" to which our sw is tied is NANP, the telephone numbering
plan of +1 country code.

If anyone is contemplating the idea of running ThemWi system sw in a country
other than USA, the first question that needs to be answered is: are you looking
to interconnect with your country's national public telephone network similarly
to how we (ThemWi) interconnect with USA PSTN, or are you only interested in
running an isolated (test or toy) network without interconnection to PSTN?

Interconnecting with PSTN outside of USA
========================================

Suppose that your country has SIP trunk providers who operate similarly to those
in USA: you rent a range of numbers in your country's national telephone
numbering plan, calls addressed to those numbers are delivered to your Internet-
connected server via SIP, and you can likewise use SIP to dial outbound calls.
At this point our current software will NOT work as-is - it will require
modifications to work with the local numbering plan being some other than NANP.

Please read our NANP-specifics article for the explanation of why our current
software is tied to NANP, and in exactly what ways.  That article also gives an
outline of what changes would need to be made to support other national
telephone numbering plans.

Running an isolated instance of Osmocom CNI + ThemWi system sw
==============================================================

If you are not interconnecting with your country's public phone network with
real phone numbers from your country's national telephone numbering plan, then
it doesn't matter where you are located in terms of physical geography - your
network will be either fully isolated (self-contained) or perhaps interconnected
with other hobbyist or community networks - but not with general PSTN.

If you would like to run ThemWi system sw in such non-PSTN-connected
configuration, the easiest way is to use fake NANP numbers - see
Fake-NANP-numbers article for more info.