36_LaCrosse.pm 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645
  1. # $Id: 36_LaCrosse.pm 15483 2017-11-23 20:03:23Z 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, $gas, $debug );
  123. $temperature = 0xFFFF;
  124. $humidity = 0xFF;
  125. $windDirection = 0xFFFF;
  126. $windSpeed = 0xFFFF;
  127. $windGust = 0xFFFF;
  128. $rain = 0xFFFF;
  129. $pressure = 0xFFFF;
  130. $gas = 0xFFFFFF;
  131. $debug = 0xFFFFFF;
  132. $error = 0;
  133. if( $msg =~ m/^OK 9/ ) {
  134. # Temperature sensor - Format:
  135. # 0 1 2 3 4
  136. # -------------------------
  137. # OK 9 56 1 4 156 37 ID = 56 T: 18.0 H: 37 no NewBatt
  138. # OK 9 49 1 4 182 54 ID = 49 T: 20.6 H: 54 no NewBatt
  139. # OK 9 55 129 4 192 56 ID = 55 T: 21.6 H: 56 WITH NewBatt
  140. # OK 9 2 1 4 212 106 ID = 2 T: 23.6 H: -- Channel: 1
  141. # OK 9 2 130 4 225 125 ID = 2 T: 24.9 H: -- Channel: 2
  142. # OK 9 ID XXX XXX XXX XXX
  143. # | | | | | | |
  144. # | | | | | | --- Humidity incl. WeakBatteryFlag
  145. # | | | | | |------ Temp * 10 + 1000 LSB
  146. # | | | | |---------- Temp * 10 + 1000 MSB
  147. # | | | |-------------- Sensor type (1 or 2) +128 if NewBatteryFlag
  148. # | | |----------------- Sensor ID
  149. # | |------------------- fix "9"
  150. # |---------------------- fix "OK"
  151. @bytes = split( ' ', substr($msg, 5) );
  152. return "" if(@bytes != 5);
  153. $addr = sprintf( "%02X", $bytes[0] );
  154. $battery_new = ($bytes[1] & 0x80) >> 7;
  155. $battery_low = ($bytes[4] & 0x80) >> 7;
  156. $typeNumber = 0;
  157. $typeName = "T(H)";
  158. $type = ($bytes[1] & 0x70) >> 4;
  159. $channel = $bytes[1] & 0x0F;
  160. $temperature = ($bytes[2]*256 + $bytes[3] - 1000)/10;
  161. $humidity = $bytes[4] & 0x7f;
  162. }
  163. elsif ($msg =~ m/^OK WS/) {
  164. # Weather station - Format:
  165. # 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
  166. # -------------------------------------------------------------------
  167. # 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
  168. # OK WS ID XXX TTT TTT HHH RRR RRR DDD DDD SSS SSS GGG GGG FFF PPP PPP
  169. # | | | | | | | | | | | | | | | | | |-- Pressure LSB
  170. # | | | | | | | | | | | | | | | | |------ Pressure MSB
  171. # | | | | | | | | | | | | | | | |---------- Flags *
  172. # | | | | | | | | | | | | | | |-------------- WindGust * 10 LSB (0.0 ... 50.0 m/s) FF/FF = none
  173. # | | | | | | | | | | | | | |------------------ WindGust * 10 MSB
  174. # | | | | | | | | | | | | |---------------------- WindSpeed * 10 LSB(0.0 ... 50.0 m/s) FF/FF = none
  175. # | | | | | | | | | | | |-------------------------- WindSpeed * 10 MSB
  176. # | | | | | | | | | | |------------------------------ WindDirection * 10 LSB (0.0 ... 365.0 Degrees) FF/FF = none
  177. # | | | | | | | | | |---------------------------------- WindDirection * 10 MSB
  178. # | | | | | | | | |-------------------------------------- Rain * 0.5mm LSB (0 ... 9999 mm) FF/FF = none
  179. # | | | | | | | |------------------------------------------ Rain * 0.5mm MSB
  180. # | | | | | | |---------------------------------------------- Humidity (1 ... 99 %rH) FF = none
  181. # | | | | | |-------------------------------------------------- Temp * 10 + 1000 LSB (-40 ... +60 °C) FF/FF = none
  182. # | | | | |------------------------------------------------------ Temp * 10 + 1000 MSB
  183. # | | | |---------------------------------------------------------- Sensor type (1=TX22, 2=NodeSensor)
  184. # | | |-------------------------------------------------------------- Sensor ID (0 ... 63)
  185. # | |----------------------------------------------------------------- fix "WS"
  186. # |-------------------------------------------------------------------- fix "OK"
  187. #
  188. # * Flags: 128 64 32 16 8 4 2 1
  189. # | | |
  190. # | | |-- New battery
  191. # | |------ ERROR
  192. # |---------- Low battery
  193. @bytes = split( ' ', substr($msg, 5) );
  194. return "" if(@bytes < 14);
  195. $addr = sprintf( "%02X", $bytes[0] );
  196. $typeNumber = $bytes[1];
  197. if($typeNumber == 1) {
  198. $typeName = "TX22";
  199. }
  200. elsif($typeNumber == 2) {
  201. $typeName = "NodeSensor";
  202. }
  203. elsif($typeNumber == 3) {
  204. $typeName = "WS1080";
  205. }
  206. elsif($typeNumber == 4) {
  207. $typeName = "LaCrosseGateway";
  208. }
  209. else {
  210. $typeName = "unknown";
  211. }
  212. $battery_new = $bytes[13] & 0x01;
  213. $battery_low = $bytes[13] & 0x04;
  214. $error = $bytes[13] & 0x02;
  215. $type = 0;
  216. $channel = 1;
  217. my $rh = $modules{LaCrosse}{defptr}{$addr};
  218. if($bytes[2] != 0xFF) {
  219. $temperature = ($bytes[2]*256 + $bytes[3] - 1000)/10;
  220. $rh->{"bufferedT"} = $temperature;
  221. }
  222. else {
  223. if(defined($rh->{"bufferedT"})) {
  224. $temperature = $rh->{"bufferedT"};
  225. }
  226. }
  227. if($bytes[4] != 0xFF) {
  228. $humidity = $bytes[4];
  229. if (defined($rh)) {
  230. $rh->{"bufferedH"} = $humidity;
  231. }
  232. }
  233. else {
  234. if(defined($rh->{"bufferedH"})) {
  235. $humidity = $rh->{"bufferedH"};
  236. }
  237. }
  238. if($bytes[5] != 0xFF) {
  239. $rain = ($bytes[5]*256 + $bytes[6]) * 0.5;
  240. }
  241. if($bytes[7] != 0xFF) {
  242. $windDirection = ($bytes[7]*256 + $bytes[8]) / 10;
  243. }
  244. if($bytes[9] != 0xFF) {
  245. $windSpeed = ($bytes[9] * 256 + $bytes[10]) / 10;
  246. }
  247. if($bytes[11] != 0xFF) {
  248. $windGust = ($bytes[11] * 256 + $bytes[12]) / 10;
  249. }
  250. if(@bytes > 15 && $bytes[14] != 0xFF) {
  251. $pressure = $bytes[14] * 256 + $bytes[15];
  252. $pressure /= 10.0 if $pressure > 5000;
  253. }
  254. if(@bytes > 18 && $bytes[16] != 0xFF) {
  255. $gas = $bytes[16] * 65536 + $bytes[17] * 256 + $bytes[18];
  256. }
  257. if(@bytes > 21 && $bytes[19] != 0xFF) {
  258. $debug = $bytes[19] * 65536 + $bytes[20] * 256 + $bytes[21];
  259. readingsBulkUpdate($hash, "debug", $debug);
  260. }
  261. }
  262. else {
  263. DoTrigger($name, "UNKNOWNCODE $msg");
  264. Log3 $name, 3, "$name: Unknown code $msg, help me!";
  265. return "";
  266. }
  267. my $raddr = $addr;
  268. my $rhash = $modules{LaCrosse}{defptr}{$raddr};
  269. my $rname = $rhash?$rhash->{NAME}:$raddr;
  270. return "" if( IsIgnored($rname) );
  271. if( !$modules{LaCrosse}{defptr}{$raddr} ) {
  272. foreach my $d (sort keys %defs) {
  273. next if( !defined($defs{$d}) );
  274. next if( !defined($defs{$d}->{TYPE}) );
  275. next if( $defs{$d}->{TYPE} ne "LaCrosse" );
  276. next if( !$defs{$d}->{replaceBattery} );
  277. if( $battery_new || $defs{$d}->{replaceBattery} == 2 ) {
  278. $rhash = $defs{$d};
  279. $raddr = $rhash->{addr};
  280. Log3 $name, 3, "LaCrosse: Changing device $rname from $raddr to $addr";
  281. delete $modules{LaCrosse}{defptr}{$raddr};
  282. $rhash->{DEF} = $addr;
  283. $rhash->{addr} = $addr;
  284. $modules{LaCrosse}{defptr}{$addr} = $rhash;
  285. LaCrosse_RemoveReplaceBattery($rhash);
  286. CommandSave(undef,undef) if( AttrVal( "autocreate", "autosave", 1 ) );
  287. return "";
  288. }
  289. }
  290. # get info about autocreate
  291. my $autoCreateState = 0;
  292. my $laCrosseInIgnoreTypes = 0;
  293. foreach my $d (keys %defs) {
  294. next if($defs{$d}{TYPE} ne "autocreate");
  295. $autoCreateState = 1;
  296. $autoCreateState = 2 if(!AttrVal($defs{$d}{NAME}, "disable", undef));
  297. my $it = AttrVal($defs{$d}{NAME}, "ignoreTypes", "");
  298. if("LaCrosse" =~ m/$it/i) {
  299. $laCrosseInIgnoreTypes = 1
  300. }
  301. }
  302. # $autoCreateState
  303. # ----------------
  304. # 0 = autoreate not defined
  305. # 1 = autocreate defined
  306. # 2 = autocreate active
  307. #$laCrosseInIgnoreTypes
  308. #----------------------
  309. # 0 = no
  310. # 1 = yes
  311. # decide how to log
  312. my $loglevel = 4;
  313. if($autoCreateState < 2 && $laCrosseInIgnoreTypes == 0) {
  314. $loglevel = 3;
  315. }
  316. Log3 $name, $loglevel, "LaCrosse: Unknown device $rname, please define it";
  317. Log3 $name, $loglevel, "LaCrosse: check commandref on usage of LaCrossePairForSec" if( !$hash->{LaCrossePair} && !defined($modules{LaCrosse}{defptr}) );
  318. return "" if( !$hash->{LaCrossePair} );
  319. return "UNDEFINED LaCrosse_$rname LaCrosse $raddr" if( $battery_new || $hash->{LaCrossePair} == 2 );
  320. return "";
  321. }
  322. $rhash->{battery_new} = $battery_new;
  323. my @list;
  324. push(@list, $rname);
  325. $rhash->{LaCrosse_lastRcv} = TimeNow();
  326. $rhash->{"sensorType"} = "$typeNumber=$typeName";
  327. if( $type == 0x00) {
  328. $channel = "" if( $channel == 1 );
  329. # Correction
  330. $temperature += $rhash->{corr1};
  331. $humidity += $rhash->{corr2};
  332. my $previousT = $temperature;
  333. my $previousH = $humidity;
  334. # Check filterThreshold
  335. if(!defined($rhash->{"previousT$channel"})
  336. || (defined($rhash->{"previousT$channel"})
  337. && abs($rhash->{"previousH$channel"} - $humidity) <= AttrVal( $rname, "filterThreshold", 10 )
  338. && abs($rhash->{"previousT$channel"} - $temperature) <= AttrVal( $rname, "filterThreshold", 10 ) )) {
  339. # remove unwanted Battery2 readings
  340. if (defined ($rhash->{READINGS}{battery2})) {
  341. delete $rhash->{READINGS}{battery2}
  342. }
  343. # Calculate average
  344. if (AttrVal( $rname, "doAverage", 0 ) && defined($rhash->{"previousT$channel"}) && $temperature != 0xFFFF) {
  345. $temperature = ($rhash->{"previousT$channel"} * 3 + $temperature) / 4;
  346. }
  347. if (AttrVal( $rname, "doAverage", 0 ) && defined($rhash->{"previousH$channel"}) && $humidity != 0xFF) {
  348. $humidity = ($rhash->{"previousH$channel"} * 3 + $humidity) / 4;
  349. }
  350. # Calculate dew point
  351. my $dewpoint = undef;
  352. if( AttrVal( $rname, "doDewpoint", 0 ) && $humidity && $humidity <= 99 && $temperature != 0xFFFF ) {
  353. $dewpoint = LaCrosse_CalcDewpoint($temperature, $humidity);
  354. }
  355. # Handle resolution
  356. my $resolution = AttrVal( $rname, "resolution", 1);
  357. if ($temperature != 0xFFFF) {
  358. $temperature = int($temperature * 10 / $resolution + ($temperature < 0 ? -0.5 : 0.5)) * $resolution / 10
  359. }
  360. if ($humidity != 0xFF) {
  361. $humidity = int($humidity * 10 / $resolution + ($humidity < 0 ? -0.5 : 0.5)) * $resolution / 10
  362. }
  363. if ($dewpoint) {
  364. $dewpoint = int($dewpoint * 10 / $resolution + ($dewpoint < 0 ? -0.5 : 0.5)) * $resolution / 10
  365. }
  366. readingsBeginUpdate($rhash);
  367. if ($typeNumber > 0) {
  368. readingsBulkUpdate($rhash, "error", $error ? "1" : "0");
  369. }
  370. readingsBulkUpdate($rhash, "battery", $battery_low ? "low" : "ok");
  371. # write temperature, humidity, ...
  372. if ($temperature != 0xFFFF) {
  373. readingsBulkUpdate($rhash, "temperature$channel", $temperature);
  374. }
  375. if ($humidity && $humidity <= 100) {
  376. readingsBulkUpdate($rhash, "humidity$channel", $humidity);
  377. }
  378. if ($dewpoint) {
  379. readingsBulkUpdate($rhash, "dewpoint$channel", $dewpoint);
  380. }
  381. # STATE
  382. if( !$channel ) {
  383. my $state = "T: ". $temperature;
  384. $state .= " H: ". ($humidity) if( $humidity && $humidity <= 99 );
  385. $state .= " D: $dewpoint" if( $dewpoint );
  386. readingsBulkUpdate($rhash, "state", $state) if( Value($rname) ne $state );
  387. }
  388. readingsEndUpdate($rhash,1);
  389. }
  390. else {
  391. $rhash->{"bufferedT"} = undef;
  392. $rhash->{"bufferedH"} = undef;
  393. }
  394. $rhash->{"previousT$channel"} = int($previousT*10 + 0.5) / 10;
  395. $rhash->{"previousH$channel"} = int($previousH*10 + 0.5) / 10;
  396. readingsBeginUpdate($rhash);
  397. if ($typeNumber > 0 && $windSpeed != 0xFFFF) {
  398. readingsBulkUpdate($rhash, "windSpeed", $windSpeed );
  399. }
  400. if ($typeNumber > 0 && $windGust != 0xFFFF) {
  401. readingsBulkUpdate($rhash, "windGust", $windGust );
  402. }
  403. if ($typeNumber > 0 && $rain != 0xFFFF) {
  404. if(!defined($rhash->{"previousR"}) || (defined($rhash->{"previousR"}) && abs($rhash->{"previousR"} - $rain) <= AttrVal( $rname, "filterThreshold", 10 ))){
  405. readingsBulkUpdate($rhash, "rain", $rain );
  406. }
  407. $rhash->{"previousR"} = $rain;
  408. }
  409. if ($typeNumber > 0 && $windDirection != 0xFFFF) {
  410. readingsBulkUpdate($rhash, "windDirectionDegree", $windDirection );
  411. my $windDirectionText = "---";
  412. if ($windDirection >= 0 && $windDirection <= 11.2) { $windDirectionText = "N"; }
  413. elsif ($windDirection > 11.2 && $windDirection <= 33.7) { $windDirectionText = "NNE"; }
  414. elsif ($windDirection > 33.7 && $windDirection <= 56.2) { $windDirectionText = "NE"; }
  415. elsif ($windDirection > 56.2 && $windDirection <= 78.7) { $windDirectionText = "ENE"; }
  416. elsif ($windDirection > 78.7 && $windDirection <= 101.2) { $windDirectionText = "E"; }
  417. elsif ($windDirection > 101.2 && $windDirection <= 123.7) { $windDirectionText = "ESE"; }
  418. elsif ($windDirection > 123.7 && $windDirection <= 146.2) { $windDirectionText = "SE"; }
  419. elsif ($windDirection > 146.2 && $windDirection <= 168.7) { $windDirectionText = "SSE"; }
  420. elsif ($windDirection > 168.7 && $windDirection <= 191.2) { $windDirectionText = "S"; }
  421. elsif ($windDirection > 191.2 && $windDirection <= 213.7) { $windDirectionText = "SSW"; }
  422. elsif ($windDirection > 213.7 && $windDirection <= 236.2) { $windDirectionText = "SW"; }
  423. elsif ($windDirection > 236.2 && $windDirection <= 258.7) { $windDirectionText = "WSW"; }
  424. elsif ($windDirection > 258.7 && $windDirection <= 281.2) { $windDirectionText = "W"; }
  425. elsif ($windDirection > 281.2 && $windDirection <= 303.7) { $windDirectionText = "WNW"; }
  426. elsif ($windDirection > 303.7 && $windDirection <= 326.2) { $windDirectionText = "NW"; }
  427. elsif ($windDirection > 326.2 && $windDirection <= 348.7) { $windDirectionText = "NNW"; };
  428. readingsBulkUpdate($rhash, "windDirectionText", $windDirectionText );
  429. }
  430. if ($typeNumber > 0 && $pressure != 0xFFFF) {
  431. readingsBulkUpdate($rhash, "pressure", $pressure );
  432. }
  433. if ($typeNumber > 0 && $gas != 0xFFFFFF) {
  434. readingsBulkUpdate($rhash, "gas", $gas );
  435. }
  436. if ($typeNumber > 0 && $debug != 0xFFFFFF) {
  437. readingsBulkUpdate($rhash, "debug", $debug );
  438. }
  439. readingsEndUpdate($rhash,1);
  440. }
  441. return @list;
  442. }
  443. 1;
  444. =pod
  445. =item summary LaCrosse Temperature and Humidity sensors
  446. =item summary_DE LaCrosse Temperature und Luftfeuchtigkeitssensoren
  447. =begin html
  448. <a name="LaCrosse"></a>
  449. <h3>LaCrosse</h3>
  450. <ul>
  451. FHEM module for LaCrosse Temperature and Humidity sensors and weather stations like WS 1600 (TX22 sensor).<br><br>
  452. It can be integrated in to FHEM via a <a href="#JeeLink">JeeLink</a> as the IODevice.<br><br>
  453. The JeeNode sketch required for this module can be found in .../contrib/36_LaCrosse-pcaSerial.zip.<br><br>
  454. <a name="LaCrosseDefine"></a>
  455. <b>Define</b>
  456. <ul>
  457. <code>define &lt;name&gt; LaCrosse &lt;addr&gt; [corr1...corr2]</code> <br>
  458. <br>
  459. addr is a 2 digit hex number to identify the LaCrosse device.<br>
  460. 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>
  461. Note: devices are autocreated only if LaCrossePairForSec is active for the <a href="#JeeLink">JeeLink</a> IODevice device.<br>
  462. </ul>
  463. <br>
  464. <a name="LaCrosse_Set"></a>
  465. <b>Set</b>
  466. <ul>
  467. <li>replaceBatteryForSec &lt;sec&gt; [ignore_battery]<br>
  468. sets the device for &lt;sec&gt; seconds into replace battery mode. the first unknown address that is
  469. received will replace the current device address. this can be partly automated with a readings group configured
  470. to show the battery state of all LaCrosse devices and a link/command to set replaceBatteryForSec on klick.
  471. </li>
  472. </ul><br>
  473. <a name="LaCrosse_Get"></a>
  474. <b>Get</b>
  475. <ul>
  476. </ul><br>
  477. <a name="LaCrosse_Readings"></a>
  478. <b>Readings</b>
  479. <ul>
  480. <li>battery[]<br>
  481. ok or low</li>
  482. <li>temperature (°C)<br>
  483. Notice: see the filterThreshold attribute.</li>
  484. <li>humidity (%rH)</li>
  485. <li>Wind speed (m/s), gust (m/s) and direction (degree)</li>
  486. <li>Rain (mm)</li>
  487. </ul><br>
  488. <a name="LaCrosse_Attr"></a>
  489. <b>Attributes</b>
  490. <ul>
  491. <li>doAverage<br>
  492. use an average of the last 4 values for temperature and humidity readings</li>
  493. <li>doDewpoint<br>
  494. calculate dewpoint</li>
  495. <li>filterThreshold<br>
  496. if the difference between the current and previous temperature is greater than filterThreshold degrees
  497. the readings for this channel are not updated. the default is 10.</li>
  498. <li>resolution<br>
  499. the resolution in 1/10 degree for the temperature reading</li>
  500. <li>ignore<br>
  501. 1 -> ignore this device.</li>
  502. </ul><br>
  503. <b>Logging and autocreate</b><br>
  504. <ul>
  505. <li>If autocreate is not active (not defined or disabled) and LaCrosse is not contained in the ignoreTypes attribute of autocreate then
  506. 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>
  507. <li>The autocreateThreshold attribute of the autocreate module (see <a href="#autocreate">autocreate</a>) is respected. The default is 2:120, means, that
  508. autocreate will create a device for a sensor only, if the sensor was received at least two times within two minutes.</li>
  509. </ul>
  510. </ul>
  511. =end html
  512. =cut