AW33开发指导文档

📎 原始文档：https://www.kdocs.cn/l/chRjVb6qHxm5 AW33开发指导文档

📌重要链接

📌发布资料

📌补丁

补丁等级说明
A 类：问题修复，客户必须修复
B 类：性能优化，客户可选择修复
C 类：功能增加，客户可选择

📌demo程序

demo程序使用方式：demo程序使用方式

1. 开发工具及环境
2. IDE编译器安装 下载链接：https://doc.zh-jieli.com/Tools/zh-cn/other_info/index.html
   至少需要安装这3个。
   相关链接：
   IOT-AC630N: AC630N系列问题、demo、工具等整理汇总
   AC630N系列问题、demo、工具等整理汇总
   先安装 codeblock 编辑器、再安装 工具链、最后安装包管理器。
3. 开发板 淘宝店购买链接：还没上架
   https://item.taobao.com/item.htm?id=817701311470&spm=a21xtw.29178619.0.0&pisk=gGd-AZ_nqmmup7ORoUk0KOW2SvuD9xYPM38_tMjudnKvR3slxg6CGZ_GWaa7Ne_C9ntnzgYI4Hddc_6eEMjlv6LeXqmisfYyz65SjccgKVA11__5AgNIRi_FWqb7OUwgj65Ijc20OTlOT3gRL-27hZsVJwN5FH6jGwSfPaNBAi6f5Nq5OHtCcr_1R8wQOg_jGi75PuN5Ossf-wFQV6tBlqQ1cM1CFHTjNxodczs39dlVXn8oZZVQOIQRhxY5cPfJGaIAXUO8_5JFyTI6PinSw6tVheWpTyPdpU9wYNt7VDIeMEOWChi0Eg9OJFvpPbNfZQ8WC9OsYJTPZgCXNdUQOECRqHddBunAfQ8X_s6m1VLXg3YyMe4IOZxGcUR59fgNw_s5MZRn07sphpOlU6rSvMRvlQ9d4LOM6RxbjGQ3Fq3YLJW5ucnG8LkcP_uAkG0-9JyF3q7Ajq78LJWXTZIioM2ULtXf.
   
4. 下载工具（强制升级工具V4.1） 淘宝店铺购买链接：
   https://item.taobao.com/item.htm?id=620295020803&spm=a21xtw.29178619.0.0&pisk=g2hEba02wBdFFZrLKfNP3EjzPANLO7-X8bZ7r40uRkq3Abirrz47-_43-5Agol1WJW98a0rZ2kwQtbkOaq3-OeFWJW3Lw7xXcIGrJ2F-RIpiTXyMsz0GZyVkC5bgfts9cIOjJp4LNVxjNpoT5yafZ723ElVgXz_3q023IlqTyzj3r6Yw7lURqMVu-Obgrrb3Zz2oSR4Quu4uZ_0gjlUuZ_muZFPgXzcRV20l_rwHPeaylMjPXRqm-l5lgZUUKXdYX_bEsyuaX20RZ_ca8JliL0vXeJMok-hIzQ5TOqkgszlJoTrz3YcQsXxMiReosc4iAU687YuoMWedy_n4T0ymtR7lwWVu45ziiU6YffrIqXyMlsy7sjw0tA99A8NUu0cKYa5omVgj9Rhy0Gq-drFgzbLcUuyl4YS8SyxZwvSlUJ4T7oTw72HJhxFlzhZGeTegMPrXRy6ReJTU7oTFgTB8p3Uaceph.
   外壳可以拆开，里面有拨开开关
   使用说明：https://doc.zh-jieli.com/Tools/zh-cn/dev_tools/forced_upgrade/index.html
   

• AW31下载说明：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/I9JB33
• 无法下载时检查方式：https://gitee.com/Jieli-Tech/fw-AC63_BT_SDK/issues/IAHLFF
• 调试打印：https://gitee.com/jieli-tech_fae/IOT-AC630N/blob/master/doc/software/%E5%85%A5%E9%97%A8/%E4%B8%8B%E8%BD%BD%E8%B0%83%E8%AF%95%E8%AF%B4%E6%98%8E.md

