8000 GitHub - TionAPI/tion_python: Python module for Tion
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

TionAPI/tion_python

BranchesTags

Repository files navigation

CI tests

About

This module will allow you to control your Tion S3 or Tion Lite breezer via bluetooth.

If you want to use MagicAir API please follow https://github.com/airens/tion

Installation

pip3 install tion-btle

Usage

Use class according to the breezer type. For example for Tion S3 you should use

from tion_btle import S3 as Breezer

Documentation

Few notes about asyncio

get, set, pair, connect and disconnect methods are async. Use it in async loop:

init

You must provide device's MAC-address to the constructor

from tion_btle import S3 as Breezer
mac: str=str("XX:XX:XX:XX:XX:XX")
device = Breezer(mac)

get

Use get() function to get current state of the breezer. It will return json with all available attributes.

print(await device.get())

Result will depend on the breezer model

All models

  • state -- current breezer state (on/off)
  • heater -- current heater status (on/off)
  • heating -- is breezer heating right now (on/off). For example, if the output temerature is 25 and target temperature 21, then heater may be ON, but heating will be OFF
  • sound -- current sound mode (on/off)
  • mode -- current air source (depend on model: outside/recirculation for all plus mixed for S3)
  • out_temp -- air temperature at the outlet of the device
  • in_temp -- air temperature at the inlet to the device
  • heater_temp -- target temperature for device
  • fan_speed -- current fan speed (1..6)
  • filter_remain
  • time -- time when parameters were taken. May be different from the current time. Depends on breezer time for S3
  • request_error_code -- error code for the request (0 if all goes well)
  • code -- response code (200 if all goes well)
  • model -- breezer model (S3/Lite)

S3

This parameters are available only for S3:

  • productivity -- current flow in m^3/h
  • fw_version -- breezer firmware version
  • timer -- timer state (on/off)

Lite

This parameters are available only for Lite:

  • device_work_time
  • electronic_work_time
  • electronic_temp
  • co2_auto_control -- co2 auto control status (on/off). When breezer is used with MagicAir
  • filter_change_required -- is filter change required (on/off)
  • light -- light state (on/off)

set

Use set({parameter1: value, parameter2: value, ...}) to set breezer parameters that may be changed. It depends on the breezer model.

await device.set({
    'fan_speed': 4,
    'heater_temp': 21, 
    'heater': 'on' 
})

All models

  • state -- current breezer state (on/off)
  • heater -- current heater status (on/off)
  • sound -- current sound mode (on/off)
  • mode -- current air source (depend on model: outside/recirculation for all plus mixed for S3)
  • heater_temp -- target temperature for the device
  • fan_speed -- current fan speed (1..6)

Lite

This parameters may be set only for Tion Lite

  • light -- light state (on/off)
  • co2_auto_control -- co2 auto control status (on/off). When breezer is used with MagicAir

pair

To pair device turn breezer to pairing mode and call

await device.pair()

About

Python module for Tion

Topics

python api home-automation iot internet-of-things tion

Resources

Readme

License

LGPL-3.0 license
Activity
Custom properties

Stars

64 stars

Watchers

13 watching

Forks

10 forks
Report repository

Releases 38

v3.3.6 Latest
Oct 11, 2022
+ 37 releases

Contributors 2

  •  
  •  

Languages

0