文档

Erae Lab

17 个章节

简介

什么是 Erae Lab？

Erae Lab 是 Embodme 富有表现力的 MPE 控制器 Erae 2 的配套编辑器。它作为独立桌面应用程序运行于 macOS、Windows 和 Linux 平台，为你提供一个可视化工作空间，用于设计和管理设备上的一切内容：触控区域在表面上的布局、每个区域如何发送 MIDI、它的外观，以及你的项目如何组织。

你在 Erae Lab 中构建的所有内容都会通过 USB 直接传输到 Erae 2。设备连接时，更改会实时同步，因此你在屏幕上设计的内容即刻就能演奏出来。

与 Erae 2 的关系

Erae Lab 本身不发声。它是一个配置工具。Erae 2 是乐器；Erae Lab 则是你塑造它的方式。当你向画布添加一个键盘元素、分配一个 MIDI 通道或选择 LED 颜色时，这些设置会被编码进一个布局，设备固件会在演奏时对其进行解析。

即使没有连接设备，你也可以在 Erae Lab 中工作——设计会作为项目文件保存在你的计算机上，并在重新连接时推送到硬件。有关硬件本身的完整介绍，请参阅《Erae 2 用户手册》第 1 章。

提示： 你可以在 Erae 2 断开连接时打开并编辑项目。随时连接，Erae Lab 都会自动同步你当前的项目。

主要功能

可视化画布——一块 42x24 的 LED 网格画布以 1:1 分辨率镜像 Erae 2 表面。直接在屏幕上拖动、调整大小并排列元素。
项目与布局管理——将你的工作组织成命名的项目，每个项目可容纳多个布局，你可以在设备上的这些布局之间切换。
元素库——包含一系列出厂元素（按键、推子、按钮、键盘、用于启动 Ableton 会话的 LivePad 等）的调色板，外加一个保存元素预设的个人库。
Tune 与 Style 面板——在统一的右侧面板中提供每个元素的 MIDI 设置（通道、音符、CC、MPE 配置）和外观设置（颜色、LED 样式、动画）。
主题选择器——从可用的 UI 主题中进行选择，以自定义 Erae Lab 应用程序的外观。
实时同步——编辑会在数毫秒内推送到已连接的设备，让你能够实时试听更改。
固件更新——Erae Lab 可直接从应用内安装捆绑的 Erae 固件更新。

提示： Erae Lab 与 Erae 2 固件共用同一条发布流水线。需要时，使用“设置”菜单检查应用更新或重新安装受管组件。

本手册的适用对象

本手册面向希望充分发挥 Erae 2 潜能的音乐人、制作人和演奏者。无论你是从零开始构建布局、改编出厂模板，还是设计复杂的多布局演奏配置，每一章都会引导你了解应用程序的某个特定方面。

手册约定

在本手册中：

参数名称以粗体显示（例如，Channel、Note）。
参数值以 代码格式 显示（例如，MPE、CC74）。
截图在适用处通过其说明文字引用。
指向本手册其他章节的交叉引用以链接形式呈现（例如，项目、元素）。
指向 Erae 2 硬件文档的交叉引用使用纯文本：“请参阅《Erae 2 用户手册》第 X 章。”

提示： 在整本手册中留意像这样的提示框，了解快捷操作、最佳实践，以及那些值得在用到之前就知道的内容。

安装与首次启动

Erae Lab 提供适用于 macOS、Windows 和 Linux 的安装程序包。请从 embodme.com 下载，并运行适合您平台的安装程序。

系统要求

	最低配置	推荐配置
macOS	macOS 10.14 (Mojave) 或更高版本，Intel 或 Apple Silicon（通用二进制）	macOS 12 或更高版本
Windows	Windows 10（64 位）	Windows 10/11（64 位）
Linux	Ubuntu 20.04 或同等版本，x86_64	Ubuntu 22.04 或更高版本
内存	4 GB	8 GB 或更多
USB	一个可用的 USB-A 或 USB-C 端口用于连接 Erae 2	---

Erae Lab 以独立模式运行——无需 DAW 或音频接口。发送到 DAW 或合成器的 MIDI 路由由 Erae 2 固件通过 USB 直接处理。

下载与安装

访问 embodme.com 并进入 Downloads（下载） 区域。
选择您的操作系统，下载最新的 Erae Lab 安装程序。
运行安装程序并按照屏幕上的提示操作。
从应用程序文件夹（macOS）、开始菜单（Windows）或应用程序启动器（Linux）启动 Erae Lab。

提示： 安装完成后，Erae Lab 会自动检查更新，并在后台安装新版本。无需任何单独的工具。

macOS：Gatekeeper 与代码签名

macOS 版的 Erae Lab 已经过 Apple 代码签名和公证。在大多数情况下，安装程序会直接打开而不会出现任何警告。如果您看到提示称该应用程序来自身份不明的开发者或无法验证，请按以下步骤操作：

打开 系统设置 > 隐私与安全性。
滚动到 安全性 部分。
找到关于 Erae Lab 被阻止的提示，点击 仍要打开。
在出现提示时进行确认。

您只需执行一次此操作。之后，macOS 会记住您的选择。

提示： 在 Apple Silicon Mac 上，Erae Lab 以原生方式运行——无需 Rosetta 转译层。

首次启动

当您首次打开 Erae Lab 时，应用程序会设置您的个人项目文件夹，并将出厂项目库复制到您的计算机上。此过程会自动完成，只需片刻。

快速上手：打开已有作品

使用左侧边栏的 Projects（项目） 区域来加载、导入和管理您的作品：

双击某个项目行即可加载该项目。
右键点击任意项目行可打开项目菜单：Rename（重命名）、Duplicate（复制）、Delete（删除）、Import...（导入...）、Export...（导出...） 以及 Open Projects Folder（打开项目文件夹）。
要导入完整项目，请从该右键菜单中选择 Import...（导入...），然后选择 .erproj 文件、.eraeproject 文件或导出的项目文件夹。
要导入单个布局，请先选择目标布局插槽，然后使用工具栏中的布局导入/打开按钮，或将布局文件拖放到 Erae Lab 上。

给 v1 用户的提示： 旧的 .emk 文件是布局文件，而非完整项目。请将 .emk 导入到当前活动项目的当前布局插槽中。当您想导入整个项目时，请使用 .erproj 文件或导出的项目文件夹。

自动加载上次的项目

首次启动之后，Erae Lab 会记住您上次关闭应用程序时打开的项目。在后续启动时，它会立即重新打开该项目，让您无需任何额外步骤即可从上次中断的地方继续。

出厂项目初始化

首次运行时，Erae Lab 会检查您的项目文件夹中是否存在出厂项目内容。如果不存在，它会从应用程序包中复制一组出厂项目。这些项目为键盘、鼓垫以及侧重演奏的布局变体等常见配置提供了现成的起点。

出厂项目会被安装到您的常规项目库中，而不是作为锁定的模板保留。您可以像操作任何其他 Erae Lab 项目一样，对它们进行打开、编辑、重命名、复制、删除、保存和还原。捆绑的出厂源文件保留在应用程序安装程序中，因此在需要时，重新安装或更新出厂内容可以重新创建原始的起点。

提示： 出厂项目是了解元素如何配置的绝佳方式。打开一个项目，浏览画布和设置面板，并随意修改它。只有当您想保留自己变体的独立副本时，才需要复制它。

连接 Erae 2

在启动 Erae Lab 之前或之后，将 Erae 2 插入任意可用的 USB 端口。应用程序会自动检测设备。建立连接后，顶部栏中的连接指示灯会亮起，活动项目将同步到设备。

在 macOS 或 Windows 上，您无需安装驱动程序——Erae 2 会显示为标准的 USB MIDI 设备。在 Linux 上，Erae Lab 会自动检测 USB 权限。如果未检测到设备，会出现 Fix Now（立即修复） 通知。点击它并输入您的管理员密码即可安装 udev 规则。

提示： 如果 Erae Lab 未能检测到您的设备，请尝试更换 USB 线缆或端口。某些无源 USB 集线器可能会导致无法检测。直接连接到计算机始终是最可靠的方式。

自动保存

Erae Lab 会在任何编辑后几乎立即自动保存您的项目。您无需记住任何手动的文件保存按钮。当某个项目行显示保存/还原控件时，该项目实际上已经保存在磁盘上；这些控件管理的是一个您可以随时返回的快照基线。详情请参阅项目。

故障排除

应用程序在 macOS 上无法打开

请参阅上文的 Gatekeeper 说明。如果在点击 仍要打开 后问题仍然存在，请尝试从 embodme.com 重新下载安装程序并再次运行。

连接后未检测到设备

检查 USB 线缆是否为数据线，而非仅供充电的线缆。
尝试直接连接到计算机，而不是通过集线器连接。
在设备已插好的情况下重启 Erae Lab。
在 Linux 上，如果 Erae Lab 中出现 Fix Now（立即修复） 通知，请点击它并输入您的管理员密码以安装 udev 规则，然后重新连接设备。

项目文件夹位置

默认情况下，Erae Lab 将项目存储在其应用数据文件夹下的 EraeLab/projects 中：

操作系统	默认项目文件夹
macOS	`~/Library/Application Support/Embodme/EraeLab/projects`
Windows	`%APPDATA%\Embodme\EraeLab\projects`
Linux	`$XDG_DATA_HOME/Embodme/EraeLab/projects`，当未设置 `XDG_DATA_HOME` 时则为 `~/.local/share/Embodme/EraeLab/projects`

要快速访问该文件夹，请右键点击 Projects（项目） 区域中的某个项目，然后选择 Open Project Folder（打开项目文件夹）。这会打开 Erae Lab 在您系统上实际使用的具体位置。

如需进一步的诊断，请参阅故障排除。

界面概览

本章将带你了解 Erae Lab 窗口的主要区域。在深入细节之前先弄清各部分的位置，会让后续每一章都更易于理解。

Full Window

窗口布局

Erae Lab 窗口围绕中央画布划分为五个区域：

区域	位置	用途
顶栏	顶部条	Lab/Sound 控件、项目名称、编辑工具、错误报告、设置、设备状态
左侧边栏	左侧列	项目库与元素调色板
中央画布	中央区域	Erae 2 操作面的可视化呈现
右侧设置面板	右侧列	各元素的 Tune（调音）与 Style（样式）设置
Learn 面板	中央区域底部	针对指针所悬停控件或区段的上下文帮助
底栏	底部条	应用程序版本与版权信息

下文将详细介绍每个区域。后续章节会对各区域中的控件做更深入的说明。

顶栏

Top Bar

顶栏横贯窗口的整个宽度，并始终保持可见。根据当前模式和已安装的组件，它包含以下内容：

Lab / Sound 切换 —— 在 Erae Lab 编辑与托管的 EraeSound 控件之间切换（当 EraeSound 可用时）。
Sound 电源 —— 启动或停止托管的 EraeSound 引擎。
项目名称 —— 显示当前活动的 Lab 项目。
编辑工具 —— 用于画布操作的复制、撤销、重做、删除和旋转按钮。
错误报告按钮 —— 在可用时打开应用内错误报告流程。
设置齿轮 —— 打开设备、音频/MIDI、更新及组件设置。
E 标志状态 —— 显示当前 Erae 的连接状态。

Embodme 标志

E 标志位于顶栏最右侧。它同时充当设备连接指示器：其颜色会根据当前 EraeStatus 变化 —— 已连接时点亮，未连接时变暗，检测到设备错误时显示警告色。

项目名称

当前项目名称以标签形式显示在顶栏中。每当你从左侧边栏切换项目时，它都会更新。此处的标签为只读 —— 要重命名项目，请在左侧边栏的 Projects（项目）区段中右键点击它。

编辑工具按钮

一排图标按钮可快速访问最常用的画布操作：

按钮	操作
复制	复制所选元素并放置在原元素旁边
撤销	撤回上一次更改（也可使用 `Cmd+Z` / `Ctrl+Z`）
重做	重新应用已撤销的更改（也可使用 `Cmd+Shift+Z` / `Ctrl+Shift+Z`）
删除	从画布中移除所选元素
逆时针旋转	将所选元素逆时针旋转 90 度
顺时针旋转	将所选元素顺时针旋转 90 度

提示： 大多数编辑操作也支持键盘快捷键。完整列表参见快捷键与交互。

设备连接指示器

顶栏最右侧的 E 标志充当连接指示器。其颜色反映当前 EraeStatus：已连接（点亮）、未连接（变暗）或错误（警告色）。当指示器变暗时，Erae Lab 仍可完整使用 —— 你可以编辑项目，它们会在设备下次连接时同步。

左侧边栏

Left Sidebar Projects

左侧边栏是一条贯穿窗口整个高度（不含顶栏和底栏）的窄列。它包含 Projects（项目）和 Elements（元素）两个区段。可用它在项目间切换、管理布局，以及将元素拖到画布上。