4. 打印工具 自己网上购买 CH340的USB转串口工具，不要使用下载工具去当串口工具使用。
   https://item.taobao.com/item.htm?ut_sk=1.ZcWApDDHvFMDAGRCA8Q2Jk5J_21380790_1747719929576.Copy.1&id=522571378803&sourceType=item&price=4.8&suid=0B769916-5BB8-4A47-8776-7358C99E161F&shareUniqueId=31666222863&un=2d22a0165b9e67c9bbeeeafdb2768e28&share_crt_v=1&un_site=0&spm=a2159r.13376460.0.0&wxsign=tbwBfLXARYXDDGWri0MwQU8yeR1tE9MI7KaRjNG32wjoGDB8Lm1-8zHmkeL4Ii3YO_faIytrDO4sRR6xYpfAq2R53zPRYs28DhVFMRw9vaW2ldOIPdhhtpZ39AfvTYhdEFt&tbSocialPopKey=shareItem&sp_tk=QndWOFZRUWFoclc%3D&cpp=1&shareurl=true&short_name=h.6tP4jV1mrYJEsh7&bxsign=scdcIkCo5ZEjofIJBwHAYKDLqOYVn04NO3F-Y2FDos7lwucM4iQcabmEE_24MScefxzUFlo4rYtcZhiwt3LTl9BAx2Xy1wNfLdxdUna9wOvETZlje2xDFZyWcNSAPTj-PRp&tk=BwV8VQQahrW&app=chrome
   
5. 烧录工具 量产烧录器有2种：一拖二烧录器、一拖八烧录器，均没有开源淘宝店购买链接，只能联系杰理代理商购买。
6. 一拖二烧录器 一拖二烧录器使用说明：https://doc.zh-jieli.com/Tools/zh-cn/mass_prod_tools/burner_1tuo2/index.html
   烧录报错：https://doc.zh-jieli.com/Tools/zh-cn/mass_prod_tools/burner_1tuo2/status_errors.html#id12
7. 一拖八烧录器 一拖八烧录器使用说明：https://doc.zh-jieli.com/Tools/zh-cn/mass_prod_tools/burner_1tuo8/index.html
   烧录报错：https://doc.zh-jieli.com/Tools/zh-cn/mass_prod_tools/burner_1tuo8/status_errors.html#targe-1tuo8-ldc-show-err
8. 烧录座子 烧录座子没有开源淘宝购买链接，只能联系杰理代理商购买。
   每个型号都是独立的座子，不能混用。
   
9. 测试工具
10. 杰理测试盒 淘宝购买链接：
    https://item.taobao.com/item.htm?id=620942507511&spm=a21xtw.29178619.0.0&pisk=g1_rbf1aJzUyIZvJqZTEb5v3xLTJyey_aw9Bt6fHNLvkFw6FtBABZ2AkZE4DsKgQwUZp89JVpLtWrwSx81CdP7LQwUCJJe2_CP_Fw_Lp_bExualciCfmq0Y3cEcDhcMYCPa1wuAJRs21RuufNQOs-exkxKYDHBGkK9xlimvv9BDkt4V4gKdEEpAkKEfDwCuH-BxhirA9O0vnrQYDoKdH-pXH-S8DHBc7F_fnuCtuO7tzRkkB_3JGZKuNMZRk70Cy3DnCui-yIO9q-2b2a68w__3aAdj9Fh9Gnrgy8sAF3hszQ4WFt1IH0wkuNOXcY9AADJoeQMf5XZtjt0fV8L-GrnlL11Yet9xFDRu6aUs2baS89xflCLSMy6GaFs-N0hdDmXokPG11JhbuzApXXBW2fgyZzOjyZvdDZ-7d4vmeqId2CSPVwME1XecUhKmKvnY9gdNWNDnpV_O2C7uZvDK-LIJ_wuf..
    一拖二杰理测试盒使用说明：https://doc.zh-jieli.com/Tools/zh-cn/mass_prod_tools/testbox_1tuo2/index.html
    校正频偏用法说明：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IAG6JT
    OTA升级用法说明：https://gitee.com/Jieli-Tech/fw-AC63_BT_SDK/issues/I7FRNK
    测试按键用法说明：https://gitee.com/Jieli-Tech/fw-AC63_BT_SDK/issues/I7T4RC
