36_LaCrosse.pm 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625
  1. # $Id: 36_LaCrosse.pm 13301 2017-02-01 18:21:32Z HCS $
  2. package main;
  3. use strict;
  4. use warnings;
  5. use SetExtensions;
  6. sub LaCrosse_Parse($$);
  7. sub LaCrosse_Initialize($) {
  8. my ($hash) = @_;
  9. $hash->{Match} = "^(\\S+\\s+9 | OK\\sWS\\s)";
  10. $hash->{SetFn} = "LaCrosse_Set";
  11. ###$hash->{GetFn} = "LaCrosse_Get";
  12. $hash->{DefFn} = "LaCrosse_Define";
  13. $hash->{UndefFn} = "LaCrosse_Undef";
  14. $hash->{FingerprintFn} = "LaCrosse_Fingerprint";
  15. $hash->{ParseFn} = "LaCrosse_Parse";
  16. ###$hash->{AttrFn} = "LaCrosse_Attr";
  17. $hash->{AttrList} = "IODev"
  18. ." ignore:1,0"
  19. ." doAverage:1,0"
  20. ." doDewpoint:1,0"
  21. ." filterThreshold"
  22. ." resolution"
  23. ." $readingFnAttributes";
  24. $hash->{AutoCreate} = { "LaCrosse.*" => { autocreateThreshold => "2:120", FILTER => "%NAME" }};
  25. }
  26. sub LaCrosse_Define($$) {
  27. my ($hash, $def) = @_;
  28. my @a = split("[ \t][ \t]*", $def);
  29. if(int(@a) < 3 || int(@a) > 5) {
  30. my $msg = "wrong syntax: define <name> LaCrosse <addr> [corr1...corr2]";
  31. Log3 undef, 2, $msg;
  32. return $msg;
  33. }
  34. $a[2] =~ m/^([\da-f]{2})$/i;
  35. return "$a[2] is not a valid LaCrosse address" if( !defined($1) );
  36. my $name = $a[0];
  37. my $addr = $a[2];
  38. $hash->{corr1} = ((int(@a) > 3) ? $a[3] : 0);
  39. $hash->{corr2} = ((int(@a) > 4) ? $a[4] : 0);
  40. return "LaCrosse device $addr already used for $modules{LaCrosse}{defptr}{$addr}->{NAME}." if( $modules{LaCrosse}{defptr}{$addr} && $modules{LaCrosse}{defptr}{$addr}->{NAME} ne $name );
  41. $hash->{addr} = $addr;
  42. $modules{LaCrosse}{defptr}{$addr} = $hash;
  43. AssignIoPort($hash);
  44. if(defined($hash->{IODev}->{NAME})) {
  45. Log3 $name, 3, "$name: I/O device is " . $hash->{IODev}->{NAME};
  46. }
  47. else {
  48. Log3 $name, 1, "$name: no I/O device";
  49. }
  50. return undef;
  51. }
  52. #-----------------------------------#
  53. sub LaCrosse_Undef($$) {
  54. my ($hash, $arg) = @_;
  55. my $name = $hash->{NAME};
  56. my $addr = $hash->{addr};
  57. delete( $modules{LaCrosse}{defptr}{$addr} );
  58. return undef;
  59. }
  60. #-----------------------------------#
  61. sub LaCrosse_Get($@) {
  62. my ($hash, $name, $cmd, @args) = @_;
  63. return "\"get $name\" needs at least one parameter" if(@_ < 3);
  64. my $list = "";
  65. return "Unknown argument $cmd, choose one of $list";
  66. }
  67. #-----------------------------------#
  68. sub LaCrosse_Attr(@) {
  69. my ($cmd, $name, $attrName, $attrVal) = @_;
  70. return undef;
  71. }
  72. #-----------------------------------#
  73. sub LaCrosse_Fingerprint($$) {
  74. my ($name, $msg) = @_;
  75. return ( "", $msg );
  76. }
  77. #-----------------------------------#
  78. sub LaCrosse_CalcDewpoint (@) {
  79. my ($temp,$hum) = @_;
  80. my($SDD, $DD, $a, $b, $v, $DP);
  81. if($temp>=0) {
  82. $a = 7.5;
  83. $b = 237.3;
  84. }
  85. else {
  86. $a = 7.6;
  87. $b = 240.7;
  88. }
  89. $SDD = 6.1078*10**(($a*$temp)/($b+$temp));
  90. $DD = $hum/100 * $SDD;
  91. $v = log($DD/6.1078)/log(10);
  92. $DP = ($b*$v)/($a-$v);
  93. return $DP;
  94. }
  95. #-----------------------------------#
  96. sub LaCrosse_RemoveReplaceBattery($) {
  97. my $hash = shift;
  98. delete($hash->{replaceBattery});
  99. }
  100. sub LaCrosse_Set($@) {
  101. my ($hash, $name, $cmd, $arg, $arg2) = @_;
  102. my $list = "replaceBatteryForSec";
  103. if( $cmd eq "replaceBatteryForSec" ) {
  104. foreach my $d (sort keys %defs) {
  105. next if (!defined($defs{$d}) );
  106. next if ($defs{$d}->{TYPE} ne "LaCrosse" );
  107. LaCrosse_RemoveReplaceBattery{$defs{$d}};
  108. }
  109. return "Usage: set $name replaceBatteryForSec <seconds_active> [ignore_battery]" if(!$arg || $arg !~ m/^\d+$/ || ($arg2 && $arg2 ne "ignore_battery"));
  110. $hash->{replaceBattery} = $arg2?2:1;
  111. InternalTimer(gettimeofday()+$arg, "LaCrosse_RemoveReplaceBattery", $hash, 0);
  112. }
  113. else {
  114. return "Unknown argument $cmd, choose one of ".$list;
  115. }
  116. return undef;
  117. }
  118. #-----------------------------------#
  119. sub LaCrosse_Parse($$) {
  120. my ($hash, $msg) = @_;
  121. my $name = $hash->{NAME};
  122. my( @bytes, $addr, $typeNumber, $typeName, $battery_new, $battery_low, $error, $type, $channel, $temperature, $humidity, $windDirection, $windSpeed, $windGust, $rain, $pressure );
  123. $temperature = 0xFFFF;
  124. $humidity = 0xFF;
  125. $windDirection = 0xFFFF;
  126. $windSpeed = 0xFFFF;
  127. $windGust = 0xFFFF;
  128. $rain = 0xFFFF;
  129. $pressure = 0xFFFF;
  130. $error = 0;
  131. if( $msg =~ m/^OK 9/ ) {
  132. # Temperature sensor - Format:
  133. # 0 1 2 3 4
  134. # -------------------------
  135. # OK 9 56 1 4 156 37 ID = 56 T: 18.0 H: 37 no NewBatt
  136. # OK 9 49 1 4 182 54 ID = 49 T: 20.6 H: 54 no NewBatt
  137. # OK 9 55 129 4 192 56 ID = 55 T: 21.6 H: 56 WITH NewBatt
  138. # OK 9 2 1 4 212 106 ID = 2 T: 23.6 H: -- Channel: 1
  139. # OK 9 2 130 4 225 125 ID = 2 T: 24.9 H: -- Channel: 2
  140. # OK 9 ID XXX XXX XXX XXX
  141. # | | | | | | |
  142. # | | | | | | --- Humidity incl. WeakBatteryFlag
  143. # | | | | | |------ Temp * 10 + 1000 LSB
  144. # | | | | |---------- Temp * 10 + 1000 MSB
  145. # | | | |-------------- Sensor type (1 or 2) +128 if NewBatteryFlag
  146. # | | |----------------- Sensor ID
  147. # | |------------------- fix "9"
  148. # |---------------------- fix "OK"
  149. @bytes = split( ' ', substr($msg, 5) );
  150. return "" if(@bytes != 5);
  151. $addr = sprintf( "%02X", $bytes[0] );
  152. $battery_new = ($bytes[1] & 0x80) >> 7;
  153. $battery_low = ($bytes[4] & 0x80) >> 7;
  154. $typeNumber = 0;
  155. $typeName = "T(H)";
  156. $type = ($bytes[1] & 0x70) >> 4;
  157. $channel = $bytes[1] & 0x0F;
  158. $temperature = ($bytes[2]*256 + $bytes[3] - 1000)/10;
  159. $humidity = $bytes[4] & 0x7f;
  160. }
  161. elsif ($msg =~ m/^OK WS/) {
  162. # Weather station - Format:
  163. # 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
  164. # -------------------------------------------------------------------
  165. # OK WS 14 1 4 208 53 0 0 7 8 0 29 0 31 1 4 1 I D=0E 23.2°C 52%rH 0mm Dir.: 180.0° Wind:2.9m/s Gust:3.1m/s new Batt. 1025 hPa
  166. # OK WS ID XXX TTT TTT HHH RRR RRR DDD DDD SSS SSS GGG GGG FFF PPP PPP
  167. # | | | | | | | | | | | | | | | | | |-- Pressure LSB
  168. # | | | | | | | | | | | | | | | | |------ Pressure MSB
  169. # | | | | | | | | | | | | | | | |---------- Flags *
  170. # | | | | | | | | | | | | | | |-------------- WindGust * 10 LSB (0.0 ... 50.0 m/s) FF/FF = none
  171. # | | | | | | | | | | | | | |------------------ WindGust * 10 MSB
  172. # | | | | | | | | | | | | |---------------------- WindSpeed * 10 LSB(0.0 ... 50.0 m/s) FF/FF = none
  173. # | | | | | | | | | | | |-------------------------- WindSpeed * 10 MSB
  174. # | | | | | | | | | | |------------------------------ WindDirection * 10 LSB (0.0 ... 365.0 Degrees) FF/FF = none
  175. # | | | | | | | | | |---------------------------------- WindDirection * 10 MSB
  176. # | | | | | | | | |-------------------------------------- Rain * 0.5mm LSB (0 ... 9999 mm) FF/FF = none
  177. # | | | | | | | |------------------------------------------ Rain * 0.5mm MSB
  178. # | | | | | | |---------------------------------------------- Humidity (1 ... 99 %rH) FF = none
  179. # | | | | | |-------------------------------------------------- Temp * 10 + 1000 LSB (-40 ... +60 °C) FF/FF = none
  180. # | | | | |------------------------------------------------------ Temp * 10 + 1000 MSB
  181. # | | | |---------------------------------------------------------- Sensor type (1=TX22, 2=NodeSensor)
  182. # | | |-------------------------------------------------------------- Sensor ID (0 ... 63)
  183. # | |----------------------------------------------------------------- fix "WS"
  184. # |-------------------------------------------------------------------- fix "OK"
  185. #
  186. # * Flags: 128 64 32 16 8 4 2 1
  187. # | | |
  188. # | | |-- New battery
  189. # | |------ ERROR
  190. # |---------- Low battery
  191. @bytes = split( ' ', substr($msg, 5) );
  192. return "" if(@bytes < 14);
  193. $addr = sprintf( "%02X", $bytes[0] );
  194. $typeNumber = $bytes[1];
  195. if($typeNumber == 1) {
  196. $typeName = "TX22";
  197. }
  198. elsif($typeNumber == 2) {
  199. $typeName = "NodeSensor";
  200. }
  201. elsif($typeNumber == 3) {
  202. $typeName = "WS1080";
  203. }
  204. elsif($typeNumber == 4) {
  205. $typeName = "LaCrosseGateway";
  206. }
  207. else {
  208. $typeName = "unknown";
  209. }
  210. $battery_new = $bytes[13] & 0x01;
  211. $battery_low = $bytes[13] & 0x04;
  212. $error = $bytes[13] & 0x02;
  213. $type = 0;
  214. $channel = 1;
  215. my $rh = $modules{LaCrosse}{defptr}{$addr};
  216. if($bytes[2] != 0xFF) {
  217. $temperature = ($bytes[2]*256 + $bytes[3] - 1000)/10;
  218. $rh->{"bufferedT"} = $temperature;
  219. }
  220. else {
  221. if(defined($rh->{"bufferedT"})) {
  222. $temperature = $rh->{"bufferedT"};
  223. }
  224. }
  225. if($bytes[4] != 0xFF) {
  226. $humidity = $bytes[4];
  227. if (defined($rh)) {
  228. $rh->{"bufferedH"} = $humidity;
  229. }
  230. }
  231. else {
  232. if(defined($rh->{"bufferedH"})) {
  233. $humidity = $rh->{"bufferedH"};
  234. }
  235. }
  236. if($bytes[5] != 0xFF) {
  237. $rain = ($bytes[5]*256 + $bytes[6]) * 0.5;
  238. }
  239. if($bytes[7] != 0xFF) {
  240. $windDirection = ($bytes[7]*256 + $bytes[8]) / 10;
  241. }
  242. if($bytes[9] != 0xFF) {
  243. $windSpeed = ($bytes[9] * 256 + $bytes[10]) / 10;
  244. }
  245. if($bytes[11] != 0xFF) {
  246. $windGust = ($bytes[11] * 256 + $bytes[12]) / 10;
  247. }
  248. if(@bytes > 15 && $bytes[14] != 0xFF) {
  249. $pressure = $bytes[14] * 256 + $bytes[15];
  250. }
  251. }
  252. else {
  253. DoTrigger($name, "UNKNOWNCODE $msg");
  254. Log3 $name, 3, "$name: Unknown code $msg, help me!";
  255. return "";
  256. }
  257. my $raddr = $addr;
  258. my $rhash = $modules{LaCrosse}{defptr}{$raddr};
  259. my $rname = $rhash?$rhash->{NAME}:$raddr;
  260. return "" if( IsIgnored($rname) );
  261. if( !$modules{LaCrosse}{defptr}{$raddr} ) {
  262. foreach my $d (sort keys %defs) {
  263. next if( !defined($defs{$d}) );
  264. next if( !defined($defs{$d}->{TYPE}) );
  265. next if( $defs{$d}->{TYPE} ne "LaCrosse" );
  266. next if( !$defs{$d}->{replaceBattery} );
  267. if( $battery_new || $defs{$d}->{replaceBattery} == 2 ) {
  268. $rhash = $defs{$d};
  269. $raddr = $rhash->{addr};
  270. Log3 $name, 3, "LaCrosse: Changing device $rname from $raddr to $addr";
  271. delete $modules{LaCrosse}{defptr}{$raddr};
  272. $rhash->{DEF} = $addr;
  273. $rhash->{addr} = $addr;
  274. $modules{LaCrosse}{defptr}{$addr} = $rhash;
  275. LaCrosse_RemoveReplaceBattery($rhash);
  276. CommandSave(undef,undef) if( AttrVal( "autocreate", "autosave", 1 ) );
  277. return "";
  278. }
  279. }
  280. # get info about autocreate
  281. my $autoCreateState = 0;
  282. my $laCrosseInIgnoreTypes = 0;
  283. foreach my $d (keys %defs) {
  284. next if($defs{$d}{TYPE} ne "autocreate");
  285. $autoCreateState = 1;
  286. $autoCreateState = 2 if(!AttrVal($defs{$d}{NAME}, "disable", undef));
  287. my $it = AttrVal($defs{$d}{NAME}, "ignoreTypes", "");
  288. if("LaCrosse" =~ m/$it/i) {
  289. $laCrosseInIgnoreTypes = 1
  290. }
  291. }
  292. # $autoCreateState
  293. # ----------------
  294. # 0 = autoreate not defined
  295. # 1 = autocreate defined
  296. # 2 = autocreate active
  297. #$laCrosseInIgnoreTypes
  298. #----------------------
  299. # 0 = no
  300. # 1 = yes
  301. # decide how to log
  302. my $loglevel = 4;
  303. if($autoCreateState < 2 && $laCrosseInIgnoreTypes == 0) {
  304. $loglevel = 3;
  305. }
  306. Log3 $name, $loglevel, "LaCrosse: Unknown device $rname, please define it";
  307. Log3 $name, $loglevel, "LaCrosse: check commandref on usage of LaCrossePairForSec" if( !$hash->{LaCrossePair} && !defined($modules{LaCrosse}{defptr}) );
  308. return "" if( !$hash->{LaCrossePair} );
  309. return "UNDEFINED LaCrosse_$rname LaCrosse $raddr" if( $battery_new || $hash->{LaCrossePair} == 2 );
  310. return "";
  311. }
  312. $rhash->{battery_new} = $battery_new;
  313. my @list;
  314. push(@list, $rname);
  315. $rhash->{LaCrosse_lastRcv} = TimeNow();
  316. $rhash->{"sensorType"} = "$typeNumber=$typeName";
  317. if( $type == 0x00) {
  318. $channel = "" if( $channel == 1 );
  319. # Correction
  320. $temperature += $rhash->{corr1};
  321. $humidity += $rhash->{corr2};
  322. my $previousT = $temperature;
  323. my $previousH = $humidity;
  324. # Check filterThreshold
  325. if(!defined($rhash->{"previousT$channel"})
  326. || (defined($rhash->{"previousT$channel"})
  327. && abs($rhash->{"previousH$channel"} - $humidity) <= AttrVal( $rname, "filterThreshold", 10 )
  328. && abs($rhash->{"previousT$channel"} - $temperature) <= AttrVal( $rname, "filterThreshold", 10 ) )) {
  329. # remove unwanted Battery2 readings
  330. if (defined ($rhash->{READINGS}{battery2})) {
  331. delete $rhash->{READINGS}{battery2}
  332. }
  333. # Calculate average
  334. if (AttrVal( $rname, "doAverage", 0 ) && defined($rhash->{"previousT$channel"}) && $temperature != 0xFFFF) {
  335. $temperature = ($rhash->{"previousT$channel"} * 3 + $temperature) / 4;
  336. }
  337. if (AttrVal( $rname, "doAverage", 0 ) && defined($rhash->{"previousH$channel"}) && $humidity != 0xFF) {
  338. $humidity = ($rhash->{"previousH$channel"} * 3 + $humidity) / 4;
  339. }
  340. # Calculate dew point
  341. my $dewpoint = undef;
  342. if( AttrVal( $rname, "doDewpoint", 0 ) && $humidity && $humidity <= 99 && $temperature != 0xFFFF ) {
  343. $dewpoint = LaCrosse_CalcDewpoint($temperature, $humidity);
  344. }
  345. # Handle resolution
  346. my $resolution = AttrVal( $rname, "resolution", 1);
  347. if ($temperature != 0xFFFF) {
  348. $temperature = int($temperature * 10 / $resolution + ($temperature < 0 ? -0.5 : 0.5)) * $resolution / 10
  349. }
  350. if ($humidity != 0xFF) {
  351. $humidity = int($humidity * 10 / $resolution + ($humidity < 0 ? -0.5 : 0.5)) * $resolution / 10
  352. }
  353. if ($dewpoint) {
  354. $dewpoint = int($dewpoint * 10 / $resolution + ($dewpoint < 0 ? -0.5 : 0.5)) * $resolution / 10
  355. }
  356. readingsBeginUpdate($rhash);
  357. if ($typeNumber > 0) {
  358. readingsBulkUpdate($rhash, "error", $error ? "1" : "0");
  359. }
  360. readingsBulkUpdate($rhash, "battery", $battery_low ? "low" : "ok");
  361. # write temperature, humidity, ...
  362. if ($temperature != 0xFFFF) {
  363. readingsBulkUpdate($rhash, "temperature$channel", $temperature);
  364. }
  365. if ($humidity && $humidity <= 100) {
  366. readingsBulkUpdate($rhash, "humidity$channel", $humidity);
  367. }
  368. if ($dewpoint) {
  369. readingsBulkUpdate($rhash, "dewpoint$channel", $dewpoint);
  370. }
  371. # STATE
  372. if( !$channel ) {
  373. my $state = "T: ". $temperature;
  374. $state .= " H: ". ($humidity) if( $humidity && $humidity <= 99 );
  375. $state .= " D: $dewpoint" if( $dewpoint );
  376. readingsBulkUpdate($rhash, "state", $state) if( Value($rname) ne $state );
  377. }
  378. readingsEndUpdate($rhash,1);
  379. }
  380. else {
  381. $rhash->{"bufferedT"} = undef;
  382. $rhash->{"bufferedH"} = undef;
  383. }
  384. $rhash->{"previousT$channel"} = int($previousT*10 + 0.5) / 10;
  385. $rhash->{"previousH$channel"} = int($previousH*10 + 0.5) / 10;
  386. readingsBeginUpdate($rhash);
  387. if ($typeNumber > 0 && $windSpeed != 0xFFFF) {
  388. readingsBulkUpdate($rhash, "windSpeed", $windSpeed );
  389. }
  390. if ($typeNumber > 0 && $windGust != 0xFFFF) {
  391. readingsBulkUpdate($rhash, "windGust", $windGust );
  392. }
  393. if ($typeNumber > 0 && $rain != 0xFFFF) {
  394. if(!defined($rhash->{"previousR"}) || (defined($rhash->{"previousR"}) && abs($rhash->{"previousR"} - $rain) <= AttrVal( $rname, "filterThreshold", 10 ))){
  395. readingsBulkUpdate($rhash, "rain", $rain );
  396. }
  397. $rhash->{"previousR"} = $rain;
  398. }
  399. if ($typeNumber > 0 && $windDirection != 0xFFFF) {
  400. readingsBulkUpdate($rhash, "windDirectionDegree", $windDirection );
  401. my $windDirectionText = "---";
  402. if ($windDirection >= 0 && $windDirection <= 11.2) { $windDirectionText = "N"; }
  403. elsif ($windDirection > 11.2 && $windDirection <= 33.7) { $windDirectionText = "NNE"; }
  404. elsif ($windDirection > 33.7 && $windDirection <= 56.2) { $windDirectionText = "NE"; }
  405. elsif ($windDirection > 56.2 && $windDirection <= 78.7) { $windDirectionText = "ENE"; }
  406. elsif ($windDirection > 78.7 && $windDirection <= 101.2) { $windDirectionText = "E"; }
  407. elsif ($windDirection > 101.2 && $windDirection <= 123.7) { $windDirectionText = "ESE"; }
  408. elsif ($windDirection > 123.7 && $windDirection <= 146.2) { $windDirectionText = "SE"; }
  409. elsif ($windDirection > 146.2 && $windDirection <= 168.7) { $windDirectionText = "SSE"; }
  410. elsif ($windDirection > 168.7 && $windDirection <= 191.2) { $windDirectionText = "S"; }
  411. elsif ($windDirection > 191.2 && $windDirection <= 213.7) { $windDirectionText = "SSW"; }
  412. elsif ($windDirection > 213.7 && $windDirection <= 236.2) { $windDirectionText = "SW"; }
  413. elsif ($windDirection > 236.2 && $windDirection <= 258.7) { $windDirectionText = "WSW"; }
  414. elsif ($windDirection > 258.7 && $windDirection <= 281.2) { $windDirectionText = "W"; }
  415. elsif ($windDirection > 281.2 && $windDirection <= 303.7) { $windDirectionText = "WNW"; }
  416. elsif ($windDirection > 303.7 && $windDirection <= 326.2) { $windDirectionText = "NW"; }
  417. elsif ($windDirection > 326.2 && $windDirection <= 348.7) { $windDirectionText = "NNW"; };
  418. readingsBulkUpdate($rhash, "windDirectionText", $windDirectionText );
  419. }
  420. if ($typeNumber > 0 && $pressure != 0xFFFF) {
  421. readingsBulkUpdate($rhash, "pressure", $pressure );
  422. }
  423. readingsEndUpdate($rhash,1);
  424. }
  425. return @list;
  426. }
  427. 1;
  428. =pod
  429. =item summary LaCrosse Temperature and Humidity sensors
  430. =item summary_DE LaCrosse Temperature und Luftfeuchtigkeitssensoren
  431. =begin html
  432. <a name="LaCrosse"></a>
  433. <h3>LaCrosse</h3>
  434. <ul>
  435. FHEM module for LaCrosse Temperature and Humidity sensors and weather stations like WS 1600 (TX22 sensor).<br><br>
  436. It can be integrated in to FHEM via a <a href="#JeeLink">JeeLink</a> as the IODevice.<br><br>
  437. The JeeNode sketch required for this module can be found in .../contrib/36_LaCrosse-pcaSerial.zip.<br><br>
  438. <a name="LaCrosseDefine"></a>
  439. <b>Define</b>
  440. <ul>
  441. <code>define &lt;name&gt; LaCrosse &lt;addr&gt; [corr1...corr2]</code> <br>
  442. <br>
  443. addr is a 2 digit hex number to identify the LaCrosse device.<br>
  444. corr1..corr2 are up to 2 numerical correction factors (corr1 for the temperature and corr2 for the humidity), which will be added to the respective value to calibrate the device.<br><br>
  445. Note: devices are autocreated only if LaCrossePairForSec is active for the <a href="#JeeLink">JeeLink</a> IODevice device.<br>
  446. </ul>
  447. <br>
  448. <a name="LaCrosse_Set"></a>
  449. <b>Set</b>
  450. <ul>
  451. <li>replaceBatteryForSec &lt;sec&gt; [ignore_battery]<br>
  452. sets the device for &lt;sec&gt; seconds into replace battery mode. the first unknown address that is
  453. received will replace the current device address. this can be partly automated with a readings group configured
  454. to show the battery state of all LaCrosse devices and a link/command to set replaceBatteryForSec on klick.
  455. </li>
  456. </ul><br>
  457. <a name="LaCrosse_Get"></a>
  458. <b>Get</b>
  459. <ul>
  460. </ul><br>
  461. <a name="LaCrosse_Readings"></a>
  462. <b>Readings</b>
  463. <ul>
  464. <li>battery[]<br>
  465. ok or low</li>
  466. <li>temperature (°C)<br>
  467. Notice: see the filterThreshold attribute.</li>
  468. <li>humidity (%rH)</li>
  469. <li>Wind speed (m/s), gust (m/s) and direction (degree)</li>
  470. <li>Rain (mm)</li>
  471. </ul><br>
  472. <a name="LaCrosse_Attr"></a>
  473. <b>Attributes</b>
  474. <ul>
  475. <li>doAverage<br>
  476. use an average of the last 4 values for temperature and humidity readings</li>
  477. <li>doDewpoint<br>
  478. calculate dewpoint</li>
  479. <li>filterThreshold<br>
  480. if the difference between the current and previous temperature is greater than filterThreshold degrees
  481. the readings for this channel are not updated. the default is 10.</li>
  482. <li>resolution<br>
  483. the resolution in 1/10 degree for the temperature reading</li>
  484. <li>ignore<br>
  485. 1 -> ignore this device.</li>
  486. </ul><br>
  487. <b>Logging and autocreate</b><br>
  488. <ul>
  489. <li>If autocreate is not active (not defined or disabled) and LaCrosse is not contained in the ignoreTypes attribute of autocreate then
  490. the <i>Unknown device xx, please define it</i> messages will be logged with loglevel 3. In all other cases they will be logged with loglevel 4. </li>
  491. <li>The autocreateThreshold attribute of the autocreate module (see <a href="#autocreate">autocreate</a>) is respected. The default is 2:120, means, that
  492. autocreate will create a device for a sensor only, if the sensor was received at least two times within two minutes.</li>
  493. </ul>
  494. </ul>
  495. =end html
  496. =cut