Communication Manager (ComM)

Синхронная функция ComM_Init (Service-ID 0x01) служит для базовой инициализации AUTOSAR Communication Manager и перезапускает его внутренние конечные автоматы [SWS_ComM_00146]. В качестве входного параметра она принимает ConfigPtr, который передается как указатель на структуру конфигурации post-build типа const ComM_ConfigType* [SWS_ComM_00146]. Функция не возвращает значения (тип возвращаемого значения void) и объявляется через заголовочный файл ComM.h [SWS_ComM_00146].

В отношении параллелизма ComM_Init определена как нереентерабельная (Non Reentrant) [SWS_ComM_00146]. Конкретная вызывающая сторона в данных спецификации не задана; предположительно, вызов осуществляется централизованно во время фазы запуска электронного блока управления в рамках инициализации BSW. Вопрос Q-7121f73c12407087 (открытый)

В общей системе ComM_Init выполняет центральную управляющую функцию и функцию предварительного условия для всего модуля: пока модуль ComM не инициализирован, ни одна из служб модуля и API не должна начинать свою штатную работу и должна возвращать E_NOT_OK для служб со стандартным типом возврата [SWS_ComM_00612]. Исключение из этой блокировки действует исключительно для самого ComM_Init, а также для функций опроса ComM_GetVersionInfo и ComM_GetStatus [SWS_ComM_00612].

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

Функция ComM_DeInit служит согласно [SWS_ComM_00147] для деинициализации AUTOSAR Communication Manager (ComM). Служба спроектирована как синхронная, имеет Service-ID 0x02 и объявляется через заголовочный файл ComM.h. В соответствии с сигнатурой void ComM_DeInit(void) функция не принимает никаких входных, выходных или передаваемых параметров и не возвращает вызывающей стороне никакого значения [SWS_ComM_00147].

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

Поскольку сигнатура функции возвращает void, прямого ответа с кодами ошибок или состояния через вызов интерфейса не происходит [SWS_ComM_00147]. Специфические реакции на ошибки, такие как уведомление Development Error Tracer (DET) или Diagnostic Event Manager (DEM), не содержатся в представленных данных спецификации и поэтому не отображаются.

Параллелизм и системный контекст

Согласно [SWS_ComM_00147], интерфейс специфицирован как нереентерабельный (Non Reentrant). Из этого следует обязательное требование к системной интеграции: полностью исключить параллельные или прерывающие вызовы из нескольких задач или контекстов. В качестве интерпретации системного процесса вызов обычно должен происходить в ходе упорядоченного останова блока управления через вышестоящий менеджер состояний (например, менеджер BSW), как только каналы связи BSW будут остановлены. Вопрос Q-f3b68dc129993cb7 (открытый)

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

Синхронная и реентерабельная функция ComM_RequestComMode ([SWS_ComM_00110]) служит для запроса режима связи для определенного пользователя (User). Она доступна через ComM.h. В качестве входных параметров для ComMode в виде запроса пользователя допустимы исключительно следующие значения:

• COMM_FULL_COMMUNICATION: запрос полной коммуникационной способности ([SWS_ComM_00110]).
• COMM_NO_COMMUNICATION: освобождение или завершение запроса связи ([SWS_ComM_00110]).

Режимы COMM_SILENT_COMMUNICATION (служит для синхронизации выключения) и COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST (внутренний триггер пробуждения для нижележащих уровней, например, при наличии аппаратного обеспечения Ethernet с поддержкой OA TC10) являются внутренними состояниями и не должны запрашиваться пользователями ([SWS_ComM_00110]). Интерпретация: передача этих внутренних режимов, предположительно, будет квитироваться значением E_NOT_OK. Вопрос Q-973ed1ce1845983e (открытый)

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

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

• E_OK: переход в требуемый режим связи успешно выполнен.
• E_NOT_OK: смена режима не удалась.
• COMM_E_MODE_LIMITATION: запрашиваемый режим не может быть предоставлен из-за активного ограничения связи (Mode Inhibition). Запросы связи также могут быть снова освобождены из-за таких ограничений.

Взаимодействие и конечный автомат

Наличие или отсутствие активных запросов влияет на конечный автомат канала ComM. Если канал находится в подсостоянии COMM_FULL_COM_NETWORK_REQUESTED с конфигурацией ComMNmVariant = SLAVE_ACTIVE и активный вызов ComM_RequestComMode(<user>, COMM_FULL_COMMUNICATION) отсутствует, конечный автомат ComM переходит в подсостояние COMM_FULL_COM_READY_SLEEP ([SWS_ComM_01017]).

Синхронная функция ComM_UpdatePncToChannelMapping с Service-ID 0x62 служит для установки записей в сопоставлении PNC с каналами блока управления или PNC-шлюза [SWS_ComM_91015]. Интерфейс доступен через заголовочный файл ComM.h и в релизе R20-11 отмечен статусом Draft [SWS_ComM_91015].

Параметры

В вызов функции передаются три входных параметра [SWS_ComM_91015]:

• MappingTable: указатель на двумерный массив boolean (const boolean*), содержащий текущее сопоставление PNC с каналами для PNC-шлюза, где первое измерение охватывает все релевантные каналы, а второе измерение — все релевантные PNC [SWS_ComM_91015].
• channelCnt: количество физических каналов, передаваемых в MappingTable [SWS_ComM_91015].
• PncCnt: количество PNC, передаваемых в MappingTable [SWS_ComM_91015].

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

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

• E_OK: запись сопоставления успешно установлена [SWS_ComM_91015].
• E_NOT_OK: установка записи сопоставления не удалась [SWS_ComM_91015].
• COMM_E_LEARNING_ACTIVE: вызов не может быть выполнен, так как активна фаза обучения PNC [SWS_ComM_91015].

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

Интерфейс определен как нереентерабельный [SWS_ComM_91015]. Поэтому одновременные вызовы недопустимы. Кроме того, обновление исключено, пока коммуникационная система находится в активной фазе обучения PNC [SWS_ComM_91015].

