LIN Transceiver Driver (LinTrcv)

LIN Transceiver Driver управляет физическим приемопередатчиком LIN канала и развязывает LinIf с аппаратным обеспечением. Согласно LinTrcv_Init, исходным режимом является SLEEP. LinTrcv_SetOpMode переключает между NORMAL, STANDBY и SLEEP и возвращает E_NOT_OK при неудачном переключении [SWS_LinTrcv_00002]. Внешние пробуждения обнаруживаются через ICU и регистрируются, когда LinIf вызывает LinTrcv_CheckWakeup. В R20-11 E_OK при этом означает «Wakeup обнаружен» [SWS_LinTrcv_00012]. Время ожидания для смены состояния должно реализовываться с помощью Tm_BusyWait1us16bit.

больше ›

LIN Transceiver Driver управляет физическим приемопередатчиком LIN канала и отделяет интерфейс LIN от аппаратного обеспечения. LinIf вызывает его сервисы напрямую: например, LinIf_SetTrcvMode вызывает LinTrcv_SetOpMode и возвращает его результат без изменений [SWS_LinTrcv_00002] LinIf-SWS с. 90. Программные и аппаратные состояния разделены. То, какие аппаратные состояния охватывает программный режим, определяется реализацией LinTrcv-SWS с. 16.

Драйвер поддерживает режимы LINTRCV_TRCV_MODE_NORMAL, LINTRCV_TRCV_MODE_STANDBY и LINTRCV_TRCV_MODE_SLEEP [SWS_LinTrcv_00168]. После включения питания он неактивен. LinTrcv_Init активирует его с набором конфигурации [SWS_LinTrcv_00001], исходным режимом является SLEEP LinTrcv-SWS с. 1. STANDBY является опциональным и может быть чисто внутренним состоянием LinTrcv-SWS Рис. 7.1 с. 15.

Диаграмма состояний: жизненный цикл от Power-On через LinTrcv_Init до смены режимов с помощью LinTrcv_SetOpMode. Опциональные переходы реконструированы (интерпретация). Источники: LinTrcv-SWS Рис. 7.1 с. 15 [SWS_LinTrcv_00168]

Внешние события пробуждения драйвер обнаруживает не через собственную ISR, а через ICU LinTrcv-SWS с. 17. LinIf опрашивает их с помощью LinTrcv_CheckWakeup. В R20-11 E_OK при этом означает «Wakeup обнаружен» [SWS_LinTrcv_00012]. В более поздних релизах это определяется иначе. Обнаруженное пробуждение передается через LinIf_WakeupConfirmation [SWS_LinTrcv_91002]. LinTrcv_SetWakeupMode разрешает уведомление, блокирует его или удаляет сохраненные события [SWS_LinTrcv_00169].

Диаграмма последовательности: внешнее пробуждение от обнаружения с помощью ICU через LinTrcv_CheckWakeup и LinIf_WakeupConfirmation до опроса причины. Источники: [SWS_LinTrcv_00012] [SWS_LinTrcv_91002] LinTrcv-SWS с. 17

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

• Время ожидания при смене состояния должно реализовываться с помощью Tm_BusyWait1us16bit [SWS_LinTrcv_00171].
• В многоядерных системах LinTrcvChannel и LinChannel одного канала должны ссылаться на один и тот же раздел [SWS_LinTrcv_00177].
• При нарушении связи с приемопередатчиком запросы возвращают E_NOT_OK LinTrcv-SWS с. 26.

Коды ошибок DET подтверждены только из более поздних релизов. Поскольку в R21-11 коды ошибок были скорректированы, их имена в R20-11 могут отличаться LinTrcv-SWS с. 1.

больше ›

Роль между интерфейсом LIN и компонентом приемопередатчика

LIN Transceiver Driver (LinTrcv) инкапсулирует управление физическим приемопередатчиком LIN. Его интерфейс состоит из семи сервисов:

• Инициализация с помощью LinTrcv_Init [SWS_LinTrcv_00001]
• Смена режима с помощью LinTrcv_SetOpMode [SWS_LinTrcv_00002]
• Опрос режима с помощью LinTrcv_GetOpMode [SWS_LinTrcv_00005]
• Запрос причины пробуждения с помощью LinTrcv_GetBusWuReason [SWS_LinTrcv_00007]
• Управление уведомлением о пробуждении с помощью LinTrcv_SetWakeupMode [SWS_LinTrcv_00009]
• Проверка пробуждения с помощью LinTrcv_CheckWakeup [SWS_LinTrcv_00012]
• Запрос версии с помощью LinTrcv_GetVersionInfo [SWS_LinTrcv_00008]

