当前位置：首页 > news >正文

无需编程！Homepoint配置文件详解：JSON设置WiFi、MQTT与屏幕参数

news 2026/8/15 19:19:52

无需编程！Homepoint配置文件详解：JSON设置WiFi、MQTT与屏幕参数

【免费下载链接】HomepointEspressif ESP32 Based Smarthome screen for MQTT项目地址: https://gitcode.com/gh_mirrors/ho/Homepoint

Homepoint是一款基于Espressif ESP32的智能家居屏幕解决方案，通过MQTT协议实现设备互联互通。本文将详细介绍如何通过JSON配置文件轻松设置WiFi网络、MQTT连接和屏幕显示参数，让你零代码打造个性化智能家居控制中心。

📋 配置文件基础：结构与位置

Homepoint的核心配置文件为config.json，位于项目根目录下的data文件夹中。该文件采用JSON格式，包含网络连接、设备管理和界面显示等关键参数。项目提供了完整的示例配置文件config_example.json，你可以直接复制修改使用。

图：配置完成后Homepoint设备显示的智能家居控制界面，展示了房间状态和传感器数据

🔧 基础配置：WiFi与MQTT连接

WiFi网络设置

配置文件开头的wifi和password字段用于设置无线网络连接：

{ "wifi": "你的WiFi名称", "password": "你的WiFi密码", "login": "", "webpass": "" }

wifi：填入你的2.4GHz WiFi网络名称（不支持5GHz）
password：WiFi密码
login和webpass：网页管理界面的登录凭证（留空则无需登录）

MQTT服务器配置

Homepoint通过MQTT协议与智能家居设备通信，相关配置如下：

{ "mqttbroker": "mqtt://192.168.8.15", "mqttusername": "", "mqttpasswd": "", "timezone": "CET-1CEST-2,M3.5.0/02:00:00,M10.5.0/03:00:00" }

mqttbroker：MQTT服务器地址（支持mqtt://和mqtts://协议）
mqttusername/mqttpasswd：MQTT服务器认证信息
timezone：时区设置，格式遵循Olson时区数据库规范

🎛️ 高级配置：场景与设备管理

场景(Scenes)配置

Homepoint通过"场景"组织不同房间或功能的设备，每个场景包含多个设备。以下是灯光场景的配置示例：

"scenes": [{ "name": "Living Room", "type": "Light", "icon": "livingroom", "devices": [{ "name": "Side Light", "setTopic": "lights/hue/00:17:88:01:02:3c:2a:6d-0b/set/on", "getTopic": "hue/status/lights/Hue color lamp 1", "onValue": "true", "offValue": "false", "icon": "bedroom" }] }]

name：场景名称（显示在屏幕上）
type：场景类型（Light/Sensor/Switch等）
icon：场景图标（从data目录下选择对应的图片文件）
devices：该场景包含的设备列表

设备(Devices)配置

每个设备需要定义MQTT通信主题和状态值：

setTopic：控制设备的MQTT主题
getTopic：获取设备状态的MQTT主题
onValue/offValue：设备开关状态的判断值

传感器设备配置示例：

{ "name": "Living Room DHT", "type": "combinedValues", "firstIcon": "temperature_small", "secondIcon": "humidity_small", "jsondata": true, "firstKey": "temperature", "secondKey": "humidity", "getTopic": "livingroom/temphumidity" }