KDocs 研发资料库
  • 音频技术应用文档入口汇总
  • 杰理WINDOWS环境安装及其他事项
  • LINUX安装和编译
  • Linux环境编译SDK教程(ubuntu18.04)
  • 音频类补丁汇总表
  • 认证资料获取汇总(最新资料后台会更新)
  • 《Hi-Res申请指南v1.0》
  • FreeRTOS 开源协议版本
  • uCOS 开源协议版本信息
  • 各个模块关键资料汇总
  • 软件调试方法
  • Makefile编译
  • 提bug的规范
  • 常规设备使用指导
  • 对外特别发布开发注意点信息汇总
  • AD697X软件问题整理
  • AC700N软件问题整理
  • AC701X耳机软件问题整理
  • 951&961软件问题整理
  • AC104X软件问题整理
  • AC128N问题整理文档
  • 可视化工具调试问题整理
  • 耳机资料汇总
  • AC704N、 AC705N相关应用
  • AC695N&AC696N&AC608N音箱问题整理
  • JL701N音箱问题整理
  • AC692X软件问题整理
  • AC706N音箱问题整理
  • JL701N音箱问题整理(可视化工具SDK)
  • JL703N音箱问题整理
  • JL709N(JL689N)音箱问题整理
  • JL7094系列-入门到进阶开发指导
  • AC210N音箱问题整理
  • 无线麦系列版本支持指南
  • AW32N无线麦问题整理
  • lAD697X&JL701X 无线麦软件共性问题整理
  • AC706N无线麦问题整理
  • AW36N无线麦问题整理
  • AC710X无线麦问题整理
  • 唤醒源获取及唤醒IO设置
  • 电源
  • LVD
  • 长按复位配置方法
  • 低功耗应用
  • TIMER
  • UART
  • SPI
  • 内部FLASH空间添加用户自定义区域
  • IIC
  • GPIO
  • MCPWM
  • SD&U盘
  • 时钟&晶振
  • GPCNT
  • IO口crossbar映射功能
  • 文件系统使用总结
  • 复用应用
  • LINEIN_AUX相关应用
  • IIS音频接口应用
  • SPDIF模式相关(HDMI_ARC、光纤、同轴)
  • PDM LINK
  • 外设相关应用
  • 蓝牙相关
  • 杰理蓝牙距离调试文档
  • TWS耳机配对方式使用及生产把控指南
  • GFP谷歌快连及其认证流程指引
  • 蓝牙发射器(bt_emitter)相关
  • BLE应用
  • 关于提升BLE传输速率说明
  • BLE测试数据
  • MUSIC 模式相关应用
  • MIDI音乐实现
  • PC相关应用
  • FM相关应用
  • AC695N_AC696N FM天线ESD静电防护措施说明V2.0_20250107
  • fm应用详细设计说明书
  • 杰理FM硬件指南-20230315
  • ADC模块
  • AUDIO相关应用
  • 新Tools的音效调试使用
  • 混响应用使用说明
  • 音效调式
  • 音箱耳机低音小音量增强实现方法
  • DAC输出功率调试
  • DAC性能测试指南
  • 针对各类底噪、电流声分析流程
  • 录音相关应用
  • OPUS编解码相关
  • RTC相关应用
  • 升级相关
  • UI相关应用
  • 通话调试流程指南
  • 通话相关应用
  • 省电容mic使用手册
  • 如何测试验证手表通话系统的语音失真 V1.0
  • AC695X_AC696X_AD697X 常见通话问题处理参考资料
  • 通话调试问题确定步骤
  • 内置触摸调试指南
  • 低功耗内置触摸介绍V2.2
  • 触摸相关文档
  • AC697X、AC698X内置触摸调试及整改方法V1.0
  • 产测相关应用
  • AC63X BLE DUT测试介绍
  • 兆华序列使用简易说明
  • JL_1T2蓝牙测试盒音频文件更换说明
  • ENC相关应用入口汇总
  • ANC相关应用入口汇总
  • JL DMS通话调试手册-V3.9.4
  • ANC-ENC结构设计要点-20240407
  • 半入耳式ANC耳机器件选型与结构设计指南V1.0
  • JL 耳道自适应调试指南
  • ANC相关问题处理
  • ANC调试文档
  • 评估蓝牙耳机通话上行降噪性能的方法 V1.0 (2)
  • FCC 或者 BQB 认证相关应用
  • BQB profile 测试中常遇到的问题点汇总
  • 蓝牙参数整理20210811
  • 杰理科技认证问题参考
  • 无线音频产品开发指南
  • 无线麦系列从入门到进阶开发指导
  • 量产烧录相关说明
  • 一拖八烧录器远程过程调用说明
  • 量产相关建议
  • EffectTool(eq)调试工具说明文档
  • AC897AD697系列的EQ调试方法-V3
  • 杰理调音指南-20220622
  • 音效模块总结
  • 简要调音步骤指引(可视化)
  • 耳机充电与通信调试指南
  • 充电仓硬件调试指南
  • 充电仓软件问题整理
  • AC951常用说明
  • AC951_AC961_开发板使用说明V1.0
  • 彩屏仓AC982 入门指导及FAQ
  • 蓝牙音频APP相关应用
  • 手机APP的简介和开发流程
  • 蓝牙音频系列-硬件设计指南
  • 静电测试及整改方法-20220706
  • TWS耳机底噪整改指南V1.2
  • 杰理蓝牙距离调试文档
  • 蓝牙RF硬件设计与调试V1.1-20250219
  • AC695N_AC696N FM天线ESD静电防护措施说明V2.0_20241228
  • 音效调试指南
  • 无线话筒K歌音箱标准开发流程
  • 杰理科技 700N TWS耳机产品标准-202303
  • 杰理科技 701N 广播产品标准-202303
  • JL-HAT ANC高效产测自适应
  • 无线话筒测试板使用介绍
  • 一拖八频偏校准使用说明
  • 领夹麦产测工具使用介绍
  • Dongle量产测试说明
  • Dongle+Tws或头戴式 SDK通过工具绑定配对功能说明文档
  • 双麦ENC产测宏配置验证方法 V1.0
  • JL耳机方案麦克风声学测试指令_V1.0
  • JL耳机方案麦克风声学测试指令_V2.0
  • JL_ENC自动测试命令_V0.0.1
  • JL蓝牙测试盒用例说明
  • LDAC自测环境搭建_ubuntu
  • 延迟小板使用手册
  • 杰理库文件的制作及添加实现过程
  • 关于 AC635N&AC636N系列免晶振兼容性补丁 说明
  • 关于 AC63系列VM兼容性修复补丁_20250224 说明
  • 关于 AC632N &AE632N_ 蓝牙& 低功耗兼容性修复补丁 说明
  • AD698N和AC638N电压优化补丁V3说明
  • 关于 AC635N&AC636N漏电和E&G版兼容联合补丁 说明
  • AD698N和AC638N电压优化补丁V2说明
  • 702相关应用
  • 2024-4-30 发布歌词显示SDK开发注意事项
  • BQB RF & FCC 认证测试固件问题汇总及源码
  • BQB profile 测试中常遇到的问题点汇总
  • 进dut测试模式方法及固件
  • 704-频偏修改bin文件合集
  • 701手表BQB PROFILE认证注意事项
  • 认证的干扰规避整改
  • 海外CRA认证报告生成说明
  • JL700N可视化工具问题处理文档
  • JL701X可视化工具问题处理文档
  • JL701N_earphone_release_v1.6.0_ANC 低功耗问题补丁
  • JL708X可视化工具问题处理文档
  • JL709N可视化工具问题处理文档
  • JLstudio可视化工具使用说明
  • 一拖二-串口_蓝牙_app在线EQ、通话参数及调试方式和内置触摸调试
  • 可视化JL701M_DONGLE_SDK添加MIC为发射源
  • 可视化JL701M_DONGLE_SDK添加按键切换usb audio与MIC发射源
  • JL701M_DONGLE_SDK_1.0.0_dongle输入linein输出dac
  • 701可视化_a2dp_to_le_demo说明
  • 耳机系列demo汇总
  • JL7018F&JL7006F_7003F AUX IIS
  • 一键连接应用
  • 普通SDK动态开关一拖二功能
  • 蓝牙分析仪(EllisysBluetoothAnalyzer)抓包例程
  • TWS配对常见应用
  • APP自定义按键的demo
  • AC700N 播歌双EQ DEMO示例及说明
  • AC698V164 MIC与蓝牙音乐共同输出DAC demo
  • 添加第三方算法以及多算法授权流程
  • 空间音频配置方法
  • 普通高低电平TWS耳机控制通讯
  • 入耳检测状态更新demo解析
  • 资源优化(非可视化的SDK)
  • 资源优化(可视化SDK)
  • 翻译耳机、语音识别应用demo
  • 耳机抗干扰问题排查和优化
  • AC698D2 抗干扰优化
  • AC696X软件问题整理
  • AC695X软件问题整理
  • AC695X软件问题整理_1722249702
  • AC608X软件问题整理
  • JL701N_2T1_DUPLEX 应用软件问题汇总
  • le_audio_1.0.0_patch05 以及之前的版本IRkey 功能异常修改
  • AC706N-le_audio-200SDK有线_无线麦录音demo
  • jl701n_le_audio_v200patch02 IO串口升级修改串口单次发送字节长度的修改办法
  • 703创建IIS 输入dac输出音频流demo
  • 703将媒体流音频同时上传PC_mic录音demo实现
  • 703四路IIS输入输出demo
  • 底噪调试
  • AW328A烧录说明
  • 文档合集
  • AC706N_wireless_mic_release_PATCH_20240712 补丁 说明
  • AC706N_wireless_mic_release_PATCH_20240726 补丁 说明
  • AC706N_wireless_mic_release_V1.0.0、1.0.1、1.0.2 补丁 说明
  • AC706N_wireless_mic_release_V1.1.2 中的2T1应用 RX端不绑定配对,TX端实现绑定配对的修改方法
  • 各系列省晶振实现方法
  • iis tx rx说明文档
  • spdif信号
  • 蓝牙电话本
  • 安卓手机同步时间补丁
  • CDC配置
  • PC模式下增加Teams唤起功能
  • 杰理HDMIARC开发实现过程
  • AC701N patch06之前的版本用第三方算法节点实现新版本的pcm delay节点功能
  • (K歌音箱)各SDK音效配置相关说明
  • 长文件录音
  • 点阵屏歌词字库相关(蓝牙歌词,普通歌词)
  • 字模提取工具说明
  • 音箱可视化彩屏-入门到进阶开发指导
  • 彩屏LVGL UI设计及工具使用
  • 使用内部UI框架进行UI调试的系列步骤
  • AD101C使用强制升级工具spi 烧录不了问题处理(测试版本)
  • AD161扩展灯板说明文档
  • 歌词显示器开发注意项
  • 使用硬件数字增益控制通话下行音量(可视化)
  • 杰理小牛产测资料
  • ENC配置说明
  • 通话调试流程指引
  • ANC相关功能demo
  • 无线麦硬件资料汇总
  • 无线麦相关应用
  • 无线麦复杂功能补丁包汇总
  • 无线话筒形态SDK程序&开发经验&问题点分享
  • 双模式结合应用问题汇总
  • 无线麦距离优化案例
  • 无线麦系列中的双工形态(duplex)演变开发对讲机方案开发资料
  • 音箱入门到进阶指导文档(编写中)
  • 蓝牙耳机品控和生产技巧
  • 982过_欠压标志获取异常
  • 如何获取最新涂鸦SDK及库文件
  • 无线话筒K歌音响-调音标准流程
  • 无线话筒产测流程