Все сервисы являются синхронными. Программные состояния драйвера отделены от аппаратных состояний компонента. Компонент может иметь больше переходов, чем драйвер. То, какие аппаратные состояния охватывает программное состояние, определяется реализацией. Однако она должна полностью обеспечивать описанную функциональность LinTrcv-SWS с. 16.

Вышестоящим пользователем, подтвержденным в полезной нагрузке, является интерфейс LIN (LinIf). Сервисы LinIf вызывают соответствующий сервис LinTrcv:

• LinIf_SetTrcvMode вызывает LinTrcv_SetOpMode и возвращает его возвращаемое значение без изменений LinIf-SWS с. 90.
• LinIf_GetTrcvMode вызывает LinTrcv_GetOpMode LinIf-SWS с. 91.
• LinIf_GetTrcvWakeupReason вызывает LinTrcv_GetBusWuReason LinIf-SWS с. 92.
• LinIf_SetTrcvWakeupMode вызывает LinTrcv_SetWakeupMode LinIf-SWS с. 93.

Типы LinTrcv_TrcvModeType и LinTrcv_TrcvWakeupModeType доступны через Lin_GeneralTypes.h [SWS_LinTrcv_00168] [SWS_LinTrcv_00169]. LinIf использует их напрямую в своих сигнатурах. Ранее существовавший собственный тип LinIf_TrcvModeType был заменен в версии 3.1.5 на LinTrcv_TrcvModeType LinIf-SWS с. 4.

На нижнем уровне драйвер использует следующие сервисы:

• сервисы чтения и записи из Dio, Det_ReportError и EcuM_SetWakeupEvent [SWS_LinTrcv_91003]
• типы из Dio, Spi, Icu и EcuM [SWS_LinTrcv_91001]
• Icu_EnableNotification и Icu_DisableNotification для уведомления о пробуждении LinTrcv-SWS с. 17
• сервис времени Tm_BusyWait1us16bit для задержек ожидания при смене состояния [SWS_LinTrcv_00171]

Обнаруженные пробуждения драйвер сообщает в LinIf через LinIf_WakeupConfirmation [SWS_LinTrcv_91002]. После этого LinIf устанавливает флаг пробуждения соответствующего канала LinIf-SWS с. 98.

Контекстная диаграмма: LinTrcv располагается между LinIf и низкоуровневыми сервисами Dio/Spi, Icu и Tm и передает уведомления о пробуждениях обратно в LinIf. Источники: [SWS_LinTrcv_91001] [SWS_LinTrcv_91002] [SWS_LinTrcv_91003] [SWS_LinTrcv_00171] LinTrcv-SWS с. 17 LinTrcv-SWS Рис. 10.3 с. 45

Жизненный цикл рабочих режимов от Power-On до Sleep

Драйвер поддерживает три программных режима работы: LINTRCV_TRCV_MODE_NORMAL, LINTRCV_TRCV_MODE_STANDBY и LINTRCV_TRCV_MODE_SLEEP [SWS_LinTrcv_00168]. Рисунок 7.1 спецификации сопоставляет их в рамках жизненного цикла LinTrcv-SWS Рис. 7.1 с. 15:

• После включения питания драйвер находится в состоянии NOT_ACTIVE.
• LinTrcv_Init переводит его в состояние ACTIVE. Три режима находятся внутри ACTIVE.
• Потеря питания завершает жизненный цикл.

LinTrcv_Init получает указатель на выбранный конфигурационный набор [SWS_LinTrcv_00001]. Структура LinTrcv_ConfigType зависит от реализации [SWS_LinTrcv_00172]. Начиная с версии 4.3.1 исходный режим после инициализации ограничен LINTRCV_TRCV_MODE_SLEEP LinTrcv-SWS с. 1.