Синхронная, нереентерабельная функция ComM_ResetPncToChannelMapping служит для сброса динамических записей сопоставления PNC с каналами блока управления к сконфигурированным значениям по умолчанию [SWS_ComM_91017]. Она не принимает входных параметров и возвращает значение состояния типа Std_ReturnType [SWS_ComM_91017].

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

Поведение функции зависит от состояния фазы обучения PNC, а также от конфигурации каналов:

• Если как минимум для одного канала активирован ComMDynamicPncToChannelMappingEnabled и фаза обучения PNC не активна, функция сбрасывает сопоставления к значениям по умолчанию исходной конфигурации (статическим записям) и возвращает E_OK [SWS_ComM_01043].
• Если система находится в активной фазе обучения PNC и как минимум для одного канала ComMDynamicPncToChannelMappingEnabled или ComMDynamicPncToChannelMappingSupport установлено в TRUE, в сбросе будет отказано и вернется COMM_E_LEARNING_ACTIVE [SWS_ComM_01042], [SWS_ComM_01045].
• Если сброс сопоставлений к значениям по умолчанию завершается сбоем, функция возвращает E_NOT_OK [SWS_ComM_91017].

Ограничения и условия вызова

Поскольку ComM_ResetPncToChannelMapping специфицирована как нереентерабельная (Non Reentrant), одновременные вызовы из параллельных контекстов выполняться не должны [SWS_ComM_91017]. Кроме того, интерфейс находится в статусе Draft [SWS_ComM_91017].

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

Асинхронная функция ComM_PnLearningRequest инициирует опциональное динамическое сопоставление PNC с каналами (Dynamic PNC-to-channel-mapping) [SWS_ComM_91019]. Она заставляет Network Management (NM) вернуться в состояние NM Repeat Message State [SWS_ComM_91019]. При этом отправляются бит Partial Network Learning Bit, чтобы принимающие узлы ответили, и бит Repeat Message Request Bit, чтобы принимающие узлы также перешли в состояние NM Repeat Message State [SWS_ComM_91019]. Вызов осуществляется без входных параметров через интерфейс в ComM.h с Service-ID 0x64 [SWS_ComM_91019].

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

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

• E_OK: алгоритм обучения PNC успешно запущен [SWS_ComM_91019].
• E_NOT_OK: не удалось запустить алгоритм обучения PNC [SWS_ComM_91019].
• COMM_E_LEARNING_ACTIVE: вызов функции не может быть выполнен, поскольку фаза обучения PNC уже активна [SWS_ComM_91019].

Параллелизм и конфигурация

Функция специфицирована как нереентерабельная (Non Reentrant) и имеет статус draft [SWS_ComM_91019]. Она доступна исключительно тогда, когда параметр предварительной конфигурации ComMDynamicPncToChannelMappingSupport установлен в TRUE [SWS_ComM_01044].

Синхронная и нереентерабельная функция ComM_UpdatePncMembership используется программными компонентами (SWC) для адаптации членства в PNC, передаваемого во время PNC-learning, для опционального динамического сопоставления PNC с каналами [SWS_ComM_91021]. Она доступна через заголовочный файл ComM.h только тогда, когда параметр конфигурации ComMDynamicPncToChannelMappingSupport установлен в TRUE [SWS_ComM_01047].

Через параметр ComM_PncMembership передается массив байтов с длиной вектора PNC, содержащий текущее членство узла в PNC [SWS_ComM_91021]. Если функция активирована как минимум на одном канале и фаза обучения PNC неактивна, вычисляется параметр Control [SWS_ComM_01049]:

• При Control = 0 текущее членство в PNC вычисляется посредством побитовой операции «И» с ComM_PncMembership, чтобы адресно сбросить соответствующие биты в маске [SWS_ComM_01049].
• При Control = 1 применяется побитовая операция «ИЛИ» для установки битов в маске [SWS_ComM_01049].

Если обновление прошло успешно, функция возвращает E_OK [SWS_ComM_01049]. Если же хотя бы на одном канале сконфигурировано динамическое сопоставление и фаза обучения PNC активна, в выполнении отказывается и сообщается специальное значение ошибки COMM_E_LEARNING_ACTIVE [SWS_ComM_01048]. Если во время процесса обновления возникает другая ошибка, возвращается E_NOT_OK [SWS_ComM_91021].

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

Функция ComM_PreventWakeUp согласно [SWS_ComM_00156] служит для изменения статуса ингибирования COMM_NO_WAKEUP для определенного канала связи. Она выполняется синхронно и доступна через заголовочный файл ComM.h.

При вызове передаются два входных параметра:

• Channel: идентифицирует соответствующий канал в соответствии с типом NetworkHandleType ([SWS_ComM_00156]).
• Status: булево значение, с помощью которого ингибирование пробуждения активируется (TRUE) или деактивируется (FALSE) ([SWS_ComM_00156]).

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

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

• E_OK: статус пробуждения для указанного канала успешно обновлен.
• E_NOT_OK: изменение статуса пробуждения не удалось, например, если данная функциональность деактивирована через классификацию групп ECU (ComMEcuGroupClassification).

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

Интерфейс специфицирован как нереентерабельный (Non Reentrant) ([SWS_ComM_00156]). Поэтому вызывающие стороны должны гарантировать, что параллельные вызовы для одного и того же экземпляра исключены.

Синхронная функция ComM_LimitChannelToNoComMode с Service-ID 0x0b служит в Communication Manager для задания статуса ингибирования для отдельного канала связи [SWS_ComM_00163]. Она предотвращает или разрешает переход канала из состояния COMM_NO_COMMUNICATION в вышестоящий режим связи [SWS_ComM_00163].

Параметры и контекст вызова

Интерфейс объявлен через заголовочный файл ComM.h и не имеет ни входных/выходных, ни чисто выходных параметров [SWS_ComM_00163]. При вызове передаются два входных параметра [SWS_ComM_00163]:

