AUTOSAR RTE

Функция Rte_Start выделяет и инициализирует системные и коммуникационные ресурсы, используемые RTE [SWS_Rte_03015]. API генерируется всегда [SWS_Rte_01309], имеет сигнатуру Std_ReturnType Rte_Start (void) [SWS_Rte_02569] и обязательно должна возвращать управление в течение конечного времени выполнения без бесконечного цикла [SWS_Rte_02585].

Функция может вызываться на каждом Core только ровно один раз через EcuStateManager из доверенного контекста OS после того, как были инициализированы все модули базового программного обеспечения, необходимые RTE [SWS_Rte_CONSTR_09035]. Вызов выполняется независимо на каждом Core [SWS_Rte_07615] и выполняет действия по запуску, специфичные для разделов, для всех разделов, назначенных этому Core [SWS_Rte_07616].

В процессе работы RTE инициализирует переменные, выделенные для блоков RAM, в зависимости от сконфигурированной стратегии [SWS_Rte_07632]. После инициализации переменных, но еще до выполнения исполняемых сущностей (Runnables), RTE вызывает функции инициализации Rte_Rips_Rte_Start всех задействованных RTE Implementation Plug-In [SWS_Rte_80052]. Затем RTE однократно активирует все Runnables, инициируемые InitEvent [SWS_Rte_06761], и запускает переход в начальные режимы [SWS_Rte_06766]. Если API Rte_StartTiming не существует, Rte_Start дополнительно запускает активацию Runnables, инициируемых TimingEvent [SWS_Rte_07575] или BackgroundEvent [SWS_Rte_07178].

Для обработки ошибок RTE или SchM при активированном RteDevErrorDetectUninit сообщает об ошибке RTE_E_UNINIT (0x07), если Rte_Start вызывается до SchM_Init [SWS_Rte_07683]. До выполнения Rte_Start runtime API RTE вызывать запрещено, так как в противном случае это также приводит к RTE_E_UNINIT [SWS_Rte_07682]; напротив, Rte_SetMirror разрешается вызывать еще до Rte_Start [SWS_Rte_07319].

Функция Rte_Stop ([SWS_Rte_02570]) генерируется в любой конфигурации ([SWS_Rte_01310]) и служит для финализации RTE на выполняющем Core ([SWS_Rte_01262]). При этом освобождаются все системные и коммуникационные ресурсы, выделенные RTE на этом ядре Core ([SWS_Rte_01262]). Синхронный вызов гарантированно завершается в течение конечного времени выполнения ([SWS_Rte_02584]).

В общей системе Rte_Stop должна вызываться EcuStateManager до того, как будут остановлены модули базового программного обеспечения, необходимые RTE ([SWS_Rte_CONSTR_09038]). В ходе выполнения RTE вызывает функции остановки Rte_Rips_Rte_Stop всех задействованных RTE Implementation Plug-In ([SWS_Rte_80053]), которые должны предоставлять эти интерфейсы жизненного цикла ([SWS_Rte_70047]). Только после полного завершения Rte_Stop разрешается выполнять SchM_Deinit ([SWS_Rte_CONSTR_09056]).

После вызова Rte_Stop на ядре Core RTE больше не активирует, не запускает и не освобождает на нем экземпляры RunnableEntity ([SWS_Rte_02538]). Это не влияет на возможность дальнейшего вызова Rte_GetMirror при условии, что базовая операционная система активна ([SWS_Rte_07350]).

В случае ошибки функция возвращает RTE_E_LIMIT, если был превышен внутренний предел или произошел сбой выделения требуемого ресурса ([SWS_Rte_01262]). Если активирован RteDevErrorDetectUninit, RTE сообщает об ошибке RTE_E_UNINIT (0x07) при вызове недопустимых API после Rte_Stop ([SWS_Rte_07682]).

Функция Rte_StartTiming служит для того, чтобы после завершения инициализации RTE разрешить активацию RunnableEntity, запускаемых по TimingEvent или BackgroundEvent ([SWS_Rte_06753], [SWS_Rte_06756]). Она реализуется как функция без параметров и без возвращаемого значения ([SWS_Rte_06754], [SWS_Rte_06758]) и должна возвращать управление в течение конечного времени выполнения ([SWS_Rte_06757]).

В отношении контекста вызова и очередности API подчиняется строгим граничным условиям:

• Функцию разрешается вызывать только после того, как RTE была полностью инициализирована, конкретно — после завершения вызова Rte_Start ([SWS_Rte_CONSTR_09061]).
• Она предназначена для выполнения после последнего вызова функции Rte_Init ([SWS_Rte_06753]).
• Данный API генерируется или предоставляется, как только создается хотя бы один API Rte_Init ([SWS_Rte_06755]).

