FlexRay Driver (Fr)

Синхронная функция Fr_Init служит для инициализации драйвера FlexRay (Fr) согласно [SWS_Fr_00032]. Она объявлена в заголовочном файле Fr.h и имеет идентификатор службы 0x1c [SWS_Fr_00032]. В качестве единственного входного параметра интерфейс ожидает Fr_ConfigPtr типа const Fr_ConfigType* [SWS_Fr_00032]. Этот указатель ссылается на драйверозависимую конфигурационную структуру, предоставляющую всю необходимую информацию для последующей операционной работы драйвера FlexRay [SWS_Fr_00032]. Функция не имеет ни входно-выходных, ни выходных параметров и не возвращает значения (void) [SWS_Fr_00032].

Что касается параллелизма и ограничений, Fr_Init специфицирована как нереентерабельная (Non Reentrant) [SWS_Fr_00032]. Поэтому параллельные или вложенные вызовы категорически недопустимы. Поскольку переданная конфигурационная структура содержит все фундаментальные данные для дальнейшей работы, инициализация, как правило, должна выполняться последовательно на этапе запуска всей системы до вызова других служб модуля [SWS_Fr_00032]. Вопрос Q-a208c696fbb083d4 (открытый)

Обработка ошибок с помощью специальных кодов ошибок или статусных ответов в определении службы не предусмотрена [SWS_Fr_00032]. Дополнительные требования, например касающиеся уведомлений в DET или DEM, в данном наборе данных не задокументированы.

Синхронная функция Fr_ControllerInit служит для инициализации FlexRay Communication Controller (FlexRay CC) в контексте драйвера FlexRay [SWS_Fr_00017]. Она объявлена в заголовочном файле Fr.h и имеет Service-ID 0x00 [SWS_Fr_00017]. Через входной параметр Fr_CtrlIdx типа uint8 передается индекс инициализируемого контроллера [SWS_Fr_00017].

В качестве возвращаемого значения функция возвращает статус Std_ReturnType [SWS_Fr_00017]:

• E_OK: вызов API был успешно завершен [SWS_Fr_00017].
• E_NOT_OK: вызов был досрочно прерван из-за возникших ошибок [SWS_Fr_00017].

Подробные коды ошибок, а также сообщения в DET или DEM в специфицированном объеме интерфейса не приведены [SWS_Fr_00017].

Что касается параллелизма, функция классифицирована как нереентерабельная для одного и того же аппаратного узла (Non Reentrant for the same device) [SWS_Fr_00017]. Поэтому вызов для одного и того же индекса контроллера Fr_CtrlIdx не должен выполняться одновременно; параллельные же вызовы для различных контроллеров, предположительно, допустимы [SWS_Fr_00017]. Вопрос Q-5bbbba38e8530b43 (открытый) Поскольку входные и выходные параметры (inout/out) не определены, инициализация в драйвере выполняется исключительно на основе состояния [SWS_Fr_00017].

Функция Fr_StartCommunication служит для запуска связи FlexRay на указанном контроллере [SWS_Fr_00010]. Интерфейс доступен через заголовочный файл Fr.h [SWS_Fr_00010].

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

Вызов выполняется асинхронно с передачей параметра Fr_CtrlIdx (идентификатор службы 0x03), который указывает индекс коммуникационного контроллера FlexRay в контексте драйвера [SWS_Fr_00010]. В качестве возвращаемого значения функция возвращает статус типа Std_ReturnType [SWS_Fr_00010]:

• E_OK: вызов API успешно завершен [SWS_Fr_00010]. Интерпретация: в силу асинхронной семантики это, вероятно, означает успешное принятие команды запуска, тогда как само установление соединения происходит впоследствии. Вопрос Q-fabca57ea7d32a05 (открытый)
• E_NOT_OK: вызов API был прерван вследствие ошибок [SWS_Fr_00010].

Параллелизм и ограничения

Для одного и того же контроллера FlexRay функция Fr_StartCommunication специфицирована как нереентерабельная [SWS_Fr_00010]. Для различных экземпляров контроллера вызов, напротив, является реентерабельным. Специфические ошибки разработки (DET), диагностические сообщения (DEM) или дополнительные зависимости в приведенных данных спецификации отсутствуют.

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

Функция Fr_AllowColdstart служит для вызова команды Controller Host Interface ALLOW_COLDSTART на FlexRay Communication Controller [SWS_Fr_00114]. Определение предоставляется через заголовочный файл Fr.h; служба имеет идентификатор службы 0x23 [SWS_Fr_00114]. Через передаваемый параметр Fr_CtrlIdx указывается индекс адресуемого контроллера FlexRay в драйвере FlexRay [SWS_Fr_00114]. Вызов выполняется асинхронно [SWS_Fr_00114].

Обработка ошибок и возвращаемые значения

Функция возвращает статус типа Std_ReturnType [SWS_Fr_00114]:

• E_OK: вызов API успешно завершен [SWS_Fr_00114].
• E_NOT_OK: вызов API был прерван вследствие ошибок [SWS_Fr_00114].

Специфические причины ошибок или сообщения в DEM либо DET для этой службы в спецификации функции отдельно не указаны [SWS_Fr_00114].

Параллелизм и ограничения