• Channel: адресует соответствующий канал через идентификатор типа NetworkHandleType [SWS_ComM_00163].
• Status: определяет в виде boolean желаемое состояние ингибирования. Передача TRUE активирует ограничение канала на COMM_NO_COMMUNICATION, тогда как FALSE снова деактивирует это ограничение [SWS_ComM_00163].

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

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

• E_OK: статус ингибирования для адресуемого канала успешно скорректирован [SWS_ComM_00163].
• E_NOT_OK: изменение статуса не удалось выполнить, что, например, имеет место в случае, если конфигурация ComMEcuGroupClassification (см. ECUC_ComM_00563) деактивирует эту функциональность [SWS_ComM_00163].

Параллелизм и системный контекст

Что касается поведения при выполнении, функция реализована синхронной (Synchronous) и нереентерабельной (Non Reentrant) [SWS_ComM_00163]. Для той же цели на уровне всей системы существует родственная функция ComM_LimitECUToNoComMode, которая реализует то же ограничение не только поканально, но и единообразно для всех каналов электронного блока управления [SWS_ComM_00163].

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

Синхронная функция ComM_LimitECUToNoComMode (Service-ID 0x0c) определена в ComM.h и служит для изменения статуса ингибирования для всего электронного блока управления [SWS_ComM_00124]. Она предотвращает или разрешает переход из COMM_NO_COMMUNICATION в более высокий режим связи для всех каналов связи ECU [SWS_ComM_00124]. Управление осуществляется через формальный параметр Status:

• TRUE: активирует ограничение электронного блока управления на режим COMM_NO_COMMUNICATION [SWS_ComM_00124].
• FALSE: снова деактивирует ограничение электронного блока управления на COMM_NO_COMMUNICATION [SWS_ComM_00124].

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

Функция возвращает вызывающей стороне код состояния типа Std_ReturnType [SWS_ComM_00124]:

• E_OK: статус ингибирования для электронного блока управления успешно применен [SWS_ComM_00124].
• E_NOT_OK: изменение статуса ингибирования не удалось, например, если параметр конфигурации ComMEcuGroupClassification (см. ECUC_ComM_00563) деактивирует эту функциональность [SWS_ComM_00124].

Вызывающая сторона должна анализировать возвращаемое значение, чтобы определить, удалось ли ввести ограничение в действие или оно было отклонено конфигурацией модуля [SWS_ComM_00124].

Параллелизм и взаимодействие

Интерфейс объявлен как нереентерабельный (Non Reentrant); параллельные или прерывающие вызовы поэтому недопустимы и должны быть исключены на стороне вызывающего объекта [SWS_ComM_00124]. В то время как ComM_LimitChannelToNoComMode предоставляет ту же функциональность управления изолированно для отдельного канала, ComM_LimitECUToNoComMode всегда затрагивает совокупность всех каналов электронного блока управления [SWS_ComM_00124].

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

Синхронная функция ComM_ReadInhibitCounter (Service-ID 0x0d) служит для запроса количества отклоненных пользовательских запросов на полноценный режим связи (COMM_FULL_COMMUNICATION) [SWS_ComM_00224]. Объявление функции предоставляется через заголовочный файл ComM.h [SWS_ComM_00224].

Функция не имеет входных параметров. Единственным выходным параметром служит указатель CounterValue базового типа uint16*, через который вызывающей стороне передается значение счетчика отклоненных запросов [SWS_ComM_00224]. Если значение счетчика удалось успешно определить и записать, функция возвращает E_OK; в случае сбоя она возвращает E_NOT_OK [SWS_ComM_00224].

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

Специфические коды ошибок или стандартизированные ошибки разработки (DET) в описании интерфейса отдельно не приведены. Неудача с возвращаемым значением E_NOT_OK [SWS_ComM_00224], предположительно, обусловлена недействительным параметром-указателем (нулевой указатель) или вызовом до инициализации модуля ComM (интерпретация). Вопрос Q-5779d898381d9894 (открытый)

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

Интерфейс явно специфицирован как нереентерабельный (Non Reentrant) [SWS_ComM_00224]. Вызывающие стороны должны на системном уровне гарантировать отсутствие конкурирующих или прерывающих вызовов из различных задач или подпрограмм обработки прерываний, чтобы избежать несогласованности при считывании счетчика.

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

Синхронный интерфейс ComM_ResetInhibitCounter служит для сброса внутреннего счетчика отклоненных или заблокированных запросов полной связи (Inhibited COMM_FULL_COMMUNICATION request Counter) в Communication Manager [SWS_ComM_00108]. Вызов предоставляется через заголовочный файл ComM.h, имеет Service-ID 0x0e и не требует входных параметров [SWS_ComM_00108]. При успешном выполнении функция возвращает значение E_OK типа Std_ReturnType [SWS_ComM_00108].

Обработка ошибок и граничные условия

Если при сбросе счетчика возникает ошибка, сервис сигнализирует об этом возвращаемым значением E_NOT_OK [SWS_ComM_00108]. Конкретные ошибки разработки (DET) или сценарии ошибок в приведенной выдержке из спецификации не указаны; вероятно, выполнение завершается сбоем и возвращает E_NOT_OK, если модуль еще не был инициализирован. Вопрос Q-31d1ba95e419fa8e (открытый)

Параллелизм

Функция объявлена как нереентерабельная (Non Reentrant) [SWS_ComM_00108]. Поэтому пользователи должны посредством надлежащей синхронизации гарантировать отсутствие параллельных вызовов из нескольких потоков, задач или подпрограмм обработки прерываний, чтобы избежать несогласованности счетчика.

Функция ComM_Nm_NetworkStartIndication служит интерфейсом уведомления от управления сетью к Communication Manager. Согласно [SWS_ComM_00383], она указывает на то, что во время состояния Bus Sleep Mode было принято NM-сообщение, что сигнализирует о том, что определенные узлы в сети уже перешли в Network Mode.