11. 芯片封装型号 已知型号，信息可能不全，具体需要跟商务确认，是否还在正常出货中

注意：AW332A和AW338A，会比 AW333A和AW336A功耗大一点。
8. 典型功耗数据 不同封装型号，不同硬件设计板子，不同环境，不同手机，测试条件下，会有微小差异。

9. 芯片型号测试板 很多型号没有，一般用烧录座子测试。
   有的也不外卖，很多代理商会自行设计，建议联系代理商购买，或者自行设计。
10. 相关工具
11. ckey文件--芯片加密 ckey文件和烧录器绑定，用于芯片代码加密。ckey文件和烧录器，都只能跟杰理代理商获取。

• 开发板，和未经烧录器烧录的芯片，都处于未加密的状态，下载的代码是不加密的。下载的代码不能加-key。
• 强制升级工具，下载程序，是无法对芯片进行加密的，只能校验芯片是否加密了。
• 一旦芯片用一拖二或一拖八烧录器，烧录后，芯片就加密了。下载代码就需要添加对应的-key。
• 芯片只能加密一个key，加密后是无法修改成其他的key。
• 不同代理商的key文件，都是不一样的，无法混用和修改的。
• 已加密的芯片，是无法获取加密哪个key的。
• 外发的烧录文件，必须加-key编译生成的，烧录器才能识别。

2. 固件授权工具 没有开放下载，一般是找杰理代理商获取。
   可以限制外发的fw烧录固件，烧录次数，避免客户可以无限制烧录。
   

3. 固件升级工具

4. 校验码查看工具

5. demo程序使用方式 将修改点，移植到自己的程序上即可。

6. 硬件设计

7. 电源

8. VPWR和IOVDD VPWR和IOVDD，千万不能短接。
   锂电池、USB 5V、3节干电池 等，接入VPWR引脚。
   2节干电池、LDO 3.3V等，接入IOVDD引脚供电，VPWR悬空。

9. 纽扣电池 纽扣电池产品必须选择AW33系列，不要选择AC632和AW31。
   AC632和AW31系列蓝牙峰值电流超过20mA，无法彻底耗尽纽扣电池电量。
   常见纽扣电池型号规格参数：

4. 生产相关
5. 生产--烧录--测试指引 相关链接：
   fw-AC63_BT_SDK: Firmware for Generic Bluetooth SDK（AC63 series）, Support AC631N/AC635N/AC636N/AC637N/AC632N, compatible with AC69 series without audio support.
   Firmware for Generic Bluetooth SDK（AC63 series）, Support AC631N/AC635N/AC636N/AC637N/AC632N, compatible with AC69 series without audio support.
6. 烧录器 详细介绍：烧录工具
7. 一拖二烧录配置
8. 一拖八烧录配置
9. 产测工具
10. 测试盒 详细介绍：测试工具
11. SDK介绍
12. 芯片资源介绍
13. ram 芯片总RAM大小为56K，细分为：

• 拥有52K字节RAM
• 拥有4K字节ICACHE缓存空间 SDK各种常用功能配置下，剩余ram资源大小：
  AW33N_sdk_release_v1.1.0各种基础功能应用：

2. flash 目前有2种flash容量可选：2Mbits（256KByte）和4Mbits（512KByte）和8Mbits（1MByte）
   具体型号查看：芯片封装型号
3. 芯片对比及芯片选型 芯片对比及芯片选型：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IBPOXO

2. AW33N_transfer--透传工程 codeblock工程文件：sdk\apps\demo\transfer\board\bd57\AW33N_transfer.cbp
   手机设置蓝牙界面，是无法连接的，需要使用APP来连接。
   推荐使用安卓手机，安装 nRF Connect
   nRF Connect安卓app.zip
   【大熊智能nrf connect使用方法_nrfconnect教程-CSDN博客
   文章浏览阅读1.3w次，点赞11次，收藏32次。本文介绍了如何使用nRF Connect应用程序进行低功耗蓝牙设备的扫描和过滤。通过扫描功能，可以发现并列出所有广播状态的设备，而过滤功能则允许根据设备名、MAC地址、广播数据类型和RSSI进行筛选。此外，还详细说明了如何连接设备、执行写操作和监听操作。

