Ethernet Interface (EthIf)

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

Функция EthIf_Init инициализирует модуль интерфейса Ethernet ([SWS_EthIf_00024]). Она выполняется синхронно, является нереентерабельной (Non Reentrant) и доступна через заголовочный файл EthIf.h с Service-ID 0x01. В качестве единственного входного параметра функция ожидает указатель CfgPtr, который ссылается на специфичную для реализации структуру конфигурации типа EthIf_ConfigType. Не существует ни параметров inout, ни параметров out, и функция не имеет возвращаемого значения ([SWS_EthIf_00024]).

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

Поскольку EthIf_Init не является реентерабельной, параллельный или вложенный вызов не допускается [SWS_EthIf_00024]. Так как специфический контекст вызова в полезных данных подробнее не описан, вызов предположительно выполняется однократно во время последовательности инициализации ECU до использования других служб Ethernet. Вопрос Q-07e92f9f3c15ea5b (открытый)

Условия последовательности вызовов и взаимодействие

Вызов EthIf_Init образует обязательное условие для использования всех остальных функций модуля. Если активировано обнаружение ошибок разработки (Development Error Detection), многочисленные службы интерфейса Ethernet перед своим выполнением проверяют, вызывалась ли EthIf_Init ранее:

• Если инициализация не была выполнена, зависимые функции сообщают об ошибке разработки ETHIF_E_UNINIT (например, [SWS_EthIf_00155], [SWS_EthIf_00161], [SWS_EthIf_00167], [SWS_EthIf_00173], [SWS_EthIf_00193], [SWS_EthIf_00199], [SWS_EthIf_00217], [SWS_EthIf_00222], [SWS_EthIf_00299], [SWS_EthIf_00302] и [SWS_EthIf_00304]).
• Некоторые интерфейсы прерывают выполнение в случае непроведенной инициализации и дополнительно возвращают значение ошибки E_NOT_OK (например, [SWS_EthIf_00246], [SWS_EthIf_00273], а также [SWS_EthIf_00277]).

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

Функция EthIf_SetControllerMode активирует или деактивирует указанный через CtrlIdx Ethernet-контроллер в контексте интерфейса Ethernet [SWS_EthIf_00034]. Через параметр CtrlMode запрашиваются следующие состояния [SWS_EthIf_00034]:

• ETH_MODE_DOWN: отключает контроллер.
• ETH_MODE_ACTIVE: активирует контроллер.
• ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST: активирует контроллер и запрашивает пробуждение (Wake-up) в сети.

Функция работает асинхронно [SWS_EthIf_00034]. Она возвращает E_OK при успешном выполнении или E_NOT_OK, если не удалось изменить режим контроллера [SWS_EthIf_00034].

Взаимодействие и перенаправление

Если EthIf_SetControllerMode вызывается с ETH_MODE_ACTIVE для контроллера, который ссылается на EthIfSwitchPortGroup типа «control», EthIf перенаправляет вызов всем портам группы при условии, что этот режим запрашивается для порта впервые и его статус равен ETH_MODE_DOWN. При этом последовательно выполняются EthSwt_SetSwitchPortMode с ETH_MODE_ACTIVE и EthSwt_PortLinkStateRequest с ETHTRCV_LINK_STATE_ACTIVE [SWS_EthIf_00264].

При запросе ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST модуль EthIf перенаправляет вызовы независимо от текущего режима следующим образом:

• При ссылке на EthIfTransceiver: вызов EthTrcv_SetTransceiverMode с ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST и затем EthTrcv_TransceiverLinkStateRequest с ETHTRCV_LINK_STATE_ACTIVE, если текущий статус равен ETHTRCV_LINK_STATE_DOWN [SWS_EthIf_00479].
• При ссылке на EthIfSwitch или EthIfSwitchPortGroup типа «control»: вызов EthSwt_SetSwitchPortMode с ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST и затем EthSwt_PortLinkStateRequest с ETHTRCV_LINK_STATE_ACTIVE, если текущее состояние равно ETHTRCV_LINK_STATE_DOWN [SWS_EthIf_00480], [SWS_EthIf_00481].

ограничения

Функция является нереентерабельной (Non Reentrant) и доступна через EthIf.h [SWS_EthIf_00034].

Синхронная и нереентерабельная функция EthIf_SetTransceiverWakeupMode (Service ID 0x2e) служит для установки режима пробуждения приемопередатчика, адресованного через TrcvIdx, в Ethernet Interface или для сброса причины его пробуждения [SWS_EthIf_00233]. Функция объявлена в заголовочном файле EthIf.h и в релизе AUTOSAR CP R20-11 помечена как устаревшая (obsolete) [SWS_EthIf_00233].

Управление осуществляется через передаваемый параметр TrcvWakeupMode [SWS_EthIf_00233]:

• ETHTRCV_WUM_ENABLE: активирует пробуждение приемопередатчика [SWS_EthIf_00233]. Если связанный драйвер EthIfTransceiverIdx в данный момент находится в состоянии ETHTRCV_WUM_DISABLE, вызов перенаправляется в EthTrcv_SetTransceiverWakeupMode [SWS_EthIf_00234].
• ETHTRCV_WUM_DISABLE: деактивирует пробуждение приемопередатчика [SWS_EthIf_00233]. Если текущее состояние драйвера — ETHTRCV_WUM_ENABLE, функция перенаправляет вызов в EthTrcv_SetTransceiverWakeupMode [SWS_EthIf_00268].
• ETHTRCV_WUM_CLEAR: сбрасывает причину пробуждения индексированного приемопередатчика [SWS_EthIf_00233].

В качестве возвращаемого значения вызов возвращает E_OK при успешном выполнении или E_NOT_OK, если режим пробуждения не удалось изменить либо причину пробуждения не удалось сбросить [SWS_EthIf_00233]. Поскольку интерфейс определен как нереентерабельный, параллельные вызовы недопустимы [SWS_EthIf_00233].

Функция EthIf_CheckWakeup запрашивает у соответствующего аппаратного обеспечения Ethernet проверку сигнализированного события пробуждения (Wake-up) [SWS_EthIf_00244]. Это используется, например, для аппаратного обеспечения Ethernet, соответствующего спецификации OPEN Alliance TC10 [SWS_EthIf_00244]. Вызов выполняется асинхронно и реентерабельно интеграционным кодом, на выбор в контексте прерывания или на уровне задач [SWS_EthIf_00244].

Входным параметром служит WakeupSource типа EcuM_WakeupSourceType, который обозначает инициирующее исходное устройство (Ethernet-трансивер или Ethernet-коммутатор) [SWS_EthIf_00244]. Возвращаемое значение равно E_OK, если запрос на проверку был принят аппаратным обеспечением, в противном случае — E_NOT_OK при отклонении запроса [SWS_EthIf_00244]. Модуль внутренне пересылает вызов нижележащим драйверам:

• Для всех затронутых Ethernet-трансиверов (на которые ссылаются через EthIfTransceiver или EthIfSwitchPortGroups) вызывается EthTrcv_CheckWakeup соответствующего драйвера трансивера [SWS_EthIf_00245].
• Для всех затронутых Ethernet-коммутаторов (на которые ссылаются через EthIfSwitch) вызывается EthSwt_SwitchCheckWakeup соответствующего драйвера коммутатора [SWS_EthIf_00500].

Доступность EthIf_CheckWakeup может быть активирована и деактивирована во время предварительной компиляции с помощью конфигурационного параметра EthIfWakeUpSupport [SWS_EthIf_00248]. API предоставляется через заголовочный файл EthIf.h [SWS_EthIf_00244].

Синхронная функция EthIf_UpdatePhysAddrFilter ([SWS_EthIf_00139]) служит для обновления фильтра адресов для Ethernet-контроллера, указанного через CtrlIdx. Через параметр Action (типа Eth_FilterActionType) физический адрес добавляется в фильтр или удаляется из него.

Для конфигурации PhysAddrPtr ожидает указатель на физический MAC-адрес в сетевом порядке байтов, который представляет собой групповой адрес назначения Ethernet-пакета уровня 2 [SWS_EthIf_00139]. Хотя в текстовом описании функции говорится об адресе источника, вероятно, речь идет о редакционной неточности, так как спецификация параметров обязывающим образом определяет групповой адрес назначения. Вопрос Q-312e20e5eadda94a (открытый)

В отношении последовательности выполнения и ограничений действуют следующие предписания [SWS_EthIf_00139]:

• Возвращаемые значения: функция возвращает E_OK, если конфигурация фильтра была успешно изменена, или E_NOT_OK, если изменение не удалось. Специфические коды ошибок DET или DEM в источниках не определены.
• Аппаратная поддержка: если лежащий в основе Ethernet-контроллер на аппаратном уровне не способен выполнять фильтрацию, программное обеспечение должно взять на себя эту задачу фильтрации.
• Параллелизм: вызов не является реэнтрантным для одного и того же индекса контроллера (CtrlIdx), однако может выполняться параллельно для разных контроллеров.

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

Функция EthIf_StoreConfiguration служит для того, чтобы запросить постоянное сохранение изученных таблиц MAC/портов Ethernet-коммутатора [SWS_EthIf_00214]. В качестве типичного вызывающего компонента упоминается, например, Complex Device Driver (CDD) [SWS_EthIf_00214]. Интерфейс доступен через заголовочный файл EthIf.h и имеет ID сервиса 0x2c [SWS_EthIf_00214].

