# Soltherm Raspberry Pi Monitoring

Python package for collecting temperature data from sensors and uploading it 
to an ftp server.

No dependencies. Python3 only.

Usage: `python3 -m solthermpi`

**Caution**: Installing this package may overwrite your crontab!


# How to update config files on Raspberry Pis

Create a user/machine specific config file named `solthermpi.ini` and copy it
to directory `config/SERIALNO/` on the ftp server. The Raspberry Pi with that
serial no. will automatically download and activate the config file.

By default, all config options are defined in `defaultconfig.ini`. User/machine
specific config files allow you to override these options.


# How to create a new version of the solthermpi package

1. Increase version number in `solthermpi/__init__.py`.
2. Build a package:
   ```
   python3 setup.py sdist
   ```
   This will create a file/package `dist/solthermpi-VERSION.tar.gz`.
3. Test if package installation works (in a fresh virtualenv):
   ```
   $ virtualenv -p python3 venv_test
   $ . venv_test/bin/activate
   $ pip install dist/solthermpi-VERSION.tar.gz
   $ python -m solthermpi  # should display usage information
   $ deactivate
   $ rm -r venv_test
   ```

# How to upgrade the package on Raspberry Pis

Simply upload the package `solthermpi-VERSION.tar.gz` (cf. above) to directory
`config/SERIALNO/` on the ftp server. The Raspberry Pi with that serial no.
will automatically upgrade (or downgrade) to the newest package from that
directory.