苹果手机，无法看到mac，无法看原始的hex数据，不好调试。

1. CONFIG_APP_LE_TRANS 只做单模BLE从机，支持低功耗、OTA
   一般用于产品类型：

• 纯BLE广播：广播遥控器、beacon等
• 和APP连接：带APP控制的各类产品、灯带、按摩器、打印机等
• 被其他client主机连接的从机设备：相机遥控器、云台等
• 和MCU通信的产品：各类已有产品，需要外挂一个BLE芯片做通信

2. CONFIG_APP_MULTI 由于ram不够，只支持2路BLE连接，例如：主从一体，双server、双client，且无法支持低功耗和OTA
   #define TCFG_LOWPOWER_LOWPOWER_SEL LOWPOWER_CLOSE // 关闭低功耗
   #define CONFIG_APP_OTA_EN 0 // 关闭OTA

• 主从一体：支持手机APP连接的同时，还能扫描周围的广播包 #define CONFIG_BT_GATT_CLIENT_NUM 1
  #define CONFIG_BT_GATT_SERVER_NUM 1
  常用产品：带遥控器的灯带、按摩器、风扇、玩具等、带钥匙的电动车面板等
• 双server从机：支持2个手机同时连接 #define CONFIG_BT_GATT_CLIENT_NUM 0
  #define CONFIG_BT_GATT_SERVER_NUM 2
  常用产品：电动车BLE模块、门锁BLE模块等
• 双client主机：能连接2个BLE从机设备 #define CONFIG_BT_GATT_CLIENT_NUM 2
  #define CONFIG_BT_GATT_SERVER_NUM 0
  常用产品：耳机充电仓、控制面板、带开关和遥控器的灯带、风扇等

3. CONFIG_APP_NONCONN_24G

• 2.4G的广播方式，单向传输，单次发包最大可以60个字节。
• #define CONFIG_TX_MODE_ENABLE 1 //发射器
• #define CONFIG_RX_MODE_ENABLE 0 //接收器 2个只能开一个，不能同时开。
  发射器可以做低功耗和关机，但接收器不能做低功耗和关机，需要一直常待机。

4. CONFIG_APP_DONGLE usb dongle 加 BLE client主机功能，可以连接遥控器、鼠标、键盘、手柄、翻页笔等设备。
   将蓝牙HID数据，转成USB HID数据上传给电脑。
   将蓝牙语音数据，转成USB UAC的PCM数据上传给电脑。
   受限于ram资源，使用范围：

• USB语音dongle，只能开1个client，只能连接一个server设备。
• USB键鼠dongle，勉强能开2个client，可以同时连接一个鼠标和一个键盘，但不能带OTA功能。

5. CONFIG_APP_AT_CHAR_COM 串口模块，杰理AT指令协议。
   fw-AW31N_BLE_SDK: Firmware for Generic Bluetooth Low Energy SDK（AW3N series）, Support AW31N.
   Firmware for Generic Bluetooth Low Energy SDK（AW3N series）, Support AW31N.
   如果是替换其他方案的串口AT模块，需要自己修改AT协议，一般和其他方案是不一样的。

6. CONFIG_APP_IDLE 空闲模式适用于：MCU应用、充电状态下、假关机状态下。

7. AW33N_hid--HID工程 codeblock工程文件：sdk\apps\demo\hid\board\bd57\AW33N_hid.cbp
   手机设置蓝牙界面上，直接搜索连接的，也同时兼容APP连接，带配对绑定和加密功能。

8. CONFIG_APP_KEYBOARD 音乐遥控器，带有音量加减、上下曲、播放暂停等功能。

9. CONFIG_APP_KEYFOB 自拍器，默认只有发大小键2种键值。
   

10. CONFIG_APP_MOUSE_SINGLE 单模鼠标，BLE server设备，可以被手机电脑蓝牙直连，或者被usb dongle BLE连接。
    可以在此基础上，添加USB模式，直连电脑做usb有线鼠标。