Интерфейс не является реентерабельным для одного и того же экземпляра контроллера (Non Reentrant for the same device) [SWS_Fr_00114]. Поэтому вызовы с тем же параметром Fr_CtrlIdx не должны производиться параллельно или с прерыванием [SWS_Fr_00114]. Интерпретация: в силу асинхронной семантики выполнения возвращаемое значение E_OK, вероятно, лишь подтверждает прием CHI-команды драйвером, тогда как изменение состояния внутри контроллера происходит со смещением во времени [SWS_Fr_00114]. Вопрос Q-e5c407f32c449510 (открытый)

Использование и принцип работы

Функция Fr_AllSlots служит для отправки CHI-команды (Controller Host Interface) ALL_SLOTS адресуемому FlexRay Communication Controller [SWS_Fr_00516]. Она предоставляется через заголовочный файл Fr.h и имеет идентификатор службы 0x24 [SWS_Fr_00516].

В качестве входного параметра функция ожидает Fr_CtrlIdx, указывающий индекс соответствующего FlexRay-контроллера в контексте драйвера FlexRay [SWS_Fr_00516]. Выполнение происходит асинхронно [SWS_Fr_00516]. Возвращаемое значение E_OK сигнализирует об успешном завершении вызова API, тогда как E_NOT_OK указывает на прерывание из-за ошибок [SWS_Fr_00516]. В силу асинхронной семантики E_OK, вероятно, подтверждает лишь успешный прием или запуск CHI-команды, а не завершенную аппаратную реакцию контроллера (интерпретация). Вопрос Q-c526e3b174a4b44a (открытый)

Обработка ошибок и параллелизм

Если выполнение завершается неудачей, вызов прерывается с возвращаемым значением E_NOT_OK [SWS_Fr_00516]. Конкретные причины ошибок или сообщения DET/DEM в спецификации этого элемента не указаны.

Что касается реентерабельности, Fr_AllSlots специфицирована как нереентерабельная для одного и того же контроллера (Non Reentrant for the same device) [SWS_Fr_00516]. Поэтому вышележащие уровни должны исключать параллельные вызовы для одного и того же экземпляра контроллера. Параллельные вызовы для различных экземпляров контроллера, напротив, скорее всего допустимы (интерпретация). Вопрос (открытый)

Функция Fr_HaltCommunication служит для инициации остановки коммуникации на коммуникационном контроллере FlexRay посредством выполнения команды CC-CHI 'DEFERRED_HALT' [SWS_Fr_00014].

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

Вызов выполняется асинхронно и предоставляется через заголовочный файл Fr.h (Service-ID 0x04) [SWS_Fr_00014]:

• Fr_CtrlIdx (входной параметр): определяет индекс управляемого коммуникационного контроллера FlexRay внутри драйвера FlexRay [SWS_Fr_00014].
• Возвращаемое значение (Std_ReturnType): возвращает E_OK, если вызов функции завершился успешно, или E_NOT_OK, если вызов был прерван из-за ошибок [SWS_Fr_00014].

Параллелизм и ограничения

Что касается контекста вызова и параллелизма, Fr_HaltCommunication является нереентерабельной относительно одного и того же устройства (Non Reentrant for the same device) [SWS_Fr_00014]. Следовательно, для одного и того же индекса контроллера не допускается параллельный или перекрывающийся вызов. Вызовы же для различных экземпляров контроллера допустимы.

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

Если во время вызова возникает ошибка, функция прерывает выполнение и сигнализирует об этом через возвращаемое значение E_NOT_OK [SWS_Fr_00014]. Подробные сообщения об ошибках в объеме спецификации для данной функции не приведены.

Синхронная функция Fr_AbortCommunication прерывает текущую коммуникацию, выполняя команду интерфейса «контроллер-хост» (CHI-команду) FREEZE на указанном коммуникационном контроллере FlexRay (CC) [SWS_Fr_00011].

Вызов и параметры

Вызов осуществляется через заголовочный файл Fr.h с указанием индекса контроллера Fr_CtrlIdx, который однозначно идентифицирует целевой FlexRay CC в контексте драйвера FlexRay [SWS_Fr_00011]. Входные и выходные параметры сверх этого отсутствуют.

Возвращаемые значения и обработка ошибок

Функция возвращает статус типа Std_ReturnType [SWS_Fr_00011]:

• E_OK: вызов API был успешно завершен [SWS_Fr_00011].
• E_NOT_OK: вызов API был прерван из-за ошибок [SWS_Fr_00011].

Параллелизм и ограничения

Относительно поведения при параллелизме Fr_AbortCommunication специфицирована как нереентерабельная для одного и того же коммуникационного контроллера (Non Reentrant for the same device) [SWS_Fr_00011]. Вызывающий компонент должен избегать параллельных вызовов для одного и того же экземпляра контроллера.

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

Функция Fr_SendWUP служит для инициации процесса пробуждения на шине FlexRay посредством отправки CHI-команды WAKEUP коммуникационному контроллеру [SWS_Fr_00009]. Через параметр Fr_CtrlIdx передается индекс целевого контроллера в контексте драйвера [SWS_Fr_00009]. Вызов выполняется асинхронно: интерфейс запускает команду, в то время как передача шаблона пробуждения затем выполняется на аппаратном уровне [SWS_Fr_00009]. Определение доступно через Fr.h, и служба имеет идентификатор службы 0x06 [SWS_Fr_00009].

