/tion_python

Python module for Tion

Primary LanguagePythonGNU Lesser General Public License v3.0LGPL-3.0

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

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(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.

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

device.pair()