Build you own dial up ISP in 2019, Hacker News

Prerequisites

Hardware Requirements

A hardware modem (not a software modem or “winmodem”)
A Linux device (eg x 86 computer, Raspberry Pi, etc.) to communicate with the a modem as the dial-in server
A client device with a modem (any type)
Some form of telephony connection to link the two modems

The hardware I’ve chosen to use is:

Matrix MX Modem (more on this later)
USB to RS – 232 serial adapter (DE-9) to connect to the modem (with hardware flow control)
DE-9 to DB – 25 serial adapter
Linksys PAP2T analog telephone adapter (ATA)
x (- Windows based) PC with a US Robotics Sportster 28800 ISA modem

Software Requirements

Ubuntu server 18. 04
ppp
Getty
Asterisk

Choosing Modem Hardware

Modem hardware varies greatly, but this project doesn’t require anything beyond standard protocols between your ISP and client modems ( V. 22, V. 32, etc.)
This tutorialshouldwork with any dial-up modem that presents itself as a serial device to the operating system, including cheap USB modems, ISA modems , PCI modems and of course external RS – 232 serial modems.

Note: You will have a lot of trouble using asoftmodem / winmodem! You are much better off using a hardware-based modem.

I’ll be using an external serial modem USB-to-RS – 232 adapter for this tutorial. Using dedicated serial hardware has the advantage of being easy to troubleshoot and scaling up to dozens of lines (if you have enough desk space and USB ports).
My modem is an MX Modem made by MATRIX, but I was unable to find (anyinformation about it. Obviously the next step was to crack it open to figure out its capabilities.

Inside is a XECOM XE (C) .4kbps modem in a single component package. The PDF manual ishere.
To connect the modem to the ISP-side computer, I’m using a generic USB to RS – 232 adapter and a DE-9 to DB – 25 adapter.

Matrix MX Modem with top cover removed
MX Modem and RS 232 adapters

Note: Tutorial will be updated with USB modem support soon.

The Telephone Network

We need a way to connect our ISP modem to clients. There are many ways to approach this:

Use the actual PSTN (ie real phone lines)
Use a PBX to provide local connectivity
Build your own circuity (not covered here as it would require extra configuration)
Build a fake PSTN using VoIP ATAs and a software PBX

I’ve gone with the fourth option. Here’s the breakdown:

Asterisk – a VoIP PBX – is configured on the dial-in server to accept connections from two SIP client accounts and route calls between them.
A Linksys PAP2T ATA – which supports two phone lines – is set up as both of those SIP clients connected to the PBX.
The ISP-side modem is connected to the first line, and the client device to the second line.

Asterisk Setup

Install asterisk

sudo apt-get install asterisk

Append configuration for the two SIP clients to the end of (/ etc / asterisk / sip.conf)

[pap2t-ispmodem] context=default type=friend secret=password qualify=200; Qualify peer is no more than 200 ms away host=dynamic; This device registers with us directmedia=yes; Send RTP directly to the peer to reduce latency and jitter regexten=881 nat=no  [pap2t-client] context=default type=friend secret=password qualify=200; Qualify peer is no more than 200 ms away host=dynamic; This device registers with us directmedia=yes; Send RTP directly to the peer to reduce latency and jitter regexten=882 nat=no

Edit/ etc / asterisk / extensions.confand make two changes:
Search for[default](should be around line 672) and comment out
include=>demo
Underneath that line, add a new line with
exten=>_X!, 1, Dial (SIP / pap2t-ispmodem, 20)
The _X! tells this dial plan rule to match any number a client dials and send the call to the pap2t-ispmodem client
Enable the asterisk service so it starts on boot
sudo systemctl enable asterisk
Start Asterisk
sudo systemctl start asterisk

Open the Asterisk console to confirm your ATA lines are registered
sudo asterisk -rvvvv

dialupserver * CLI>sip show peers Name / username Host Dyn Forcerport Comedia ACL Port Status Description pap2t-client / pap2t-client  1.8. 112 D No No 5061 OK (7 ms) pap2t-ispmodem / pap2t-ispm  1.8. 112 D No No  OK (6 ms) 2 SIP PEERS [Monitored: 2 online, 0 offline Unmonitored: 0 online, 0 offline]

If you make changes to your configuration after starting Asterisk, you can use thereloadcommand in the console to reload the configuration.

ATA SIP registration example:

- Registered SIP 'pap2t-ispmodem' at  1.8. 112: 5060        >Saved useragent "Linksys / SPA 2102 - 5.2.5 "for peer pap2t-ispmodem        NOTICE [4253]: chan_sip.c: 24592 handle_response_peerpoke: Peer 'pap2t-ispmodem' is now Reachable. (7ms /  (ms)     - Registered SIP 'pap2t-client' at  1.8. 112: 5061        >Saved useragent "Linksys / SPA 2102 - 5.2.5 "for peer pap2t-client        NOTICE [4253]: chan_sip.c: 24592 handle_response_peerpoke: Peer 'pap2t-client' is now Reachable. (5ms /  (ms)

Successful call example:

==Using SIP RTP CoS mark 5        >0x7fa  (e)  - Strict RTP learning after remote address set to: (**********************************************************************************************************************************. 1.8. : 16482     - Executing [[email protected]: 1] Dial ("SIP / pap2t-client - 00000002 "," SIP / pap2t-ispmodem, 20 ") in new stack   ==Using SIP RTP CoS mark 5     - Called SIP / pap2t-ispmodem     - SIP / pap2t-ispmodem - 00000003 is ringing        >0x7fa1f 8252350 - Strict RTP learning after remote address set to: 10 1.8. 112: 16384     - SIP / pap2t-ispmodem - 00000003 answered SIP / pap2t-client- 00000002     - Channel SIP / pap2t-ispmodem - 00000003 joined 'simple_bridge' basic- bridge    - Channel SIP / pap2t-client - 00000002 joined 'simple_bridge' basic -bridge       >Bridge 5f  (eb-3f)  -  (D1 -) ****************************************************************************************************************** (B3-C) ***************************************************************************************************************** (c)  C2D 38: switching from simple_bridge technology to native_rtp        >Remotely bridged 'SIP / pap2t-client - 00000002 'and' SIP / pap2t-ispmodem - 00000003 '- media will flow directly between them        >0x7fa1f 8252350 - Strict RTP learning after remote address set to: 10 1.8. 112: 16384        >0x7fa  (e)  - Strict RTP learning after remote address set to: (**********************************************************************************************************************************. 1.8. : 16482     - Channel SIP / pap2t-client - 00000002 left 'native_rtp' basic -bridge    - Channel SIP / pap2t-ispmodem - 00000003 left 'native_rtp' basic- bridge  ==Spawn extension (default, 88567682, 1) exited non-zero on 'SIP / pap2t-client - 00000002 '        >0x7fa1f 8252350 - Strict RTP learning after remote address set to: 10 1.8. 112: 16384

ATA Configuration

I won’t go into much detail on ATA configuration since the topic has been beaten to death on various forums. This is the process to get basic communication:

Set up both lines on the ATA to register to the PBX with usernames ‘pap2t-ispmodem’ and ‘pap2t-client’ and the password ‘password’
Use the G. 711 µ-law codec
Disable every echo cancellation option in your ATA (see (here for PAP2T instructions) )
Set the jitter buffer to be as small as possible

Congratulations! You now have your own voice network.

The Dial-in Server

Install your Debian-based Linux distribution of choice (not covered here)
Update to latest packages and reboot if required

sudo apt-get update sudo apt-get upgrade sudo reboot

Connect the USB to RS – 232 adapter and confirm it shows up as / dev / ttyUSBXXX (ls / dev /to check). In my case, it presents as/ dev / ttyUSB0
My serial adapter is a “ID 1a 86: 7523 QinHeng Electronics HL - (USB-Serial adapter) "
Install ppp (and getty if your distro doesn’t have it by default)
```
sudo apt-get install ppp mgetty
```

Many of the old guides were written when inittab was still around, but it’s 2019 and systemd has taken over.
We need to create a systemd service for mgetty, so edit/ lib / systemd / system / mgetty.servicewith your text editor of choice as root.

[Unit] Description=External Modem Documentation=man: mgetty (8) Requires=systemd-udev-settle.service After=systemd-udev-settle.service  [Service] Type=simple ExecStart=/ sbin / mgetty / dev / ttyUSB0 Restart=always PIDFile=/ var / run / mgetty.pid.ttyUSB0  [Install] WantedBy=multi-user.target

Configure mgetty by editing/ etc / mgetty / mgetty.configwith your text editor of choice as root.
Comment out everything except the debug level, and append the section for configuring the serial device:
```
debug 9  port ttyUSB0  port-owner root  port-group dialout  port-mode 0660  data-only yes  ignore-carrier no  toggle-dtr yes  toggle-dtr-waittime 500  rings 2  #autobauding yes  speed 9600
```
Enable the mgetty service so it starts on boot:
sudo systemctl enable mgetty.service
Start mgetty:
sudo systemctl start mgetty.service

Configure ppp by editing/ etc / ppp / options
Like above, comment out everything except these settings:

# Define the DNS server for the client to use ms-dns 8.8.8.8 # async character map should be 0 asyncmap 0 # Require authentication auth # Use hardware flow control crtscts # We want exclusive access to the modem device lock # Show pap passwords in log files to help with debugging show-password # Require the client to authenticate with pap   pap # If you are having trouble with auth enable debugging debug # Heartbeat for control messages, used to determine if the client connection has dropped lcp-echo-interval 30 lcp-echo-failure 4 # Cache the client mac address in the arp system table proxyarp # Disable the IPXCP and IPX protocols. noipx

Create a device option file by editing/ etc / ppp / options.ttyUSB0

local lock nocrtscts 192. 168.  1:  168. 32. 105 netmask 255. 255. 255 noauth proxyarp lcp-echo-failure 60

Create the user for PAP authentication:
sudo useradd -G dialout, dip, users -m -g users -s / usr / sbin / pppd dial
Set a password:
(sudo passwd dial)
Edit/ etc / ppp / pap-secretsand append the username and password (same as you entered above, quotes included):
dial * "dial" *
Enable packet forwarding for IP4 by editing/ etc / sysctl.conf:
net.ipv4.ip_forward=1
The last step for the dial-up server is to configure the firewall to allow traffic forwarding from PPP out onto the network (and off to the Internet).
1. On Linux distributions with iptables, you need to add a line to/ etc / rc.localto enable masquerading. If your Ethernet interface is named eth0, you would add this line:
  iptables -t nat -A POSTROUTING -s 192. 168. .0 / 24 -o eth0 -j MASQUERADE
2. On modern Ubuntu installs, ufw is used as a frontend to iptables, so the procedure is a bit different. Followthis guide, but you can omit- o eth0and use (s) . 168. 0 / 24.

Troubleshooting

When using an external modem, the choice of USB to RS – 232 adapter seems to be crucial. There aren’t many requirements, but you must use an adapter that supports hardware flow control. If you need to purchase an adapter, you can either get one that explicitly says it supports hardware flow control ($$$), or play the eBay lottery and buy a half-dozen different models and hope one of them works.

I ran into a bug in Debian 9.5 with my USB to serial adapter using the ch 341 driver, where setting the baud rate was not working on some Linux kernels. (Seems to bethis bug)

To troubleshoot modem communication and baud rate settings, use minicom (or screen) to open a session over serial and try different settings (or read your modem’s manual!). Sending the command ‘AT’ followed by a new line should result in your modem replying ‘OK’.
If you’re getting nothing at all out of your modem, perform aserial loopback test

If mgetty is not answering incoming calls, it may be having trouble communicating with your modem. Check the logs in/ var / log / mgetty /to determine the problem. You may need to set a modem initialization string in the mgetty device config file, so check your modem’s manual for help on this.