Projects 区段

Projects 区段列出你 Erae Lab 库中的每一个项目。每一行代表一个项目，显示其名称以及一排小型布局缩略图 —— 该项目每个布局插槽对应一个缩略图。

Left Sidebar Projects

你可以在这里执行的操作：

展开或折叠项目 —— 点击项目名称以显示或隐藏其布局缩略图。
加载项目 —— 双击未激活的项目名称即可加载它。
重命名活动项目 —— 双击活动项目名称即可就地重命名。
切换布局 —— 点击活动项目行中的某个布局缩略图，将画布切换到该布局。双击未激活项目的缩略图，可在该布局处打开那个项目。
新建项目 —— 使用该区段顶部的 + 按钮。
重命名项目 —— 右键点击项目行并选择 Rename（重命名）。
复制项目 —— 右键点击并选择 Duplicate（复制）。
删除项目 —— 右键点击并选择 Delete（删除）。如果删除最后一个项目，Erae Lab 会自动创建一个新的空项目。
导入或导出项目 —— 右键点击项目行并选择 Import...（导入）或 Export...（导出）。同一菜单还包含 Open Projects Folder（打开项目文件夹）。
在项目间拖动布局 —— 从一个项目行拖动布局缩略图，并放到另一行的某个布局插槽上，即可复制或移动它。
保存项目快照 —— 当实时项目与其快照基线不同时，点击每行的 Save（保存）图标，将当前已存盘的磁盘状态接受为新的快照。
还原到快照 —— 点击每行的 Revert（还原）图标，恢复到最近的快照基线并丢弃该项目的实时更改。

活动项目会被高亮显示。该项目内的活动布局也会在其缩略图中被高亮。

提示： Erae Lab 几乎会在任何更改后立即自动保存。即使某个项目显示了 Save/Revert 控件，它也并非在等待写入磁盘。Save 会创建一个快照检查点；Revert 则恢复到最近的检查点。

有关项目管理的完整说明，参见项目。有关布局相关操作，参见布局。

Elements 区段

Elements 区段是你用于构建布局的调色板。它包含所有可拖到画布上的构建块。

Left Sidebar Elements

该区段分为两个子组：

Factory 元素

上方的组显示 Erae Lab 自带的内置元素类型。每个出厂元素都显示为一个小方形缩略图，预览该元素默认的 LED 外观。可用的元素类型包括：

Key —— 单个压力感应触控板，通常用于音符或和弦。
Fader 1D —— 一维推子，当你沿其滑动时发送连续的控制值。
Fader 2D —— 二维触控板，发送两个独立的连续值（X 轴和 Y 轴）。
Iso Keyboard —— 跨多行的同构键盘布局。
Chroma Keyboard —— 采用钢琴式黑白键配色的半音阶键盘。
Drumpad Keyboard —— 为鼓组编程而排布的触控板网格。
Button —— 一种统一的按钮元素，输出模式可选：Note、Control Change、Program Change、Control Voltage 或 Tap Tempo。模式通过设置面板中的 Type（类型）参数切换，因此只有一种 Button 类型，而非独立的 Note/CC/PC 按钮元素。
LivePad (Ableton Launchpad) —— 一个专用的 Ableton Live 会话启动操作面，模拟 Launchpad 协议。来自 Live 的 LED 颜色反馈会反映在 Erae 2 操作面上。
API Zone —— 一个可编程区域，通过 Erae USB API 协议向外部应用程序传递原始的多点触控数据，适用于自定义或开发者用例。

要将任意出厂元素添加到画布，从该区段拖出并放到画布上即可。Erae Lab 会在你放置点附近找到最合适的可用空间。

My Elements

下方的组显示你的个人元素预设 —— 即你之前从画布中以自定义配置保存的元素。它们以 4 列网格中的缩略图单元格形式显示，按类型和名称排序，并支持就地重命名。

要将画布上的元素保存为预设，将它从画布拖入 My Elements 区域。要重命名或删除预设，右键点击其缩略图。

提示： 元素预设会一并捕获元素的类型、尺寸、MIDI 设置和外观。可用它们在多个布局或项目间快速复制某个配置。

有关每种元素类型及其设置的详细说明，参见元素。

画布

中央画布是主工作区。它将 Erae 2 操作面可视化呈现为 42 列 × 24 行的网格 —— 物理设备上每个 LED 对应一个单元格。

你放置在画布上的每个元素都占据该网格中的一块矩形区域。画布会按各元素配置的 LED 样式进行渲染，因此视图会非常接近你在设备操作面上看到的效果。

在画布上操作

操作	结果
点击元素	选中它，并在右侧设置面板中填入其参数
拖动元素	将它移动到新位置；Erae Lab 会检查重叠并将放置约束到网格内
点击空白处并拖动	绘制选择矩形以一次选中多个元素
从 Elements 区段放置	在放置位置放下一个出厂或预设元素
右键点击	打开包含复制、粘贴、删除和旋转选项的上下文菜单

提示： 使用 Cmd+A（macOS）或 Ctrl+A（Windows/Linux）一次选中当前布局上的所有元素。选中多个元素后，右侧设置面板会显示可批量编辑的共享参数。

在主画布网格下方，两个标记为 A 和 B 的小区域代表 Erae 2 的踏板输入。点击某个踏板区域会打开其专用的 Pedal（踏板）设置面板 —— 它独立于画布元素面板 —— 你可在其中配置踏板类型和 MIDI 路由。

有关在画布上操作的完整指南，参见画布。

Learn 面板

Learn 面板在中央区段底部、画布下方拥有自己专属的区域。当你悬停控件、项目行、元素预设、画布元素和设置时，它会更新显示上下文帮助。这样既能保持指引可见，又不会占用 Projects 和 Elements 侧边栏的空间。

右侧设置面板

当画布上有元素被选中时，右侧设置面板会显示其配置。该面板有两个选项卡：Tune（调音）和 Style（样式）。

Tune 选项卡

Tune 选项卡包含所选元素的所有 MIDI 相关设置。你在此看到的内容取决于元素类型 —— key 元素显示音符、通道和 MPE 设置；fader 显示 CC 编号、范围和通道；button 显示其触发模式和消息类型。

Tune 选项卡中常见的参数：

参数	控制内容
Channel	MIDI 通道（1–16，或选 `MPE` 以使用逐音色模式）
Note	发送音符的元素所用的 MIDI 音符编号
CC	发送 CC 的元素所用的 Control Change 编号
Min / Max	推子及连续元素的输出值范围
Mode	元素行为，例如可用时的瞬时（momentary）或开关（toggle）模式

提示： 选中多个元素时，Tune 选项卡只显示所有所选类型共有的参数。编辑某个共享参数会同时更新所有所选元素。

有关按元素类型对 Tune 参数的完整分解，参见 MIDI 设置。

Style 选项卡

Style 选项卡控制所选元素的视觉外观 —— 即它在 Erae 2 操作面上的样子。

Style 选项卡中的关键参数：

参数	控制内容
Color	元素激活或空闲状态的 LED 颜色
Brightness	LED 的整体亮度
Style	灯光图案（纯色、渐变、放射状等）
Key Style	用于键盘元素：白键与黑键的逐键颜色分配

使用此选项卡可直接编辑所选元素的颜色和动画。

提示： 在已连接的 Erae 2 上，Style 选项卡会实时更新。你可一边观察设备一边调整颜色和亮度 —— 无需手动保存或推送。

有关所有外观选项的完整说明，参见外观与样式。

底栏

Bottom Panel

底栏是窗口最底部的一条窄条。它显示：

应用程序版本 —— 当前 Erae Lab 的版本号（例如 Erae Lab 2.0.3）。
版权声明 —— Embodme 的版权信息。

更新提示和组件安装进度由更新程序、设置菜单或弹出通知（toast）显示，而非由底栏显示。

接下来

现在你已掌握了界面的整体地图，以下各章将深入介绍每个区域：

项目 —— 创建、切换和组织项目。
布局 —— 在一个项目中管理多个布局。
画布 —— 放置和编辑元素。
元素 —— 每种元素类型及其设置。
MIDI 设置 —— Tune 面板的全部细节。
外观与样式 —— Style 面板与 LED 颜色。
预设 —— 元素预设。
设备同步 —— Erae Lab 如何与 Erae 2 通信。

第 4 章 — 项目

项目是 Erae Lab 工作的顶层容器。每个项目包含八个布局（旧版 Erae 项目最多可达 32 个）、一个项目名称以及项目元数据。项目以文件夹的形式存储在你的电脑上，并自动与已连接的 Erae 2 设备同步。

项目侧边栏

左侧面板的 Projects（项目） 部分会列出你库中的每个项目。每一行显示：

项目名称，点击可展开或折叠该行。
一个最多包含八个布局缩略图的网格，以两行四列的形式排列，每个缩略图都显示该布局内容的微缩预览。已填充的槽位会高亮显示；空槽位则显示为变暗的占位符。
当项目当前已加载到已连接的 Erae 2 上时，会显示一个设备徽章（例如 MK2）。

点击项目名称可展开或折叠其布局缩略图。双击一个非活动项目的名称即可加载该项目。双击活动项目的名称可就地重命名。按 Enter 确认重命名，或按 Escape 取消。

点击活动项目行中已填充的缩略图可切换到该布局。双击非活动项目行中的缩略图，可在该布局处打开该项目。点击空槽位可在该槽位创建一个新布局。

右键点击某个项目行可打开项目菜单。它包含 Rename（重命名）、Duplicate（复制）、Delete（删除）、Import...（导入…）、Export...（导出…） 以及 Open Projects Folder（打开项目文件夹）。右键点击某个布局缩略图可复制、粘贴或清除该布局槽位。

创建新项目

要创建新项目，请点击项目侧边栏顶部的 + 按钮。Erae Lab 会以默认名称（Untitled）和单个空布局初始化该项目。新项目会立即成为活动项目。

首次启动时——或在项目库为空时——Erae Lab 会自动填充出厂内容，因此你始终有一个起点可供探索。

出厂项目一旦被复制到你的库中，就是普通的可编辑项目。你可以直接修改它们，或者先复制一份，以便在你自己的库中保留一份未改动的副本。

加载项目

点击侧边栏中的任意项目行即可加载它。活动项目会高亮显示，其第一个布局会被发送到已连接的设备。

你也可以从库之外打开项目文件：

在 Projects（项目） 侧边栏中右键点击某个项目行，并选择 Import...（导入…）。
浏览并选择一个 .erproj 旧版 XML 文件、一个旧版 .eraeproject 文件、一个当前的项目文件夹，或者某个受支持的项目组成部分。
Erae Lab 会读取该项目，将其添加到库中，并激活它。

你也可以使用工具栏的加载/导入按钮，或将受支持的文件直接拖放到 Erae Lab 窗口上。

旧版 .emk 布局文件也可以单独导入：

选择该布局应放入的项目和布局槽位。
使用工具栏中的布局导入/打开按钮，或将 .emk 文件拖放到 Erae Lab 上。
Erae Lab 会用导入的布局替换活动布局槽位，并像处理其他任何布局编辑一样同步该更改。

给 v1 用户的提示： .emk 文件是单独的布局。它们不会作为独立项目出现在项目侧边栏中。当你想导入完整项目时，请使用 .erproj 文件或导出的项目文件夹。

上次项目自动加载： Erae Lab 启动时，会自动重新打开你上次激活的项目，让你能够准确地从上次中断的地方继续。

保存

Erae Lab 会自动保存你的项目。对项目的任何更改——移动元素、调整参数、切换布局——都会触发一个约 300 ms 的短暂自动保存计时器。一旦计时器在没有进一步编辑的情况下触发，项目就会被写入磁盘。保存是精细化的：只有自上次保存以来确实发生更改的布局和项目数据才会被写入，从而将磁盘活动降到最低。

提示： 自动保存的去抖动机制会将快速的连续编辑（例如实时拖动某个元素）合并为一次写入，在你暂停后才执行写入，而不是在每次鼠标移动时都写入。

保存与还原快照

自动保存会让项目文件保持最新。即使项目侧边栏显示了保存/还原控件，你最新的编辑也已经保存到磁盘了。这些控件的含义并不是"现在写入此项目"；它们管理的是一个返回快照。

每个项目都有一个明确的快照基准：你通过项目行上的 Save（保存） 按钮接受的最后一个版本。它让你能够自由地尝试编辑、跨多次启动持续工作，并随时返回到之前接受的版本。

当某个项目与其快照基准不同时，项目侧边栏中该项目行上会出现两个小图标：

项目保存/还原控件

Save snapshot（保存快照） — 将项目当前保存在磁盘上的字节捕获为新的快照基准。此操作之后，保存和还原图标会消失，直到你再次进行更改。
Revert snapshot（还原快照） — 从最后一个快照基准恢复项目。这会丢弃自上次保存快照以来所做的更改。