Обработка ошибок и возвращаемые значения

Функция возвращает значение состояния типа Std_ReturnType [SWS_Fr_00009]:

• E_OK: вызов API был успешно выполнен, и CHI-команда отправлена [SWS_Fr_00009].
• E_NOT_OK: вызов API был прерван из-за возникших ошибок [SWS_Fr_00009].

Параллелизм и ограничения

Функция специфицирована как нереентерабельная для одного и того же устройства (Non Reentrant for the same device) [SWS_Fr_00009]. Интерпретация: по всей видимости, это означает, что вышестоящие модули должны синхронизировать одновременные вызовы для одного и того же экземпляра контроллера, тогда как вызовы для различных экземпляров контроллера могут выполняться параллельно. Вопрос Q-0e3b4e70a0755877 (открытый) Не определены ни входные/выходные параметры, ни чисто выходные параметры [SWS_Fr_00009].

Функция Fr_TransmitTxLPdu служит для передачи полезных данных по сети FlexRay [SWS_Fr_00092]. Она обрабатывает запрос на передачу с асинхронной семантикой и сопоставляет передаваемую LSdu с кадром FlexRay, идентифицируемым через Fr_LPduIdx [SWS_Fr_00092].

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

Вызов осуществляется через заголовочный файл Fr.h (Service-ID 0x0b) с указанием индекса контроллера Fr_CtrlIdx для FlexRay Communication Controller, а также однозначного индекса кадра Fr_LPduIdx [SWS_Fr_00092]. Через указатель Fr_LSduPtr передается подготовленная в буфере передаваемая LSdu, длина данных которой в байтах задается через Fr_LSduLength [SWS_Fr_00092]. Через выходной параметр Fr_SlotAssignmentPtr вызывающая сторона может запросить фактический цикл передачи, Slot-ID и канал FlexRay; если эта информация не требуется, вместо этого может быть передан NULL_PTR [SWS_Fr_00092].

Возвращаемые значения и обработка ошибок

Функция квитирует вызов типом возврата Std_ReturnType: возвращаемое значение E_OK подтверждает успешное завершение вызова API, тогда как E_NOT_OK сигнализирует о прерывании из-за ошибок [SWS_Fr_00092]. Специфические сообщения DET или DEM в данных спецификации не содержатся.

Параллелизм

Что касается параллелизма, Fr_TransmitTxLPdu специфицирована как нереентерабельная для одного и того же устройства (Non Reentrant for the same device) [SWS_Fr_00092]. Поэтому параллельные вызовы передачи для одного и того же контроллера FlexRay недопустимы.

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

Синхронная функция Fr_CancelTxLPdu прерывает уже ожидающую передачу L-PDU, которая находится в физическом ресурсе передачи контроллера (например, в буфере передачи) [SWS_Fr_00610]. Функция объявлена в заголовочном файле Fr.h и имеет Service ID 0x2d [SWS_Fr_00610].

Для идентификации прерываемой передачи интерфейс ожидает два параметра [SWS_Fr_00610]:

• Fr_CtrlIdx: индекс FlexRay Communication Controller в контексте драйвера FlexRay [SWS_Fr_00610].
• Fr_LPduIdx: уникальный индекс для идентификации соответствующего кадра FlexRay [SWS_Fr_00610].

Возвращаемые значения и обработка ошибок

Вызов функции возвращает значение состояния типа Std_ReturnType [SWS_Fr_00610]:

• E_OK: вызов API был успешно завершен [SWS_Fr_00610].
• E_NOT_OK: вызов был прерван из-за ошибок [SWS_Fr_00610].

Специфические коды ошибок, записи DET или DEM для этой функции не задокументированы; при возникновении ошибки функция сообщает о ней исключительно через возвращаемое значение E_NOT_OK [SWS_Fr_00610].

Параллелизм и ограничения

В отношении параллелизма Fr_CancelTxLPdu определена как нереэнтерабельная для одного и того же устройства (Non Reentrant for the same device) [SWS_Fr_00610]. Это, вероятно, означает, что параллельные вызовы для одного и того же экземпляра контроллера должны синхронизироваться на уровне вызывающей стороны. Вопрос Q-ec480944eec04076 (открытый) Другие входные или выходные параметры отсутствуют [SWS_Fr_00610].

Синхронная функция Fr_ReceiveRxLPdu служит для приема полезных данных из сети FlexRay и доступна через заголовочный файл Fr.h [SWS_Fr_00093].

Параметры и использование

Через входные параметры Fr_CtrlIdx и Fr_LPduIdx однозначно адресуются соответствующий коммуникационный контроллер драйвера FlexRay, а также принимаемый кадр FlexRay [SWS_Fr_00093]. Полезные данные и данные о состоянии передаются вызывающей стороне через несколько указателей:

• Fr_LSduPtr: указатель на буфер, в котором должна быть сохранена принятая L-SDU.
• Fr_LPduStatusPtr: указатель на область памяти для статуса приема L-PDU.
• Fr_LSduLengthPtr: область памяти для длины принятой L-SDU в байтах, соответствующая количеству байтов, скопированных в Fr_LSduPtr.
• Fr_SlotAssignmentPtr: область памяти для цикла, Slot-ID и канала кадра. Если в качестве этого параметра передается NULL_PTR, это указывает на то, что вызывающей стороне эта информация о назначении не требуется.

