XiAlgo 常见问题 FAQ v1.0
XiAlgo 常见问题 FAQ v1.0
摘要
本文档汇集 XiAlgo 算法库从选型、安装、调参、部署到售后全流程的 40+ 高频问题。目标读者:Tier1 调音工程师、主机厂算法团队、后装改装厂、IDM 客户。 FAE 在回答客户时可直接引用本文条目。条目定期从工单系统 / 展会问答中提炼更新。
查找方式
- Ctrl+F 关键词
- 8 大类快捷跳转见下方目录
- 若找不到答案,请联系
support@xisound.com或开工单
1. 选型(Selection)
1.1 我做车载音响,应选哪些套件?
- 基础调音:FX(PEQ / DRC / Crossover)必选
- 路噪场景:加 NR(RoadNoise_NLMS + WindNoise)
- 多音区:加 Zone(前排 / 后排独立)
- 未来 AI 扩展:预留 Pro+ AI 升级路径(需 D2+ 芯片)
- 典型组合:Pro · FX + NR + Zone 三套件 覆盖绝大多数车载项目
1.2 Free / Pro / Pro+ 怎么选?
- Free:做评估 / 原型 / 教学 · 不能量产
- Pro:Tier1 量产主流选择 · 年订阅
- Pro+:要 AI / 车规 / 8-Zone / 3D 再升级
- Custom:需要源码 + IDM 才上
1.3 XiAlgo 能不能用在非 XiDSP 芯片上?
- v1.0:仅支持 XiDSP D1
- 2027+:规划支持 ADI SHARC / TI C66x(通过 Custom Tier 移植 NRE)
- 客户自研 DSP:IDM 客户可拿源码 + 编译器后端移植
1.4 小 Tier1 / 后装改装厂能用 Pro 吗?
完全可以。XiAlgo Pro Tier 定价对中小客户友好,3-10 席位的小团队都是典型客户画像。
1.5 AI 套件 v1.0 支持什么芯片?
D2 及以上(D2 B0 量产目标 2028 Q4)。D1 不支持 AI 套件(无 AI 协处理器)。
2. 安装与加载(Installation & Loading)
2.1 .xipkg 拖到 packages 目录后 Palette 没出现?
- 检查签名状态:菜单 → 帮助 → 已加载算法包 看是否 ❌ 状态
- 检查 ABI 版本:XiStudio 版本需匹配
.xipkg的 ABI - 重启 XiStudio(部分缓存需清理)
- 查看日志:菜单 → 帮助 → 日志查看器 搜 "LoadError"
2.2 "Signature invalid" 错误怎么办?
- 确认下载未损坏(重新下载一次)
- 确认使用的是对应客户 / 版本的签名包(找商务索要)
- 开发阶段可在 XiStudio 设置里允许未签名包(仅限调试)
2.3 "ABI mismatch" 错误?
- 算法包要求的 ABI > XiStudio 当前支持
- 升级 XiStudio 到对应大版本
2.4 两个不同版本的同一套件能共存吗?
不可以:同一 name 的套件只能存在一个版本。升级新版本必须先卸载旧版本。
2.5 Custom Tier 源码包收到后怎么编译?
- 安装 XiAlgo SDK(随源码交付)
- 设置环境变量
XI_SDK_PATH - 运行
make all或按 README 执行 - 产出
.xo→ 打包.xipkg→ 签名 → 安装
3. 调参(Parameter Tuning)
3.1 PEQ Q 值设多少合适?
- 窄调(精修):Q = 5-10
- 通用(音色调整):Q = 1-3
- 宽调(曲线修形):Q = 0.5-1
- 切勿超 15:数值稳定性下降 + 听感奇怪
3.2 DRC 如何调参避免"泵"效应?
- Attack 不要太快(≥ 5 ms),否则出现喘息感
- Release 不要太慢(≤ 200 ms),否则尾声拖泥
- Ratio 不要太陡(≤ 6:1 更自然)
- Knee 用 Soft Knee 减少"咔哒"感
3.3 NR 步长(μ)怎么调?
- 太小:收敛慢 · 追不上变化
- 太大:发散 · 反而产生失真
- 经验值:RoadNoise μ = 0.001 - 0.01,逐步 A/B 试听
- 用 XiStudio Scope 看 Error 信号收敛情况
3.4 AEC 双讲能完美消除吗?
- 单讲(只 far-end 讲):ERLE 可达 35-40 dB
- 双讲:ERLE 目标 25-30 dB(行业共识)
- 不要期待 60 dB:完美抑制双讲是理论难题
3.5 Zone 前后音场"漏音"严重?
- 开 Crosstalk 解耦算法块(Zone 套件)
- 调 Delay 对齐各 Zone 声波时差
- 物理声学层面也要配合:扬声器指向性 + 吸音棉
3.6 参数突变听到"咔嚓"声?
- 增大
ramp_ms(建议 20-50 ms) - 对切换型参数(Bypass / ModeSwitch)设 Fade-in/out ≥ 30 ms
4. MIPS / 性能(Performance)
4.1 编译时警告 "MIPS Exceeded" 怎么办?
- 合并:把 5 × PEQ_5band 改为 1 × PEQ_31band
- 降采样率:96 → 48 kHz 直接减半
- 关通道:未用通道 mute 掉
- Tier 升级:D1 不够 → D2 / D3
- 删重复:Crossover 前后 Gain 去掉多余一段
4.2 运行时突然出现间歇爆音?
- MIPS 利用率接近 95% 可能触发 WDT → 降级 Bypass
- 查 菜单 → 性能 → Real-time Scope
- 减少算法 · 或升级 DSP 型号
4.3 编译时 MIPS 和运行时 MIPS 差多少?
通常 ±5% 以内: - 编译时是最坏情况估算 - 运行时是实测 - 若差 > 10%,请联系 FAE(可能 SDK 版本问题)
4.4 内存不足怎么办?
- 删除多余 Reverb(占用大)
- 换用更小的 NR 版本("Lite" 版本节省一半内存)
- 升级到更高 SRAM 的 DSP(D2: 1 MB, D3: 4 MB)
4.5 FP32 比 Q1.23 定点算法好吗?
- 精度:FP32 理论精度更高
- 实测:声学 THD+N 差异 < 1 dB · 人耳听不出
- CPU:FP32 在无硬件支持的 D1 上贵 3-5 倍 MIPS
- 建议:D1 用定点,D2+ 有 FP32 单元时按需启用
5. 签名与授权(Signing & Licensing)
5.1 什么场合需要签名?
- 开发调试:不强制(XiStudio 允许未签名包加载,但有警告)
- 客户量产:必须签名(XiDSP OTP 开启 Secure Boot 后拒绝未签名)
- IDM 部署:客户私钥签名
5.2 签名密钥怎么管理?
- 建议使用 HSM(硬件安全模块)存储私钥
- CI / CD 流程中私钥只有自动化账户可访问
- 每年轮换一次密钥 · 旧密钥保留归档
5.3 客户密钥丢失怎么办?
- 立即通知 Xisound 吊销该密钥
- Xisound 签发新密钥 + 新白名单给客户
- 产线重新烧录新签名版固件
5.4 Pro+ 的 UUID 白名单什么时候提交?
- 量产前 2 周发给商务中心
- 每批次 UUID 白名单须签名
- 超过合同量的 UUID 需追加合同
5.5 IDM 源码授权可以转授权给其他公司吗?
- 默认不可以(合同红线条款)
- 特殊需求可谈"二级授权" → CFO + 法务 + CEO 三签
6. 车规与合规(Automotive & Compliance)
6.1 XiAlgo 能用于车规项目吗?
- Pro Tier:可用于车规研发 / 原型项目
- Pro+ Tier 车规增强包:目标 ASIL-B,尚未完成认证(预计 2028)
- A1 配套:A1 芯片车规认证完成后 XiAlgo 车规包同步发布
6.2 ISO 26262 ASIL-B 已经通过了吗?
未通过 · 规划中。Pro+ 车规增强包目标 2028 完成 ASIL-B 合规,届时提供:
- Safety Manual
- FMEDA 分析报告
- 失效注入测试结果
- Health Monitor API
6.3 可以自己做 ISO 26262 验证吗?
- Custom Tier 拿源码客户可自建 Safety Case
- Xisound 提供源码可追溯性文档 + 测试用例
- 认证机构(TÜV 等)审计时 Xisound 可配合
6.4 算法可以提供 FDA / CE / FCC 认证支持吗?
- XiAlgo 本身不做这些(算法不认证,系统才认证)
- 客户整系统认证时 Xisound 可提供必要的算法技术文档
7. 定制 / IDM(Customization & IDM)
7.1 能帮我们开发客户专属算法块吗?
可以,走 NRE 流程:
- 20-100 工程周不等
- 里程碑付款
- 开发完成后以 .xipkg 或源码形式交付
- 见 pricing.md §5 NRE 定制开发费
7.2 IDM 客户能拿到哪些源码?
Custom Tier L2+: - XiAlgo 六套件全部算法源码 - XiCore 运行时(部分) - 编译器后端(可移植到客户自研 DSP) - 测试用例 - Xisound 不提供 XiStudio IDE 源码
7.3 IDM 客户自行改动源码后 Xisound 还支持吗?
- 未改动部分:正常支持
- 改动部分:客户自行维护(保修条款不覆盖)
- 重大 Bug 可付费请 Xisound 代查
7.4 Royalty 漏报 / 少报会有什么后果?
- 合同有年度审计条款
- 首次漏报:补缴 + 警告
- 故意瞒报:合同终止 + 违约金
- 情节严重:法律追究
8. 技术支持 / 售后(Support & Warranty)
8.1 技术支持 SLA?
| Tier | SLA(工作日) |
|---|---|
| Free | 社区论坛尽力而为 |
| Pro | 48 小时邮件 |
| Pro+ | 24 小时 + 专属 FAE |
| Custom | 8 小时 + 驻场可选 |
8.2 怎么开工单?
- Enterprise+ / Pro+ 客户:CRM 系统(签约时开通账号)
- Pro 客户:
support@xisound.com邮件(注明合同号) - Free 用户:Discord 社区 / 微信群
8.3 有中文文档吗?
- 核心文档(overview / spec / user-manual / faq)中文优先
- API / tech-arch 中英双版
- IDM 专属英文白皮书
8.4 有培训课程吗?
有,详见 training.md:
- L1:算法库基础(免费在线)
- L2:调参工坊(收费 · 2-3 天)
- L3:自研算法开发(Custom / IDM 定制)
8.5 能安排工程师到现场吗?
- Pro+:每年 1 次免费,其余按工日付费
- Custom / IDM:按合同约定 · 典型 5-20 工日 / 年
- 现场差旅 + 住宿另计
8.6 出 Bug 需要提供什么信息?
- XiStudio 版本 + XiAlgo 套件版本
- XiDSP 型号 + 固件版本
.xiproj工程文件- XiStudio 导出 XiAlgo 诊断包(菜单 → 帮助)
- 问题重现步骤 / 测试音频
9. 其他(Misc)
9.1 XiAlgo 与 XiStudio 必须同版本吗?
- 小版本(Minor / Patch)兼容范围大
- 大版本(ABI)必须匹配:
- XiAlgo ABI v1.0 ↔ XiStudio v1.x
- XiAlgo ABI v2.0 ↔ XiStudio v2.x
9.2 换 XiDSP 型号(D1 → D2)需要重新买 XiAlgo 吗?
- Pro Tier:通常不用重新买(同一项目订阅覆盖 D1/D2)
- 合同条款为准:部分合同按型号授权 · 需补差价
- 联系商务确认
9.3 XiAlgo 会停更停维吗?
- v1.0 承诺维护:至少到 2030(4+ 年)
- EOL 通知:提前 12 个月通知所有客户
- Custom / IDM 源码客户即使 EOL 后仍可自维护
9.4 能与第三方算法库混用吗?
可以。XiAlgo 算法块与客户自研块共享 XiCore 运行时,同框架下协同工作:
- xi-algo-build 可编译客户自研 C 源码到 .xo
- 客户自研块 + XiAlgo 官方块可混合图编辑
9.5 开源项目可以用 XiAlgo Free Tier 吗?
可以。个人 / 开源项目 / 教育用途免费。但 Free Tier 不含商业量产授权。
10. 附录
10.1 FAQ 更新机制
- 每季度由 FAE 团队从工单系统 / 展会 / 邮件中汇总高频新问题
- 每重大事件(新版本 / 新套件 / 破坏性变更)即时补充
- 本文版本 v1.0 → 下一版 v1.1 目标 2026 Q3
10.2 关联文档
- XiAlgo 产品概述
- XiAlgo PRD v1.0
- XiAlgo 产品规格书
- XiAlgo 用户手册
- XiAlgo 定价单
- XiAlgo 竞品对比
- XiAlgo 版本更新日志
- XiAlgo 培训材料
10.3 版本历史
| 版本 | 日期 | 要点 |
|---|---|---|
| v1.0 | 2026-05-05 | 首版 · 8 大类 40+ 条问答 |
faq.md · D2-P5-MAN-005 · v1.0 · 2026-05-05 · Xisound 交付中心 · FAE 团队