• Вызов и параметры: интерфейс объявляется через заголовочный файл ComM_Nm.h и принимает в качестве входного параметра соответствующий коммуникационный канал Channel типа NetworkHandleType [SWS_ComM_00383].
• Синхронность и возврат: вызов не имеет возвращаемого значения (void) и следует асинхронной семантике выполнения [SWS_ComM_00383].
• Параллелизм: функция снабжена Service-ID 0x15 и специфицирована как реентерабельная (Reentrant) [SWS_ComM_00383].

Специфические коды ошибок, сообщения DET или DEM, а также особые реакции на ошибки для этого интерфейса в спецификации не указаны [SWS_ComM_00383]. Интерпретация: индикация, вероятно, предназначена для внутреннего запуска перехода из состояния покоя к активной сетевой коммуникации для указанного канала. Вопрос Q-97a02db4ab6a3af8 (открытый)

Функция ComM_Nm_NetworkMode выступает в AUTOSAR-менеджере связи (ComM) в качестве callback-уведомления, с помощью которого управление сетью (Nm) сигнализирует об успешном переходе в сетевой режим (Network Mode) [SWS_ComM_00390].

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

Интерфейс доступен через заголовочный файл ComM_Nm.h и имеет Service-ID 0x18 [SWS_ComM_00390]. При вызове через единственный входной параметр Channel типа NetworkHandleType передается соответствующий канал связи [SWS_ComM_00390]. Функция не возвращает значения (тип возврата void) и не имеет выходных параметров [SWS_ComM_00390].

Параллелизм и семантика

Поведение выполнения ComM_Nm_NetworkMode объявлено как асинхронное (Asynchronous) [SWS_ComM_00390]. В отношении параллелизма функция специфицирована как реентерабельная (Reentrant), поэтому ее можно повторно вызывать для параллельных событий каналов [SWS_ComM_00390].

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

Поскольку сигнатура не предусматривает возвращаемого значения, коды ошибок напрямую вызывающей стороне не передаются [SWS_ComM_00390].

Функция ComM_Nm_PrepareBusSleepMode служит интерфейсом уведомления модуля Communication Manager (ComM). Она информирует ComM о том, что управление сетью для указанного канала связи перешло в состояние «Prepare Bus - Sleep Mode» [SWS_ComM_00391].

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

Интерфейс доступен через заголовочный файл ComM_Nm.h и имеет Service-ID 0x19 [SWS_ComM_00391]. Выполнение происходит асинхронно [SWS_ComM_00391]. Сигнатура функции включает следующие параметры:

• Channel (In, NetworkHandleType): идентифицирует соответствующий сетевой канал, управление сетью которого перешло в режим Prepare-Bus-Sleep [SWS_ComM_00391].
• Возвращаемое значение: void; значения состояния или ошибок не возвращаются, а входные/выходные параметры отсутствуют [SWS_ComM_00391].

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

Что касается параллелизма, ComM_Nm_PrepareBusSleepMode специфицирована как реентерабельная, однако с обязательным ограничением, состоящим в том, что это не распространяется на один и тот же NM-канал (Reentrant (but not for the same NM - Channel)) [SWS_ComM_00391]. Поэтому вызовы для разных каналов могут выполняться параллельно, тогда как одновременные вызовы для одного и того же канала должны быть исключены.

Контекст вызова и обработка ошибок

Интерпретация: контекст вызова, вероятно, находится в универсальном или шинно-специфичном Network Management, которое сообщает о достижении этого состояния в ComM. Вопрос Q-41524322db480310 (открытый) Специфические коды ошибок, сообщения DET или DEM для этого интерфейса в спецификации не определены [SWS_ComM_00391].

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

Callback-функция ComM_Nm_BusSleepMode служит уведомлением для модуля ComM о том, что управление сетью перешло в режим Bus-Sleep [SWS_ComM_00392]. Посредством этого вызова функция должна перевести соответствующее аппаратное обеспечение, а также трансивер в спящий режим шины (Bus-Sleep) [SWS_ComM_00392].

Интерфейс и параметры

Функция предоставляется через заголовочный файл ComM_Nm.h и имеет Service-ID 0x1a [SWS_ComM_00392]. Вызов осуществляется через сигнатуру void ComM_Nm_BusSleepMode (NetworkHandleType Channel) со следующими характеристиками параметров [SWS_ComM_00392]:

• Channel: входной параметр типа NetworkHandleType, идентифицирующий соответствующий канал связи [SWS_ComM_00392].
• Для данной функции не предусмотрены ни входные/выходные, ни выходные параметры [SWS_ComM_00392].
• Возвращаемое значение не определено (void) [SWS_ComM_00392].

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

В отношении поведения при выполнении и возможных ограничений требование определяет следующие рамочные условия [SWS_ComM_00392]:

• Асинхронная семантика: вызов классифицирован как асинхронный (Asynchronous) [SWS_ComM_00392].
• Реентерабельность: функция определена как реентерабельная (Reentrant) [SWS_ComM_00392].

Callback-функция ComM_Nm_RestartIndication с Service-ID 0x1b вызывается NM-интерфейсом и объявлена через заголовочный файл ComM_Nm.h [SWS_ComM_00792]. Она служит для уведомления Communication Manager о перезапуске сетевого управления во время текущего процесса отключения координируемых шин [SWS_ComM_00792]. Единственный входной параметр Channel типа NetworkHandleType указывает затронутый канал; операция не возвращает значения [SWS_ComM_00792].

Интерфейс специфицирован как асинхронный и реентерабельный [SWS_ComM_00792]. Его вызов NM-интерфейсом происходит при одновременном наличии трёх условий:

• NM-интерфейс уже начал останов координируемых шин [SWS_ComM_00792].
• Ещё не все из этих координируемых шин сообщили о состоянии Bus-Sleep [SWS_ComM_00792].
• По меньшей мере на одной из координируемых шин перезапускается сетевое управление [SWS_ComM_00792].

Если эти условия выполнены, NM-интерфейс вызывает функцию специально с дескриптором тех каналов, которые уже сигнализировали о состоянии Bus-Sleep [SWS_ComM_00792].