11. CONFIG_APP_MOUSE_DUAL 三模鼠标，BLE模式、2.4G高回报率模式、USB模式，需要手动切换，不支持同时共存。
    #define SWITCH_MODE_BLE_ENABLE (1 & TCFG_USER_BLE_ENABLE) //使能BLE模式
    #define SWITCH_MODE_24G_ENABLE (1 & (CFG_RF_24G_CODE_ID != 0) & TCFG_USER_BLE_ENABLE) //使能2.4G模式
    #define SWITCH_MODE_USB_ENABLE TCFG_OTG_USB_DEV_EN
    3种模式可以自由组合成双模双模。

12. CONFIG_APP_KEYPAGE 翻页器、抖音神器，存在一定的兼容性问题，因为苹果系统限制，苹果系统更新，导致这个应用也一直在实时更新。
    最新版本，可以联系杰理获取。
    苹果系统的翻页功能，是模拟鼠标操作的，因此无法做到兼容所有的苹果手机系统，一般是按照最新的IOS版本调试，不考虑旧版本的。
    苹果手机需要打开辅助触控功能：设置 -> 辅助功能 -> 触控 -> 辅助触控打开
    辅助触控下，有个跟踪灵敏度的调节，一般要么设置为0，要在再10%左右的位置。
    

13. CONFIG_APP_REMOTE_CONTROL 红外遥控器，电视遥控器、机顶盒遥控器等。被电视、机顶盒、投影仪等连接。
    这种遥控器，无论是蓝牙HID，还是红外码，都是没有统一标准的，都需要根据每款主机适配的。
    每个电视厂商、每个省的机顶盒，都有各自的标准，都要适配开发的。
    公版sdk红外做的是，NEC编码、海信电视红外键值的。

14. CONFIG_APP_IDLE 空闲模式适用于：MCU应用、充电状态下、假关机状态下。

15. 功能介绍

16. 开关打印

17. 开打印

#define CONFIG_DEBUG_ENABLE    //打印总开关，关打印注释此宏

#define TCFG_UART0_ENABLE       ENABLE_THIS_MOUDLE   //保持，关打印也不要改成disable
#define TCFG_UART0_RX_PORT      NO_CONFIG_PORT       //保持，不要配置IO
#define TCFG_UART0_TX_PORT      IO_PORT_DP           //打印口，可配任意IO
#define TCFG_UART0_BAUDRATE     1000000              //建议用1M，用115200打印会死机

#define LIB_DEBUG    1 // 打开底层库打印，代码会变大很多

const char log_tag_const_v_PMU AT(.LOG_TAG_CONST) = CONFIG_DEBUG_LIB(FALSE);
const char log_tag_const_i_PMU AT(.LOG_TAG_CONST) = CONFIG_DEBUG_LIB(TRUE); // 要看底层驱动打印，改成 TRUE
const char log_tag_const_d_PMU AT(.LOG_TAG_CONST) = CONFIG_DEBUG_LIB(TRUE); // 要看底层驱动打印，改成 TRUE
const char log_tag_const_w_PMU AT(.LOG_TAG_CONST) = CONFIG_DEBUG_LIB(TRUE);
const char log_tag_const_e_PMU AT(.LOG_TAG_CONST) = CONFIG_DEBUG_LIB(TRUE);
const char log_tag_const_c_PMU AT(.LOG_TAG_CONST) = CONFIG_DEBUG_LIB(TRUE);

2. 关打印

/* #define CONFIG_DEBUG_ENABLE    // 关打印，注释此宏 */

#define TCFG_UART0_ENABLE       ENABLE_THIS_MOUDLE   //保持enable，关打印也不要改成disable

#define LIB_DEBUG    0 // 关底层库打印，代码会变小很多

const char MM_ASSERT     = 0; //生产代码必须检查置0，否则死机不复位，需要断电
const int config_asser   = 0; //生产代码必须检查置0，否则死机不复位，需要断电

3. 开异常打印

const char MM_ASSERT           = 1; //打开断言打印，生产代码必须置0
const int config_asser         = 1; //打开异常打印，生产代码必须置0
// 生产代码就算不关打印，这2个变量也必须要置0