如果被还原的项目已连接到某个 Erae 2，Erae Lab 会将其标记为通过正常同步流程同步回设备。如果设备已断开连接，被还原的项目仍会被标记为待同步，并将在下次可以同步时被推送。

如果快照基准缺失，Erae Lab 只会显示保存图标。如果快照基准已损坏，还原会被禁用，而保存会用当前项目状态替换掉已损坏的快照。

提示： 可以把自动保存理解为"将我当前的工作写入磁盘"，而把项目行的保存理解为"将这个已保存的版本设为我的检查点"。还原会回到那个检查点。

复制项目

右键点击某个项目行并选择 Duplicate（复制）。Erae Lab 会创建该项目的一个独立副本（包括所有布局），并使用一个新名称。第一个副本会被命名为 <Project> Copy；如果该名称已存在，Erae Lab 会添加一个数字后缀。该副本会被添加到库中，并成为活动项目。

删除项目

右键点击某个项目行并选择 Delete（删除）。Erae Lab 会立即将该项目从活动库中移除，并且应用内没有撤销操作。Erae Lab 不会立即永久擦除数据，而是将该项目归档到其应用数据归档文件夹中，并使用带时间戳的名称命名。同时还会写入一条删除记录，以便同步能够将该删除操作传播到已连接的设备。

如果你删除了最后一个剩余的项目，Erae Lab 会自动重置为一个新的空白 Untitled 项目，以便应用程序始终有一个活动项目。

提示： 归档的项目会保留 7 天，之后会被自动清除。如果你不小心删除了某个项目，请在清除时限到期之前，使用应用的文件夹/打开文件夹操作，或联系支持人员来定位应用数据归档文件夹。

导出项目

要分享项目或在库之外备份它：

右键点击该项目行并选择 Export…（导出…）。
会打开一个文件选择器。选择一个目标文件夹。
Erae Lab 会将所选项目行的完整项目文件夹——头文件、布局、共享项目数据以及 Lab 管理的元数据——复制到该位置。

导出的文件夹可以在任何运行 Erae Lab 的机器上重新导入。

提示： 导出的项目文件夹是自包含的。你可以将它们压缩后通过电子邮件发送、存储到云存储中，或者提交到版本控制系统。

导入项目

要将项目引入你的库：

在 Projects（项目） 侧边栏中右键点击任意项目行，并选择 Import...（导入…）。
选择一个 .erproj 旧版 XML 文件、旧版 .eraeproject 文件、当前项目文件夹，或受支持的项目组成部分。
Erae Lab 会读取该项目，使用自动递增的后缀解决任何名称冲突，并将其添加到库中。

你也可以将受支持的项目文件或文件夹直接拖放到 Erae Lab 窗口上。

导入项目文件夹时，Erae Lab 会丢弃导入的 snapshot/、snapshot.tmp、snapshot.old 和 .live_stamp 状态，然后为导入的副本创建一个全新的本地快照基准。这可以防止另一台机器的快照/检查点状态影响你本地的保存/还原控件。

你也可以使用工具栏中的布局导入/打开按钮，或将文件拖放到 Erae Lab 上，来导入单独的布局文件（.eraebin 或旧版 .emk 格式）。该布局会被放入活动项目的当前布局槽位中。

项目文件夹格式

项目文件夹包含若干二进制部分。当前的项目头文件存储为 settings.eraebin；旧版 .eraeproject 头文件仍可兼容导入，但不是当前的主要格式。每个 .eraebin 部分都以一个 5 字节的头部开始，其中包含一个格式版本标记和一个负载哈希值，以确保加载时的完整性。各个布局、项目头文件和共享项目数据都分别作为单独的文件存储在项目文件夹层级结构中：

MyProject/
  settings.eraebin         ← project header
  project_elements.eraebin ← shared project elements
  sync.eraebin             ← sync metadata (dirty flags, device ID)
  .live_stamp              ← Lab-managed live edit marker
  snapshot/                ← accepted Save/Revert checkpoint
    .snapshot_stamp        ← snapshot marker
  layout_0/
    data.eraebin           ← layout data
  layout_1/
    data.eraebin
  ...

项目文件夹是一个普通目录——你可以在 Finder 或资源管理器中查看它、复制单个布局文件，或使用任何标准文件工具备份它。snapshot/、.live_stamp 和 snapshot/.snapshot_stamp 由 Erae Lab 管理。sync.eraebin 存储同步状态，并被排除在快照比较之外。

工具栏设备操作

工具栏提供两种用于在 Erae Lab 和已连接设备之间传输项目的操作：

Send to Device（发送到设备） — 将当前项目从你的电脑推送到已连接的 Erae 2，用你的最新版本覆盖设备上存储的项目。
Receive from Device（从设备接收） — 将当前存储在已连接 Erae 2 上的项目拉回到 Erae Lab，这在需要从一个已与电脑副本产生分歧的设备恢复时很有用。

当设备已连接且活动项目与设备的项目槽位匹配时，这些操作会在工具栏中可用。

项目库位置

默认情况下，项目存储在 Erae Lab 应用数据文件夹的 EraeLab/projects 下：

操作系统	默认项目文件夹
macOS	`~/Library/Application Support/Embodme/EraeLab/projects`
Windows	`%APPDATA%\Embodme\EraeLab\projects`
Linux	`$XDG_DATA_HOME/Embodme/EraeLab/projects`，或在未设置 `XDG_DATA_HOME` 时为 `~/.local/share/Embodme/EraeLab/projects`

归档存储在它旁边的 EraeLab/archive 下。要跳转到活动项目的文件夹，请在 Projects（项目） 部分右键点击某个项目并选择 Open Project Folder（打开项目文件夹）。这是为你的操作系统和安装类型显示确切位置的最安全方式。

有关在项目内处理布局的详细信息，请参阅第 5 章 — 布局。

第 5 章 — 布局

布局是分配到项目某个布局槽位中的元素画布。每个布局都是独立的：它拥有自己的一组元素，以及各自的视觉/MIDI 配置。在 Erae 2 上切换布局时，新的布局会实时发送到设备。

每个项目的布局

Erae 2 项目正好包含八个布局槽位，编号从 0 到 7。旧版 Erae 项目最多可拥有 32 个布局槽位。槽位可以为空，也可以已填充。空槽位不含任何元素，在设备上不占用任何空间；已填充的槽位则保存着一份完整的画布配置。

“项目”侧边栏会在每个项目名称的正下方，以两行各四个小缩略图的形式显示该项目的布局槽位。已填充的槽位会渲染其所含元素的微型预览；空槽位则显示为暗淡的占位符。这让你一眼就能看清每个项目的填充密度。

**提示：**每个布局最多可容纳 256 个元素。此上限是针对每个布局的，而非每个项目。在构建密集配置之前，请先规划好每个布局内的元素分布。

布局选择器面板

布局选择器面板横贯中央画布区域的顶部。它显示八个带编号的按钮，每个布局槽位对应一个。

已填充的槽位会以彩色指示器显示。
空槽位显示为暗淡（灰色）。
当前激活的布局会被高亮显示。

点击任意按钮即可切换到该布局。画布会立即更新以显示所选布局的元素，同时该布局会被推送到已连接的设备。

**提示：**你可以使用键盘快捷键来切换布局。完整列表请参阅第 15 章 — 快捷键与交互。

布局操作

在“项目”侧边栏中右键点击某个布局缩略图（或使用布局选择器面板中的布局槽位上下文菜单），即可访问以下操作：

操作	说明
重命名	打开布局的内联重命名输入框。按 Enter 确认，或按 Escape 取消。
复制副本	在同一项目内的下一个可用槽位中创建该布局的独立副本。
拷贝	将布局拷贝到内部剪贴板，以便粘贴到另一个槽位或项目中。
删除	从槽位中移除该布局。槽位将变为空；此操作可撤销。

提示：在进行重大编辑之前，请使用复制副本，以便在相邻槽位中保留一个已知良好的布局版本。

布局浏览器

左侧面板的布局区域提供一个可浏览的网格，展示库中所有项目的全部布局。每张卡片都显示一个缩略图预览、布局名称及其所属项目名称。

使用顶部的搜索框可按布局或项目名称进行筛选。切换 Fav 按钮可仅显示你标记为收藏的布局。

点击某张布局卡片会将该布局加载到画布中——如果其所属项目尚未激活，也会一并加载。

在项目之间拖放

你可以在“项目”侧边栏中拖动布局缩略图，将布局从一个项目移动或拷贝到另一个项目：

在“项目”侧边栏中，展开源项目行和目标项目行。
从源项目中拖动一个布局缩略图，并将其放到目标项目行中的某个槽位上。
布局数据会被拷贝到目标槽位中。

如果目标槽位已被填充，则现有布局会被替换。此操作可在项目层级撤销。

**提示：**在项目之间拖动布局，是从多个现有项目中精选最佳布局来快速组建新项目的便捷方法。

作为容器的布局

布局是元素的容器——它本身除了一个名称和一份元素定义列表之外，不保存任何内容。所有视觉和行为属性都存在于放置在该布局内的元素上。

撤销和重做作用于项目操作，其中包括布局编辑。当你切换布局时，Erae Lab 会保留足够的上下文，以便安全地撤销近期与布局相关的编辑。

有关如何在布局内放置、移动和配置元素的内容，请参阅第 6 章 — 画布。

画布

画布是当前布局的中央工作区。它将 Erae 表面表示为一个 42 x 24 的网格，与 Erae 2 的可演奏区域相对应。

放置元素

将一个受支持的元素从 Elements 区域拖到画布上。拖动时，Erae Lab 会显示放置预览。松开鼠标即可放置该元素。

如果放置位置与另一个元素重叠，或者超出网格范围，Erae Lab 会拒绝此次放置。请尝试其他位置，或先调整附近元素的大小。

也可以从 Elements 区域的 User 区拖出元素预设。它们会根据该预设保存的大小、行为和外观创建一个新元素。

移动、调整大小与旋转

移动 -- 将选中的元素拖到新的网格位置。
调整大小 -- 拖动选中元素周围显示的控制柄。
旋转 -- 当选中的元素支持旋转时，使用工具栏上的旋转按钮。
拖动复制 -- 拖动时按住 Alt（macOS 上为 Option），即可复制而非移动。

Erae Lab 会阻止元素相互重叠。当多个选中的元素一起移动时，它们会保持彼此之间的相对位置，并与所有未选中的元素进行检测。

多选

可以通过两种方式选择多个元素：

套索选择 -- 在空白画布区域拖动，选中矩形框所触及的每一个元素。
Cmd/Ctrl 点击 -- 在 macOS 上按住 Cmd，或在 Windows/Linux 上按住 Ctrl，同时点击某个元素，即可将其加入或移出当前选择。

使用 Cmd+A / Ctrl+A 选中当前布局中的所有元素。

撤销与重做

Erae Lab 会将画布编辑记录为可撤销的项目操作。

撤销 -- Cmd+Z / Ctrl+Z
重做 -- Cmd+Shift+Z / Ctrl+Shift+Z

工具栏上也提供了撤销和重做按钮。

复制、粘贴与再制

在选中一个或多个元素时：

复制 -- Cmd+C / Ctrl+C
粘贴 -- Cmd+V / Ctrl+V
再制 -- Cmd+D / Ctrl+D
删除 -- Backspace 或 Delete

在同一布局内再制或粘贴时，可能会调整 MIDI CC 或 CV 分配以避免冲突。跨布局粘贴时会保留所复制元素的数据，除非 Erae Lab 需要解决冲突。

布局拖放

可以将 Projects 侧边栏中的布局缩略图拖到某个布局槽位上，以复制或替换该槽位的布局。这在基于现有布局创建新项目时非常有用。

设备实时更新

当连接了 Erae 设备时，画布编辑会被自动保存，并在编辑稳定后发送到设备。你无需在每次更改后再执行常规的手动推送/拉取步骤。

元素

元素是布局的构成单元。Erae Lab 目前支持以下类型的元素。

键盘类

同构网格（Keygrid）

一种用于基于音程演奏的同构网格。非常适合演奏和弦、便于移调的演奏模式，以及富有表现力的演奏。

钢琴键盘（Keyboard）

钢琴式的半音阶布局，适合希望使用熟悉的音符排列方式的用户。

鼓垫（Drumpad）

为鼓组与打击乐布局优化的垫块网格。

连续控制类

一维推子（Fader 1D）

单轴推子，可用于控制音量、截止频率或发送量等数值。

二维推子（Fader 2D）

一个 XY 触控板，可同时控制两个数值。

触发器与垫块

按钮（Button）

一种可配置的触发元素。根据具体配置，它可以发送音符、CC、程序切换、CV 或点击定速（tap-tempo）等动作。

键（Key）

单个富有表现力的音符垫块。适合用作大尺寸的单触发垫块、持续音（drone）或专用的演奏触发器。

集成与实用元素

Ableton Launchpad

