首页/新闻资讯/正文详情

BH1750 API参考与常见问题排查清单:返回无数据、I2C地址找不到等6个高频问题(源师兄)

发布时间:2026/9/25 1:23:27 来源:云帆数科 栏目:资讯中心
BH1750 API参考与常见问题排查清单:返回无数据、I2C地址找不到等6个高频问题(源师兄)
BH1750 API参考与常见问题排查清单返回无数据、I2C地址找不到等6个高频问题源师兄【免费下载链接】CupCode_BH1750光线模块该模块用于测量环境光线强度项目地址: https://gitcode.com/yuanshixiong/test源师兄 BH1750 光线模块CupCode_BH1750是一款基于I2C的数字环境光感扩展用于测量环境光线强度可直接读取照度值lux并返回全黑/明亮/强烈日晒等明暗档位。本文提供完整的BH1750 API 参考并整理返回无数据、I2C 地址找不到等 6 个高频问题的排查清单帮助新手快速定位故障、稳定读数。一、认识 BH1750 光线模块BH1750 是一颗数字式环境光照度传感器通过I2C总线把环境有多亮换算成具体数值lux勒克斯输出无需手动计算电压接上即可读数。本扩展将传感器封装成 ohcode 积木核心能力集中在驱动库 library/bh1750_lib.py 中扩展说明见 config.json积木分类见 category.jsonPython 生成逻辑见 blocksdef.js。 适合场景智能灯光随环境调光、温室光照监测、白天/黑夜自动切换、教室光照达标检测等。二、接线与快速上手⚡ 接线遵循标准 4 线制见 README.md引脚连接说明SCLGPIO22时钟线积木内可改SDAGPIO21数据线积木内可改VCC3.3V电源GNDGND地ADD接地决定 I2C 地址为0x23上手三步放置扩展目录 → 用初始化积木指定 SCL/SDA 引脚 → 调用读取积木。加载与完整接线说明详见 README.md。三、BH1750 API 速查表所有方法都封装在 BH1750 类中调用前先完成初始化API参数返回值作用BH1750(scl, sda)22, 21默认实例初始化并上电read_lux()无浮点 lux读取当前照度level()无文字档位按亮度返回档位文字对应源码read_lux()见 library/bh1750_lib.pylevel()见 library/bh1750_lib.py。import sys sys.path.insert(0, library) import bh1750_lib light bh1750_lib.BH1750(22, 21) # 初始化SCL22, SDA21 print(light.read_lux()) # 例356.7 (lux) print(light.level()) # 例室内正常四、明暗档位对照表level()会把 lux 换算成直观文字便于直接驱动逻辑lux 范围档位文字典型场景 1全黑完全遮光1 ~ 30夜间照明夜晚灯光30 ~ 200室内正常日常室内200 ~ 1000明亮白天窗边≥ 1000强烈日晒户外阳光阈值定义见 library/bh1750_lib.py。五、6 个高频问题排查清单 以下按出现频率整理遇到先对号入座。问题 1读取无数据返回 None 或报错原因没有先初始化、I2C 未建立、引脚号填错。排查先调用初始化积木BH1750(scl, sda)确认引脚为 22/21再执行read_lux()。✅解决初始化与读取必须成对使用初始化在前。问题 2I2C 地址 0x23 找不到 / 扫描不到原因ADD 引脚未接地、接线松脱、VCC 与 GND 接反。排查确认ADD 已接地否则地址不为 0x23逐根检查 4 根线核对 VCC3.3V。✅解决ADD 接地即锁定地址0x23见 library/bh1750_lib.py。问题 3读数忽大忽小、不稳定原因环境光在变、电源波动、传感器被手遮挡。排查固定传感器朝向与位置避开发光屏幕保持供电稳定。✅解决连续读取多次取平均值可明显平滑波动。问题 4读数固定偏大或偏小需校准原因换算系数、环境反射、安装角度差异。排查分别在明亮与全黑环境各测一次与参考值对照。✅解决lux 由原始值除以 1.2 得到见 library/bh1750_lib.py可在该处微调校准系数。问题 5接线后无响应 / 初始化报错原因GPIO 引脚与其他 I2C 设备冲突、引脚号超出范围。排查核对引脚是否被其他外设占用确认传入的是有效 GPIO 编号。✅解决为 BH1750 预留独立的 I2C 引脚对避免总线争用。问题 6连续读取响应慢 / 循环阻塞原因高精度模式单次测量约180ms属正常耗时。排查确认测量逻辑sleep_ms(180)见 library/bh1750_lib.py。✅解决在循环中预留间隔避免密集轮询导致卡顿。六、相关文件索引文件作用library/bh1750_lib.pyBH1750 驱动库read_lux()、level()blocksdef.js积木定义与 Python 代码生成category.json积木分类初始化/读取/档位config.json扩展元信息README.md接线与使用说明LICENSEApache-2.0 排查口诀先接线、再初始化、后读取地址看 ADD波动看环境慢就留间隔。【免费下载链接】CupCode_BH1750光线模块该模块用于测量环境光线强度项目地址: https://gitcode.com/yuanshixiong/test创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关推荐