В состоянии ACTIVE LinTrcv_SetOpMode переключает внутреннее состояние адресованного канала на переданный режим [SWS_LinTrcv_00002] LinTrcv-SWS с. 25. Режим LINTRCV_TRCV_MODE_STANDBY является опциональным. Он может быть чисто внутренним состоянием, используемым аппаратным обеспечением для переходов. Конкретному аппаратному обеспечению могут потребоваться не все интерфейсы LinTrcv-SWS Рис. 7.1 с. 15. Спецификация также называет условия, при которых LinTrcv_SetOpMode переключает канал в STANDBY. Эти условия в данном фрагменте обрезаны и здесь не приводятся LinTrcv-SWS с. 25.

LinTrcv_GetOpMode возвращает текущее программное состояние драйвера в выходном параметре OpMode [SWS_LinTrcv_00005] LinTrcv-SWS с. 26. Это не обязательно состояние аппаратного компонента. Вызывающая сторона может использовать это перед сменой режима, чтобы проверить, в каком режиме находится канал. Через LinIf этот запрос доступен как LinIf_GetTrcvMode LinIf-SWS с. 91.

Диаграмма состояний: после Power-On драйвер неактивен. LinTrcv_Init переводит в активную область с исходным режимом SLEEP, LinTrcv_SetOpMode переключает между режимами. Опциональные переходы реконструированы по подписям к рис. 7.1 (интерпретация). Условные переходы в STANDBY не показаны. Источники: LinTrcv-SWS Рис. 7.1 с. 15 [SWS_LinTrcv_00168] [SWS_LinTrcv_00001] LinTrcv-SWS с. 1

Смена режима и опросы через интерфейс LIN

Каждая служба адресует канал через параметр LinNetwork типа uint8 [SWS_LinTrcv_00002] [SWS_LinTrcv_00005]. В LinIf соответствующий параметр называется Channel и имеет тип NetworkHandleType LinIf-SWS с. 90.

LinTrcv_SetOpMode является синхронной и нереentrant-ной, идентификатор службы (Service ID) — 0x01. Возвращаемые значения означают [SWS_LinTrcv_00002]:

• E_OK: состояние трансивера переключилось в запрошенный режим.
• E_NOT_OK: переключение не было принято, завершилось сбоем или параметр находится вне допустимого диапазона.

LinIf должен разрешать вызов для всех трансиверов и всех режимов, даже если аппаратное обеспечение не поддерживает какой-либо режим LinIf-SWS с. 90. Таким образом, отображение на аппаратные средства остается задачей LinTrcv.

Время ожидания при смене состояний драйвер реализует с помощью Tm_BusyWait1us16bit [SWS_LinTrcv_00171]. Поскольку LinTrcv_SetOpMode работает синхронно [SWS_LinTrcv_00002], это активное время ожидания, вероятно, приходится на сам вызов и увеличивает время его выполнения (интерпретация). Вопрос Q-54fe21bbe7c737d9 (открытый) Кроме того, при переходе в режим ожидания (Standby) драйвер активирует каналы ICU для распознавания пробуждения LinTrcv-SWS с. 17.

Службы опроса являются reentrant-ными. LinTrcv_GetBusWuReason возвращает распознанную причину пробуждения в типе LinTrcv_TrcvWakeupReasonType [SWS_LinTrcv_00007]. К его значениям относятся LINTRCV_WU_ERROR, LINTRCV_WU_NOT_SUPPORTED, LINTRCV_WU_BY_BUS и LINTRCV_WU_BY_PIN [SWS_LinTrcv_00170]. Насколько точно можно дифференцировать причины пробуждения, сильно зависит от аппаратного обеспечения трансивера LinTrcv-SWS с. 28. LinTrcv_GetVersionInfo возвращает информацию о версии как Std_VersionInfoType [SWS_LinTrcv_00008] LinTrcv-SWS с. 29.

Диаграмма последовательности: смена режима передается от LinIf к LinTrcv. LinTrcv ожидает через Tm, при переходе в STANDBY активирует уведомление ICU и возвращает свой результат через LinIf без изменений. Управление через Dio/Spi и положение времени ожидания внутри вызова являются интерпретацией. Источники: [SWS_LinTrcv_00002] [SWS_LinTrcv_00171] LinIf-SWS с. 90 LinTrcv-SWS с. 17

Распознавание, оповещение и управление пробуждением

Драйвер различает два типа пробуждения LinTrcv-SWS с. 17:

