Wio LTE Setup Guide

Requirements


Hardware Setup

  1. Insert Soracom Air SIM card into Wio LTE, ensuring the SIM card is oriented correctly:

  2. Attach the two antennas to the Wio LTE, using the antenna connectors LTE Main and LTE.

  3. Attach the micro-USB cable to the Wio LTE.

  4. Attach sensors to the Wio LTE. In this example, we have attached the buzzer and GPS module:

    When attaching other sensors, please refer to the Wio LTE manual to ensure that your sensors are plugged into an appropriate plug.

    Certain sensors included with your Wio LTE kit require additional power to function. This power is provided by specific sensor ports on the Wio LTE. As each port on the Wio LTE differs, ensure that you use the correct port for each sensor. Incorrect usage may result in damage to the sensor or to the Wio LTE controller.


Switching Modes

The Wio LTE has two different modes:

You can switch modes by using the RST button located on the front of the board next to the 3.5mm aux port, and the BOOT button located on the rear of the board across from the SIM/micro-SD slot.

Normal Mode

By default, when you connect the Wio LTE to your computer or to a USB power source, it will boot up in Normal mode.

If your Wio LTE is currently connected to your computer in DFU mode, you can switch to Normal mode without unplugging the USB cable by simply pressing the RST button once.

When connected to your computer, you can check that your Wio LTE is connected in normal mode:

DFU Mode

To enter DFU mode, your Wio LTE should be connected to your computer in normal mode. Then:

  1. Press and hold the BOOT button.
  2. Press and release the RST button.
  3. Release the BOOT button.

The Wio LTE will switch to DFU mode.

You can check that your Wio LTE is connected in DFU mode:


Driver Installation

Install Windows Drivers

When using Windows, the following drivers are required:

Additionally, we will install TeraTerm which will let us connect to the Wio LTE serial port to view its output.

WinUSB Driver

  1. Download Zadig 2.3 (zadig-2.3.exe) from the official site.
  2. Switch the Wio LTE to DFU mode.
  3. Run zadig-2.3.exe.
  4. From Zadig 2.3, click Options List All Devices
  5. Select STM32 BOOTLOADER. Once the Driver line changes to STTub30 → WinUSB, click Replace Driver.

Once installed, the Wio LTE should show up in Device Manager underneath Universal Serial Bus controllers as STM32 BOOTLOADER.

Virtual COM Port Driver
  1. Download and extract Virtual Com Port (stsw-stm32102.zip) from the Wio LTE Github page (Japanese).
  2. Run VCP_V1.4.0_Setup.exe. This will install several Virtual COM Port drivers to C:\Program Files (x86)\STMicroelectronics\Software\Virtual comport driver.
  3. Open the Virtual comport driver folder and run the driver installation file that corresponds to your Windows version:
    • Windows 10 or Windows 8.1 (64-bit) - Win8\ dpinst_amd64.exe
    • Windows 10 or Windows 8.1 (32-bit) - Win8\ dpinst_x86.exe
    • Windows 7 (64-bit) - Win7\ dpinst_amd64.exe
    • Windows 7 (32-bit) - Win7\ dpinst_x86.exe
TeraTerm

Download and install TeraTerm from the official website.


Install Mac OS Drivers

When using Mac OS, the following driver is required:

libusb

In order to install libusb, you must first install Xcode and Xcode Command Line Tools .

  1. Open the Terminal app.
  2. Run the following commands to install Homebrew and libusb:
    /usr/bin/ruby -e '$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)'
    brew install libusb

Arduino IDE Installation

In order to develop for the Wio LTE, you will need to install:

Install Arduino IDE

Download and install the latest version of Arduino IDE from the official site.

Download Arduino IDE

Install Wio LTE Board Definitions

  1. Run Arduino IDE.

    On Windows, you may receive a security alert when you run Arduino IDE for the first time. Ensure that you enable firewall exceptions for Arduino IDE for both private and public networks.

  2. From Arduino IDE, click File Preferences.
  3. Copy and paste the following URL to the Additional Boards Manager URLs field: https://raw.githubusercontent.com/Seeed-Studio/Seeed_Platform/master/package_seeeduino_boards_index.json 追加の様子
  4. Click OK.
  5. From Arduino IDE, click Tools Boards Boards Manager....
  6. Search for Seeed STM32F4 Boards (by Seeed Studio), and click Install.
  7. Click Close.

Install Wio LTE Libraries

  1. From Arduino IDE, click Sketch Include Library Manage Libraries....
  2. Search for Wio LTE for Arduino (by Seeed K.K.), and click Install.

Sample Programs

LED Test

Let's check that we can flash a simple program to the Wio LTE.

  1. Run Arduino IDE.
  2. From Arduino IDE, click File Examples Wio LTE for Arduino basic LedSetRGB.
  3. Connect your Wio LTE to your computer in normal mode.
  4. Click Tools Port:, then select the COM Port that corresponds to your Wio LTE.
  5. Switch your Wio LTE to DFU mode.
  6. Click Sketch Upload. This will compile the program and upload it to your Wio LTE, and may take a minute to complete.
  7. When the log window shows DFU end, the upload is complete. Switch your Wio LTE back to normal mode to run the sample LED program.

Send Data to Harvest

This basic Arduino sketch will get device uptime and send it to Harvest once every 60 seconds, allowing you to see graph data being generated in real time.

Before sending any data, make sure that your SIM card has been added to a group, and that Soracom Harvest has been enabled for that group.

  1. Run Arduino IDE.
  2. From Arduino IDE, click File Examples Wio LTE for Arduino soracom soracom-harvest**.
  3. Connect your Wio LTE to your computer, then switch it to DFU mode.
  4. Click Sketch Upload. This will compile the program and upload it to your Wio LTE, and may take a minute to complete.
  5. When the log window shows DFU end, the upload is complete. Switch your Wio LTE back to normal mode to run the sample LED program.
  6. Login to the User Console.
  7. From the list of subscribers, click the for your SIM card.
  8. Click the Actions menu, then select Harvest data.

This Arduino sketch will also output the device uptime and Harvest response to the serial monitor. To view, click Tools Serial Monitor.

On Windows, the default Arduino IDE Serial Monitor may display errors. Therefore, we recommend using TeraTerm to view the serial output.


Adding Sensors

You can easily add several kinds of sensors to your Wio LTE to capture other kinds of data. Be sure to check the Examples Wio LTE for Arduino grove menu for sample code for various sensors.

Certain sensors included with your Wio LTE kit require additional power to function. This power is provided by specific sensor ports on the Wio LTE. As each port on the Wio LTE differs, ensure that you use the correct port for each sensor. Incorrect usage may result in damage to the sensor or to the Wio LTE controller.


Additional Cellular Functionality

The Wio LTE can also send and receive data using other methods over its cellular connection, such as publishing and subscribing to MQTT topics, as well as sending and receiving SMS messages.

You can find additional code samples in the http, mqtt, and sms menus.