Are you an LLM? You can read better optimized documentation at /doc/device\v2\periph-exec\button-control.md for this page in Markdown format
按键多模式控制
先保存并启用输入 btn1 与输出 led1。上拉输入类型 13 的按键通常接 GPIO 与 GND,下拉输入类型 14 则按其电路确定按下极性;GPIO 与供电以实际芯片、板卡及资源校验为准。不要把 GPIO0/BOOT 或其他启动绑定位默认当作所有板卡都安全的按键。
事件映射
| eventId | 行为 |
|---|---|
button_press/button_release | 稳定按下/释放 |
button_click | 单击 |
button_double_click | 双击 |
button_long_press_2s/5s/10s | 对应长按阶段 |
事件规则 triggerType=4、triggerPeriphId="btn1";未指定输入时兼容任意按键,通常应显式填写。单击翻转状态灯:
json
{
"id": "exec_button_led",
"name": "exec_button_led",
"enabled": false,
"execMode": 0,
"triggers": [
{
"triggerType": 4,
"eventId": "button_click",
"triggerPeriphId": "btn1"
}
],
"actions": [
{
"actionType": 30,
"targetPeriphId": "led1",
"actionValue": "",
"syncDelayMs": 0,
"execMode": 0
}
],
"reportAfterExec": false
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
双击可另配固定关闭电平,须与输出极性匹配。长按 2 秒可以触发指示动作,5 秒可请求系统动作 6 重启;动作 7 恢复出厂已拒绝自动化调用,不能用 10 秒长按配出厂重置。
时序与消抖
检查周期约 20 ms,消抖使用保存的 debounceMs:原生输入未指定时默认 50 ms,扩展器默认 40 ms。外设配置变化或来源恢复会重新建立基线,不能让故障期间的旧边沿变成新单击。
没有启用的双击监听时,短按松开即可产生单击;存在双击监听时,单击等待默认 300 ms 双击窗口。不能承诺所有单击立即执行,也不能在未配置双击监听时用连续两次单击验证双击。
长按 2/5/10 秒按时间递进,非互斥事件;若 5 秒重启,10 秒阶段可能无法到达。释放、短按和长按按状态机处理,软件事件不证明实际负载动作。保存为停用草稿后,先核对接线、消抖、日志及输出,再现场启用。结果不明时不要重复翻转。

