SparkFun Edge Hookup Guide a learn.sparkfun.com tutorial
Available online at: http://sfe.io/t878
Introduction
With the SparkFun Edge Development Board and the SparkFun Edge 2 Development Board, edge computing is here! You've probably heard of this latest entry to the long lineage of tech buzzwords like "IoT,""LoRa," and "cloud" before it, but what is the edge and why does it matter? The cloud is impressively powerful but all-the-time connections require power and connectivity that may not be available. Edge computing handles discrete tasks such as determining if someone said 'start washer' and responding accordingly. The audio analysis is done at the "edge" rather than on the web. This dramatically reduces costs and complexity while limiting potential data privacy leaks.
So now that you've embarked upon the journey to the Edge, let's take a moment to get off on the right foot. In this hookup guide we will get familiar with the hardware available and how to connect to your computer, then we'll point you in the right direction to begin writing awesome applications using machine learning!
Required Materials
To follow along with this tutorial, you will need the following materials. You may not need everything though depending on what you have. Add it to your cart, read through the guide, and adjust the cart as necessary.
Suggested Reading
If you aren’t familiar with the following concepts, we recommend checking out these tutorials before continuing.
Serial Terminal Basics
Using SparkFun Edge Board with Ambiq Apollo3 SDK
Suggested Viewing
Hardware Overview
Microcontroller
Both the Edge and the Edge 2 use the Apollo3 Blue - the cutting-edge of high efficiency microcontrollers. This small BGA package packs quite a punch! While the Edge Development Board uses the microcontroller on it's own, the Edge 2 wraps the Apollo3 in the multi-functional, FCC certified Artemis Module.
- 32-bit ARM Cortex-M4F processor with Direct Memory Access
- 48MHz CPU clock, 96MHz with TurboSPOT™
- Extremely low-power usage: 6uA/MHz
- 1MB Flash
- 384KB SRAM
- Dedicated Bluetooth processor with BLE 5
 |  |
| 15170 - Edge Board | 15420 - Edge 2 Board |
Sensors
Such a formidable microcontroller would be wasted without a suite of cool sensors to use with it - that's why we've included two microphones, a 3-axis accelerometer, and a camera connector.
Microphones
Both the Edge and the Edge 2 have two onboard microphones. The original Edge board contains Micro Electro-Mechanical microphones that are hooked up to an operational amplifier with 75x gain to make the best use of the Apollo3's built-in 14-bit analog to digital converter. The Edge 2 uses the newer MEMS digital PDM microphones, which simplifies component count and marginally reduces current consumption.
On both boards, the Apollo3 microcontroller can use Direct Memory Access to take audio recordings without using processor cycles - that means you can process audio while you record the next sample!
 |  |
| 15170 - Edge Board | 15420 - Edge 2 Board |
Accelerometer
Dynamic interaction with the Edge is included right out of the gate with the onboard ST Microelectronics LIS2DH12 3-axis accelerometer. The accelerometer is on its very own dedicated I2C bus so there's no need to worry about address conflicts.
 |  |
| 15170 - Edge Board | 15420 - Edge 2 Board |
Camera Connector
At the top of the board we've included a camera connector. We've included this for use in ongoing development - preliminary stages are looking good and we hope to have this fully functional in very short order.
 |  |
| 15170 - Edge Board | 15420 - Edge 2 Board |
Connections
If you need anything else to complete your application there are plenty of ways to connect to the Edge board. Among these are the FTDI UART header, a Qwiic connector, a built-in Bluetooth radio, four GPIO pins, four LEDs, and last (but not least) a CR2032 coin cell holder.
Serial UART Connection
You'll use this connector to program the Edge board, but after that you can also use it to talk to other systems that use a UART interface such as GPS or Serial LCD.
 |  |
| 15170 - Edge Board | 15420 - Edge 2 Board |
Qwiic Connector
The Apollo3 can have up to 6 independent I2C ports. We've taken advantage of that fact by exposing a fresh I2C port through a Qwiic connector, allowing you to add a chain of I2C sensors without soldering.
 |  |
| 15170 - Edge Board | 15420 - Edge 2 Board |
Bluetooth Radio
The Apollo3 comes with hardware support for a Bluetooth Low-Energy (BLE) radio. The Edge board pairs that up with a surface mount antenna, while the Edge 2's Artemis module has a built-in BLE antenna. The BLE controller and host can be configured to support up to eight simultaneous connections -- security and extended packet length are also supported.
 |  |
| 15170 - Edge Board | 15420 - Edge 2 Board |
Inputs/Outputs
If all that wasn't enough there were still more pins available on the Apollo3, so we broke them out to four LEDs and four GPIO connections along the bottom edge. These are good for addition additional simple input or output capabilities to a project.
 |  |
| 15170 - Edge Board | 15420 - Edge 2 Board |
CR2032 Coin Cell Holder
To demonstrate just how efficient this microcontroller is we included a coin cell battery holder on the bottom. That means that once your application is all ready you can take it to school on a key-chain and show it off to your best friend!
 |  |
