Alexey Zholtikov
6961da0aa1
Added automatically sensitivity adjustment. Fixed bug with sensitivity adjustment error on ESP32.
82 lines
2.3 KiB
Markdown
82 lines
2.3 KiB
Markdown
# ESP32 ESP-IDF and ESP8266 RTOS SDK component for BH1750 ambient light sensor
|
||
|
||
## Tested on
|
||
|
||
1. ESP8266 RTOS_SDK v3.4
|
||
2. ESP32 ESP-IDF v5.2
|
||
|
||
## Features
|
||
|
||
1. Recorded illuminance values from 0.11 to 121241 lux (depends on operation mode and sensitivity).
|
||
2. Support automatically sensitivity adjustment.
|
||
|
||
## Using
|
||
|
||
In an existing project, run the following command to install the component:
|
||
|
||
```text
|
||
cd ../your_project/components
|
||
git clone https://github.com/aZholtikov/zh_bh1750.git
|
||
```
|
||
|
||
In the application, add the component:
|
||
|
||
```c
|
||
#include "zh_bh1750.h"
|
||
```
|
||
|
||
## Example
|
||
|
||
Reading the sensor:
|
||
|
||
```c
|
||
#include "zh_bh1750.h"
|
||
|
||
#define I2C_PORT (I2C_NUM_MAX - 1)
|
||
|
||
void app_main(void)
|
||
{
|
||
esp_log_level_set("zh_bh1750", ESP_LOG_NONE);
|
||
#ifdef CONFIG_IDF_TARGET_ESP8266
|
||
i2c_config_t i2c_config = {
|
||
.mode = I2C_MODE_MASTER,
|
||
.sda_io_num = GPIO_NUM_4, // In accordance with used chip.
|
||
.sda_pullup_en = GPIO_PULLUP_ENABLE,
|
||
.scl_io_num = GPIO_NUM_5, // In accordance with used chip.
|
||
.scl_pullup_en = GPIO_PULLUP_ENABLE,
|
||
};
|
||
i2c_driver_install(I2C_PORT, i2c_config.mode);
|
||
i2c_param_config(I2C_PORT, &i2c_config);
|
||
#else
|
||
i2c_master_bus_config_t i2c_bus_config = {
|
||
.clk_source = I2C_CLK_SRC_DEFAULT,
|
||
.i2c_port = I2C_PORT,
|
||
.scl_io_num = GPIO_NUM_22, // In accordance with used chip.
|
||
.sda_io_num = GPIO_NUM_21, // In accordance with used chip.
|
||
.glitch_ignore_cnt = 7,
|
||
.flags.enable_internal_pullup = true,
|
||
};
|
||
i2c_master_bus_handle_t i2c_bus_handle;
|
||
i2c_new_master_bus(&i2c_bus_config, &i2c_bus_handle);
|
||
#endif
|
||
zh_bh1750_init_config_t bh1750_init_config = ZH_BH1750_INIT_CONFIG_DEFAULT();
|
||
bh1750_init_config.auto_adjust = true; // Just for an example of how to enable auto adjustment the sensor sensitivity.
|
||
#ifdef CONFIG_IDF_TARGET_ESP8266
|
||
bh1750_init_config.i2c_port = I2C_PORT;
|
||
#else
|
||
bh1750_init_config.i2c_handle = i2c_bus_handle;
|
||
#endif
|
||
zh_bh1750_init(&bh1750_init_config);
|
||
zh_bh1750_adjust(69); // Just for an example of how to change the sensor sensitivity. Don’t work if auto adjustment is enabled.
|
||
float lux = 0.0;
|
||
for (;;)
|
||
{
|
||
zh_bh1750_read(&lux);
|
||
printf("Lux %0.2f\n", lux);
|
||
vTaskDelay(5000 / portTICK_PERIOD_MS);
|
||
}
|
||
}
|
||
```
|
||
|
||
Any [feedback](mailto:github@azholtikov.ru) will be gladly accepted.
|