Специфические коды ошибок, реакции на ошибки или сообщения в модуль тестирования разработки или памяти ошибок (DET/DEM) во фрагменте спецификации не предусмотрены [SWS_ComM_00792]. Интерпретация: вероятно, функция предназначена в ComM для того, чтобы снова согласовать внутреннее состояние уже спящих каналов с реактивированной координацией шин. Вопрос (открытый)

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

Функция ComM_Nm_RepeatMessageLeftIndication служит интерфейсом уведомления, который сигнализирует ComM о том, что состояние всех модулей Bus NM (<Bus Nm>) покинуло состояние Repeat Message [SWS_ComM_91024]. В рамках опциональной функции динамического сопоставления кластеров частичных сетей с каналами (Dynamic PNC-to-channel-mapping) этот вызов указывает на завершение фазы обучения [SWS_ComM_91024].

Интерфейс объявляется через заголовочный файл ComM_Nm.h и не имеет возвращаемого значения (void) [SWS_ComM_91024]. В качестве входного параметра передается затрагиваемый коммуникационный канал:

• Channel (In, NetworkHandleType): идентификация канала, для которого сообщается о выходе из состояния [SWS_ComM_91024].

Взаимодействие и функциональное воздействие

Поведение индикации управляет фазой обучения PNC: если параметр конфигурации ComMDynamicPncToChannelMappingEnabled установлен в TRUE и вызывается ComM_Nm_RepeatMessageLeftIndication, ComM переводит фазу обучения PNC (PNC Learning Phase) для соответствующего канала в неактивное состояние [SWS_ComM_01029] [SWS_ComM_01046].

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

Интерфейс специфицирован как реентерабельный и обладает асинхронной семантикой выполнения [SWS_ComM_91024]. В данной спецификации элемент дополнительно отмечен статусом разработки draft [SWS_ComM_91024].

Функция ComM_Nm_PncLearningBitIndication служит интерфейсом уведомления для модуля ComM, сигнализирующим о приеме NM-сообщения с установленным битом PNC Learning [SWS_ComM_91026]. Интерфейс имеет Service-ID 0x69, предоставляется через заголовочный файл ComM_Nm.h и отмечен в спецификации статусом «draft» [SWS_ComM_91026].

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

• Параметры: в качестве входного параметра передается Channel типа NetworkHandleType, идентифицирующий соответствующий коммуникационный канал [SWS_ComM_91026]. Входные/выходные и выходные параметры отсутствуют, а типом возвращаемого значения является void [SWS_ComM_91026].
• Параллелизм: вызов специфицирован как асинхронный и реентерабельный [SWS_ComM_91026]. Судя по идентификатору и заголовочному файлу, вызов, как правило, выполняется нижележащим NM-модулем, как только принято соответствующее NM-сообщение. Вопрос Q-31b0ce30b88c71b6 (открытый)
• Обработка ошибок: в объеме спецификации для этой службы не задокументированы ни возвращаемые значения, ни специфические коды ошибок или сообщения в DET либо DEM.

Во взаимодействии с динамическим сопоставлением PNC функция управляет активацией фазы обучения: если ComM_Nm_PncLearningBitIndication вызывается на канале, для которого параметр конфигурации ComMDynamicPncToChannelMappingEnabled установлен в TRUE, ComM должен перевести фазу обучения PNC (PNC Learning Phase) для этого канала в активное состояние [SWS_ComM_01026]. Согласно спецификации, такое же состояние активной фазы обучения на соответствующем канале ComM инициирует и в том случае, когда модуль сам вызывает Nm_PnLearningRequest [SWS_ComM_01026].

Синхронная и реентерабельная функция ComM_Nm_ForwardSynchronizedPncShutdown (Service-ID 0x6b) объявляется через заголовочный файл ComM_Nm.h и служит для скоординированной пересылки синхронизированного останова PNC [SWS_ComM_91003].

Использование и контекст вызова: она вызывается, когда блок управления в роли промежуточного PNC-координатора (intermediate PNC coordinator) принимает сообщение об останове PN через шинно-специфичный NM [SWS_ComM_91003]. В качестве единственного входного параметра передается затрагиваемый коммуникационный канал (Channel типа NetworkHandleType). Возвращаемое значение не определено (void) [SWS_ComM_91003].

Взаимодействие и последовательность действий: после индикации ComM немедленно освобождает соответствующие конечные автоматы PNC. Кроме того, он незамедлительно пересылает информацию о PN в затрагиваемые каналы ComM и соответствующие каналы NM [SWS_ComM_91003]. Благодаря этому обеспечивается в значительной степени синхронный останов PNC по всей иерархической топологии PN — от вышестоящего координатора верхнего уровня до подчиненных PNC-узлов [SWS_ComM_91003].

Обработка ошибок и граничные условия: поскольку интерфейс не имеет возвращаемого значения и специфические коды ошибок не документированы, обработка ошибок, по всей видимости, происходит внутри или через DET. Вопрос Q-618a8c1da055cdf5 (открытый) В выпуске R20-11 этот элемент классифицирован как Draft [SWS_ComM_91003].

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

Синхронный интерфейс ComM_DCM_ActiveDiagnostic служит для уведомления модуля Communication Manager (ComM) со стороны Diagnostic Communication Manager (DCM) об активных диагностических действиях на определенном канале связи [SWS_ComM_00873]. Функция определена в заголовочном файле ComM_Dcm.h и обозначена с Service-ID 0x1f [SWS_ComM_00873].

В качестве единственного параметра вызова выступает входной параметр Channel типа данных NetworkHandleType, однозначно идентифицирующий соответствующий канал для предстоящей диагностической связи [SWS_ComM_00873]. Интерфейс не имеет возвращаемого значения (тип возврата void), а входные/выходные или выходные параметры отсутствуют [SWS_ComM_00873].

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

В отношении параллелизма данный элемент службы специфицирован как реентерабельный [SWS_ComM_00873]. Это допускает параллельные синхронные вызовы функции из различных контекстов выполнения, например, если DCM должен одновременно управлять несколькими сетевыми каналами или обслуживать их.

Обработка ошибок и взаимодействие