针对受支持工作流程的 Ableton Live 会话控制界面。

API 区域（API Zone）

一块可编程的触控区域，可向外部软件公开原始触控数据。

踏板输入（Pedal Input）

一种非触控表面元素，可将连接的踏板输入映射到 MIDI 或 CV 行为。

使用元素

对于每一种受支持的元素，常规工作流程都是相同的：

将它从侧边栏拖到画布上。
调整它的大小并放置位置。
在 Tune 标签页中调整它的行为。
在 Style 标签页中设置它的 LED 样式。

MIDI 设置

Tune 面板控制每个受支持的元素如何发送 MIDI 和 CV 数据。

通用设置

大多数可演奏元素都共享以下核心参数：

MIDI Channel
MIDI Group
Trigger on Entry
相关情况下的音符范围或根音
CC 分配
受支持时的 CV 分配

速度映射使用手指检测器的连续运动速度，而非 note-on 力度。该数值经过平滑和归一化处理，因此 0 cm/s 为最小值，100 cm/s 达到所配置的 CC 或 CV 最大值。

MIDI 输出目标

每个元素都可以发送到任意可用目标的组合：

USB Device —— Erae 在你的电脑上显示为一个 USB MIDI 设备
TRS MIDI A / TRS MIDI B —— 物理 TRS MIDI 输出插孔
USB Host —— 用于直接连接到 USB MIDI 主机设备

禁用所有输出即可在不删除某个元素的情况下将其静音。

键盘

键盘类元素允许你配置：

根音和八度
网格上的音符布局
pitch bend 范围
压力、揉弦及滑音风格的表现力
可选的位置、压力和速度 CC 映射

对于 UI 中显示的内置音阶选项，可进行音阶选择。

推子

受支持的推子有：

Fader 1D
Fader 2D

它们提供：

初始值
绝对轴映射
压力映射
受支持时的速度映射
受支持时的 CV 路由

按钮与琴键

按钮和琴键可根据元素类型配置为音符、CC、程序切换、CV 或点击定速（tap-tempo）等行为。

MPE 与表现力

在受支持的情况下，MPE 与表现力设置控制如何将手指压力和运动转换为 MIDI。请在你的目标合成器中匹配 pitch bend 范围，以获得正确的行为。

踏板输入

踏板输入带有一个 Type 选择器，可在受支持的踏板模式之间切换，例如开关、延音、底鼓和表情踏板行为。Tune 面板会随之变化，显示所选踏板类型的参数。

外观与样式

样式（Style） 标签页用于控制元素在 Erae 表面上的显示效果。

可编辑的内容

对于支持的元素，你可以配置：

颜色
渐变
边缘样式
触摸动画
跨多选元素的统一样式更新

拾色器

在样式标签页中点击某个颜色控件即可打开拾色器。使用色相环、饱和度/明度区域或十六进制输入框，来选择应用于所选样式属性的颜色。

键盘样式

键盘类元素根据具体元素支持按音级或按音符着色。这样可以让根音、可演奏区域以及演奏区域在视觉上始终保持清晰。

推子样式

推子为其活动区域、边缘和背景提供了直接的颜色控件，让当前位置始终清晰易读。

多选编辑

当选中多个元素时，在样式标签页中所做的更改会同时应用于全部所选元素。在所选元素中取值不一致的颜色项会显示为 Mixed（混合），直到你为其指定新的值为止。

预设

本手册介绍当前版本中可用的预设工作流程。

元素预设

元素预设会保存一个已配置好的画布元素，以便日后重复使用。预设会记录元素的类型、尺寸、MIDI/CV 行为以及外观设置，但不会保存元素在画布上的当前位置。

保存元素预设

要保存元素预设，请将一个元素从画布拖入元素区的 User 区域。Erae Lab 会创建一个新的预设条目，可在任意项目中重复使用。

加载元素预设

将元素区 User 区域中的某个元素预设拖到画布上。Erae Lab 会使用所保存的配置创建一个新元素。

重命名与整理

当界面为某个预设提供重命名控件时，可在元素区中重命名用户元素预设。请使用能够描述用途的清晰名称，例如 lead-keygrid-mpe 或 filter-fader-cc74。

Erae Sound 工厂预设

如果已安装 Erae Sound，或通过 Erae Lab 进行宿主加载，其音色预设浏览器中会包含工厂音色预设。这些预设与 Erae Lab 的元素预设彼此独立。

Erae Sound 工厂预设为只读。你可以在工作过程中加载并编辑音色参数，但无法重命名、删除或覆盖工厂预设文件。请在 Erae Sound 中使用 Save As...，以基于工厂预设创建可编辑的用户预设。

第 12 章 — 设备同步

Erae Lab 会在你的项目库与已连接的 Erae 2 硬件之间维持一条实时的双向链路。当你连接设备时，Lab 会将硬件上的内容与你库中的内容进行比对，并自动协调两者——把新建或更新的项目推送到设备，拉取在设备上创建或编辑的项目，并在此过程中解决检测到的任何命名冲突。

有关硬件侧的同步行为，请参阅《Erae 2 用户手册》第 14 章。

系统要求

完整的双向同步需要：

通过厂商 USB 二进制协议连接的 Erae 2（设备上需安装 2.0 或更高版本固件）。
插入 Erae 2 的 SD 卡。同步期间项目会存储到 SD 卡并从中读取。没有 SD 卡则无法进行同步。

注意： 当未连接兼容设备时，设置面板与同步状态指示器会反映断开连接的状态。在 Erae Lab 中于断开连接状态下所做的编辑会被排入队列，并在下次连接到兼容的 Erae 2 时推送。

连接检测

只要设备就绪，Erae Lab 就会通过 USB 自动检测已连接的 Erae 2。无需手动配对步骤。工具栏中的状态指示器会随连接状态而变化：

已断开 — 未检测到设备，或设备正在启动
同步中 — 正在进行项目清单比对与文件传输
已连接 — 同步完成，设备处于空闲状态

已连接同步

提示： 在 Erae Lab 中工作时，请让你的 Erae 2 保持开机并连接。同步引擎会在你编辑时于后台保持设备处于最新状态，因此你的硬件始终反映你最近的工作成果。

注意： 只有当 Erae 2 由其专用 USB 电源供电时，才能保证最佳的 USB 同步性能。通过计算机 USB 端口为设备供电可能引入共享总线的供电限制，从而影响同步可靠性。为获得稳定且一致的设备同步，请始终使用专用电源。

多设备支持

Erae Lab 可以检测到多于一台已连接的 Erae 2。同一时间只有一台设备是 活动设备：这是 Lab 进行编辑、同步、更新以及用于宿主托管 EraeSound 输入的设备。

当连接了多台设备时，请打开设置菜单，并在编辑或同步之前于设备选择器中选择目标设备。所选设备会在多次启动之间被记住。

每台 Erae 2 都带有唯一的硬件标识符。Erae Lab 在协调项目、脏标记、删除墓碑以及同步历史时会使用此标识。这可以防止 Lab 仅仅因为两台不同的物理设备包含名称相同的项目，就将它们视为同一个同步目标。

在以下情况下使用活动设备选择器：

同时连接一台录音室设备和一台演出设备。
想将 Lab 中的更改复制到某一台设备，而不影响另一台已连接的设备。
在直接于硬件上编辑布局之后，需要从某台特定设备拉取编辑内容。
在 Lab 中宿主托管 EraeSound，并需要让它的 MIDI/触控输入跟随某台特定的 Erae。

Lab 与宿主托管的 EraeSound 共享同一个活动设备选择。在 Lab 中更改活动设备也会更改宿主托管 EraeSound 所使用的已连接 Erae。

同步协议

当设备连接时，同步引擎会按一套结构化的顺序运行：

保存到介质 — 在读取清单之前，Lab 请求设备将其活动布局刷新到 SD 卡，以确保不丢失任何内存中的编辑。
请求清单 — Lab 读取设备上的完整项目列表，包括每个项目的名称、唯一 ID、格式版本以及脏标记。
比对清单 — Lab 将设备清单与本地项目库进行比对，构建出一份同步操作列表。
执行操作 — Lab 按顺序逐项处理每个操作：将 Lab 项目推送到设备、将设备项目拉取到 Lab、在名称发生更改时重命名项目，以及删除自上次同步以来在 Lab 中被移除的项目。

同步期间，进度会以 toast 通知的形式显示。当所有操作完成后，引擎返回空闲状态，toast 随之消失。

推送与拉取操作

推送到设备

在以下情况下，项目会从 Lab 推送到设备：

项目存在于 Lab 中但不存在于设备上（新项目）。
项目在两侧均存在，但 Lab 中的副本自上次同步以来已被编辑。

推送会通过厂商 USB 二进制协议，以一次批量传输的方式发送项目的设置文件以及所有布局文件。

从设备拉取

在以下情况下，项目会从设备拉取到 Lab：

项目存在于设备上但不存在于 Lab 中（在设备上创建）。
项目在两侧均存在，但设备上的副本带有 脏标记（自上次同步以来直接在硬件上编辑过）。

拉取的项目文件以原始二进制载荷的形式到达，会先在内存中组装，再写入磁盘。

提示： 直接在 Erae 2 上编辑布局——例如使用硬件控件切换活动布局——会在设备上设置脏标记。当你重新连接时，Lab 会自动拉取更新后的版本。你无需手动发起拉取。

重命名检测

如果某个项目的唯一 ID 在两侧匹配但名称不同，同步引擎会检测到一次重命名。视重命名发生在哪一侧而定：

在 Lab 中重命名 — 从设备上删除旧名称，并以新名称将项目推送过去。
在设备上重命名 — Lab 采用设备上的名称作为新的本地名称。

冲突解决

如果你在两处编辑了同一个项目——一次在 Lab 中，一次直接在 Erae 上——Lab 无法得知你想保留哪个版本。当你重新连接时，它会暂停同步，并通过一条提供三个按钮的通知向你询问：

保留设备版本 · 两者都保留 · 保留 Lab 版本

选择其一，Lab 便会据此完成同步。在你做出选择之前，两侧均不会有任何改动。

各选项的作用

保留设备版本 — Lab 用你 Erae 上的版本替换它的副本。你在 Lab 中对该项目所做的编辑会被丢弃。没有自动备份。

保留 Lab 版本 — Lab 将其版本发送到 Erae，覆盖设备上的副本。你在设备上对该项目所做的编辑会被丢弃。没有自动备份。

两者都保留 — Lab 在你的计算机和 Erae 上并排保留两个版本：

你的 Lab 版本保留其原始名称（例如 My Song）。
Erae 上的那个版本会在末尾加上 _erae 进行重命名（例如 My Song_erae），并作为单独的项目复制到 Lab 中。
同步完成后，两个项目同时存在于 Lab 和设备上。你可以打开它们、进行对比，并在之后删除你不想要的那一个。

如果名为 My Song_erae 的项目已经存在，Lab 会使用 My Song_erae_2，再之后是 _erae_3，以此类推，从而确保任何内容都不会被覆盖。

如果你不确定哪一侧有你需要的更改，请选择“两者都保留”。 这是唯一一个绝不会破坏工作成果的选项。你之后随时都可以清理掉多余的副本。

关闭通知

如果你在冲突通知上点击关闭按钮 (X) 而非进行选择，Lab 会将其视为 保留 Lab 版本——你的 Lab 版本会被推送到 Erae，设备上的更改会被丢弃。当你将鼠标悬停在“关闭”上时，通知本身会提醒你这一点。如果你想先考虑一下，只需把通知留在屏幕上即可：在你做出决定之前，同步会保持暂停。

什么会触发冲突

只有当两侧自上次成功同步以来都存在未保存的更改时，冲突才会出现——即你的 Lab 项目显示有未保存的编辑，并且同一个项目在 Erae 上也被编辑过。如果只有一侧发生了更改，Lab 会直接自动同步那一侧，不会出现通知。

仅闪存项目

设备上的某些项目仅存在于闪存中——它们由某个固件流程写入，且从未迁移到 SD 卡。这些项目在设备清单中被标记为 仅闪存，并被同步引擎视为只读。Lab 不会尝试删除或覆盖仅闪存项目。

活动布局防抖

当你在设备已连接的情况下于 Lab 中主动编辑某个布局时，Lab 不会把每一次按键都推送到设备。相反，它会等到编辑活动空闲达 200 毫秒 后，再发送一次更新后的活动布局推送。这种防抖机制可防止在快速编辑期间产生大量的部分传输。

提示： 在正常编辑过程中，防抖延迟难以察觉。如果你需要设备立即反映某项更改——例如在演出之前——请完成编辑后稍作停顿，或显式保存该项目。

删除墓碑

当你在没有连接任何设备时从 Lab 中删除某个项目，Lab 会记录一条 删除墓碑——一条包含该项目唯一 ID 的持久化记录。下次连接设备时，同步引擎会检查这份墓碑列表，并针对每条记录的条目向设备发送一条 DeleteProject 命令。

