Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Programmable Wireless: Seeed Wio Tracker LTE Quickstart

Using these instructions and a Wio Tracker LTE from Seeed Studio, you'll quickly connect to the internet using Twilio's Programmable Wireless.

We'll use the Arduino IDE in this quickstart. The modifications we make should be adaptable outside, however.

In this quickstart, you'll learn how to:

  1. Sign up for a Twilio account
  2. Purchase a Twilio Programmable Wireless Starter Pack which comes with 3 SIM cards
  3. Insert a SIM card into the Wio Tracker LTE
  4. Connect the included cellular PCB antenna to the Wio Tracker
  5. Power and flash the Wio Tracker
  6. Verify you are connected to the internet via Programmable Wireless

Hardware Prerequisites

  • Wio Tracker LTE
    • PCB cellular antenna included

  • 3.7v Lithium Ion Battery with JST SH 1.0mm 2-pin connector

Setup & Software Requirements

Not the quickstart you were looking to complete? See our other Programmable Wireless quickstarts or see all Wireless resources.

I'm got everything ready - let's do this!

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 a Twilio account. Once you've signed up, continue with this quickstart.

First, visit the Programmable Wireless Console. On the Orders page, purchase a set of 3 starter SIMs by selecting the SIM Starter Pack... or make a larger custom order by entering a quantity under the Multi-Size SIM Card product.

Order SIM Cards from Twilio

Note: Orders of 10 SIMs or more will be delivered with the SIM cards already tied to your account.

I've got my SIM! What's next?

Register, assign a Rate Plan, and activate your SIM

Once you receive your SIM shipment, visit the Register a SIM page in the Programmable Wireless Console.

SIM Card Registration Code

Follow that up by picking a Unique Name for the SIM.

Choose a Rate Plan

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. We've added a couple defaults which approximate usage we see in the field, but feel free to explore options later.

Activate a SIM card

When you're happy with the Rate Plan, '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.

I'm active! Let's track things with the Wio Tracker LTE!

Attach the Cellular Antenna to the Wio Tracker

With the Wio Tracker still disconnected from power, remove the cellular PCB antenna from the packaging. Connect it to the connector labeled 'LTE' on the Wio. Your setup should look like this:

Wio Tracker LTE Cellular Antenna

Insert the SIM Card

Punch out your Twilio SIM card 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.

Inset the SIM Card

Prepare to Connect the Battery

We had version 1.1 of the Wio Tracker LTE and the module consumed too much power to be driven over USB.

Connect a 3.7v Lithium Ion battery to the board. If you use the adapters listed on Amazon carefully note the polarity of the plug before making connections. Our wires were reversed red/black for the plug onboard.

Note that the below picture shows the black and red wires oriented reverse of what the board asks for. If you purchase the same item as we did your setup will be similar - triple check the polarity before using the battery if you build an adapter like us.

Wio Tracker Insert Battery

Note how the battery connects and the orientation, but don't plug it in yet. Before you power up you need to complete one more step we'll cover in a second.

Getting close now - let's go.

Connect to the Wio Tracker LTE over serial

Follow these steps to get serial connected on the board. Note that if you change the code you will need to reboot the board in 'DFU Mode".

Hold down the 'boot' button on the module side of the Wio. It is black with a 'BOOT0' label.

  1. While still holding the boot button, plug the Micro USB cable between the Tracker and the computer. You should see a flashing LED on the microcontroller side.
  2. 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.
  3. Open the Arduino IDE if it isn't yet open. In the 'Tools' menu under 'Boards', scroll to 'Seeed STM32F4 Boards' and select the 'Wio Tracker LTE'.
    Seeed LTE Select

  4. DO NOT select a serial port. Your board is in DFU mode so 'Port' should be empty:
    No Port Selected

Simple - are we adding code next?

Flash the Wio Tracker with the Firmware

Now you're ready to add the firmware to the board. Create a new project and paste the following code, or retreive it from Github and open it in the Arduino IDE.

        Connect to Twilio Programmable Wireless with the Seeed Studio Wio Tracker LTE

        Programmable Wireless with a Seeed Studio Wio Tracker LTE

        Connect to Twilio Programmable Wireless with the Seeed Studio Wio Tracker LTE

        Once you have the code inside the IDE, 'Upload' the code to the board. Once uploaded, you should see a success message in the Arduino console below the IDE window.

        Monitor the results over serial

        Seeed does not recommend using the in-built serial monitor as it can sometimes interfere with the programming process. We'll share instructions to monitor the results through two methods.

        Serial Monitor NOT in Aruino

        1. Unplug the Wio
        2. Connect the battery to the Wio
        3. Immediately connect the MicroUSB cable between Wio and computer

        The next step depends on your platform.

        For Windows, we suggest using the terminal emulator PuTTY to connect - the Wio will enumerate as a COM port. Follow this document to connect and use 115200 baud 8-N-1 signaling.

        On a Mac OSX or *NIX machine, you should have the 'screen' emulator built-in. Open a new terminal and run screen using a command similar to the following:

        screen /dev/tty.somenumbersandletters 115200

        Serial Monitor IN Arduino

        1. Unplug the Wio
        2. Connect the battery to the Wio
        3. Immediately connect the MicroUSB cable between the Wio and computer
        4. The serial port will enumerate and you will see it in the 'Tools' -> 'Port' -> <port name> menu. Select the new serial port
        5. Open the serial monitor by visiting the 'Tools' menu, then selecting 'Serial Monitor'
        I'm connected! What should I do next?!

        Where to next?

        Now that you have a Wio Tracker LTE on Twilio Programmable Wireless, we can't wait to see what you do next. Here's some inspiration:

        Rate this page:

        Need some help?

        We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.