系统调试
Armino平台AP系统调试命令
BK7258 AP系统的log通过mailbox转发到CP侧串口DL_UART0输出(默认波特率为115200)
通过这三个宏CONFIG_SYS_PRINT_DEV_MAILBOX=n，CONFIG_SYS_PRINT_DEV_UART=y，CONFIG_UART_PRINT_PORT=0 可以改变AP的Log输出方式（上述设置是AP的Log通过UART0输出）
AP log带cpu1标签（异常log除外）
通过串口输入log命令查看当前log配置
宏CONFIG_UART_ATE_PORT表示使用哪一个PIN管脚检测ATE模式；宏CONFIG_UART_PRINT_PORT表示默认初始化时，LOG的UART口；CONFIG_UART_ATE_PRINT_PORT表示ATE检测时，将LOG的UART口做一次切换（但此时LOG口还没有初始化,初始化时，根据CONFIG_UART_ATE_PRINT_PORT选择） 示例：ate识别用uart1的tx，正常应用的日志用uart1，进ate模式后，log及命令行用uart0，配置如下：CONFIG_UART_ATE_PORT=1，CONFIG_UART_PRINT_PORT=1，CONFIG_UART_ATE_PRINT_PORT=0
通过串口输入help命令查看当前支持的调试命令：
#cpu1 log $log: echo 1, level 3, sync 0, white_list 0, flush 1. #cpu1 help $====Build-in Commands==== help log: log [echo(0,1)] [level(0~5)] [sync(0,1)] [Whitelist(0,1)] debug: debug cmd [param] (ex:debug help) loginfo: log statistics. modlog: modlog tag_name on/off ====User Commands==== 2bd_master_test: 2bd_master_test {start|stop} 2bd_slave_test: 2bd_slave_test {start|stop} assert: asset and dump system information aud_adc_dma_test: aud_adc_dma_test {start|stop sample_rate} aud_adc_loop_test: aud_adc_loop_test {start|stop sample_rate} aud_adc_mcp_test: aud_adc_mcp_test {start|stop sample_rate} aud_dac_dma_test: aud_dac_dma_test {start|stop 8000|16000|44100|48000} aud_dac_eq_test: aud_dac_eq_test {start|stop} aud_dac_mcp_test: aud_dac_mcp_test {8000|16000|44100|48000} backtrace: show task backtrace cpuload: show task cpu load cputest: cputest [count] dhcpc: dhcpc dma: dma {id} {init|deinit|start|stop|set_tran_len|get_remain_len} dma_chnl: dma_chnl alloc dma_chnl_free: dma_chnl_free {id} dma_chnl_test: {start|stop} {uart1|uart2|uart3} {wait_ms} dma_config: dma_config {mode|priority|pasue|src|dst}{mode value/priority value/dev,width,increase_en,loop_en,start_addr,end_addr} dma_copy: copy {src} {dst} {len} dma_driver: dma_driver {init|deinit} dma_int: dma_int {id} {reg|enable_hf_fini|disable_hf_fini|enable_fini|disable_fini|pause} dma_memcopy_test: copy {count|in_number1|in_number2|out_number1|out_number2} dtm_master_test: dtm_master_test {start|stop} dtm_slave_test: dtm_slave_test {start|stop} dvfs: dvfs [cksel_core] [ckdiv_core] [ckdiv_bus] [ckdiv_cpu0] [ckdiv_cpu1] dvfs_auto_test: dvfs_auto_test [period] dwtd: dwtd r/w/b data_address dwtdd: dwtdd data_address data_value dwtdr: dwtdr data_address data_address_limit dwti: dwt instruction_addr event: event {reg|unreg|post} {mod_id} {event_id} exception: {undefine|dabort|illegal|irq|fiq} fatfs_idle_test: fatfs_idle_test {start|stop|clean} fatfstest: fatfstest <cmd> flash: flash {erase|read|write} [start_addr] [len] flash_erase_test: cli_flash_erase_test with ble connecting flash_partition: flash_partition {show} flash_test: flash_test <cmd(R/W/E/N)> fmap_test: flash_test memory map fpb: fpb instruction_addr gpio: gpio [set_mode/output_low/output_high/input/spi_mode] [id] [mode] gpio_driver: gpio_driver [init/deinit]} gpio_int: gpio_int [index] [inttype/start/stop] [low/high_level/rising/falling edge] gpio_map: gpio_map [sdio_map/spi_map] gpio_retention_test: gpio_retention_test http_ota: http_ota url httplog: httplog [1|0]. i2c: i2c {init|write|read} i2c_driver: i2c_driver {init|deinit} i2s_master_test: i2s_master_test {start|stop} i2s_slave_test: i2s_slave_test {start|stop} id int: retarget {int_group0} {int_group1} ip: ip [sta|ap][{ip}{mask}{gate}{dns}] ipconfig: ipconfig [sta|ap][{ip}{mask}{gate}{dns}] iperf: iperf help jpeg: jpeg {init|deint} jpeg_driver: jpeg_driver {init|deinit} lwip_mem: print lwip memory information lwip_pbuf: print lwip pbuf information lwip_stats: print lwip protocal statistics memdump: <addr> <length> memleak: [show memleak memset: <addr> <value 1> [<value 2> ... <value n>] memshow: show free heap memstack: show stack memory usage memtest: <addr> <length> memtest_r: <src> <dest> <size> memtest_wr: <addr> <count> memtime: <addr> <count> <0:write,1:read> micodebug: micodebug on/off mpucfg: <rnr> <rbar> <rlar> cpu2:(11008):cpu2_test_task run core: 2 cpu1:(11008):cpu1_test_task run core: 1 mpuclr: <rnr> mpudump: dump mpu config osinfo: show os runtime information pcm_master_test: pcm_master_test {start|stop} pcm_slave_test: pcm_slave_test {start|stop} per_packet_info: per_packet_info [per_packet_info_output_bitmap(base 16)] ping: ping <ip> pm: pm [sleep_mode] [wake_source] [vote1] [vote2] [vote3] [param1] [param2] [param3] pm_clk: pm_clk [module_name][clk_state] pm_ctrl: pm_ctrl [ctrl_value] pm_debug: pm_debug [debug_en_value] pm_freq: pm_freq [module_name][ frequency] pm_lpo: pm_lpo [lpo_type] pm_power: pm_power [module_name][ power state] pm_vol: pm_vol [vol_value] pm_vote: pm_vote [pm_sleep_mode] [pm_vote] [pm_vote_value] [pm_sleep_time] psram_free: psram_free <addr> psram_malloc: psram_malloc <length> psram_state: psram_state qspi: qspi {init|write|read} qspi_driver: qspi_driver {init|deinit} reboot: reboot system regdump: regdump {module} regshow: regshow -w/r addr [value] sd_card: sd_card {init|deinit|read|write|erase|cmp|} sdio: sdio {init|deinit|send_cmd|config_data} sdio_host_driver: sdio_host_driver {init|deinit} sdmadc: sdmadc_test sdtest: sdtest <cmd> spi: spi {init|write|read} spi_config: spi_config {id} {mode|baud_rate} [...] spi_data_test: spi_data_test {id} {master|slave} {baud_rate|send}[...] spi_driver: spi_driver {init|deinit} spi_flash: spi_flash {id} {readid|read|write|erase} {addr} {len}[...] spi_int: spi_int {id} {reg} {tx|rx} stackguard: stackguard <override_len> starttype: show start reason type tasklist: list tasks time: system time timer: timer {chan} {start|stop|read} [...] uart: uart {id} {init|deinit|write|read|write_string|dump_statis} [...] uart_config: uart_config {id} {baud_rate|data_bits} [...] uart_driver: {init|deinit} uart_int: uart_int {id} {enable|disable|reg} {tx|rx} usb: usb driver_init|driver_deinit|power[gpio_id ops]|open_host|open_dev|close usb_ls: usb list system usb_mount: usb mount usb_op: usb_read file length usb_unmount: usb unmount version wdrv: wdrv
Armino平台AP系统swd调试
ap系统支持在线调试，使用jlink工具及Eclipse上位机工具，即可快速搭建调式环境。
JLink环境通过Eclipse集成JLink gdb server + gdb 工具
Jlink和BK7258连线:
1# VTref ---- VREF 7# SWDIO ---- SWDIO 9# SWCLK ---- SWCLK 20# GND ---- GNDJLink软件版本 https://www.segger.com/downloads/jlink/JLink_Windows_V768_x86_64.exe
Eclipse版本 eclipse-embedcpp-2020-12-R-win32-x86_64.zip
Eclipse工程配置
默认swd连接cpu0(cp端)，BK7258有两个swd口(grou1/group2)
可以通过setjtagmode cpu0 group1命令设置swd连接cpu0(cp端)
可以通过setjtagmode cpu1 group1设置swd连接cpu1(ap端)
可以通过jtagmode命令查看当前jtag状态
备注
使用Jlink进行SWD调试连接，需要编译DEBUG版本。
如果是开机异常，在串口输入命令的形式可能无法连接上Jlink。可以在driver_init里bk_gpio_driver_init();之后手动调用： bk_set_jtag_mode(0,0); //第一个参数0表示调试cpu0，第二个参数0表示使用第一组SWD gpio管脚 while(g_test_mode); //定义一个volitale的全局变量，而不是while（1）；是防止编译器将后面的代码全部优化掉
然后接入Jlink后，修改g_test_mode变量值，开始往下调试。
由于GPIO管脚复用，所以默认版本接入JLINK调试，需要输入调试命令，或者在代码里设置调试模式：
关闭看门狗
重新配置SWD相关的gpio
swd调试示例
连接好jlink后，可以按照以下步骤打断点调试：
根据函数指针或者函数名在Disassembly页找到dump的地址
示意图1
示意图2
在dump函数之前的语句设置断点，将断点属性设置为hardware
示意图3
点击resume继续运行程序。运行错误代码，如我在sta命令里，加了错误代码
示意图4
程序在断点处停下
示意图5
Armino平台异常dump一键恢复现场工具
请参考发布工具中使用文档: https://dl.bekencorp.com/tools/Debug_tool/BK7258-debug.zip
BK7258 dump工具常见问题:
默认Release版本dump功能是关闭的, 可以通过CONFIG_DUMP_ENABLE配置打开
当前的架构采用cp+ap模式, 可以通过两者的config文件修改打开dump功能
Dump工具恢复现场的原理是脚本通过分析log,解析出regs,itcm,dtcm,sram内容,然后通过gdb将这些内容恢复到qemu虚拟机中
Log文件的后缀支持txt, log, DAT
Log文件的编码当前只支持utf-8, 其他编码格式可用通过notepad++手动转换为utf-8编码格式
如果工具目录下有多份Log, 或者Log中有多次Dump, 工具会分析最后一次Dump, 需要保证工具目录下只有一份Log, 且Log中只有一份dump
Dump工具可以自动去掉日志里规则的时间戳: [2024-02-03 14:35:13.375193], 如果遇到不规则的时间戳, 需要手动去除
Dump过程中如果出现2次异常, 常见的如检测内存越界时, 遇到Assert, 会多打印一次寄存器, 解析时需要删掉第二次寄存器打印
任一个cpu Dump都会将当前cpu的寄存器, itcm, dtcm, 以及640k sram全部dump出来
默认cp侧的Log和Dump通过UART0输出
默认ap侧的Log和Dump通过MAILBOX到cp再通过UART0输出
Dump过程中如果遇到多个cpu同时dump, 需要将Log拆分成两份dump文件,分别用cp和ap的elf来恢复现场
每个cpu需要当前cpu的寄存器, itcm, dtcm, sram加上elf就可以恢复现场
寄存器格式:
CPU1 Current regs: =========> CPU1 表示当前寄存器是cpu1出现异常的寄存器 0 r0 x 0x0 1 r1 x 0x28061ca0 2 r2 x 0x0 3 r3 x 0x8061ca0 4 r4 x 0x28061d74 5 r5 x 0x28061d70 6 r6 x 0x28085a90 7 r7 x 0x28061de4 8 r8 x 0x8080808 9 r9 x 0x9090909 10 r10 x 0x10101010 11 r11 x 0x11111111 12 r12 x 0x1 14 sp x 0x20000928 15 lr x 0x21ec909 16 pc x 0x21ec8fa 17 xpsr x 0x61000000 18 msp x 0x2808ff48 19 psp x 0x20000908 20 primask x 0x0 21 basepri x 0x0 22 faultmask x 0x0 23 fpscr x 0x0 30 CPU1 xPSR x 0x4 31 LR x 0xfffffffd 32 control x 0xc 40 MMFAR x 0x8061ca0 41 BFAR x 0x8061ca0 42 CFSR x 0x82 43 HFSR x 0x0 MemFault =========> 初步异常原因是内存访问异常dtcm格式:
>>>>stack mem dump begin, stack_top=20000000, stack end=20004000 <<<<stack mem dump end. stack_top=20000000, stack end=20004000itcm格式:
>>>>stack mem dump begin, stack_top=00000020, stack end=00004000 <<<<stack mem dump end. stack_top=00000020, stack end=00004000sram格式:
>>>>stack mem dump begin, stack_top=28040000, stack end=28060000 <<<<stack mem dump end. stack_top=28040000, stack end=28060000 >>>>stack mem dump begin, stack_top=28060000, stack end=280a0000 <<<<stack mem dump end. stack_top=28060000, stack end=280a0000 >>>>stack mem dump begin, stack_top=28000000, stack end=28010000 <<<<stack mem dump end. stack_top=28000000, stack end=28010000 >>>>stack mem dump begin, stack_top=28010000, stack end=28020000 <<<<stack mem dump end. stack_top=28010000, stack end=28020000 >>>>stack mem dump begin, stack_top=28020000, stack end=28040000 <<<<stack mem dump end. stack_top=28020000, stack end=28040000当系统打开CONFIG_MEM_DEBUG时, Dump过程会将当前系统正在使用的Heap内存全部打印出来, 并检查是否有内存越界:
tick addr size line func task -------- ---------- ---- ----- -------------------------------- ---------------- 6976 0x28064b68 80 425 xQueueGenericCreate media_ui_task 6976 0x28064be0 80 425 xQueueGenericCreate media_ui_task 6976 0x28064c58 160 425 xQueueGenericCreate media_ui_task 6976 0x28064d20 1024 863 xTaskCreate_ex media_ui_task 6976 0x28065148 104 868 xTaskCreate_ex media_ui_task 6976 0x2807d098 80 425 xQueueGenericCreate transfer_major_task 6976 0x2807d110 80 425 xQueueGenericCreate transfer_major_task正常情况下也会将task相关信息dump到日志, 供问题分析时参考
Armino平台系统稳定性问题分析
嵌入式稳定性问题是一类常见但不容易定位的问题，其具有以下特征：
不可预测性：系统故障的时间点不固定，难以预测，可能在长时间运行后突然发生
多样性：问题可能以崩溃、死机、卡顿或错误行为等多种形式出现
累计效应：系统运行时间越长，资源泄漏或数据损坏等问题可能积累，最终导致崩溃
环境依赖性：稳定性还可能受温度、湿度和电源波动等环境因素的影响
为了帮助用户更好的定位稳定性问题，下面的链接文档中提供了常见的分析手段
备注
本文档仅针对软件引起的稳定性问题,建议用户在碰到稳定性问题时，优先参考该文档
文档 下载链接
文档内容说明:
文中介绍了系统调试相关的工具，请参考上述章节
文中列举了系统可能出现异常的各种场景
文中还列举了一些经典的稳定性问题的分析案例