install.md

Installation

1. Install dependencies.
   • Go toolchain required if you are going to compile from sources.
   • Gattlib required if you are using gatt backend.
   • Install Bluez to scan and pair device.
2. Compile or download released binaries.
3. Pair device with bluetoothctrl First, press 'On' button on device for 5 seconds while blue ligth is turned on. Then pair with bluetoothctrl

      [bluetooth]# scan on
      ... 
      [NEW] Device E1:AA:BB:CC:DD:EE Tion Breezer 3S
      ...
      [bluetooth]# scan off
      [bluetooth]# pair E1:AA:BB:CC:DD:EE
   
   

4. Now you can use tion tools
   • cli :

    $ ./tion-cli --device E1:AA:BB:CC:DD:EE 
    Using implementation github.com/muka/go-bluetooth/api
    Status: on, Heater: on, Sound: on
    Target: 15 C, In: 3 C, Out: 14 C
    Speed 2, Gate: outdoor, Error: 0, FW: 32
    Filters remain: 42 days, Uptime 280 days 17:19
   
    $ ./tion-cli --device E1:AA:BB:CC:DD:EE -off 
    Turned off
   
    $ ./tion-cli --device E1:AA:BB:CC:DD:EE -on 
    Turned on
   

   • mqtt can be controlled by systemd, below example configuration

   [Unit]
   Description=Tion MQTT
   
   [Service]
   User=pi
   ExecStart=/pathto/tion-mqtt -device  E1:AA:BB:CC:DD:EE -mqtt ssl://mqtt -mqtt-user user -mqtt-pass password -mqtt-ca /path-to-ca -n -d -keepbt -interval 30
   Restart=always
   RestartSec=20
   StartLimitInterval=0
   
   [Install]
   WantedBy=multi-user.target

   MQTT client publish tion status to topic periodically and can be managed by control messages from control topic.
   • influx can send tion parameters to InfluxDB
   • schedule can configure and run actions by timer