Script to automate control of an home reverse cycle aircon system based on custom logic and temperature measurements.
Go to file
Rob Pearce 513d1d3593 Fix typos, add example usage 2021-06-03 19:46:14 +10:00
README.md Fix typos, add example usage 2021-06-03 19:46:14 +10:00
aircon.sh Initial checkin 2021-06-03 09:01:36 +10:00

README.md

Overview

aircon.sh in action

Script to automate control of an home reverse cycle aircon system based on custom logic and temperature measurements.

This was originally written for an AdvantageAir system. It just calls an external script to interface with the aircon, so should be easily adaptable to other systems.

Requirements

Features

  • Log temperature measurements to a CSV file or InfluxDB
  • Control zone temperature by opening/closing its vents
  • Control zone temperature by opening/closing vents in adjacent zones
  • Automatically adjust aircon settings based on defined temperature thresholds
  • Turn zones on/off based on ARP table entires for specific MAC addresses (for example, if a TV is turned on or a person's phone is detected)
  • Define temperature rules based on weekday and/or time

Usage

root@gridbug:~# scripts/aircon.sh  -h
usage:  scripts/aircon.sh [options]

    Modifies aircon based on configured parameters in /root/.airconrc.

    -h          Show this text.
    -c          Cron mode.  Only show output if actions were taken.
    -i x.x.x.x  Specify IP address for aircon (default is 10.99.99.1)
    -I db       Log all zone temperatures to given influxdb database, then exit (see -o).
    -A db       Log actions to given influxdb database.
    -f file     Specify an alternate config file.
    -k file     If file exists, never change aircon settings (default: /root/.aircon_noaction).
    -l num      Set number of too hot/cold zones at which to taking action.
    -L          Log all zone temperatures to CSV file, then exit (see -o).
    -o file     Specify CSV output file.  Default:  /root/acstats.csv
    -m          Generate a config file based on current aircon setup.
    -p          Profiler mode.
    -w          List which zone owners' devices are available then exit.
    -t num      Specify degrees below min temperature before taking action.
    -T num      Specify degrees above max temperature before taking action.
    -y          Actually run commands/db inserts.  By default, commands are just displayed.

Examples

Sample .rc file

root@gridbug:~# cat .airconrc

options -t 0.5

modelock heat

constant Family

owner Study robsphone
owner Rob&Beth robsphone bethsphone
owner Brendan brendansphone
owner Media lgtv_wifi

@Thu-Fri;0830-1630 force Nursery close   # Childcare hours
@1830-0630 temp Nursery 17-19


@0600-2359 temp Family 18-21
temp Media 18-22
temp Rob&Beth 18-22
@Mon-Fri;0830-1730 temp Study 18-22 # Rob working
@Sat-Sun ignore Study               # Not working
2000-0700 temp Ben/Sewing 18-22
@Mon-Fri;0830-1730 temp Ben/Sewing 17-22 # Brendan working

adj Brendan Family
adj Media Brendan
adj Rob&Beth Family
adj Study Family

person Rob robsphone
person Beth bethsphone
person Brendan brendansphone

Generate ~/.airconrcbased on your a tual aircon zones

bash$ aircon.sh -m

Log temperature for each zone to csv then exit

bash$ aircon.sh -L -o /root/acstats.csv -x /usr/local/bin/pymyair -f /root/.airconrc

Preview influxdb inserts for zone temperatures

bash$ aircon.sh -I myinfluxdb -y

Log temperature for each zone to local influxdb then exit

bash$ aircon.sh -I myinfluxdb -y

Determine required aircon changes and display them only (dry run)

bash$ aircon.sh

Make required aircon changes

bash$ aircon.sh -y

Make required aircon changes and log actions to influxdb

bash$ aircon.sh -y -A myinfluxdb

Make required aircon changes and only produce output if actions taken (cron mdoe)

bash$ aircon.sh -y -c