При вызове Rte_StartTiming она немедленно запускает периодические и фоновые активации ([SWS_Rte_06759], [SWS_Rte_06760]). Если же данный API в конфигурации отсутствует, то вместо этого уже вызов Rte_Start берет на себя деблокирование Runnable-сущностей, инициируемых через TimingEvent и BackgroundEvent ([SWS_Rte_07178], [SWS_Rte_07575]). Специфические коды ошибок или возвращаемые значения для этого вызова не определены ([SWS_Rte_06754]).

Использование и семантика

Функция SchM_Init выделяет и инициализирует системные ресурсы, используемые Basic Software Scheduler (SchM) в составе RTE на вызывающем Core ([SWS_Rte_08060]). Этот интерфейс генерируется всегда ([SWS_Rte_07271]) и имеет сигнатуру void SchM_Init(const SchM_ConfigType* ConfigPtr) ([SWS_Rte_07270]). Он выполняется синхронно и обязательно должен возвращать управление за конечное время выполнения, не входя в бесконечный цикл ([SWS_Rte_07273]).

В процессе инициализации SchM_Init выполняет следующие шаги:

• Инициирует переход в начальный режим для каждого экземпляра машины режимов, относящегося к Basic Software Scheduler ([SWS_Rte_07532]).
• Запускает активацию экземпляров BswSchedulableEntity, инициируемых событиями BswBackgroundEvent ([SWS_Rte_07584]).
• Вызывает функции инициализации Rte_Rips_SchM_Init всех задействованных RTE Implementation Plug-Ins ([SWS_Rte_80051]).

Контекст вызова и условия очередности

SchM_Init разрешается вызывать на каждом Core строго один раз с помощью EcuStateManager, как только модули BSW, необходимые для Basic Software Scheduler, будут инициализированы ([SWS_Rte_CONSTR_09055]). Последующие API, такие как Rte_Start, разрешается вызывать только после полного завершения SchM_Init ([SWS_Rte_CONSTR_09036]).

Обработка ошибок

Если SchM_Init вызывается с указателем NULL в качестве параметра, Basic Software Scheduler сообщает об ошибке RTE_E_DET_ILLEGAL_VARIANT_CRITERION_VALUE (0x02) ([SWS_Rte_07684]). Если API планировщика (такие как SchM_Switch, SchM_Mode или SchM_Start) или Rte_Start вызываются до SchM_Init, при активированном RteDevErrorDetectUninit сообщается об ошибке RTE_E_UNINIT (0x07) ([SWS_Rte_07683]).

Использование

Функция SchM_Start служит для ввода в эксплуатацию Basic Software Scheduler в модуле RTE и принципиально всегда предоставляется в рамках генерации интерфейсов [SWS_Rte_04547]. Она имеет C-сигнатуру без параметров void SchM_Start(void) [SWS_Rte_04546] и не возвращает значения. Для выполнения действует обязательное требование: вызов должен возвращать управление в течение конечного времени выполнения и ни в коем случае не должен зацикливаться в бесконечном цикле [SWS_Rte_04548]. Ввиду отсутствия асинхронных механизмов callback-вызовов, вероятно, речь идет о синхронно блокирующем вызове инициализации. Вопрос Q-b6ad9ed696841d7a (открытый)

Контекст вызова и параллелизм

Для контекста вызова и взаимодействия с другими системными компонентами действуют строгие ограничения:

• Вызывающий компонент и частота: функция может вызываться на каждом процессорном ядре исключительно через EcuStateManager и при этом только ровно один раз [SWS_Rte_CONSTR_09055].
• Условия очередности: вызов должен происходить только после того, как будут полностью инициализированы все модули Basic Software, необходимые части Basic Software Scheduler модуля RTE [SWS_Rte_CONSTR_09055].
• Взаимодействие при запуске системы: после выполнения Basic Software Scheduler готов к работе; вызов обязательно должен выполняться до инициализации BSW-менеджера через BswM_Init() [SWS_Rte_07273].

Обработка ошибок

Специфические коды ошибок, возвращаемые значения или уведомления для DET или DEM в полезной нагрузке для этой функции не определены.

Использование

Функция SchM_StartTiming имеет сигнатуру без параметров void SchM_StartTiming(void) [SWS_Rte_04549] и всегда генерируется RTE-генератором [SWS_Rte_04550]. Ее вызов запускает периодические события для BSW и SWC [SWS_Rte_04548], инициируя активацию экземпляров BswSchedulableEntity, запускаемых BswTimingEvent [SWS_Rte_07574]. Функция должна возвращать управление в течение конечного времени выполнения и не должна содержать бесконечный цикл [SWS_Rte_04551].

Контекст вызова и ограничения

