Upsy Desky固件定制指南：如何通过ESPHome配置实现个性化功能

Upsy Desky固件定制指南：如何通过ESPHome配置实现个性化功能

【免费下载链接】upsy-deskyMake your standing desk smarter项目地址: https://gitcode.com/gh_mirrors/up/upsy-desky

Upsy Desky是一款基于ESPHome的智能升降桌控制固件，通过简单的配置修改，你可以轻松实现高度预设、蓝牙控制等个性化功能。本文将带你快速掌握固件定制的核心方法，让你的升降桌更符合使用习惯。

准备工作：获取与安装固件

首先需要克隆项目仓库到本地环境：

git clone https://gitcode.com/gh_mirrors/up/upsy-desky

固件核心配置文件位于项目的firmware目录下，主要包括：

• base.yaml：基础功能配置
• config.yaml：用户自定义配置
• addons/：功能扩展模块目录

核心配置文件解析

基础配置（base.yaml）

base.yaml是固件的核心配置文件，定义了ESP32硬件参数、UART通信设置和基础功能模块。关键配置项包括：

• 设备信息：设置设备名称和项目版本

substitutions: name: "upsy-desky" friendly_name: "Upsy Desky" project_version: "dev"

• 硬件引脚：配置升降桌控制所需的引脚定义

standing_desk_uart_rx_pin: "17" # 串口接收引脚 standing_desk_up_pin: "21" # 上升控制引脚 standing_desk_down_pin: "22" # 下降控制引脚

• 高度范围：设置升降桌的最小/最大高度（单位：英寸）

standing_desk_min_height: "25.2" # 最低高度 standing_desk_max_height: "50.8" # 最高高度

功能扩展模块

Upsy Desky通过模块化设计支持功能扩展，主要扩展模块位于firmware/addons/目录：

• presets.yaml：高度预设功能
• bluetooth-proxy.yaml：蓝牙代理功能
• runtime-config.yaml：运行时配置功能

个性化定制实例

1. 调整高度范围

如果你需要修改升降桌的高度范围限制，可以直接编辑base.yaml中的高度参数：

standing_desk_min_height: "28.0" # 调整最低高度为28英寸 standing_desk_max_height: "48.0" # 调整最高高度为48英寸

2. 配置高度预设

预设功能允许你快速切换到常用高度，配置文件为addons/presets.yaml。系统默认提供4个预设按钮，每个按钮对应不同的GPIO引脚组合：

button: # 预设1按钮配置 - platform: template id: recall_preset_1 name: "Preset 1" icon: "mdi:numeric-1-box" on_press: - output.turn_on: button_bit1 - output.turn_on: button_bit2 - delay: 1s - output.turn_off: button_bit2 - output.turn_off: button_bit1

3. 启用蓝牙功能

要添加蓝牙控制功能，只需在主配置文件中包含蓝牙代理模块：

packages: addon_bluetooth: !include addons/bluetooth-proxy.yaml

编译与刷写固件

完成配置修改后，使用ESPHome命令编译并刷写固件：

cd firmware esphome run config.yaml

系统会自动编译固件并通过USB接口刷写到ESP32设备。刷写完成后，设备将自动重启并应用新配置。

高级定制技巧

自定义按钮功能

通过修改presets.yaml中的按钮触发动作，你可以实现更复杂的功能，例如：

• 设置延时下降
• 组合高度调整
• 联动其他智能家居设备

修改状态LED

状态LED的配置位于base.yaml的light部分，你可以调整引脚和闪烁模式：

light: - platform: status_led id: upsy_desky_status_led name: "Status LED" pin: GPIO23 # 修改为其他GPIO引脚 restore_mode: RESTORE_DEFAULT_ON

故障排除与支持

如果遇到配置问题，可以参考以下资源：

• 项目官方文档：docs/fulfillment.md
• 固件调试配置：firmware/debug.yaml
• 测试固件工具：test-firmware/

通过以上步骤，你可以轻松定制Upsy Desky固件，打造专属于你的智能升降桌控制系统。无论是简单的高度调整还是复杂的自动化场景，ESPHome的灵活配置都能满足你的需求。

【免费下载链接】upsy-deskyMake your standing desk smarter项目地址: https://gitcode.com/gh_mirrors/up/upsy-desky