Создание приложения с поддержкой режима реального времени
Внимание
Это документация по Azure Sphere (устаревшая версия). Служба Azure Sphere (устаревшая версия) выходит на пенсию 27 сентября 2027 г., и к этому времени пользователи должны перейти в Azure Sphere (интегрированная). Используйте селектор версий, расположенный над toC, чтобы просмотреть документацию по Azure Sphere (интегрированная).
Самый простой способ создать новое приложение с поддержкой реального времени — начать работу с пустым шаблоном из расширения Azure Sphere Visual Studio Code и настроить конфигурацию проекта, выполнив следующие действия.
Запустите Visual Studio Code. Выберите палитру команд view>и введите Azure Sphere: Создать проект.
Выберите RTCore Blank в меню "Шаблоны".
Затем Visual Studio Code отображает окно проводник. Перейдите в папку, в которой нужно разместить пустое приложение и укажите имя проекта, например NewRTApp. Visual Studio Code создает папку NewRTApp в выбранном расположении и создает файлы сборки для пустого приложения. Должны появиться сообщения из CMake.
Вы также можете создать новое приложение, поддерживающее режим реального времени, из любого из примеров, поддерживающих Azure Sphere в режиме реального времени:
Клонируйте репозиторий примеров, если вы еще этого не сделали. Скопируйте одну из папок приложения высокого уровня и переименуйте ее для проекта.
В файле CMakeLists.txt измените имя проекта, указав имя своей новой папки. Например:
PROJECT(NewRTApp C)
Самый простой способ создать новое приложение, поддерживающее режим реального времени, — начать с пустого шаблона из расширения Azure Sphere Visual Studio и настроить конфигурацию проекта, выполнив следующие действия:
Откройте Visual Studio и выберите Создать проект.
Введите
Azure Sphere
в поле поиска помеченный "Поиск шаблонов". Выберите Azure Sphere RTCore Blank из возвращаемого списка, а затем нажмите кнопку "Далее".Укажите имя проекта (например, NewRTApp), расположение файла проекта и имя решения (которое может совпадать с именем проекта), а затем нажмите кнопку "Создать". Visual Studio создает папку NewRTApp в выбранном расположении и создает файлы сборки для пустого приложения. Должны появиться сообщения из CMake.
Вы также можете создать новое приложение, поддерживающее режим реального времени, из любого из высокоуровневых примеров Azure Sphere:
Клонируйте репозиторий примеров, если вы еще этого не сделали. Скопируйте одну из папок приложения с поддержкой реального времени и переименуйте ее для проекта.
В файле CMakeLists.txt измените имя проекта, указав имя своей новой папки. Например:
PROJECT(NewRTApp C)
Самый простой способ создать приложение с поддержкой режима реального времени, — начать с примера HelloWorld_RTApp_MT3620_BareMetal и настроить конфигурацию для своего проекта, сделав следующее:
Клонируйте репозиторий примеров, если вы еще этого не сделали. Скопируйте папку HelloWorld_RTApp_MT3620_BareMetal и переименуйте ее для проекта.
В файле CMakeLists.txt измените имя проекта, указав имя своей новой папки. Например:
PROJECT(NewRTApp C)
Базовая структура файлов приложения с поддержкой реального времени
Независимо от того, как вы создаете приложение, все приложения Azure Sphere используют следующие основные файлы:
- Исходный код приложения в одном или нескольких файлах. В настоящее время поддерживается только исходный код языка C.
- Файлы сборки CMake. требуется CMakeLists.txt. CMake вместе с служебной программой упрощенной сборки ninja используется для управления процессом сборки приложения Azure Sphere.
- Файл манифеста приложения, описывающий возможности, доступные приложению.
Приложения, поддерживаемые в режиме реального времени, добавляют по крайней мере один другой файл: файл linker.ld, чтобы указать, где должны загружаться различные компоненты приложения в ядро реального времени.
Написание кода
- Напишите код приложения, используя примеры RTApp в Azure Sphere в качестве руководства. В следующих разделах описываются конкретные сценарии реализации:
- В файле app_manifest.json:
- Задайте
Name
в качестве имени проекта. - Задайте для
ApplicationType
значение"RealTimeCapable"
. - Добавьте все возможности приложения, необходимые для кода, такие как аппаратные ресурсы или подключения. Если приложение RTApp взаимодействует с высокоуровневым приложением, добавьте идентификатор компонента этого приложения в возможность
AllowedApplicationConnections
.
- Задайте
Если требуется развернуть приложение RTApp вместе с высокоуровневым партнерским приложением, добавьте идентификатор компонента партнера в поле partnerComponents в разделе configurations файла launch.vs.json (Visual Studio) или .vscode/launch.json (Visual Studio Code).
"partnerComponents": [ "25025d2c-66da-4448-bae1-ac26fcdd3627" ]