XiAlgo · User Manual

XiAlgo 用户手册 v1.0

安装 · 拖拽建链 · 调优 · MIPS 预算 · 签名部署

文档编号：D2-P5-MAN-001 · 版本：v1.0 · 发布：2026-05-05

从一个算法块到一整套音响方案 · 一份手册搞定

6

算法套件

拖拽

建链方式

实时

仿真反馈

XiAlgo 用户手册 v1.0

摘要

本手册面向 XiAlgo 算法库的首次使用者：Tier1 调音工程师、主机厂声学团队、后装改装厂、IDM 客户算法移植团队。 内容覆盖算法包安装 → XiStudio 拖拽建链 → 参数调优 → MIPS 预算 → 仿真验证 → 烧录部署 → 量产校验全流程，目标是让新用户1 天内跑通第一个完整算法链并产出可听的主观改善。

阅读前提

• 已阅读 XiAlgo 产品概述 与 XiAlgo 产品规格书
• 已安装 XiStudio（Community 或 Pro 版）
• 已有一台 XiDSP EVK-D1 或等效目标板
• 熟悉基本 DSP 概念（EQ / DRC / 采样率）

---

1. 算法包获取与安装

1.1 算法包 Tier 对照

Tier	来源	授权需求
Free	XiStudio 应用市场自动下载	无需合同
Pro	合同签订后获取下载链接	Pro 订阅
Pro+	合同 + 客户白名单（Device UUID 绑定）	Pro+ 订阅 + NDA
Custom	定制交付	Enterprise / IDM 合同

1.2 安装目录

XiStudio 启动时扫描以下位置：

Windows: %APPDATA%\Xisound\XiStudio\packages\
macOS:   ~/Library/Application Support/Xisound/XiStudio/packages/
Linux:   ~/.config/xisound/xistudio/packages/

把下载的 .xipkg 文件拖入该目录 → 重启 XiStudio → 自动加载。

1.3 应用市场安装（Free / Pro）

XiStudio 菜单 → 扩展 → 算法市场：

graph LR
    Market[算法市场] --> Search[搜索 · 筛选 Tier]
    Search --> Detail[查看算法详情]
    Detail --> Install[点击 · 安装]
    Install --> Verify[自动验签 + 激活]
    Verify --> Ready[Palette 出现新块]

    class Market xyL5
    class Search,Detail xyL2
    class Install xyL3
    class Verify xyWarn
    class Ready xySuccess

1.4 安装完成核对

菜单 帮助 → 已加载算法包 可查看： - 包名 / 版本 / ABI - 来源（官方 / 客户 / 自签） - 签名状态（✅ 已验证 / ⚠️ 开发模式） - 占用磁盘

---

2. 首个算法链：2ch 立体声 EQ + DRC + 限幅

2.1 目标

用 XiAlgo-FX 套件搭一条最简单但完整的调音链：

Input 2ch → PEQ_5band → DRC_multiband → Limiter → Output 2ch

2.2 操作步骤

1. 新建工程：文件 → 新建 → XiDSP-D1 项目
2. 把 Palette 里的 FX / PEQ_5band 拖到画布
3. 接下来依次拖 DRC_multiband / Limiter
4. 用鼠标从 Input 节点拉线到 PEQ → DRC → Limiter → Output
5. Ctrl+S 保存

2.3 第一次编译

菜单 → 编译 → 为 XiDSP-D1 编译：

Compile  ...
  ✓ Graph topology resolved (4 blocks)
  ✓ Parameter validation ok
  ✓ MIPS estimate: 25 / 300 (8%)
  ✓ Memory estimate: 3.2 KB / 96 KB (3%)
  ✓ Generated build/firmware.xifw (128 KB)
Done in 2.3 s

2.4 烧录到 EVK

菜单 → 设备 → 连接 EVK-D1 → 烧录 firmware.xifw

等看到 LED D2 心跳闪 = 烧录成功 + 固件运行。

2.5 听听看效果

• 把手机 3.5mm 接到 EVK Line In
• 把有源音箱接到 EVK Line Out
• 播放任意音乐
• 在 XiStudio 中实时调 PEQ 低频增益 → 应立刻听到低频变化

---

3. 参数调优

3.1 参数面板基础

双击画布上的 PEQ_5band 块 → 打开参数面板：

┌─ PEQ_5band ──────────────────────────────────┐
│ Band 1:  Freq [  100 Hz] Gain [+3.0 dB] Q [1.0] │
│ Band 2:  Freq [  500 Hz] Gain [  0.0 dB] Q [1.0] │
│ Band 3:  Freq [ 1000 Hz] Gain [  0.0 dB] Q [1.0] │
│ Band 4:  Freq [ 5000 Hz] Gain [  0.0 dB] Q [1.0] │
│ Band 5:  Freq [10000 Hz] Gain [+2.0 dB] Q [1.0] │
│                                                   │
│ [ 重置默认 ] [ 保存预设 ] [ 加载预设 ]              │
└───────────────────────────────────────────────┘

3.2 调参最佳实践

工程师经验法则

1. 先切后调：先选合适的 Crossover / 通道拓扑，再动 EQ / DRC
2. 低频优先：人耳对 80-200 Hz 最敏感，先调这里
3. 留余量：PEQ Gain 正向最多 +6 dB，超了易失真
4. 双重检查：改完每个块听一下，避免一口气改到整链无救
5. 记录变化：用 XiStudio 参数历史 功能保留改动轨迹

3.3 参数斜坡（Ramp）

所有参数变化有默认 20 ms 渐变，保证无爆音。如需更快 / 更慢：

• 块右键 → 高级参数 → ramp_ms
• Gain / Freq 建议 10-30 ms
• Threshold / Ratio 建议 5-10 ms（DRC）
• 不连续量（Bypass / ModeSwitch）自动做 50 ms Fade

---

4. MIPS 预算与性能监测

4.1 编译时估算

每次编译后 XiStudio 输出 MIPS 报告：

MIPS Budget Report (XiDSP-D1 · 300 MIPS total)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  System Overhead          20 MIPS  ██▌              6.7%
  PEQ_5band × 2            20 MIPS  ██▌              6.7%
  DRC_multiband × 2        24 MIPS  ███              8.0%
  Limiter × 2               6 MIPS  ▌                2.0%
  ─────────────────── ─────────── ──────────────── ─────
  Used                     70 MIPS  ████▌           23.3%
  Free                    230 MIPS  ███████████████ 76.7%
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✓ Within budget

4.2 运行时监测

烧录后 菜单 → 性能 → Real-time Scope 实时查看：

• 每 100 ms 刷新
• Per-block 耗时（微秒）
• 总 MIPS 利用率
• 帧超时计数（应永远为 0）

MIPS 超预算警告

若运行时 MIPS > 95% → 出现间歇性声音卡顿 / WDT 降级。应立即精简算法链或升级到更高型号 DSP（D2+）。

4.3 MIPS 优化手法

手法	效果	适用
合并相邻 PEQ	5 段 PEQ × 2 = 2 个 → 1 个 10 段	PEQ 节省 ~30%
降低采样率	96 kHz → 48 kHz	直接减半
关闭未用通道	4ch → 2ch	线性比例下降
用定点替 FP32	PEQ FP32 → Q1.23	D1 节省 ~20%
减少 ASRC	用同源时钟减少 1-2 路 ASRC	每路 ~10 MIPS

---

5. 仿真验证

5.1 位精确仿真

XiStudio 内置位精确仿真器，可在无硬件时验证算法：

1. 菜单 → 仿真 → 加载音频
2. 选 WAV / FLAC / PCM（支持 16/24/32-bit · 44.1/48/96 kHz）
3. 点 运行仿真
4. 仿真结束后播放结果 / 导出 WAV

5.2 性能预测

仿真模式下还可得： - 实际 MIPS 数据 - 节点级波形（任意中间信号） - THD+N / SNR / 频响 客观指标（调用 XiTest 算法）

5.3 仿真与真机对比

仿真 vs 真机差异

仿真 位精确 = 真机输出位完全一致。若听感不同，几乎必然是源文件 / DAC / 测试环境差异，不是仿真误差。

---

6. 典型场景

6.1 场景 A：2ch 立体声家影后装

Input 2ch → Crossover_2way → [Low] Delay → Reverb →
                              [High] PEQ_5 → DRC_2band → Limiter
         → Output 2ch (L/R)

• 特点：声场 + 低频补偿 + 保护
• 典型 MIPS：~80 / 300
• 参考：《XiAlgo 场景库 · Home Theater》预设

6.2 场景 B：车载 8ch 前后排 + 中音

Input 8ch → Per-channel PEQ_10band → DRC_multiband ×8 →
            Zone_4zone →
            RoadNoise_NLMS (降噪) →
            Limiter ×8 →
            Output 8ch

• 特点：多音区 + 路噪降噪 + 每通道独立
• 典型 MIPS：~180 / 300（需 D1 全力）
• 参考：《XiAlgo 场景库 · In-Vehicle》预设

6.3 场景 C：专业现场 KTV

Mic 2ch → EchoCancel → PEQ + Limiter →
          Harmony (和声) → KeyShift (变调) →
          Chorus (合唱) → Reverb →
          Output 2ch

• 特点：卡拉OK 特效完整
• 典型 MIPS：~120 / 300
• 参考：《XiAlgo 场景库 · KTV》预设

---

7. 预设管理

7.1 保存预设

