Обзор раздела «Начало работы»¶
Для устройств SF32 доступно несколько вариантов разработки. Сейчас официальные средства для первого запуска — SiFli-SDK и CodeKit. Поддержка платы SF32LB52 DevKit LCD в основном проекте Zephyr доступна начиная с версии Zephyr v4.3.0. OpenSiFli также предлагает бета-пакет ArduinoCore-zephyr и разрабатывает поддержку Rust для SF32LB52. Для MicroPython пока нужны официальные образы прошивки и инструкции для конкретных плат; без них нельзя подготовить полноценное проверенное руководство.
Сведения о рекомендуемом процессе разработки и текущем статусе каждой платформы см. в разделе Обзор раздела «Разработка». Используйте таблицу ниже только для выбора отправной точки: основным источником сведений о поддерживаемых платах и ограничениях служит страница соответствующей платформы.
Выберите вариант разработки¶
| Вариант | Текущий статус | С чего начать |
|---|---|---|
| SiFli-SDK | Официальная платформа SiFli для разработки устройств на SF32: RT-Thread, Bluetooth, графика, аудио, энергосбережение, первичный запуск и проверка платы. | SiFli-SDK |
| SiFli CodeKit | Официальный процесс разработки SiFli в VS Code: настройка SDK, создание проекта, сборка, прошивка и монитор последовательного порта. | SiFli CodeKit |
| Zephyr | Начиная с Zephyr v4.3.0, в основном проекте Zephyr поддерживается плата sf32lb52_devkit_lcd. |
Zephyr upstream |
| Arduino | Для SF32LB52 DevKit LCD в OpenSiFli доступен бета-пакет ArduinoCore-zephyr. | Arduino |
| Rust | Проект OpenSiFli sifli-rs позволяет экспериментировать с Rust, но пока находится в разработке и не готов к серийному применению. |
Rust |
| MicroPython | Нужны официальные образы прошивки, команды прошивки, настройки REPL и сведения о поддерживаемых API. | MicroPython |
Что понадобится¶
Сначала выберите плату, поддерживаемую нужным программным путём. Подключение для прошивки и последовательной связи зависит от платы и фреймворка:
- Отладочная плата SF32, например SF32LB52-DevKit-LCD.
- Кабель с поддержкой передачи данных и интерфейс для прошивки/последовательной связи, указанный для этой платы и фреймворка. Для SF32LB52-DevKit-LCD в инструкциях SiFli по подключению для последовательной загрузки используется USB-to-UART; не путайте его с отдельным USB-разъёмом для USB-функций.
- Компьютер под управлением Windows, macOS или Linux.
- Терминал последовательного порта, настроенный для консоли платы, чтобы просматривать загрузочные журналы и вывод примеров.
Используйте кабель для передачи данных
Кабели USB, предназначенные только для зарядки, часто становятся причиной проблем при первом запуске. Если плата включается, но последовательный порт не появляется, попробуйте заведомо исправный кабель для передачи данных и подключите его напрямую к USB-порту компьютера.
Рекомендуемый первый запуск¶
Если вы впервые работаете с платой SF32, начните с SiFli-SDK. Это эталонный программный стек для SF32 и наиболее надёжная отправная точка, чтобы проверить плату, кабель, последовательный порт, процедуру прошивки и инструментарий.
После успешного запуска hello_world можно перейти к другой платформе, совместимой с конкретным оборудованием. Так у вас останется заведомо рабочая конфигурация, к которой можно вернуться, если последующие эксперименты вызовут проблемы.
Признаки успешного запуска¶
К концу руководства по началу работы у вас должно быть выполнено следующее:
- Собран или загружен первый пример.
- Пример записан на плату.
- Открыта консоль последовательного порта.
- Получен ожидаемый вывод: например, загрузочный журнал,
hello_world, приглашение оболочки или баннер REPL. - Зафиксированы название платы, последовательный порт и команда прошивки, с которой всё заработало.
Сохраните эти сведения в заметках проекта. Когда начнёте изменять примеры, они помогут быстрее восстановить рабочую конфигурацию.
Перейти к руководствам¶
Как только вы сможете повторить успешный первый запуск, переходите к обзору практических руководств. Это следующий этап обучения: сначала работа с одной периферийной подсистемой, затем объединение нескольких подсистем и, наконец, проверка проекта на соответствие требованиям изделия.
Когда переходить к разделу «Разработк໶
Цель раздела «Начало работы» достигнута, когда вы можете повторить заведомо успешный первый запуск. Раздел «Разработка» служит постоянным инженерным справочником по зрелости платформ, инструментам, прошивке и отладке, архитектуре прошивки и интеграции изделия. После первого запуска обратитесь к справочнику по инструментам CodeKit, чтобы разобраться в его роли в повседневной разработке; эта страница посвящена именно первому запуску.
Что проверить перед выбором пути разработки¶
Прежде чем выбирать вариант разработки, убедитесь, что документация охватывает нужную плату и версию ПО. В частности, проверьте, есть ли в ней:
- Публичная матрица поддержки и уровня зрелости по каждой плате для SiFli-SDK, CodeKit, Zephyr, Arduino и MicroPython.
- Точный идентификатор платы для каждого поддерживаемого варианта разработки.
- Инструкции по прошивке и загрузке для Windows, macOS и Linux.
- Ожидаемый вывод последовательного порта для каждого первого примера.
- Инструкции по восстановлению после неудачной прошивки или использования недействительного образа.
- Известные ограничения каждой платформы, особенно для Bluetooth, дисплея, хранилища, USB и режимов низкого энергопотребления.
- Примечания к выпускам с указанием совместимых версий SDK, CodeKit, пакетов, образов прошивки и поддержки плат.
Не считайте, что вариант разработки, доступный для одной платы, подходит для всех плат SF32. Проверяйте конкретную плату и используемую версию ПО.
Последнее обновление: