OctoPrint自定义控制功能详解：打造个性化3D打印控制面板-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00135/article/details/148440162

OctoPrint自定义控制功能详解：打造个性化3D打印控制面板

OctoPrint OctoPrint is the snappy web interface for your 3D printer! 项目地址: https://gitcode.com/gh_mirrors/oc/OctoPrint

什么是OctoPrint自定义控制功能？

OctoPrint作为一款强大的3D打印机控制软件，提供了自定义控制面板的功能，允许用户在"控制"标签页中添加自己设计的控制按钮和交互元素。这个功能特别适合那些希望快速访问常用G代码命令或创建复杂打印工作流的用户。

自定义控制的基本结构

自定义控制通过YAML格式的配置文件进行定义，主要分为两种基本类型：

容器型控件：作为其他控件的分组容器，可以包含子控件
功能型控件：实际执行操作的控件，如发送G代码命令、显示打印机反馈等

容器型控件详解

容器型控件主要用于组织界面布局，其核心属性包括：

children：包含的子控件列表
name：容器标题（可选）
layout：布局方式（vertical垂直/horizontal水平/网格布局）
collapsed：是否默认折叠（可选）

- name: 风扇控制
  layout: horizontal
  children:
    - name: 开启风扇
      command: M106 S255
    - name: 关闭风扇
      command: M107

功能型控件类型

OctoPrint支持多种功能型控件，每种都有其特定用途：

1. 简单命令按钮

发送单个G代码命令：

- name: 归位X轴
  command: G28 X0

2. 多命令序列

发送一系列G代码命令：

- name: 移动并归位
  commands:
    - G91
    - G1 X10 F3000
    - G90
    - G28 X0

3. 参数化命令

允许用户输入参数值：

- name: 设置挤出机温度
  command: M104 S%(temp)s
  input:
    - name: 温度(℃)
      parameter: temp
      default: 200
      slider:
        min: 170
        max: 250

4. G代码脚本

执行复杂的G代码脚本模板：

- name: 打印测试方块
  script: custom/test_cube.gco

5. 打印机反馈显示

捕获并显示打印机返回的信息：

- name: 获取位置
  command: M114
  regex: "X:([-+]?[0-9.]+) Y:([-+]?[0-9.]+) Z:([-+]?[0-9.]+) E:([-+]?[0-9.]+)"
  template: "当前位置: X={0}, Y={1}, Z={2}, E={3}"

高级功能特性

输入参数配置

自定义控件可以包含多种输入元素：

文本输入框
滑块控件（可配置范围、步长）
默认值设置

input:
  - name: 移动距离(mm)
    parameter: distance
    default: 10
    slider:
      min: 1
      max: 50
      step: 1

确认对话框

对于关键操作，可以添加确认提示：

- name: 重置EEPROM
  command: M502
  confirm: 确定要重置EEPROM设置吗？此操作不可逆！

JavaScript集成

通过JavaScript代码扩展控件行为：

- name: 自定义操作
  javascript: |
    if (confirm("执行自定义操作？")) {
      self.socket.sendCommand("M117 操作已执行");
    }

实际应用示例

风扇控制面板

controls:
  - name: 风扇控制
    layout: horizontal
    children:
      - name: 开启风扇
        command: M106 S%(speed)s
        input:
          - name: 风速(0-255)
            parameter: speed
            default: 128
            slider:
              min: 0
              max: 255
      - name: 关闭风扇
        command: M107
        additionalClasses: btn-danger

打印机诊断面板

- name: 诊断工具
  children:
    - name: 获取固件信息
      command: M115
    - name: 获取温度
      command: M105
      regex: "T:([0-9.]+) /([0-9.]+) B:([0-9.]+) /([0-9.]+)"
      template: "喷嘴: 当前={0}℃/目标={1}℃ | 热床: 当前={2}℃/目标={3}℃"
    - name: 紧急停止
      command: M112
      confirm: 确定要紧急停止打印机吗？
      additionalClasses: btn-danger