RuuviTag Sensor is a Python library for communicating with RuuviTag BLE Sensor Beacon and for decoding sensord data from broadcasted eddystone-url.
- RuuviTag with Weather Station firmware
- Setup guide
- Python 2.7 and 3
- psutil
- Package uses psutil to start and stop processes. Psutil requires
sudo apt-get install python-devorsudo apt-get install python3-dev
- Package uses psutil to start and stop processes. Psutil requires
- psutil
- Linux
- Package's Windows and OSX supports are only for testing and url decoding
- Bluez
sudo apt-get install bluez bluez-hcidump
- Superuser rights
- Package uses internally hciconf, hcitool and hcidump, which require superuser rights
Install latest released version
$ pip install ruuvitag_sensorInstall latest developement version
$ pip install git+https://github.com/ttu/ruuvitag-sensor
# Or clone this repository and install locally
$ pip install -e .Full installation guide for Raspberry PI & Raspbian
RuuviTag sensors can be identified using MAC addresses.
from ruuvitag_sensor.ruuvi import RuuviTagSensor
sensors = RuuviTagSensor.find_ruuvitags()
# find_ruuvitags function will print the mac address and the state of a sensor when it is found
# find_ruuvitags function returns same information in a dictionaryfrom ruuvitag_sensor.ruuvi import RuuviTagSensor
sensor = RuuviTagSensor('AA:2C:6A:1E:59:3D')
# update state from the device
state = sensor.update()
# get latest state (does not get it from the device)
state = sensor.state
print(state)from ruuvitag_sensor.ruuvi import RuuviTagSensor
# List of macs of sensors which data will be collected
macs = ['AA:2C:6A:1E:59:3D', 'CC:2C:6A:1E:59:3D']
# get_data_for_sensors will look data for the duration of timeout_in_sec
timeout_in_sec = 4
datas = RuuviTagSensor.get_data_for_sensors(macs, timeout_in_sec)
# Dictionary will have lates data for each sensor
print(datas['AA:2C:6A:1E:59:3D'])
print(datas['CC:2C:6A:1E:59:3D'])from ruuvitag_sensor.ruuvi import RuuviTagSensor
from ruuvitag_sensor.url_decoder import UrlDecoder
full_data = '043E2A0201030157168974A5F41E0201060303AAFE1616AAFE10EE037275752E76692341412C3E672B49246AB9'
data = full_data[26:]
encoded = RuuviTagSensor.convert_data(data)
sensor_data = UrlDecoder().decode_data(encoded)
print(sensor_data)$ python ruuvitag_sensor -h
usage: ruuvitag_sensor [-h] [-g MAC_ADDRESS] [-f] [--version]
optional arguments:
-h, --help show this help message and exit
-g MAC_ADDRESS, --get MAC_ADDRESS
Get data
-f, --find Find broadcasting RuuviTags
--version show program's version number and exit
Tests use unittest.mock library, so Python 3.3. or newer is required.
Run with nosetests
$ pip install nose
$ nosetestsRun with setup
$ python setup.py testExamples are in examples directory.
Licensed under the MIT License.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent