Инструменты¶
Для разработки под SF32 недостаточно одного компилятора. В рабочем процессе также нужны средства прошивки, мониторинга последовательного порта, анализа сбоев, сбора трассировок, преобразования изображений, настройки радиотракта и аудио, а также заводского программирования.
В таблице ниже типовые задачи разработки сопоставлены с подходящими инструментами. Она дополняет, но не заменяет руководства: инструкции по установке, точные команды и процедуры для конкретных инструментов приведены в связанной документации.
Обзор инструментов¶
| Инструмент | Назначение |
|---|---|
sftool |
Кроссплатформенная утилита для загрузки и прошивки SF32, используемая в процессах OpenSiFli на Zephyr и Arduino. |
| UART-скрипты SDK для прошивки | Скрипты для первичной прошивки, создаваемые при сборке SiFli-SDK. |
| Действия CodeKit | Настройка, сборка, прошивка и мониторинг из VS Code. |
AssertDump |
Сохранение данных памяти при сбое для последующего анализа. |
SiFli_Trace / UsartServer |
Сбор трассировок/журналов и отладка по UART через Debug IP микросхемы. |
Impeller |
Программирование прошивки, калибровка и тестирование PCBA на производственной линии. |
| eZip / инструменты для изображений | Преобразование ресурсов для графических конвейеров со сжатием. |
| Инструменты для RF, аудио и производства | Калибровка, тестирование и настройка на этапе производства. |
Инструменты прошивки¶
Для первого запуска платы используйте UART-скрипты SDK: они создаются для только что собранной прошивки. Добавьте sftool, если вам нужны:
- Единый инструмент командной строки для прошивки в разных процессах.
- Интеграция с
west flashв Zephyr. - Поддержка загрузки прошивки через ArduinoCore-zephyr.
- Автоматизация в CI, на производстве или при регрессионном тестировании.
Пока команда не выбрала единый стандарт, документируйте в проекте оба способа.
Журналы и трассировки¶
Для обычной разработки достаточно терминала последовательного порта. При сложных сбоях сохраняйте структурированные журналы и данные для анализа:
- Сохраняйте полный журнал загрузки, начиная со сброса.
- Храните точные файлы ELF, map и отладочных символов, соответствующие прошитому образу.
- Записывайте, какая среда была активна: shell RT-Thread, shell Zephyr или режим отладки Arduino.
- Если доступны диагностические средства SiFli, используйте их для анализа assert-дампов и сбора трассировок.
Инструменты для ресурсов и производства¶
Для продуктов с насыщенной графикой документируйте процесс преобразования ресурсов, особенно если используются сжатие eZip или аппаратное ускорение графики. Для серийного производства отдельно описывайте средства настройки RF, аудио и производственные инструменты, не смешивая их с инструментами прошивки для разработчиков: это не позволит производственным операторам зависеть от команд, предназначенных только для разработки.
Контрольный список по выбору инструментов¶
| Задача | Рекомендуемый инструмент |
|---|---|
| Первая прошивка через SDK | UART-скрипт прошивки SDK. |
| Кроссплатформенная прошивка по скрипту | sftool. |
| Сборка и мониторинг из VS Code | CodeKit. |
| Сбой после запуска | Журнал последовательного порта и средство анализа assert-дампов. |
| Длительный сбор трассировок | Средства сервера трассировок/UART. |
| Подготовка графических ресурсов | eZip/инструменты для изображений. |
| Программирование на производстве | Производственные инструменты SiFli и утверждённые процедуры. |
Практические рекомендации¶
- Освойте один надёжный способ прошивки, прежде чем добавлять второй.
- Сохраняйте проверенные журналы последовательного порта для каждой платы.
- Для первого запуска используйте скрипты, созданные SDK.
- Используйте
sftool, если нужна воспроизводимая прошивка из командной строки для Zephyr, Arduino или автоматизированных процессов. - Подготовьте средства анализа сбоев до того, как появится трудно воспроизводимая ошибка.
Последнее обновление: