Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Data collection web application for microcontrollers

Project description

####2014 Visgence Inc.
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <>

#Design Goals

#Getting Started (Ubuntu and Raspberry Pi)
cherrypy (pip install --no-use-wheel cherrypy on windows)
##Setting Up Teleceptor
1. Pull the latest version of Teleceptor from GitHub.
2. To insatll a local config customizable first run ```./teleceptor copyconfig``` app will print path
3. In teleceptor folder, run command ```./teleceptorcmd setup``` and wait until _Done!_ is printed.
* **Note:** All commands should be run in the teleceptor folder unless installed with pip or setuptools
4. Run command ```./teleceptorcmd runserver```. You will now be running teleceptor as a local host.
5. Open up either a Chrome or Mozilla Firefox browser and go to page [] (
* If you do not have any sensors connected, you should see two default sensors producing a graph per tab with random data.
6. Set up desired sensors and start collecting data.(_See below for setting up sensors_)

##Setting Up Sensors
1. Run command ```./teleceptorcmd poller```. This will begin to look for sensors via USB ports.
2. Plug in your sensor through a USB port.
* Make sure you have the most current firmware for your sensor. (_See **Sensor Firmware**._)

#Sensor Firmware
Sensor firmware can be found in the [firmware]( folder. Download the appropriate firmware for your type of sensor, and then upload it to your sensor.

* You will need to download aJSON and add it to your adruino IDE.
* In the .ino file that you download for your firmware, change the uuid found in _static const char jsonData[ ]_ to be a unique name of your choosing.

#Teleceptor Front-End Usage
* To view sensor data that has been collected, click on a sensor under the _Sensors_ tab.
* To look at a certain time period of data, select a range under the _Time Controls_ tab.
* :star: Specifc data can also be viewed by passing the mouse on the graph to observe data points and the time it was collected.
* :star2: By clicking and dragging on a certain part of _either_ graph, you can zoom-in on points.
* Some information about the sensor is editable and will change the graph accordingly such as _Units_ or _Calibration_.
* Be sure to save after editing for the configuration information to be available later.
* _Metadata_ cannot be changed. However, you can change it in the firmware and then re-upload the firmware to the sensor.
* If you download updates from teleceptor but and are not sure if the webpage is up-to-date as well, clear your web browser's cache:
* **Chrome:** Right-click in a blank spot on the page -> Inspect element -> Settings (gear symbol) -> Disable cache (while DevTools is open) -> Refresh the page
* **Mozilla Firefox**: _ctrl+Shift+R_ will reload the page without cache and/or _ctrl+Shift+Delete_ -> Details -> Cache checkbox -> Clear Now

Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
teleceptor-0.7.7.tar.gz (1.8 MB) Copy SHA256 hash SHA256 Source None Sep 13, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page