Через входной параметр SwitchIdx передается индекс целевого коммутатора в контексте драйвера Ethernet-коммутатора [SWS_EthIf_00214]. В качестве возвращаемого значения функция передает статус Std_ReturnType: значение E_OK указывает на то, что запрос на сохранение был принят, тогда как E_NOT_OK сигнализирует о непринятии [SWS_EthIf_00214]. Поскольку спецификация обозначает выполнение как синхронное/асинхронное, прием запроса, вероятно, происходит синхронно, тогда как само сохранение, предположительно, обрабатывается асинхронно в нижележащих модулях. Вопрос Q-4f10e936c7d30258 (открытый)

Ограничения и обработка ошибок

Что касается параллелизма, EthIf_StoreConfiguration специфицирована как нереэнтрантная (Non Reentrant) [SWS_EthIf_00214]. Поэтому параллельные вызовы должны исключаться или синхронизироваться на стороне вызывающего компонента. Специфические сообщения об ошибках DET или DEM для этого интерфейса не определены; ошибка при приеме запроса передается исключительно через возвращаемое значение E_NOT_OK [SWS_EthIf_00214].

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

Функция EthIf_ResetConfiguration служит для того, чтобы запросить постоянный сброс динамически изученных таблиц MAC и портов Ethernet-коммутатора [SWS_EthIf_00219]. Статически сконфигурированные записи остаются в конфигурации без изменений [SWS_EthIf_00219]. В качестве вызывающего компонента этого интерфейса может выступать, например, Complex Device Driver (CDD) [SWS_EthIf_00219].

Через передаваемый параметр SwitchIdx указывается индекс соответствующего коммутатора в контексте драйвера Ethernet-коммутатора [SWS_EthIf_00219]. Что касается семантики выполнения, операция обозначена как синхронная/асинхронная [SWS_EthIf_00219]; вероятно, это означает, что прием запроса подтверждается синхронно, тогда как сброс аппаратных таблиц выполняется асинхронно. Вопрос Q-9e7f89ec9e809fd0 (открытый)

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

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

• E_OK: запрос на постоянный сброс таблицы MAC/портов был успешно принят [SWS_EthIf_00219].
• E_NOT_OK: запрос был отклонен [SWS_EthIf_00219].

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

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

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

Синхронная функция EthIf_EnableEgressTimeStamp служит для активации регистрации меток времени передачи (Egress Time Stamping) для выделенного объекта сообщения или буфера передачи [SWS_EthIf_00160]. Интерфейс предоставляется через заголовочный файл EthIf.h [SWS_EthIf_00160].

Параметры и вызов

При вызове функция ожидает передачи двух входных параметров [SWS_EthIf_00160]:

• CtrlIdx: индекс адресуемого контроллера Ethernet [SWS_EthIf_00160].
• BufIdx: индекс буфера сообщений, для которого приложение ожидает регистрацию метки времени передачи [SWS_EthIf_00160].

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

Поведение аппаратного обеспечения и параллелизм

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

В отношении параллелизма функция определена как нереентерабельная (Non Reentrant) [SWS_EthIf_00160].

Асинхронная функция EthIf_SwitchPortGroupRequestMode запрашивает рабочий режим для группы портов коммутатора ([SWS_EthIf_91102]). Вызов специфицирован как нереентерабельный и передает индекс группы портов (PortGroupIdx), а также требуемый целевой режим (PortMode). В качестве режимов доступны ETH_MODE_DOWN для деактивации, ETH_MODE_ACTIVE для активации, а также ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST для активации с пробуждением сети ([SWS_EthIf_91102]). При успешном инициировании функция возвращает E_OK, в противном случае — E_NOT_OK ([SWS_EthIf_91102]).

Как правило, EthIf перенаправляет запрос нижележащему коммутатору путем вызова EthSwt_SetSwitchPortMode для всех связанных портов ([SWS_EthIf_91102]). При этом для различных режимов действуют специфические правила поведения:

• Деактивация (ETH_MODE_DOWN): если порты в данный момент находятся в состоянии ETH_MODE_ACTIVE и для всех групп, ссылающихся на эти порты, был запрошен ETH_MODE_DOWN, EthIf запускает таймер с временем задержки EthIfSwitchOffPortTimedelay ([SWS_EthIf_00270]).
• Активация (ETH_MODE_ACTIVE или ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST): текущий таймер задержки отключения для портов соответствующей группы портов немедленно прерывается ([SWS_EthIf_00483]).
• Запрос пробуждения (ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST): вызов обязательно перенаправляется в фиксированном порядке для всех портов группы независимо от текущего режима портов: сначала вызывается EthSwt_SetSwitchPortMode с ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST, а затем EthSwt_PortLinkStateRequest с ETHTRCV_LINK_STATE_ACTIVE, если текущее состояние линка равно ETHTRCV_LINK_STATE_DOWN ([SWS_EthIf_00482]).

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

Функция EthIf_StartAllPorts служит для запроса на перевод всех сконфигурированных и затрагиваемых портов коммутатора Ethernet в состояние ETH_MODE_ACTIVE ([SWS_EthIf_91103]). Вызов выполняется без параметров, обладает асинхронной семантикой и специфицирован как реентерабельный ([SWS_EthIf_91103]). В качестве возвращаемого значения E_OK сигнализирует о принятии запроса, тогда как E_NOT_OK указывает на отклонение ([SWS_EthIf_91103]).

После вызова EthIf_StartAllPorts EthIf перенаправляет команды управления всем затронутым портам коммутаторов Ethernet (EthSwtPorts) в строго определенном порядке ([SWS_EthIf_00275]):

• Сначала вызывается EthSwt_SetSwitchPortMode с ETH_MODE_ACTIVE, если текущий режим равен ETH_MODE_DOWN ([SWS_EthIf_00275]).
• Затем выполняется вызов EthSwt_PortLinkStateRequest с ETHTRCV_LINK_STATE_ACTIVE, если текущее состояние линка равно ETHTRCV_LINK_STATE_DOWN, и для всех этих портов запускается таймер с интервалом времени EthIfPortStartupActiveTime ([SWS_EthIf_00275]).

Если активированный таким образом порт не запрашивается штатно с ETH_MODE_ACTIVE в течение интервала времени EthIfPortStartupActiveTime, EthIf автоматически снова деактивирует этот порт ([SWS_EthIf_00276]). Деактивация в обязательном порядке выполняется в обратном порядке:

• Сначала вызывается EthSwt_PortLinkStateRequest с ETHTRCV_LINK_STATE_DOWN ([SWS_EthIf_00276]).
• Затем вызывается EthSwt_SetSwitchPortMode с ETH_MODE_DOWN ([SWS_EthIf_00276]).

Функция EthIf_SwitchEnableTimeStamping ([SWS_EthIf_91007]) активирует регистрацию меток времени исходящего трафика (egress) для определенного объекта сообщения на уровне коммутатора. Соответствующий объект передачи адресуется через индекс контроллера CtrlIdx, а также индекс буфера BufIdx.

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

Вызов выполняется синхронно ([SWS_EthIf_91007]). В качестве входных параметров функция ожидает индекс контроллера CtrlIdx в контексте EthIf, а также BufIdx для буфера сообщений, для которого приложение ожидает регистрацию метки времени. Через выходной параметр MgmtInfo типа EthSwt_MgmtInfoType* предоставляется сопутствующая управляющая информация ([SWS_EthIf_91007]).

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

Функция сигнализирует о результате через возвращаемое значение типа Std_ReturnType ([SWS_EthIf_91007]):

• E_OK: фиксация временных меток для исходящего трафика (Egress Time Stamping) успешно активирована ([SWS_EthIf_91007]).
• E_NOT_OK: активация фиксации временных меток не удалась ([SWS_EthIf_91007]).

Ограничения и параллелизм

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

Синхронная интерфейсная функция EthIf_VerifyConfig служит для проверки конфигурации коммутатора и перенаправляет вызов напрямую в EthSwt_VerifyConfig [SWS_EthIf_91012]. Сама проверка выполняется драйвером Ethernet-коммутатора в зависимости от соответствующей аппаратной архитектуры, аппаратных возможностей и предполагаемой точности проверки [SWS_EthIf_91012].

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

Функция доступна через заголовочный файл EthIf.h с ID сервиса 0x40 и ожидает два параметра [SWS_EthIf_91012]:

• SwitchIdx (in): индекс коммутатора в контексте драйвера Ethernet-коммутатора.
• Result (out): указатель на логическое значение, принимающее результат верификации. TRUE обозначает успешно проверенную конфигурацию, тогда как FALSE указывает на обнаруженные повреждения.

В качестве возвращаемого значения Std_ReturnType сообщает статус выполнения: E_OK сигнализирует о том, что верификация успешно завершена, тогда как E_NOT_OK указывает на сбой проверки конфигурации [SWS_EthIf_91012].

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

Функция специфицирована как нереэнтрантная (Non Reentrant) [SWS_EthIf_91012]. Поэтому вызывающие компоненты должны гарантировать отсутствие конкурирующих вызовов. Поскольку полезная нагрузка не содержит специфических кодов ошибок для DET или DEM, детальные проверки параметров (такие как валидация индексов или указателей), вероятно, обрабатываются на стороне драйвера или специфичны для реализации. Вопрос Q-03b5f343e97bec7f (открытый)

Синхронная функция EthIf_SetForwardingMode предоставляется через заголовочный файл EthIf.h и служит для управления пересылкой кадров (Frame Forwarding) на Ethernet-коммутаторе [SWS_EthIf_91013]. Она проверяет текущую конфигурацию коммутатора и при обнаружении недействительности выполняет реконфигурацию коммутатора [SWS_EthIf_91013].

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

При вызове (ID сервиса 0x41) передаются следующие входные параметры [SWS_EthIf_91013]:

• SwitchIdx: индекс соответствующего коммутатора в контексте драйвера Ethernet-коммутатора [SWS_EthIf_91013].
• mode: логический переключатель для активации (TRUE) или деактивации (FALSE) пересылки кадров [SWS_EthIf_91013].

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

• E_OK: согласно спецификации сигнализировало об успешной остановке пересылки; интерпретация: вероятно, в более общем смысле это подтверждает успешное принятие запрошенного режима пересылки [SWS_EthIf_91013]. Вопрос Q-f245de852fe854c0 (открытый)
• E_NOT_OK: переключение или остановка пересылки кадров завершились неудачно [SWS_EthIf_91013].

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

Функция специфицирована как нереэнтрантная (Non Reentrant) [SWS_EthIf_91013]. Поэтому вызывающие компоненты должны обеспечивать сериализованное выполнение вызовов для одного и того же или параллельных контекстов коммутатора и отсутствие конкурирующих вызовов. Специфические коды ошибок для DET или DEM в стандарте для этого сервиса не определены.

Функция EthIf_ClearTrcvSignalQuality служит для синхронной очистки сохранённых значений качества сигнала соединения Ethernet для определённого приёмопередатчика [SWS_EthIf_91059]. Для этого вызывающая сторона с помощью параметра TrcvIdx передаёт индекс приёмопередатчика в контексте Ethernet Interface, после чего соответствующие измеренные значения очищаются [SWS_EthIf_00400].

В качестве возвращаемого значения интерфейс возвращает тип Std_ReturnType: если сброс качества сигнала прошёл успешно, возвращается E_OK, в противном случае операция завершается ошибкой с кодом E_NOT_OK [SWS_EthIf_91059]. Интерпретация: значение ошибки E_NOT_OK, вероятно, обусловлено недопустимыми параметрами индекса или ошибками при передаче нижележащим драйверам, поскольку полезная нагрузка не указывает конкретных кодов ошибок или записей DET. Вопрос Q-40d8f0c1fc7ba11e (открытый)

С точки зрения параллелизма служба реализована как реентерабельная для различных индексов приёмопередатчиков, однако явно нереентерабельна для одного и того же TrcvIdx [SWS_EthIf_91059]. Поэтому несколько вызовов для одного и того же приёмопередатчика не должны выполняться одновременно из параллельных контекстов и должны быть надлежащим образом защищены.

Во взаимодействии модулей данный вызов целенаправленно очищает сохранённые значения качества сигнала типа EthIf_SignalQualityResultType для адресуемого через TrcvIdx EthIfTransceiver [SWS_EthIf_00400]. Объявление синхронного интерфейса с service ID 0x19 предоставляется через заголовочный файл EthIf.h [SWS_EthIf_91059].

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

Синхронная функция EthIf_ClearSwitchPortSignalQuality служит для сброса сохранённых значений качества сигнала для соединения определённого порта Ethernet-коммутатора [SWS_EthIf_91060]. Адресация целевого порта осуществляется через два входных параметра SwitchIdx (индекс Ethernet-коммутатора) и SwitchPortIdx (индекс порта в контексте интерфейса) [SWS_EthIf_91060]. Функция доступна через заголовочный файл EthIf.h [SWS_EthIf_91060].

Взаимодействие и структуры данных

Согласно [SWS_EthIf_00404] вызов очищает внутренне сохраняемые значения качества сигнала адресуемого порта коммутатора, соответствующие типу EthIf_SignalQualityResultType. Это позволяет вышестоящим модулям целенаправленно отбрасывать исторические измеренные значения и инициировать переоценку качества соединения.

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

Успешность операции отображается через возвращаемое значение типа Std_ReturnType: при успешной очистке функция возвращает E_OK, в противном случае — E_NOT_OK [SWS_EthIf_91060]. Специфичные коды ошибок DET или DEM в полезной нагрузке не определены. Интерпретация: возвращаемое значение E_NOT_OK, вероятно, возникает в частности в том случае, если переданы недопустимые индексы или если нижележащий драйвер коммутатора не может выполнить сброс. Вопрос Q-fc42f5b3e5414f6a (открытый)

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

В отношении реентерабельности EthIf_ClearSwitchPortSignalQuality является реентерабельной для различных индексов коммутатора и портов коммутатора [SWS_EthIf_91060]. Однако для одного и того же порта коммутатора (SwitchPortIdx) функция специфицирована как нереентерабельная [SWS_EthIf_91060]. Поэтому вызывающие стороны должны обеспечить, чтобы одновременные вызовы для одного и того же порта предотвращались или защищались подходящими механизмами синхронизации.

Синхронная интерфейсная функция EthIf_SetPhyTestMode служит для активации заданного тестового режима на Ethernet-трансивере [SWS_EthIf_91016]. Сервис объявлен в заголовочном файле EthIf.h и идентифицируется шестнадцатеричным ID сервиса 0x17 [SWS_EthIf_91016].

Для вызова функция ожидает передачу двух входных параметров [SWS_EthIf_91016]:

• TrcvIdx: определяет числовой индекс целевого трансивера в контексте Ethernet Interface [SWS_EthIf_91016].
• Mode: определяет конкретный активируемый тестовый режим типа EthTrcv_PhyTestModeType [SWS_EthIf_91016].

Входно-выходные параметры отсутствуют [SWS_EthIf_91016]. В качестве возвращаемого значения сервис возвращает статус типа Std_ReturnType [SWS_EthIf_91016]. Возвращаемое значение E_OK подтверждает, что запрос на активацию тестового режима был успешно принят [SWS_EthIf_91016]. Значение E_NOT_OK, напротив, указывает на то, что запрос был отклонен и тестовый режим активировать не удалось [SWS_EthIf_91016].

Что касается параллелизма, EthIf_SetPhyTestMode специфицирована как реэнтрантная для разных индексов трансиверов (TrcvIdx) [SWS_EthIf_91016]. Для одного и того же индекса трансивера выполнение явно не является реэнтрантным [SWS_EthIf_91016]. Поэтому вызывающие компоненты должны гарантировать избежание конкурирующих вызовов для одного и того же экземпляра трансивера и взамен координировать их последовательно.

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

Синхронная функция EthIf_SetPhyLoopbackMode служит для активации заданного режима шлейфа на Ethernet-трансивере [SWS_EthIf_91018]. Объявление доступно через заголовочный файл EthIf.h [SWS_EthIf_91018].

При вызове функция ожидает два входных параметра:

• TrcvIdx: индекс трансивера в контексте Ethernet Interface [SWS_EthIf_91018].
• Mode: активируемый режим шлейфа типа EthTrcv_PhyLoopbackModeType [SWS_EthIf_91018].

В качестве возвращаемого значения функция возвращает статус типа Std_ReturnType: E_OK сигнализирует о том, что запрос был принят, тогда как E_NOT_OK указывает на то, что запрос не удалось принять [SWS_EthIf_91018]. Интерпретация: вероятно, функция синхронно перенаправляет вызов в драйвер Ethernet-трансивера, отвечающий за TrcvIdx. Вопрос Q-c4736bbfd250cca0 (открытый)

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

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

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

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

Синхронная функция интерфейса EthIf_SetPhyTxMode служит для активации указанного режима передачи для приемопередатчика Ethernet [SWS_EthIf_91005]. Объявление функции выполняется в заголовочном файле EthIf.h под Service ID 0x13 [SWS_EthIf_91005].

Для вызова функция ожидает два входных параметра [SWS_EthIf_91005]:

• TrcvIdx: числовой индекс соответствующего приемопередатчика в контексте интерфейса Ethernet.
• Mode: конкретный активируемый режим передачи типа EthTrcv_PhyTxModeType.

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

Что касается поведения при параллелизме, EthIf_SetPhyTxMode реентерабельна для различных индексов приемопередатчиков (TrcvIdx) [SWS_EthIf_91005]. Однако если выполняются вызовы для одного и того же индекса приемопередатчика, функция определена как нереентерабельная и требует синхронизированного или последовательного вызова [SWS_EthIf_91005].

В качестве формального ограничения следует учитывать, что данный элемент интерфейса в спецификации AUTOSAR CP R20-11 помечен статусом draft [SWS_EthIf_91005].

Синхронная и реентерабельная функция EthIf_ProvideTxBuffer (Service ID 0x09) предоставляет доступ к буферу передачи Ethernet-контроллера, указанного с помощью CtrlIdx, и доступна через заголовочный файл EthIf.h [SWS_EthIf_00067].

Для запроса буфера вызывающая сторона передает индекс контроллера (CtrlIdx), тип кадра Ethernet (FrameType), а также приоритет (Priority) для 3-битного поля PCP тега VLAN [SWS_EthIf_00067]. С помощью входного и выходного параметра LenBytePtr вызывающая сторона задает желаемый размер буфера в байтах и получает обратно фактически предоставленную длину [SWS_EthIf_00067]. При успешном выделении функция предоставляет указатель на буфер через BufPtr и индекс ресурса буфера для последующих запросов через BufIdxPtr [SWS_EthIf_00067].

Результат запроса буфера возвращается через тип возвращаемого значения BufReq_ReturnType [SWS_EthIf_00067]:

• BUFREQ_OK: буфер был успешно предоставлен [SWS_EthIf_00067].
• BUFREQ_E_BUSY: все ресурсы буфера в данный момент заняты [SWS_EthIf_00067].
• BUFREQ_E_OVFL: запрошенная длина буфера превышает доступный размер [SWS_EthIf_00067].
• BUFREQ_E_NOT_OK: обнаружена ошибка разработки [SWS_EthIf_00067].

Синхронная функция EthIf_Transmit инициирует передачу ранее предоставленного и заполненного буфера передачи через интерфейс Ethernet [SWS_EthIf_00075].

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