| 15170 - Edge Board | 15420 - Edge 2 Board |
JTAG Connector
For anyone who wants the utmost performance out of the Edge board during the development process you can use the JTAG MIPI 10 standard 1.27mm pitch 2x5 connector to hook up your debugger/programmer.
 |  |
| 15170 - Edge Board | 15420 - Edge 2 Board |
Board Dimensions
SparkFun Edge Development Board
SparkFun Edge 2 Development Board
Hardware Hookup
It's very easy to get started using the Edge board - all you need to do is provide power! Right off the bat you can try out the AI voice recognition by seeing the yellow LED light up for 'Yes' and the red LED light up for 'No.'
Power + Programming
To power the board either place a charged CR2031 3V battery into the coin cell holder or plug in your USB-serial converter.
If you want to upload new code or see what the Edge board has to say to you then you'll need to be able to read the UART pins which are broken out just above the coin cell holder. The pinout is compatible with SparkFun serial breakouts like the Serial Basic Breakout or the new Serial Basic Breakout with USB C. The ability to toggle the DTR line from USB is required for bootloading.
With your chosen method of connection at hand begin making the connections with care. If you have USB-serial bridge with the compatible pinout (order DTR, RXI, TXO, VCC, CTS, GND from the perspective of the bridge) you can simply make sure that the GRN and BLK labels match up between the bridge and the Edge board. If you are using some other way to view/send UART data then make sure to connect the TX of the bridge to the RX of the Edge and vice-versa. Also make sure to connect GND (closest to the BLK label on the Edge) and DTR (closest to the GRN label) pins. From the bridge's perspective RXI is next to DTR and TXO is next to RXI.
Extensions
With the Edge boards you can add additional I2C sensors with the Qwiic connector and have access to four GPIO pins.
Connecting Qwiic sensors is as simple as chaining them together with Qwiic Cables and then linking that chain to the Edge board. Note, if you have many sensors (5 or more is a good rule of thumb) then you'll need to disconnect the I2C pullup resistors from a few of the boards.
The four available GPIO pins are pads 1, 3, 36, and 38 of the Apollo3. In addition to GPIO functionality some have additional special functions:
| Apollo3 Pad | Special Functions |
|---|---|
| 1 | UART0 TX |
| 3 | ADC Trigger1 |
| 36 | ADC Trigger1, UART1 RX, UART1 CTS, UART0 CTS, PDM Microphone DATA, 32 kHz Clock Output |
| 38 | ADC Trigger3, UART0 CTS, UART1 RX |
Software Setup
The Edge board takes advantage of the cutting-edge Apollo3 Blue microcontroller from Ambiq for incredibly high efficiency which allows AI applications to run on a coin cell power source. The cost of using the latest and greatest technology is that there is no Arduino support for the chip. In order to start developing your own applications you'll need to follow along with our extensive Ambiq Apollo3 Software Development Kit Setup Guide.
Using SparkFun Edge Board with Ambiq Apollo3 SDK
March 28, 2019
SDK Examples
Once your SDK is set up you should be able to compile and upload the examples. Here's a short description of each one. For more details make sure to follow along with the SDK setup guide.
- example1_edge_test demonstrates the hardware on the board including:
- UART printing for info/debugging
- ADC operation to sample from a microphone
- I2C operation to control the accelerometer
- GPIO functions
- example2_dual_mic_dma shows how to use DMA to capture 16 kHz audio recordings from both microphones without blocking the processor. This is the basis of how audio is provided to the TensorFlow Lite demo.
- tensorflow_demo uses a pre-trained model to identify "yes" and "no" and blink a corresponding LED on the board. Using GPIO you could easily expand this example to control a device.
- SparkFun_Edge_Project_Template is an easy-to-use bare-bones makefile project that you can copy to any directory that you like. With only a little configuration you'll be writing your very own application!
Troubleshooting
If your product is not working as you expected or you need technical assistance or information, head on over to the SparkFun Technical Assistance page for some initial troubleshooting.
If you don't find what you need there, the SparkFun Forums are a great place to find and ask for help. If this is your first visit, you'll need to create a Forum Account to search product forums and post questions.
SparkFun Edge Board Forum
Resources and Going Further
Now that you are familiar with the hardware and setup, you should be able to start integrating the Edge Board into your projects. If you want more information on the Ambiq Apollo3 or the SparkFun Edge Board, check out some of the links below:
SparkFun Edge:
SparkFun Edge 2:
Working with the Apollo 3:
- Ambiq Apollo3 Datasheet
- SDK Setup Guide
- Machine Learning on a Microcontroller with SparkFun Edge
- Using TensorFlow on Microcontrollers
- TensorFlow Lite
Need some inspiration for your next project? Check out some of these IoT tutorials!
Raspberry Pi Twitter Monitor
SparkFun Blocks for Intel® Edison - I2C Breakout Block
Internet of Things Experiment Guide
Photon Weather Shield Hookup Guide V11
Or check out this blog post for ideas.
learn.sparkfun.com | CC BY-SA 3.0 | SparkFun Electronics | Niwot, Colorado