- 1A Telnyx Portal account and active Telnyx SIM card with data plan. Check out this Quickstart Guide to get set up.
- 2Raspberry Pi 3 Model B or Raspberry Pi 4 (this guide will use 4 but the steps are the same).
- 3Make sure both the firmware and software are up-to-date on your Pi.
- 4This device does not work using the USB port; you must plug in directly to your Pi's 40-pin connector.
Alright, let's get started!
- 1First, we will enable UART. This will allow us to communicate directly with the device using AT commands. To do that, run this command and then follow the prompts as shown:
- Choose Interfacing Options (5):
- Choose P6 Serial:
- Press No to the prompt below then Reboot.
- 2Now, let's retreive necessary repository from Sixfab to begin the installation:
- 3Let's take ownership of the script and install it:
chmod +x install.sh sudo ./install.sh
- 4After running these commands, the terminal will prompt you to choose your HAT device. Select "Raspberry Pi Cellular IoT HAT". Follow the guided prompts and type
data00.telnyxfor the APN and "ttyS0" for the port. If you selected something else during this step, please run the script again.
- 5Type "y" to enable autoconnect/reconnect service. If you select "n", then the APN may not be properly saved into the plist.
If you have issues with network connectivity, check
ifconfig to see if interface PPP0 is visible (it should be located at the very bottom).
If you do not see this entry, repeat step 3 above. Sixfab's script is designed to skip items when there is an error or a part doesn't run properly.
If you see the PPP0 interface but there is no data connection please try the following steps.
- 1Try pinging Google DNS at 126.96.36.199.
- 2If this doesn't work, reboot the Pi and reset the interface.
sudo reboot sudo ifconfig ppp0 down sudo ifconfig ppp0 up
- 3If this step fails, run step 3 and 4 from the original setup again with a blank APN, then run the script again with the correct APN (
- 4Check the antenna connection - main & GPS. An improperly seated connection will cause the device to reboot.
- 5Check if the antenna supports your HAT model.
- 6Check the Pi's power supply - the HAT itself uses 2 - 6 watts of power. Make sure you are using a sufficient power supply for your Pi. Raspberry Pi 3 requires at least 12W of power. Raspberry Pi 4 requires at least 15W of power.
- 7Slow internet may cause issues in your setup too. The theoratical speed max for this HAT is about 350 Kbps range as this is the limitation of the CATM1 network. This is normal.