Вызов осуществляется через интерфейс, объявленный в EthIf.h, со следующими входными параметрами [SWS_EthIf_00075]:

• CtrlIdx: индекс Ethernet-контроллера в контексте модуля EthIf.
• BufIdx: индекс передаваемого буферного ресурса.
• FrameType: тип Ethernet-кадра.
• TxConfirmation: управляет активацией подтверждения передачи.
• LenByte: длина данных в байтах.
• PhysAddrPtr: физический целевой адрес (MAC-адрес) в сетевом порядке байтов.

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

В качестве возвращаемого значения функция возвращает E_OK при успешном запуске передачи или E_NOT_OK, если передача не удалась [SWS_EthIf_00075]. Функция является реентерабельной для вызовов с различными индексами буферов и контроллеров (BufIdx и CtrlIdx) [SWS_EthIf_00075].

Функция EthIf_SwitchPortGetLinkState служит согласно [SWS_EthIf_91109] для запроса текущего состояния соединения определённого порта коммутатора. Передаются индекс коммутатора SwitchIdx в контексте драйвера Ethernet-коммутатора, а также индекс порта SwitchPortIdx на адресуемом коммутаторе. Результат запроса предоставляется через указатель LinkStatePtr, который принимает значение либо ETHTRCV_LINK_STATE_DOWN (порт отключён), либо ETHTRCV_LINK_STATE_ACTIVE (порт подключён). В спецификации поведение выполнения указано как синхронное или асинхронное; вероятно, это зависит от нижележащего драйвера коммутатора или аппаратного подключения. Вопрос Q-dde6f9e8f1b8ba52 (открытый)

В качестве возвращаемого значения функция возвращает Std_ReturnType ([SWS_EthIf_91109]). При успешном запросе возвращается E_OK. Если определение состояния соединения завершается сбоем или функция вызывается, когда коммутатор находится в состоянии ETHSWT_STATE_UNINIT или ETHSWT_STATE_INIT, возвращается E_NOT_OK.

С точки зрения параллелизма функция специфицирована как нереентерабельная (Non Reentrant) ([SWS_EthIf_91109]), поэтому одновременные вызовы в одном и том же контексте должны быть исключены. Объявление доступно через заголовочный файл EthIf.h с service ID 0x4b.

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

Синхронная функция EthIf_TransceiverGetLinkState служит для запроса текущего состояния соединения (link state) адресуемого через TrcvIdx приёмопередатчика Ethernet согласно [SWS_EthIf_91110]. Объявление интерфейса предоставляется через заголовочный файл EthIf.h [SWS_EthIf_91110].

При вызове передаются следующие параметры [SWS_EthIf_91110]:

• TrcvIdx (входной): индекс приёмопередатчика в контексте Ethernet Transceiver Driver.
• LinkStatePtr (выходной): указатель на область памяти для определённого состояния типа EthTrcv_LinkStateType. Возможными значениями результата являются ETHTRCV_LINK_STATE_ACTIVE для подключённого и ETHTRCV_LINK_STATE_DOWN для отключённого приёмопередатчика.

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

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

Если запрос завершается сбоем, служба с service ID 0x4c возвращает возвращаемое значение E_NOT_OK [SWS_EthIf_91110]. Специфичные сообщения об ошибках DET или DEM в спецификации функции не приведены.

Параллелизм

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

Функция EthIf_SwitchPortGetBaudRate служит для запроса текущей скорости передачи определённого порта Ethernet-коммутатора согласно [SWS_EthIf_91111]. При вызове передаются индекс коммутатора (SwitchIdx) и индекс порта на адресуемом коммутаторе (SwitchPortIdx). Результат запроса предоставляется через указатель BaudRatePtr типа EthTrcv_BaudRateType*, который может отображать такие скорости, как ETHTRCV_BAUD_RATE_10MBIT, ETHTRCV_BAUD_RATE_100MBIT, ETHTRCV_BAUD_RATE_1000MBIT или ETHTRCV_BAUD_RATE_2500MBIT [SWS_EthIf_91111].

Что касается обработки ошибок, при успешном определении скорости в бодах функция возвращает E_OK. Возвращаемое значение E_NOT_OK сигнализирует о том, что скорость в бодах для указанного порта коммутатора не удалось считать или что драйвер коммутатора находится в состоянии ETHSWT_STATE_UNINIT либо ETHSWT_STATE_INIT [SWS_EthIf_91111].

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

Синхронная функция EthIf_TransceiverGetBaudRate с service ID 0x4e служит для считывания текущей скорости передачи данных индексированного приёмопередатчика Ethernet [SWS_EthIf_91112]. Она входит в состав модуля EthIf и предоставляется через заголовочный файл EthIf.h [SWS_EthIf_91112].

Входной параметр TrcvIdx типа uint8 идентифицирует приёмопередатчик в контексте драйвера Ethernet-приёмопередатчика [SWS_EthIf_91112]. Inout-параметры отсутствуют [SWS_EthIf_91112]. Результат запроса возвращается через выходной параметр BaudRatePtr [SWS_EthIf_91112]. Допустимыми значениями типа Eth_Trcv_BaudRateType являются ETHTRCV_BAUD_RATE_10MBIT (10 Мбит/с), ETHTRCV_BAUD_RATE_100MBIT (100 Мбит/с), ETHTRCV_BAUD_RATE_1000MBIT (1000 Мбит/с), а также ETHTRCV_BAUD_RATE_2500MBIT (2500 Мбит/с) [SWS_EthIf_91112].

Функция возвращает статус типа Std_ReturnType: при успешном вызове возвращается E_OK [SWS_EthIf_91112]. Если приёмопередатчик не удалось инициализировать, служба завершается сбоем и возвращает E_NOT_OK [SWS_EthIf_91112].

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

Функция EthIf_SwitchPortGetDuplexMode служит для запроса текущего режима дуплекса индексированного порта на Ethernet-коммутаторе [SWS_EthIf_91113]. Она перенаправляет вызов функции EthSwt_GetDuplexMode драйвера Ethernet-коммутатора, сопоставленного через SwitchIdx [SWS_EthIf_00428].

Параметры и интерфейс

• SwitchIdx: индекс Ethernet-коммутатора в контексте драйвера [SWS_EthIf_91113].
• SwitchPortIdx: индекс соответствующего порта на адресуемом коммутаторе [SWS_EthIf_91113].
• DuplexModePtr: выходной указатель типа EthTrcv_DuplexModeType* для определённого режима, либо ETHTRCV_DUPLEX_MODE_HALF (полудуплекс), либо ETHTRCV_DUPLEXMODE_FULL (полный дуплекс) [SWS_EthIf_91113].

Выполнение и обработка ошибок

Возвращаемое значение E_OK сигнализирует об успешном запросе [SWS_EthIf_91113]. Если режим дуплекса порта не может быть определён или драйвер находится в состояниях ETHSWT_STATE_UNINIT либо ETHSWT_STATE_INIT, функция возвращает E_NOT_OK [SWS_EthIf_91113].

Интерфейс является нереентерабельным (Non Reentrant) и объявлен в спецификации как синхронный/асинхронный [SWS_EthIf_91113]. Интерпретация: фактический синхронный или асинхронный принцип работы, вероятно, зависит от характеристик подключённого драйвера коммутатора. Вопрос Q-339413722431978f (открытый)

Синхронная функция EthIf_TransceiverGetDuplexMode определяет текущий режим дуплекса индексированного приёмопередатчика Ethernet согласно [SWS_EthIf_91114].

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

Вызов выполняется синхронно и специфицирован как нереентерабельный (Non Reentrant) [SWS_EthIf_91114]:

• TrcvIdx: передаёт в качестве входного параметра индекс приёмопередатчика в контексте драйвера Ethernet-приёмопередатчика [SWS_EthIf_91114].
• DuplexModePtr: служит выходным указателем на тип EthTrcv_DuplexModeType для сохранения результата. Возможными значениями являются ETHTRCV_DUPLEX_MODE_HALF (полудуплекс) или ETHTRCV_DUPLEX_MODE_FULL (полный дуплекс) [SWS_EthIf_91114].

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

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

• E_OK: режим дуплекса был успешно запрошен и предоставлен через DuplexModePtr [SWS_EthIf_91114].
• E_NOT_OK: определение завершилось ошибкой, согласно спецификации, например, если приёмопередатчик не удалось инициализировать [SWS_EthIf_91114].

Ограничения и параллелизм

Поскольку интерфейс нереентерабелен, параллельные вызовы для одного и того же или различных экземпляров приёмопередатчика без внешней синхронизации недопустимы. Объявление доступно через заголовочный файл EthIf.h [SWS_EthIf_91114].

Синхронная функция EthIf_SwitchPortGetCounterValues служит для считывания значений счетчиков сброшенных пакетов (Drop Counter) определенного порта коммутатора Ethernet согласно [SWS_EthIf_91115]. Предоставляемая через заголовочный файл EthIf.h, функция принимает индекс коммутатора SwitchIdx, а также индекс порта SwitchPortIdx и возвращает значения счетчиков через указатель CounterPtr ([SWS_EthIf_91115]).

Принцип работы и перенаправление

Согласно [SWS_EthIf_00432], EthIf_SwitchPortGetCounterValues напрямую перенаправляет запрос функции EthSwt_GetCounterValues соответствующего драйвера коммутатора Ethernet. Возвращаемые значения счетчиков ориентируются на стандарты IETF RFC 1757, RFC 1643 и RFC 2233, при этом точное семантическое значение закреплено за структурой Eth_CounterType ([SWS_EthIf_91115]).

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

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