相关链接：
查看代码异常复位等异常情况：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IAKCNM
https://doc.zh-jieli.com/AC63/zh-cn/master/getting_started/code_debug/printf_debug.html
4. 复位信息 判断复位源和唤醒源：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IAHMFB
2. 芯片工作状态

1. 快速启动--快速唤醒 烧录快速启动及升级程序方法：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IAMX7W
   快速启动：芯片断电再上电，开机的速度
   快速唤醒：芯片软关机，但没断电，IO唤醒后，开机的速度
2. 工作模式
3. 正常状态--cpu运行状态 芯片正常运行，软件正常跑。此时功耗，跟随主频大小。
   主频越高，功耗越大，在2-5mA之间。
4. 待机状态--低功耗 待机--睡眠--低功耗，没有需要运行的代码，芯片可以 临时进入睡眠低功耗，此时功耗4-5uA之间，保持ram的区域数据还在。
   可以定时唤醒、IO唤醒等。
   https://gitee.com/jieli-tech_fae/IOT-AC630N/blob/master/doc/software/%E9%A9%B1%E5%8A%A8/%E4%BD%8E%E5%8A%9F%E8%80%97%E6%B5%81%E7%A8%8B.md
   没有接口可以主动进入睡眠，需要提前设置底层查询函数，返回空闲状态。

///相关代码
#define TCFG_LOWPOWER_LOWPOWER_SEL            DEEP_SLEEP_EN    //开启BLE低功耗powerdown
#define TCFG_LOWPOWER_LOWPOWER_SEL            LOWPOWER_CLOSE   //关闭BLE低功耗

sys_power_down(4000000);

REGISTER_LP_TARGET()

void sleep_enter_callback(u8 step)
void sleep_exit_callback(u32 usec)


void sleep_run_check_enalbe(u8 enable)

3. 关机状态 软关机，ram数据清空，cpu不跑，只能IO唤醒，此时功耗2uA。

///相关代码
app_soft_flag.sfc_fast_boot = 1;

u8 power_soff_callback()

le_trans_set_soft_poweroff();
power_set_soft_poweroff(); // 一般不能直接调用这个，需要调用应用模式的关机

3. 工作频率 最高可以跑160M，旧的sdk不支持，130版本可以
   建议只跑到128M即可

#define TCFG_CLOCK_SYS_HZ                  48000000 // 48M

#define TCFG_CLOCK_SYS_HZ                  128000000 // 128M

4. 工作电压 VDDIO即芯片工作电压，和IO的输出电压。
   串口模块，需要和其他IC通信的，建议设置VDDIO为 VDDIOM_VOL_34V 和 VDDIOW_VOL_33V
   单芯片状态，建议设置 VDDIO为 VDDIOM_VOL_30V 和 VDDIOW_VOL_28V

#define TCFG_LOWPOWER_VDDIOM_LEVEL            VDDIOM_VOL_30V   // 正常状态下VDDIO电压值
#define TCFG_LOWPOWER_VDDIOW_LEVEL            VDDIOW_VOL_28V   // 睡眠-低功耗-关机下VDDIO电压值

3. 引脚
4. 普通引脚GPIO GPIO使用：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IAEK0D
5. 特殊引脚 特殊引脚--复位引脚--使用配置（PA11、PA4、PA7、USB）：
   https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IAO7N4
6. 电源引脚 IOVDD、VPWR供电方式配置 -- 电量检测配置：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IBUU4M
   IOVDD供电配置问题 https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/ICXAUZ
7. 按键 实现按键软开机功能：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IBAWN5
   关机流程中按键丢失问题优化：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IBQV77
8. io按键

#define KEY_IO_EN                           ENABLE                  //<IO按键使能
#define MOUSE_KEY_SCAN_MODE                 DISABLE_THIS_MOUDLE

#define TCFG_IOKEY_POWER_CONNECT_WAY        ONE_PORT_TO_LOW    //按键一端接低电平一端接IO
#define TCFG_IOKEY_POWER_ONE_PORT           IO_PORTA_00        //IO按键端口
#define TCFG_IOKEY_POWER_ONE_PORT_VALUE     0x0                //power port键值