各个模块关键资料汇总

📎 原始文档:https://www.kdocs.cn/l/ccaejPhOkZe9 2025.11.28音频线客户培训

IC及产品介绍

主流类型及发展方向

耳机

  • 翻译耳机 image
  • 心率+血氧+计步 image
    • +VPU(骨传导mic) image
  • 内置入耳检测 image
  • 虚拟环绕声算法 image

直播麦\无线麦

image

功能调试介绍

资料库入口:
深圳产品研发中心
可视化工具上的项目帮助文档
image

按键

流程

SDK\apps\earphone\mode\bt\bt_key_msg_table.c
SDK\apps\earphone\mode\bt\earphone.c
SDK\apps\earphone\mode\common\app_default_msg_handler.c

内置触摸

相关资料链接:
内置触摸
来自「深圳产品研发中心」
重点部分:

  • 硬件设计部分
  • 在线调试参数部分 新一代内置触摸算法调试方法
    image

LED灯

流程

led_config.c
led_ui_msg_handler.c

TWS

TWS
来自「深圳产品研发中心」
image

配对及回连

流程

SDK\apps\earphone\mode\bt\bt_tws.c

配对

image 配对码
imageimage

回连

imageimage

打印字符含义

image

mac地址、公共地址、tws local地址、tws remote地址

