Measuring illuminance with light intensity sensor module (BH1750FVI) and ESP32 | そう備忘録

Measuring illuminance with light intensity sensor module (BH1750FVI) and ESP32


Article on the measurement of illuminance with the ESP-WROOM-32 module using the GY-302, a modularized illuminance sensor (BH1750FVI) from ROHM Co.

BH1750FVI surface

The GY-302 has the following features

  • Interface: I2C
  • I2C Address: 0x23 or 0x5C
  • Illuminance: 0.11 to 100,000 lux
  • Voltage: 3.0 to 5.0 V (3.3 V was used in this case)

Measurement Mode

There are three modes of measurement as follows

H-Resolution Mode

High resolution mode

  • Measurement time: 120 ms
  • Resolution: 1 lux

H-Resolution Mode2

High resolution mode 2

  • Measurement time: 120 ms
  • Resolution: 0.5 lux

Measurement time is the same as in high-resolution mode, but the measurable range is different (see below)

L-Resolution Mode

Low resolution mode

  • Measurement time: 16 ms
  • Resolution: 4 lux

In addition to the above modes, there are two other modes, Continuously and One Time, so there are 3 x 2 = 6 possible combinations.


Used for continuous measurement

One Time

One time

Automatically enters power-down mode after measurement is complete


The sensor sensitivity can be adjusted with the register that adjusts the measurement time.

The default setting is 69, with a range of 31 to 254.

A higher value (254) will increase the measurement time and allow for finer sensitivity, but will lower the maximum measurable illuminance.

In H-Resolution Mode, the maximum illuminance is 14,836 lux, and in Mode 2, the maximum illuminance is 7,418 lux, which is half of the maximum, making it unsuitable for outdoor measurements.

On the other hand, indoors, there was no problem with the default setting of 69.

Calculation Formula

The following is a description of the calculation formulas performed inside the library.

In H-Resolution Mode and Mode2, the sensitivity is calculated by the following formula.

H-reslution mode : Illuminance per 1 count ( lx / count ) = 1 / 1.2 *( 69 / X )
H-reslution mode2 : Illuminance per 1 count ( lx / count ) = 1 / 1.2 *( 69 / X ) / 2

X : MTreg value


When X (MTreg) is 254 in H-Resolution Mode

1 / 1.2 *( 69 / 254 ) = 0.2263・・・ ≒ 0.23

Measured in 0.23 lux units. (Half of that when Mode 2 is selected)

The same formula is used to calculate the unit of 1.85 lux when MTreg is 31.

The value measured by the sensor is returned in High Byte and Low Byte as shown below (quoted from BH1750FVI datasheet).

Calculation method of measurement results

The powers of 2 where the bit is 1 are added together and divided by 1.2 (fixed).

The above ex) is a calculation example when MTreg is set to the default value of 69, but if all bits are set to 1 and MTreg is set to 254, the calculation formula for H-Resolution Mode is as follows

(2^15 + 2^14 + 2^13 + 2^12 + 2^11 + 2^10 + 2^9 + 2^8 + 2^7 + 2^6 + 2^5 + 2^4 + 2^3 + 2^2 + 2^1 + 2^0) / 1.2 *( 69 / 254 ) = 14835.67913・・・ ≒ 14,836

The above formula indicates that a maximum of 14,836 lux can be measured.

In Mode 2, the maximum measurable illuminance is about 7,400 lux, which is half of the maximum measurable illuminance. Therefore, care should be taken when measuring illuminance in bright places with high sensitivity.


The following five connectors are available.

  • VCC: 3 to 5V
  • GND: GND
  • SCL: I2C connection
  • SDA: Same as above
  • ADDR: For I2C address change
Back side of BH1750

I2C Address

When ADDR is connected LOW (0.3V or lower), the value is 0x23; when ADDR is connected HIGH (0.7V or higher), the value is 0x5C.

Other Parts

Other major parts prepared are as follows.

ESP32 module

Various ESP32 modules are available on the market, but the ESP-WROOM-32 module we used this time is from the following product.

The pin layout is the pin layout of ESP32 DEVKIT V1 (30 pins).

ESP32 Dev Kit V1

Silicon Wire

Recently purchased silicon wire (24 AWG)

Silicon is soft and very comfortable to use.

The temperature range of -60 to +200 C is also very nice.

Silicon Wire

Preliminary Preparation

Arduino IDE (Ver 1.8.19) was used as the development environment.

Please refer to this article for downloading and installing Arduino IDE.

Install the necessary libraries in advance.

BH1750 Library

Start the Arduino IDE and launch the Library Manager by going to Sketch->Include Library->Manage Libraries.

Type “BH1750” in the search field to search and installed the library that appears at the top of the list.

Github is here.

This library does the calculations I just described internally, so all I need to do from the sketch is to call the function that reads the MTreg set and the illuminance.

Search the BH1750 library

Wiring Diagram

The wiring diagram is as follows.

ADDR is connected to GND, so the I2C address is 0x23.

Wiring diagram between BH1750FVI and ESP-WROOM-32


The following is a sketch of the illuminance measured and displayed on the console approximately every 10 seconds.


 * BH1750 test
#include <Wire.h>
#include <BH1750.h>

// I2C Pin
constexpr short int SDA_PIN = 21;
constexpr short int SCL_PIN = 22;

BH1750 lightMeter(0x23);

float lux;

void setup() {
    Wire.begin(SDA_PIN, SCL_PIN); // I2C

     * 6 Mode

void loop() {
    if (lightMeter.measurementReady(true)) {
        if (lightMeter.setMTreg(69)) { // set MTreg(Measurement Time)
            Serial.println("MTreg Normal Setting(69)");
        } else {
            Serial.println("MTreg setting error");
        lux = lightMeter.readLightLevel();
        Serial.print("Light: ");
        Serial.println(" lx");
    } else {

supplementary explanation


Initial processing of I2C connection and initial processing of BH1750FVI.

The following six modes can be set.



MTreg is set to the standard 69.

The above sketch is an example of a single measurement with standard settings, but if you want to measure as accurately as possible in high-resolution mode from very bright to very dark locations, you can use the

  1. Set MTreg to 69 and measure in high resolution mode 2
  2. If the measurement result is less than 10 lux, go to 4.
  3. If the result is more than 5,000 lux, go to 5. Otherwise, go to 6.
  4. If MTreg is set to 254, go to 7.
  5. Set MTreg to 32 and go to 7.
  6. Set MTreg to 69 and go to 7.
  7. Measure again in High Resolution 2 mode

The measurement may be performed in two steps, such as

Execution Result

The results are as follows.

The measurement results are displayed on the console, and a high illuminance was measured when the sensor was illuminated by an LED light.

Execution Result

This concludes this article.


I hope this article will be useful to someone somewhere.

souichirou kikuchi

I'm Japanese. A reminder to remember what I've done. I'm blogging in the hope that it will be helpful to others who want to do similar things. I mainly write blogs about LEGO, AWS (Amazon Web Services), WordPress, Deep Learning and Raspberry Pi. At work, I'm working on installing collaborative robots and IoT in factories. I passed the JDLA (Japan Deep Learning Association) Deep Learning for GENERAL in July 2019. If you have any questions, please leave them in the comments at the bottom of the article.


Name, Email, and Website are optional.
and, your Email address will not be published.