Table of Contents
Advertisement
USER GUIDE
SNAPconnect E12
SNAP Enabled Gateway
©2008-2017 Synapse Wireless, All Rights Reserved. All Synapse products are
patent pending. Synapse , the Synapse logo, SNAP, and Portal are all registered trademarks
of Synapse Wireless, Inc.
Doc# 116-081614-030-B001
6723 Odyssey Drive
//
Huntsville, AL 35806
//
(877) 982-7888
//
Synapse-Wireless.com
Advertisement
Table of Contents
Related Manuals for Synapse SNAPconnect E12
Summary of Contents for Synapse SNAPconnect E12
-
Page 1: User Guide
USER GUIDE SNAPconnect E12 SNAP Enabled Gateway ©2008-2017 Synapse Wireless, All Rights Reserved. All Synapse products are patent pending. Synapse , the Synapse logo, SNAP, and Portal are all registered trademarks of Synapse Wireless, Inc. Doc# 116-081614-030-B001 6723 Odyssey Drive... - Page 2 Information contained in this manual is provided in connection with Synapse Wireless products and services and is intended solely to assist its customers. Synapse reserves the right to make changes at any time and without notice. Synapse assumes no liability whatsoever for the contents of this manual or the redistribution as permitted by the foregoing limited license.
-
Page 3: Table Of Contents
Table of Contents Overview The Device Getting Started Powering the E12 Establishing a Serial Connection Mounting the E12 E12 Software Specifics Passwords and root Access E12-Specific Software Packages E12 Physical Interfaces E12 LEDs The SNAP Module-Controlled LED The E12 Button Working With the Gateway's SNAP Module Waking the SNAP Module Resetting the SNAP Module Restoring Functionality to an Unresponsive SNAP Module... - Page 4 Troubleshooting Common Problems The Ethernet port does not work or eth0 does not appear in ifconfig SNAPconnect is not working I cannot SSH into my E12 Regulatory Information and Certifications...
-
Page 5: Overview
Powered by Ubuntu - Easy to Customize The SNAPconnect E12 Gateway is an embedded Ubuntu Linux computer with the flexibility to add custom or 3rd party software as needed for local databases, IoT platform clients, or other elements. It bridges SNAP edge networks over Ethernet or optional USB connectivity devices such as cell modems, Bluetooth, or Wi-Fi adapters. -
Page 6: The Device
The images below show an E12 gateway with all features marked: All E12s include a SNAP-powered module, and will come with an antenna for the module's connection labeled with the Synapse S on the E12's case. SNAPconnect E12 User Guide — 116-081614-030-B001... -
Page 7: Getting Started
Getting Started Adding an E12 gateway to your SNAP network is easy, but as with adding any computer to any network, if you don’t follow the right steps, you’ll end up in the wrong place. These directions provide the steps for connecting to your E12 from either a Windows PC or a Linux PC, which we will refer to as your host PC. - Page 8 NOTE: During the upcoming step 4, if you find that your host PC cannot connect to the E12 over the USB connection, you may need to install the FTDI USB to UART VCP drivers, available from http://www.ftdichip.com SNAPconnect E12 User Guide — 116-081614-030-B001...
- Page 9 4. Find the serial port that your host PC has assigned to the E12 (over that USB connection) To find the serial port on a Windows PC: a. Check under “Ports” in the Device Manager. b. Look for USB Serial Port (COMxx) where the xx will indicate the serial port assigned (e.g., COM3, or COM88).
- Page 10 Before starting work with the E12, you'll want to make sure you have the latest versions of the software installed on the unit. The E12 makes use of Python Development Libraries that are sometimes updated to add SNAPconnect E12 User Guide — 116-081614-030-B001...
- Page 11 You can also have full internet access via the wired Ethernet connection. Now it’s up to you to do awesome things with your SNAP-powered network. You can find examples of other people’s efforts on the Synapse Wireless repository at GitHub: https://github.com/synapse-wireless.
-
Page 12: Mounting The E12
Mounting the E12 The E12 has mounting holes on the outside flanges of the unit, any of which can be used for mounting the E12 to a solid surface. SNAPconnect E12 User Guide — 116-081614-030-B001... -
Page 13: E12 Software Specifics
E12 Software Specifics The E12 uses Canonical’s Ubuntu 14.04, running a custom Linux kernel based on the Beaglebone Black kernal. There are many resources out there for learning about Ubuntu online, and the topic possibilities far exceed the scope of this manual. However there are a few details that warrant discussion. Passwords and root Access The default configuration for Ubuntu Linux is to have the root user disabled. - Page 14 First, you can upgrade SNAPconnect and the encryption libraries necessary for AES128 communications using these commands: sudo –H pip install snapconnect –i https://update.synapse- wireless.com/pypi/ sudo -H pip install --extra-index-url https://update.synapse- wireless.com/pypi snaptoolbelt...
-
Page 15: E12 Physical Interfaces
E12’s AM335x processor, except through calls to the SNAP module. These two IO lines from the SNAP module will light their respective colors when written high. This sample code demonstrates its use: from synapse.platforms import * GREEN=GPIO_1 RED=GPIO_0 @setHook(HOOK_STARTUP) -
Page 16: The E12 Button
You can monitor the AM335x processor GPIO directly rather than using the Bash script if you find that to be easier. Unlike the Bash script that set states on the E12, this script does not require sudo access to run. SNAPconnect E12 User Guide — 116-081614-030-B001... -
Page 17: Working With The Gateway's Snap Module
At times it may be helpful to have the SNAP module in your E12 sleep, and then be woken by the E12’s processor. If you have installed the recommended E12-snap-utils package, you can easily do this by defining GPIO_F1 on the SNAP module as a wake pin, like this: from synapse.pinWakeup import * from synapse.platforms import * @setHook(HOOK_STARTUP) -
Page 18: Resetting The Snap Module
The Synapse Wireless Portal software provides mechanisms for node recovery, but since you cannot make a serial connection from the SNAP module in your E12 to Portal, that functionality needs to exist on the E12 as well. -
Page 19: Upgrading The Snap Module Firmware
–i <imageName> -p RF220 (for 2.4GHz gateways) sudo flash-bridge –i <imageName> -p RF320 (for 915MHz gateways) For this command, <imageName> refers to an absolute or relative path to a Synapse firmware image file, which will have the extension .sfi. - Page 20 For example: First, download SNAP firmware version 2.8.1 by typing: sudo -H pip install snap_firmware_2.8.1 -i https://update.synapse- wireless.com/pypi/ This will download the firmware images and put them in the folder: /usr/local/lib/python2.7/dist-packages/snap_firmware_2_8_1/ Then you can update the E12 by typing: For 2.4GHz Gateways: sudo flash-bridge -i /usr/local/lib/python2.7/dist-packages/snap_firmware_...
-
Page 21: Accessing The Microsd Slot
Accessing the MicroSD Slot The E12 includes an on the board microSD slot for reflashing your device to its factory state. You can also use a card in this slot as additional flash storage on your gateway if you need it. The following instructions will work for ext4-, FAT32-, or exFAT-formatted cards. -
Page 22: Common Linux Operations
2, which allows for multiuser connectivity (per the standards) and networking (which the standards Emacs is not included in the base Linux distribution on the E12. You can get it using sudo apt-get install emacs SNAPconnect E12 User Guide — 116-081614-030-B001... -
Page 23: Starting A Service
provide at runlevel 3). This is important because it affects where you should add your run-once scripts to have them execute. There is a Bash script located at /etc/rc.local that executes every time the runlevel changes to a new multiuser level. In normal operation, the E12 boots to runlevel 2 and stays there. If you are not actively initializing a new runlevel, this script will only run on boot. -
Page 24: Setting Your E12'S Clock
To make a recovery flash drive, first ensure you have the newest version of the utility: sudo apt-get install 50-password-reset Then, insert the flash drive you wish to store your recovery key, and run: sudo generate-usb-password-reset USERNAME SNAPconnect E12 User Guide — 116-081614-030-B001... -
Page 25: Mounting An External Drive
Where username is the account you wish to be unlocked if this flash drive is present on boot. The key will then be written to the flash drive and stored locally on your gateway. On subsequent boots, if the flash drive containing the key is present, the account specified will have it's password deleted, and you will have to supply a new password upon logging in. -
Page 26: Extending The E12 With Usb Accessories
SN220, you need to modify it to operate as a serial device rather than a USB device. For instructions on doing this, refer to the Synapse Wireless technical brief “Configuring an SN220 SNAPstick as a COM Port,” available on the Synapse developer microsite at http://developer.synapsewireless.com/. -
Page 27: Using Usb_Modeswitch
Using usb_modeswitch Many USB Wi-Fi and cell modems now come with a small amount of onboard storage, typically used to automatically install drivers when connected to a Windows host. When the device first connects, it appears as a small flash drive or virtual CD-ROM. -
Page 28: Factory Restore / Re-Flashing Your E12
4 - 5 minute delay before the board begins programming. You can identify affected boards by a black Synapse logo next to the programming button. A few moments after programming begins, LEDs 1, 2, 3 and 4 will begin cycling to indicate the E12 is being programmed. -
Page 29: Specifications And Installation
The Synapse Wireless E12 gateway is a free-standing ARM Cortex-A8 based Linux computer running Ubuntu 14.04, and incorporating a 915MHz or 2.4 GHz Synapse RF module that connects the device to SNAP-powered mesh networks. The gateway is available with serial connectivity through a microUSB connection, and Ethernet connectivity through the RJ-45 connector. -
Page 30: E12 Dimensions
E12 Dimensions SNAPconnect E12 User Guide — 116-081614-030-B001... -
Page 31: Troubleshooting Common Problems
Troubleshooting Common Problems The Ethernet port does not work or eth0 does not appear in ifconfig Most likely, your MAC address has not been set. If you run ifconfig -a and see output similar to: eth_badmac Link encap:Ethernet HWaddr 00:1c:2c:ff:ff:ff Your MAC address has reverted to the default and needs to be set. ... -
Page 32: Regulatory Information And Certifications
This device complies with Part 15 of FCC rules. Operation is subject to the following two conditions: (1) this device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation. SNAPconnect E12 User Guide — 116-081614-030-B001... -
Page 33: Declaration Of Conformity
The products listed above have been tested at an External Test Laboratory certified per FCC rules and has been found to meet the FCC, Part 15, Emission Limits. Documentation is on file and available from Synapse Wireless, Inc. Industry Canada (IC) Statement This Class B digital apparatus complies with Canadian ICES-003.
Need help?
Do you have a question about the SNAPconnect E12 and is the answer not in the manual?
Questions and answers