52_I2C_HDC1008.pm 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701
  1. # Modul für I2C Temperatur- und Feuchtigkeitssensor HDC1008
  2. # Autor : Karsten Grüttner
  3. # $Id: 52_I2C_HDC1008.pm 11595 2016-06-02 14:54:51Z schlawiano $
  4. # Technische Dokumention für den Sensor befindet sich http://www.ti.com/lit/ds/symlink/hdc1008.pdf
  5. package main;
  6. use strict;
  7. use warnings;
  8. # Konfigurationsparameter Temperatur, Lesedauer in Microsekunden und Konfigurationscode als Word (Bit 10)
  9. my %I2C_HDC1008_tempParams =
  10. (
  11. '11Bit' => {delay => 3650, code => 1 << 10 },
  12. '14Bit' => {delay => 6350, code => 0 }
  13. );
  14. # Konfigurationsparameter Feuchtigkeit, Lesedauer in Microsekunden und Konfigurationscode als Word (Bit 9:8)
  15. my %I2C_HDC1008_humParams = #
  16. (
  17. '8Bit' => {delay => 2500, code => 1 << 9 },
  18. '11Bit' => {delay => 3850, code => 1 << 8 } ,
  19. '14Bit' => {delay => 6500, code => 0 }
  20. );
  21. # Konfigurationsparameter Heizelement, Konfigurationscode als Word (Bit 13 )
  22. my %I2C_HDC1008_validsHeater =
  23. (
  24. 'off' => 0, # 0
  25. 'on' => 1 << 13 # 1
  26. );
  27. sub I2C_HDC1008_Initialize($) {
  28. my ($hash) = @_;
  29. $hash->{DefFn} = 'I2C_HDC1008_Define';
  30. $hash->{UndefFn} = 'I2C_HDC1008_Undef';
  31. $hash->{SetFn} = 'I2C_HDC1008_Set';
  32. $hash->{AttrFn} = 'I2C_HDC1008_Attr';
  33. $hash->{ReadFn} = 'I2C_HDC1008_Read';
  34. $hash->{I2CRecFn} = 'I2C_HDC1008_I2CRec';
  35. $hash->{AttrList} =
  36. "interval ".
  37. "IODev ".
  38. "Resolution_Temperature:11Bit,14Bit ". # als Dropdown
  39. "Resolution_Humidity:8Bit,11Bit,14Bit ". # als Dropdown
  40. "roundTemperatureDecimal ".
  41. "roundHumidityDecimal ".
  42. $readingFnAttributes;
  43. }
  44. sub I2C_HDC1008_Define($$) {
  45. my ($hash, $def) = @_;
  46. my @a = split('[ \t][ \t]*', $def);
  47. $hash->{MODUL_STATE} = "defined";
  48. $hash->{RESOLUTION_TEMPERATURE} = '14Bit';
  49. $hash->{RESOLUTION_HUMIDITY} = '14Bit';
  50. $hash->{HEATER} = 'off';
  51. $hash->{INTERVAL} = 0;
  52. $hash->{DEVICE_STATE} = 'UNKNOWN';
  53. if ($main::init_done) {
  54. eval { I2C_HDC1008_Init( $hash, [ @a[ 2 .. scalar(@a) - 1 ] ] ); };
  55. return I2C_HDC1008_Catch($@) if $@;
  56. }
  57. else
  58. {
  59. Log3 $hash, 5, "[$hash->{NAME}] I2C_HDC1008_Define main::init_done was false";
  60. }
  61. return undef;
  62. }
  63. sub I2C_HDC1008_Init($$) {
  64. my ( $hash, $args ) = @_;
  65. my $name = $hash->{NAME};
  66. if (defined $args && int(@$args) > 1)
  67. {
  68. return "Define: Wrong syntax. Usage:\n" .
  69. "define <name> I2C_HDC1008 [<i2caddress>]";
  70. }
  71. if (defined (my $address = shift @$args))
  72. {
  73. $address = $address =~ /^0.*$/ ? oct($address) : $address;
  74. if ($address < 64 && $address > 67) # nur 0x40 bis 0x43 erlaubt
  75. {
  76. Log3 $hash, 5, "[$name] I2C Address not valid for HDC1008";
  77. return "$name I2C Address not valid for HDC1008";
  78. }
  79. else
  80. {
  81. $hash->{I2C_Address} = $address;
  82. }
  83. }
  84. else
  85. {
  86. $hash->{I2C_Address} = oct('0x40');
  87. Log3 $name, 5, "[$name] I2C_HDC1008_Init default-I2C-addresse 0x40 used";
  88. }
  89. my $msg = '';
  90. $msg = CommandAttr(undef, $name . ' interval 5');
  91. if ($msg) {
  92. Log3 $hash, 5, "[$name] I2C_HDC1008_Init interval:".$msg;
  93. return $msg;
  94. }
  95. AssignIoPort($hash);
  96. if (defined AttrVal($hash->{NAME}, "IODev", undef))
  97. {
  98. $hash->{MODUL_STATE} = 'Initialized';
  99. $hash->{DEVICE_STATE} = 'READY';
  100. }
  101. else
  102. {
  103. $hash->{MODUL_STATE} = "Error: Missing Attr 'IODev'";
  104. }
  105. return undef;
  106. }
  107. sub I2C_HDC1008_Catch($) {
  108. my $exception = shift;
  109. if ($exception) {
  110. $exception =~ /^(.*)( at.*FHEM.*)$/;
  111. return $1;
  112. }
  113. return undef;
  114. }
  115. sub I2C_HDC1008_I2CRec ($$) {
  116. my ($hash, $clientmsg) = @_;
  117. my $name = $hash->{NAME};
  118. my $phash = $hash->{IODev};
  119. my $pname = $phash->{NAME};
  120. while ( my ( $k, $v ) = each %$clientmsg )
  121. {
  122. #erzeugen von Internals fuer alle Keys in $clientmsg die mit dem physical Namen beginnen
  123. my $upper_k = uc $k;
  124. $hash->{$upper_k} = $v if $k =~ /^$pname/ ;
  125. }
  126. if ($clientmsg->{direction} && $clientmsg->{type} && $clientmsg->{$pname . "_SENDSTAT"} && $clientmsg->{$pname . "_SENDSTAT"} eq "Ok") {
  127. if ( $clientmsg->{direction} eq "i2cread" && defined($clientmsg->{received}) )
  128. {
  129. Log3 $hash, 5, "[$name] I2C_HDC1008_I2CRec received: $clientmsg->{type} $clientmsg->{received}";
  130. I2C_HDC1008_GetTemp ($hash, $clientmsg->{received}) if $clientmsg->{type} eq "temp" && $clientmsg->{nbyte} == 2;
  131. I2C_HDC1008_GetHum ($hash, $clientmsg->{received}) if $clientmsg->{type} eq "hum" && $clientmsg->{nbyte} == 2;
  132. }
  133. }
  134. }
  135. sub I2C_HDC1008_GetTemp ($$)
  136. {
  137. my ($hash, $rawdata) = @_;
  138. my $name = $hash->{NAME};
  139. my @raw = split(" ",$rawdata);
  140. my $tempWord = ($raw[0] << 8 | $raw[1]);
  141. my $temperature = (($tempWord /65536.0)*165.0)-40.0;
  142. Log3 $hash, 5, "[$name] I2C_HDC1008_I2CRec calced Temperatur: $temperature";
  143. $temperature = sprintf( '%.' . AttrVal($hash->{NAME}, 'roundTemperatureDecimal', 1) . 'f', $temperature );
  144. readingsSingleUpdate($hash, "temperature", $temperature, 0);
  145. }
  146. sub I2C_HDC1008_GetHum ($$)
  147. {
  148. my ($hash, $rawdata) = @_;
  149. my $name = $hash->{NAME};
  150. my @raw = split(" ",$rawdata);
  151. my $humWord = ($raw[0] << 8 | $raw[1]);
  152. my $humidity = ($humWord /65536.0)*100.0;
  153. Log3 $hash, 5, "[$name] I2C_HDC1008_I2CRec calced humidity: $humidity";
  154. my $temperature = ReadingsVal($hash->{NAME} ,"temperature","0");
  155. $humidity = sprintf( '%.' . AttrVal($hash->{NAME}, 'roundHumidityDecimal', 1) . 'f', $humidity );
  156. readingsBeginUpdate($hash);
  157. readingsBulkUpdate($hash, 'humidity', $humidity);
  158. readingsBulkUpdate($hash, 'temperature', $temperature);
  159. readingsBulkUpdate(
  160. $hash,
  161. 'state',
  162. 'T: ' . $temperature . ' H: ' . $humidity
  163. );
  164. readingsEndUpdate($hash, 1);
  165. }
  166. sub I2C_HDC1008_Undef($$)
  167. {
  168. my ($hash, $name) = @_;
  169. if ( defined (AttrVal($hash->{NAME}, "interval", undef)) )
  170. {
  171. RemoveInternalTimer($hash);
  172. }
  173. return undef;
  174. }
  175. sub I2C_HDC1008_Reset($)
  176. {
  177. my ($hash) = @_;
  178. my $name = $hash->{NAME};
  179. if ($hash->{MODUL_STATE} ne 'Initialized') { return "Error MODULE_STATE in $name is not 'Initialized' " };
  180. return "$name: no IO device defined" unless ($hash->{IODev});
  181. my $Param = 1 << 15; # Bit 15 für Reset
  182. my $low_byte = $Param & 0xff;
  183. my $high_byte = ($Param & 0xff00) >> 8;
  184. my $iodev = $hash->{IODev};
  185. my $i2caddress = $hash->{I2C_Address};
  186. CallFn($iodev->{NAME}, "I2CWrtFn", $iodev, {
  187. direction => "i2cwrite",
  188. i2caddress => $i2caddress,
  189. reg => 2,
  190. data => $high_byte. " ".$low_byte
  191. });
  192. RemoveInternalTimer($hash);
  193. $hash->{DEVICE_STATE} ='READY';
  194. InternalTimer(gettimeofday() + 15.0/1000, 'I2C_HDC1008_Poll', $hash, 0); # Sensor braucht bis 15 ms bis er bereit ist
  195. }
  196. # Funktion holt die Werte vom Sensor via I2C
  197. # asynchrones Lesen, über Status-Wechsel in $hash->{DEVICE_STATE} und Rückgabe der notwendigen Dauer des aktuellen Schritts in Sekunden,
  198. # die dann an den Timer gegeben wird. Der schaut nach Ablauf der Zeit hier wieder vorbei und weiß als nächstes zu tun ist,
  199. # andere Prozesse werden dabei nicht mehr blockiert.
  200. sub I2C_HDC1008_UpdateValues($)
  201. {
  202. my ($hash) = @_;
  203. my $name = $hash->{NAME};
  204. if ($hash->{MODUL_STATE} ne 'Initialized') { return "Error MODULE_STATE in $name is not 'Initialized' " };
  205. return "$name: no IO device defined" unless ($hash->{IODev});
  206. Log3 $name, 5, "[$name] I2C_HDC1008_UpdateValues starts with state: $hash->{DEVICE_STATE}";
  207. # baue Konfigurationsparameter zusammen
  208. my $modeReading = 1 << 12; # lies beides gleichzeitig
  209. my $resTempIndex = $hash->{RESOLUTION_TEMPERATURE};
  210. my $resHumIndex = $hash->{RESOLUTION_HUMIDITY};
  211. my $heaterIndex = $hash->{HEATER};
  212. my $resTempParam = $I2C_HDC1008_tempParams{$resTempIndex}{code};
  213. my $resHumParam = $I2C_HDC1008_humParams{$resHumIndex}{code};
  214. my $heaterParam = $I2C_HDC1008_validsHeater{$heaterIndex};
  215. my $iodev = $hash->{IODev};
  216. my $i2caddress = $hash->{I2C_Address};
  217. if ($hash->{DEVICE_STATE} eq 'READY')
  218. {
  219. my $Param = $modeReading | $resTempParam | $resHumParam | $heaterParam;
  220. # schicke Konfiguration zum HDC1008-Sensor
  221. # --------------------------------------------------------
  222. my $low_byte = $Param & 0xff;
  223. my $high_byte = ($Param & 0xff00) >> 8;
  224. CallFn($iodev->{NAME}, "I2CWrtFn", $iodev, {
  225. direction => "i2cwrite",
  226. i2caddress => $i2caddress,
  227. reg => 2,
  228. data => $high_byte. " ".$low_byte # Leider fehlt es hier an Doku. Laut Quellcode (00_RPII2C.pm, ab Zeile 369), werden die dezimale Zahlen durch Leerzeichen getrennt, binär gewandelt und zum I2C-Bus geschickt
  229. });
  230. $hash->{DEVICE_STATE} = 'CONFIGURING';
  231. return 15.0/1000; # Sensor braucht bis 15 ms bis er bereit ist
  232. }
  233. elsif($hash->{DEVICE_STATE} eq 'CONFIGURING')
  234. {
  235. # HDC1008-Sensor soll Temperatur messen
  236. # --------------------------------------------------------
  237. CallFn($iodev->{NAME}, "I2CWrtFn", $iodev, {
  238. direction => "i2cwrite",
  239. i2caddress => $i2caddress,
  240. data => (0)
  241. });
  242. $hash->{DEVICE_STATE} = 'MEASURING_TEMPERATURE';
  243. my $tempWait = $I2C_HDC1008_tempParams{$resTempIndex}{delay}; # in ns
  244. return $tempWait/1000000.0;
  245. }
  246. elsif($hash->{DEVICE_STATE} eq 'MEASURING_TEMPERATURE')
  247. {
  248. # Temperatur vom HDC1008-Sensor lesen
  249. # --------------------------------------------------------
  250. CallFn($iodev->{NAME}, "I2CWrtFn", $iodev, { # Leider fehlt es hier an Doku. daher hier der Hinweis bei erfolgreichem Lesen wird die Funktion in $hash->{I2CRecFn} aufgerufen
  251. direction => "i2cread",
  252. i2caddress => $i2caddress,
  253. type => "temp",
  254. nbyte => 2
  255. });
  256. # HDC1008-Sensor soll Feuchtigkeit messen
  257. # --------------------------------------------------------
  258. CallFn($iodev->{NAME}, "I2CWrtFn", $iodev, {
  259. direction => "i2cwrite",
  260. i2caddress => $i2caddress,
  261. data => 1
  262. });
  263. $hash->{DEVICE_STATE} = 'MEASURING_HUMIDITY';
  264. my $humWait = $I2C_HDC1008_humParams{$resTempIndex}{delay};
  265. return $humWait/1000000.0;
  266. }
  267. elsif($hash->{DEVICE_STATE} eq 'MEASURING_HUMIDITY')
  268. {
  269. # lese Feuchtigkeit vom HDC1008-Sensor
  270. # --------------------------------------------------------
  271. CallFn($iodev->{NAME}, "I2CWrtFn", $iodev, {
  272. direction => "i2cread",
  273. i2caddress => $i2caddress,
  274. type => "hum",
  275. nbyte => 2
  276. });
  277. # fertig
  278. $hash->{DEVICE_STATE} = 'READY';
  279. my $pollInterval = AttrVal($hash->{NAME}, 'interval', 0);
  280. return $pollInterval * 60; # Pollintervall in Minuten
  281. }
  282. else
  283. {
  284. Log3 $name, 5, "[$name] I2C_HDC1008_UpdateValues wtf... whats wrong !!!!!!!!!!!!!!";
  285. $hash->{DEVICE_STATE} = 'READY';
  286. my $pollInterval = AttrVal($hash->{NAME}, 'interval', 0);
  287. return $pollInterval * 60; # Pollintervall in Minuten
  288. }
  289. }
  290. # set wenn Befehl gesetzt wurde und nicht '?' ist,
  291. # dann führe Befehl aus und gib den Status zurück
  292. # ansonsten gib alle Befehle und deren Optionen zurück
  293. sub I2C_HDC1008_Set($@) {
  294. my ($hash, @param) = @_;
  295. return '"set HDC1008" needs at least one argument' if (int(@param) < 2);
  296. my $name = shift @param;
  297. my $cmd = shift @param;
  298. my $val = join("", @param);
  299. if (defined $cmd && $cmd ne '?') # falls set mit Kommand aufgerufen wurde
  300. {
  301. if ($cmd eq 'Heater')
  302. {
  303. if ( defined($I2C_HDC1008_validsHeater{$val}) )
  304. {
  305. $hash->{HEATER} = $val;
  306. return undef;
  307. }
  308. else
  309. {
  310. return "Invalid value for setting 'Heater'";
  311. }
  312. }
  313. elsif ($cmd eq 'Update')
  314. {
  315. RemoveInternalTimer($hash);
  316. $hash->{DEVICE_STATE} ='READY';
  317. I2C_HDC1008_Poll($hash);
  318. return undef;
  319. }
  320. elsif ($cmd eq 'Reset')
  321. {
  322. I2C_HDC1008_Reset($hash);
  323. return undef;
  324. }
  325. # Debug("Set HDC1008 $cmd");
  326. return -1;
  327. }
  328. else # Ansonsten Rückgabe was an set - Optionen möglich ist
  329. {
  330. return "Update:noArg Heater:off,on Reset:noArg ";
  331. }
  332. }
  333. sub I2C_HDC1008_CheckState
  334. {
  335. my ($hash) = @_;
  336. if ($hash->{MODUL_STATE} ne 'Initialized')
  337. {
  338. my @def = split (' ',$hash->{DEF});
  339. I2C_HDC1008_Init($hash,\@def) if (defined ($hash->{IODev}));
  340. }
  341. }
  342. sub I2C_HDC1008_Poll
  343. {
  344. my ($hash) = @_;
  345. I2C_HDC1008_CheckState($hash);
  346. my $name = $hash->{NAME};
  347. my $delay = I2C_HDC1008_UpdateValues($hash);
  348. my $ret = I2C_HDC1008_Catch($@) if $@;
  349. if ($delay > 0)
  350. {
  351. Log3 $hash, 5, "[$name] I2C_HDC1008_Poll call InternalTimer with $delay seconds";
  352. InternalTimer(gettimeofday() + $delay, 'I2C_HDC1008_Poll', $hash, 0);
  353. }
  354. else
  355. {
  356. Log3 $name, 5, "[$name] I2C_HDC1008_Poll dont call InternalTimer, nothing todo";
  357. }
  358. return;
  359. }
  360. sub I2C_HDC1008_Attr(@)
  361. {
  362. my ($command, $name, $attr, $val) = @_;
  363. my $hash = $defs{$name};
  364. my $msg = '';
  365. if ($attr eq 'interval')
  366. {
  367. if ( defined($val) )
  368. {
  369. if ( looks_like_number($val) && $val > 0)
  370. {
  371. RemoveInternalTimer($hash);
  372. $hash->{DEVICE_STATE} = 'READY';
  373. InternalTimer(1, 'I2C_HDC1008_Poll', $hash, 0);
  374. $hash->{INTERVAL} = $val;
  375. Log3 $hash, 5, "[$hash->{NAME}] I2C_HDC1008_Attr call InternalTimer with new value $val ";
  376. } else
  377. {
  378. $msg .= "$hash->{NAME}: Wrong poll intervall defined. interval must be a number > 0";
  379. Log3 $hash, 5, "[$hash->{NAME}] I2C_HDC1008_Attr Wrong poll intervall defined. interval must be a number > 0";
  380. $hash->{INTERVAL} = 0;
  381. }
  382. }
  383. else
  384. { #wird auch aufgerufen wenn $val leer ist, aber der attribut wert wird auf 1 gesetzt
  385. RemoveInternalTimer($hash);
  386. $hash->{INTERVAL} = 0;
  387. }
  388. }
  389. elsif ($attr eq 'Resolution_Temperature')
  390. {
  391. if (!defined($val))
  392. {
  393. $hash->{RESOLUTION_TEMPERATURE} = '14Bit';
  394. }
  395. elsif ( defined($I2C_HDC1008_tempParams{$val}{code}) )
  396. {
  397. $hash->{RESOLUTION_TEMPERATURE} = $val;
  398. }
  399. else
  400. {
  401. $msg .= "invalid value for attribute $attr";
  402. }
  403. }
  404. elsif ($attr eq 'Resolution_Humidity')
  405. {
  406. if (!defined($val))
  407. {
  408. $hash->{RESOLUTION_HUMIDITY} = '14Bit';
  409. }
  410. elsif ( defined($I2C_HDC1008_humParams{$val}{code}) )
  411. {
  412. $hash->{RESOLUTION_HUMIDITY} = $val;
  413. }
  414. else
  415. {
  416. $msg .= "invalid value for attribute $attr";
  417. }
  418. }
  419. elsif ($command && $command eq "set" && $attr && $attr eq "IODev")
  420. {
  421. if ($main::init_done and (!defined ($hash->{IODev}) or $hash->{IODev}->{NAME} ne $val))
  422. {
  423. main::AssignIoPort($hash,$val);
  424. my @def = split (' ',$hash->{DEF});
  425. I2C_HDC1008_Init($hash,\@def) if (defined ($hash->{IODev}));
  426. }
  427. }
  428. elsif ( ($attr eq 'roundTemperatureDecimal') || ($attr eq 'roundHumidityDecimal'))
  429. {
  430. if (!defined($val))
  431. {
  432. return undef;
  433. }
  434. elsif (!(looks_like_number($val) && ($val>=0 )))
  435. {
  436. $msg .= "$attr must be a number >= 0"
  437. }
  438. }
  439. return ($msg) ? $msg : undef;
  440. }
  441. 1;
  442. =pod
  443. =begin html
  444. <a name="I2C_HDC1008"></a>
  445. <h3>I2C_HDC1008</h3>
  446. <ul>
  447. <a name="I2C_HDC1008"></a>
  448. Provides an interface to the I2C_HDC1008 I2C Humidity sensor from <a href=" http://www.ti.com">Texas Instruments</a>.
  449. The I2C messages are send through an I2C interface module like <a href="#RPII2C">RPII2C</a>, <a href="#FRM">FRM</a>
  450. or <a href="#NetzerI2C">NetzerI2C</a> so this device must be defined first.<br>
  451. <b>attribute IODev must be set</b><br>
  452. <a name="I2C_HDC1008Define"></a><br>
  453. <b>Define</b>
  454. <ul>
  455. <code>define &lt;name&gt; I2C_HDC1008 [&lt;I2C Address&gt;]</code><br>
  456. where <code>&lt;I2C Address&gt;</code> is an 2 digit hexadecimal value<br>
  457. </ul>
  458. <a name="I2C_HDC1008Set"></a>
  459. <b>Set</b>
  460. <ul>
  461. <code>set &lt;name&gt; Update</code><br>
  462. Reads the current temperature and humidity values from sensor.<br><br>
  463. <code>set &lt;name&gt; Reset</code><br>
  464. Resets the sensor
  465. <code>set &lt;name&gt; Heater {on|off}</code><br>
  466. turns the sensor heater on or off
  467. </ul>
  468. <a name="I2C_HDC1008Attr"></a>
  469. <b>Attributes</b>
  470. <ul>
  471. <li>interval<br>
  472. Set the polling interval in minutes to query data from sensor<br>
  473. Default: 5, valid values: 1,2,5,10,20,30<br><br>
  474. </li>
  475. <li>Resolution_Temperature<br>
  476. resolution for measurement temperature.<br>
  477. Standard: 14Bit, valid values: 11Bit, 14Bit<br><br>
  478. </li>
  479. <li>Resolution_Humidity<br>
  480. resolution for measurement humidity.<br>
  481. Standard: 14Bit, valid values: 8Bit, 11Bit, 14Bit<br><br>
  482. </li>
  483. <li>roundHumidityDecimal<br>
  484. Number of decimal places for humidity value<br>
  485. Default: 1, valid values: 0 1 2,...<br><br>
  486. </li>
  487. <li>roundTemperatureDecimal<br>
  488. Number of decimal places for temperature value<br>
  489. Default: 1, valid values: 0,1,2,...<br><br>
  490. </li>
  491. <li><a href="#IODev">IODev</a></li>
  492. </ul><br>
  493. </ul>
  494. =end html
  495. =begin html_DE
  496. <a name="I2C_HDC1008"></a>
  497. <h3>I2C_HDC1008</h3>
  498. <ul>
  499. <a name="I2C_HDC1008"></a>
  500. Erm&ouml;glicht die Verwendung eines I2C_HDC1008 I2C Feuchtesensors von <a href=" http://www.ti.com">Texas Instruments</a>.
  501. I2C-Botschaften werden &uuml;ber ein I2C Interface Modul wie beispielsweise das <a href="#RPII2C">RPII2C</a>, <a href="#FRM">FRM</a>
  502. oder <a href="#NetzerI2C">NetzerI2C</a> gesendet. Daher muss dieses vorher definiert werden.<br>
  503. <b>Das Attribut IODev muss definiert sein.</b><br>
  504. <a name="I2C_HDC1008Define"></a><br>
  505. <b>Define</b>
  506. <ul>
  507. <code>define &lt;name&gt; I2C_HDC1008 [&lt;I2C Address&gt;]</code><br>
  508. Der Wert <code>&lt;I2C Address&gt;</code> ist ein zweistelliger Hex-Wert<br>
  509. </ul>
  510. <a name="I2C_HDC1008Set"></a>
  511. <b>Set</b>
  512. <ul>
  513. <code>set &lt;name&gt; Update</code><br>
  514. Aktuelle Temperatur und Feuchte Werte vom Sensor lesen.<br><br>
  515. <code>set &lt;name&gt; Reset</code><br>
  516. Setzt den Sensor zur&uuml;ck
  517. <code>set &lt;name&gt; Heater {on|off}</code><br>
  518. Schaltet das Heizelement des Sensors an oder aus
  519. </ul>
  520. <a name="I2C_HDC1008Attr"></a>
  521. <b>Attribute</b>
  522. <ul>
  523. <li>interval<br>
  524. Aktualisierungsintervall aller Werte in Minuten.<br>
  525. Standard: 5, g&uuml;ltige Werte: 1,2,5,10,20,30<br><br>
  526. </li>
  527. <li>Resolution_Temperature<br>
  528. Genauigkeit mit der die Temperatur gemessen werden soll.<br>
  529. Standard: 14Bit, g&uuml;ltige Werte: 11Bit, 14Bit<br><br>
  530. </li>
  531. <li>Resolution_Humidity<br>
  532. Genauigkeit mit der die Feuchtigkeit gemessen werden soll.<br>
  533. Standard: 14Bit, g&uuml;ltige Werte: 8Bit, 11Bit, 14Bit<br><br>
  534. </li>
  535. <li>roundHumidityDecimal<br>
  536. Anzahl Dezimalstellen f&uuml;r den Feuchtewert<br>
  537. Standard: 1, g&uuml;ltige Werte: 0 1 2<br><br>
  538. </li>
  539. <li>roundTemperatureDecimal<br>
  540. Anzahl Dezimalstellen f&uuml;r den Temperaturwert<br>
  541. Standard: 1, g&uuml;ltige Werte: 0,1,2<br><br>
  542. </li>
  543. <li><a href="#IODev">IODev</a></li>
  544. </ul><br>
  545. </ul>
  546. =end html
  547. =cut