Digital 16bit Serial Output Type Ambient Light Sensor IC by ROHM, Ambient light sensor (Illuminance to digital converter)
Diff: BH1750.h
- Revision:
- 0:d95f6ac4c8d6
- Child:
- 1:4a02a8fbf021
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/BH1750.h Sat Mar 07 23:44:42 2015 +0000 @@ -0,0 +1,128 @@ +/* + * mbed library program + * light intensity sensor module with built-in a 16 bit AD converter generating digital signal. + * BH1750 by ROHM Co.,Ltd. + * + * Copyright (c) 2015 Kenji Arai / JH1PJL + * http://www.page.sannet.ne.jp/kenjia/index.html + * http://mbed.org/users/kenjiArai/ + * Created: March 7th, 2015 + * Revised: March 8th, 2015 + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, + * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE + * AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, + * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + */ +/* + *---------------- REFERENCE ---------------------------------------------------------------------- + * Original Information + * http://www.rohm.co.jp/web/japan/products/-/product/BH1750FVI + * Device kit + * http://www.aitendo.com/product/10240 + */ + +#ifndef BH1750_H +#define BH1750_H + +#include "mbed.h" + +// light intensity sensor, BH1750 +// 7bit address = 0b0100011(0x23) or 0b1011100(0x5c) +#define BH1750_G_CHIP_ADDR (0x23 << 1) +#define BH1750_V_CHIP_ADDR (0x5c << 1) + +////////////// COMMAND //////////////////////////////////// +#define CMD_PWR_DWN 0x00 +#define CMD_PWR_UP 0x01 +#define CMD_RESET 0x07 +#define CMD_C_H_RES_M 0x10 +#define CMD_C_H_RES_M2 0x11 +#define CMD_C_L_RES_M 0x13 +#define CMD_1_H_RES_M 0x20 +#define CMD_1_H_RES_M2 0x21 +#define CMD_1_L_RES_M 0x23 +#define CMD_M_TIME_H 0x40 +#define CMD_M_TIME_L 0x60 + +////////////// SENSITIVITY //////////////////////////////// +#define SENS_1R00 69 +#define SENS_3R68 254 +#define SENS_0R45 31 +#define SENS_2R00 138 +#define SENS_0R50 35 + +/** Interface for Luminosity sensor, BH1750 + * @code + * #include "mbed.h" + * #include "BH1750.h" + * + * // I2C Communication + * BH1750 lum(dp5,dp27); // BH1750 SDA, SCL + * // If you connected I2C line not only this device but also other devices, + * // you need to declare following method. + * I2C i2c(dp5,dp27); // SDA, SCL + * BH1750 lum(i2c); // BH1750 SDA, SCL (Data available every 120mSec) + * + * int main() {; + * while(true){ + * printf("Illuminance: %+7.2f [Lux]\r\n", lum.lux()); + * wait(1.0); + * } + * } + * @endcode + */ + +class BH1750 +{ +public: + /** Configure data pin + * @param data SDA and SCL pins + */ + BH1750(PinName p_sda, PinName p_scl); + BH1750(PinName p_sda, PinName p_scl, uint8_t addr); + + /** Configure data pin (with other devices on I2C line) + * @param I2C previous definition + */ + BH1750(I2C& p_i2c); + BH1750(I2C& p_i2c, uint8_t addr); + + /** Get Illuminance, unit of Lux + * @param none + * @return Lux + */ + float lux(void); + + /** Set sensor sensitivity adjustment + * @param sensitivity parameter + * @return none + */ + void set_sensitivity(uint8_t parameter); + + /** Set I2C clock frequency + * @param freq. + * @return none + */ + void frequency(int hz); + + /** Power Up/Down + * @param none + * @return none + */ + void power_up(void); + void power_down(void); + +protected: + I2C _i2c; + + void init(void); + +private: + uint8_t BH1750_addr; + uint8_t dt[4]; + int8_t sensitivity; +}; + +#endif // BH1750_H