工程与存储

一个工程是一首歌：四条轨道的音源和音色、所有 Pattern、编排、混音、每轨效果和总线效果、BPM 和 Swing、键盘设置，以及每条轨道的和弦和琶音。工程存在 SD 卡上，在 0 SETUP 的 PROJECT 和 FILES 页保存、载入、新建。手上正在做的东西也会自动存到卡上（见 工作状态会被保留）。SD 卡是鸣片唯一存东西的地方：没有卡就什么都存不下。

存在工程里	不在工程里
音源、音色、采样（按文件名）、Pattern、编排、混音（音量、静音、独奏、SEQ）、每轨和总线效果、BPM、Swing、键盘（KEYS）、和弦和琶音	SELECT（应用偏好）、设备设置（音量、按键灯、屏幕、日志）、LOOP / SONG、REC

保存、另存、新建、打开

01FN+S

任何画面按 FN+S（或 FN 菜单的 SAVE）：马上存好，底部显示 SAVED 和名字。还没有名字的工程自动用第一个空着的名字：SONG 01、SONG 02……

02按住ESC+9G1

0 SETUP PROJECT：SAVE、LOAD、NEW；SAVE AS（自己起名）在这一页的 FN 菜单里。

03CTRL

FILES：卡上的工程；↑← / ↓SUB 选择，↵OK 载入。

同一时刻的屏幕和按键灯

1. 1SAVE 保存
2. 2LOAD 打开 FILES 列表
3. 3NEW 新建
4. 4工程名 · UNSAVED：有没保存的改动

SETUP 的 PROJECT 页。

• 有未保存的改动时，PROJECT 页工程名旁边写着 UNSAVED，FN 菜单的 SAVE 也写着 UNSAVED；新建或打开别的工程前会先确认（↵OK 是，ESC 否）。
• PROJECT 和 FILES 页的 FN 菜单有 NEW、LOAD、SAVE AS。详见 PROJECT 工程 和 FILES 工程文件。
• NEW 的工程是默认的四轨 T1 DRUMS T2 JUNO T3 DX7 T4 SAMPLER，演奏设置也是默认的（C 大调、没有和弦、琶音关闭）。
• 保存失败时底部会说明原因：NO SD CARD（开机时没有插卡）、SD CARD ERROR（卡写不进去）、SAVE SAMPLE FIRST（有一段录音还没保存）、NO MEMORY。载入失败：INVALID PROJECT、SAMPLE MISSING（工程用到的采样不在 Samples/ 里）、NO MEMORY。
• 工程是纯文本文件，格式 7（.ccproj）；格式 1–6 也能读（6 之前的文件没有键盘、和弦和琶音，载入时保持现在的设置）。0.1.0 版只能打开格式 1–6：这个固件保存的工程是格式 7。采样按文件名引用，在卡上改名或删除一个采样会影响所有用到它的工程。
• 写文件是原子的：先写临时文件再替换，保存时断电也不会坏掉。

工作状态会被保留

插着 SD 卡时，随时可以关机或直接拔电：当前的工作状态会自动存到卡上，下次开机原样回来。

• 内容和工程一样，另外还记着工程名和是不是 UNSAVED（所以载入别的工程时照样会先问）。回来时停在 T1。
• 按键停下来就写：最后一次按键 1.5 秒后、没有按住的键，播放中也一样。一直在按键（或者有采样正从卡上播放）时，最多等 60 秒。写卡在后台进行，音乐和屏幕都不用等它；没改变任何东西的按键不会触发写入。切换到别的应用时马上写。
• 它不是工程：只有 SAVE 才会写出有名字的工程。想留下来的东西要保存，载入或新建别的工程之前也先保存。
• 写不进去时屏幕显示 AUTOSAVE FAILED: SD CARD ERROR（卡被拔掉时是 NO SD CARD），之后会一直重试；卡一恢复就把改动写进去。
• 还没保存的录音放在卡上（Session/take-<轨道>.wav）；重启后它会回来，屏幕显示 UNSAVED TAKE IS BACK。用到的采样不在卡上时，卡回来后自动载入。
• 如果连续三次没能正常启动，下一次启动会跳过一次工作状态。
• 不保留的：无感录制的 take，以及是不是正在播放。没有卡时什么都不保留（见 没插卡或卡坏了）。

提示

设置（SELECT、音量、灯、屏幕、日志）改动后约 1 秒自动写到 SD 卡，不用手动保存。

SD 卡上的目录

所有东西都在卡根目录的一个文件夹 CardenzaSynth 里：

<SD 卡>/CardenzaSynth/
  Settings/system.cfg      设备设置（音量、灯、屏幕、日志）
  Settings/synth.cfg       音乐工作站的偏好（SELECT）
  Projects/                工程（.ccproj）
  Presets/<音源>/           自己保存的音色
  Samples/                 采样，所有应用共用
  Session/                 工作状态、还没保存的录音
  Logs/                    日志（log.txt）
  Apps/<作者>/<名字>/       别的应用，各有自己的文件夹

• 这就是 0.1.0 版的目录：它的工程、音色和采样原地使用。
• 别的固件的目录（开发版的 Cardenza/ 文件夹，0.1.0 之前的 CardenzaSynth/Project、Preset、Sample）不读也不改。要用里面的文件，在电脑上把它们复制到上面的文件夹里：文件格式是一样的。
• 每个应用只写自己的文件夹和共用的 Samples/。

设置文件

Settings/ 里的 .cfg 是纯文本，一行一个 key=value，在电脑上也能看、能改：

# Cardenza settings: Cardenza/Synth (storage protocol 2)
keys.select=1

读的时候很宽容：坏掉的行会跳过，不认识的键原样保留（新旧固件可以共用一张卡）。设备写入改动时会先重新读一遍文件，只改在设备上改过的项，所以在电脑上改的内容会留下。

日志

0 SETUP SYSTEM 的 LOG 打开（默认）并且插着卡时，鸣片把它报告的内容写进 CardenzaSynth/Logs/log.txt：每次开机和固件版本、载入和保存、出错，以及崩溃时的报告。文件超过 512 KB 后改名为 log.1.txt，重新开始一个。

出了问题（死机、声音停了、保存失败），把这两个文件连同简单的说明发给我们：里面记着发生了什么。LOG 关闭时什么都不写。

没插卡或卡坏了

同一时刻的屏幕和按键灯

1. 1SD 卡：READY / NOT FOUND
2. 2音量 · 按键灯 · 屏幕 · 日志

SETUP SYSTEM：SD 卡状态。

鸣片只在开机时找一次卡。

• 开机时没有卡：开机动画之后弹出提示 NO SD CARD、NOTHING WILL BE SAVED、INSERT A CARD AND RESTART TO SAVE（↵OK 或 ESC 关掉）。这一次运行里设备完全不碰卡，之后再插进去也一样：可以弹、可以改设置，但断电后什么都不会留下；保存提示 NO SD CARD，FILES 是空的，教程也不会开始。插上卡，重新开机。
• 用着用着卡没反应了：失败的那次操作提示 SD CARD ERROR，设备会重新找卡；卡恢复后，设置和工作状态会写进去。
• SETUP SYSTEM 上显示卡的状态：SD CARD READY 或 NOT FOUND。