在任意参数面板 → 保存预设 → 起名 → 存到：

~/Xisound/XiStudio/presets/user/

预设以 .xipreset 文件（小型 JSON + 签名），可分享给同事。

7.2 加载预设

参数面板 → 加载预设 → 选 .xipreset → 所有参数一次性替换。

7.3 预设对比（A/B）

菜单 → 参数 → A/B 对比： - A 槽：当前参数 - B 槽：保存为快照 - 鼠标点 A/B 瞬间切换 → 用耳朵判断

---

8. 签名与部署

8.1 开发阶段

开发调试不强制签名：XiStudio 允许加载未签名的 .xipkg，但会 Toast 警告"开发模式"。

8.2 客户部署

量产必须签名

• 客户部署 / 量产固件必须用客户私钥签名所有自研 .xipkg
• 未签名包在 XiDSP OTP 安全模式下无法加载
• 签名命令：xi-algo-sign sign <pkg> --key <customer_private.pem>（详见 api.md §5）

8.3 IDM 部署

IDM 客户可拿 算法源码 自行签名流程：

1. Xisound 交付 Custom Tier 源码包 + 编译工具链
2. 客户自建 CI 编译 → .xo → 打包 .xipkg
3. 用客户私钥签名
4. 烧录到客户专属 Die Lot（OTP 带客户 ID）
5. 批量部署

---

9. 故障排查

9.1 常见故障速查

现象	可能原因	解决
Palette 找不到算法块	.xipkg 未放对目录	检查 §1.2 路径
加载时 "Signature invalid"	签名校验失败	向供应商索取正确签名版本
加载时 "ABI mismatch"	XiStudio 版本过旧	升级到 .xipkg 对应 XiStudio 版本
编译时 "MIPS exceeded"	算法链太重	简化 / 升级 DSP 型号 / 降采样率
听到周期性爆音	Ramp 时间过短	放大 ramp_ms 到 20+ ms
DRC 听感"泵"	时间常数不匹配	增大 Attack+Release，降低 Ratio
NR 收敛慢	步长过小	逐步提高 μ（见算法包调参 FAQ）

9.2 日志导出

菜单 → 帮助 → 导出 XiAlgo 诊断包 生成 xialgo-diag-YYYYMMDD.zip，含：

• 算法包加载日志
• 当前工程 .xiproj
• 运行时 MIPS 采样曲线
• 错误码历史

报 Bug 给 FAE 时请附带此包。

---

10. 进阶：编写自己的算法块

10.1 基本流程

1. 拿 SDK：Pro+ 或 IDM 订阅后获取 XiAlgo SDK（含头文件 + 编译器）
2. 写 C 源码：实现四个生命周期函数（init/process/update_param/destroy）
3. 编译：xi-algo-build myblock.c --target d1 -o myblock_d1.xo
4. 打包：xi-algo-pack --manifest mypkg.json --out mypkg.xipkg
5. 签名：xi-algo-sign sign mypkg.xipkg --key mine.pem --out mypkg-signed.xipkg
6. 拖到 packages 目录 → XiStudio 启动即可用

10.2 编码规范

详见 算法开发规范，核心要点：

• process() 不得 malloc / free / printf
• 状态变量用 XiCore Memory Pool 在 init 时申请
• 用 xi_mac_* 系列 intrinsics 榨取 DSP 流水线性能
• 参数变化要能实时响应 update_param

10.3 调试技巧

• 用 xi_trace_printf 代替 printf（只在非实时路径安全）
• 用 XiStudio Scope 可视化任意内部信号
• 用 XiTest 做 MIPS + 频响自动回归

---

11. 附录

11.1 规格速查

项	值
支持 DSP	XiDSP-D1 / D2 / D3 / D4 / A1
支持 XiStudio	v1.0+
支持系统	Windows 10/11 · macOS 12+ · Ubuntu 22.04+
典型包大小	0.5 - 5 MB
最长 .xipkg 加载时间	≤ 2 s

11.2 关联文档

• XiAlgo 产品概述
• XiAlgo PRD v1.0
• XiAlgo 产品规格书
• XiAlgo API 文档
• XiAlgo 技术架构
• XiAlgo FAQ
• XiAlgo 培训材料
• XiStudio 用户手册
• XiDSP 用户手册
• 算法开发规范

11.3 售后与保修

• 工单：Enterprise+ 客户 CRM 系统
• 邮箱：support@xisound.com
• 社群：Discord / 微信群（签约后加入）

11.4 版本历史

版本	日期	要点
v1.0	2026-05-05	首版 · 安装 / 建链 / 调参 / MIPS / 仿真 / 签名 / 排错 / 自研入门

---

user-manual.md · D2-P5-MAN-001 · v1.0 · 2026-05-05 · Xisound 交付中心 · FAE 团队