• E_OK: считывание значений счетчиков выполнено успешно ([SWS_EthIf_91115]).
• E_NOT_OK: при считывании значений счетчиков произошла ошибка ([SWS_EthIf_91115]).

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

Функция специфицирована как нереентрабельная (Non Reentrant) ([SWS_EthIf_91115]). Поэтому параллельные вызовы должны синхронизироваться на уровне вызывающей стороны. Интерпретация: кроме того, вызывающая сторона, по всей видимости, отвечает за предоставление действительной и достаточно емкой области памяти для CounterPtr, поскольку в спецификации внутреннее выделение буфера не упоминается. Вопрос Q-140661eaa9693cce (открытый)

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

Функция EthIf_SwitchPortGetRxStats ([SWS_EthIf_91116]) служит для запроса счётчиков статистики приёма для порта Ethernet-коммутатора. Она доступна через заголовочный файл EthIf.h и значится под service ID 0x52 ([SWS_EthIf_91116]).

Вызов требует следующих параметров ([SWS_EthIf_91116]):

• SwitchIdx: индекс Ethernet-коммутатора в контексте драйвера Ethernet-коммутатора.
• SwitchPortIdx: индекс порта на адресуемом коммутаторе.
• RxStatsPtr: указатель на структуру типа Eth_RxStatsType, в которую записываются значения счётчиков. Большая часть этих значений получена из IETF RFC 2819 (Remote Network Monitoring Management Information Base).

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

Функция возвращает в качестве результата Std_ReturnType ([SWS_EthIf_91116]):

• E_OK: статистические данные успешно считаны.
• E_NOT_OK: значения счётчиков не удалось определить ([SWS_EthIf_91116]). Специфичные сообщения об ошибках DET или DEM для этого вызова не специфицированы.

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

Функция классифицирована как нереентерабельная (Non Reentrant) ([SWS_EthIf_91116]). Поскольку синхронность указана как «Synchronous /Asynchronous», фактическое блокирующее поведение, вероятно, зависит от реализации нижележащего драйвера Ethernet-коммутатора ([SWS_EthIf_91116]). Вопрос Q-d1e839075bf42e7f (открытый) Вызывающие стороны должны избегать параллельного доступа к одному и тому же интерфейсу.

Функция EthIf_SwitchPortGetTxStats служит для считывания статистики передачи согласно IETF RFC1213 для определённого порта Ethernet-коммутатора [SWS_EthIf_91117]. Она доступна через заголовочный файл EthIf.h с service ID 0x53 [SWS_EthIf_91117].

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

При вызове индекс коммутатора (SwitchIdx) и индекс порта на адресуемом коммутаторе (SwitchPortIdx) передаются в качестве входных параметров [SWS_EthIf_91117]. Определённые показания счётчиков предоставляются через указатель TxStatsPtr типа Eth_TxStatsType* [SWS_EthIf_91117]. Если счётчик недоступен или не поддерживается, максимально возможное значение счётчика сигнализирует о недопустимом значении [SWS_EthIf_91117].

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

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

• E_OK: статистика передачи успешно определена [SWS_EthIf_91117].
• E_NOT_OK: статистику передачи получить не удалось [SWS_EthIf_91117].

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

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

Согласно спецификации EthIf_SwitchPortGetTxStats определена как асинхронная (Asynchronous) и нереентерабельная (Non Reentrant) [SWS_EthIf_91117]. Из-за отсутствия реентерабельности одновременные вызовы не должны выполняться без вышестоящей синхронизации [SWS_EthIf_91117]. Поскольку служба объявлена как асинхронная, переданный буфер TxStatsPtr, вероятно, должен оставаться действительным до полного завершения операции (интерпретация: стабильность буфера при асинхронном запросе) [SWS_EthIf_91117]. Вопрос Q-8a14618d6990206b (открытый)

Предоставляемая через EthIf.h синхронная функция EthIf_SwitchPortGetTxErrorCounterValues (Service-ID 0x54) считывает список счетчиков ошибок передачи для порта коммутатора Ethernet [SWS_EthIf_91118]. Счетчики соответствуют определениям из IETF RFC1213, а также RFC1643 и предоставляются через тип Eth_TxErrorCounterValuesType в выходном параметре TxStatsPtr [SWS_EthIf_91118].

При вызове SwitchIdx адресует коммутатор в контексте драйвера, а SwitchPortIdx — конкретный порт на коммутаторе [SWS_EthIf_91118]. Функция возвращает E_OK при успешном определении значений и E_NOTOK, если статистику передачи получить не удалось [SWS_EthIf_91118]. При этом значение счетчика, принимающее максимально возможное значение, явно обозначает недействительный или недоступный счетчик [SWS_EthIf_91118].

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

Функция EthIf_SwitchPortGetMacLearningMode опрашивает текущий режим обучения MAC для определенного порта коммутатора ([SWS_EthIf_91119]). К определяемым режимам относятся включенное аппаратное обучение, отключенное аппаратное обучение, а также включенное программное обучение ([SWS_EthIf_91119]). Доступность этой функции зависит от аппаратного обеспечения, поскольку соответствующее аппаратное обеспечение коммутатора должно поддерживать различные режимы обучения ([SWS_EthIf_91119]).

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

Интерфейс предоставляется через заголовочный файл EthIf.h и имеет идентификатор службы (Service ID) 0x55 ([SWS_EthIf_91119]). При вызове должны быть переданы следующие параметры:

• SwitchIdx (in): индекс коммутатора в контексте драйвера Ethernet-коммутатора ([SWS_EthIf_91119]).
• SwitchPortIdx (in): индекс порта на адресуемом коммутаторе ([SWS_EthIf_91119]).
• MacLearningModePtr (out): указатель на область памяти типа EthSwt_MacLearningType, в которой сохраняется определенный режим ([SWS_EthIf_91119]).

Синхронизация, параллелизм и возвращаемые значения

Выполнение определено как синхронное/асинхронное и является нереентерабельным (Non Reentrant) ([SWS_EthIf_91119]). В качестве возвращаемого значения используется Std_ReturnType со следующими статусами:

• E_OK: опрос успешно выполнен ([SWS_EthIf_91119]).
• E_NOT_OK: ошибка выполнения ([SWS_EthIf_91119]). В описании спецификации к E_NOT_OK хотя и указано буквально «configuration could be persistently reset», интерпретация: вероятно, это редакционная ошибка копирования в спецификации, которая в обычном контексте просто сигнализирует о неудачном завершении опроса. Вопрос Q-7565d2fbd70e355d (открытый)

Синхронный интерфейс EthIf_WritePortMirrorConfiguration служит для сохранения конфигурации зеркалирования портов в теневом буфере внутри драйвера Ethernet-коммутатора [SWS_EthIf_91122].

При вызове передаются следующие входные параметры [SWS_EthIf_91122]:

• MirroredSwitchIdx: индекс соответствующего коммутатора в контексте драйвера Ethernet-коммутатора, на котором находится зеркалируемый порт коммутатора [SWS_EthIf_91122].
• PortMirrorConfigurationPtr: указатель на данные конфигурации структуры EthSwt_PortMirrorCfgType [SWS_EthIf_91122].

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

• E_OK: конфигурация зеркалирования портов была успешно записана для индексированного порта [SWS_EthIf_91122].
• E_NOT_OK: не удалось записать конфигурацию, например из-за недоступности индексированного коммутатора [SWS_EthIf_91122].
• ETHSWT_PORT_MIRRORING_CONFIGURATION_NOT_SUPPORTED: зеркалирование портов не поддерживается аппаратным обеспечением коммутатора или драйвером Ethernet-коммутатора [SWS_EthIf_91122].

Функция специфицирована как нереентерабельная (Non Reentrant) и доступна через заголовочный файл EthIf.h [SWS_EthIf_91122]. Интерпретация: вызывающим сторонам, по всей видимости, требуется координировать параллельные обращения с помощью вышестоящих механизмов, так как внутренняя защита синхронизации не специфицирована. Вопрос Q-c731aedd871251a4 (открытый)

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

Функция EthIf_ReadPortMirrorConfiguration предназначена для опроса конфигурации зеркалирования портов определенного Ethernet-коммутатора [SWS_EthIf_91123]. Она объявлена в заголовочном файле EthIf.h и имеет идентификатор службы 0x59. Поведение при выполнении специфицировано как асинхронное (Asynchronous), при этом непосредственный вызов возвращает значение статуса типа Std_ReturnType [SWS_EthIf_91123].

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

• MirroredSwitchIdx (in): индекс Ethernet-коммутатора в контексте драйвера Ethernet-коммутатора, на котором находятся зеркалируемые порты коммутатора [SWS_EthIf_91123].
• PortMirrorConfigurationPtr (out): указатель на область памяти, в которой должна быть сохранена считанная конфигурация [SWS_EthIf_91123].
• Возвращаемое значение: E_OK сигнализирует об успешном считывании конфигурации. В случае ошибки возвращается E_NOT_OK, например если индексированный Ethernet-коммутатор недоступен [SWS_EthIf_91123].

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

Для выполнения EthIf_ReadPortMirrorConfiguration перенаправляет вызов напрямую в функцию EthSwt_ReadPortMirrorConfiguration соответствующего драйвера Ethernet-коммутатора [SWS_EthIf_00448]. Функция определена как нереентерабельная (Non Reentrant) [SWS_EthIf_91123]; поэтому вызывающая сторона должна избегать параллельных вызовов для одного и того же интерфейса.

