User Tools

Site Tools


owst:start

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
owst:start [2014/02/17 00:41]
admin [Features]
owst:start [2020/04/08 08:42] (current)
admin [Configuration]
Line 3: Line 3:
 OWST is an Open Source project performing as a programmable timer for [[http://www.maximintegrated.com/products/1-wire-and-ibutton.mvp|1-Wire]](r) switches such as [[http://www.maximintegrated.com/datasheet/index.mvp/id/3818/t/al|DS2408]] (8-Channel Addressable Switch) or [[http://www.maximintegrated.com/datasheet/index.mvp/id/4588/t/al|DS2413]] (Dual Channel Addressable Switch).  OWST is an Open Source project performing as a programmable timer for [[http://www.maximintegrated.com/products/1-wire-and-ibutton.mvp|1-Wire]](r) switches such as [[http://www.maximintegrated.com/datasheet/index.mvp/id/3818/t/al|DS2408]] (8-Channel Addressable Switch) or [[http://www.maximintegrated.com/datasheet/index.mvp/id/4588/t/al|DS2413]] (Dual Channel Addressable Switch). 
  
- +For featurestechnical detailsinstallation instructions see [[https://github.com/clemens-it/owst|OWST on GitHub]]
-====Features==== +
-  * completely free and open source. +
-  * manages addressable switches in a 1-Wire networkevery switch can be controlled by timer programs. +
-  * Every switch may be in one of the three modes: constant ONconstant OFF, TIMER. Mode may be changed without affecting the programming of the timer. +
- +
-Timer +
-  * Nearly unlimited time programs. Number of time programs are limited only by the resources of the server and/or the used database management system SQlite3. +
-  * programming is based on weekly repetition. +
-  * 7-day programming: time programs can be set to be valid for selected days of the week only. +
-  * Time programs can be limited by a starting and final date. +
-  * Option to automatically delete time program after it's expiry date.  +
-  * Option for time program to override other active time programs when switching OFF. +
- +
- +
-Web interface +
-  * Management of time programs (insert, update, delete) +
-  * Designed for usage on smart phone +
-  * Cloning of time programs +
-  * Interruption of time programs for a given time period (ideal for holidays etc.) +
-  * Immediate actions such as switch-ON for given time or switch-OFF in given time. +
-  * Access to log  +
-  * Display of at queue +
- +
-The script which actually switches on or off the One Wire switches may be called periodically using cron or at the corresponding date and time using 'at' (with automatic reprogramming of 'at').  +
- +
-OWS Timer Control works on a time resolution of minutes. Therefore time programs might switch off/on up too 59 seconds to late/early.  +
- +
-Requirements / Relies on +
-  * [[http://owfs.org/|OWFS]] +
-  * [[http://www.php.net|PHP5]] +
-  * [[http://www.smarty.net/|Smarty Template Engine]] +
-  * [[http://www.sqlite.org/|SQLite3]] +
-  * cron/at+
  
 ====Screenshots==== ====Screenshots====
Line 49: Line 16:
   * The user/UID under which the code of the web interface is run must have access to the same at-queue as the user/UID who runs the timer program handler.   * The user/UID under which the code of the web interface is run must have access to the same at-queue as the user/UID who runs the timer program handler.
     * This can be accomplished by either using the same UID for both tasks (web interface and Timer Program Handler), or to grant the web-UID access to the at-queue of the UID which handles the timer programs by using sudo.     * This can be accomplished by either using the same UID for both tasks (web interface and Timer Program Handler), or to grant the web-UID access to the at-queue of the UID which handles the timer programs by using sudo.
- 
-Using sudo: you need to add the following line to your /etc/sudoers file. 
-  www-data ALL = (tph) NOPASSWD: /usr/bin/atq, /usr/bin/atrm, /usr/bin/at 
- 
-Run at boot 
- 
-The Timer Program Handler needs to be run at boot in order to reset the One Wire chip properly. 
- 
-  # File /etc/cron.d/owst 
-  # adapt path names as required 
-   
-  # at reboot empty the at-queue and call tp.php to reprogram all the at-jobs (-r) and to reset the 
-  # switches (-m) to their required states 
-  @reboot   pi   [ -x <path>/tp.php ] && atq | cut -f1 | xargs -r atrm && <path>/tp.php -mr 
- 
  
   * To configure the single switches you need to edit the SQLite database table 'switch' manually. You can do this on the command line, you can use the SQLite web interface [[http://phpliteadmin.googlecode.com|phpLiteAdmin]] or any other user interface to edit SQLite databases.   * To configure the single switches you need to edit the SQLite database table 'switch' manually. You can do this on the command line, you can use the SQLite web interface [[http://phpliteadmin.googlecode.com|phpLiteAdmin]] or any other user interface to edit SQLite databases.
  
-===Nginx=== 
-Protect files from direct web access 
-<code> 
-location ~ /owc/(include|lib|smarty) { 
-   deny all; 
-} 
-</code> 
 ====Further notes==== ====Further notes====
   * 1-Wire is a registered trademark of Maxim Integrated Products, Inc.   * 1-Wire is a registered trademark of Maxim Integrated Products, Inc.
-  * Linux is a registered trademark of Linus Torvalds. 
- 
  
owst/start.1392594067.txt.gz · Last modified: 2014/02/17 00:41 by admin