Параллелизм и обработка ошибок

Интерфейс выполняется синхронно, однако является нереентерабельным для одного и того же устройства [SWS_Fr_00093]. Успешная операция приема квитируется значением E_OK, тогда как при возникновении ошибок вызов прерывается и возвращается E_NOT_OK [SWS_Fr_00093]. Специфические коды ошибок DET или DEM в данных спецификации функции не указаны.

Синхронный интерфейс Fr_CheckTxLPduStatus (Service-ID 0x0d) служит согласно [SWS_Fr_00094] для проверки текущего статуса передачи L-SDU или кадра FlexRay в драйвере FlexRay. Он предоставляется через заголовочный файл Fr.h.

В качестве входных параметров функция требует индекс коммуникационного контроллера FlexRay (Fr_CtrlIdx), а также индекс Fr_LPduIdx, который однозначно идентифицирует проверяемый кадр FlexRay в драйвере [SWS_Fr_00094]. Определенный статус передачи LPdu записывается обратно по переданному адресу памяти через выходной параметр Fr_TxLPduStatusPtr [SWS_Fr_00094].

Кроме того, выходной параметр Fr_SlotAssignmentPtr позволяет определить назначение слота: он указывает на ячейку памяти, в которую помещаются фактический цикл, Slot-ID и канал адресуемого кадра [SWS_Fr_00094]. Если вызывающей стороне эта информация о назначении не требуется, передача NULL_PTR сигнализирует о том, что эти данные предоставлять не нужно [SWS_Fr_00094].

Интерфейс должен выполняться синхронно и специфицирован как нереентерабельный для одного и того же устройства (Non Reentrant for the same device) [SWS_Fr_00094]. При успешном завершении вызов возвращает возвращаемое значение E_OK; в случае возникших ошибок функция прерывается и возвращает E_NOT_OK [SWS_Fr_00094].

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

Синхронная функция Fr_PrepareLPdu служит согласно [SWS_Fr_00107] для подготовки L-PDU (Prepares a LPdu) и предоставляется через заголовочный файл Fr.h. В качестве входных параметров служба ожидает индекс контроллера Fr_CtrlIdx для адресации FlexRay Communication Controller (CC) в контексте драйвера, а также Fr_LPduIdx для однозначной идентификации соответствующего FlexRay-фрейма [SWS_Fr_00107]. Интерпретация: вызов, вероятно, инициализирует или переводит в состояние готовности аппаратно-зависимые структуры буферов для последующей передачи или приема фрейма. Вопрос Q-c4375099d73dbea2 (открытый)

Параллелизм и ограничения

Что касается параллелизма, Fr_PrepareLPdu специфицирована как нереентерабельная для одного и того же аппаратного узла (Non Reentrant for the same device) [SWS_Fr_00107]. Поэтому вызывающий компонент обязан строго исключать параллельный или прерывающий вызов для одного и того же индекса контроллера Fr_CtrlIdx.

Возвращаемые значения и обработка ошибок

Функция имеет идентификатор службы 0x1f и возвращает свой статус через возвращаемый тип Std_ReturnType [SWS_Fr_00107]:

• E_OK: вызов API успешно завершен [SWS_Fr_00107].
• E_NOT_OK: вызов API был преждевременно прерван из-за возникших ошибок [SWS_Fr_00107]. Конкретные коды ошибок DET или DEM в данном фрагменте спецификации не определены.

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

Синхронная функция Fr_ReconfigLPdu обеспечивает динамическую реконфигурацию FlexRay LPDU во время выполнения [SWS_Fr_00524]. Предоставляемая через заголовочный файл Fr.h, при вызове она адресует через Fr_CtrlIdx соответствующий контроллер FlexRay, а через Fr_LPduIdx — уникальный идентификатор кадра AUTOSAR_SWS_FlexRayDriver с. 65.

При реконфигурации передаются следующие целевые параметры [SWS_Fr_00524]:

• Fr_FrameId и Fr_ChnlIdx: определение нового ID кадра, а также канала связи.
• Fr_CycleRepetition и Fr_CycleOffset: настройка фильтрации циклов для LPDU.
• Fr_PayloadLength и Fr_HeaderCRC: длина полезных данных в байтах, а также соответствующая CRC заголовка кадра.

Параллелизм и возвращаемые значения

Служба не является реэнтерабельной для одного и того же контроллера (Non Reentrant for the same device) [SWS_Fr_00524]. При вызовах для различных экземпляров контроллера FlexRay реэнтерабельность, напротив, должна обеспечиваться (интерпретация). Вопрос Q-85908ef4796c80c7 (открытый) При успешной переконфигурации вызов возвращает E_OK; если реконфигурация завершается сбоем из-за ошибок, возвращается E_NOT_OK AUTOSAR_SWS_FlexRayDriver с. 65.

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

Синхронная функция драйвера Fr_DisableLPdu служит для деактивации аппаратного ресурса FlexRay-LPdu для передачи или приема ([SWS_Fr_00539]). Интерфейс предоставляется через заголовочный файл Fr.h и назначен идентификатору службы 0x26 ([SWS_Fr_00539]).

