Skip to content

Commit

Permalink
added readme
Browse files Browse the repository at this point in the history
  • Loading branch information
drnoa committed Apr 3, 2024
1 parent 59ed5a9 commit b4c22cb
Showing 1 changed file with 36 additions and 1 deletion.
37 changes: 36 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1 +1,36 @@
# pv_heating_manager
# Heating Manager
The Heating Manager is a Go-based program designed for monitoring and controlling a heating system using Shelly devices. It continuously checks the temperature and activates the heating if needed to prevent exceeding a predefined temperature threshold. Additionally, it conducts weekly checks to ensure the system's proper functionality.

## Features

- **Temperature Monitoring**: Monitors the temperature via a Shelly device and logs the status.
- **Automatic Heating Control**: Turns on the heating when the set temperature threshold is exceeded.
- **Weekly System Check**: Performs automatic weekly checks to ensure the system's operability.

## Configuration

The program reads its configuration from a file named `config.json`, which should be placed in the same directory as the program. The configuration file should include the following settings:

```json
{
"shellyTempURL": "http://[Shelly-IP-Address]/rpc/Temperature.GetConfig?id=[ID of the temperature sensor]",
"shellyHeatingOnURL": "http://[Shelly-IP-Address]/rpc/Switch.Set?id=0&on=true",
"temperatureThreshold": 55
}
```

## Installation
Ensure Go is installed on your system.
Clone the repository or download the source files.
Run go build in the project directory to create the executable file.
## Usage
After configuring config.json appropriately and compiling the program, you can start the Heating Manager by running the generated executable:

```bash
./heating_manager
```

The program will continue to run in the background, monitoring the temperature and controlling the heating as needed.

## License
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

0 comments on commit b4c22cb

Please sign in to comment.