废弃--AC704N相关应用
文档简介
该文档主要描述 AC704N开发相关的使用说明和注意事项，收集并持续更新开发调试过程中的相关疑问和解答，对SDK介绍文档做一个补充说明，为用户进行二次开发提供参考。
704N-SDK项目帮助文档在杰理开发者平台(JL DP)'帮助'处进入，如本文档有与后续帮助文档或工具注释说明冲突，以后者为标准。
﻿
目录
文档简介
一、芯片和工程特性
二、芯片型号和SDK选用说明
1. AC704N
2.AC704N_FLASH
三、升级烧录说明
1. 一拖八烧录
2. 一拖二烧录
3. 强升工具烧录
4. 测试盒升级
四、软件开发说明
1 .帮助文档
2 各版本芯片和SDK开发简介
2.1 704N-A/B版
2.2 704N-C版OTP芯片
2.3 704N-C版Flash芯片
2.4 704N-D版
3.环境安装和SDK获取
4.SDK版本说明
5.编译
6.烧录下载和升级
7 通用加key方法
8.DEBUG开打印
9.更新到最新补丁的方法
9.1 合并打补丁方式
9.2 新建工程获取最新补丁方式
10.项目工具导出
11.情景卡片和配置项说明
11.1 情景配置（UI修改）
11.2 DCVDD档位
(空标题)
11.3 蓝牙保留配置项
11.4 保留配置项
11.5 触摸互斥配置项
11.6 性能模式和功率模式
五、常用功能使用说明
1.蓝牙名
2.按键
2.1按键配置 
2.2 IO按键
2.3 AD按键
2.4 触摸按键
2.5 触摸在线调试
2.6 按键提示音
2.7长按先播提示音，抬起触发功能
2.8按键清除蓝牙记录
(空标题)
3.灯效
3.1 标准场景灯效配置
3.2 自定义灯效修改
3.3 7048D红灯补充说明
3.4 交替闪灯效频率对齐其他系列
3.5 关机灯效蓝灯亮1.5s
4.提示音
4.1 提示音修改
5.TWS相关功能
5.1 配对方式选择
5.2 声道分配方式
5.3 交叉配对
5.4 断电回连手机
6.EQ和通话
6.1 EQ类型修改
6.2 EQ在线调试
6.3 项目工具导出
6.4 通话基本配置说明
6.5 关闭通话功能
6.6省电容MIC声音异常
6.7 通话在线调试
7.开关机相关补充
7.1按键开机和关机
7.2关机关触摸和nvram进一步降低关机功耗
8.电量和功耗相关补充
8.1耳机充满时出现复充问题处理
8.2耳机充满时出现复充问题处理2
8.3耳机充满时触摸会重新唤醒充电处理
8.4 耳机入仓无法唤醒仓充电
8.5关机关触摸和nvram进一步降低关机功耗
(空标题)
9.BLE广播功能
六、FAQ
1. 测试盒升级后拔出关机、播提示音
2. tws耳机7048Ev200_patch04 以及之前版本，进入蓝牙spp在线eq调试时异常死机
一、芯片和工程特性
704N系列有两种芯片，一种是纯OTP芯片，该芯片丝印最后一位为0，如7043A0、7048D0，通常我们称为A0芯片、D0芯片，都是指OTP芯片；另一种是带flash的芯片，该芯片丝印最后一位不为0，如7043A4、7048D2，通常我们称为A2芯片、D2芯片，都是指FLASH芯片；
OTP芯片相较于常规的芯片代码存储在 FLASH，SDK 代码的存储介质是 ROM 介质。因为代码已经固化到 ROM，不可编辑，只可通过配置 efuse 位来进行控制。适合程序固定不变的应用场合。
OTP芯片没有flash，断电后无法保存TWS配对信息，如需长时间仓储，要把自动配对打开，或者使用按键配对，避免因为长时间存放、电池没电导致TWS掉配对和不配对
FLASH芯片增加了一个外置 flash，依托于 ROM 内代码资源可以被 FLASH 代码调用的特性，可以组成断点工程【ROM+FLASH】。则相对比与需要配置工具进行配置的 ROM 工程，增加更多的可修改性，可反复擦写，灵活性很强，适合做开发用途。
注意：并非所有的功能都可以通过断点方式增加，能插断点的前提条件是能找到要插断点位置的地址，其次，断点的数量是有限的 ，过于复杂的功能无法通过断点方式实现。
二、芯片型号和SDK选用说明
版本型号：
目前704N芯片存在两种类型，纯OTP芯片和带flash芯片，并存在多个芯片版本：
AC704N：A版、B版、C版、D版
对应的SDK也存在多个版本。
对应关系：
不同版本芯片对应SDK不一样。
目前已发布SDK（含内测版本）有两种，与芯片对应关系如下：
1.AC704N
该SDK主要通过可视化工具-杰理开发者平台(JL-DP)配置功能，无代码，既可以用于OTP芯片，又可以用于flash芯片
﻿﻿
AC704N_TWS_sdk_release_1.0.0 - 对应使用A版本芯片、B版本芯片
AC704N_TWS_sdk_release_2.0.0 - 对应使用C版本芯片
AC704N_TWS_sdk_release_3.0.0 - 对应使用D版本芯片
2.AC704N_FLASH
该SDK既可以通过可视化工具-杰理开发者平台(JL-DP)配置功能，同时也开放了部分代码，可操作空间更自由；但需要依赖flash运行，必须使用带flash的芯片
﻿﻿
﻿
（持续更新）
芯片版本与SDK对应关系，后续会更新到可视化工具中提醒，及对应帮助文档详细说明。
D0芯片没有flash，断电后无法保存TWS配对信息，如需长时间仓储，要把自动配对打开，或者使用按键配对，避免因为长时间存放、电池没电导致TWS掉配对和不配对
型号示例：
例：AC7048D0_C芯片
SDK必须使用 版本2.x.x系列
﻿﻿
包装示意图：
﻿﻿
丝印示意图：
﻿﻿
﻿
C版芯片和D版芯片的区别是：D版芯片添加tws捂耳距离优化和增加了A版收集的客户需求UI，做到和A版的tws捂耳距离一样。因此C版的tws捂耳距离相对A，B和D版是较弱的。
❗  注意：各芯片版本的配置不共通，不能够copy的形式来同步
三、升级烧录说明
1.一拖八烧录
﻿﻿
1：空片烧写支持一拖二、一拖八，预留点上图。
2：测试盒只支持升级，不支持空片
3：强升工具不支持USB升级，可以串口vpwr升级，参考强升工具文档，类似于AC98
双脚起振方案：
﻿﻿
单脚起振方案：
📌
注意：空片必须用双线烧写
﻿﻿
📌注意：测试盒升级只支持有线串口升级
﻿﻿
﻿
﻿
2.一拖二烧录
一拖二烧录工具版本更新到最新，正常使用即可；
3.强升工具烧录
强升工具仅可用于带flash芯片烧录
使用强升工具升级时，请确保接线无误，虚拟串口在线！接线如下：
﻿﻿
﻿﻿
4.测试盒升级
测试盒升级只支持有线串口升级
四、软件开发说明
1 .帮助文档
📢可视化工具项目帮助文档，开发前必读！！！
704项目帮助文档入口
﻿﻿
﻿﻿
2 各版本芯片和SDK开发简介
2.1 704N-A/B版
704-A/B版使用可视化工具配置，没有代码
﻿﻿
2.2 704N-C版OTP芯片
704-C版 OTP调试说明
开发应使用v2.0.0版本的SDK
﻿﻿
先用download_flash+带flash的C版芯片来调；确认功能通过后，再使用download_efuse+C版OTP芯片确认和生产
﻿﻿
2.3 704N-C版Flash芯片
最新：
开发应使用AC704N_FLASH的程序，这是一个带代码的SDK版本
也可以烧录v2.0.0的SDK的download_flash文件
﻿﻿
（以上边最新消息为准，704芯片选择AC704N_FLASH既原来说的v3.0.0版本SDK）
开发应使用v3.0.0版本SDK，这是一个带代码的SDK版本
﻿﻿
也可以烧录v2.0.0的SDK的download_flash文件
2.4 704N-D版
要使用v3.0.0版本的SDK，和C版的v2.0.0 SDK一样，分为OTP和flash版本
﻿﻿
先用download_flash+带flash的D版芯片来调试；确认功能通过后，再使用download_efuse+D版OTP芯片确认和生产
﻿﻿
3.环境安装和SDK获取
704N软件需要可视化配置工具，即杰理开发者平台（JLDP）
﻿﻿
可视化工具更新到最新版本
﻿﻿
项目-新建项目，SDK选择TWS耳机，如果没有704N找助理申请权限
﻿﻿
首次打开要下载程序，否则可能会打不开别人发过来的工程，创建工程之前检测SDK版本更新到最新
﻿﻿
4.SDK版本说明
﻿1.0.0是不会开放代码的断点rom版本的a版芯片版本。这个版本必须带一个flash才能够跑起来。
﻿2.0.0是c版rom版本。关于带flash的C版芯片，如果flash没有完整的程序，则跑rom的程序。
﻿2.0.0flash是c版的flashsdk版本，
已发布，杰理开发者平台芯片选择AC704N_FLASH
﻿﻿
﻿3.0.0是d版芯片SDK。
❗注意：各芯片版本的配置不共通，不能够copy的形式来同步
5.编译
工具编译
﻿﻿
没有识别到芯片，这个报错是正常的，重点看.fw文件有更新即可
﻿﻿
加KEY还是跟其他系列一样加在download里，详见通用加key方法章节，带debug是有开打印的，调试用
﻿﻿
6.烧录下载和升级
📌
建议预留烧录点都留，用双线串口烧写
﻿﻿
1：空片烧写支持一拖二、一拖八，预留点上图。
2：测试盒只支持升级，不支持空片
3：强升工具不支持USB升级，可以串口vpwr升级，参考强升工具文档，类似于AC98
双脚起振方案：
﻿﻿
单脚起振方案：
📌
注意：空片必须用双线烧写
﻿﻿
📌注意：测试盒升级只支持有线串口升级
﻿﻿
﻿
﻿﻿
👋补充：使用强升工具升级时，请确保接线无误，虚拟串口在线！
7 通用加key方法
1.准备好key文件，放在download.bat文件同一级目录下，704N在\SDK\download_flash_A目录里
其他系列download.bat文件路径不同，但也可按同样方法添加key文件﻿
﻿﻿
﻿
1.对download.bat文件右键编辑，打开download.bat文件
﻿﻿
﻿
1.在isd_download.exe段的最后边添加-key加空格加key文件名保存即可，如下图
﻿﻿
8.DEBUG开打印
704N PA2输出，波特率默认2M
705N PA1输出，波特率默认2M
﻿﻿
9.更新到最新补丁的方法
9.1 合并打补丁方式
打开工具主页，找到项目工程，单击版本号
﻿﻿
点击”检测更新”，找到最新补丁，点下载
﻿﻿
下载完成后点击自动合并
﻿﻿
合并后要确认版本是否正确
﻿﻿
9.2 新建工程获取最新补丁方式
点击新建项目
﻿﻿
﻿﻿
﻿﻿
﻿﻿
﻿﻿
﻿﻿
﻿
10.项目工具导出
﻿﻿
导出包自带离线版工具，无需安装可视化工具也可以修改配置和调试
﻿﻿
﻿﻿
﻿
11.情景卡片和配置项说明
11.1 情景配置（UI修改）
默认情景配置是封进rom的。只能开关，无法修改，也无法新增，直接点会报文件不存在
需要自定义的话可以新建情景配置分组文件
﻿﻿
﻿﻿
﻿
﻿﻿
﻿﻿
﻿﻿
注意：由于内存大小新建的卡片数量有上限，由卡片内设条件多少决定；正常配置约20张；
情景配置自定义修改方法：
﻿﻿
﻿﻿
﻿﻿
﻿﻿
11.2 DCVDD档位
功耗高可以降到1.35V，希望蓝牙距离好可以提高到1.5V
﻿﻿
﻿
11.3 蓝牙保留配置项
保持默认即可，内部的配置项，用于排查分析
﻿﻿
11.4 保留配置项
📌
注意：保留配置项为带flash版本芯片扩展的特殊功能，非标准SDK的功能范围；为方便过渡到纯rom芯片版本，非必要不建议启用。
﻿﻿
﻿﻿
﻿﻿
﻿
﻿﻿
﻿﻿
- 添加提示音播放结束后再开启灯效
﻿﻿
﻿﻿
﻿﻿
﻿﻿
﻿﻿
﻿
﻿﻿
﻿﻿
﻿﻿
﻿﻿
﻿﻿
﻿﻿
﻿
11.5 触摸互斥配置项
蓝牙天线跟触摸可能会存在互相干扰，影响触摸效果，底层预留的配置，一般情况不使用；后续版本更新会添加使用说明。
﻿﻿
11.6 性能模式和功率模式
低功耗就是更低功耗的意思，代价是抗干扰能力变差，使用时建议严谨测试性能是否ok
功率模式通常用于ows方案，开了大功率，能推更大声的喇叭，但功耗也会上来
﻿﻿
﻿
五、常用功能使用说明
1.蓝牙名
带flash芯片放flash的，没有次数限制，可以多次修改；
OTP芯片资源有限，16byte，可改写次数由实际使用蓝牙名长度决定；
﻿﻿
2.按键
2.1按键配置 
﻿﻿
2.2 IO按键
固定使用PA6低电平检测
﻿﻿
2.3 AD按键
﻿﻿
2.4 触摸按键
﻿﻿
注意按键类型改成触摸按键后，还需要配置触摸按键通道（引脚）
﻿﻿
触摸互斥配置项
保持默认配置即可，用户无需关注这部分功能；
蓝牙天线跟触摸可能会存在互相干扰，影响触摸效果，底层预留的配置，一般情况不使用；后续版本更新会添加使用说明。
﻿﻿
﻿
2.5 触摸在线调试
1.下载在线调试版本
﻿﻿
1.PC连接蓝牙，查看更多蓝牙选项，查看SPP连接COM端口
﻿﻿
1.杰理开发者平台(可视化工具)连接在线调试
﻿﻿
﻿﻿
1.打开触摸在线调试
﻿﻿
后续调试操作同其他系列芯片在线调试步骤一样，详情请参考触摸调试帮助文档
﻿﻿
﻿
﻿
2.6 按键提示音
﻿﻿
2.7长按先播提示音，抬起触发功能
该功能使用到保留配置项9，需要更新到path02.01版本以上
﻿﻿
﻿﻿
﻿﻿
对于通话长按挂断容易误触发siri
参考方案1：通过定时器做标志位
﻿﻿
参考方案2：
把拒接做成长按1s挂断，通过配置9过滤掉抬起，过滤siri唤醒功能
非通话下唤醒siri继续使用长按和抬起，通过配置23设置不过滤
﻿﻿
﻿﻿
﻿﻿
﻿﻿
2.8按键清除蓝牙记录
﻿﻿
﻿
3.灯效
3.1 标准场景灯效配置
标准场景卡片只能开关，不能修改
﻿﻿
3.2 自定义灯效修改
默认情景配置是封进rom的。只能开关，无法修改，也无法新增，直接点会报文件不存在
﻿﻿
﻿﻿
需要自定义的话可以新建情景配置分组文件
﻿﻿
﻿﻿
﻿﻿
注意：由于内存大小新建的卡片数量有上限，由卡片内设条件多少决定；正常配置约20张；
3.3 7048D红灯补充说明
需要用到保留配置项，目前只有带flash的芯片可以支持
需要关掉复用兼容（注意：关掉后可能会导致引入杂音）
﻿﻿
﻿﻿
﻿
3.4 交替闪灯效频率对齐其他系列
704N系列默认交替闪灯效与其他系列频率不一致，表现为红蓝灯交替之间会有一段灯全灭的时间。该现象属于正常现象。
﻿﻿
﻿﻿
3.5 关机灯效蓝灯亮1.5s
﻿﻿
﻿﻿
﻿
﻿
﻿
4.提示音
4.1 提示音修改
只有带flash的芯片支持修改
﻿
最新版本已经默认支持修改，若无法修改按如下方法处理：
1.解除工具提示音修改限制
﻿﻿
在JL DP(可视化工具)下载目录下，找到需要修改提示音的SDK版本下的config.list文件
把sdkType项的efuseOtp改成normal并保存
﻿﻿
❗
注意：
该OTP限制开关仅用于提示音修改和导出，导出完毕后请及时关闭；
修改和导出其他配置时，请务必检查该限制开关已恢复关闭状态！
1.修改提示音
回到可视化工具配置界面F5刷新或重启可视化工具，到提示音界面添加自定义提示音
❗
注意：不能更改原来的文件命名，例如TWS连接的提示音，必须命名为f.sin 或者f.wts
﻿﻿
1.导出提示音文件
提示音修改完成了，点击右上方的导出
﻿﻿
导出成功后，到对应项目的output文件夹下，找到对应的导出提示音文件，并复制到下载目录替换原提示音文件；
﻿﻿
﻿﻿
1.恢复工具提示音修改限制
参考第一点
在JL DP(可视化工具)下载目录下，把刚才修改的config.list文件
把sdkType项改回efuseOtp并保存。
﻿﻿
🙃
704N系列若无flash，提示音和702系列一样不支持修改，可视化工具配置只能用于试听
﻿﻿
﻿﻿
﻿
5.TWS相关功能
5.1 配对方式选择
5.2 声道分配方式
硬件区分左右没特殊要求默认都是用PA3带下拉电阻区分，旧版原理图标记有误使用PA5，应使用PA3
对于带flash 的芯片，可以通过保留配置项10修改
﻿﻿
﻿
5.3 交叉配对
需要开启TWS连接超时自动配对新耳机
﻿﻿
若耳机无TWS配对记录，开机直接进入交叉配对
若耳机已经有TWS配对记录，开机先根据对耳地址回连一段时间，再开启交叉配对
﻿﻿
5.4 断电回连手机
该功能仅带flash的芯片可实现，OTP芯片回连地址只能存储再ram中，断点会丢失；
﻿﻿
﻿
6.EQ和通话
6.1 EQ类型修改
蓝牙音乐EQ类型不可修改，序号1和序号2已经在EQ曲线首尾固定好类型，需要使用点序号使能使用即可
﻿﻿
﻿
6.2 EQ在线调试
704N只支持spp串口调试，不支持物理有线串口
1.可视化工具更新到最新，704SDK更新到patch_01.07以上
2.通过download_debug.bat直接下载到样机
﻿﻿
1.可视化工具连接蓝牙串口
﻿﻿
﻿﻿
1.在EQ节点进入在线调试
﻿﻿
﻿﻿
补充：
由于兼容性问题部分电脑在线调试过程中存在连不上、断连情况；建议多换几台电脑尝试；该问题后面版本优化。
6.3 项目工具导出
﻿﻿
导出包自带离线版工具，无需安装可视化工具也可以修改配置和调试
﻿﻿
﻿﻿
6.4 通话基本配置说明
数据流节点不支持修改，没办法像其他系列那样随意挪动数据流节点；
目前只支持ANS，数据流上的DNS节点ANS共用，ANS参数也是改这里 
C版ANS和DNS都支持，D版只支持DNS
﻿﻿
﻿﻿
﻿﻿
﻿﻿
6.5 关闭通话功能
（1）v1.0.0版本SDK：
SDK更新到最新，可直接通过HFP开关配置
﻿﻿
也可通过卡片逻辑方法实现：
﻿﻿
（2）v2.0.0版本OTP-SDK：
通过卡片逻辑在底层把esco链路断开的方式来实现
﻿﻿
❗
注意：OTP版本关闭通话功能不可以通过关闭HFP开关实现
（3）v2.0.0版本FLASH-SDK：
﻿﻿
7
#include "syscfg_id.h"   

