Skip to main content

Interface to Thingy:52

Project description

=========
Thingy:52
=========


.. image:: https://img.shields.io/pypi/v/thingy52.svg
:target: https://pypi.python.org/pypi/thingy52

.. image:: https://img.shields.io/travis/SebastianRoll/thingy52.svg
:target: https://travis-ci.org/SebastianRoll/thingy52

.. image:: https://readthedocs.org/projects/thingy52/badge/?version=latest
:target: https://thingy52.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status

.. image:: https://pyup.io/repos/github/SebastianRoll/thingy52/shield.svg
:target: https://pyup.io/repos/github/SebastianRoll/thingy52/
:alt: Updates


Python interface to Thingy:52

.. image:: demos/demo_camera_udp.gif

* Free software: MIT license
* Documentation: https://thingy52.readthedocs.io. <- coming soon

This package is an implementation of a Python interface for the Thingy:52 ble IoT Sensor Kit.

More information about Thingy:52 is found here: https://www.nordicsemi.com/eng/Products/Nordic-Thingy-52

Full disclosure: A reference implementation for thingy:52 already exists in the popular bluepy package:

https://github.com/IanHarvey/bluepy

Install
-------

Python 2 support <- coming soon.

Python 3:

.. highlight:: bash

$ sudo apt-get install libglib2.0-dev
$ pip3 install thingy52

If you find bluepy-helper isn't being built, please try:

.. highlight:: bash

$ pip install --no-binary :all: thingy52

To use the recording demo (/demo/record.py) you will need the PyAudio package (https://people.csail.mit.edu/hubert/pyaudio/).

Features
--------

* CLI interface using Click

* Data conversion functions for all sensors (not yet fully complete)

* Some fun demos to get you started


BUGS
----

The first connection attempt after turning on the thingy:52 usually fails, but it works after that.


TODO
----

- [ ] Python 2.X

- [X] Python 3.X

- [ ] Implementation

- [X] Toggle notify

- [ ] Notification frequency

- [X] Read/Write

- [X] Services

- [X] Environment

- [X] Motion

- [X] User Interface

- [ ] Audio

- [ ] Documentation

- [ ] Installation

- [ ] Usage

- [ ] Convert docs to markdown

- [ ] Badges (CI, Readthedocs)

- [ ] Photo of thingy:52

- [ ] Gif of demo (controlling Picam)

- [ ] Distribution

- [ ] Conda package (conda-forge)

- [X] Pypi package

More information
----------------

* https://nordicsemiconductor.github.io/Nordic-Thingy52-FW/documentation/firmware_architecture.html
* https://infocenter.nordicsemi.com/index.jsp?topic=%2Fcom.nordic.infocenter.rds%2Fdita%2Frds%2Fdesigns%2Fthingy%2Fhw_description%2Fhw_descr.html&cp=9_0_6

Credits
---------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage



=======
History
=======

0.1.0 (2017-08-26)
------------------

* First release on PyPI.

Project details


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
thingy52-0.1.5-py2.py3-none-any.whl (12.5 kB) Copy SHA256 hash SHA256 Wheel 3.6
thingy52-0.1.5.tar.gz (98.7 kB) Copy SHA256 hash SHA256 Source None

Supported by

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