Unit DLight Arduino Tutorial

1. Preparation

• Environment Setup: Follow the Arduino IDE Getting Started Tutorial to install the IDE, then install the board manager package and required driver libraries for the development board you are using.
• Required Driver Libraries:
  • M5Unified
  • M5GFX
  • M5-DLight
• Required Hardware:
  • Basic v2.7
  • Unit DLight

2. Notes

3. Example Program

• This tutorial uses Basic V2.7 with Unit DLight. Unit DLight communicates via I2C at the default address 0x23. Once connected, the corresponding pins are G21 (SDA) and G22 (SCL).

#include <M5Unified.h>
#include <M5_DLight.h>

M5Canvas canvas(&M5.Display);

M5_DLight sensor;
uint16_t lux;

void setup() {
    M5.begin();
    canvas.setTextDatum(MC_DATUM);
    canvas.setColorDepth(1);
    canvas.setFont(&fonts::Orbitron_Light_24);
    canvas.setTextSize(2);
    canvas.createSprite(M5.Display.width(), M5.Display.height());
    canvas.setPaletteColor(1, ORANGE);
    Serial.begin(115200);
    Serial.println("Sensor begin.....");
    sensor.begin(&Wire, SDA, SCL);

    // CONTINUOUSLY_H_RESOLUTION_MODE
    // CONTINUOUSLY_H_RESOLUTION_MODE2
    // CONTINUOUSLY_L_RESOLUTION_MODE
    // ONE_TIME_H_RESOLUTION_MODE
    // ONE_TIME_H_RESOLUTION_MODE2
    // ONE_TIME_L_RESOLUTION_MODE
    sensor.setMode(CONTINUOUSLY_H_RESOLUTION_MODE);
}

char info[40];

void loop() {
    lux = sensor.getLUX();
    sprintf(info, "lux: %d", lux);
    canvas.fillSprite(BLACK);
    canvas.drawString(info, 160, 120);
    canvas.pushSprite(0, 0);
    Serial.println(info);
    delay(100);
}

4. Compile and Upload

• Copy and paste the example code above into the project code area and select the device port. For details, see Program Compilation and Flashing. Click the compile and upload button in the upper-left corner of Arduino IDE, then wait for the program to compile and upload to the device.

5. Ambient Light Illuminance Detection

• After the program starts, the screen and Serial Monitor update the ambient light illuminance measured by Unit DLight every 100ms, displayed in lx. Change the light intensity on the sensor surface to observe changes in the illuminance value.