image

流程

SDK\apps\earphone\mode\bt\bt_tws.c
SDK\interface\utils\syscfg_id.h
image

主从切换

image

流程

简单来说,主从切换的顺序是:

  1. 判断主从切换电量是否符合要求(默认从机电量大于主机0.1v)
  2. 判断主从间的信号强度差值是否符合设定要求
  3. 无业务状态及未连接手机下不支持主从切换,会引入异常 imageimage

一拖二

一拖二
来自「深圳产品研发中心」
image

流程

SDK\apps\earphone\mode\bt\tws_dual_conn.c
SDK\apps\earphone\mode\bt\dual_a2dp_play.c
SDK\apps\earphone\mode\bt\dual_phone_call.c

回连及连接

image

字符说明

image

设备抢占

image

APP协议

自定义BLE服务特征进行RCSP OTA(可视化)
来自「深圳产品研发中心」
image

流程

SDK\apps\common\third_party_profile\jieli\rcsp\ble_rcsp_server.c
SDK\apps\common\third_party_profile\jieli\rcsp\adv\ble_rcsp_adv.c

自定义协议

  • 完全不需要RCSP任何流程的
  • SDK\apps\earphone\demo\trans_data_demo.c已经完全弃用,统一改为SDK\apps\common\third_party_profile\custom_protocol_demo\custom_protocol.c image