Синхронная функция EthIf_DeletePortMirrorConfiguration служит для удаления сохраненной конфигурации зеркалирования портов для определенного коммутатора ([SWS_EthIf_91124]). Вызывающая сторона передает через параметр Mirrored Switch Idx индекс коммутатора в контексте Ethernet Switch Driver ([SWS_EthIf_91124]). Интерфейс имеет идентификатор службы 0x5a и предоставляется через заголовочный файл EthIf.h ([SWS_EthIf_91124]).

Возвращаемое значение типа Std_ReturnType сообщает о результате удаления ([SWS_EthIf_91124]):

• E_OK: конфигурация зеркалирования портов успешно удалена ([SWS_EthIf_91124]). Если для указанного индекса коммутатора сохраненная конфигурация не найдена, функция по определению также возвращает E_OK ([SWS_EthIf_91124]).
• E_NOT_OK: удаление конфигурации завершилось сбоем ([SWS_EthIf_91124]). Это происходит, например, если зеркалирование портов на момент вызова все еще активировано ([SWS_EthIf_91124]).

Что касается параллелизма, функция является реентерабельной для различных индексов коммутаторов (Mirrored Switch Idx), однако нереентерабельна при многократных вызовах для одного и того же индекса ([SWS_EthIf_91124]). Поскольку активное зеркалирование явно указано как причина ошибки для E_NOT_OK, вероятно, перед удалением конфигурации потребуется отключить зеркалирование портов ([SWS_EthIf_91124]). Вопрос Q-b9e5665de687dbba (открытый)

Синхронная функция EthIf_SetPortMirrorState служит для установки требуемого состояния конфигурации зеркалирования портов для указанного Ethernet-коммутатора ([SWS_EthIf_91126]). Она доступна через заголовочный файл EthIf.h ([SWS_EthIf_91126]).

При вызове функция ожидает три параметра ([SWS_EthIf_91126]):

• MirroredSwitchIdx: индекс Ethernet-коммутатора в контексте Ethernet Switch Driver, на котором находится активируемая или деактивируемая конфигурация зеркалирования портов.
• PortIdx: индекс порта на адресуемом Ethernet-коммутаторе.
• PortMirrorState: запрашиваемое состояние зеркалирования портов, либо PORT_MIRRORING_ENABLED, либо PORT_MIRRORING_DISABLED.

Возвращаемое значение типа Std_ReturnType сигнализирует о результате запроса ([SWS_EthIf_91126]):

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

Выполнение происходит синхронно и определено как нереентерабельное (Non Reentrant) ([SWS_EthIf_91126]). В стеке уровней пересылку берет на себя Ethernet Interface: согласно [SWS_EthIf_00454] EthIf_SetPortMirrorState перенаправляет вызов напрямую в функцию EthSwt_SetPortMirrorState соответствующего Ethernet Switch Driver.

Функция EthIf_SetPortTestMode служит для активации заданного тестового режима на индексированном порту Ethernet-коммутатора [SWS_EthIf_91127]. Синхронная служба доступна через заголовочный файл EthIf.h с идентификатором службы 0x5d [SWS_EthIf_91127].

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

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

• SwitchIdx (uint8): индекс коммутатора в контексте соответствующего драйвера Ethernet-коммутатора [SWS_EthIf_91127].
• PortIdx (uint8): индекс порта на адресуемом Ethernet-коммутаторе [SWS_EthIf_91127].
• Mode (EthTrcv_PhyTestModeType): тестовый режим, активируемый на порту коммутатора [SWS_EthIf_91127].

Возвращаемое значение типа Std_ReturnType сигнализирует об успехе операции [SWS_EthIf_91127]:

• E_OK: тестовый режим порта для индексированного порта Ethernet-коммутатора успешно установлен [SWS_EthIf_91127].
• E_NOT_OK: установка тестового режима порта не удалась, например если адресуемый порт Ethernet-коммутатора недоступен [SWS_EthIf_91127].

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

Функция специфицирована как нереентерабельная (Non Reentrant) и работает синхронно [SWS_EthIf_91127]. При вызове EthIf_SetPortTestMode перенаправляет запрос напрямую в нижележащую функцию EthSwt_SetPortTestMode соответствующего драйвера Ethernet-коммутатора [SWS_EthIf_00456].

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

Функция EthIf_SetPortLoopbackMode служит для того, чтобы активировать заданный тестовый режим шлейфа для индексированного порта Ethernet-коммутатора [SWS_EthIf_91128]. Объявление предоставляется через заголовочный файл EthIf.h [SWS_EthIf_91128]. При вызове передаются следующие входные параметры:

• SwitchIdx: индекс Ethernet-коммутатора в контексте драйвера Ethernet-коммутатора [SWS_EthIf_91128].
• PortIdx: индекс соответствующего порта на предварительно адресованном коммутаторе [SWS_EthIf_91128].
• Mode: активируемый режим шлейфа типа EthTrcv_PhyLoopbackModeType [SWS_EthIf_91128].

Взаимодействие и перенаправление

Функция не выполняет конфигурацию на аппаратном уровне самостоятельно. Вместо этого EthIf_SetPortLoopbackMode перенаправляет вызов напрямую в функцию EthSwt_SetPortLoopbackMode соответствующего драйвера Ethernet-коммутатора [SWS_EthIf_00458].

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

Возвращаемое значение имеет тип Std_ReturnType [SWS_EthIf_91128]:

• E_OK: режим шлейфа успешно активирован для индексированного порта Ethernet-коммутатора [SWS_EthIf_91128].
• E_NOT_OK: активация завершилась неудачно, например если индексированный порт Ethernet-коммутатора недоступен [SWS_EthIf_91128].

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

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

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

Синхронная функция EthIf_SetPortTxMode активирует заданный режим передачи для индексированного порта Ethernet-коммутатора [SWS_EthIf_91129]. Она доступна через заголовочный файл EthIf.h и имеет идентификатор службы 0x5f [SWS_EthIf_91129].

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

Вызов адресует целевой порт через два индекса и передает требуемый режим [SWS_EthIf_91129]:

• SwitchIdx: индекс коммутатора в контексте драйвера Ethernet-коммутатора.
• PortIdx: индекс порта на адресуемом коммутаторе.
• Mode: активируемый режим передачи типа EthTrcv_PhyTxModeType.

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

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

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

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

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

Асинхронный интерфейс EthIf_RunPortCableDiagnostic инициирует диагностику кабеля для выбранного порта Ethernet-коммутатора [SWS_EthIf_91131]. При вызове передаются параметры SwitchIdx (индекс коммутатора в контексте драйвера Ethernet-коммутатора) и PortIdx (индекс адресуемого порта на коммутаторе). Функция возвращает E_OK, как только триггер диагностики кабеля был принят; если запуск отклонен, возвращается E_NOT_OK [SWS_EthIf_91131].

Взаимодействие и предварительные условия

При выполнении EthIf_RunPortCableDiagnostic компонент EthIf обязан убедиться, что соответствующий EthIfController находится в рабочем состоянии ETH_MODE_ACTIVE [SWS_EthIf_00464]. При этом условии Ethernet Interface перенаправляет вызов в функцию EthSwt_RunPortCableDiagnostic назначенного драйвера коммутатора [SWS_EthIf_00464].

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

Функция является реентерабельной для не совпадающих между собой значений SwitchIdx и PortIdx [SWS_EthIf_91131]. Однако для идентичных пар из индекса коммутатора и индекса порта вызов специфицирован как нереентерабельный, поэтому параллельного выполнения на одном и том же порту следует избегать.

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

Функция EthIf_RunCableDiagnostic инициирует диагностику кабеля для указанного трансивера Ethernet [SWS_EthIf_91132]. Она предоставляется через заголовочный файл EthIf.h и значится под идентификатором службы 0x62 [SWS_EthIf_91132]. В качестве передаваемого параметра выступает TrcvIdx, который отражает индекс целевого трансивера в контексте драйвера Ethernet-трансивера [SWS_EthIf_91132].

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

• E_OK: триггер диагностики кабеля успешно принят [SWS_EthIf_91132].
• E_NOT_OK: триггер не принят [SWS_EthIf_91132].

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

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

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

Что касается параллелизма, EthIf_RunCableDiagnostic реентерабельна для вызовов с разными индексами (TrcvIdx), однако нереентерабельна для одного и того же индекса трансивера [SWS_EthIf_91132]. Одновременные запросы диагностики на одном и том же трансивере должны предотвращаться вызывающей стороной. Интерпретация: поскольку функция работает чисто асинхронно и не возвращает данных с результатами, предоставление результата диагностики, вероятно, осуществляется через отдельный механизм. Вопрос Q-c65c009cd2e00dea (открытый)

Интерфейсная функция EthIf_SwitchGetCfgDataRaw служит для чтения конфигурационных данных или данных памяти индексированного Ethernet-коммутатора переменной длины [SWS_EthIf_91133]. В рамках многоуровневой модели модуль не обрабатывает вызов самостоятельно, а перенаправляет его непосредственно в функцию EthSwt_GetCfgDataRaw соответствующего драйвера Ethernet-коммутатора [SWS_EthIf_00468]. Функция объявлена в заголовочном файле EthIf.h и имеет идентификатор службы (Service ID) 0x63 [SWS_EthIf_91133].

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

Вызов выполняется асинхронно и лишь инициирует операцию чтения [SWS_EthIf_91133]. В качестве параметров функция ожидает:

• SwitchIdx: индекс Ethernet-коммутатора в контексте драйвера Ethernet-коммутатора [SWS_EthIf_91133],
• Offset: начальное смещение в памяти Ethernet-коммутатора, с которого начинается процесс чтения [SWS_EthIf_91133],
• Length: количество считываемых и копируемых байтов данных [SWS_EthIf_91133],
• BufferPtr: указатель на целевую область памяти, в которую должны быть скопированы данные [SWS_EthIf_91133].

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