Для этого вызова не определены отдельные коды ошибок или сообщения в систему управления ошибками разработки (DET), а также в систему управления памятью диагностических ошибок (DEM) [SWS_ComM_00873]. Взаимодействие ограничивается обменом сигналами между DCM и ComM; интерпретация: вызов, предположительно, используется в ComM для поддержания соответствующего канала в активном состоянии связи на время диагностической активности [SWS_ComM_00873]. Вопрос Q-bfd91da2e435fbb6 (открытый)

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

Синхронная функция ComM_DCM_InactiveDiagnostic служит для того, чтобы Diagnostic Communication Manager (DCM) сообщил Communication Manager (ComM), что диагностическая связь на определённом канале неактивна и больше не требуется [SWS_ComM_00874]. Объявление этого интерфейса предоставляется через заголовочный файл ComM_Dcm.h с Service-ID 0x20 [SWS_ComM_00874].

В качестве входного параметра передаётся Channel типа NetworkHandleType, который идентифицирует соответствующий коммуникационный канал [SWS_ComM_00874]. Функция не имеет ни входных/выходных параметров, ни выходных параметров и не возвращает значения (void) [SWS_ComM_00874].

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

Интерфейс специфицирован как реентерабельный [SWS_ComM_00874], так что одновременные вызовы — например, для разных коммуникационных каналов — допустимы. Специфические коды ошибок, сообщения об ошибках DET или события DEM для этой функции в полезной нагрузке не определены [SWS_ComM_00874]. Модуль ComM, вероятно, использует сообщение о неактивности внутри себя для отмены существующих диагностических запросов для канала и соответствующей корректировки статуса канала. Вопрос Q-148d39d8c17e936c (открытый)

Функция ComM_EcuM_WakeUpIndication служит для уведомления Communication Manager (ComM) о возникшем событии пробуждения (Wake-up) на соответствующем затронутом канале связи [SWS_ComM_00275]. Вызов, как правило, выполняется модулем ECU State Manager (EcuM), как только тот зарегистрирует соответствующее пробуждение на канале. Вопрос Q-5f8c43b9df10dc8e (открытый)

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

Интерфейс определен как синхронный и имеет Service-ID 0x2a [SWS_ComM_00275]. Через входной параметр Channel типа NetworkHandleType передается идентификатор канала связи, на котором было обнаружено пробуждение [SWS_ComM_00275]. Функция не имеет возвращаемого значения (void) и объявляется через заголовочный файл ComM_EcuM.h [SWS_ComM_00275].

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

Согласно спецификации, ComM_EcuM_WakeUpIndication классифицируется как реентерабельная [SWS_ComM_00275]. Таким образом, функцию разрешено вызывать параллельно для различных каналов или из параллельных контекстов. Специфические коды ошибок, возвращаемые значения или сообщения DET/DEM в определении элемента не указаны [SWS_ComM_00275].

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

Синхронная функция ComM_EcuM_PNCWakeUpIndication служит для уведомления Communication Manager о пробуждении (Wake-up) в кластере частичной сети (Partial Network Cluster, PNC) [SWS_ComM_91001]. Она объявляется через заголовочный файл ComM_EcuM.h и ожидает в качестве входного параметра PNCid идентификатор соответствующего кластера; возвращаемые значения отсутствуют [SWS_ComM_91001]. Интерпретация: вызов обычно выполняется ECU State Manager (EcuM) при обнаружении соответствующего события PNC. Вопрос Q-fee4a70f73cde8ea (открытый)

Параллелизм и переходы состояний

Интерфейс специфицирован как реентерабельный [SWS_ComM_91001]. Его вызов вызывает целевые переходы состояний внутри конечных автоматов PNC и каналов ComM:

• Если ссылаемый кластер находится в основном состоянии PNC PNC_NO_COMMUNICATION, выполняется выход из него и переход в подсостояние PNC PNC_PREPARE_SLEEP [SWS_ComM_00964].
• Если вызов происходит в подсостоянии COMM_NO_COM_NO_PENDING_REQUEST при активированной поддержке PNC (ComMPncSupport=TRUE) и деактивированном синхронном пробуждении (ComMSynchronousWakeUp=FALSE), модуль переводит в подсостояние COMM_NO_COM_REQUEST_PENDING те конечные автоматы каналов ComM, на которые ссылается указанный PNC [SWS_ComM_01014].
• Если же при активном ComMPncSupport сконфигурирован ComMSynchronousWakeUp=TRUE, вызов в подсостоянии COMM_NO_COM_NO_PENDING_REQUEST переключает в подсостояние COMM_NO_COM_REQUEST_PENDING абсолютно все конечные автоматы каналов ComM [SWS_ComM_01015].

С помощью функции ComM_CommunicationAllowed ([SWS_ComM_00871]) модулю ComM через EcuM или BswM сообщается, разрешена ли связь для определенного канала.

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

Интерфейс вызывается модулем EcuM или BswM; если используется EcuM Flex, эту задачу берет на себя BswM ([SWS_ComM_00871]). Функция объявлена через заголовочный файл ComM_BswM.h и имеет Service-ID 0x35 ([SWS_ComM_00871]).

Функция не имеет возвращаемого значения (void) и ожидает следующие передаваемые параметры ([SWS_ComM_00871]):

• Channel (тип NetworkHandleType): обозначает соответствующий канал связи ([SWS_ComM_00871]).
• Allowed (тип boolean): передает статус разрешения со значением TRUE для разрешенной связи или FALSE для неразрешенной связи ([SWS_ComM_00871]).

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

Согласно спецификации функция работает асинхронно (Asynchronous) и классифицирована как нереентерабельная (Non Reentrant) ([SWS_ComM_00871]). Ввиду нереентерабельности вызывающая сторона, вероятно, должна гарантировать отсутствие параллельных или прерывающих вызовов данного интерфейса. Вопрос Q-e6688e3286d9ed60 (открытый)

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

