Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ankurp/homebridge-pi-thermostat
Homebridge Plugin to make Raspberry Pi into Thermostat
https://github.com/ankurp/homebridge-pi-thermostat
homebridge homebridge-plugin raspberry-pi thermostat
Last synced: 3 months ago
JSON representation
Homebridge Plugin to make Raspberry Pi into Thermostat
- Host: GitHub
- URL: https://github.com/ankurp/homebridge-pi-thermostat
- Owner: ankurp
- Created: 2017-12-22T01:21:25.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2022-04-20T18:50:40.000Z (almost 3 years ago)
- Last Synced: 2024-09-18T19:28:03.036Z (4 months ago)
- Topics: homebridge, homebridge-plugin, raspberry-pi, thermostat
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/homebridge-pi-thermostat
- Size: 33.2 KB
- Stars: 38
- Watchers: 7
- Forks: 23
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Homebridge Pi Thermostat Plugin
This is a [homebridge](https://github.com/nfarina/homebridge) plugin to make a Raspberry Pi connected with a Relay Board and DHT22 Temperature and Humidity Sensor into a smart thermostat that can be controlled via the Home app on iOS using Homekit.
## [Guide](https://blog.encoredevlabs.com/feature/thermostat/raspberrypi/home-automation/homekit/homebridge/2017/12/25/homekit-pi-thermostat.html)
For those who want to create their own thermostat using Raspberry Pi, [here is a blog post](https://blog.encoredevlabs.com/feature/thermostat/raspberrypi/home-automation/homekit/homebridge/2017/12/25/homekit-pi-thermostat.html) that goes through the details of where to buy the parts, how to assemble it and what software to install to get this to work.
## Installation
* Install nodejs and other dependencies for homebridge to work
```sh
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt-get install -y nodejs libavahi-compat-libdnssd-dev
```
* Install [BCM2835](http://www.airspayce.com/mikem/bcm2835/) for temperature sensor to work
```sh
wget http://www.airspayce.com/mikem/bcm2835/bcm2835-1.52.tar.gz
tar zxvf bcm2835-1.52.tar.gz
cd bcm2835-1.52
./configure && make && sudo make check && sudo make install
```
* Install homebridge and this plugin
```sh
sudo npm install -g --unsafe-perm homebridge homebridge-pi-thermostat
```
* Add the accessory config to your homebridge config file located at this path `~/.homebridge/config.json`.
```json
{
"bridge": {
"name": "Homebridge",
"username": "CC:22:3D:E3:CE:30",
"port": 51826,
"pin": "031-45-154"
},
"description": "",
"accessories": [
{
"accessory": "Thermostat",
"name": "Pi Thermostat",
"fanRelayPin": 26,
"heatRelayPin": 21,
"coolRelayPin": 20,
"temperatureSensorPin": 4,
"minimumOnOffTime": 120000,
"blowerTurnOffTime": 80000,
"startDelay": 10000,
"temperatureCheckInterval": 10000
}
],
"platforms": []
}
```
* Start it up by running `homebridge` command.
## Configuration
### Relay Pins
You can change the pin to turn on and off the relay switch for the Fan, Heat and Cool setting.
```json
"fanRelayPin": 26,
"heatRelayPin": 21,
"coolRelayPin": 20,
```
### Temperature Sensor Pin
You also can change the pin for the DHT22 temperature sensor.
```json
"temperatureSensorPin": 4,
```
### Timing
The system has a minimum on off time which is in miliseconds and is the minimum time it keeps the Heat or Cool turned on and off so that it does not damage the heating or cooling system by turning on and off very quickly.
```json
"minimumOnOffTime": 120000,
```
The system also has a blowerTurnOffTime which is the time it takes to turn off the blower after Heat or Cool is turned off.
```json
"blowerTurnOffTime": 80000,
```
The interval for checking the temperature of the room can also be set and defaults to 10 seconds.
```json
"temperatureCheckInterval": 10000
```
## Screenshots