如果删除发生时正好有设备连接，删除命令会立即发送，而不会等待下一个连接周期。

提示： 在设备确认删除之后，墓碑会被自动清理。你无需手动管理它们。

同步状态通知

同步引擎通过出现在 Lab 界面中的简短 toast 通知来传达其进度：

当清单比对与文件传输开始时，会出现一条 “同步中…” toast。
该 toast 会随每个正在传输的项目名称而更新。
一条 “同步完成” toast 确认所有操作均已成功完成。
如果在某个同步步骤中发生超时或协议错误，会出现一条错误 toast。重新连接设备会重启同步序列。

提示： 同步错误最常见的原因是在传输过程中短暂拔出了 USB 线缆。重新连接线缆，Erae Lab 会自动从头重启同步。

第 13 章 — 固件更新

Erae Lab 负责为已连接的 Erae 2 硬件处理固件更新。固件文件随 Erae Lab 安装包一同打包提供 —— 更新时无需从网络下载。让 Erae Lab 本身保持最新，即可确保你始终拥有适用于设备的最新固件。

自动检查更新

当 Erae 2 连接时，Erae Lab 会将设备上报的固件版本与当前 Lab 安装包所包含的最新版本进行比较。如果打包的固件比设备上的更新，更新会自动开始。

提示： 让 Erae Lab 保持最新，以确保打包的固件是最新的。固件文件随 Erae Lab 应用程序包一同提供，因此安装新版本的 Lab 是获取新固件的主要途径。

固件更新

单阶段 SysEx 流式传输

对于 Erae 2 硬件，更新是一个单阶段流程：

重启进入引导加载程序 —— Lab 通过厂商 USB 二进制协议发送 RebootForUpdate 命令。设备重启进入引导加载程序模式，并在主机上重新枚举为一个名为 "Bootloader" 的 MIDI 设备。
引导加载程序检测 —— Lab 扫描引导加载程序 MIDI 端口。一旦检测到，它便从厂商 USB 协议切换到 MIDI SysEx 进行传输。
SysEx 流式传输 —— Lab 通过引导加载程序 MIDI 端口，将固件文件（erae_touch.syx）作为一系列 SysEx 数据包流式发送。随着数据包的发送，进度指示器会跟踪传输过程。
重启进入固件 —— 当整个流传输完成时，设备会自动重启进入新固件，并作为普通的 Erae 2 重新连接。这里没有逐包确认机制 —— 重启是由流传输完成所触发的。

提示： 在固件更新期间，请勿断开 USB 线缆。如果传输被中断，请重新连接设备 —— 如果它再次以引导加载程序模式出现，Lab 会检测到这个孤立的引导加载程序并提供恢复选项（见下文）。

引导加载程序检测与孤立设备恢复

每当没有厂商 USB 设备存在时，Lab 都会持续扫描引导加载程序 MIDI 端口。即使没有更新正在进行，该扫描也处于活动状态，从而让 Lab 能够检测到卡在引导加载程序模式中的设备 —— 例如，在上一次更新失败或被中断之后。

孤立引导加载程序恢复

如果 Lab 在未发起更新的情况下检测到引导加载程序端口，它会将该设备识别为孤立引导加载程序 —— 即一台正在等待固件文件、但该文件从未被送达的设备。在 3 秒的确认窗口之后，Lab 会弹出一个对话框：

选择文件 —— Lab 会打开一个文件选择器，让你手动选择一个 .syx 固件文件。随后流式传输会按照普通的 SysEx 更新流程继续进行。
忽略 —— Lab 会忽略该引导加载程序端口。设备将保持在引导加载程序模式，直到你重新连接并确认恢复。

提示： 如果你的设备卡在显示引导加载程序状态，而 Erae Lab 没有自动提供恢复选项，请断开并重新连接 USB 线缆。每次连接都会重新开始 3 秒的孤立设备检测窗口。

进度跟踪

Lab 界面中的一条提示通知会实时跟踪更新：

流式传输开始时会出现 "正在更新 Erae 固件..."。
随着 SysEx 数据包的发送，进度会不断推进。
"固件已更新！" 确认已成功重启进入新固件。
如果在任何阶段发生错误，会出现一条带有简要说明的错误提示。在大多数情况下，重新连接设备并重试更新即可解决问题。

提示： 更新成功后，Erae Lab 会抑制更新提示，直到设备断开并重新连接。重新连接会触发一次全新的版本检查。

macOS：更新后重置 MIDI 设备

在 macOS 上完成固件更新后，Erae 2 会作为一个新的 MIDI 设备重新枚举。如果 Erae Lab 没有自动重新连接，或者设备没有出现在其他 MIDI 应用程序中：

打开 Audio MIDI Setup（音频 MIDI 设置）（位于 /Applications/Utilities）。
找到任何过时的 Erae 2 条目，并使用减号（−）按钮将其移除。
拔出并重新插入 USB 线缆。设备会干净地重新枚举。
如果连接指示器没有响应，请重新启动 Erae Lab。

启动失败排查

如果设备在固件更新后无法正常启动：

触控面板空白或卡死 —— 在重启 Erae 的同时按住 Settings（设置），进入更新恢复模式。当 Erae Lab 检测到处于此状态的设备时，它会显示一条提示，建议更新到当前打包的固件。
无 USB 枚举 —— 尝试更换 USB 线缆和接口。如果设备仍然无法枚举，请联系 Embodme 支持（support@embodme.com）—— 请勿反复尝试断电重启。
恢复用 .syx 文件 —— 打包的固件文件位于 Erae Lab 应用程序包内部。在 macOS 上：右键点击 /Applications 中的 Erae Lab，选择 Show Package Contents（显示包内容），然后导航到 Contents/Resources/firmware/。如果你手头有任何先前下载的 .syx 文件，也可以使用它。

设置菜单

点击右上角工具栏中的齿轮图标即可打开设置菜单。该菜单以浮层形式打开，集中了设备选择、Erae Sound 音频/MIDI 设置、更新检查以及组件安装工具。

设置面板

设备选择

如果连接了多个 Erae 设备，设置菜单会显示一个带有设备选择器的设备区块。在编辑、同步、更新固件或托管 Erae Sound 之前，请先选择你希望 Erae Lab 控制的设备。当前激活的设备选择会被记住，下次启动时沿用。

如果只连接了一个 Erae 设备，该区块会被隐藏，因为没有可供选择的内容。

声音设置

当托管的 Erae Sound 引擎在 Erae Lab 内部运行或启用时，设置菜单会显示一个音频区块。你可以用它来选择音频输出设备、输出通道配置、采样率、缓冲区大小，以及操作系统所提供的相关驱动选项。

这些设置会影响托管的 Erae Sound 播放。Erae Lab 的工程编辑功能并不需要音频接口；即使没有配置任何音频输出，这些功能也能正常使用。

MIDI 设置与 Auto Erae

当托管 Erae Sound 时，同一个音频区块还包含 MIDI 输入复选框。Erae Lab 会自动为 Erae Sound 启用已连接的 Erae MIDI 输入，因此音符、压力以及演奏手势无需手动设置即可送达声音引擎。

这种自动选择有时被称为 Auto Erae。它会在首次启动时运行，并在操作系统报告 MIDI 设备被连接或重新连接时再次运行。在固件更新或 USB 重新连接之后，Erae Lab 会重新检查可用的 MIDI 输入，并重新启用检测到的 Erae 端口。

你仍然可以使用 MIDI 输入列表来手动查看或调整已启用的输入。Erae Lab 会自动占用非引导加载程序（bootloader）的 Erae MIDI 输入；引导加载程序/更新端口在演奏输入中会被忽略。

检查更新

点击 检查更新，让 Erae Lab 的应用更新程序立即查找更新的 Erae Lab 版本。Erae Lab 也会在后台自动检查应用更新，但当你想在开始一次使用前先确认安装版本时，这个按钮会很有用。

如果有可用的应用更新，请按照更新程序的提示操作。检查更新不会覆盖你已打开的工程。受管组件会在启动时自动检查，也可以通过 重新安装组件 手动刷新。

安装或重新安装组件

点击 重新安装组件 可强制 Erae Lab 重新安装其受管组件包。这包括 Erae Sound 包、固件包、脚本以及出厂内容包。

当某个组件看起来缺失或损坏、出厂内容未正确安装，或技术支持要求你刷新捆绑内容时，请使用此功能。Erae Lab 会清除本地组件清单、重新检查发布源，并在重新安装过程中显示进度或失败提示。在 Windows 上，当安装程序需要更新受保护的组件位置时，可能会请求管理员授权。出厂内容会以安全的方式合并：捆绑的只读内容可以被添加或替换，但你的工程和用户预设不会被删除。

如果你处于离线状态，Erae Lab 会在可能的情况下使用已缓存的安装内容；否则它会报告失败，你可以在网络可用时重试。

CV Clock

底部栏可以显示一个 CV Clock 控件，用于配置来自 Lab 工程的时钟输出。打开它即可设置：

启用 —— 打开或关闭 CV 时钟输出。
节拍分度 —— 选择时钟速率：1、2、4、8、24 或 48 ppqn。
输出 —— 选择用于时钟信号的 CV 输出对。当设备/工程需要时，Erae Lab 会保留相邻的输出用于复位行为。

工程与元素设置

工程专属的设置仍然位于其专用面板中，而非齿轮菜单内。例如，CV Clock 和各元素的 MIDI 设置是从画布和右侧设置面板中配置的。有关这些工作流程，请参阅 MIDI 设置、画布和设备同步。

已保存的状态

Erae Lab 会在多次启动之间记住应用级别的状态，包括当前激活的设备、当前的 Lab/Sound 视图、托管 Erae Sound 的电源状态、托管插件状态，以及托管 Sound 所使用的音频/MIDI 设置。

键盘快捷键与交互操作

本章是一份快速参考指南，涵盖 Erae Lab 中所有可用的键盘快捷键、鼠标手势和拖放交互操作。在探索画布时，建议将本章保持打开以便随时查阅。

键盘快捷键

当画布处于焦点状态时，快捷键即可使用。撤销和重做在任意面板中也都有效，但在文本输入框内例外——此时 Cmd+Z（macOS）/ Ctrl+Z（Windows）作用于文本框自身的编辑历史。

操作	macOS	Windows / Linux
新建布局	`Cmd + N`	`Ctrl + N`
打开 / 导入	`Cmd + O`	`Ctrl + O`
导出当前布局	`Cmd + S`	`Ctrl + S`
撤销	`Cmd + Z`	`Ctrl + Z`
重做	`Cmd + Shift + Z`	`Ctrl + Shift + Z`
复制	`Cmd + C`	`Ctrl + C`
粘贴	`Cmd + V`	`Ctrl + V`
生成副本	`Cmd + D`	`Ctrl + D`
删除选中项	`Delete` 或 `Backspace`	`Delete` 或 `Backspace`
全选	`Cmd + A`	`Ctrl + A`

提示： 生成副本（Cmd + D）会在原元素紧邻的位置粘贴一份副本，并自动递增其 CC 和 CV 值——这对于搭建一排推子非常有用，无需手动逐个调整每个通道。

提示： 撤销和重做历史按项目独立保存，并在面板切换后依然保留。你可以撤销在 MIDI 或外观面板中所做的多次编辑，而不仅限于画布上的移动操作。

画布上的鼠标交互

选择元素

手势	作用
单击某个元素	选中该元素。之前的任何选择都会被清除。
Cmd + 单击（macOS）/ Ctrl + 单击（Windows）某个元素	将该元素添加到当前选择中；若该元素已被选中，则将其移出选择。
在画布空白区域单击 + 拖动	绘制一个套索矩形。释放鼠标时，完全或部分位于矩形内的所有元素都会被选中。
在画布空白区域单击	取消选择所有元素。

提示： 套索选择采用批量设置机制——右侧面板会在拖动完成后统一更新一次，而非对每个元素逐一更新，因此即使在拥有 16 个元素的完整布局上也能保持流畅响应。

移动与调整元素大小

手势	作用
单击 + 拖动某个选中的元素	移动该元素。当前选择中的所有元素会一起移动。在你拖动时，Erae Lab 会将元素吸附到打击垫网格上。
拖动调整手柄（角部或边缘）	调整元素大小。元素会吸附到最接近的有效网格尺寸。

元素之间不能重叠。如果你将某个元素放到已被占用的单元格上，它会弹回到之前的位置。

拖放操作

从侧边栏到画布

从元素侧边栏（左侧面板）拖出某种元素类型，并将其放到画布上。在拖动过程中，Erae Lab 会显示一个吸附到网格的虚影轮廓。释放鼠标即可在该位置创建元素。

从元素预设到画布

从左侧边栏 ELEMENTS（元素）区中的 User（用户）区域拖出某个元素预设，并将其放到画布上。创建出的元素会应用该预设中所有已保存的 MIDI、CV 和外观设置。

