/OSPy

A Python port of the Arduino based OpenSprinkler firmware V 1.8.3

Primary LanguagePython

OSPy Readme

An improved Python 3 port of the Arduino based OpenSprinkler firmware.

Because the web interface is based on the original firmware, the basics described in the user manual are still applicable.

Installation

Preferred option (using Git)

(This option does support automatic updating.)

  1. Ensure git is installed (and the git executable is in your path).
  2. Use git to clone https://github.com/Rimco/OSPy.git to a location of your choice.

Second option (without Git)

(This option does not support automatic updating.)

  1. Download a copy of the program from https://github.com/Rimco/OSPy/archive/master.zip.
  2. Extract the contents to a location of your choice.

Setup

A setup file has been provided to help you setting up your environment to contain all required packages. This setup also helps you in case you want to run the program as a service (on Raspbian).

  1. Go to the folder where the setup.py file is located.
  2. Execute: python setup.py install
  3. Follow the procedures of the script.

License

OpenSprinkler Py (OSPy) Interval Program

Creative Commons Attribution-ShareAlike 3.0 license

Acknowledgements

Full credit goes to Dan for his generous contributions in porting the microcontroller firmware to Python.

The program makes use of web.py (http://webpy.org) for the web interface.

The program makes use of py-gfm (https://github.com/Zopieux/py-gfm) to render the help pages written in GitHub flavored markdown (Python 2) The program makes use of pygments (http://pygments.org) to provide syntax highlighting in the help pages. (Python 2)

The program makes use of cmarkgfm (https://github.com/theacodes/cmarkgfm) to render the help pages written in GitHub flavored markdown (Python 3+).

The program makes use of OpenStreetMap (https://www.openstreetmap.org) to convert locations into coordinates.

The program makes use of Storm Glass API (stormglass.io) for weather information.