Параллелизм

Функция определена как нереентерабельная (Non Reentrant) [SWS_EthIf_91133]. Поэтому вызывающие компоненты должны обеспечить последовательное выполнение вызовов. Интерпретация: из-за асинхронного характера содержимое буфера при возврате из E_OK, вероятно, еще не будет окончательно заполнено, а будет предоставлено драйвером с задержкой по времени. Вопрос Q-0abda93fb8830dd4 (открытый)

Функция EthIf_SwitchGetCfgDataInfo определяет общий размер конфигурационных данных, а также начальный адрес конфигурационных регистров для индексированного Ethernet-коммутатора [SWS_EthIf_91134]. Интерфейс объявлен в заголовочном файле EthIf.h и имеет идентификатор службы (Service ID) 0x64 [SWS_EthIf_91134].

Функция принимает следующие параметры [SWS_EthIf_91134]:

• SwitchIdx (in): индекс Ethernet-коммутатора в контексте драйвера Ethernet-коммутатора.
• DataSizePtr (out): указатель на область памяти, в которую должен быть скопирован общий размер конфигурационных данных.
• DataAdressPtr (out): указатель на область памяти, в которую должен быть скопирован начальный адрес конфигурационных регистров.

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

Для контекста вызова функция специфицирована как реентерабельная, а также формально как асинхронная [SWS_EthIf_91134]. Поскольку механизмы обратного вызова не специфицированы, предоставление данных при возврате из E_OK, вероятно, происходит непосредственно (интерпретация: классификация как асинхронная, предположительно, указывает на внутренние обращения драйвера). Вопрос Q-bf49882a16548ea4 (открытый)

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

Функция EthIf_SwitchPortGetMaxFIFOBufferFillLevel определяет максимальный объем выделенной буферной памяти FIFO (в байтах) с момента последнего обращения для чтения для определенного выходного порта (egress port) Ethernet-коммутатора [SWS_EthIf_91135]. Вызов может выполняться, например, комплексным драйвером устройства (CDD) [SWS_EthIf_91135]. Для адресации передаются индекс коммутатора (SwitchPortIdx), индекс порта (PortIdx) и индекс FIFO (SwitchPortEgressFifoIdx). Определенный уровень заполнения записывается в область памяти, на которую указывает SwitchPortEgressFifoBufferLevelPtr [SWS_EthIf_91135].

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

Функция обладает семантикой асинхронного выполнения [SWS_EthIf_91135]. Она реентерабельна для различных индексов коммутаторов и портов, однако не должна вызываться параллельно для одной и той же комбинации из SwitchPortIdx и PortIdx [SWS_EthIf_91135]. Из-за асинхронной семантики при одновременной передаче указателя адресуемая область памяти для результата, вероятно, должна оставаться действительной до завершения операции. Вопрос Q-c941ffec278a86cd (открытый)

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

При успешном запросе функция возвращает E_OK, в противном случае — E_NOT_OK [SWS_EthIf_91135]. Если аппаратная часть коммутатора не поддерживает попортовое определение максимального уровня заполнения буфера FIFO, значение по целевому адресу SwitchPortEgressFifoBufferLevelPtr устанавливается в 0xFFFFFFFF [SWS_EthIf_91135]. Модуль перенаправляет вызов для дальнейшего выполнения в функцию драйвера EthSwt_GetMaxFIFOBufferFillLevel назначенного драйвера Ethernet-коммутатора [SWS_EthIf_00472].

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

Функция EthIf_TransceiverGetMacMethod (ID сервиса 0x66) служит для синхронного запроса сконфигурированного метода доступа к среде Ethernet-трансивера [SWS_EthIf_91021]. Она доступна через заголовочный файл EthIf.h и использует следующие интерфейсные параметры:

• TrcvIdx (in): индекс трансивера в контексте драйвера Ethernet-трансивера [SWS_EthIf_91021].
• MacModePtr (out): указатель на область памяти для определенного метода доступа типа EthTrcv_MacMethodType [SWS_EthIf_91021]. Допустимыми результирующими значениями являются ETHTRCV_MAC_TYPE_CSMA_CD (Carrier-Sense Multiple Access с Collision Detection) и ETHTRCV_MAC_TYPE_PLCA (Physical Layer Collision Avoidance).

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

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

• E_OK: метод доступа к среде был успешно считан и предоставлен через MacModePtr.
• E_NOT_OK: запрос к трансиверу не был принят [SWS_EthIf_91021]. Специфические коды ошибок DET или DEM в спецификации для этого сервиса не приведены.

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

Выполнение происходит синхронно, однако функция специфицирована как нереэнтрантная (Non Reentrant) [SWS_EthIf_91021]. Поэтому одновременный или прерывающий вызов в рамках одного и того же контекста драйвера должен быть исключен вызывающим компонентом. Следует также учитывать, что в релизе R20-11 сервис указан со статусом atp.Status=draft [SWS_EthIf_91021].

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

Синхронная функция EthIf_RxIndication обрабатывает Ethernet-кадр, принятый через индексированный физический Ethernet-контроллер [SWS_EthIf_00085]. Служба не имеет возвращаемого значения и выполняет пересылку принятых данных внутри интерфейса Ethernet [SWS_EthIf_00085]. Интерпретация: вызов, вероятно, обычно осуществляется нижележащим драйвером Ethernet (Eth), как только новые принятые данные становятся полностью доступны. Вопрос Q-c3d25d0b89e6cd7f (открытый)

Параметры

Для дальнейшей обработки функция принимает следующие параметры [SWS_EthIf_00085]:

• CtrlIdx: индекс физического Ethernet-контроллера в контексте интерфейса Ethernet [SWS_EthIf_00085].
• FrameType: тип кадра принятого Ethernet-кадра [SWS_EthIf_00085].
• IsBroadcast: признак того, является ли кадр широковещательным (Broadcast-Frame) [SWS_EthIf_00085].
• PhysAddrPtr: указатель на физический адрес источника (MAC-адрес в сетевом порядке байтов) принятого кадра [SWS_EthIf_00085].
• DataPtr: указатель на полезные данные (Payload) принятого кадра [SWS_EthIf_00085].
• LenByte: длина полезных данных в принятом кадре в байтах [SWS_EthIf_00085].

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

Интерфейс объявлен как нереентерабельный (Non Reentrant) и доступен под Service ID 0x10 через заголовочный файл EthIf.h [SWS_EthIf_00085]. Вызывающие стороны должны гарантировать отсутствие конкурирующих вызовов. Специфические коды ошибок, возвращаемые значения или сообщения DET/DEM в объеме спецификации для этой функции не указаны.

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

Синхронная функция EthIf_TxConfirmation (Service ID 0x11) подтверждает передачу Ethernet-кадра физическим Ethernet-контроллером, на который ссылается CtrlIdx [SWS_EthIf_00091]. Функция не имеет возвращаемого значения и доступна через заголовочный файл EthIf.h [SWS_EthIf_00091].

Входные параметры определены следующим образом [SWS_EthIf_00091]:

• CtrlIdx (uint8): индекс физического Ethernet-контроллера в контексте интерфейса Ethernet.
• BufIdx (Eth_BufIdxType): индекс переданного буфера.
• Result (Std_ReturnType): результат передачи; E_OK сигнализирует об успешной операции отправки, E_NOT_OK — об ошибке передачи.

Взаимодействие с вышестоящими уровнями

В соответствии с [SWS_EthIf_00255] EthIf_TxConfirmation пересылает полученный результат передачи Result на сконфигурированный верхний уровень через его функцию обратного вызова (Callback) <UL>_TxConfirmation.

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

Функция специфицирована как нереентерабельная (Non Reentrant) [SWS_EthIf_00091]. Поэтому параллельные вызовы должны быть исключены. Специфические сообщения об ошибках DET или DEM во фрагменте спецификации не предусмотрены; ошибки передаются исключительно через параметр Result со значением E_NOT_OK [SWS_EthIf_00091].

Функция оповещения EthIf_CtrlModeIndication вызывается в соответствии с [SWS_EthIf_00231], как только рабочий режим Ethernet-контроллера был успешно считан. Срабатывание происходит асинхронно в результате предшествующего вызова Eth_SetControllerMode, причем вызов может осуществляться непосредственно внутри соответствующих триггерных функций. Сама функция имеет синхронную семантику выполнения и не возвращает значения ([SWS_EthIf_00231]).

Через параметры передаются индекс физического Ethernet-контроллера в контексте интерфейса Ethernet (CtrlIdx), а также сообщенный режим контроллера (CtrlMode) ([SWS_EthIf_00231]). В отношении параллелизма [SWS_EthIf_00231] указывает, что функция не является реентерабельной для одного и того же индекса контроллера, но для разных индексов может выполняться реентерабельно.

Что касается взаимодействия с другими модулями, связанные требования ссылаются на последующие действия, которые, однако, классифицированы в данном релизе как устаревшие:

• В соответствии с [SWS_EthIf_00267] (OBSOLETE) в контексте этой функции предусматривался вызов EthSwt_SetSwitchPortMode для всех портов группы портов коммутатора при наличии соответствующей ссылки управления, а при ETH_MODE_DOWN — разрешение конфликтов с активными группами.
• В соответствии с [SWS_EthIf_00413] (OBSOLETE) в контексте этой функции предусматривался вызов EthTrcv_TransceiverLinkStateRequest с ETHTRCV_LINK_STATE_ACTIVE или ETHTRCV_LINK_STATE_DOWN при наличии ссылки на трансивер в зависимости от того, запрашивался ли ранее ETH_MODE_ACTIVE или ETH_MODE_DOWN.

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