#define TCFG_IOKEY_PREV_CONNECT_WAY         ONE_PORT_TO_LOW    //按键一端接低电平一端接IO
#define TCFG_IOKEY_PREV_ONE_PORT            IO_PORTA_01
#define TCFG_IOKEY_PREV_ONE_PORT_VALUE      0x1                //prev port键值

/// 每个IO都可以设置成唤醒口
keys_config[index++] = create_key_io_wakeup_config(TCFG_IOKEY_POWER_ONE_PORT,
                                        PORT_INPUT_PULLUP_10K, PORT_FLT_DISABLE, FALLING_EDGE, key_active_set);

//唤醒口个数
#define WAKE_IO_MAX_NUMS                 4

//硬件支持最大唤醒口8个，无法改大的
#define MAX_WAKEUP_PORT                  8  //最大同时支持数字io输入个数

2. ad按键 AD按键，只有对地的0R按键是可以唤醒的，其他按键电压没有拉到地，是唤醒不了。
   做AD按键的，有IO限制的，不是任意IO都可以做。

#define TCFG_ADKEY_ENABLE                   ENABLE_THIS_MOUDLE //是否使能AD按键
#define TCFG_ADKEY_PORT                     IO_PORTB_01         //AD按键端口(需要注意选择的IO口是否支持AD功能)
/*AD通道选择，需要和AD按键的端口相对应:
    AD_CH_PA1    AD_CH_PA3    AD_CH_PA4    AD_CH_PA5
    AD_CH_PA9    AD_CH_PA1    AD_CH_PB1    AD_CH_PB4
    AD_CH_PB6    AD_CH_PB7    AD_CH_DP     AD_CH_DM
    AD_CH_PB2
*/
#define TCFG_ADKEY_AD_CHANNEL               AD_CH_PB1
#define TCFG_ADKEY_EXTERN_UP_ENABLE         ENABLE_THIS_MOUDLE //是否使用外部上拉

#if TCFG_ADKEY_EXTERN_UP_ENABLE
#define R_UP    220                 //22K，外部上拉阻值在此自行设置
#else
#define R_UP    100                 //10K，内部上拉默认10K
#endif

3. 矩阵按键

#define KEY_MATRIX_EN                       ENABLE
#define MATRIX_KEY_ROW1                     IO_PORTA_00
#define MATRIX_KEY_ROW2                     IO_PORTA_01
#define MATRIX_KEY_ROW3                     IO_PORTA_02

#define MATRIX_KEY_ROL1                     IO_PORTA_08
#define MATRIX_KEY_ROL2                     IO_PORTA_09
#define MATRIX_KEY_ROL3                     IO_PORTA_10
// 行列组合，可以自行调整
// 行做唤醒口，那列就要输出口，才能做到任意IO都能唤醒

4. 红外发射/接收按键

#define TCFG_IR_ENABLE                      ENABLE
#define IR_KEY_IO                           IO_PORTA_10
#define IR_WORK_FRQ                         38000
#define IR_WORK_DUTY                        5000
#define TCFG_IR_ENCODER_TIMER_TID           0 // 使用timer0作为红外timer tid
#define TCFG_IR_ENCODER_PWM_TID             1 // 使用timer1作为红外pwm tid

// 红外载波发射
ir_encoder_init(IR_KEY_IO, IR_WORK_FRQ, IR_WORK_DUTY);

// 红外载波接收
ir_decoder_init(IO_PORTA_01); //红外信号接收IO_PORTA_O1

// 默认做的是 38K载波的NEC 红外，其他协议，需要自行修改

5. 蓝牙

6. 广播包 动态修改广播包--广播类型--广播频率：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IBLGAX

7. profile 蓝牙协议简介：https://doc.zh-jieli.com/AW31/zh-cn/master/bluetooth/bt_profeil.html

8. 杰理OTA服务

9. HID服务

10. 链接参数

11. MTU MTU改大到120连接会重启：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IBAIH0
    BLE长包设置 DLE 和 MTU：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IBYBAU

//测试NRF连接,工具不会主动发起交换流程,需要手动操作; 但设备可配置主动发起MTU长度交换请求
#define ATT_MTU_REQUEST_ENALBE     1    /*配置1,就是设备端主动发起交换*/

