2009-01-12 09:21:53 +00:00
|
|
|
NAME
|
|
|
|
|
getstate.pm - Copyright (c)2008 Martin Fischer <m_fischer@gmx.de>
|
2008-12-28 14:43:45 +00:00
|
|
|
|
2009-01-12 09:21:53 +00:00
|
|
|
SYNOPSIS
|
|
|
|
|
getstate <devspec>
|
2008-12-28 14:43:45 +00:00
|
|
|
|
2009-01-12 09:21:53 +00:00
|
|
|
DESCRIPTION
|
|
|
|
|
The module getstate.pm extends FHEM to support a short status output of
|
|
|
|
|
a device. It is useful for monitoring the device in e.g. Cacti.
|
2008-12-28 14:43:45 +00:00
|
|
|
|
2009-01-12 09:21:53 +00:00
|
|
|
INSTALLATION
|
|
|
|
|
Copy the script 99_getstate.pm to FHEM modules directory, e.g.
|
2008-12-28 14:43:45 +00:00
|
|
|
|
2010-09-04 06:51:58 +00:00
|
|
|
'cp 99_getstate.pm /usr/share/fhem/FHEM'
|
2008-12-28 14:43:45 +00:00
|
|
|
|
2009-01-12 09:21:53 +00:00
|
|
|
and restart FHEM.
|
2008-12-28 14:43:45 +00:00
|
|
|
|
2009-01-12 09:21:53 +00:00
|
|
|
EXAMPLES
|
|
|
|
|
Output a short string of the "READINGS" for <devspec>.
|
2008-12-28 14:43:45 +00:00
|
|
|
|
2009-01-12 09:21:53 +00:00
|
|
|
Example for a FS20-Device:
|
2009-12-02 20:38:00 +00:00
|
|
|
fhem> getstate EG.sz.SD.Tv
|
2009-01-12 09:21:53 +00:00
|
|
|
state:0
|
2008-12-28 14:43:45 +00:00
|
|
|
|
2009-01-12 09:21:53 +00:00
|
|
|
Example for a FHT-Device:
|
2009-12-02 20:38:00 +00:00
|
|
|
fhem> getstate EG.wz.HZ
|
2009-01-12 09:21:53 +00:00
|
|
|
actuator:0 day-temp:21.5 desired-temp:21.5 lowtemp-offset:4.0 [...]
|
|
|
|
|
|
|
|
|
|
Example for a KS300/555-Device:
|
2009-12-02 20:38:00 +00:00
|
|
|
fhem> getstate GH.ga.WE.01
|
2009-01-12 09:21:53 +00:00
|
|
|
humidity:93 israining:0 rain:207.8 rain_raw:815 temperature:5.1 [...]
|
|
|
|
|
|
|
|
|
|
Example for a HMS-Device:
|
2009-12-02 20:38:00 +00:00
|
|
|
fhem> getstate NN.xx.RM.01
|
2009-01-12 09:21:53 +00:00
|
|
|
smoke_detect:0
|
|
|
|
|
|
|
|
|
|
CONTRIB
|
|
|
|
|
You can use the example script contrib/fhem-getstate as a "Data Input
|
|
|
|
|
Method" for your Cacti graphs.
|
|
|
|
|
|
|
|
|
|
LEGALESE
|
|
|
|
|
License GPLv3+: GNU GPL version 3 or later
|
|
|
|
|
<http://gnu.org/licenses/gpl.html>.
|
|
|
|
|
|
|
|
|
|
This is free software: you are free to change and redistribute it. There
|
|
|
|
|
is NO WARRANTY, to the extent permitted by law.
|
|
|
|
|
|
|
|
|
|
AUTHOR
|
|
|
|
|
Copyright (C) 2008 Martin Fischer <m_fischer@gmx.de>
|
2008-12-28 14:43:45 +00:00
|
|
|
|
