Сбор журналов и анализ сбоев¶

Руководства SDK debug_logging и crash_analysis дополняют друг друга: журналы показывают, что выполняли оба ядра, а дамп памяти позволяет отладчику восстановить контекст сбоя. Для каждого дампа сохраняйте соответствующие ELF, файлы карты компоновки и символов, ревизию SDK, модель микросхемы, конфигурацию и ревизию платы.

Выбор отладочного подключения¶

После выхода LPSYS из режима Standby подключение SWD возвращается к HCPU. Сам по себе сброс через J-Link не переключает выбранное ядро. При асинхронном журналировании дамп assert может оказаться неполным; для фиксации сбоя используйте синхронное журналирование или механизм, сохраняющий данные при сбое.

Сбор данных в реальном времени или после сбоя¶

В актуальных версиях SDK собирайте данные через UART или J-Link с помощью sdk.py:

sdk.py crash-dump capture-live --transport uart --probe /dev/ttyUSB0 \
  --chip SF32LB52 --chip-model LB525 \
  --output /tmp/live-crash --elf build_hcpu/main.elf

Если в целевом устройстве используется PSRAM, добавьте --include-psram --psram-size 8MB. Для J-Link можно задать --transport jlink --jlink-ip 127.0.0.1:19025; выберите ядро, в котором произошёл сбой, с помощью --core hcpu или --core lcpu. В каталоге результатов должны находиться сохранённый двоичный дамп, ELF/AXF ядра, log.txt, manifest.json и sdk_manifest.json.

Для более старых версий SDK используйте способ, предусмотренный для семейства в исходном руководстве:

• UART: SifliUsartServer или AssertDumpUart могут выгрузить пакет assert, пока консоль доступна.
• J-Link/SWD: добавьте J-Link в PATH и запустите скрипт для целевого семейства. Например, для SF32LB55x используется $SDK_ROOT/tools/crash_dump_analyser/script/save_ram_55x.bat. Соответствующий скрипт сохраняет RAM, регистры EPIC и PSRAM.
• Если нужны данные для выявления утечки памяти в куче, включите RTOS → RT-Thread Kernel → Memory Management → Enable memory trace.

Для скриптового сбора выберите файл .jlink, соответствующий семейству, конфигурации PSRAM и способу подключения. При использовании SifliUsartServer нужен скрипт для режима IP, а для прямого подключения J-Link — скрипт для режима USB. Несовпадение конфигурации может привести к сбою захвата.

Для сбора по UART обычно требуется согласовать настройки утилиты последовательного порта, адрес сервера и целевое ядро. Следующие снимки экрана из исходного руководства помогут проверить подключение:

Восстановление и анализ контекста¶

Преобразуйте собранный пакет в core-файл, который можно открыть в отладчике, и анализируйте его с соответствующим ELF:

sdk.py crash-dump readcore --package /tmp/live-crash \
  --elf build_hcpu/main.elf --output /tmp/live-crash/coredump.elf
sdk.py crash-dump analyze --core /tmp/live-crash/coredump.elf \
  --elf build_hcpu/main.elf

В старом процессе с Trace32 загрузите пакет assert HCPU кнопкой HCPU assertion (HA) и командой run_next_step; для дампа LCPU используйте конфигурацию восстановления LCPU. Если стек исключения не отображается, прежде чем интерпретировать регистры, проверьте выбранное ядро, ELF и диапазоны памяти.

Остановка на раннем этапе загрузки или при подозрении на гонку¶

Для отладки инициализации раскомментируйте первую инструкцию в соответствующем Reset_Handler, чтобы она стала B .:

Пути к файлам запуска ниже относятся к SF32LB55x. Для другого семейства используйте соответствующие файлы запуска.

• HCPU: $SDK_ROOT/drivers/cmsis/sf32lb55x/Templates/arm/startup_bf0_hcpu.S
• LCPU: $SDK_ROOT/drivers/cmsis/sf32lb55x/Templates/arm/startup_bf0_lcpu.S

Подключите J-Link и увеличьте PC на два байта, чтобы продолжить выполнение. В C та же преднамеренная остановка задаётся выражением _asm("B .");. Не заменяйте его на while (1);: компилятор может удалить код после цикла.

Анализ диагностических данных¶

Дамп assert обычно содержит функцию и номер строки сработавшей проверки, таблицу потоков, состояние почтовых ящиков и очередей сообщений, мьютексов и семафоров, использование кучи и регистры CPU. Сопоставьте PC на момент сбоя с соответствующим ELF, затем проверьте запас свободного места в стеке, владение ресурсами, на которых заблокировано ожидание, содержимое очередей и последнюю запись журнала перед сбоем. Сохраните исходный дамп до подстановки имён символов.

Для интерактивного анализа Ozone может загрузить ELF для HCPU/LCPU и соответствующий SVD-файл для Cortex-M33 с FPU из $SDK_ROOT/tools/svd_external. Если состояние ядра не позволяет подключиться по SWD, используйте UART или SifliUsartServer. ULOG может работать через UART; после включения поддержки RTT выберите segger в качестве устройства журналирования RT-Thread, чтобы использовать Segger RTT.

Диагностика сбоев шины и памяти¶

Монитор шины SDK позволяет зафиксировать обращения, приводящие к ошибке шины (bus fault). Зарегистрируйте функцию обратного вызова с помощью dbg_busmon_reg_callback, а затем используйте dbg_busmon_read и dbg_busmon_write из исходного примера, чтобы проверить нужный диапазон адресов. Дополните это трассировкой кучи и пакетом аварийного дампа: одного дампа регистров без символов и контекста памяти обычно недостаточно.

Официальные источники по семействам: анализ сбоев SF32LB52x, SF32LB55x, SF32LB56x, SF32LB58x и соответствующее руководство по отладке и журналированию.

Последнее обновление: 2026-10-12