/*一般是主机发起交换,如果主机没有发起,设备端也可以主动发起(ATT_MTU_REQUEST_ENALBE set 1)*/
#define ATT_LOCAL_MTU_SIZE        (247) /*发送配PDU长度*/

#if ATT_MTU_REQUEST_ENALBE
        att_server_set_exchange_mtu(trans_con_handle);/*主动请求MTU长度交换*/
#endif

    case GATT_COMM_EVENT_MTU_EXCHANGE_COMPLETE:
        log_info("con_handle= %02x, ATT MTU = %u\n", little_endian_read_16(packet, 0), little_endian_read_16(packet, 2));
        break;

注意点：
很老的手机改不了，新手机一般都能128，大部分安卓都能512。
固件只是请求的建议值，最终的生效值，是取决于手机系统端的。
要改大，要注意兼容不同的MTU值，需要自行做重组包操作。
5. nRF Connect使用教程 NOTE：BLE开发流程--使用说明： https://gitee.com/Jieli-Tech/fw-AC63_BT_SDK/issues/I9QI1G
6. BLE主机 [分享内容]: BLE主机流程：https://gitee.com/Jieli-Tech/fw-AC63_BT_SDK/issues/IBP4D3

1. 跳过profile搜索过程

2. 蓝牙断开原因 ble断开原因： https://gitee.com/Jieli-Tech/fw-AC63_BT_SDK/issues/I75JGU

3. FAQ

4. 低功耗

5. 唤醒口 配置独立的唤醒口：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IAN37C
   判断复位源和唤醒源：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IAHMFB
   获取IO唤醒源误识别DMDP问题：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IANZ2U

6. 调功耗

各系列芯片功耗对比

芯片选型建议

• 优先选用AC632 纽扣电池产品、应用层需要RAM大于4KB、对BLE传输速率大于20KB/s、BLE多主从带低功耗
• 优先选用AW31 需要快速唤醒、快速启动、2.4G高回报率

7. 升级OTA

8. APP BLE OTA

9. 测试盒BLE升级

10. 测试盒串口升级 蓝牙测试盒单线串口升级配置：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IB9I7E

11. 杰理串口升级 暂时还没支持

12. 自定义双备份升级 杰理双备份升级介绍.md
    fw-AC63_BT_SDK: Firmware for Generic Bluetooth SDK（AC63 series）, Support AC631N/AC635N/AC636N/AC637N/AC632N, compatible with AC69 series without audio support.
    Firmware for Generic Bluetooth SDK（AC63 series）, Support AC631N/AC635N/AC636N/AC637N/AC632N, compatible with AC69 series without audio support.

13. 杰理USB升级

14. 定时器 硬件定时器使用：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IAHMWG

15. PWM PWM输出：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IAIAJD

16. ADC

17. 电量检测 IOVDD、VPWR供电方式配置 -- 电量检测配置：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IBUU4M

18. 串口

19. USB

20. flash

21. VM 记忆、保存数据到内部flash:https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IAJQUF

22. 自定义flash分区 内置flash开辟自定义区域读写：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IAEY7H

23. 认证码 指定mac地址烧录、自定义保留区烧录认证码、三元组、序列号等:
    https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IAIHDD

24. SDK系统

25. 事件 转事件到最低优先级线程执行：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IAPXPS
    转事件到主循环执行：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IBQVUP

26. 认证相关

27. DUT #define TCFG_NORMAL_SET_DUT_MODE 1 // DUT测试模式,默认上电进初始化
    USB初始化成串口，DP对RX、DM对TX，需要接入串口工具，再接入测试仪器
    AC63X BLE DUT测试介绍.pdf

28. dut 测试程序 AW31N_sdk_release_v1.2.0_trs_dut_波特率115200_v1.0.zip

29. FCC 认证程序FCC、BQB：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IB6J6F
    【金山文档 | WPS云文档】 认证资料获取汇总(最新资料后台会更新)
    https://kdocs.cn/l/cugCGfEDWPhB
    建议采用这个下载包，经过验证的，公版sdk改出来的，不一定是完善的

30. BQB 认证程序FCC、BQB：https://gitee.com/Jieli-Tech/fw-AW31N_BLE_SDK/issues/IB6J6F

本文档包含以下子页面