Using these instructions and the affordable Wio Tracker GSM from Seeed Studio, you can quickly get connected to the internet with Twilio's Programmable Wireless.
In this quickstart, we'll use the Arduino IDE to program our board. However, the modifications we make should be adaptable outside of the Arduino ecosystem.
In this Quickstart, you'll learn how to:
- Sign up for Twilio
- Purchase your first SIM cards for Twilio Programmable Wireless
- Insert your SIM card into a GSM Wio Tracker
- Connect the included cellular PCB antenna to the Tracker
- Power and flash the Wio Tracker
- Verify you are connected to the internet
- Wio Tracker GSM
- Included PCB Cellular Antenna
- Highly Recommended: 3.7v Lithium Ion Battery with JST SH 1.0mm 2-pin connector
- (Without the battery, performance will be unreliable due to power draw)
- Arduino IDE
- Seeed Board Support Package for Arduino
- Follow the instructions through the link to install
- Serial Port Driver
- (You likely need to restart after installing the serial port driver)
While most of your code will be transferrable, it’s important to note: for new product development in the United States 2G isn’t a good choice.
American 2G networks are being deprecated. For new development, we suggest researching alternatives or discussing your idea with the Twilio Programmable Wireless team.
Already have a Twilio account and SIM card? Skip ahead to the register and activate step.
Before you can connect with Twilio Programmable Wireless you'll need to sign up for a Twilio account. Once you've done that, continue this quickstart.
Note: Orders of 10 SIMs or more will be delivered with the SIM cards already registered to your account.
Once you receive your SIM shipment, choose one and remove it from any packaging. Once removed, visit the Register a SIM page in the Wireless Console.
Follow that up by next picking a distinct Unique Name for this SIM.
Next, select a rate plan from the options provided by Twilio.
By default, there are rate plans added which approximate the usage we see in the field. Rate Plans let you control every aspect of what your device can do in the field and their data usage, but their complete capabilities are beyond the scope of this post.
When you're happy with the naming and rate plan, click to 'Activate' the SIM card.
Note: You'll need to activate your SIM for real-world workflows although you can use small amounts of data without activating.
With the Wio Tracker still disconnected from power, remove the cellular PCB antenna from the packaging. Connect it to the labeled connector on the Wio. Your setup should look like this:
Punch out your Twilio SIM card if necessary and insert it into the slot closest to the PCB on the Wio. The slot is on the modem side and has an orientation diagram. You want to put it in the 'bottom' slot; the upper slot is for an optional MicroSD card.
If you have a 3.7v Lithium Ion battery with the proper connector, connect it to the Wio Tracker. Although the Tracker will run without a battery, brief spikes of power consumption may make the Tracker unreliable or cause a freeze. It is highly recommended you add a battery to your setup for reliability.
Now that everything is inserted and connected you're ready to power it up and flash it!
Follow these steps to get serial connected on the board.
- Using a MicroUSB cable, connect the Wio Tracker to an empty USB port on your computer. You should see signs of life (in LED form) on the board.
- Open the Arduino IDE if it isn't yet open. In the 'Tools' menu under 'Boards', scroll to 'Seeduino SAMD Boards' and select the 'Wio GPS Board'.
- A new serial port should be enumerated in the menu. Visit 'Tools' -> 'Port', then select the Wio Tracker's serial.
If everything is set up properly, now you're ready to add the firmware to the board. Create a new project and paste the following code, or download it from Github and open it in the Arduino IDE.
Once you have the code inside the IDE, 'Upload' the code to the board.
Open the serial monitor by visiting the 'Tools' menu, then selecting 'Serial Monitor'.
If everything goes well and your connections are true, you should see something like the following sequence as the Tracker boots up and connects to Twilio:
And there you have it! Internet connectivity with the Wio Tracker and Twilio Programmable Wireless.
Now that you have a Wio Tracker connected to Twilio, we can't wait to see what you do with it. Here are some possible places to go next:
- Emulate full end-to-end applications with Twilio Wireless Blueprints
- Manage a fleet of devices with the Programmable Wireless API
- Try Machine to Machine SMS Commands
- See all Programmable Wireless Guides and Tutorials