if (get_cfg_hfp_enable() == 0)
    {
        __this->spp_profile_support          = 1; //hfp关闭，则spp需要打开，保持有一个服务在线，否则会出现连接慢，播歌慢的情况。
    }
﻿﻿
﻿﻿
6.6省电容MIC声音异常
mic trim异常时，可能会出现无声/声音小/电音/失真问题
1.芯片高温时上电 trim MIC异常
公版默认只在上电时trim麦一次，可以将trim配置改为每次开机都trim规避该问题
﻿﻿
1.前级增益设置过大 trim MIC异常
当前级增益甚至过大时，动态范围小，trim不到合理的偏置电压，比较容易小声/失真问题
处理方法：
1.将MIC_BIAS电阻 修改为0.5k， 从小开始收敛校准。
2.降低MIC增益（数字）, 在通话算法节点的前级增益弥补回来
﻿﻿
﻿﻿
6.7 通话在线调试
❗
注意：暂不支持DNS在线调试
1.软件打开一拖二
﻿﻿
2.烧录带在线调试的debug程序
﻿﻿
3.一拖二连接PC和手机，PC端在更多蓝牙配置中查看端口
﻿﻿
4.到可视化工具连接对应端口蓝牙SPP
﻿﻿
5.连接成功后，点数据流节点更改通话参数，即可同步到耳机上
﻿﻿
﻿
﻿
7.开关机相关补充
7.1按键开机和关机
﻿﻿
﻿﻿
7.2关机关触摸和nvram进一步降低关机功耗
﻿﻿
﻿﻿
﻿
【金山文档 | WPS云文档】 704A版1.0.0(patch03.17)关机关nvram补丁
﻿https://kdocs.cn/l/cbyhWyOD8ZLP﻿
﻿
8.电量和功耗相关补充
8.1耳机充满时出现复充问题处理
针对掉维持电压较晚的仓，可能会存在耳机满电先一步空闲关机，关机后仓掉电压唤醒耳机，耳机开机再次唤醒仓，进而开始新一轮充电流程（复充问题）
AC704N：
关闭 “充电系统空闲时关机”
如图所示：
﻿﻿
8.2耳机充满时出现复充问题处理2
针对仓检测负载的变化敏感导致识别到耳机出入仓了，又起5V充电。
﻿﻿
8.3耳机充满时触摸会重新唤醒充电处理
升级到patch02.14以上
﻿﻿
8.4 耳机入仓无法唤醒仓充电
需要与明确唤醒仓的条件，再判断耳机端是否能满足
部分的仓需要检测较高的电流才能判定耳机入仓，进而唤醒5V充电，在耳机充电电流过低时或耳机满电入仓马上关充电的情况下，往往无法唤醒这类型的仓。
对于这类仓的问题，其他系列芯片可以通过入仓加放电增加功耗来处理，但704N区别于其它芯片，目前不支持类似功能,所以无法适配这类型充电仓。
8.5关机关触摸和nvram进一步降低关机功耗
﻿﻿
﻿﻿
﻿
【金山文档 | WPS云文档】 704A版1.0.0(patch03.17)关机关nvram补丁
﻿https://kdocs.cn/l/cbyhWyOD8ZLP﻿
﻿
9.BLE广播功能
需要使用2.0.0flash版本SDK
﻿﻿
﻿﻿
﻿
六、FAQ
1.测试盒升级后拔出关机、播提示音
﻿﻿
2.tws耳机7048Ev200_patch04 以及之前版本，进入蓝牙spp在线eq调试时异常死机
【金山文档 | WPS云文档】 tws耳机_704v200_patch04蓝牙spp在线eq调试补丁.rar
﻿https://kdocs.cn/l/choTEUgZhc4B﻿
或更新到最新patch0401版本
﻿﻿
﻿
3.VPWR供电开机功能
﻿﻿
﻿﻿
﻿
﻿