Перед вызовом SchM_StartTiming обязательно должна быть вызвана SchM_Init [SWS_Rte_04548]. Кроме того, действует обязательное ограничение, согласно которому SchM_StartTiming на каждом Core может быть вызвана через EcuStateManager строго один раз после того, как будут инициализированы все модули базового программного обеспечения, необходимые для Basic Software Scheduler [SWS_Rte_CONSTR_09055].

Обработка ошибок

Если SchM_StartTiming вызывается до SchM_Init, Basic Software Scheduler или RTE сообщает об ошибке RTE_E_UNINIT (0x07) при условии, что обнаружение ошибок разработки RteDevErrorDetectUninit активировано [SWS_Rte_07683].

Использование и функциональные возможности

Функция SchM_Deinit служит для финализации части Basic Software Scheduler в RTE на том Core, на котором она вызывается [SWS_Rte_04551]. При этом сервис освобождает все системные ресурсы, которые были заняты BSW-планировщиком на этом Core [SWS_Rte_04551]. Функция не имеет ни параметров, ни возвращаемого значения (void SchM_Deinit(void)) [SWS_Rte_07274] и всегда генерируется RTE-генератором [SWS_Rte_07275]. Что касается временных характеристик, спецификация требует, чтобы SchM_Deinit возвращала управление за конечное время выполнения [SWS_Rte_07277].

Контекст вызова и условия очередности

Для вызова во время фазы отключения электронного блока управления действуют обязательные требования к последовательности:

• Функцию SchM_Deinit разрешается использовать только после того, как RTE была полностью финализирована, то есть после завершения Rte_Stop [SWS_Rte_CONSTR_09056].
• Вызов должен выполняться через EcuStateManager перед завершением работы базовых уровней, необходимых для функционирования Basic Software Scheduler [SWS_Rte_CONSTR_09057].
• После того как SchM_Deinit была вызвана на определенном Core, BSW-планировщик на этом Core больше не должен активировать или запускать какие-либо экземпляры BswSchedulableEntity [SWS_Rte_07586].

Очистка подключаемых модулей

В рамках деинициализации RTE внутри SchM_Deinit в обязательном порядке вызывает функции Rte_Rips_SchM_Deinit всех участвующих подключаемых модулей RTE Implementation Plug-In, чтобы завершить их очистку [SWS_Rte_80054].

Функция-обработчик <name of the Invocation Handler> выполняет в модуле Rte синхронный вызов различных типов Runnable через трансформер [SWS_Rte_89015]. К поддерживаемым сущностям относятся Server-Runnable, Hard-Error-Runnable, ASCR-Runnable, а также триггерные Runnable [SWS_Rte_89015].

Интерфейс не имеет ни входных, ни входных/выходных, ни выходных параметров и не возвращает значения (сигнатура void (void)) [SWS_Rte_89015]. Вызов обрабатывается синхронно и обозначается Service-ID 0xEE [SWS_Rte_89015]. Декларация предоставляется через заголовочный файл Rte_Rips_<PlugIn>.h [SWS_Rte_89015].

В отношении параллелизма функция объявлена как условно реентерабельная (Conditional Reentrant) [SWS_Rte_89015]. Это, по-видимому, означает, что параллельный вызов допустим только при наличии различных контекстов выполнения или раздельных экземпляров плагинов. Вопрос Q-24aabb36a2be58f4 (открытый) Идентификатор <name of the Invocation Handler>, а также обозначение заголовка <PlugIn> представляют собой заполнители; фактическое имя, вероятно, определяется при конфигурации плагина.

Функция Rte_Rips_SchM_Deinit служит для деинициализации тех компонентов RTE Implementation Plug-In, которые имеют значение для операций Basic Software Scheduler (SchM) [SWS_Rte_89019]. Она относится к обязательным интерфейсам жизненного цикла, которые должны предоставляться каждым RTE Implementation Plug-In наряду с Rte_Rips_SchM_Init, Rte_Rips_Rte_Start и Rte_Rips_Rte_Stop [SWS_Rte_70047].

Для интеграции и использования действуют следующие положения:

• Контекст вызова и выполнение: интерфейс имеет сигнатуру void Rte_Rips_SchM_Deinit (void), не принимает параметров и не возвращает значения [SWS_Rte_89019]. Он выполняется синхронно [SWS_Rte_89019]. Вызов осуществляется не программными компонентами, а координируется со стороны RTE внутри SchM_Deinit для всех задействованных плагинов [SWS_Rte_80054].
• Подключение файлов и идентификатор: объявление доступно через заголовочный файл Rte_Rips_<PlugIn>.h; функция имеет Service ID 0xF3 [SWS_Rte_89019].
• Параллелизм и ограничения: функция специфицирована как нереентерабельная (Non Reentrant) [SWS_Rte_89019]. Из этого, по всей видимости, следует, что во время вызова в SchM_Deinit никакие конкурирующие активности SchM больше не должны обращаться к плагину. Вопрос Q-60aec1abc9e891b2 (открытый)
• Обработка ошибок: спецификация не предусматривает для Rte_Rips_SchM_Deinit ни кодов ошибок, ни возвращаемых значений и не определяет сообщений об ошибках в DET или DEM [SWS_Rte_89019].

