jcs.org
notes and code for my payphone project
1## Payphone Project
2
3These are some notes from my project to install a working payphone in my home and configure it to make and receive calls through an Asterisk PBX.
4
5[](https://i.imgur.com/gn6paGq.jpg) [](https://i.imgur.com/QBEGEvc.jpg)
6
7#### The Phone
8
9This is a Western Electric/AT&T 1D2 single-slot "dumb" payphone, popular in the 1980s. It came with a T-key but no upper or lower locks or keys. The handset was pretty gross and there were no upper or lower instruction cards. Shipping was a bit expensive since the phone weighs nearly 50 pounds.
10
11I purchased a new [handset](http://www.payphone.com/Standard-Handset.html), [mounting backplate](http://www.payphone.com/Mounting-Backplate.html), and [mounting studs](http://www.payphone.com/Brass-Mounting-Stud.html). I located some old instruction cards on eBay and upper and lower locks with key sets.
12
13The instruction cards install by unscrewing a very tiny allen bolt in the front of the housing to allow the card to slide up and then back down.
14
15The replacement handset was wired differently than the handset that came with the phone, which initially caused the mouthpiece not to transmit any audio. By touching a AA battery to the wires of the disconnected handset, I was able to figure out which wires went to the earpiece and which to the mouthpiece. The handset's red wire is connected to terminal 3, yellow to 4, green to 6, and black to 8.
16
17#### Mounting
18
19To mount the phone to my wall, I drilled 5 holes into a wall stud and secured the backing plate to the wall with 2 1/4" screws. The mounting studs hand-screwed into the back of the phone which allowed the phone to easily hang on the backplate, aligning the 12 holes in the back of the phone to the 1/4x20 threaded holes in the backplate.
20
21The phone is mounted at the recommended height of 63" from the floor to the top of the housing.
22
23#### Connectivity
24
25Back when all payphones were owned by the phone company, a POTS line provisioned for a payphone provided dialtone to the phone. When coins were inserted, the phone's totalizer sent simultaneous 1700+2200 Hz tones down the line for each 5 cents (nickel = one 66 ms tone, dime = two 66 ms tones with a 66 ms pause in between, quarter = five 33 ms tones with 33 ms pauses).
26
27The phone company's Automated Coin Toll Service (ACTS) would respond to the tones generated by the phone (or your [red box](https://en.wikipedia.org/wiki/Red_box_%28phreaking%29)) and allow the dialed phone number to connect for a certain amount of time.
28
29Newer "smart" (Elcotel-style) payphones are commonly owned by private companies (Customer Owned Coin Telephones - COCOTs) and don't require a specially-provisioned phone line. The phone has an embedded circuit board that has to be programmed with rate information, allowing the phone itself to determine whether the call is allowed to go through based on the number dialed and the amount of coins inserted. These phones would have to get reprogrammed every so often by a company that calls into the pay phone and uploads new rate information to it. (If you're looking to acquire a payphone for personal use, avoid these "smart" phones. An easy way to tell them apart from the outside is that "dumb" phones have the coin slot on the left side and "smart" phones usually have it on the right. Inside it's easy to tell; just look for a big modern-looking circuit board.)
30
31Since this phone has always worked with a normal POTS line, making it work now just requires hooking up the red and green wires of an RJ11 cable to the Ring and Tip terminals in the phone. It rings, dials, and otherwise functions just like a normal analog telephone.
32
33I connected the phone to a Grandstream HT701 SIP ATA and was able to make and receive calls through an Asterisk soft PBX, with dialtone coming from the ATA. I registered an inbound number through Twilio (appropriately enough, one ending in -2600) and routed it to the Asterisk server via SIP.
34
35Since this a payphone, after all, it should require depositing coins to make a call. Much older phones (like 3-slot rotary phones) required coins to be deposited before hearing a dial tone. These were mostly phased out by the 1970s and replaced with phones that provided a dial tone first, allowing emergency calls without depositing coins as well as depositing extra coins for long-distance calls. Using Asterisk, this payphone will be configured to provide a dial tone first and allow free emergency calls, but require 25 cents to call any other number.
36
37#### Sending Coin Tones to Asterisk
38
39Since the ATA only establishes audio between the phone and Asterisk after a recognizable pattern of digits has been dialed (and sent to Asterisk all at once in one INVITE request), Asterisk would not be able to respond to coin tones generated before dialing.
40
41Using the ATA's "Offhook Auto-Dial" feature, I configured it to automatically (silently) dial `0` as soon as the handset was picked up. An AGI script on the Asterisk server would then take over, generating its own dialtone and responding to any tones sent by the phone.
42
43*Relevant Asterisk `sip.conf` configuration for the ATA:*
44
45 [2600]
46 canreinvite=no
47 callerid=<...>
48 context=payphone-totalizer
49 dtmfmode=inband
50 host=dynamic
51 nat=yes
52 progressinband=no
53 qualify=3000
54 secret=...
55 type=friend
56 disallow=all
57 allow=ulaw
58 allow=alaw
59
60*Relevant Asterisk `extensions.conf` configuration to take over the call as soon as `0` is dialed by the ATA:*
61
62 [payphone-totalizer]
63 exten => 0,1,Answer
64 exten => 0,2,AGI(payphone.agi)
65 exten => 0,3,Hangup
66
67#### Recognizing Coin Tones
68
69Now that Asterisk is receiving the 1700+2200 Hz tones generated when coins are inserted, some code is needed to actually recognize them. Using Asterisk EAGI would allow a program to read the raw audio stream and analyze it for the proper tone frequencies using the [Goertzel algorithm](https://en.wikipedia.org/wiki/Goertzel_algorithm), but doing so would be pretty complicated.
70
71Since Asterisk is already doing in-band dual-tone multi-frequency (DTMF) detection for numerical digits, modifying it to recognize the coin tones is much less complicated. [This patch to Asterisk's DSP module](asterisk-dsp_recognize_coins.patch) recognizes the 1700+2200 Hz tone and turns it into a `$` digit, allowing any AGI or other code handling numeric digits to easily recognize coin tones.
72
73*A small AGI script to recognize and accumulate inserted coin amounts, printing it to the Asterisk console:*
74
75 #!/usr/bin/perl
76
77 use Asterisk::AGI;
78 use strict;
79
80 my $inserted = 0;
81 my $dialed = "";
82 my $AGI = new Asterisk::AGI;
83
84 # generate dialtone while we wait for coins
85 $AGI->exec("Playtones", "dial");
86
87 while (1) {
88 my $digit = $AGI->wait_for_digit(1000);
89 next if ($digit <= 0);
90
91 if ($digit == ord('$')) {
92 $inserted += 5;
93 $AGI->verbose("got 5-cent tone (now " . $inserted . " cents)", 5);
94 }
95 else {
96 $dialed .= chr($digit);
97 $AGI->verbose("dialed " . chr($digit) . " (now " . $dialed . ")", 5);
98 }
99 }
100
101Now that the amount of inserted coins can be recognized, along with any digits dialed, it's possible to make a full script that can refuse to connect calls and play an error message until a certain amount of money is inserted. Toll-free numbers, 911, etc. can be connected before any coins are collected.
102
103My routing script is [under development here](payphone.agi).
104
105#### TODO
106
107- Make the coin hopper queue up coins when inserted rather than immediately dropping them into the coin box, to allow for refunding. This [requires sending high voltage](http://web.archive.org/web/20201127205016/http://oldphoneguy.net/images/MPPwk.pdf) ([2](http://web.archive.org/web/20171014015056/http://atcaonline.com/controller.html)) to the coin relay, and would have to be done out-of-band.