Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/azholtikov/zh_bh1750
ESP32 ESP-IDF and ESP8266 RTOS SDK component for BH1750 ambient light sensor.
https://github.com/azholtikov/zh_bh1750
bh1750 component esp-idf esp32 esp8266 i2c rtos-sdk
Last synced: 1 day ago
JSON representation
ESP32 ESP-IDF and ESP8266 RTOS SDK component for BH1750 ambient light sensor.
- Host: GitHub
- URL: https://github.com/azholtikov/zh_bh1750
- Owner: aZholtikov
- License: apache-2.0
- Created: 2024-03-08T07:09:26.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-07-22T12:47:56.000Z (4 months ago)
- Last Synced: 2024-07-22T15:12:47.712Z (4 months ago)
- Topics: bh1750, component, esp-idf, esp32, esp8266, i2c, rtos-sdk
- Language: C
- Homepage:
- Size: 529 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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:[email protected]) will be gladly accepted.