This page documents how to get started using the Breakout SDK and what it provides. Today, the Breakout SDK is built for the STM32F405RG MCU and U-Blox Sara-N410 cellular module in mind. This specific Developer Board was provided in Twilio's Alfa Developer Kit and distributed to SIGNAL 2018 attendees, and it came with Grove sensors – humidity, light, and ultrasonic.
- Programmable Wireless Narrowband SIM
- Alfa Developer Board
- LTE antenna
- GPS antenna
- 3 Grove sensors:
- Button
- Ultrasonic
- Temperature/Humidity
- Lithium battery
- Micro-USB cable
The following items are required to use Breakout SDK:
- Alfa Development Kit
- Arduino IDE 1.8.7+
- dfu-util
- Register the Narrowband SIM in the Programmable Wireless Console
- Insert the smallest form factor of the Narrowband SIM in the bottom of the two slots available on the Developer Board
The smallest form factor of a SIM is the Nano (4FF) SIM size. The top slot is a Micro-SD card slot. If you insert the Narrowband SIM in the top slow, gently pry it out with needle-nose pliers.
- Connect the LTE Antenna to the LTE pin located on the bottom of the board.
The following steps will guide you from downloading the Arduino IDE to installing sample applications on your Developer board.
- Download Arduino IDE 1.8.7+
The following step is required for OSX:
- Install Homebrew by typing the following in a Terminal:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
- Install dfu-util using Homebrew by typing the following in a Terminal:
brew install dfu-util libusb
Note: Use dfu-util 0.9 or greater if available. Check dfu-util version with
brew info dfu-util
The follow steps are required for Windows:
- Insert the Micro-USB cable into the Developer Board
- Insert the other end of the USB cable in your computer
- Open Arduino IDE
- Click Arduino > Preferences
- Copy the following URL into the Additional Boards Manager URLs field:
https://raw.githubusercontent.com/Seeed-Studio/Seeed_Platform/master/package_seeeduino_boards_index.json
- Click OK
- Click Tools > Boards > Boards Manager
- Type "Seeed" into the search field
- Select the Seeed STM32F4 Boards version 1.2.3+
See #2 in known limitations and workaround if you are not using version 1.2.3 or greater.
- Click Install
- Close the Boards Manager window
- Click Tools > Boards > Wio Tracker LTE
- Click Tools > Port > {Your Modem Port Here}
- OSX: /dev/{cu|tty}.usbmodem{XXXX}
- Linux: /dev/ttyACM{X}
- Windows: COM{X}
- Click the green "Clone or download" button at the top right handside of this repository
- Click the Download as ZIP file button
- Make note of the download location
- Open Arduino IDE
- Select Sketch > Include Library > Add .ZIP Library and select the .zip file downloaded
- Restart Arduino IDE
The library will now be present for Arduino IDE to use. To update the library:
- Delete the library from your Arduino directory
- You can find the library to delete in your
Arduino/libraries
directory - OSX: in ~/Documents/Arduino/libraries
- You can find the library to delete in your
- Follow the steps in the Breakout SDK Installation section above
Tip: An alternative to downloading the library as a ZIP is to check the library out using
git
in the Arduino/libraries directory, or symlink the locally-checked out copy there.
- Open Arduino IDE
- Click File > examples and navigate to the Breakout library examples
- Select an example from File > Examples > Breakout SDK > Sensors
- Search for
psk_key
- Insert your PSK in place of
00112233445566778899aabbccddeeff
- You can find your PSK in the under your Narrowband SIM Resource
Note: The example ino files are readonly. Save your changes to a new location.
- Enable Bootloader mode on the Developer Board:
- Press and hold the BOOT0 button underneath the Developer Board
- Press and hold the RST on the top of the Developer Board
- Release the RST on the top of the Developer Board
- Release the BOOT0 button to enable Bootloader mode
- Click Sketch > Upload to upload the example to the Developer Board
- Do not click
Upload Using Programmer
- Click the RST button when the sketch has finished uploading
- Click Tools > Port > {Your Modem Port Here}
- OSX: /dev/{cu|tty}.usbmodem{XXXX}
- Linux: /dev/ttyACM{X}
- Windows: COM{X}
- Click Tools > Serial Monitor
- Monitor the output of the board in the Serial Monitor window
When the board is in Bootloader mode the serial port won't be initialized and not available to monitor.
Receiving the output WARNING: Category 'Device' in library Wio LTE Arduino Library is not valid. Setting to 'Uncategorized'
See known #4 under Limitations and Workarounds below.
Note Connecting to the network for the first time can take a minute or two. If the light doesn't go blue, try another location. You may not have cell coverage in your current location.
The LEDs on the Developer Board are set to function as the following:
- Red CHG LED - Lights up based on the battery charging level.
- Yellow Status LED - lights up when the modem module is power on.
- Blue Network LED - lights up when the modem module is successfully registered to the mobile NB-IoT network.
- Red RST LED - lights up during the reset procedure. To place the module in firmware flashing mode, press the BOOT0 switch on the board when this LED lights up.
- WS2812 RGB LED - available for your application and is used in the briefly in the examples to indicate the status of the Breakout SDK.
Note that the lithium battery is recommended to be plugged in at all times, especially if your USB power source does not provide sufficient power for the board at peak levels.
- Receiving the output
WARNING: Category 'Device' in library Wio LTE Arduino Library is not valid. Setting to 'Uncategorized'
in Arduino IDE.- Problem: Incorrect version of dfu-util. Using 0.8 or lower.
- Solution: Update dfu-util to 0.9+
- OSX: Type the following in a Terminal:
brew install dfu-util
- OSX: Type the following in a Terminal:
- Unable to remove lithium battery from Developer Board.
- Problem: JST pings lock lithium battery into place.
- Solution: If the battery is pushed in a touch too far, it locks. Lift the pins from the JST connector and pull on the lithium battery cable. The JST connector has tabs that dig in and are not meant to be disconnected again.
No DFU capable USB device available
- Problem: Unable to upload firmware. Device is not in DFU mode.
DFU begin dfu-util 0.8 Copyright 2005-2009 Weston Schmidt, Harald Welte and OpenMoko Inc. Copyright 2010-2014 Tormod Volden and Stefan Schmidt This program is Free Software and has ABSOLUTELY NO WARRANTY Please report bugs to http://sourceforge.net/p/dfu-util/tickets/ dfu-util: Invalid DFU suffix signature dfu-util: A valid DFU suffix will be required in a future dfu-util release!!! dfu-util: No DFU capable USB device available DFU end
- Solution: Put Developer Board in DFU mode.