Для вызова функции необходимо передать два обязательных параметра ([SWS_Fr_00539]):

• Fr_CtrlIdx: индекс FlexRay Communication Controller в контексте драйвера.
• Fr_LPduIdx: уникальный индекс для идентификации соответствующего FlexRay-фрейма или LPdu.

В качестве возвращаемого значения функция возвращает статус Std_ReturnType ([SWS_Fr_00539]). Значение E_OK свидетельствует об успешно завершенном вызове, тогда как E_NOT_OK возвращается в случае, если вызов был прерван из-за ошибки.

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

В настоящей спецификации для этой службы не определены специальные коды ошибок, а также сообщения в DET или DEM; ошибочное поведение непосредственно выражается в возвращаемом значении E_NOT_OK ([SWS_Fr_00539]).

Параллелизм и ограничения

Что касается реентерабельности, Fr_DisableLPdu классифицирована как нереентерабельная для одного и того же устройства (Non Reentrant for the same device) ([SWS_Fr_00539]). Поэтому вызывающие стороны должны гарантировать, что одновременные вызовы для одного и того же контроллера будут синхронизированы.

Синхронная функция Fr_CancelAbsoluteTimer служит для корректной остановки активного абсолютного таймера на FlexRay Communication Controller ([SWS_Fr_00095]). Она предоставляется через заголовочный файл Fr.h и имеет Service-ID 0x13 ([SWS_Fr_00095]).

Параметры и возвращаемое значение

• Fr_CtrlIdx: передает индекс соответствующего FlexRay Communication Controller в контексте драйвера FlexRay ([SWS_Fr_00095]).
• Fr_AbsTimerIdx: определяет индекс останавливаемого абсолютного таймера в контексте выбранного контроллера FlexRay ([SWS_Fr_00095]).
• Возвращаемое значение: передает через тип Std_ReturnType статус E_OK при успешном выполнении или E_NOT_OK, если вызов был прерван из-за ошибок ([SWS_Fr_00095]).

Параллелизм и ограничения

Что касается параллелизма, интерфейс определен для одного и того же устройства как нереентерабельный («Non Reentrant for the same device») ([SWS_Fr_00095]). Вызывающие уровни должны гарантировать отсутствие конкурирующих или прерывающих обращений для одного и того же контроллера. Интерпретация: при различных контроллерах выполнение, напротив, предположительно допустимо в реентерабельном режиме. Вопрос Q-01203b0b28193021 (открытый)

Синхронная функция Fr_EnableAbsoluteTimerIRQ служит для активации линии прерывания абсолютного таймера внутри FlexRay Communication Controller [SWS_Fr_00034]. Служба предоставляется через заголовочный файл Fr.h и имеет идентификатор службы 0x15 [SWS_Fr_00034].

При вызове интерфейс ожидает два входных параметра [SWS_Fr_00034]:

• Fr_CtrlIdx: индекс FlexRay Communication Controller в контексте драйвера FlexRay [SWS_Fr_00034].
• Fr_AbsTimerIdx: индекс абсолютного таймера в контексте адресуемого контроллера FlexRay [SWS_Fr_00034].

Возвращаемое значение типа Std_ReturnType сигнализирует о результате выполнения [SWS_Fr_00034]:

• E_OK: вызов API был успешно завершен [SWS_Fr_00034].
• E_NOT_OK: вызов функции был прерван из-за ошибок [SWS_Fr_00034].

В отношении параллельного выполнения функция специфицирована как нереентерабельная для одного и того же устройства («Non Reentrant for the same device») [SWS_Fr_00034]. Это требует обязательного предотвращения одновременных вызовов для одного и того же экземпляра контроллера; предположительно, параллельный вызов для различных экземпляров контроллера, однако, допустим. Вопрос Q-d7e594a84357e129 (открытый) Специфические коды ошибок для ошибок разработки или производства (DET/DEM) в описании функции не приводятся; возникшие ошибки непосредственно приводят к возврату E_NOT_OK [SWS_Fr_00034].

Синхронная функция Fr_AckAbsoluteTimerIRQ относится к модулю драйвера FlexRay (Fr) на платформе AUTOSAR Classic и служит для сброса условия прерывания абсолютного таймера [SWS_Fr_00036]. Объявление интерфейса предоставляется через заголовочный файл Fr.h и сопоставлено с шестнадцатеричным Service-ID 0x17 [SWS_Fr_00036].

Для однозначной адресации таймера функция ожидает два входных параметра типа uint8, тогда как параметры ввода-вывода или чисто выходные параметры отсутствуют [SWS_Fr_00036]:

• Fr_CtrlIdx: передает индекс FlexRay Communication Controller (CC) в контексте драйвера FlexRay [SWS_Fr_00036].
• Fr_AbsTimerIdx: обозначает индекс абсолютного таймера в контексте соответствующего FlexRay Communication Controller [SWS_Fr_00036].

Результат выполнения функции возвращается через значение статуса типа Std_ReturnType. Если вызов завершился успешно, функция возвращает E_OK [SWS_Fr_00036]. Если во время выполнения возникают ошибки, вызов функции досрочно прерывается и возвращает вместо этого E_NOT_OK [SWS_Fr_00036].