• Внутреннее пробуждение: инициируется верхним уровнем, например, с помощью LinTrcv_Init или LinTrcv_SetOpMode.
• Внешнее пробуждение: драйвер распознает его на LIN-канале. LinIf должен вызвать LinTrcv_CheckWakeup, чтобы пробуждение было передано на верхний уровень.

Собственный ISR для пробуждения драйвером не предусмотрен. Распознавание осуществляется через ICU с помощью Icu_EnableNotification и Icu_DisableNotification. Тип пробуждения выбирается через конфигурационный параметр LinTrcvWakeUpSupport. С помощью LinTrcvWakeupByBusUsed можно включать и отключать поддержку пробуждения для каждого канала LinTrcv-SWS с. 17.

LinTrcv_CheckWakeup оценивает пробуждение в адресуемой сети, например, доминантный уровень шины или отрицательный фронт на выводе пробуждения LinTrcv-SWS с. 30. В R20-11 возвращаемые значения означают [SWS_LinTrcv_00012]:

• E_OK: пробуждение было обнаружено.
• E_NOT_OK: пробуждение не было обнаружено.

Фрагмент документа из более поздних релизов определяет эти значения иначе — как «вызов принят/не принят». Это изменение появилось в R22-11 и не применяется к R20-11 LinTrcv-SWS с. 1 LinTrcv-SWS с. 30. После успешного обнаружения драйвер сообщает источник пробуждения через LinIf_WakeupConfirmation [SWS_LinTrcv_91002]. Собственных callback-уведомлений LinTrcv не предоставляет LinTrcv-SWS с. 32. Поэтому необходимо активно вызывать LinTrcv_CheckWakeup.

LinTrcv_SetWakeupMode является синхронной и нереentrant-ной. Она управляет уведомлением о пробуждении для каждой сети через LinTrcv_TrcvWakeupModeType [SWS_LinTrcv_00009] [SWS_LinTrcv_00169]:

• LINTRCV_WUMODE_ENABLE разрешает уведомление.
• LINTRCV_WUMODE_DISABLE блокирует его.
• LINTRCV_WUMODE_CLEAR сбрасывает сохраненное событие пробуждения.

Если при разрешении уже имеется сохраненное событие, драйвер выполняет уведомление еще во время вызова или сразу после него LinTrcv-SWS с. 31. LinIf предоставляет это управление как LinIf_SetTrcvWakeupMode LinIf-SWS с. 93.

Диаграмма последовательности: внешнее пробуждение распознается через ICU. LinIf проверяет его с помощью LinTrcv_CheckWakeup, LinTrcv подтверждает его через LinIf_WakeupConfirmation, и после этого причину можно запросить (возвращаемые значения согласно R20-11). Источники: [SWS_LinTrcv_00012] [SWS_LinTrcv_91002] [SWS_LinTrcv_00007] LinTrcv-SWS с. 17 LinIf-SWS с. 98

Диаграмма деятельности: LinTrcv_SetWakeupMode выполняет ветвление в зависимости от запрошенного режима. Только при ENABLE с сохраненным событием сразу следует уведомление. Источники: [SWS_LinTrcv_00009] [SWS_LinTrcv_00169] LinTrcv-SWS с. 31

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

Каким образом драйвер обращается к микросхеме, определяет контейнер выбора LinTrcvAccess LinTrcv-SWS Рис. 10.3 с. 45. Необходимо выбрать ровно один из двух вариантов:

• LinTrcvDioAccess: выводы трансивера отображаются на каналы DIO.
• LinTrcvSpiSequence: обращение к микросхеме с поддержкой SPI осуществляется через SPI-последовательность.

Диаграмма взята из R23-11 и более поздних релизов. Однако службы чтения и записи DIO, а также типы SPI перечислены в качестве используемых интерфейсов и импортированных типов уже в R20-11 [SWS_LinTrcv_91003] [SWS_LinTrcv_91001].

Для многоядерных систем в R20-11 действуют следующие правила:

• Драйвер должен отклонять конфигурации с неподдерживаемыми назначениями разделов [SWS_LinTrcv_00174].
• Разделы, на которые ссылается LinTrcvChannelEcucPartitionRef, должны быть подмножеством разделов, на которые ссылается LinTrcvEcucPartitionRef. Если модуль ссылается на разделы, каждый канал должен ссылаться ровно на один из них [SWS_LinTrcv_00176].
• LinTrcvChannel и LinChannel одного и того же коммуникационного канала должны ссылаться на один и тот же раздел [SWS_LinTrcv_00177].

