stuff with trunks

content/blog/2022-02-14-personal-pbx.md

@@ -36,5 +36,71 @@ I have personally used Asterisk a fair bit due to its heavy use in the Amateur R
 
 ## The goals for this project
 
+Going in to this project, I had a few seperate goals I decided to complete at the same time:
+
+- Build my own PBX without using someone else's base configs
+- Play around with [Twilio](https://www.twilio.com/)'s services
+- Spice up my existing [Hamshack Hotline](https://hamshackhotline.com/) connection
+
+And of course, like all my other projects, this one is running on a budget. Less than $10 per month for all required SAAS and IAAS subscriptions.
+
+## Acquiring a PSTN phone number
+
+The [Public Switched Telephone Network](https://en.wikipedia.org/wiki/Public_switched_telephone_network) (PSTN) is likely the only phone network you have interacted with knowingly. This is the network your cellphone number will be allocated under, and the network that routes your calls to your friends.
+
+Generally, if you wanted a PSTN number, you have to go to a phone carrier and get a landline or cellular subscription. Since I needed a number for a PBX, I took a slightly different approach.
+
+*Twilio* provides a programatically controllable PSTN service. Their services include:
+
+- SMS/MMS messaging APIs
+- VOIP phone numbers
+- Email APIs
+- Elastic SIP trunking
+- ..and much more
+
+I am personally interested in their [SIP Trunking](https://www.twilio.com/sip-trunking) service. When renting a number from Twilio (which costs just a dollar a month), you can create a SIP trunk from your PBX to theirs, and they will route all inbound calls back to you, plus allow you to place outbound calls to the PSTN through them.
+
+*Hey students, you practically do all of the Twillio stuff in this post for **free** through [GitHub Student Pack](https://education.github.com/pack/offers)* :wink:
+
+## Software PBXes and Trunking
+
+Before I get much further, I should explain the options for hosting a PBX, along with an explanation of trunking.
+
+Ignoring physical PBXes, there are a few options for self-hosting a phone network.
+
+- Using a commercial service like [3CX](https://www.3cx.com/)
+- Using one of the many Asterisk-based sofware packages
+- Using [SIPFoundry](https://www.sipfoundry.org/)
+
+As previously stated, I chose to go with an Asterisk-based system. Specifically, [FreePBX 15](https://www.freepbx.org/). There are other Asterisk-based systems available as well:
+
+- Simply running Asterisk on a server without any management software
+- [VitalPBX](https://www.vitalpbx.com/)
+- [PBXInAFlash](https://sourceforge.net/projects/pbxinaflash/)
+
+### Trunking
+
+Trunking in the telephony world, is essentially the same as VLANs in the computer networking world. A trunk is a seperate network that can be routed to and from based on your PBX routing rules.
+
+In my system, I have two trunks, one for Twilio (and by extension the whole PSTN), and one for Hamshack Hotline.
+
+![My trunking setup](/images/posts/personal-pbx/my_trunks.png)
+
+## Provisioning an IAX2 Trunk through Hamshack Hotline
+
+*Hamshack Hotline* is a service for Amateur Radio operators that allows us to connect physical VOIP phones to a private phone network for direct-calling other operators, clubs, and even [supported repeaters](https://apps.hamshackhotline.com:9091/links.php). All users must prove their licence status.
+
+Since this section does not apply to the majority of my audience, I will not go into the details of how to link up with Hamshack Hotline. Instead, I'll just link [their guide for doing this](https://wiki.hamshackhotline.com/doku.php?id=kb:iax:trunk.info).
+
+## Pulling everything together
+
+To get this whole system working, I spun up a droplet on [Digital Ocean](https://m.do.co/c/34e43c62fd02) and used their [FreePBX image](https://marketplace.digitalocean.com/apps/freepbx-1?refcode=34e43c62fd02&utm_campaign=Referral_Invite&utm_medium=Referral_Program&utm_source=badge) to quickly get up and running.
+
+Then, I set up a number on Twilio and followed their [Elastic SIP Trunking guide](https://twilio-cms-prod.s3.amazonaws.com/documents/TwilioElasticSIPTrunking-FreePBX-Configuration-Guide-Version1-0-FINAL-06122018.pdf). As well as the Hamshack Hotline guide linked above.
 
 
+## Conclusion
+
+In the end, with some additional tweaking to the [IVR](https://en.wikipedia.org/wiki/Interactive_voice_response) settings to allow external password access, I was able to get a working PBX up and running.
+
+I can now place a PSTN call from my cellphone to the PBX, enter a password, then dial a Hamshack Hotline RF-Link number to call up repeaters from my phone.

static/images/posts/personal-pbx/my_trunks.dot

@@ -0,0 +1,18 @@
+graph G {
+    pstn -- twilio;
+    other_hams -- hh;
+    allstar -- hh;
+    twilio -- pbx;
+    hh -- pbx;
+    pbx -- phone, desktop, laptop;
+    
+    pstn[label="PSTN"];
+    twilio[label="Twilio"];
+    other_hams[label="Other Hams"];
+    allstar[label="AllStarLink"];
+    hh[label="Hamshack Hotline"];
+    pbx[label="My PBX"];
+    phone[label="My Phone"];
+    desktop[label="My Desktop"];
+    laptop[label="My Laptop"];
+}