Тип данных Rte_Rips_SwitchNotificationStatusType ([SWS_Rte_91113]) основан на uint8 и предоставляется через Rte_Type.h. Он служит для сигнализации о статусе операций enqueue и dequeue в очереди режимов (Mode Queue) в контексте RTE Implementation Plug-Ins.

Диапазон значений включает коды состояния для обоих направлений операций ([SWS_Rte_91113]):

• RTE_SWITCH_NOTIFICATION_SKIP (0x00): уведомление о смене режима невозможно извлечь.
• RTE_SWITCH_NOTIFICATION_ENQUEUED_FIRST (0x01): уведомление было помещено в пустую очередь.
• RTE_SWITCH_NOTIFICATION_ENQUEUED_NOT_FIRST (0x02): уведомление было помещено в уже занятую очередь.
• RTE_SWITCH_NOTIFICATION_ENQUEUE_FAILED (0x03): сбой при постановке в непустую очередь.
• RTE_SWITCH_NOTIFICATION_DEQUEUED_LAST (0x04): последнее уведомление о смене режима было извлечено из очереди.
• RTE_SWITCH_NOTIFICATION_DEQUEUED_NOT_LAST (0x05): уведомление было извлечено; в очереди остаются другие уведомления.

При использовании данный тип фигурирует в двух синхронных реентерабельных интерфейсах: функция Rte_Rips_<PlugIn>_Switch_<BswSwcI>_<MMI> ([SWS_Rte_91114]) получает статус в качестве входного параметра switchNotificationStatus, чтобы уведомлять плагин об операциях enqueue. Напротив, функция Rte_Rips_<PlugIn>_DequeueModeSwitch_<MMI>_<OsTask> ([SWS_Rte_91115]) возвращает данный тип в качестве возвращаемого значения, когда после завершения последней On-Entry ExecutableEntity уведомление извлекается из очереди.

Ошибки при постановке в очередь функционально сообщаются через значение состояния RTE_SWITCH_NOTIFICATION_ENQUEUE_FAILED ([SWS_Rte_91113]); отдельные записи DET или DEM в полезной нагрузке не указаны. Интерпретация: текст спецификации «was enqueued from mode queue» у констант операции dequeue, вероятно, обусловлен редакционной неточностью и означает операцию извлечения. Вопрос Q-6e9e040dcd341f66 (открытый) Элемент, а также соответствующие интерфейсы помечены как черновик (Draft) ([SWS_Rte_91113]).

Тип данных Rte_DsmqStatusType основан на uint8 и согласно [SWS_Rte_80085], а также [SWS_Rte_91102] определяется вместе со своими литералами в заголовочном файле Rte_Type.h. Он служит для сигнализации о статусе операций enqueue и dequeue для уведомлений о смене режима в Distributed Shared Mode Queue (DSMQ) [SWS_Rte_91102].

Диапазон значений включает следующие литералы [SWS_Rte_91102]:

• RTE_DSMQ_ENQUEUED_FIRST (0x01): уведомление было помещено в ранее пустую DSMQ.
• RTE_DSMQ_ENQUEUED_NOT_FIRST (0x02): постановка в очередь произошла в уже заполненную (непустую) DSMQ.
• RTE_DSMQ_ENQUEUE_FAILED (0x03): постановка в очередь в непустую DSMQ завершилась сбоем.
• RTE_DSMQ_DEQUEUED_LAST (0x04): последнее уведомление о смене режима было извлечено из DSMQ.
• RTE_DSMQ_DEQUEUED_NOT_LAST (0x05): уведомление было извлечено, при этом в очереди остаются другие уведомления.

Для обработки ошибок литерал RTE_DSMQ_ENQUEUE_FAILED сигнализирует о сбое операции постановки в очередь при непустой очереди [SWS_Rte_91102].

Тип используется в качестве передаваемого параметра dsmqstatus в интерфейсах RTE Implementation Plug-In (RIPS). Функция Rte_Rips_<PlugIn>_DsmqSwitch_<BswSwcI>_<MMI> синхронно информирует плагин о постановке в очередь в DSMQ [SWS_Rte_91103]. Кроме того, Rte_Rips_<PlugIn>_DsmqTransitionEnd_<BswSwcI>_<MMI> синхронно сообщает в RIPS о завершении перехода режима в DSMQ-Transition-OsTask [SWS_Rte_91106]. Обе службы обратного вызова объявлены как синхронные и реентерабельные [SWS_Rte_91103], [SWS_Rte_91106].