Функция EthIf_TrcvModeIndication служит интерфейсом уведомлений модуля Ethernet Interface, который вызывается, как только будет считана смена режима приемопередатчика [SWS_EthIf_00232]. Она доступна через заголовочный файл EthIf.h и имеет Service ID 0x0f [SWS_EthIf_00232].

Выполнение самой функции специфицировано как синхронное, тогда как вызов происходит асинхронно, когда определена смена режима [SWS_EthIf_00232]. Если функция инициируется предшествующим вызовом EthTrcv_SetTransceiverMode, ее разрешается вызывать непосредственно внутри этой инициирующей функции [SWS_EthIf_00232].

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

• TrcvIdx: индекс приемопередатчика Ethernet в контексте Ethernet Interface (входной параметр) [SWS_EthIf_00232].
• TrcvMode: сообщаемый рабочий режим приемопередатчика Ethernet типа Eth_ModeType (входной параметр) [SWS_EthIf_00232].
• Возвращаемое значение: отсутствует (void) [SWS_EthIf_00232].

Параллелизм и реентерабельность

Функция специфицирована как нереентерабельная для одного и того же индекса, но реентерабельная для различных индексов [SWS_EthIf_00232]. В таблице спецификации при этом указано Ctrl Idx, что в контексте данного интерфейса приемопередатчика, предположительно, следует интерпретировать как ссылку на индекс приемопередатчика или контроллера [SWS_EthIf_00232]. Вопрос Q-c0123f1ef0e4ec71 (открытый)

Функция EthIf_SwitchPortModeIndication служит для Ethernet Interface (EthIf) в качестве асинхронного интерфейса уведомления об изменении режима порта Ethernet-коммутатора, сообщаемом драйвером Ethernet Switch Driver [SWS_EthIf_91055].

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

EthIf определяет ожидаемые уведомления на основе конфигурации соответствующего порта коммутатора: если порт коммутатора ссылается на приёмопередатчик (EthTrcv), EthIf вместо этого ожидает уведомление через EthIf_TrcvModeIndication(); в противном случае ожидается уведомление от Ethernet Switch Driver через EthIf_SwitchPortModeIndication() [SWS_EthIf_91055].

• SwitchIdx: индекс Ethernet-коммутатора в контексте Ethernet Switch Driver [SWS_EthIf_91055].
• SwitchPortIdx: индекс порта на адресуемом Ethernet-коммутаторе [SWS_EthIf_91055].
• PortMode: вновь сообщённый режим порта коммутатора типа Eth_ModeType [SWS_EthIf_91055].

Свойства выполнения и ограничения

Функция не имеет возвращаемого значения (void) и обладает service ID 0x46 [SWS_EthIf_91055]. Она специфицирована как асинхронная (Asynchronous) и нереентерабельная (Non Reentrant) [SWS_EthIf_91055]. Поэтому вызывающие стороны должны исключить конкурирующие вызовы для этой службы. Специфичные сообщения об ошибках DET или DEM в полезной нагрузке для данной функции не определены.

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

Функция EthIf_SleepIndication служит интерфейсом уведомлений Ethernet Interface. Она вызывается соответствующим драйвером приемопередатчика Ethernet (EthTrcv), как только тот зафиксирует индикацию сна в сети [SWS_EthIf_91006]. В качестве единственного входного параметра передается TrcvIdx, который однозначно идентифицирует индекс сигнализирующего приемопередатчика Ethernet в контексте модуля EthIf [SWS_EthIf_91006]. Функция не имеет ни входных/выходных параметров, ни возвращаемых значений и выполняет уведомление синхронно [SWS_EthIf_91006].

Взаимодействие с аппаратным обеспечением

Основным сценарием применения является использование с аппаратным обеспечением Ethernet, спроектированным в соответствии со спецификацией OPEN Alliance TC10 [SWS_EthIf_91006]. В этом сценарии приемопередатчик (PHY) на аппаратном уровне обнаруживает Sleep.Indication, вызванную запросом на переход в режим сна (Sleep.Request) от напрямую подключенного партнера по линии связи [SWS_EthIf_91006].

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

Интерфейс определен как синхронный и реентерабельный и предоставляется через заголовочный файл EthIf.h (Service ID 0x68) [SWS_EthIf_91006]. При системной интеграции необходимо учитывать, что элемент помечен тегом atp.Status=draft как черновик [SWS_EthIf_91006]. Конкретные подпрограммы обработки ошибок или коды ошибок DET в рамках спецификации не определены; предположительно, формальная проверка ошибок появится только в будущих версиях спецификации. Вопрос Q-680af6c43439167f (открытый)

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

Функция EthIf_MainFunctionRx выполняет в Ethernet Interface (EthIf) центральную задачу проверки наличия вновь поступивших кадров данных в режиме опроса и запуска соответствующих индикаций приема (Reception Indications) для вышележащих уровней [SWS_EthIf_00097]. Она определена с сигнатурой void EthIf_MainFunctionRx (void), соответственно, не принимает параметров вызова и не возвращает значения [SWS_EthIf_00097]. В качестве Service ID задано шестнадцатеричное значение 0x20 [SWS_EthIf_00097].

Функция предоставляется через заголовочный файл SchM_EthIf.h [SWS_EthIf_00097]. Это наводит на интерпретацию, что ее вызов выполняется периодически диспетчером расписания (SchM) или операционной системой в контексте циклической задачи базового программного обеспечения.

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

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

Основная функция EthIf_MainFunctionTx служит для циклической обработки операций передачи и опроса состояния внутри модуля Ethernet Interface [SWS_EthIf_00113]. Она имеет шестнадцатеричный Service ID 0x21 и согласно своей сигнатуре void EthIf_MainFunctionTx (void) выполняется без входных параметров и без возвращаемого значения, так что вся обработка осуществляется на основе состояния [SWS_EthIf_00113].

В процессе работы сервис выполняет две центральные задачи при коммуникации по Ethernet:

• Подтверждения передачи: в режиме опроса функция выдает подтверждения успешно завершенных передач (Transmission Confirmations) вышележащим уровням [SWS_EthIf_00113].
• Состояния приемопередатчика: она отслеживает и проверяет систему на предмет произошедших изменений состояния подключенных приемопередатчиков Ethernet [SWS_EthIf_00113].

Что касается системной интеграции, интерфейс доступен через заголовочный файл SchM_EthIf.h [SWS_EthIf_00113]. Интерпретация: из предоставления через SchM_EthIf.h, вероятно, следует, что вызов выполняется периодически планировщиком BSW (SchM) в контексте циклической задачи. Вопрос Q-b9dde07f9cc74a95 (открытый) Это гарантирует, что ожидающие подтверждения передачи в режиме опроса и смены состояний приемопередатчика обрабатываются регулярно и без зависимости от прерываний.

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

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

Функция EthIf_MainFunctionState служит для циклического опроса (поллинга) информации о состоянии и диагностике подключенного коммуникационного оборудования Ethernet, такого как трансиверы Ethernet и порты коммутатора Ethernet [SWS_EthIf_91104]. К ней относятся, например, статус соединения (Link State), а также качество сигнала [SWS_EthIf_91104]. Функция не имеет ни входных, ни выходных параметров и не возвращает значения (void EthIf_MainFunctionState(void), Service-ID 0x05) [SWS_EthIf_91104]. Поведение выполнения специфицировано как асинхронное [SWS_EthIf_91104].

Параллелизм и условия вызова

Функция определена как нереентрабельная (Non Reentrant) [SWS_EthIf_91104]. Поэтому она ни в какой момент времени не должна выполняться параллельно или прерывать саму себя. Поскольку интерфейс предоставляется через заголовочный файл EthIf_SchM.h [SWS_EthIf_91104], периодический вызов обычно должен осуществляться в контексте задачи планировщика BSW (SchM). Вопрос Q-10d02355b276be90 (открытый)

Взаимодействие и конфигурация

Согласно [SWS_EthIf_00407], EthIf_MainFunctionState должен опрашивать информацию об оборудовании строго с сконфигурированной периодичностью EthIfMainFunctionStatePeriod. Это обеспечивает регулярное обновление физических параметров интерфейса в Ethernet-интерфейсе.

Структура данных EthIf_SignalQualityResultType ([SWS_EthIf_91057]) служит для сбора и диагностики качества соединения на уровне Ethernet и предоставляется через заголовочный файл EthIf.h.

Структура объединяет три измеряемые величины базового типа uint32:

• ActualSignalQuality: представляет текущее действующее качество сигнала соединения Ethernet.
• HighestSignalQuality: фиксирует наивысшее измеренное качество сигнала соединения с момента последнего сброса.
• LowestSignalQuality: документирует наименьшее измеренное качество сигнала соединения с момента последнего сброса.

Во взаимодействии с модулем EthIf экстремальные значения отражают динамику стабильности соединения. Сброс сохраненных внутри исторических значений управляется через выделенные интерфейсы:

• Для трансивера, указанного через TrcvIdx, функция EthIf_ClearTrcvSignalQuality сбрасывает сохраненные значения качества сигнала ([SWS_EthIf_00400]).
• Для порта коммутатора, идентифицированного через SwitchIdx и SwitchPortIdx, EthIf_ClearSwitchPortSignalQuality удаляет сохраненные значения качества сигнала ([SWS_EthIf_00404]).

Интерпретация: поскольку полезная нагрузка (Payload) не указывает конкретную функцию чтения, эта структура, предположительно, должна служить выходным параметром соответствующих запросов состояния для трансиверов и портов коммутатора, чтобы сопоставлять текущее качество сигнала с экстремальными значениями. Вопрос Q-8e5f2914bade574c (открытый)