All Projects → jcs → Payphone

jcs / Payphone

notes and code for my payphone project

Programming Languages

perl
6916 projects

Projects that are alternatives of or similar to Payphone

Katari
Katari - Python Session Initiated Protocol Framework
Stars: ✭ 29 (-85.92%)
Mutual labels:  phone, asterisk
Soup
☎️ Original open source call flooder using Twilio's API.
Stars: ✭ 267 (+29.61%)
Mutual labels:  phone, asterisk
Docker Freepbx
Dockerized FreePBX 15 w/Asterisk 17, Seperate MySQL Database support, and Data Persistence and UCP
Stars: ✭ 331 (+60.68%)
Mutual labels:  phone, asterisk
Simple Dialer
A handy phone call manager with phonebook, number blocking and multi-SIM support
Stars: ✭ 138 (-33.01%)
Mutual labels:  phone
Maruos
Your phone is your PC.
Stars: ✭ 1,814 (+780.58%)
Mutual labels:  phone
Pagi
PHP AGI ( Asterisk Gateway Interface ) facade, with CDR ( Call Detail Record ), Call spool and schedule auto dial, Send and Receive Fax, Channel Variables, and Caller ID management
Stars: ✭ 161 (-21.84%)
Mutual labels:  asterisk
Vonage Ruby Sdk
Vonage REST API client for Ruby. API support for SMS, Voice, Text-to-Speech, Numbers, Verify (2FA) and more.
Stars: ✭ 203 (-1.46%)
Mutual labels:  phone
Vonage Python Sdk
Vonage Server SDK for Python. API support for SMS, Voice, Text-to-Speech, Numbers, Verify (2FA) and more.
Stars: ✭ 134 (-34.95%)
Mutual labels:  phone
Node Ari Client
Node.js client for ARI. This library is best effort with limited support.
Stars: ✭ 186 (-9.71%)
Mutual labels:  asterisk
Camera2
Camera App write with api 2
Stars: ✭ 156 (-24.27%)
Mutual labels:  phone
Plexus
Remove the fear of Android app compatibility on de-Googled devices.
Stars: ✭ 152 (-26.21%)
Mutual labels:  phone
Tg2sip
Telegram <-> SIP voice gateway
Stars: ✭ 142 (-31.07%)
Mutual labels:  asterisk
Ws Scrcpy
Web client prototype for scrcpy.
Stars: ✭ 164 (-20.39%)
Mutual labels:  phone
Asternet
AsterNET is an open source .NET framework for Asterisk AMI and FastAGI. AsterNET allows you to talk to Asterisk AMI from any .NET application and create FastAGI applications in any .NET language.
Stars: ✭ 138 (-33.01%)
Mutual labels:  asterisk
Socialtextview
A simple custom Android TextView that highlights content such as Mention, Hashtag, Phone, Email and Url.
Stars: ✭ 195 (-5.34%)
Mutual labels:  phone
Remote Control Pc
Control Laptop using Android. Remote control PC consists of android as well as desktop app written in Java to control laptop using phone.
Stars: ✭ 136 (-33.98%)
Mutual labels:  phone
Unifiedcontactpicker
Stars: ✭ 178 (-13.59%)
Mutual labels:  phone
Arcoreinsideouttrackinggearvr
Inside Out Positional Tracking (6DoF) for GearVR/Cardboard/Daydream using ARCore v1.6.0
Stars: ✭ 150 (-27.18%)
Mutual labels:  phone
Ngx Webcam
A simple Angular webcam component / pure & minimal, no flash-fallback
Stars: ✭ 148 (-28.16%)
Mutual labels:  phone
Mobile Select Area
手机联动选择地区
Stars: ✭ 157 (-23.79%)
Mutual labels:  phone

Payphone Project

These 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.

The Phone

This 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.

I purchased a new handset, mounting backplate, and mounting studs. I located some old instruction cards on eBay and upper and lower locks with key sets.

The 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.

The 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.

Mounting

To 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.

The phone is mounted at the standard height of 63" from the floor to the top of the housing.

Connectivity

Back 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).

The phone company's Automated Coin Toll Service (ACTS) would respond to the tones generated by the phone (or your red box) and allow the dialed phone number to connect for a certain amount of time.

Newer "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.)

Since 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.

I 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.

Since 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.

Sending Coin Tones to Asterisk

Since 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.

Using 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.

Relevant Asterisk sip.conf configuration for the ATA:

[2600]
canreinvite=no
callerid=<...>
context=payphone-totalizer
dtmfmode=inband
host=dynamic
nat=yes
progressinband=no
qualify=3000
secret=...
type=friend
disallow=all
allow=ulaw
allow=alaw

Relevant Asterisk extensions.conf configuration to take over the call as soon as 0 is dialed by the ATA:

[payphone-totalizer]
exten => 0,1,Answer
exten => 0,2,AGI(payphone.agi)
exten => 0,3,Hangup

Recognizing Coin Tones

Now 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, but doing so would be pretty complicated.

Since 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 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.

A small AGI script to recognize and accumulate inserted coin amounts, printing it to the Asterisk console:

#!/usr/bin/perl

use Asterisk::AGI;
use strict;

my $inserted = 0;
my $dialed = "";
my $AGI = new Asterisk::AGI;

# generate dialtone while we wait for coins
$AGI->exec("Playtones", "dial");

while (1) {
    my $digit = $AGI->wait_for_digit(1000);
    next if ($digit <= 0);

    if ($digit == ord('$')) {
        $inserted += 5;
        $AGI->verbose("got 5-cent tone (now " . $inserted . " cents)", 5);
    }
    else {
        $dialed .= chr($digit);
        $AGI->verbose("dialed " . chr($digit) . " (now " . $dialed . ")", 5);
    }
}

Now 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.

My routing script is under development here.

TODO

  • 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 (2) to the coin relay, and would have to be done out-of-band.
Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].