mirror of
https://github.com/fhem/fhem-mirror.git
synced 2025-02-28 21:14:52 +00:00
423 lines
12 KiB
Perl
Executable File
423 lines
12 KiB
Perl
Executable File
########################################################################################
|
|
#
|
|
# $Id$
|
|
#
|
|
# FHEM module for one Firmata PWM output pin
|
|
#
|
|
########################################################################################
|
|
#
|
|
# LICENSE AND COPYRIGHT
|
|
#
|
|
# Copyright (C) 2013 ntruchess
|
|
# Copyright (C) 2016 jensb
|
|
#
|
|
# All rights reserved
|
|
#
|
|
# This script is free software; you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation; either version 2 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# The GNU General Public License can be found at
|
|
# http://www.gnu.org/copyleft/gpl.html.
|
|
# A copy is found in the textfile GPL.txt and important notices to the license
|
|
# from the author is found in LICENSE.txt distributed with these scripts.
|
|
#
|
|
# This script is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# This copyright notice MUST APPEAR in all copies of the script!
|
|
#
|
|
########################################################################################
|
|
|
|
package main;
|
|
|
|
use strict;
|
|
use warnings;
|
|
|
|
#add FHEM/lib to @INC if it's not allready included. Should rather be in fhem.pl than here though...
|
|
BEGIN {
|
|
if (!grep(/FHEM\/lib$/,@INC)) {
|
|
foreach my $inc (grep(/FHEM$/,@INC)) {
|
|
push @INC,$inc."/lib";
|
|
};
|
|
};
|
|
};
|
|
|
|
use Device::Firmata::Constants qw/ :all /;
|
|
use SetExtensions qw/ :all /;
|
|
|
|
#####################################
|
|
|
|
my %gets = (
|
|
"dim" => 0,
|
|
"value" => 0,
|
|
"devStateIcon" => 0,
|
|
);
|
|
|
|
my %sets = (
|
|
"on" => 0,
|
|
"off" => 0,
|
|
"toggle" => 0,
|
|
"value" => 1,
|
|
"dim:slider,0,1,100" => 1,
|
|
"fadeTo" => 2,
|
|
"dimUp" => 0,
|
|
"dimDown" => 0,
|
|
);
|
|
|
|
sub
|
|
FRM_PWM_Initialize($)
|
|
{
|
|
my ($hash) = @_;
|
|
|
|
$hash->{SetFn} = "FRM_PWM_Set";
|
|
$hash->{GetFn} = "FRM_PWM_Get";
|
|
$hash->{DefFn} = "FRM_Client_Define";
|
|
$hash->{InitFn} = "FRM_PWM_Init";
|
|
$hash->{UndefFn} = "FRM_Client_Undef";
|
|
$hash->{AttrFn} = "FRM_PWM_Attr";
|
|
$hash->{StateFn} = "FRM_PWM_State";
|
|
|
|
$hash->{AttrList} = "restoreOnReconnect:on,off restoreOnStartup:on,off IODev $main::readingFnAttributes";
|
|
main::LoadModule("FRM");
|
|
}
|
|
|
|
sub
|
|
FRM_PWM_Init($$)
|
|
{
|
|
my ($hash,$args) = @_;
|
|
my $ret = FRM_Init_Pin_Client($hash,$args,PIN_PWM);
|
|
return $ret if (defined $ret);
|
|
my $firmata = $hash->{IODev}->{FirmataDevice};
|
|
my $name = $hash->{NAME};
|
|
my $resolution = 8;
|
|
if (defined $firmata->{metadata}{pwm_resolutions}) {
|
|
$resolution = $firmata->{metadata}{pwm_resolutions}{$hash->{PIN}}
|
|
}
|
|
$hash->{resolution} = $resolution;
|
|
$hash->{".max"} = defined $resolution ? (1<<$resolution)-1 : 255;
|
|
$hash->{".dim"} = 0;
|
|
$hash->{".toggle"} = "off";
|
|
if (! (defined AttrVal($name,"stateFormat",undef))) {
|
|
$main::attr{$name}{"stateFormat"} = "value";
|
|
}
|
|
my $value = ReadingsVal($name,"value",undef);
|
|
if (defined $value and AttrVal($hash->{NAME},"restoreOnReconnect","on") eq "on") {
|
|
FRM_PWM_Set($hash,$name,"value",$value);
|
|
}
|
|
main::readingsSingleUpdate($hash,"state","Initialized",1);
|
|
return undef;
|
|
}
|
|
|
|
sub
|
|
FRM_PWM_Set($@)
|
|
{
|
|
my ($hash, $name, $cmd, @a) = @_;
|
|
|
|
my @match = grep( $_ =~ /^$cmd($|:)/, keys %sets );
|
|
#-- check argument
|
|
return SetExtensions($hash, join(" ", keys %sets), $name, $cmd, @a) unless @match == 1;
|
|
return "$cmd expects $sets{$match[0]} parameters" unless (@a eq $sets{$match[0]});
|
|
|
|
eval {
|
|
SETHANDLER: {
|
|
my $value = $a[0] if @a;
|
|
$cmd eq "on" and do {
|
|
FRM_PWM_writeOut($hash,$hash->{".max"});
|
|
$hash->{".toggle"} = "on";
|
|
last;
|
|
};
|
|
$cmd eq "off" and do {
|
|
FRM_PWM_writeOut($hash,0);
|
|
$hash->{".toggle"} = "off";
|
|
last;
|
|
};
|
|
$cmd eq "toggle" and do {
|
|
my $toggle = $hash->{".toggle"};
|
|
TOGGLEHANDLER: {
|
|
$toggle eq "off" and do {
|
|
FRM_PWM_writeOut($hash,$hash->{".dim"});
|
|
$hash->{".toggle"} = "up";
|
|
last;
|
|
};
|
|
$toggle eq "up" and do {
|
|
FRM_PWM_writeOut($hash,$hash->{".max"});
|
|
$hash->{".toggle"} = "on";
|
|
last;
|
|
};
|
|
$toggle eq "on" and do {
|
|
FRM_PWM_writeOut($hash,$hash->{".dim"});
|
|
$hash->{".toggle"} = "down";
|
|
last;
|
|
};
|
|
$toggle eq "down" and do {
|
|
FRM_PWM_writeOut($hash,0);
|
|
$hash->{".toggle"} = "off";
|
|
last;
|
|
};
|
|
};
|
|
last;
|
|
};
|
|
$cmd eq "value" and do {
|
|
my $max = $hash->{".max"};
|
|
die "maximum value of $max exceeded: $value" if ($value > $max);
|
|
FRM_PWM_writeOut($hash,$value);
|
|
TOGGLEHANDLER: {
|
|
$value == $max and do {
|
|
$hash->{".toggle"} = "on";
|
|
last;
|
|
};
|
|
$value == 0 and do {
|
|
$hash->{".toggle"} = "off";
|
|
last;
|
|
};
|
|
$hash->{".toggle"} = "up" unless $hash->{".toggle"} eq "down";
|
|
$hash->{".dim"} = $value;
|
|
};
|
|
last;
|
|
};
|
|
$cmd eq "dim" and do {
|
|
die "maximum value of 100 exceeded: $value" if ($value > 100);
|
|
my $dim = int($hash->{".max"}*$value/100);
|
|
FRM_PWM_writeOut($hash,$dim);
|
|
TOGGLEHANDLER: {
|
|
$value == 100 and do {
|
|
$hash->{".toggle"} = "on";
|
|
last;
|
|
};
|
|
$value == 0 and do {
|
|
$hash->{".toggle"} = "off";
|
|
last;
|
|
};
|
|
$hash->{".toggle"} = "up" unless $hash->{".toggle"} eq "down";
|
|
$hash->{".dim"} = $dim;
|
|
};
|
|
last;
|
|
};
|
|
$cmd eq "fadeTo" and do {
|
|
die "fadeTo not implemented yet";
|
|
};
|
|
$cmd eq "dimUp" and do {
|
|
my $dim = $hash->{".dim"};
|
|
my $max = $hash->{".max"};
|
|
if ($dim > $max * 0.9) {
|
|
$dim = $max;
|
|
$hash->{".toggle"} = "on";
|
|
} else {
|
|
$dim = $dim + $max / 10;
|
|
$hash->{".toggle"} = "up" unless $hash->{".toggle"} eq "down";
|
|
}
|
|
FRM_PWM_writeOut($hash,$dim);
|
|
$hash->{".dim"} = $dim;
|
|
last;
|
|
};
|
|
$cmd eq "dimDown" and do {
|
|
my $step = $hash->{".max"} / 10;
|
|
my $dim = $hash->{".dim"};
|
|
if ($dim < $step) {
|
|
$dim = 0;
|
|
$hash->{".toggle"} = "off";
|
|
} else {
|
|
$dim = $dim - $step;
|
|
$hash->{".toggle"} = "down" unless $hash->{".toggle"} eq "up";
|
|
}
|
|
FRM_PWM_writeOut($hash,$dim);
|
|
$hash->{".dim"} = $dim;
|
|
last;
|
|
};
|
|
}
|
|
};
|
|
if ($@) {
|
|
$@ =~ /^(.*)( at.*FHEM.*)$/;
|
|
$hash->{STATE} = "error setting '$cmd': ".(defined $1 ? $1 : $@);
|
|
return "error setting '$hash->{NAME} $cmd': ".(defined $1 ? $1 : $@);
|
|
}
|
|
return undef;
|
|
}
|
|
|
|
sub
|
|
FRM_PWM_writeOut($$)
|
|
{
|
|
my ($hash,$value) = @_;
|
|
FRM_Client_FirmataDevice($hash)->analog_write($hash->{PIN},$value);
|
|
readingsBeginUpdate($hash);
|
|
readingsBulkUpdate($hash,"value",$value, 1);
|
|
readingsBulkUpdate($hash,"dim",int($value*100/$hash->{".max"}), 1);
|
|
readingsEndUpdate($hash, 1);
|
|
}
|
|
|
|
sub
|
|
FRM_PWM_Get($@)
|
|
{
|
|
my ($hash, $name, $cmd, @a) = @_;
|
|
|
|
return "FRM_PWM: Get with unknown argument $cmd, choose one of ".join(" ", sort keys %gets)
|
|
unless defined($gets{$cmd});
|
|
|
|
GETHANDLER: {
|
|
$cmd eq 'dim' and do {
|
|
return ReadingsVal($name,"dim",undef);
|
|
};
|
|
$cmd eq 'value' and do {
|
|
return ReadingsVal($name,"value",undef);
|
|
};
|
|
$cmd eq 'devStateIcon' and do {
|
|
return return "not implemented yet";
|
|
};
|
|
}
|
|
}
|
|
|
|
sub
|
|
FRM_PWM_State($$$$)
|
|
{
|
|
my ($hash, $tim, $sname, $sval) = @_;
|
|
my $name = $hash->{NAME};
|
|
if ($sname eq "value") {
|
|
# depending on the FHEM startup timing and the Arduino connection type, FHEM statefile restore and Arduino connect take place in arbitrary order
|
|
if (AttrVal($name, "restoreOnStartup", "on") eq "on") {
|
|
$hash->{READINGS}{$sname}{VAL} = $sval;
|
|
$hash->{READINGS}{$sname}{TIME} = $tim;
|
|
if (defined($hash->{IODev}) && defined($hash->{IODev}->{FirmataDevice} && $hash->{IODev}->{FirmataDevice}->{state} eq "Initialized")) {
|
|
FRM_PWM_Set($hash, $name, "value", $sval);
|
|
}
|
|
} else {
|
|
$hash->{READINGS}{$sname}{VAL} = undef;
|
|
$hash->{READINGS}{$sname}{TIME} = gettimeofday();
|
|
}
|
|
}
|
|
return 0; # default processing by fhem.pl
|
|
}
|
|
|
|
sub
|
|
FRM_PWM_Attr($$$$)
|
|
{
|
|
my ($command,$name,$attribute,$value) = @_;
|
|
my $hash = $main::defs{$name};
|
|
eval {
|
|
if ($command eq "set") {
|
|
ARGUMENT_HANDLER: {
|
|
$attribute eq "IODev" and do {
|
|
if ($main::init_done and (!defined ($hash->{IODev}) or $hash->{IODev}->{NAME} ne $value)) {
|
|
FRM_Client_AssignIOPort($hash,$value);
|
|
FRM_Init_Client($hash) if (defined ($hash->{IODev}));
|
|
}
|
|
last;
|
|
};
|
|
}
|
|
}
|
|
};
|
|
if ($@) {
|
|
$@ =~ /^(.*)( at.*FHEM.*)$/;
|
|
$hash->{STATE} = "error setting $attribute to $value: ".$1;
|
|
return "cannot $command attribute $attribute to $value for $name: ".$1;
|
|
}
|
|
}
|
|
|
|
1;
|
|
|
|
=pod
|
|
|
|
CHANGES
|
|
|
|
2016 jensb
|
|
o modified subs FRM_PWM_Init and FRM_PWM_State to support attribute "restoreOnStartup"
|
|
|
|
=cut
|
|
|
|
=pod
|
|
=item device
|
|
=item summary Firmata: PWM output
|
|
=item summary_DE Firmata: PWM Ausgang
|
|
=begin html
|
|
|
|
<a name="FRM_PWM"></a>
|
|
<h3>FRM_PWM</h3>
|
|
<ul>
|
|
This module represents a pin of a <a href="http://www.firmata.org">Firmata device</a>
|
|
that should be configured as a pulse width modulated output (PWM).<br><br>
|
|
|
|
Requires a defined <a href="#FRM">FRM</a> device to work. The pin must be listed in the internal reading "<a href="#FRMinternals">pwm_pins</a>"<br>
|
|
of the FRM device (after connecting to the Firmata device) to be used as PWM output.<br><br>
|
|
|
|
<a name="FRM_PWMdefine"></a>
|
|
<b>Define</b>
|
|
<ul>
|
|
<code>define <name> FRM_PWM <pin></code><br><br>
|
|
|
|
Defines the FRM_PWM device. <pin>> is the arduino-pin to use.
|
|
</ul><br>
|
|
|
|
<a name="FRM_PWMset"></a>
|
|
<b>Set</b><br>
|
|
<ul>
|
|
<li><code>set <name> on</code><br>
|
|
sets the pulse-width to 100%<br>
|
|
</li>
|
|
<li>
|
|
<code>set <name> off</code><br>
|
|
sets the pulse-width to 0%<br>
|
|
</li>
|
|
<li>
|
|
<a href="#setExtensions">set extensions</a> are supported<br>
|
|
</li>
|
|
<li>
|
|
<code>set <name> toggle</code><br>
|
|
toggles the pulse-width in between to the last value set by 'value' or 'dim' and 0 respectivly 100%<br>
|
|
</li>
|
|
<li>
|
|
<code>set <name> value <value></code><br>
|
|
sets the pulse-width to the value specified<br>
|
|
The min value is zero and the max value depends on the Firmata device (see internal reading<br>
|
|
"<a href="#FRMinternals">pwm_resolutions</a>" of the FRM device). For 8 bits resolution the range
|
|
is 0 to 255 (also see <a href="http://arduino.cc/en/Reference/AnalogWrite">analogWrite()</a> for details)<br>
|
|
</li>
|
|
<li>
|
|
<code>set <name> dim <value></code><br>
|
|
sets the pulse-width to the value specified in percent<br>
|
|
Range is from 0 to 100<br>
|
|
</li>
|
|
<li>
|
|
<code>set <name> dimUp</code><br>
|
|
increases the pulse-width by 10%<br>
|
|
</li>
|
|
<li>
|
|
<code>set <name> dimDown</code><br>
|
|
decreases the pulse-width by 10%<br>
|
|
</li>
|
|
</ul><br>
|
|
|
|
<a name="FRM_PWMget"></a>
|
|
<b>Get</b><br>
|
|
<ul>
|
|
N/A
|
|
</ul><br>
|
|
|
|
<a name="FRM_PWMattr"></a>
|
|
<b>Attributes</b><br>
|
|
<ul>
|
|
<li>restoreOnStartup <on|off></li>
|
|
<li>restoreOnReconnect <on|off></li>
|
|
<li><a href="#IODev">IODev</a><br>
|
|
Specify which <a href="#FRM">FRM</a> to use. (Optional, only required if there is more
|
|
than one FRM-device defined.)
|
|
</li>
|
|
<li><a href="#eventMap">eventMap</a><br></li>
|
|
<li><a href="#readingFnAttributes">readingFnAttributes</a><br></li>
|
|
</ul><br>
|
|
|
|
<a name="FRM_PWMnotes"></a>
|
|
<b>Notes</b><br>
|
|
<ul>
|
|
<li>attribute <i>stateFormat</i><br>
|
|
In most cases it is a good idea to assign "value" to the attribute <i>stateFormat</i>. This will show the
|
|
current value of the pin in the web interface.
|
|
</li>
|
|
</ul>
|
|
</ul><br>
|
|
|
|
=end html
|
|
=cut
|