Takes data from a device connected to the serial port of a PC and sends it to Exosite.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE
README.md
options.cfg
pc_serial_gateway.py
serial_port_protocol.txt

README.md

======================================== About

pc_serial_gateway.py is a python script that collects data from devices connected to a serial port and publishes the data to Exosite via XMPP

License is BSD, Copyright 2011, Exosite LLC (see LICENSE file)

Built/tested with Python 2.6.5

======================================== Quick Start

(1) install python
http://www.python.org/download/
http://www.python.org/download/releases/2.6.5/
http://www.python.org/ftp/python/2.6.5/python-2.6.5.msi

(2) install xmpppy
http://xmpppy.sourceforge.net/
http://sourceforge.net/projects/xmpppy/
http://sourceforge.net/projects/xmpppy/files/xmpppy/0.4.0/xmpppy-0.4.0.win32.exe/download

If running Debian Linux (or Ubuntu), you can > apt-get install python-xmpp

(3) install dnspython
http://www.dnspython.org/

If running Debian Linux (or Ubuntu), you can > apt-get install python-dns
NOTE: this step is not always necessary, depends on xmpp server you use

(4) install serial
http://pyserial.sourceforge.net/
http://pypi.python.org/pypi/pyserial

If running Debian Linux (or Ubuntu), you can > apt-get install python-serial

(5) install exompp
https://github.com/exosite-labs/exompp-python

This is a client library that supports the Exosite XMPP API

(6) configure it
Open the file "options.cfg"
--) update the serial port # in options.cfg to point to the port you are using (use device manager in windows or a terminal program to list ports)
--) update the default credentials in options.cfg to use your xmpp login

(7) test it out
get python script "pc_serial_gateway.py"
--) attach a compatible device to a/the serial port
--) run the script (> python pc_serial_gateway.py)
--) verify the app connects to both the device and Exosite (no errors should be generated)
--) log into portals.exosite.com and verify the data source is created and that data was generated

(8) tweak it
--) play around, use it, extend it!

======================================== Release History


2011-09-15

--) updated for synapse nodes cik vs. device name support v.2011-07-24
--) updated support to pyexompp v.0.2


2011-06-08

--) removed xmpp code to use pyexompp


2011-01-07

--) initial release