Интерфейс ComM_BusSM_ModeIndication служит для индикации фактического режима шины ответственным Bus State Manager модулю ComM [SWS_ComM_00675]. C-функция доступна через заголовочный файл ComM.h и ведётся под Service-ID 0x33 [SWS_ComM_00675]. Её синтаксис имеет вид void ComM_BusSM_ModeIndication (NetworkHandleType Channel, ComM_ModeType ComMode) [SWS_ComM_00675].

Функция принимает два входных параметра:

• Channel: затронутый коммуникационный канал типа NetworkHandleType [SWS_ComM_00675].
• ComMode: фактический режим шины типа ComM_ModeType [SWS_ComM_00675].

Интерфейс не имеет возвращаемого значения (void) и не определяет ни входных/выходных параметров, ни чисто выходных параметров [SWS_ComM_00675].

Параллелизм и синхронизация

Для поведения во время выполнения определено, что вызов осуществляется асинхронно (Asynchronous) и функция может выполняться реентерабельно (Reentrant) [SWS_ComM_00675].

Взаимодействие в общей системе

Модуль ComM пересылает состояние, сообщённое через этот вызов, пользователям [SWS_ComM_00675]. Это распространение состояния шины осуществляется через интерфейсы RTE и BswM [SWS_ComM_00675].

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

Синхронная сервисная функция ComM_BusSM_BusSleepMode служит ответственным Bus State Manager (BusSM) в качестве уведомления для Communication Manager (ComM) о том, что фактический режим шины коммуникационного канала перешёл в состояние Bus-Sleep [SWS_ComM_91000]. Идентификация затронутого канала осуществляется через входной параметр Channel типа NetworkHandleType [SWS_ComM_91000]. Функция не объявляет ни выходных параметров, ни возвращаемого значения (void) [SWS_ComM_91000].

Действительность, зависящая от конфигурации

Вызов не является универсально допустимым, а явно ограничен каналами ComM, чей параметр ComMNmVariant установлен в SLAVE_ACTIVE или SLAVE_PASSIVE [SWS_ComM_91000]. Спецификация называет для этого два типичных сценария использования:

• LIN-слейвы с конфигурацией ComMNmVariant = SLAVE_ACTIVE [SWS_ComM_91000].
• Каналы Ethernet с оборудованием согласно OPEN Alliance TC10, которые работают в качестве пассивных слейвов связи, при этом ComMNmVariant = SLAVE_PASSIVE и параметр EthTrcvActAsSlavePassiveEnabled установлен в TRUE [SWS_ComM_91000].

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

Интерфейс имеет Service-ID 0x34, объявлен через заголовочный файл ComM.h и классифицирован как реентерабельный [SWS_ComM_91000]. Специфические коды ошибок или отдельное поведение в случае ошибки в определении функции не указаны [SWS_ComM_91000].

Тип перечисления ComM_InitStatusType служит для представления состояния инициализации модуля ComM (COM Manager) и доступен через заголовочный файл ComM.h [SWS_ComM_00668].

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

• COMM_UNINIT (закодировано со значением 0x00 или 0): указывает на то, что COM Manager не инициализирован или не может использоваться. Это состояние обязательно является значением по умолчанию непосредственно после сброса [SWS_ComM_00668].
• COMM_INIT (закодировано со значением 0x01): указывает на то, что COM Manager был надлежащим образом инициализирован и готов к работе [SWS_ComM_00668].

Что касается временной последовательности и использования модуля, этот статус обозначает принципиальную применимость COM Manager [SWS_ComM_00668]. Интерпретация: вызывающие стороны или внутренние подпрограммы модуля, вероятно, оценивают этот статус, чтобы гарантировать, что запросы связи не обрабатываются в состоянии COMM_UNINIT, так как COM Manager в этом состоянии явно специфицирован как непригодный к использованию [SWS_ComM_00668]. Вопрос Q-2c4da2e5c40a0f4b (открытый) Только после успешного перехода в COMM_INIT модуль становится доступным для взаимодействий более высокого уровня.

Тип перечисления ComM_PncModeType определяет текущее рабочее состояние Partial Network Cluster (PNC) в Communication Manager [SWS_ComM_00673]. Тип предоставляется через заголовочный файл ComM.h и включает пять дискретных состояний [SWS_ComM_00673]:

• COMM_PNC_REQUESTED (0x00): PNC запрашивается локальным пользователем ComM.
• COMM_PNC_READY_SLEEP (0x01): PNC запрашивается удалённым пользователем ComM.
• COMM_PNC_PREPARE_SLEEP (0x02): PNC активен, но без контроля дедлайнов (Deadline Monitoring).
• COMM_PNC_NO_COMMUNICATION (0x03): для PNC связь не выполняется.
• COMM_PNC_REQUESTED_WITH_WAKEUP_REQUEST (0x04): локальный запрос PNC с дополнительным требованием аппаратного пробуждения к BswM.

Во взаимодействии с BswM режим COMM_PNC_REQUESTED_WITH_WAKEUP_REQUEST служит для сигнализации того, что активный запрос должен дополнительно инициировать пробуждение коммуникационного оборудования [SWS_ComM_00673]. Это предполагает, что функция поддерживается и сконфигурирована, например при переключении портов Ethernet-коммутаторов согласно OA TC10 [SWS_ComM_00673]. В качестве ограничения следует учитывать, что в релизе R20-11 этот режим имеет статус draft [SWS_ComM_00673].

Поскольку это чистое определение типа, для ComM_PncModeType нет собственных подпрограмм обработки ошибок или требований к реентерабельности.

Интерпретация: поскольку тип объявлен в ComM.h, а BswM адресуется в качестве получателя информации о режиме, данный тип данных, вероятно, используется межмодульно в качестве параметра интерфейса для сообщений о состоянии PNC. Вопрос Q-88ad945ffcf90e9e (открытый)

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

Тип ComM_StateType представляет состояния и подсостояния внутреннего конечного автомата Communication Manager (ComM) на платформе AUTOSAR Classic [SWS_ComM_00674]. Он определен как самостоятельный тип на базе стандартного типа uint8 и предоставляется через заголовочный файл ComM.h для программных компонентов и модулей BSW [SWS_ComM_00674].

