Skip to content

Commit

Permalink
Merge pull request #26 from cuplsensor/master
Browse files Browse the repository at this point in the history
Updating from master.
  • Loading branch information
malcolmmackay committed Feb 6, 2021
2 parents 0b99c17 + 836185d commit cb4a7c4
Showing 1 changed file with 30 additions and 5 deletions.
35 changes: 30 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,33 @@
# wscodec
Websensor Encoder and Decoder -- in development, not recommended for production use yet.
# cuplcodec
[cuplcodec](https://cupl.co.uk/index.php/software/cuplcodec/) encodes environmental sensor data into a URL. Each sample includes two 12-bit readings (temperature and humidity). These are converted to base64 and written into a circular buffer. A HMAC is written after the most recent sample in the buffer. The URL can be rendered as a QR code or stored on an NFC tag. If a tag with a URL is tapped
by a mobile phone, it opens automatically in a web browser. This allows the user to view sensor data **without installing an app on their phones**. A web application comprising [cuplfrontend](https://github.com/cuplsensor/cuplfrontend) and [cuplbackend](https://github.com/cuplsensor/cuplbackend) runs the decoder in cuplcodec, unwraps the circular buffer and displays a list of samples in the browser.

## Tests

`pip install wscodec`
![GitHub Workflow Status](https://github.com/cuplsensor/cuplcodec/workflows/Python%20package/badge.svg)

Find documentation at https://wscodec.readthedocs.io/. This is very much a work in progress.
A lot of it was written a while ago and is now out of date.
The codec is tested with [pytest](https://docs.pytest.org/en/stable/). The encoder written in C can be tested with the decoder written in Python using [CFFI](https://cffi.readthedocs.io/en/latest/).

## Documentation

[![Documentation Status](https://readthedocs.org/projects/wscodec/badge/?version=latest)](https://readthedocs.org/projects/wscodec/badge/?version=latest)

Hosted on [ReadTheDocs](https://readthedocs.org/projects/wscodec/badge/?version=latest). This includes information on how to run the encoder on an MSP430.

## PyPI Package

[![PyPI pyversions](https://img.shields.io/pypi/pyversions/ansicolortags.svg)](https://pypi.python.org/pypi/cuplcodec/)

Hosted on [PyPI](https://pypi.org/project/cuplcodec/). Install the package with:

pip install cuplcodec

## Licence

### cuplcodec

[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)

### Documentation

[![License: CC BY-SA 4.0](https://img.shields.io/badge/License-CC%20BY--SA%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-sa/4.0/)

0 comments on commit cb4a7c4

Please sign in to comment.