Что касается поведения при параллелизме, сервис классифицирован как нереентерабельный для одного и того же устройства (Non Reentrant for the same device) [SWS_Fr_00036]. Поэтому вызовы для одного и того же экземпляра контроллера должны осуществляться синхронно и не должны выполняться с параллельным перекрытием [SWS_Fr_00036].

Синхронная функция Fr_DisableAbsoluteTimerIRQ служит в драйвере FlexRay для целенаправленного отключения линии прерывания абсолютного таймера [SWS_Fr_00035]. В качестве входных параметров интерфейс ожидает индекс контроллера Fr_CtrlIdx для адресации соответствующего коммуникационного контроллера FlexRay (CC) в контексте драйвера, а также Fr_AbsTimerIdx для идентификации абсолютного таймера внутри этого контроллера [SWS_Fr_00035]. Объявление функции предоставляется через заголовочный файл Fr.h [SWS_Fr_00035].

Результат выполнения передается вызывающей стороне синхронно через возвращаемый тип Std_ReturnType [SWS_Fr_00035]. Если сервис удалось завершить корректно и успешно, он возвращает E_OK [SWS_Fr_00035]. Если же во время обработки возникают ошибки, функция прерывает операцию и сигнализирует об этом возвращаемым значением E_NOT_OK [SWS_Fr_00035]. Конкретные ошибки разработки или времени выполнения (DET/DEM) в элементе спецификации не указаны, поэтому состояния ошибок должны распознаваться и обрабатываться преимущественно на основе возвращаемого значения [SWS_Fr_00035].

Что касается параллелизма, Fr_DisableAbsoluteTimerIRQ определена как нереентерабельная для одного и того же устройства (same device) [SWS_Fr_00035]. Поэтому несколько вызовов для одного и того же индекса контроллера не должны выполняться параллельно и должны синхронизироваться на стороне вызывающей программы, тогда как параллельный доступ к различным контроллерам разрешен [SWS_Fr_00035].

Синхронная функция Fr_ReadCCConfig считывает определенный параметр конфигурации протокола FlexRay контроллера непосредственно из конфигурации модуля драйвера FlexRay [SWS_Fr_00651]. Интерфейс объявляется через заголовочный файл Fr.h и имеет Service ID 0x2e [SWS_Fr_00651].

Параметры и возвращаемые значения

• Fr_CtrlIdx: определяет индекс соответствующего коммуникационного контроллера FlexRay в контексте драйвера [SWS_Fr_00651].
• Fr_ConfigParamIdx: идентифицирует считываемый параметр через определенные макросы формата FR_CIDX_<config_parameter_name> [SWS_Fr_00651].
• Fr_ConfigParamValuePtr: указатель на адрес памяти типа uint32, по которому записывается считанное значение [SWS_Fr_00651].
• Возвращаемое значение: возвращает E_OK при успешном выполнении или E_NOT_OK в случае ошибки [SWS_Fr_00651].

Параллелизм и поведение при ошибках

Функция разработана как нереэнтерабельная для одного и того же контроллера («Non Reentrant for the same device») [SWS_Fr_00651]. Таким образом, одновременные вызовы для различных экземпляров контроллера должны быть допустимы. Вопрос Q-b5e4172654514747 (открытый) Специфические ошибки DET или DEM в определении интерфейса не указаны; ошибочные состояния приводят к прерыванию с возвратом E_NOT_OK [SWS_Fr_00651]. Вызывающая сторона, вероятно, должна гарантировать, что Fr_ConfigParamValuePtr указывает на действительную область памяти.

Перечислимый тип Fr_SlotModeType является частью определения интерфейса драйвера FlexRay в AUTOSAR Classic и предоставляется через заголовочный файл Fr_GeneralTypes.h [SWS_Fr_00506]. Определение типа формально ссылается на тип T_SlotMode из спецификации протокола FlexRay, где он описан в главе, посвященной Protocol Operation Control (статус POC) [SWS_Fr_00506].

Перечисление специфицирует состояние обработки слотов контроллера с помощью трех фиксированно определенных значений [SWS_Fr_00506]:

• FR_SLOTMODE_KEYSLOT (значение 0x00): отображает литерал KEYSLOT формального определения типа T_SlotMode [SWS_Fr_00506].
• FR_SLOTMODE_ALL_PENDING (значение 0x01): отображает литерал ALL_PENDING формального определения типа T_SlotMode [SWS_Fr_00506].
• FR_SLOTMODE_ALL (значение 0x02): отображает литерал ALL формального определения типа T_SlotMode [SWS_Fr_00506].

При использовании с контроллерами, соответствующими более старому стандарту FlexRay 2.1 Rev A, необходимо учитывать отличающееся именование: вместо литерала KEYSLOT здесь используется литерал SINGLESLOT [SWS_Fr_00506]. Интерпретация: на уровне драйвера и программного обеспечения тип, предположительно, служит для определения того, разрешил ли контроллер FlexRay в данный момент только ключевые слоты (Key Slots) или все слоты для передачи, либо предстоит соответствующее переключение. Вопрос Q-f926c41c8a5d3380 (открытый)

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

Перечислимый тип Fr_ErrorModeType отображает режимы ошибок FlexRay Protocol Operation Control (POC) и предоставляется через заголовочный файл Fr_GeneralTypes.h [SWS_Fr_00507]. Перечисление определяет состояния механизма мониторинга ошибок коммуникационного контроллера и ссылается на формальное определение типа T_ErrorMode в статусе FlexRay POC [SWS_Fr_00507].