EyeMock:纯前端眼动推演工具原理与Windows兼容实践
EyeMock:纯前端眼动推演工具原理与Windows兼容实践

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 1:23:27

TensorFlow 2 图片数据建模全流程实战:基于 tf.data 管道构建 Cifar2 飞机与汽车图像分类模型
TensorFlow 2 图片数据建模全流程实战:基于 tf.data 管道构建 Cifar2 飞机与汽车图像分类模型

教程深度学习机器学习 【免费下载链接】eat_tensorflow2_in_30_days Tensorflow2.0 🍎🍊 is delicious, just eat it! 😋😋 项目地址: https://gitcode.com/gh_mirrors/ea/eat_tensorflow2_in_30_days 点击查看 免费下… · 2026/9/25 1:23:27

TextBlob 文本处理库实战指南:词性标注、情感分析、名词短语提取与文本分类
TextBlob 文本处理库实战指南:词性标注、情感分析、名词短语提取与文本分类

NLP人工智能 【免费下载链接】TextBlob Simple, Pythonic, text processing--Sentiment analysis, part-of-speech tagging, noun phrase extraction, translation, and more. 项目地址: https://gitcode.com/gh_mirrors/te/TextBlob 点击查看 免费下载 TextBlob 是… · 2026/9/25 1:23:21

从国内爆红到国际冷场:Manus能否成为下一个DeepSeek?——用TaoToken统一Key实测多模型Agent配置
从国内爆红到国际冷场:Manus能否成为下一个DeepSeek?——用TaoToken统一Key实测多模型Agent配置

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 13:54:51

深入解析 Agora convo AI:用 NextJS 与 STT 从零搭建你的第一个 AI 教育 Agent 助手(TaoToken 统一 Key 配置)
深入解析 Agora convo AI:用 NextJS 与 STT 从零搭建你的第一个 AI 教育 Agent 助手(TaoToken 统一 Key 配置)

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 13:54:32

Atlas 300V 24G加速卡详解与YOLO部署实战指南
Atlas 300V 24G加速卡详解与YOLO部署实战指南

如果你最近在网络上看过"atlas"这个词,八成绕不开华为昇腾系列AI加速卡。作为长期做深度学习部署的从业者,我几乎每天都要跟它打交道。最近不少朋友在问两件事:一是"atlas部署yolo怎么搞",二是"atlas 30… · 2026/9/25 13:53:44

5个免费AI写作软件搭配TaoToken:效率办公告别熬夜加班苦日子
5个免费AI写作软件搭配TaoToken:效率办公告别熬夜加班苦日子

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 13:53:31

AI视频生成新手第一课:用Seedance2-Skill快速上手即梦Seedance 2.0提示词(完整指南)
AI视频生成新手第一课:用Seedance2-Skill快速上手即梦Seedance 2.0提示词(完整指南)

AI视频生成新手第一课:用Seedance2-Skill快速上手即梦Seedance 2.0提示词(完整指南) 【免费下载链接】seedance2-skill skill to create best prompts for generating videos with seedance2.0 项目地址: https://gitcode.com/gh_mirrors/s… · 2026/9/25 13:53:31

C#酒店管理系统源码实战:WinForms前台与SQL Server后台全解析
C#酒店管理系统源码实战:WinForms前台与SQL Server后台全解析

简介:这是一套基于C#的酒店管理系统源码,适合学习桌面应用程序开发、酒店业务信息化管理的学生或初级开发者使用。系统覆盖前台与后台两大核心场景:前台支持预约、入住、换房、退房结算、客户信息维护及按房间号消费;后台提供财产… · 2026/9/25 13:53:31

数值优化(Numerical Optimization)学习系列-03-共轭梯度方法(Conjugate Gradient)
数值优化(Numerical Optimization)学习系列-03-共轭梯度方法(Conjugate Gradient)

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 1:00:31

创维E900V22D刷机全攻略:S905L3SB芯片兼容性解析与救砖实战
创维E900V22D刷机全攻略:S905L3SB芯片兼容性解析与救砖实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 1:00:31

MQTT协议原理与Broker服务器搭建实战:从Mosquitto到EMQX
MQTT协议原理与Broker服务器搭建实战:从Mosquitto到EMQX

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 1:00:37

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码