Skip to end of metadata
Go to start of metadata


This page will show you step-by-step how to interface a Synapse Wireless Snap RF Engine to the BeagleBone Black. This example uses the EK2100 Starter Kit from Synapse Wireless. From the kit, an SN132 SNAPstick (lower left photo), is connected to the BeagleBone's USB Port. In this scenario we will press a button on the SN171 (lower right photo), also from the kit, wirelessly prompting a python script on the BeagleBone to send an email notifying "something has happened". My goal when starting this project was to have multiple sensor nodes throughout a business or home communicating with a low power web enabled device.

Hardware Requirements

BeagleBone Black at Digi-Key
BeagleBone Green at Digi-Key

Development Kit:
EK2100-220 Starter Kit at Digi-Key
EK5100-220 Starter Kit at Digi-Key
EK2500 Starter Kit at Digi-Key

Or a combination of these:
SN132 SNAPstick at Digi-Key
SN171 ProtoBoard at Digi-Key
SNAP Transceivers at Digi-Key

Software Requirements


  • BeagleBone Black running Debian or Ubuntu
  • Portal IDE
    • For this purpose, it's only used to program the transceivers.
    • Choose the version for your operating system on this page: https://forums.synapse-wireless.com/showthread.php?t=5400
    • You will need to do a basic registration and be logged in to view that page.
    • Use the windows version if you can.
  • SNAP Connect
    • 3.1.0-python2.7
    • This is the main software that will run on the BeagleBone Black.
    • It is written in Python and made specifically for ARM devices to interact with SNAP networks.
    • Will acquire and install in later steps.

Install Portal on Windows Machine

  1. Login here and download Portal-setup-2.4.36.exe (this is the version for my Windows 7 machine).
  2. Follow guided installation.

Install script on nodes

  1. Download node_smtp.py
    1. Move or save this file in the following directory on your machine:
    2. C:\Users\YourName\Documents\Portal\snappyImages (exact location may vary).
  2. Connect SNAPstick to an available USB port on your machine.
  3. Connect the ProtoBoard to a power source.
  4. Open Portal.
  5. Click "Connect" when prompted (mine says "USB0" for the Port).
  6. Update Firmware if needed Portal: Reference Manual Page 46
  7. In the "Node Views" window, click on "Stick" under "Device Type" (Figure 1).
  8. In the "Node Info" window, click on the "Upload SNAPpy Image (Figure 2).
  9. Select the node_smtp we saved earlier and click OK.
  10. The SNAPstick is now programmed.
  11. Now click on the "Device Type" labeled "Buzz" and repeat.
  12. You just programmed the ProtoBoard "over the air".



SSH Into BeagleBone

Login as root.



Install SNAP Connect

The following steps are done on the Beaglebone Black.

Acquire SNAP Connect software. 


Get email Scripts

  1. Edit the "to",gmail_user and gmail_pwd to your credentials.
  2. Save and exit.

Run Script

  1. Connect the SNAPstick to the USB port of the BeagleBone and reboot.
  2. Power the ProtoBoard.
  3. SSH back into the BeagleBone as root.



What you should see:


Now when you press the button on the ProtoBoard an email will be sent.

Email Multiple Recipients

This is an alternative script that allows you to send to multiple recipients. In this example, I chose one of my recipients to be MyNumber@vtext.com, allowing me to receive an email and text message.


Edit the file with your information and run the script just like before.