Диапазон значений согласно [SWS_Fr_00507] охватывает три состояния:

• FR_ERRORMODE_ACTIVE (0x00): представляет литерал ACTIVE формального определения типа T_ErrorMode и обозначает безошибочное состояние или нормальный режим работы коммуникационного контроллера.
• FR_ERRORMODE_PASSIVE (0x01): соответствует литералу PASSIVE формального определения типа T_ErrorMode, при котором на шине были зарегистрированы ошибки и коммуникация может быть ограничена.
• FR_ERRORMODE_COMM_HALT (0x02): отображает литерал COMM_HALT формального определения типа T_ErrorMode, когда коммуникация по шине была остановлена из-за тяжелых ошибочных состояний.

Интеграция и граничные условия

Интерпретация: тип, вероятно, служит прежде всего в качестве возвращаемого значения или статусного параметра в функциях опроса драйвера FlexRay, чтобы передавать вышестоящим программным уровням состояние контроллера. Вопрос Q-e4d6ae534d1dfa2c (открытый) Поскольку [SWS_Fr_00507] специфицирует исключительно структуру данных, на уровне типа отсутствуют самостоятельные обработки ошибок через DET или DEM, а также прямые требования к реентерабельности или параллелизму.

Перечислимый тип Fr_WakeupStatusType предоставляется через заголовочный файл Fr_GeneralTypes.h и отображает статус Wakeup драйвера FlexRay в соответствии с формальным определением T_WakeupStatus из статуса POC [SWS_Fr_00508].

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

Тип представляет различные состояния и события во время процесса пробуждения FlexRay и включает семь специфических значений перечисления [SWS_Fr_00508]:

• FR_WAKEUP_UNDEFINED (0x00): соответствует литералу UNDEFINED формального определения типа [SWS_Fr_00508].
• FR_WAKEUP_RECEIVED_HEADER (0x01): обозначает прием заголовка Wakeup (литерал RECEIVED_HEADER) [SWS_Fr_00508].
• FR_WAKEUP_RECEIVED_WUP (0x02): представляет принятый шаблон Wakeup (литерал RECEIVED_WUP) [SWS_Fr_00508].
• FR_WAKEUP_COLLISION_HEADER (0x03): указывает на коллизию при принятом заголовке (литерал COLLISION_HEADER) [SWS_Fr_00508].
• FR_WAKEUP_COLLISION_WUP (0x04): сигнализирует о коллизии во время шаблона Wakeup (литерал COLLISION_WUP) [SWS_Fr_00508].
• FR_WAKEUP_COLLISION_UNKNOWN (0x05): описывает коллизию с неизвестной причиной (литерал COLLISION_UNKNOWN) [SWS_Fr_00508].
• FR_WAKEUP_TRANSMITTED (0x06): подтверждает успешную отправку сигнала Wakeup (литерал TRANSMITTED) [SWS_Fr_00508].

Взаимодействие и ограничения

Интерпретация: данный тип, предположительно, служит в первую очередь статусным параметром функций драйвера, чтобы предоставить вышестоящим модулям возможность точной диагностики состояния канала и пробуждения. Вопрос Q-48907418bc3729a1 (открытый) Поскольку спецификация не определяет специфических кодов ошибок или ограничений параллелизма для самого типа, его использование подчиняется соглашениям о вызовах соответствующих опрашивающих функций API [SWS_Fr_00508].

Тип перечисления Fr_StartupStateType предоставляется согласно [SWS_Fr_00509] через заголовочный файл Fr_GeneralTypes.h и отображает состояния запуска протокольного контроллера FlexRay (статус POC) на стандартизированные значения. Определение ссылается на формальное определение типа T_StartupState из главы 2.2.1.3 спецификации.

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

• FR_STARTUP_UNDEFINED (0x00): представляет неопределенное состояние запуска.
• от FR_STARTUP_COLDSTART_LISTEN (0x01) до FR_STARTUP_COLDSTART_GAP (0x09): представляют фазы холодного старта, включая фазу прослушивания, проверку целостности, разрешение коллизий и присоединение (Coldstart Join).
• FR_STARTUP_INTEGRATION_LISTEN (0x06), FR_STARTUP_INITIALIZE_SCHEDULE (0x07) и FR_STARTUP_INTEGRATION_CONSISTENCY_CHECK (0x08): представляют шаги интеграции и инициализации в расписании.
• FR_STARTUP_EXTERNAL_STARTUP (0x0A): представляет запуск с внешним управлением.

Интегрирующие программные модули используют этот тип (интерпретация: прежде всего для запроса статуса или мониторинга запуска контроллера). Вопрос Q-7d07faa6c48d4e58 (открытый) Поскольку Fr_StartupStateType является исключительно определением типа, никакие коды ошибок или сообщения об ошибках непосредственно не генерируются; однако обрабатывающие стороны должны учитывать, что значения вне диапазона от 0x00 до 0x0A не специфицированы.

Тип данных Fr_POCStatusType специфицирован как структура данных и предоставляется через заголовочный файл Fr_GeneralTypes.h [SWS_Fr_00510]. Формальное определение ссылается на описание типа T_POCStatus в главе 2.2.1.3 (POC status) спецификации протокола FlexRay [SWS_Fr_00510].

