https://github.com/fphammerle/wireless-sensor

Command-line tool & python library to receive & decode signals of FT017TH wireless thermo/hygrometers 🌡
https://github.com/fphammerle/wireless-sensor

home-automation humidity raspberry-pi sensor temperature wireless-sensor

Last synced: 18 days ago
JSON representation

Command-line tool & python library to receive & decode signals of FT017TH wireless thermo/hygrometers 🌡

• Host: GitHub
• URL: https://github.com/fphammerle/wireless-sensor
• Owner: fphammerle
• License: gpl-3.0
• Created: 2020-12-07T11:29:13.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2025-06-20T09:02:58.000Z (25 days ago)
• Last Synced: 2025-06-22T10:51:30.535Z (23 days ago)
• Topics: home-automation, humidity, raspberry-pi, sensor, temperature, wireless-sensor
• Language: Python
• Homepage: https://pypi.org/project/wireless-sensor/
• Size: 485 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: COPYING

Awesome Lists containing this project

README

        
# wireless-sensor 🌡

[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

[![CI Pipeline Status](https://github.com/fphammerle/wireless-sensor/workflows/tests/badge.svg)](https://github.com/fphammerle/wireless-sensor/actions)

![Coverage Status](https://ipfs.io/ipfs/QmP8k5H4MkfspFxQxdL2kEZ4QQWQjF8xwPYD35KvNH4CA6/20230429T090002+0200/s3.amazonaws.com/assets.coveralls.io/badges/coveralls_100.svg)

[![Last Release](https://img.shields.io/pypi/v/wireless-sensor.svg)](https://pypi.org/project/wireless-sensor/#history)

[![Compatible Python Versions](https://img.shields.io/pypi/pyversions/wireless-sensor.svg)](https://pypi.org/project/wireless-sensor/)

[![DOI](https://zenodo.org/badge/319298583.svg)](https://zenodo.org/badge/latestdoi/319298583)

Command-line tool & python library to receive & decode signals of FT017TH wireless thermo/hygrometers

## Requirements

* [FT017TH](https://github.com/fphammerle/FT017TH-wireless-thermometer-hygrometer-signal#product-details) sensor

* [CC1101 transceiver](https://www.ti.com/product/CC1101)

* Linux machine with CC1101 connected to SPI port & `GDO0` connected to some GPIO pin

  ([wiring instructions](https://github.com/fphammerle/python-cc1101#wiring-raspberry-pi)

  for raspberry pi)

## Setup

```sh

$ pip3 install --user --upgrade wireless-sensor

```

## Usage

### Command-line

```sh

$ wireless-sensor-receive

2020-12-07T10:40:16+0100 23.9°C 46.9%

2020-12-07T10:41:04+0100 23.9°C 46.9%

2020-12-07T10:42:01+0100 23.8°C 47.0%

```

### Python Library

```python

import asyncio

import wireless_sensor

async def _main():

    sensor = wireless_sensor.FT017TH(gdo0_gpio_line_name=b'GPIO24')

    async for measurement in sensor.receive(timeout_seconds=600):

        print(

            measurement.decoding_timestamp,

            measurement.temperature_degrees_celsius,

            measurement.relative_humidity,

        )

asyncio.run(_main())

```