The BH1750 board uses I2C for communication, and two pins are required to interface to the device. Configuring the I2C bus is best done in user code (not library code) so that it can be done once and can more easily make use of various options for different platforms.

Overview

The BH1750 has six different measurment modes. They are divided in two groups; continuous and one-time measurments. In continuous mode, the sensor continuously measures lightness value. In one-time mode, sensor makes only one measurment, and then goes into Power Down mode after this.

Each mode, has three different precisions:

Low Resolution Mode - (4 lx precision, 16ms measurment time)
High Resolution Mode - (1 lx precision, 120ms measurment time)
High Resolution Mode 2 - (0.5 lx precision, 120ms measurment time)

By default, this library uses Continuous High Resolution Mode, but you can set any other mode by passing the mode argument to BH1750.begin().

Remember, if you use One-Time mode, your sensor will go into Power Down mode when it completes the measurment and you've read it.

Typical Connection:

VCC -> 5V (3V3 on Arduino Due, Zero, MKR1000, etc)
GND -> GND
SCL -> SCL (A5 on Arduino Uno, Leonardo, etc or 21 on Mega and Due on esp8266 free selectable)
SDA -> SDA (A4 on Arduino Uno, Leonardo, etc or 20 on Mega and Due on esp8266 free selectable)
ADD -> GND or VCC (see below)

ADD pin is used to set sensor I2C address. If it has voltage greater or equal to 0.7VCC voltage (e.g. you've connected it to VCC) the sensor address will be 0x5C. In other case (if ADD voltage less than 0.7 * VCC) the sensor address will be 0x23 (by default).

The datasheet for the BH1750 can be obtained here

Example

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

BH1750 lightMeter;

void setup(){

  Serial.begin(9600);

  // Initialize the I2C bus (BH1750 library doesn't do this automatically)
  // On esp8266 devices you can select SCL and SDA pins using Wire.begin(D4, D3);
  Wire.begin();

  lightMeter.begin();
  Serial.println(F("BH1750 Test"));

}

void loop() {

  uint16_t lux = lightMeter.readLightLevel();
  Serial.print("Light: ");
  Serial.print(lux);
  Serial.println(" lx");
  delay(1000);

}

There are more examples in the examples directory. One shows a simple use while the other shows a more advanced use case.

Installation

Click "Clone or download" -> "Download ZIP" button.

(For Arduino >= 1.5.x) Use the way above, or Library Manager. Open Arduino IDE, click Sketch -> Include library -> Add .ZIP library and select the downloaded archive.
(For Arduino < 1.5.x) Extract the archive to <Your User Directory>/My Documents/Arduino/libraries/ folder and rename it to BH1750. Restart IDE.

Additional info, about library installation process - https://www.arduino.cc/en/Guide/Libraries