Debug Log

image

音频

翻译耳机、语音识别
来自「深圳产品研发中心」
imageimage

基本知识普及

一、采样率(Sampling Rate)

  1. 核心定义:单位时间内对连续模拟音频信号的采样次数,单位为赫兹(Hz)。它决定了音频的频率响应上限,遵循奈奎斯特采样定理:采样率必须≥2 倍音频最高频率,才能无失真还原信号。
    • 例:人耳可听频率约 20Hz-20kHz,因此 44.1kHz 采样率(CD 标准)即可完整覆盖;采样率越高,理论上高频细节越丰富。
  2. 蓝牙音频常见采样率
场景常见采样率说明
基础蓝牙音频(SBC)44.1kHz/48kHz蓝牙基础编码,多数设备兼容,48kHz 更适配视频同步
高清蓝牙(aptX HD/LDAC)48kHz/96kHz96kHz 采样率可还原超高频细节,适合无损音乐爱好者
无损蓝牙(LC3 无损)44.1kHz/48kHz/96kHz新一代编码,兼顾无损音质与低延迟

二、信噪比(Signal-to-Noise Ratio, SNR)

  1. 核心定义:音频信号强度与背景噪声强度的比值,单位为分贝(dB)。它直接决定音频的纯净度,数值越高,噪声越少、音质越干净。
    • 计算公式:SNR=10log10(PnoisePsignal),Psignal为信号功率,Pnoise为噪声功率。
  2. 蓝牙音频常见信噪比标准
    • 普通蓝牙耳机:≥90dB,日常听感无明显噪声;
    • 高清蓝牙耳机:≥100dB,适合安静环境下听轻音乐、人声;
    • 发烧级蓝牙音频设备:≥110dB,接近无损设备的纯净度。
  3. 蓝牙中的影响因素:编码压缩、蓝牙传输干扰、耳机放大器噪声、电池供电噪声都会影响信噪比。比如蓝牙传输时的频段干扰(2.4GHz 频段与 WiFi、微波炉重叠)会导致噪声增加,降低信噪比。

三、音频格式(编码格式,Bluetooth Audio Codec)

  1. 核心定义:蓝牙设备间传输音频时的数据压缩 / 解码协议,决定了音质、延迟、功耗和兼容性,是蓝牙音频的核心。
  2. 主流蓝牙音频格式对比