Диапазон значений и подсостояния

Диапазон значений включает пять фиксированных значений, которые отображают точную фазу конечного автомата связи [SWS_ComM_00674]:

• COMM_NO_COM_NO_PENDING_REQUEST (значение 0): обозначает состояние внутри No Communication, когда в данный момент запрос связи отсутствует [SWS_ComM_00674].
• COMM_NO_COM_REQUEST_PENDING (значение 1): обозначает состояние внутри No Communication, пока ожидается запрос связи [SWS_ComM_00674].
• COMM_FULL_COM_NETWORK_REQUESTED (значение 2): обозначает состояние внутри Full Communication, при котором сеть активно запрошена [SWS_ComM_00674].
• COMM_FULL_COM_READY_SLEEP (значение 3): обозначает состояние внутри Full Communication, в котором активные запросы больше не присутствуют и сеть готова к переходу в режим сна [SWS_ComM_00674].
• COMM_SILENT_COM (значение 4): соответствует режиму связи Silent Communication [SWS_ComM_00674].

Сопоставление с режимами связи

Значения ComM_StateType находятся в прямом соотношении с вышестоящими режимами связи (Communication Modes) ComM [SWS_ComM_00674]. Все состояния с префиксом COMM_NO_COM* назначены режиму No Communication, тогда как состояния с префиксом COMM_FULL_COM* соответствуют режиму Full Communication [SWS_ComM_00674]. Значение COMM_SILENT_COM отображает одноименный режим связи Silent Communication [SWS_ComM_00674].

Тип данных ComM_ModeType отображает текущий режим связи и тем самым первичное состояние конечного автомата канала ComM в Communication Manager [SWS_ComM_00672]. Он является производным от базового типа uint8 и предоставляется через заголовочный файл Rte_ComM_Type.h для использования программными компонентами и другими BSW-модулями [SWS_ComM_00672].

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

• COMM_NO_COMMUNICATION (0): сконфигурированный канал находится в состоянии покоя и не имеет возможности передачи или приёма [SWS_ComM_00672].
• COMM_SILENT_COMMUNICATION (1): канал ограничен пассивной способностью к приёму; отправка сообщений заблокирована [SWS_ComM_00672].
• COMM_FULL_COMMUNICATION (2): канал находится в режиме полной связи с активной возможностью передачи и приёма [SWS_ComM_00672].
• COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST (3): канал обладает возможностью передачи и приёма на нижний уровень, например для аппаратного обеспечения Ethernet согласно OPEN Alliance TC10 [SWS_ComM_00672].

При использовании действуют существенные функциональные ограничения: режим COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST снабжён тегом atp.Status=draft и явно предназначен для чисто внутреннего использования внутри конечного автомата канала ComM [SWS_ComM_00672]. Поэтому внешние пользователи или вышестоящие программные компоненты, предположительно, не должны ни запрашивать это состояние в качестве целевого режима, ни ожидать его напрямую через интерфейсы. Вопрос Q-e5f4abe0d6543c82 (открытый) Специфические коды ошибок, проверки во время выполнения или сообщения в DET или DEM для этого типа не определены [SWS_ComM_00672].

Элемент спецификации modeLimitation согласно [SWS_ComM_01009] определён как предоставляемый порт (Provided Port) менеджера связи (ComM) для интерфейса ComM_ECUModeLimitation. Интерпретация: через этот порт-интерфейс модуль ComM, вероятно, предоставляет вышестоящим программным компонентам или BswM механизмы для целенаправленного ограничения активных режимов связи на уровне блока управления, чтобы, например, защитить энергопотребление или режимы работы. Вопрос Q-337c6b40bd72cf76 (открытый)

Предоставление этого порта в системе подчиняется явному условию вариативности: согласно [SWS_ComM_01009] элемент присутствует в системе исключительно тогда, когда задана опция конфигурации {ecuc(ComM/ComMGeneral.ComMModeLimitationEnabled)} == true. Предположительно, отключение этого параметра приводит к тому, что порт опускается во время генерации кода. Вопрос (открытый) Поэтому компоненты прикладного и базового программного обеспечения могут архитектурно подключать этот интерфейс только при активированной опции.

В отношении конкретных операций интерфейса, параметров, реентерабельности, а также сообщений об ошибках в DET или DEM [SWS_ComM_01009] не содержит отдельных положений. Поэтому интеграторы должны прежде всего убедиться, что требуемая конфигурация в контейнере ComMGeneral активирована, прежде чем компоненты будут подключены к порту modeLimitation.

Тип ComMMode специфицирован в модуле ComM как Mode Declaration Group [SWS_ComM_01012]. Элемент отнесён к категории ALPHABETIC_ORDER и определяет базовые режимы связи модуля [SWS_ComM_01012].

Группа включает три обязательных состояния [SWS_ComM_01012]:

• COMM_NO_COMMUNICATION: служит начальным режимом группы [SWS_ComM_01012].
• COMM_SILENT_COMMUNICATION: представляет пассивный режим связи [SWS_ComM_01012].
• COMM_FULL_COMMUNICATION: обозначает режим неограниченной связи [SWS_ComM_01012].

В качестве начального режима определён COMM_NO_COMMUNICATION, благодаря чему система по умолчанию запускается без активной связи [SWS_ComM_01012]. Для переходов отдельное значение («On transition value») не определено [SWS_ComM_01012]; интерпретация: вероятно, это означает, что смена статуса выполняется напрямую без определённых промежуточных состояний. Вопрос Q-f0e73d26f85073b4 (открытый) Интерпретация: эти режимы, вероятно, отображают состояние связи каналов или пользователей связи в модуле. Вопрос Q-ef5fa29f6af152c7 (открытый) Интерпретация: категория ALPHABETIC_ORDER, вероятно, прежде всего задаёт стандартизированное перечисление и представление для интерфейсов RTE. Вопрос Q-12af3dde3a4cc95e (открытый)