Многоядерное распределение было добавлено в R19-11 и уточнено в R24-11 LinTrcv-SWS с. 1.

Поведение при ошибке

Ошибки времени выполнения проявляются в возвращаемом значении:

• При отсутствии или нарушении связи с трансивером LinTrcv_GetOpMode LinTrcv-SWS с. 26 и LinTrcv_GetBusWuReason возвращают LinTrcv-SWS с. 28 E_NOT_OK.
• LinTrcv_SetOpMode возвращает E_NOT_OK, если переход не был принят или завершился сбоем [SWS_LinTrcv_00002].
• LinTrcv_SetWakeupMode возвращает E_NOT_OK, если режим пробуждения не удалось установить LinTrcv-SWS с. 31.
• Если причину пробуждения невозможно определить из-за ошибки, для этого предусмотрено значение LINTRCV_WU_ERROR [SWS_LinTrcv_00170].

Об ошибках разработки драйвер сообщает через Det_ReportError [SWS_LinTrcv_91003]. В R20-11 они приводят в LinTrcv_GetOpMode и LinTrcv_GetBusWuReason к E_NOT_OK [SWS_LinTrcv_00005] [SWS_LinTrcv_00007]. Места в документации из более поздних релизов называют конкретные проверки LinTrcv-SWS с. 26 LinTrcv-SWS с. 30 LinTrcv-SWS с. 29:

• Вызов до инициализации: LINTRCV_E_UNINIT
• Недопустимый номер сети: LINTRCV_E_INVALID_LIN_NETWORK
• Нулевой указатель при LinTrcv_GetVersionInfo: LINTRCV_E_PARAM_POINTER

По содержанию эти проверки, вероятно, применимы и к R20-11 (интерпретация). Вопрос Q-58e3d310b525b810 (открытый) Однако в R20-11 была скорректирована классификация ошибок, а в R21-11 — коды ошибок. Поэтому идентификаторы в R20-11 могут отличаться LinTrcv-SWS с. 1.

Часть некорректных действий перехватывает уже LinIf. При недействительном Channel LinIf_SetTrcvMode и LinIf_GetTrcvMode сообщают об ошибке LINIF_E_NONEXISTENT_CHANNEL LinIf-SWS с. 90. Кроме того, LinIf_GetTrcvMode при недействительном канале или нулевом указателе возвращает E_NOT_OK LinIf-SWS с. 91. Если LinIf_WakeupConfirmation получает недействительный источник пробуждения, при активированном обнаружении ошибок инициируется LINIF_E_PARAM_WAKEUPSOURCE LinIf-SWS с. 98.

Дальнейшие подробные доказательства

• [SWS_LinTrcv_00002] с LinTrcv-SWS с. 25: смена режима, возвращаемые значения и переход в STANDBY.
• [SWS_LinTrcv_00012] с LinTrcv-SWS с. 30: проверка пробуждения. Возвращаемые значения в R20-11 отличаются от более поздних релизов.
• [SWS_LinTrcv_00009] [SWS_LinTrcv_00169] с LinTrcv-SWS с. 31: разрешение, блокировка и сброс уведомлений о пробуждении.
• [SWS_LinTrcv_00168] с LinTrcv-SWS Рис. 7.1 с. 15: рабочие режимы и жизненный цикл.
• [SWS_LinTrcv_00170] с LinTrcv-SWS с. 28: причины пробуждения и их зависимость от аппаратного обеспечения.
• [SWS_LinTrcv_00171]: время ожидания через Tm_BusyWait1us16bit.
• [SWS_LinTrcv_00174] [SWS_LinTrcv_00176] [SWS_LinTrcv_00177]: разделение на разделы в многоядерных электронных блоках управления (ECU).
• [SWS_LinTrcv_91001] [SWS_LinTrcv_91002] [SWS_LinTrcv_91003]: импортированные типы, подтверждение пробуждения в LinIf и другие используемые интерфейсы.
• LinTrcv-SWS с. 17: внутренние и внешние пробуждения, использование ICU и конфигурация пробуждения.