布局拖放

从布局面板拖出一个布局缩略图，并将其放到画布区域，即可切换到该布局。在现场演出的搭建过程中，这是在多个布局之间快速跳转的最快方式。

界面反馈约定

Erae Lab 使用一套统一的视觉提示来传达状态：

状态	你会看到
已选中	元素获得一圈明亮的强调色边框（颜色取决于主题）。
多选	所有被选中的元素会同时显示相同的强调色边框。
悬停	鼠标移过时元素略微变亮；光标变为移动指针。
拖动中	一个半透明的元素虚影跟随光标移动；网格上会高亮显示有效的放置位置。
冲突 / 重叠	当放置位置已被占用时，虚影轮廓变为红色。
套索激活	当你在画布空白区域拖动时，会出现一个带细边框的半透明矩形。
自上次快照后已更改	当自动保存的项目与其快照检查点存在差异时，项目行会显示保存/还原控件。
同步中	在 Erae 2 接收数据期间，会出现一条吐司通知和工具栏中的旋转加载指示。

提示： 画布底部的状态栏会以打击垫网格单位（列 x 行）显示选中元素的位置和尺寸。借此可以精确对齐元素，无需用肉眼数网格方块。

故障排查

本章介绍你在使用 Erae Lab 时可能遇到的最常见问题。如需了解硬件相关的具体问题，请参阅《Erae 2 用户手册》第 10 章。

如果使用本指南仍无法解决问题，请在应用内提供该功能时使用应用内的错误报告按钮，或通过 support@embodme.com 联系 Embodme 支持团队。

设备未被检测到

现象： 插入 Erae 2 后，工具栏中的连接指示灯始终保持灰色。

解决步骤：

换一根 USB 数据线试试。仅供充电的数据线无法工作——请确保数据线支持数据传输。
换一个 USB 接口试试，最好直接使用电脑上的接口，而不是集线器上的接口。
在 macOS 上，打开 系统信息 > USB，查看其中是否出现 Erae 2。如果那里也没有出现，则问题出在硬件或数据线上。
在 Linux 上，Erae Lab 需要 USB 权限。如果设备出现在 lsusb 中，但未出现在 Erae Lab 中，请为 Erae 2 的 USB 厂商 ID 添加一条 udev 规则，然后重新插拔。如果原因正是如此，日志中会显示一条 "USB permission denied"（USB 权限被拒绝）的消息。
退出 Erae Lab，拔下设备，等待五秒，重新插入，然后重新启动 Erae Lab。

提示： Erae Lab 每隔几秒就会轮询一次设备。如果你在启动后才插入设备，无需重启——稍候片刻，指示灯应会自动变绿。

设备已检测到但无法连接

现象： 设备短暂出现后又断开，或指示灯闪烁不定。

解决步骤：

检查设备上的固件版本（连接后可在工具栏中查看）。如果它低于当前版本的 Erae Lab 所要求的最低版本，固件更新对话框会自动出现——请按照固件更新中的说明操作。
如果 Erae 2 处于恢复/更新模式（触控面显示纯色，而不是正常的开机动画），请参阅下方的更新恢复。
通过点击工具栏菜单中的 连接 > 重置，强制进行一次连接重置。

同步冲突

现象： 当你连接 Erae 2 时，会弹出一条提示，要求你选择如何解决相互冲突的项目版本。

当 Lab 副本和设备副本自上次干净同步以来都发生了更改时，Erae Lab 就会触发冲突。

提示中的解决选项：

选项	结果
保留设备版本	对于发生冲突的项目，将设备版本拉取到 Lab 中。
两者都保留	Lab 保留自己的版本，并将设备版本作为单独的副本导入，通常带有类似 `_erae` 的后缀，并重新生成一个标识。
保留 Lab 版本	对于冲突项目，Lab 版本将覆盖设备版本。

提示： 如果你不确定哪个版本包含你需要的更改，请选择 两者都保留。

项目恢复

如果某个项目文件损坏，或被从 Erae Lab 库中意外删除，Erae 2 板载的 SD 卡上保存着最后一次同步的副本。连接 Erae 2——在标准同步周期内，同步引擎会拉取本地库中缺失的所有设备项目。

项目本地存储在 Erae Lab 应用数据文件夹下的 EraeLab/projects 中。使用应用的文件夹/打开文件夹操作，可显示适用于你操作系统的确切路径。Time Machine 或任何涵盖该文件夹的文件级备份，都能提供额外的安全保障。

文件格式故障排查

现象： 某个 .erproj 或 .emk 文件无法正确打开或导入。

解决步骤：

核对文件扩展名。当前项目是包含 settings.eraebin 的文件夹；.eraeproject、.erproj 和 .emk 都是旧版/导入格式。扩展名为 .emk 的文件是某个较旧格式版本的布局文件；先选择目标布局槽位，然后使用布局导入/打开按钮，或将该文件拖到 Erae Lab 上。
检查文件大小是否为零字节（下载或复制不完整）。如果是，请从原始来源重新获取该文件。
如果该文件是用比你当前所用版本更新的 Erae Lab 创建的，请将 Erae Lab 更新到最新版本。
如果问题仍然存在，请将该文件作为附件发送至 support@embodme.com——并附上 Erae Lab 的版本和操作系统信息。

MIDI 端口冲突

现象： 你的 DAW 没有接收到来自 Erae 2 的 MIDI，或 MIDI 被错误的应用程序接收。

解决步骤：

在 macOS 上，某些应用程序会独占 MIDI 端口。请检查是否有其他应用程序以独占方式占用了 Erae 2 的 MIDI 端口。
核实你的 DAW 的 MIDI 输入首选项中已选择了正确的 MIDI 端口。Erae 2 在 USB 设备端口上以名为 "Erae 2" 的设备形式枚举。
如果你正在使用虚拟 MIDI 路由工具（macOS 上的 IAC Driver，Windows 上的 LoopBe），请确保路由配置正确，且不会形成反馈回路。
在 macOS 上，打开 音频 MIDI 设置，查看 Erae 2 是否出现且未显示错误图标。退出并重新启动音频 MIDI 设置，可促使系统 MIDI 守护进程重新枚举设备。

macOS：MIDI 出问题后移除设备

如果 Erae 2 的 MIDI 端口在固件更新或意外断开后停止响应：

打开 音频 MIDI 设置。
在列表中选择 Erae 2 设备。
按下减号（−）按钮将其移除。
拔下并重新插入 USB 数据线。设备将以一个干净的条目重新枚举。

固件更新失败

现象： 固件更新过程中进度条停在中途，或 Erae Lab 报告更新错误。

解决步骤：

更新过程中切勿拔下设备。如果更新停滞超过 60 秒且无任何进展，Erae Lab 将超时并显示错误。
超时后，退出 Erae Lab，拔下设备，等待 10 秒，然后重新连接。如果设备正常启动，请重新启动 Erae Lab，让它自动重试更新。
如果设备在更新失败后无法启动，请将其重启进入更新恢复模式——请参阅下方的更新恢复。

更新恢复

现象： Erae 2 无法正常响应，且其触控面显示纯色或一片空白。

按住 Settings 的同时重启设备。这会使 Erae 进入更新恢复模式，以便 Erae Lab 检测到它并提供当前捆绑的固件。

将设备连接到电脑，并保持 Erae Lab 处于打开状态。
在重启设备的同时按住 Settings。
等待 Erae Lab 弹出提示，建议更新到当前固件。
接受更新，并保持 USB 数据线连接，直到设备重启。

如果恢复重启后 Erae Lab 没有显示更新提示，请断开并重新连接 USB，然后重复"重启时按住 Settings"的步骤。如果设备仍然无法恢复，请联系 support@embodme.com。

提示： 在恢复过程中，请勿反复对设备进行断电重启。只需进入更新恢复模式一次，接受 Lab 的更新提示，然后等待更新完成即可。

Erae Lab 崩溃

现象： Erae Lab 意外退出或变得无响应。

解决步骤：

如果应用程序无响应，请强制退出：
- macOS： 按下 Cmd + Option + Esc，选择 Erae Lab，然后点击 强制退出。或者，右键点击程序坞图标并选择 强制退出。
- Windows： 按下 Ctrl + Shift + Esc 打开任务管理器，找到 Erae Lab，然后点击 结束任务。
重新启动 Erae Lab。应用程序会自动重新加载上次保存的项目状态。
如果重新启动后错误报告按钮可用，请在 Erae Lab 内部提交一份报告。如有可能，请先重新连接设备并重现问题，以便包含当前会话的设备诊断信息和近期日志。
如果应用内报告功能不可用，请发送电子邮件至 support@embodme.com，并描述崩溃发生时你正在进行的操作。

应用内错误报告

在可用时，顶栏中的错误报告按钮会打开一个应用内报告表单。请将它用于崩溃、同步问题、设备通信问题、托管的 EraeSound 问题，以及可重现的 UI 问题。

错误报告可以包含你当前的项目、宿主状态、应用和机器元数据、当前会话的设备诊断信息以及近期日志。这些上下文有助于支持团队重现问题，但其中可能包含涉及隐私的项目名称、MIDI 路由、预设名称和设备状态。提交前请检查你的描述；如果你需要先讨论敏感内容，请使用电子邮件支持。

如果看不到该按钮，请联系 support@embodme.com，并附上你的 Erae Lab 版本、操作系统、所连接的设备型号、固件版本，以及触发该问题的操作步骤。

MIDI 设备未出现在设置中

现象： 已连接某个 MIDI 接口，但它没有出现在设置的 MIDI 设备下拉菜单中。

解决步骤：

关闭设置面板，然后重新打开。每次打开面板时，Erae Lab 都会刷新设备列表。
在 macOS 上，打开 音频 MIDI 设置（位于 /Applications/Utilities）。核实设备出现在其中且未显示错误图标。有时退出并重新启动音频 MIDI 设置会促使系统 MIDI 守护进程重新枚举设备。
在 Windows 上，检查 设备管理器 中该 MIDI 设备是否存在驱动程序错误。如果出现警告图标，请重新安装设备驱动程序。
核实该设备未被其他应用程序独占。某些 MIDI 接口不支持共享访问——请关闭其他可能占用该设备的 DAW 或 MIDI 工具。

提示： 虚拟 MIDI 端口（例如 macOS 上的 IAC Driver 或 Windows 上的 LoopBe 创建的端口）会像物理端口一样出现在 Erae Lab 的设备列表中。如果你使用虚拟端口进行路由，请确保在打开 Erae Lab 之前已将其启用。

Erae 兼容性

本节面向使用初代 Erae 硬件的用户。Erae Lab 主手册介绍的是当前 Erae 2 的工作流程；初代 Erae 的差异之处统一收录于此，以免打断主手册中的设置、同步和更新章节。

工程同步

初代 Erae 硬件使用标准 MIDI，不支持 Erae 2 的厂商 USB 二进制协议。因此，Erae 无法使用自动双向工程同步。Erae 元素的 MIDI 输出可正常工作，但同步引擎不会在这些设备上运行。

当 Erae 通过标准 MIDI USB 连接时，一旦 MIDI 端口打开，工具栏指示器可能会显示 Connected（已连接）。这仅表示 MIDI 已连通，并不意味着 Erae 2 同步协议处于激活状态。

固件更新

由于 Erae 硬件的内部更新架构与 Erae 2 不同，它采用两阶段更新流程。

阶段 1：Stage-2 引导加载程序

重启进入引导加载程序 - Lab 在已打开的 MIDI 端口上通过旧版 SysEx 发送 RebootForUpdate。设备随即重启并进入其主引导加载程序。
Stage-2 SysEx 流式传输 - Lab 通过 MIDI SysEx 流式传输一个 stage-2 加载程序文件（erae_mk1_h7_stage2.syx）。这个小程序为阶段 2 中使用的二进制文件传输搭建桥梁。
等待 stage-2 重新连接 - 在 stage-2 加载程序完成后，设备会重新枚举，并返回一个状态码以表明它已准备好进行二进制传输（FirmwareUpdater）。Lab 最多等待 60 秒以完成此次重新连接。

阶段 2：二进制固件传输

二进制文件传输 - Lab 使用厂商二进制文件传输协议（FileStart、FileData 和 FileComplete），分块发送实际的固件二进制文件（erae_mk1_h7_update.bin）。
等待重启 - 在传输确认完成后，设备会重启进入新固件并正常重新连接。Lab 最多等待 60 秒以完成最终重启。

Erae 的两阶段流程比 Erae 2 的更新耗时更长。进度指示器会贯穿这两个阶段持续推进。在整个过程中请保持设备连接并通电；完整更新通常会在两分钟内完成。

如果更新在阶段 1 和阶段 2 之间失败，设备可能会以部分引导加载程序状态重新连接。Erae Lab 会自动检测到这种情况，并在下次启动时恢复阶段 2。

