AS_BH1750A.cpp 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705
  1. /*
  2. This is a (Arduino) library for the BH1750FVI Digital Light Sensor.
  3. Description:
  4. http://www.rohm.com/web/global/products/-/product/BH1750FVI
  5. Datasheet:
  6. http://rohmfs.rohm.com/en/products/databook/datasheet/ic/sensor/light/bh1750fvi-e.pdf
  7. Copyright (c) 2013 Alexander Schulz. All right reserved.
  8. This library is free software; you can redistribute it and/or
  9. modify it under the terms of the GNU Lesser General Public
  10. License as published by the Free Software Foundation; either
  11. version 2.1 of the License, or (at your option) any later version.
  12. This library is distributed in the hope that it will be useful,
  13. but WITHOUT ANY WARRANTY; without even the implied warranty of
  14. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  15. Lesser General Public License for more details.
  16. You should have received a copy of the GNU Lesser General Public
  17. License along with this library; if not, write to the Free Software
  18. Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
  19. */
  20. #include "AS_BH1750A.h"
  21. // Debug-Flag
  22. #define BH1750_DEBUG 0
  23. /**
  24. * Constructor.
  25. * Erlaubt die I2C-Adresse des Sensors zu ändern.
  26. * Standardadresse: 0x23, Alternativadresse: 0x5C.
  27. * Es sind entsprechende Konstanten definiert: BH1750_DEFAULT_I2CADDR und BH1750_SECOND_I2CADDR.
  28. * Bei Nichtangabe wird die Standardadresse verwendet.
  29. * Um die Alternativadresse zu nutzen, muss der Sensorpin 'ADR' des Chips auf VCC gelegt werden.
  30. */
  31. AS_BH1750A::AS_BH1750A(uint8_t address) {
  32. _address = address;
  33. _hardwareMode = 255;
  34. }
  35. /**
  36. * Führt die anfängliche Initialisierung des Sensors.
  37. * Mögliche Parameter:
  38. * - Modus für die Sensorauflösung:
  39. * -- RESOLUTION_LOW: Physische Sensormodus mit 4 lx Auflösung. Messzeit ca. 16ms. Bereich 0-54612.
  40. * -- RESOLUTION_NORMAL: Physische Sensormodus mit 1 lx Auflösung. Messzeit ca. 120ms. Bereich 0-54612.
  41. * -- RESOLUTION_HIGH: Physische Sensormodus mit 0,5 lx Auflösung. Messzeit ca. 120ms. Bereich 0-54612.
  42. * (Die Messbereiche können durch Änderung des MTreg verschoben werden.)
  43. * -- RESOLUTION_AUTO_HIGH: Die Werte im MTreg werden je nach Helligkeit automatisch so angepasst,
  44. * dass eine maximalmögliche Auflösung und Messbereich erziehlt werden.
  45. * Die messbaren Werte fangen von 0,11 lx und gehen bis über 100000 lx.
  46. * (ich weis nicht, wie genau die Werte in Grenzbereichen sind,
  47. * besonders bei hohen Werte habe ich da meine Zweifel.
  48. * Die Werte scheinen jedoch weitgehend linear mit der steigenden Helligkeit zu wachsen.)
  49. * Auflösung im Unteren Bereich ca. 0,13 lx, im mittleren 0,5 lx, im oberen etwa 1-2 lx.
  50. * Die Messzeiten verlängern sich durch mehrfache Messungen und
  51. * die Änderungen von Measurement Time (MTreg) bis max. ca. 500 ms.
  52. *
  53. * - AutoPowerDown: true = Der Sensor wird nach der Messung in den Stromsparmodus versetzt.
  54. * Das spätere Aufwecken wird ggf. automatisch vorgenommen, braucht jedoch geringfügig mehr Zeit.
  55. *
  56. * Defaultwerte: RESOLUTION_AUTO_HIGH, true
  57. *
  58. */
  59. bool AS_BH1750A::begin(sensors_resolution_t mode, bool autoPowerDown) {
  60. #if BH1750_DEBUG == 1
  61. Serial.print(" sensors_resolution_mode (virtual): ");
  62. Serial.println(mode, DEC);
  63. #endif
  64. _virtualMode = mode;
  65. _autoPowerDown = autoPowerDown;
  66. Wire.begin();
  67. defineMTReg(BH1750_MTREG_DEFAULT); // eigentlich normalerweise unnötig, da standard
  68. // Hardware-Modus zum gewünschten VitrualModus ermitteltn
  69. switch (_virtualMode) {
  70. case RESOLUTION_LOW:
  71. _hardwareMode = autoPowerDown?BH1750_ONE_TIME_LOW_RES_MODE:BH1750_CONTINUOUS_LOW_RES_MODE;
  72. break;
  73. case RESOLUTION_NORMAL:
  74. _hardwareMode = autoPowerDown?BH1750_ONE_TIME_HIGH_RES_MODE:BH1750_CONTINUOUS_HIGH_RES_MODE;
  75. break;
  76. case RESOLUTION_HIGH:
  77. _hardwareMode = autoPowerDown?BH1750_ONE_TIME_HIGH_RES_MODE_2:BH1750_CONTINUOUS_HIGH_RES_MODE_2;
  78. break;
  79. case RESOLUTION_AUTO_HIGH:
  80. _hardwareMode = BH1750_CONTINUOUS_LOW_RES_MODE;
  81. break;
  82. default:
  83. // darf eigentlich nicht passieren...
  84. _hardwareMode = 255;
  85. break;
  86. }
  87. #if BH1750_DEBUG == 1
  88. Serial.print("hardware mode: ");
  89. Serial.println(_hardwareMode, DEC);
  90. #endif
  91. if(_hardwareMode==255) {
  92. return false;
  93. }
  94. // Versuchen, den gewählten Hardwaremodus zu aktivieren
  95. if(selectResolutionMode(_hardwareMode)){
  96. #if BH1750_DEBUG == 1
  97. Serial.print("hardware mode defined successfully");
  98. Serial.println(_hardwareMode, DEC);
  99. #endif
  100. return true;
  101. }
  102. // Initialisierung fehlgeschlagen
  103. #if BH1750_DEBUG == 1
  104. Serial.print("failure to aktivate hardware mode ");
  105. Serial.println(_hardwareMode, DEC);
  106. #endif
  107. _hardwareMode = 255;
  108. return false;
  109. }
  110. /**
  111. * Erlaub eine Prüfung, ob ein (ansprechbarer) BH1750-Sensor vorhanden ist.
  112. */
  113. bool AS_BH1750A::isPresent() {
  114. // Check I2C Adresse
  115. Wire.beginTransmission(_address);
  116. if(Wire.endTransmission()!=0) {
  117. return false;
  118. }
  119. // Check device: ist es ein BH1750
  120. if(!isInitialized()) {
  121. // zuvor inaktiv, daher zu Testen schnelltes einmal-Mode aktivieren
  122. //write8(BH1750_POWER_ON);
  123. selectResolutionMode(BH1750_ONE_TIME_LOW_RES_MODE);
  124. delay(5);// Hier muss man in jedem Fall warten, daher die kurze Pause erstmal ok
  125. _hardwareMode=255;
  126. }
  127. else {
  128. // falls einmal-modus aktiv war, muss der Sensor geweckt werden
  129. powerOn();
  130. unsigned long dd = getModeDelay(); if(dd>0) {delay(dd);}
  131. //delay(getModeDelay()); // s.o.
  132. }
  133. // Prüfen, ob Werte auch wirklich geliefert werden (letztes Modus, ggf. wird auto-PowerDown ausgeführt)
  134. return (readLightLevel()>=0);
  135. }
  136. /**
  137. * Weckt ein im PowerDown-Modus befindlichen Sensor auf (schadet auch dem 'wachen' Sensor nicht).
  138. * Funktionier nur, wenn der Sensor bereits initialisiert wurde.
  139. */
  140. void AS_BH1750A::powerOn() {
  141. if(!isInitialized()) {
  142. #if BH1750_DEBUG == 1
  143. Serial.println("sensor not initialized");
  144. #endif
  145. return;
  146. }
  147. _valueReaded=false;
  148. //write8(BH1750_POWER_ON); //
  149. //fDelayPtr(10); // Nötig?
  150. // Scheinbar reicht das Setzen von HardwareMode auch ohne PowerON-Befehl aus
  151. selectResolutionMode(_hardwareMode); // letzten Modus wieder aktivieren
  152. }
  153. /**
  154. * Schickt den Sensor in Stromsparmodus.
  155. * Funktionier nur, wenn der Sensor bereits initialisiert wurde.
  156. */
  157. void AS_BH1750A::powerDown() {
  158. if(!isInitialized()) {
  159. #if BH1750_DEBUG == 1
  160. Serial.println("sensor not initialized");
  161. #endif
  162. return;
  163. }
  164. write8(BH1750_POWER_DOWN);
  165. }
  166. /**
  167. * Sendet zum Sensor ein Befehl zum Auswahl von HardwareMode.
  168. *
  169. * Parameter:
  170. * - mode: s.o.
  171. * - DelayFuncPtr: delay(n) Möglichkeit, eigene Delay-Funktion mitzugeben (z.B. um sleep-Modus zu verwenden).
  172. *
  173. * Defaultwerte: delay()
  174. *
  175. */
  176. bool AS_BH1750A::selectResolutionMode(uint8_t mode) {
  177. #if BH1750_DEBUG == 1
  178. Serial.print("selectResolutionMode: ");
  179. Serial.println(mode, DEC);
  180. #endif
  181. if(!isInitialized()) {
  182. return false;
  183. #if BH1750_DEBUG == 1
  184. Serial.println("sensor not initialized");
  185. #endif
  186. }
  187. _hardwareMode=mode;
  188. _valueReaded=false;
  189. // Prüfen, ob ein valides Modus vorliegt und im positiven Fall das gewünschte Modus aktivieren
  190. switch (mode) {
  191. case BH1750_CONTINUOUS_HIGH_RES_MODE:
  192. case BH1750_CONTINUOUS_HIGH_RES_MODE_2:
  193. case BH1750_CONTINUOUS_LOW_RES_MODE:
  194. case BH1750_ONE_TIME_HIGH_RES_MODE:
  195. case BH1750_ONE_TIME_HIGH_RES_MODE_2:
  196. case BH1750_ONE_TIME_LOW_RES_MODE:
  197. // Modus aktivieren
  198. if(write8(mode)) {
  199. // Kurze pause nötig, sonst wird das Modus nicht sicher Aktiviert
  200. // (z.B. liefert Sensor im AutoHigh Modus abwechselnd übersteuerte Werte, etwa so: 54612.5, 68123.4, 54612.5, 69345.3,..)
  201. //fDelayPtr(5); => Aufrufer soll 5ms extra warten
  202. return true;
  203. }
  204. break;
  205. default:
  206. // Invalid measurement mode
  207. #if BH1750_DEBUG == 1
  208. Serial.println("Invalid measurement mode");
  209. #endif
  210. break;
  211. }
  212. return false;
  213. }
  214. /**
  215. * Liefert aktuell gemessenen Wert für Helligkeit in lux (lx).
  216. * Falls sich der Sensorf in Stromsparmodus befindet, wird er automatisch geweckt.
  217. *
  218. * Wurde der Sensor (noch) nicht initialisiert (begin), wird der Wert -1 geliefert.
  219. */
  220. /*float AS_BH1750A::readLightLevel_alt(DelayFuncPtr fDelayPtr) {
  221. #if BH1750_DEBUG == 1
  222. Serial.print("call: readLightLevel. virtualMode: ");
  223. Serial.println(_virtualMode, DEC);
  224. #endif
  225. if(!isInitialized()) {
  226. #if BH1750_DEBUG == 1
  227. Serial.println("sensor not initialized");
  228. #endif
  229. return -1;
  230. }
  231. // ggf. PowerOn
  232. if(_autoPowerDown && _valueReaded){
  233. powerOn();
  234. unsigned long dd = getModeDelay(); if(dd>0) {delay(dd);}
  235. }
  236. // Das Automatische Modus benötigt eine Sonderbehandlung.
  237. // Zuerst wird die Helligkeit im LowRes-Modus gelesen,
  238. // je nach Bereich (dunkel, normal, sehr hell) werden die Werte von MTreg gesetzt und
  239. // danach wird die eigentliche Messung vorgenommen.
  240. // Die feste Grenzwerte verursachen möglicherweise einen 'Sprung' in der Messkurve.
  241. // In diesem Fall wäre eine laufende Anpassung von MTreg in Grenzbereichen vermutlich besser.
  242. // Für meine Zwecke ist das jedoch ohne Bedeutung.
  243. if(_virtualMode==RESOLUTION_AUTO_HIGH) {
  244. defineMTReg(BH1750_MTREG_DEFAULT);
  245. selectResolutionMode(BH1750_CONTINUOUS_LOW_RES_MODE);
  246. //fDelayPtr(16+5); // Lesezeit in LowResMode
  247. fDelayPtr(getModeDelay());
  248. uint16_t level = readRawLevel();
  249. #if BH1750_DEBUG == 1
  250. Serial.print("AutoHighMode: check level read: ");
  251. Serial.println(level, DEC);
  252. #endif
  253. if(level<10) {
  254. #if BH1750_DEBUG == 1
  255. Serial.println("level 0: dark");
  256. #endif
  257. // Dunkel, Empfindlichkeit auf Maximum.
  258. // Der Wert ist zufällig. Ab ca. 16000 wäre diese Vorgehnsweise möglich.
  259. // Ich brauche diese Genauigkeit aber nur in den ganz dunklen Bereichen (zu erkennen, wann wirklich 'dunkel' ist).
  260. defineMTReg(BH1750_MTREG_MAX);
  261. selectResolutionMode(_autoPowerDown?BH1750_ONE_TIME_HIGH_RES_MODE_2:BH1750_CONTINUOUS_HIGH_RES_MODE_2);
  262. //fDelayPtr(120*3.68+5); // TODO: Wert prüfen
  263. fDelayPtr(getModeDelay());
  264. //fDelayPtr(122);
  265. }
  266. else if(level<32767) {
  267. #if BH1750_DEBUG == 1
  268. Serial.println("level 1: normal");
  269. #endif
  270. // Bis hierher reicht die 0,5 lx Modus. Normale Empfindlichkeit.
  271. defineMTReg(BH1750_MTREG_DEFAULT);
  272. selectResolutionMode(_autoPowerDown?BH1750_ONE_TIME_HIGH_RES_MODE_2:BH1750_CONTINUOUS_HIGH_RES_MODE_2);
  273. //fDelayPtr(120+5); // TODO: Wert prüfen
  274. fDelayPtr(getModeDelay());
  275. }
  276. else if(level<60000) {
  277. #if BH1750_DEBUG == 1
  278. Serial.println("level 2: bright");
  279. #endif
  280. // hoher Bereich, 1 lx Modus, normale Empfindlichkeit. Der Wert von 60000 ist mehr oder weniger zufällig, es mus einfach ein hoher Wert, nah an der Grenze sein.
  281. defineMTReg(BH1750_MTREG_DEFAULT);
  282. selectResolutionMode(_autoPowerDown?BH1750_ONE_TIME_HIGH_RES_MODE:BH1750_CONTINUOUS_HIGH_RES_MODE);
  283. //fDelayPtr(120+5); // TODO: Wert prüfen
  284. fDelayPtr(getModeDelay());
  285. }
  286. else {
  287. #if BH1750_DEBUG == 1
  288. Serial.println("level 3: very bright");
  289. #endif
  290. // sehr hoher Bereich, Empfindlichkeit verringern
  291. defineMTReg(32); // Min+1, bei dem Minimum aus Doku spielt der Sensor (zumindest meiner) verrückt: Die Werte sind ca. 1/10 von den Erwarteten.
  292. selectResolutionMode(_autoPowerDown?BH1750_ONE_TIME_HIGH_RES_MODE:BH1750_CONTINUOUS_HIGH_RES_MODE);
  293. //fDelayPtr(120+5); // TODO: Wert prüfen
  294. fDelayPtr(getModeDelay());
  295. }
  296. }
  297. // Hardware Wert lesen und in Lux umrechnen.
  298. uint16_t raw = readRawLevel();
  299. if(raw==65535) {
  300. // Wert verdächtig hoch. Sensor prüfen.
  301. // Check I2C Adresse
  302. Wire.beginTransmission(_address);
  303. if(Wire.endTransmission()!=0) {
  304. return -1;
  305. }
  306. }
  307. return convertRawValue(raw);
  308. }*/
  309. /**
  310. * Roh-Wert der Helligkeit auslesen.
  311. * Wertebereich 0-65535.
  312. */
  313. uint16_t AS_BH1750A::readRawLevel(void) {
  314. uint16_t level;
  315. Wire.beginTransmission(_address);
  316. Wire.requestFrom(_address, 2);
  317. #if (ARDUINO >= 100)
  318. level = Wire.read();
  319. level <<= 8;
  320. level |= Wire.read();
  321. #else
  322. level = Wire.receive();
  323. level <<= 8;
  324. level |= Wire.receive();
  325. #endif
  326. if(Wire.endTransmission()!=0) {
  327. #if BH1750_DEBUG == 1
  328. Serial.println("I2C read error");
  329. #endif
  330. return 65535; // Error marker
  331. }
  332. #if BH1750_DEBUG == 1
  333. Serial.print("Raw light level: ");
  334. Serial.println(level);
  335. #endif
  336. _valueReaded=true;
  337. return level;
  338. }
  339. /**
  340. * Rechnet Roh-Werte in Lux um.
  341. */
  342. float AS_BH1750A::convertRawValue(uint16_t raw) {
  343. // Basisumrechnung
  344. float flevel = raw/1.2;
  345. #if BH1750_DEBUG == 1
  346. Serial.print("convert light level (1): ");
  347. Serial.println(flevel);
  348. #endif
  349. // MTreg-Einfluss berechnen
  350. if(_MTreg!=BH1750_MTREG_DEFAULT) { // bei 69 ist der Faktor = 1
  351. flevel = flevel * _MTregFactor;
  352. #if BH1750_DEBUG == 1
  353. Serial.print("convert light level (2): ");
  354. Serial.println(flevel);
  355. #endif
  356. }
  357. // je nach Modus ist eine weitere Umrechnung nötig
  358. switch (_hardwareMode) {
  359. case BH1750_CONTINUOUS_HIGH_RES_MODE_2:
  360. case BH1750_ONE_TIME_HIGH_RES_MODE_2:
  361. flevel = flevel/2;
  362. #if BH1750_DEBUG == 1
  363. Serial.print("convert light level (3): ");
  364. Serial.println(flevel);
  365. #endif
  366. break;
  367. default:
  368. // nothing to do
  369. break;
  370. }
  371. #if BH1750_DEBUG == 1
  372. Serial.print("Light level: ");
  373. Serial.println(flevel);
  374. #endif
  375. return flevel;
  376. }
  377. /**
  378. * MTreg setzen. Definiert Empfindlichkeit des Sensors.
  379. * Min.Wert (BH1750_MTREG_MIN) = 31 (Empfindlichkeit: default*0,45)
  380. * Max.Wert (BH1750_MTREG_MAX) = 254 (Empfindlichkeit: default*3,68)
  381. * Default (BH1750_MTREG_DEFAULT) = 69.
  382. * Mit der Empfindlichkeit verändert sich die Lesezeit (höhere Empfindlichkeit bedeutet längere Zeitspanne).
  383. */
  384. void AS_BH1750A::defineMTReg(uint8_t val) {
  385. if(val<BH1750_MTREG_MIN) {
  386. val = BH1750_MTREG_MIN;
  387. }
  388. if(val>BH1750_MTREG_MAX) {
  389. val = BH1750_MTREG_MAX;
  390. }
  391. if(val!=_MTreg) {
  392. _MTreg = val;
  393. _MTregFactor = (float)BH1750_MTREG_DEFAULT / _MTreg;
  394. // Change Measurement time
  395. // Übertragung in zwei Schritten: 3 Bit und 5 Bit, jeweils mit einem Prefix.
  396. // High bit: 01000_MT[7,6,5]
  397. // Low bit: 011_MT[4,3,2,1,0]
  398. uint8_t hiByte = val>>5;
  399. hiByte |= 0b01000000;
  400. #if BH1750_DEBUG == 1
  401. Serial.print("MGTreg high byte: ");
  402. Serial.println(hiByte, BIN);
  403. #endif
  404. write8(hiByte);
  405. //fDelayPtr(10);
  406. // Pause nötig?
  407. uint8_t loByte = val&0b00011111;
  408. loByte |= 0b01100000;
  409. #if BH1750_DEBUG == 1
  410. Serial.print("MGTreg low byte: ");
  411. Serial.println(loByte, BIN);
  412. #endif
  413. write8(hiByte);
  414. //fDelayPtr(10);
  415. }
  416. }
  417. /**
  418. * Gibt an, ob der Sensor initialisiert ist.
  419. */
  420. bool AS_BH1750A::isInitialized() {
  421. return _hardwareMode!=255;
  422. }
  423. /**
  424. * Schreibt ein Byte auf I2C Bus (auf die Adresse des Sensors).
  425. */
  426. bool AS_BH1750A::write8(uint8_t d) {
  427. Wire.beginTransmission(_address);
  428. #if (ARDUINO >= 100)
  429. Wire.write(d);
  430. #else
  431. Wire.send(d);
  432. #endif
  433. return (Wire.endTransmission()==0);
  434. }
  435. float AS_BH1750A::readLightLevel(DelayFuncPtr fDelayPtr, TimeFuncPtr fTimePtr) {
  436. startMeasurementAsync(fTimePtr);
  437. while(!isMeasurementReady()) {
  438. fDelayPtr(_nextDelay);
  439. }
  440. return readLightLevelAsync();
  441. }
  442. /*float AS_BH1750A::checkAndReadLightLevelAsync(TimeFuncPtr fTimePtr) {
  443. //Serial.print("--stage: ");
  444. //Serial.println(_stage);
  445. if(_stage==0 || _stage>=100) {
  446. if(startMeasurementAsync(fTimePtr)) return -100;
  447. return -1; // Marker "nicht vorhanden"
  448. } else if(_stage==99) {
  449. _stage=100;
  450. return readLightLevelAsync();
  451. }
  452. return readLightLevelAsync();
  453. }*/
  454. unsigned long AS_BH1750A::nextDelay(void) {
  455. return _nextDelay;
  456. }
  457. //void AS_BH1750A::reset(void) {
  458. //_stage==0;
  459. //}
  460. bool AS_BH1750A::startMeasurementAsync(TimeFuncPtr fTimePtr) {
  461. _fTimePtr = fTimePtr;
  462. _stage = 0;
  463. _nextDelay = 0;
  464. int _lastResult = -1;
  465. _lastTimestamp=fTimePtr();
  466. return readLightLevelAsync()!=-1;
  467. }
  468. bool AS_BH1750A::isMeasurementReady(void) {
  469. return readLightLevelAsync() >= -1; // -1 ist 'not initialized'-Marker (prevent hangs)
  470. }
  471. bool AS_BH1750A::delayExpired() {
  472. unsigned long timestamp = _fTimePtr();
  473. // Zeitdifferenz
  474. unsigned long delayTime = 0;
  475. // Auf Ueberlauf pruefen
  476. if (timestamp < _lastTimestamp)
  477. {
  478. // Ueberlauf: Delay ist Zeit zum MaxWert plus Zeit ab Null
  479. delayTime = MAX_U_LONG - _lastTimestamp + timestamp;
  480. } else {
  481. // Kein Ueberlauf: einfache Differenz
  482. delayTime = timestamp - _lastTimestamp;
  483. }
  484. return (delayTime >= _nextDelay);
  485. }
  486. float AS_BH1750A::readLightLevelAsync() {
  487. if(_stage>=99) return _lastResult;
  488. if(_stage==0) {
  489. #if BH1750_DEBUG == 1
  490. Serial.print("call: readLightLevel. virtualMode: ");
  491. Serial.println(_virtualMode, DEC);
  492. #endif
  493. if(!isInitialized()) {
  494. #if BH1750_DEBUG == 1
  495. Serial.println("sensor not initialized");
  496. #endif
  497. return -1;
  498. }
  499. // ggf. PowerOn
  500. if(_autoPowerDown && _valueReaded){
  501. powerOn();
  502. _nextDelay = getModeDelay();
  503. // TEST delay(getModeDelay());_stage=99;
  504. return -100;
  505. } else {
  506. _nextDelay = 0;
  507. }
  508. _stage++;
  509. }
  510. // Das Automatische Modus benötigt eine Sonderbehandlung.
  511. // Zuerst wird die Helligkeit im LowRes-Modus gelesen,
  512. // je nach Bereich (dunkel, normal, sehr hell) werden die Werte von MTreg gesetzt und
  513. // danach wird die eigentliche Messung vorgenommen.
  514. /*
  515. Die feste Grenzwerte verursachen möglicherweise einen 'Sprung' in der Messkurve.
  516. In diesem Fall wäre eine laufende Anpassung von MTreg in Grenzbereichen vermutlich besser.
  517. Für meine Zwecke ist das jedoch ohne Bedeutung.
  518. */
  519. if(_virtualMode==RESOLUTION_AUTO_HIGH) {
  520. selectAutoMode();
  521. } else {
  522. if(delayExpired()) {_stage=99;} // Fertig
  523. }
  524. if(_stage<99) return -100; // Marker: wait for next step
  525. // Hardware Wert lesen und in Lux umrechnen.
  526. uint16_t raw = readRawLevel();
  527. if(raw==65535) {
  528. // Wert verdächtig hoch. Sensor prüfen.
  529. // Check I2C Adresse
  530. Wire.beginTransmission(_address);
  531. if(Wire.endTransmission()!=0) {
  532. return -1;
  533. }
  534. }
  535. _lastResult = convertRawValue(raw);
  536. return _lastResult;
  537. }
  538. void AS_BH1750A::selectAutoMode() {
  539. //if(!delayExpired()) return;
  540. if(_stage==1) {
  541. defineMTReg(BH1750_MTREG_DEFAULT);
  542. selectResolutionMode(BH1750_CONTINUOUS_LOW_RES_MODE);
  543. //fDelayPtr(16+5); // Lesezeit in LowResMode
  544. //fDelayPtr(getModeDelay());
  545. _nextDelay=getModeDelay();
  546. _stage++;
  547. return;
  548. }
  549. if(!delayExpired()) return;
  550. if(_stage==2) {
  551. uint16_t level = readRawLevel();
  552. #if BH1750_DEBUG == 1
  553. Serial.print("AutoHighMode: check level read: ");
  554. Serial.println(level, DEC);
  555. #endif
  556. if(level<10) {
  557. #if BH1750_DEBUG == 1
  558. Serial.println("level 0: dark");
  559. #endif
  560. // Dunkel, Empfindlichkeit auf Maximum.
  561. // Der Wert ist zufällig. Ab ca. 16000 wäre diese Vorgehnsweise möglich.
  562. // Ich brauche diese Genauigkeit aber nur in den ganz dunklen Bereichen (zu erkennen, wann wirklich 'dunkel' ist).
  563. defineMTReg(BH1750_MTREG_MAX);
  564. selectResolutionMode(_autoPowerDown?BH1750_ONE_TIME_HIGH_RES_MODE_2:BH1750_CONTINUOUS_HIGH_RES_MODE_2);
  565. //fDelayPtr(120*3.68+5); // TODO: Wert prüfen
  566. //fDelayPtr(getModeDelay());
  567. _nextDelay=getModeDelay();
  568. //fDelayPtr(122);
  569. } else if(level<32767) {
  570. #if BH1750_DEBUG == 1
  571. Serial.println("level 1: normal");
  572. #endif
  573. // Bis hierher reicht die 0,5 lx Modus. Normale Empfindlichkeit.
  574. defineMTReg(BH1750_MTREG_DEFAULT);
  575. selectResolutionMode(_autoPowerDown?BH1750_ONE_TIME_HIGH_RES_MODE_2:BH1750_CONTINUOUS_HIGH_RES_MODE_2);
  576. //fDelayPtr(120+5); // TODO: Wert prüfen
  577. //fDelayPtr(getModeDelay());
  578. _nextDelay=getModeDelay();
  579. } else if(level<60000) {
  580. #if BH1750_DEBUG == 1
  581. Serial.println("level 2: bright");
  582. #endif
  583. // hoher Bereich, 1 lx Modus, normale Empfindlichkeit. Der Wert von 60000 ist mehr oder weniger zufällig, es mus einfach ein hoher Wert, nah an der Grenze sein.
  584. defineMTReg(BH1750_MTREG_DEFAULT);
  585. selectResolutionMode(_autoPowerDown?BH1750_ONE_TIME_HIGH_RES_MODE:BH1750_CONTINUOUS_HIGH_RES_MODE);
  586. //fDelayPtr(120+5); // TODO: Wert prüfen
  587. //fDelayPtr(getModeDelay());
  588. _nextDelay=getModeDelay();
  589. } else {
  590. #if BH1750_DEBUG == 1
  591. Serial.println("level 3: very bright");
  592. #endif
  593. // sehr hoher Bereich, Empfindlichkeit verringern
  594. defineMTReg(32); // Min+1, bei dem Minimum aus Doku spielt der Sensor (zumindest meiner) verrückt: Die Werte sind ca. 1/10 von den Erwarteten.
  595. selectResolutionMode(_autoPowerDown?BH1750_ONE_TIME_HIGH_RES_MODE:BH1750_CONTINUOUS_HIGH_RES_MODE);
  596. //fDelayPtr(120+5); // TODO: Wert prüfen
  597. //fDelayPtr(getModeDelay());
  598. _nextDelay=getModeDelay();
  599. }
  600. _stage++;
  601. return;
  602. }
  603. _stage = 99; // fertig
  604. }
  605. unsigned long AS_BH1750A::getModeDelay() {
  606. float ml;
  607. if(_MTreg<=BH1750_MTREG_MIN+1) { ml = 0.45; }
  608. else if(_MTreg<=BH1750_MTREG_DEFAULT+1) { ml = 1.0; }
  609. else { ml = 3.68; }
  610. switch (_hardwareMode) {
  611. case BH1750_CONTINUOUS_HIGH_RES_MODE:
  612. case BH1750_ONE_TIME_HIGH_RES_MODE:
  613. return ml*120+5;
  614. case BH1750_ONE_TIME_HIGH_RES_MODE_2:
  615. case BH1750_CONTINUOUS_HIGH_RES_MODE_2:
  616. return ml*120+5;
  617. case BH1750_CONTINUOUS_LOW_RES_MODE:
  618. case BH1750_ONE_TIME_LOW_RES_MODE:
  619. return ml*16+5;
  620. default:
  621. return 0;
  622. }
  623. }