OVERVIEW
这块模块适合做什么
VEML6030 是 I2C 数字环境光传感器，内部包含光电二极管、低噪声放大器和 16 位 ADC。客户常用它做自动背光、智能照明、光照记录、室内外亮度判断等项目。
I2C 直读
主控只需要 VCC、GND、SDA、SCL 四根线；常见地址为 0x48。
输出 lux
代码读取 ALS 原始值后按配置换算成 lux，适合串口、OLED 或上位机显示。
阈值中断
模块的 INT 引脚可选，适合亮度超过/低于阈值时唤醒主控。
VIDEO
视频资料和分段说明
已检查视频：这条有声音，画面中文正常，不是乱码。网页使用压缩版，B 站保留高清 1080×1920 原文件。
分段时间
00:00模块外观和用途：I2C 输出环境光数据
00:15ESP32 接线：GPIO21/SDA、GPIO22/SCL
00:31ESP32 代码：Wire 直接读寄存器
00:51Arduino UNO 接线：A4/SDA、A5/SCL
01:06串口输出 RAW 和 lux 读数
01:21STM32 接线：PB7/SDA、PB6/SCL
01:38STM32 HAL 地址写法和读取思路
01:52常见问题：扫不到、饱和、弱光跳动
REAL PHOTO
产品图和模块识别
WIRING
三种主控接线图
接线图按主控分开画，避免线交叉。调试时先只接 VCC、GND、SDA、SCL，确认能扫到 0x48 后再考虑 INT。
| VEML6030 | ESP32 | 说明 |
|---|---|---|
| VIN / VCC | 3V3 | 推荐 3.3V 供电 |
| GND | GND | 必须共地 |
| SDA | GPIO21 | I2C 数据线 |
| SCL | GPIO22 | I2C 时钟线 |
| INT | GPIO25 | 可选，不用可悬空 |
| VEML6030 | Arduino UNO | 说明 |
|---|---|---|
| VIN / VCC | 3.3V | 优先 3.3V |
| GND | GND | 必须共地 |
| SDA | A4 / SDA | I2C 数据线 |
| SCL | A5 / SCL | I2C 时钟线 |
| INT | D2 | 可选 |
| VEML6030 | STM32F103 I2C1 | 说明 |
|---|---|---|
| VIN / VCC | 3.3V | STM32 是 3.3V 逻辑 |
| GND | GND | 必须共地 |
| SDA | PB7 | I2C1_SDA |
| SCL | PB6 | I2C1_SCL |
| INT | PA0 | 可选外部中断 |
REGISTERS
寄存器和配置建议
| 寄存器 | 地址 | 用途 |
|---|---|---|
| ALS_CONF | 0x00 | 增益、积分时间、开关配置 |
| ALS_WH | 0x01 | 中断高阈值 |
| ALS_WL | 0x02 | 中断低阈值 |
| PSM | 0x03 | 省电模式 |
| ALS | 0x04 | 环境光原始数据 |
| WHITE | 0x05 | 白光通道数据 |
| ALS_INT | 0x06 | 中断状态 |
| 场景 | 增益 | 积分时间 |
|---|---|---|
| 普通室内/室外 | 1/8 或 1/4 | 100 ms |
| 弱光环境 | 1 或 2 | 400-800 ms |
| 强太阳光 | 1/8 | 25-100 ms |
CODE
Arduino / ESP32 / STM32 测试代码
下面代码使用 Wire.h 直接读写寄存器，不强制依赖第三方库。先用 I2C Scanner 看 0x48，再跑 lux 读取程序。
ESP32_Arduino_VEML6030.ino
#include <Wire.h>
#define VEML6030_ADDR 0x48
#define SDA_PIN 21
#define SCL_PIN 22
#define REG_ALS_CONF 0x00
#define REG_ALS 0x04
void write16(uint8_t reg, uint16_t value) {
Wire.beginTransmission(VEML6030_ADDR);
Wire.write(reg);
Wire.write(value & 0xFF);
Wire.write((value >> 8) & 0xFF);
Wire.endTransmission();
}
uint16_t read16(uint8_t reg) {
Wire.beginTransmission(VEML6030_ADDR);
Wire.write(reg);
Wire.endTransmission(false);
Wire.requestFrom(VEML6030_ADDR, 2);
uint16_t lsb = Wire.read();
uint16_t msb = Wire.read();
return (msb << 8) | lsb;
}
void setup() {
Serial.begin(115200);
Wire.begin(SDA_PIN, SCL_PIN);
write16(REG_ALS_CONF, 0x0000);
delay(120);
Serial.println("VEML6030 ESP32 ready");
}
void loop() {
uint16_t raw = read16(REG_ALS);
float lux = raw * 0.0672;
Serial.print("RAW: ");
Serial.print(raw);
Serial.print(" Lux: ");
Serial.println(lux, 2);
delay(1000);
}I2C_Scanner.ino
#include <Wire.h>
void setup() {
Serial.begin(115200);
Wire.begin();
Serial.println("I2C scan start");
for (byte addr = 1; addr < 127; addr++) {
Wire.beginTransmission(addr);
if (Wire.endTransmission() == 0) {
Serial.print("Found I2C device: 0x");
if (addr < 16) Serial.print("0");
Serial.println(addr, HEX);
}
}
}
void loop() {}STM32 HAL 地址提醒
VEML6030 的 7 位地址是 0x48。STM32 HAL 常见写法需要左移一位：#define VEML6030_ADDR (0x48 << 1)，也就是 0x90。
新手改代码看这几行
Arduino IDE 的 .ino 文件要放在同名文件夹里，例如 VEML6030_Test/VEML6030_Test.ino。如果还有 .h、.cpp 驱动文件，也一起放进这个文件夹。
| 要改的内容 | 代码位置 | 什么时候改 |
|---|---|---|
| ESP32 SDA 引脚 | #define SDA_PIN 21 | 你的 SDA 不是接 GPIO21 时 |
| ESP32 SCL 引脚 | #define SCL_PIN 22 | 你的 SCL 不是接 GPIO22 时 |
| I2C 地址 | #define VEML6030_ADDR 0x48 | I2C 扫描到其它地址时才改 |
| 串口波特率 | Serial.begin(115200) | 串口监视器也要选 115200 |
| UNO I2C | Wire.begin() | UNO 固定 A4/A5，一般不用写 21/22 |
扫不到 0x48 时，不要先乱改地址。先检查供电、GND 共地、SDA/SCL 是否接反，再看程序引脚是否和实际接线一致。
Support
需要技术支持时，把这几项一起发来
复制下面这段填一下发给客服，我们一次就能定位，不用来回问。
DOWNLOADS