附录 A — 元素参数参考

本附录列出 Erae Lab 中每种元素类型的所有可配置参数。参数按元素类型分组。MIDI 映射列说明当该元素在设备上处于活动状态时，对应参数所驱动的 MIDI 或 CV 信号。

MIDI 通道与组字段共用同一个 4 位存储范围（0–15，在界面中显示为 1–16）。MIDI 输出目标（USB Device、USB Host、MIDI A、MIDI B）对所有发送 MIDI 的元素都通用，并在每个元素中单独注明。CC 控制器编号遵循标准的 7 位 MIDI 编号（0–127）。CV 输出按逻辑输出对索引进行引用。速度（Speed）输出采用连续的检测级手指移动速度，经过平滑处理后归一化为 0 到 100 cm/s。

Iso 键盘

一种基于网格的键盘，其中每个琴键单元映射到一个半音或音阶音级。键宽和键高（以琴键单位计）定义单元尺寸。Iso 键盘从共享的琴键属性集中继承所有琴键级别的表现力。

参数	说明	类型	范围	默认值	MIDI 映射
MIDI Channel	所有琴键的 MIDI 通道	uint4	0–15（1–16）	0（ch 1）	Note On/Off 通道
MIDI Group	用于路由的 MIDI 组	uint4	0–15	0	内部路由组
MIDI Output Dest	输出端口选择	flags	USB Device、USB Host、MIDI A、MIDI B	USB Device	选择输出端口
Base Note	键盘的最低音符	Note	0–127	0x30（C4）	音符映射的锚点
Scale	琴键布局的当前音阶	enum	Chromatic、Major、Minor、…	Major	决定哪些琴键在音阶内
Chroma Notes Shown	显示音阶外（半音）琴键	bool	true/false	true	影响琴键可见性与音符索引
Octave Fixed	锁定八度，禁止八度移位	bool	true/false	false	防止音符范围发生移位
Key Width	每个琴键单元的宽度（琴键单位）	uint8	1–N	1	—
Key Height	每个琴键单元的高度（琴键单位）	uint8	1–N	1	—
Semitones Line Offset	每行的半音偏移量（半音模式）	uint6	0–63	5	移动行与行之间的音高间隔
Degrees Line Offset	每行的音级偏移量（音阶模式）	uint6	0–63	3	移动行与行之间的音级间隔
Start Note	音阶内的起始音符索引	uint4	0–11	0	偏移琴键索引映射
Activate Same Keys	同时触发所有共享相同音级的琴键	bool	true/false	false	影响音符触发分组
MPE Enable	启用 MPE（MIDI Polyphonic Expression）	bool	true/false	false	将每次触摸路由到唯一通道
MPE Master Channel	MPE 主通道选择	enum	Channel 1 / Channel 16	Channel 1	设置 MPE 区域主通道
Velocity Tune	力度响应曲线	struct	见琴键属性	default	音符力度
Lift Tune	抬起（释放）力度曲线	struct	见琴键属性	default	NoteOff 力度
Pressure Tune	触后/压力响应	struct	见 Pressure Tune	default	通道/复音触后
Vibrato Tune	来自 X 轴的 Pitch Bend 揉弦	struct	见 Vibrato Tune	default	Pitch Bend
Glissando Tune	半音音符量化	struct	见 Glissando Tune	disabled	半音音符量化
CC74 Tune	来自 Y 轴的音色亮度表现力（CC#74）	struct	见 CC74 Tune	disabled	CC#74
Pressure CC	由压力驱动的可选 CC	CC config	0–127 控制器，可选	disabled	复音压力 CC
X Absolute CC	由手指 X 位置驱动的 CC	CC config	0–127 控制器，可选	disabled	绝对 X CC
Y Absolute CC	由手指 Y 位置驱动的 CC	CC config	0–127 控制器，可选	disabled	绝对 Y CC
Motion Speed CC	由连续手指移动速度驱动的 CC	CC config	0–127 控制器，可选	disabled	Motion Speed CC
X Relative CC	来自 X 运动的相对 CC	CC config	0–127 控制器，可选	disabled	相对 X CC
Y Relative CC	来自 Y 运动的相对 CC	CC config	0–127 控制器，可选	disabled	相对 Y CC
CV Key	每个声部的 CV 音高输出	CV config	enabled/disabled	disabled	V/Oct 输出
CV Pressure	由压力驱动的 CV 输出	CV config	enabled/disabled	disabled	CV 压力
CV Velocity	由力度驱动的 CV 输出	CV config	enabled/disabled	disabled	CV 力度
CV Num Voice	CV 声部输出数量	uint4	0–15	0（1 个声部）	跨 CV 输出的复音数
Arpeggiator	琶音器设置	struct	enabled/disabled	disabled	修改音符触发模式
Key Styles	各音级与各半音的琴键颜色	style array	—	—	仅视觉

Chroma 键盘

一种钢琴风格的布局，白键与黑键按标准半音顺序排列。它与 Iso 键盘共享相同的琴键属性集。键宽与键高决定白键的物理尺寸；黑键按比例缩放（为白键高度的 5/12）。

参数	说明	类型	范围	默认值	MIDI 映射
MIDI Channel	所有琴键的 MIDI 通道	uint4	0–15（1–16）	0（ch 1）	Note On/Off 通道
MIDI Group	用于路由的 MIDI 组	uint4	0–15	0	内部路由组
MIDI Output Dest	输出端口选择	flags	USB Device、USB Host、MIDI A、MIDI B	USB Device	选择输出端口
Base Note	键盘的最低音符	Note	0–127	0x30（C4）	音符映射的锚点
Scale	当前音阶	enum	Chromatic、Major、…	Chromatic	决定音阶内着色
Key Width	每个白键的宽度（琴键单位）	uint8	2–N（最小 2）	4	—
Key Height	白键的高度（琴键单位）	uint8	4–N（最小 4）	元素的完整高度	—
Line Offset	起始琴键的半音偏移量	uint6	0–63	0	移动基准音符的位置
Chroma Notes Shown	显示所有半音音符	bool	true/false	true	影响音符索引模式
Octave Fixed	锁定八度	bool	true/false	false	防止八度移位
MPE Enable	启用 MPE	bool	true/false	false	每次触摸的通道路由
MPE Master Channel	MPE 主通道	enum	Channel 1 / Channel 16	Channel 1	MPE 区域主通道
Velocity Tune	力度曲线	struct	见琴键属性	default	音符力度
Lift Tune	释放力度曲线	struct	见琴键属性	default	NoteOff 力度
Pressure Tune	压力响应	struct	见 Pressure Tune	default	触后
Vibrato Tune	X 轴揉弦	struct	见 Vibrato Tune	default	Pitch Bend
Glissando Tune	半音音符量化	struct	见 Glissando Tune	disabled	半音音符量化
CC74 Tune	音色亮度 CC#74	struct	见 CC74 Tune	disabled	CC#74
Pressure CC	由压力驱动的 CC	CC config	0–127 控制器，可选	disabled	压力 CC
X Absolute CC	X 位置 CC	CC config	0–127 控制器，可选	disabled	绝对 X CC
Y Absolute CC	Y 位置 CC	CC config	0–127 控制器，可选	disabled	绝对 Y CC
Motion Speed CC	由连续手指移动速度驱动的 CC	CC config	0–127 控制器，可选	disabled	Motion Speed CC
X Relative CC	相对 X CC	CC config	0–127 控制器，可选	disabled	相对 X CC
Y Relative CC	相对 Y CC	CC config	0–127 控制器，可选	disabled	相对 Y CC
CV Key	CV 音高输出	CV config	enabled/disabled	disabled	V/Oct 输出
CV Pressure	由压力驱动的 CV 输出	CV config	enabled/disabled	disabled	CV 压力
CV Velocity	由力度驱动的 CV 输出	CV config	enabled/disabled	disabled	CV 力度
CV Num Voice	CV 声部输出数量	uint4	0–15	0（1 个声部）	跨 CV 输出的复音数
Key Styles	各半音与各音阶音级的颜色	style array	—	—	仅视觉

Drumpad 键盘

一种采用固定半音音阶映射的网格键盘，专为打击乐设计。每个单元触发一个不同的音符。键宽与键高定义琴键单元的尺寸。它共享完整的琴键属性集（力度、压力、抬起、揉弦、CC、CV）。

参数	说明	类型	范围	默认值	MIDI 映射
MIDI Channel	MIDI 通道	uint4	0–15（1–16）	0（ch 1）	Note On/Off 通道
MIDI Group	MIDI 组	uint4	0–15	0	内部路由组
MIDI Output Dest	输出端口选择	flags	USB Device、USB Host、MIDI A、MIDI B	USB Device	选择输出端口
Base Note	最低音符	Note	0–127	0x30（C4）	音符映射的锚点
Key Width	每个琴键单元的宽度（琴键单位）	uint8	1–N	1	—
Key Height	每个琴键单元的高度（琴键单位）	uint8	1–N	1	—
MPE Enable	启用 MPE	bool	true/false	false	每次触摸的通道路由
MPE Master Channel	MPE 主通道	enum	Channel 1 / Channel 16	Channel 1	MPE 区域主通道
Velocity Tune	力度响应	struct	见琴键属性	default	音符力度
Lift Tune	释放力度	struct	见琴键属性	default	NoteOff 力度
Pressure Tune	压力响应	struct	见 Pressure Tune	default	触后
Vibrato Tune	X 揉弦	struct	见 Vibrato Tune	default	Pitch Bend
CC74 Tune	音色亮度 CC#74	struct	见 CC74 Tune	disabled	CC#74
Pressure CC	由压力驱动的 CC	CC config	0–127 控制器，可选	disabled	压力 CC
X Absolute CC	X 位置 CC	CC config	0–127 控制器，可选	disabled	绝对 X CC
Y Absolute CC	Y 位置 CC	CC config	0–127 控制器，可选	disabled	绝对 Y CC
Motion Speed CC	由连续手指移动速度驱动的 CC	CC config	0–127 控制器，可选	disabled	Motion Speed CC
CV Key	CV 音高输出	CV config	enabled/disabled	disabled	V/Oct
CV Pressure	由压力驱动的 CV 输出	CV config	enabled/disabled	disabled	CV 压力
CV Velocity	由力度驱动的 CV 输出	CV config	enabled/disabled	disabled	CV 力度
CV Num Voice	CV 声部输出数量	uint4	0–15	0（1 个声部）	跨 CV 输出的复音数
Key Styles	每个琴键的颜色	style array	—	—	仅视觉

琴键属性子结构

Glissando Tune

控制滑动过程中的半音音符量化。当手指在网格上移动时，音高会吸附到最近的量化位置，而不是产生连续的滑音。

参数	说明	类型	范围	默认值
Enable	激活半音音符量化	bool	true/false	false
Y Disabled	禁用 Y 轴量化（仅 X）	bool	true/false	false
Retrigger	每次音高变化时重新发送 note-on	bool	true/false	false
Tune Location	吸附参考点：琴键中心或手指位置	enum	Pad、Finger	Pad
Smoothing	滑动后音高稳定的速度	uint8	0–255	63
In-Tune Width	稳定音高区域占键宽的比例	uint8	0–255	50

Vibrato Tune

控制由 X 轴手指运动驱动的 Pitch Bend 揉弦。

参数	说明	类型	范围	默认值
Enable	激活揉弦	bool	true/false	false
Pitch Bend Range	最大 Pitch Bend（以半音计）	uint8	1–96	12（非 MPE），48（MPE）
Style	揉弦曲线形状	enum	Linear、Quadratic、FarQuadratic	Linear
Strength	揉弦深度	uint8	0–127	64
Return Speed	音高返回中心的速度	uint8	0–127	64

Pressure Tune

控制表面压力如何映射到触后或 CC 输出。

参数	说明	类型	范围	默认值
Enable	激活压力输出	bool	true/false	false
Type	触后模式	enum	Channel Pressure、Poly Pressure	Channel Pressure
Tracking	响应曲线形状	enum	Linear、Exponential、Logarithmic	Linear
Filter	平滑滤波强度	uint8	0–255	0
Min	最小输出值	uint7	0–127	0
Max	最大输出值	uint7	0–127	127
Intensity	输出增益	uint8	0–127	64
Smoothing	额外的输出平滑	uint8	0–255	0

CC74 Tune（音色亮度）

配置音色亮度（CC#74）输出，即 MPE 的音色轴，它也可以在非 MPE 环境中使用。

参数	说明	类型	范围	默认值
Enable	激活 CC#74 输出	bool	true/false	false
Gesture	驱动输出的物理轴。Motion Speed 为连续手指移动速度。	enum	Pressure、X abs、Y abs、X rel、Y rel、Motion Speed	Y abs
Initial Value	手指触摸时发送的 CC 值	uint7	0–127	0
Controller	CC 编号（默认 74）	uint7	0–127	74
Min	最小输出值	uint7	0–127	0
Max	最大输出值	uint7	0–127	127
Tracking	响应曲线形状	enum	Linear、Exponential、Logarithmic	Linear
Filter	平滑滤波强度	uint8	0–255	0
Intensity	输出增益	uint8	0–127	64
Smoothing	输出平滑	uint8	0–255	0