格式核心优势音质 / 码率兼容性
SBC(Subband Codec)通用兼容,低功耗有损,码率约 320kbps;音质一般所有蓝牙音频设备强制支持
AAC苹果生态适配,音质优于 SBC有损,码率约 256-320kbps;适合人声、流行乐苹果设备、安卓旗舰、多数流媒体平台支持
LDAC索尼专属,高码率最高 990kbps,支持 96kHz/24bit,高清无损音质索尼设备、部分安卓旗舰支持
LC3新一代标准,低延迟 + 无损,低功耗支持无损,码率灵活,延迟低于 SBC蓝牙 5.2 及以上设备,逐步成为主流

四、相位(Phase)

  1. 核心定义:描述周期性音频信号在某一时刻的位置,单位为度(°)或弧度(rad)。相位差(两信号的相位差值)会影响音频的声场定位、立体声分离度、声音叠加效果。
    • 例:两声道信号相位完全一致(0° 相位差),声音会居中;相位相反(180° 相位差),声音会抵消,出现 “中空” 感。
  2. 蓝牙音频中的关键影响
    • 立体声分离:蓝牙传输时若左右声道相位偏差过大,会导致声场变窄、定位模糊;
    • 降噪 / 通话:麦克风阵列的相位匹配决定降噪效果,相位偏差会导致降噪失效、回声增强;
    • 音频同步:视频与音频的相位同步(延迟),相位偏差会导致口型对不上。

五、幅度(Amplitude)

  1. 核心定义:音频信号的振动幅度,对应声音的响度(音量),单位为分贝(dB SPL,声压级)或伏特(V,电信号幅度)。幅度越大,声音越响。
    • 关键阈值:人耳听阈约 0dB SPL,痛阈约 120dB SPL;音频设备的最大幅度受硬件限制,超出会出现削波失真(声音破音)。
  2. 蓝牙音频中的关键限制
    • 音量控制:蓝牙设备通过调节电信号幅度控制音量,幅度过小会导致信噪比下降(噪声凸显);
    • 编码限制:蓝牙编码对幅度的动态范围有要求,动态范围过小会导致声音干瘪,过大则可能因压缩导致失真;
    • 硬件限制:耳机扬声器的最大幅度决定了最大音量,超出会损坏扬声器或出现破音。

音频配置

DAC

image

ANC

image 注意点:

  • ANC要求adc通道是差分输入
  • 默认的两个anc配置文件内容是空的,需要从anc在线调工具里面重新导出才能正常使用 image
ENC

cvp_v3三代ENC算法
imageimage 二代的双mic enc算法
image 消耗更多flash换取更少的RAM使用,性能相较一代无明显差异

音频流协商

示例

image

特殊字符说明

image

相关问题的debug方法

SDK\apps\earphone\log_config\lib_media_config.c
image 打开这些log可以看见参数信息及一些音频流协商信息,有助于分析相关音效问题

如何定位是不是跑不过来

image 会有CPU占用率打印,主要看CPU0和CPU1占用率
image

如何定位是不是音频杂音

可以加个正弦波转换节点进行测试
image

音频流位宽

image

  • 24bit所需的缓存是16bit的两倍
  • 24bit有助于优化量化噪声
  • 如果需要平衡RAM消耗和量化噪声可以评估用部分24bit,但是代码需要修改,具体改动方案根据具体项目和问题处理

翻译耳机

翻译耳机、语音识别
来自「深圳产品研发中心」

系统

死机调试方法

软件调试方法
来自「深圳产品研发中心」
image 5.1. 串口调试 — JL Project Documentation
image

示例

R_2025-11-24_14_13_56.log

image 原因:RAM不够导致申请失败断言
分析:

  1. 先看断言原因 image
  2. 看断言地址 image
  3. 找断言地址对应lst文件中的函数 image

W内存泄露调试方法

  1. 确认是否是内存泄露 定时器500ms调用mem_stats() API,看实际剩余的RAM有没有一直减少
    image
  2. 怎么定位哪些API导致的内存泄露 image 修改截图位置后,外部声明以下API
void exception_analyze_user_callback(int unsigned *sp)
{
    //debug 内存泄露
    mem_unfree_dump();
    return;
}
Prev
uCOS 开源协议版本信息
Next
软件调试方法