无需编程！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" }

• type：传感器类型（singleValue/combinedValues）
• jsondata：是否接收JSON格式数据
• firstKey/secondKey：从JSON数据中提取的数值键名

⚙️ 配置文件使用方法

1. 准备配置文件

1. 复制data/config_example.json为data/config.json
2. 使用文本编辑器修改配置参数
3. 保存文件并上传到设备

2. 设备安装指南

图：Homepoint在ESP32设备上的安装过程示意图

完整的安装步骤：

1. 克隆项目仓库：git clone https://gitcode.com/gh_mirrors/ho/Homepoint
2. 按照README.md说明配置开发环境
3. 将修改好的config.json文件放入data目录
4. 使用ESP32开发工具烧录固件和文件系统

📱 界面定制：图标与显示参数

Homepoint支持通过配置文件自定义屏幕显示内容：

• 图标选择：在data目录下提供了多种设备状态图标，如bedroom_active.jpg、fan_inactive.jpg等
• 布局调整：通过修改场景顺序控制屏幕显示布局
• 传感器单位：温度默认使用摄氏度，湿度使用百分比

❓ 常见问题解决

连接失败怎么办？

1. 检查WiFi名称和密码是否正确（区分大小写）
2. 确保MQTT服务器地址和端口可访问
3. 验证时区设置格式是否正确

设备不显示状态？

1. 确认getTopic与设备实际发布的主题一致
2. 检查onValue/offValue与设备状态值匹配
3. 验证JSON数据的firstKey/secondKey是否正确

🎉 总结

通过修改JSON配置文件，你可以轻松定制Homepoint智能家居屏幕的各项功能，无需编写任何代码。从WiFi网络设置到MQTT设备连接，从场景管理到界面显示，配置文件提供了灵活而强大的自定义选项。立即下载config_example.json开始你的智能家居之旅吧！

配置文件路径：data/config.json
示例文件路径：data/config_example.json
图标资源目录：data/（包含各种状态图标）

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