按钮（Note / Control Change / Program Change / Control Voltage / Tap Tempo）

一种单琴键的按钮元素。模式在配置时选择，并决定可用的子参数。锁定（Latched）模式在每次按下时切换状态，而不是在按下和释放时发送消息。

共享按钮参数

参数	说明	类型	范围	默认值	MIDI 映射
MIDI Channel	MIDI 通道	uint4	0–15（1–16）	0（ch 1）	消息通道
MIDI Group	MIDI 组	uint4	0–15	0	内部路由组
MIDI Output Dest	输出端口选择	flags	USB Device、USB Host、MIDI A、MIDI B	USB Device	选择输出端口
Latched	切换模式与瞬时模式	bool	true/false	false	决定按下/释放还是切换
Button Type	消息类型	enum	Note、Control Change、Program Change、Control Voltage、Tap Tempo、Disabled	Note	选择活动子参数集

按钮 — Note 模式

参数	说明	类型	范围	默认值	MIDI 映射
Note	MIDI 音符编号	Note	0–127	0x30（C4）	Note On/Off 音符编号
CV Note	此按钮的 CV 音高输出	CV config	enabled/disabled	disabled	V/Oct 门控输出

按钮 — Control Change 模式

参数	说明	类型	范围	默认值	MIDI 映射
Controller A	按下时（ON 事件）发送的 CC 编号	uint7	0–127，可选	disabled	CC 编号
Value A	按下时发送的 CC 值	uint7	0–127	64	CC 值
Controller B	释放时（OFF，仅锁定模式）发送的 CC 编号	uint7	0–127，可选	disabled	CC 编号
Value B	释放时发送的 CC 值	uint7	0–127	65	CC 值

按钮 — Program Change 模式

参数	说明	类型	范围	默认值	MIDI 映射
Bank MSB A	按下时的 Bank Select MSB	uint7	0–127，可选	disabled	CC#0
Bank LSB A	按下时的 Bank Select LSB	uint7	0–127，可选	disabled	CC#32
Program A	按下时的 Program 编号	uint7	0–127，可选	disabled	Program Change
Bank MSB B	释放时的 Bank Select MSB（锁定）	uint7	0–127，可选	disabled	CC#0
Bank LSB B	释放时的 Bank Select LSB（锁定）	uint7	0–127，可选	disabled	CC#32
Program B	释放时的 Program 编号（锁定）	uint7	0–127，可选	disabled	Program Change

按钮 — Control Voltage 模式

参数	说明	类型	范围	默认值	MIDI 映射
CV On/Off	由按钮状态驱动的门控输出	CV config	enabled/disabled	disabled	0–5 V 门控

按钮 — Tap Tempo 模式

测量连续敲击之间的间隔并推导出 BPM。除类型选择器外无其他子参数。

Fader 1D

一维连续推子。手指 Y 位置（垂直轴）作为主控制值被跟踪。表面上的压力提供独立的辅助输出。

参数	说明	类型	范围	默认值	MIDI 映射
MIDI Channel	MIDI 通道	uint4	0–15（1–16）	0（ch 1）	消息通道
MIDI Group	MIDI 组	uint4	0–15	0	内部路由组
MIDI Output Dest	输出端口选择	flags	USB Device、USB Host、MIDI A、MIDI B	USB Device	选择输出端口
Initial Y Value	无手指时发送的值	uint7	0–127	0x3F（63）	空闲时的 CC 值
Y Absolute CC	由 Y 位置驱动的 CC	CC config	0–127 控制器，可选	disabled	绝对位置 CC
Pressure CC	由接触压力驱动的 CC	CC config	0–127 控制器，可选	disabled	压力 CC
Motion Speed CC	由连续手指移动速度驱动的 CC	CC config	0–127 控制器，可选	disabled	Motion Speed CC
Y Absolute CV	由 Y 位置驱动的 CV 输出	CV config	enabled/disabled	disabled	0–5 V 位置
Pressure CV	由压力驱动的 CV 输出	CV config	enabled/disabled	disabled	0–5 V 压力
Motion Speed CV	由连续手指移动速度驱动的 CV 输出	CV config	enabled/disabled	disabled	0–5 V 速度

Fader 2D

二维连续触控板。X 轴和 Y 轴各自独立跟踪手指位置，分别驱动一个独立的 CC 或 CV 输出。压力提供第三个独立输出。

参数	说明	类型	范围	默认值	MIDI 映射
MIDI Channel	MIDI 通道	uint4	0–15（1–16）	0（ch 1）	消息通道
MIDI Group	MIDI 组	uint4	0–15	0	内部路由组
MIDI Output Dest	输出端口选择	flags	USB Device、USB Host、MIDI A、MIDI B	USB Device	选择输出端口
Initial X Value	无手指时发送的 X 值	uint7	0–127	0x3F（63）	空闲时的 CC 值
Initial Y Value	无手指时发送的 Y 值	uint7	0–127	0x3F（63）	空闲时的 CC 值
X Absolute CC	由 X 位置驱动的 CC	CC config	0–127 控制器，可选	disabled	绝对 X CC
Y Absolute CC	由 Y 位置驱动的 CC	CC config	0–127 控制器，可选	disabled	绝对 Y CC
Pressure CC	由压力驱动的 CC	CC config	0–127 控制器，可选	disabled	压力 CC
Motion Speed CC	由连续手指移动速度驱动的 CC	CC config	0–127 控制器，可选	disabled	Motion Speed CC
X Absolute CV	来自 X 位置的 CV 输出	CV config	enabled/disabled	disabled	0–5 V X 位置
Y Absolute CV	来自 Y 位置的 CV 输出	CV config	enabled/disabled	disabled	0–5 V Y 位置
Pressure CV	来自压力的 CV 输出	CV config	enabled/disabled	disabled	0–5 V 压力
Motion Speed CV	来自连续手指移动速度的 CV 输出	CV config	enabled/disabled	disabled	0–5 V 速度

Ableton Launchpad

一种专用的 Ableton Live / Launchpad 兼容元素。它占据触控表面的固定区域，并通过 USB 使用 Launchpad sysex 协议进行通信。在 Erae Lab 中只有显示缩放级别可由用户配置。

参数	说明	类型	范围	默认值	MIDI 映射
Position	触控板放置区域	enum	Full Width、Left Half、Right Half	Full Width	设置物理几何区域
Zoom Level	Ableton 中的显示缩放	enum	Small、Large	Small	Launchpad 协议缩放

API Zone

一种原始多点触控数据区域。固件通过 embodme API 将手指坐标和压力直接报告给主机应用程序，而不转换为 MIDI 消息。用于自定义软件集成。

参数	说明	类型	范围	默认值	MIDI 映射
Zone Index	该区域在 API 中的标识符	uint8	0–127	0	API 区域选择器
Max Num Fingers	报告的最大同时触点数	uint8	0–10	10	API 手指数量上限
Finger Data Rate	手指数据的报告率分频系数	uint8	0–255	0	API 报告率

踏板（PedalV2）

踏板元素是分配给两个踏板输入之一（Input A 或 Input B）的非可见元素。每个踏板可配置为以下模式之一：Switch、Kick、Sustain Binary、Sustain Continuous、Expressive 或 Hi-Hat。

共享踏板参数

参数	说明	类型	范围	默认值	MIDI 映射
Pedal Input	物理输入插孔	enum	Input A、Input B	Input A	—
Pedal Type	工作模式	enum	Switch、Kick、Sustain Binary、Sustain Continuous、Expressive、Hi-Hat、Disabled	Disabled	选择参数子集
MIDI Channel	MIDI 通道	uint4	0–15（1–16）	0（ch 1）	消息通道
MIDI Group	MIDI 组	uint4	0–15	0	内部路由组
MIDI Output Dest	输出端口选择	flags	USB Device、USB Host、MIDI A、MIDI B	USB Device	选择输出端口

踏板 — Switch 模式

在按下和释放时发送 Note、CC、Program Change 或 Tap Tempo 消息。

参数	说明	类型	范围	默认值	MIDI 映射
Latched	切换与瞬时	bool	true/false	false	决定 ON/OFF 周期
Message Type	开关消息的子类型	enum	Note、CC、Program Change、Tap Tempo	Note	选择消息子参数
Note	音符编号（Note 模式）	Note	0–127	0x30（C4）	Note On/Off
Controller On	按下时的 CC 编号（CC 模式）	uint7	0–127	64	CC 编号
Value On	按下时的 CC 值	uint7	0–127	64	CC 值
Controller Off	释放时的 CC 编号（CC 模式）	uint7	0–127，可选	disabled	CC 编号
Value Off	释放时的 CC 值	uint7	0–127	65	CC 值
CV On/Off	门控输出	CV config	enabled/disabled	disabled	0–5 V 门控

踏板 — Kick 模式

检测冲击瞬态，并发出力度与冲击速度成正比的音符。

参数	说明	类型	范围	默认值	MIDI 映射
Note	触发的 MIDI 音符	Note	0–127	0x24（C2）	Note On 音符编号
Velocity Sensitivity	根据冲击速度缩放力度	uint8	0–100（%）	100	音符力度
Impact Threshold	触发所需的最小增量	float	0.0–1.0	0.1（10%）	过滤噪声
Duration Mode	音符长度模式	enum	Fixed、Until Release	Until Release	NoteOff 时机
Fixed Duration (ms)	Fixed 模式下的音符时长	uint16	1–65535 ms	100 ms	NoteOff 延迟
CV Gate	触发时的 CV 门控输出	CV config	enabled/disabled	disabled	0–5 V 门控
CV Velocity	与力度成正比的 CV 输出	CV config	enabled/disabled	disabled	0–5 V 力度

踏板 — Sustain Binary 模式

发送一个二值 CC（通常为 CC#64 延音），具有不同的 ON 和 OFF 值。

参数	说明	类型	范围	默认值	MIDI 映射
Latched	切换模式	bool	true/false	false	ON/OFF 切换
Controller	CC 编号	uint7	0–127	64（延音）	CC 编号
On Value	激活时的 CC 值	uint7	0–127	127	CC 值
Off Value	未激活时的 CC 值	uint7	0–127	0	CC 值
CV On/Off	门控输出	CV config	enabled/disabled	disabled	0–5 V 门控

踏板 — Sustain Continuous 模式

跟踪连续的踏板位置，并将其作为 CC 值发送（默认为 CC#64）。

参数	说明	类型	范围	默认值	MIDI 映射
Controller	CC 编号	uint7	0–127	64（延音）	连续 CC
Invert Continuous	翻转踏板极性	bool	true/false	false	反转值曲线
Pressure CV	来自踏板位置的 CV 输出	CV config	enabled/disabled	disabled	0–5 V 位置

踏板 — Expressive 模式

将连续的踏板位置作为表现力 CC 进行跟踪（默认为 CC#11）。

参数	说明	类型	范围	默认值	MIDI 映射
Controller	CC 编号	uint7	0–127	11（表现力）	连续 CC
Invert Continuous	翻转踏板极性	bool	true/false	false	反转值曲线
Pressure CV	来自踏板位置的 CV 输出	CV config	enabled/disabled	disabled	0–5 V 位置

踏板 — Hi-Hat 模式

将连续位置 CC（CC#4）与基于冲击的踩镲（chick）音符检测相结合，用于实现闭合 hi-hat 声音。

参数	说明	类型	范围	默认值	MIDI 映射
Controller	连续位置 CC	uint7	0–127	4（脚踏控制器）	CC#4 位置
Invert Continuous	翻转踏板极性	bool	true/false	false	反转位置曲线
Chick Note	脚踩 chick 时触发的音符	Note	0–127	0x2A（F#1）	Note On/Off
Chick Velocity Sensitivity	缩放 chick 力度	uint8	0–100（%）	50	chick 音符力度
Chick Impact Threshold	触发 chick 所需的最小增量	float	0.0–1.0	0.1（10%）	过滤缓慢闭合
Closed Threshold	启用 chick 检测的踏板位置	float	0.0–1.0	0.9（90%）	chick 启用阈值
Chick Duration (ms)	chick 的 NoteOff 延迟	uint16	1–65535 ms	50 ms	NoteOff 时机
Chick Dead Time (ms)	有效 chick 的最大持续时间	uint8	1–255 ms	100 ms	防止缓慢闭合触发
CV Gate	chick 时的门控输出	CV config	enabled/disabled	disabled	0–5 V 门控
CV Continuous	来自踏板位置的 CV 输出	CV config	enabled/disabled	disabled	0–5 V 位置