Использование и состав структуры

Структура агрегирует текущее рабочее состояние и состояние протокола FlexRay Protocol Operation Control (POC) [SWS_Fr_00510]. Она состоит из следующих элементов:

• State (тип Fr_POCStateType) и StartupState (тип Fr_StartupStateType) для указания текущего состояния POC, а также статуса запуска [SWS_Fr_00510].
• ErrorMode (тип Fr_ErrorModeType) и Freeze (тип boolean) для обозначения режима ошибки и останова контроллера [SWS_Fr_00510].
• SlotMode (тип Fr_SlotModeType) и WakeupStatus (тип Fr_WakeupStatusType) для режима работы со слотами и статуса пробуждения [SWS_Fr_00510].
• CHIHaltRequest, CHIReadyRequest, а также ColdstartNoise (каждый boolean) для сигнализации требований хост-интерфейса или шума в линии во время холодного старта [SWS_Fr_00510].

Параллелизм и интеграция

Интерпретация: поскольку Fr_POCStatusType является исключительно структурой данных без собственной функциональной логики, она, по всей видимости, выступает преимущественно в качестве выходного параметра при запросах статуса оборудования FlexRay. Вопрос Q-960f2475ff1068fc (открытый) Если несколько задач или уровней программного обеспечения обращаются к экземплярам этой структуры, вызывающие стороны должны самостоятельно позаботиться о надлежащей синхронизации, чтобы обеспечить согласованное считывание связанных подсостояний [SWS_Fr_00510].

Перечислимый тип Fr_TxLPduStatusType служит на платформе AUTOSAR Classic для определения того, была ли LPdu FlexRay (Link Layer Protocol Data Unit) успешно передана или нет [SWS_Fr_00511]. Определение типа предоставляется через заголовочный файл Fr_GeneralTypes.h для программных модулей [SWS_Fr_00511].

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

• FR_TRANSMITTED (0x00): LPdu была успешно передана по шине [SWS_Fr_00511].
• FR_TRANSMITTED_CONFLICT (0x01): Во время передачи возник конфликт [SWS_Fr_00511].
• FR_NOT_TRANSMITTED (0x02): LPdu не была передана [SWS_Fr_00511].

С точки зрения взаимодействия и контекста вызова это значение состояния обычно может использоваться вышележащими уровнями для запроса состояния буфера передачи в драйвере FlexRay (интерпретация). Вопрос Q-347a88512db1f006 (открытый) Специфические коды ошибок, подпрограммы обработки ошибок, а также сообщения DET или DEM для данного типа данных в спецификациях не предусмотрены, поскольку он представляет собой чистое объявление типа [SWS_Fr_00511].

Тип перечисления Fr_RxLPduStatusType является частью модуля AUTOSAR Classic Fr и предоставляется через заголовочный файл Fr_GeneralTypes.h [SWS_Fr_00512]. Он служит для определения того, была ли принята L-PDU (FlexRay Link Layer PDU) или нет [SWS_Fr_00512].

Тип определяет три дискретных значения состояния для оценки статуса приема [SWS_Fr_00512]:

• FR_RECEIVED (0x00): L-PDU была успешно принята [SWS_Fr_00512].
• FR_NOT_RECEIVED (0x01): L-PDU не была принята [SWS_Fr_00512].
• FR_RECEIVED_MORE_DATA_AVAILABLE (0x02): L-PDU была принята, и доступны дальнейшие экземпляры этой L-PDU, как это происходит при использовании приемных FIFO [SWS_Fr_00512].

При работе на прием через буферные структуры тип не только различает наличие принятых данных, но и дополнительно сигнализирует в режиме FIFO о наличии последующих экземпляров [SWS_Fr_00512]. Предположительно, это указывает вызывающей стороне на то, что после считывания текущего экземпляра из FIFO можно сразу же извлечь последующие данные [SWS_Fr_00512]. Вопрос Q-0ab7cac72ff7f549 (открытый)

Структура Fr_SlotAssignmentType служит для хранения информации о сопоставлении кадра FlexRay с циклом связи и ID слота [SWS_Fr_91002]. Она определена в заголовочном файле Fr_GeneralTypes.h и объединяет все параметры адресации, необходимые для передачи или приема кадра на канале FlexRay [SWS_Fr_91002].

Структура включает в себя следующие элементы [SWS_Fr_91002]:

• Cycle (тип uint8): обозначает цикл, в котором передается или принимается кадр FlexRay [SWS_Fr_91002].
• SlotId (тип uint16): обозначает уникальный ID слота кадра в схеме связи FlexRay [SWS_Fr_91002].
• channelId (тип Fr_ChannelType): указывает канал FlexRay, по которому осуществляется передача или прием [SWS_Fr_91002].

Поскольку Fr_SlotAssignmentType представляет собой чистую структуру данных, она не имеет собственной семантики выполнения, такой как синхронность или реэнтерабельность, и сама по себе не генерирует сообщений об ошибках DET или DEM [SWS_Fr_91002]. Согласованность содержащихся значений цикла, слота и канала, вероятно, относится к зоне ответственности использующих ее функций драйвера (интерпретация). Вопрос Q-77f88375e544e298 (открытый)