Diagnostic Communication Manager (DCM)

Синхронная и нереентерабельная функция Dcm_Init служит для базовой инициализации модуля DCM [SWS_Dcm_00037]. Она принимает через параметр ConfigPtr указатель на набор конфигурации для вариантов Post-Build и не имеет возвращаемого значения [SWS_Dcm_00037]. Во время выполнения модуль инициализирует все глобальные переменные DCM значениями из конфигурации [SWS_Dcm_00334].

В рамках процесса инициализации конфигурируются различные функциональные области и состояния:

• Управление DDDID: если параметр конфигурации DcmDDDIDStorage установлен в FALSE, DCM при запуске инициализирует все динамически определенные идентификаторы данных (DDDID) как отсутствующие [SWS_Dcm_00866]. Если параметр установлен в TRUE, определения DDDID восстанавливаются из NvM [SWS_Dcm_00867].
• Response on Event (ROE): DCM переводит состояние каждого события во время Dcm_Init в статус «ROE cleared» [SWS_Dcm_00872].
• Статус аутентификации: если DcmDspAuthenticationPersistStateModeRuleRef не сконфигурирован или если вычисление ссылочного правила режима дает false, модуль переводит все состояния аутентификации в состояние «deauthenticated» [SWS_Dcm_01480].
• Статус коммуникации: после завершения Dcm_Init DCM устанавливает параметр ActiveDiagnostic в «DCM_COMM_ACTIVE» [SWS_Dcm_01069].

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

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

Синхронный интерфейс Dcm_DemTriggerOnDTCStatus (Service-ID 0x2B) доступен через заголовочный файл Dcm_Dem.h и служит для сообщения об изменениях байта статуса UDS модулю DCM [SWS_Dcm_00614]. Это позволяет DCM инициировать события Response-on-Event (ROE) для подсервиса диагностической службы OnDTCStatusChanged [SWS_Dcm_00614]. При вызове функция принимает три входных параметра: затронутый код ошибки DTC (uint32), предыдущее состояние DTCStatusOld (Dem_UdsStatusByteType), а также обновленное состояние DTCStatusNew (Dem_UdsStatusByteType) [SWS_Dcm_00614]. Входные/выходные параметры отсутствуют [SWS_Dcm_00614].

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

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

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

Функция классифицирована как реентерабельная и обладает семантикой синхронного выполнения [SWS_Dcm_00614]. В отношении взаимодействия с диагностическими запросами действует жесткое граничное условие: если в DCM в текущий момент обрабатывается запрос на очистку памяти событий (EventMemory), DCM должен игнорировать входящие вызовы функции обратного вызова Dcm_DemTriggerOnDTCStatus [SWS_Dcm_01410].

Функция Dcm_BndMWriteBlockFinish служит интерфейсом уведомления от BndM к DCM для индикации завершения операции записи блока [SWS_Dcm_91088]. Функция объявлена в заголовочном файле Dcm.h, имеет идентификатор службы 0x7a, не возвращает значения (void) и выполняется синхронно [SWS_Dcm_91088].

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

• BlockId (тип: BndM_BlockIdType): идентифицирует блок, операция записи которого была завершена.
• result (тип: BndM_ResultType): передает результат операции записи в DCM.

Функциональное взаимодействие и поведение в случае ошибки привязаны к атомарным операциям записи BndM, ранее инициированным DCM:

• Если Dcm_BndMWriteBlockFinish вызывается со статусом result = E_OK, DCM отправляет положительный диагностический ответ на ожидающий запрос [SWS_Dcm_01584].
• Если функция вызывается с result = E_NOT_OK, DCM в случае ошибки реагирует отрицательным диагностическим ответом 0x72 (generalProgrammingFailure) [SWS_Dcm_01585].

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

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

Функция Dcm_SetDeauthenticatedRole выполняется синхронно и реентерабельно ([SWS_Dcm_91069]). Она позволяет программному компоненту назначить для соединения, идентифицированного с помощью connectionId, новую роль deauthenticatedRole типа Dcm_AuthenticationRoleType для деаутентифицированного состояния ([SWS_Dcm_91069], [SWS_Dcm_01486]). В качестве возвращаемого значения без исключения возвращается E_OK ([SWS_Dcm_91069]).

Условия состояния и обработка ошибок

Вызов обрабатывается DCM исключительно в том случае, если соединение находится в деаутентифицированном состоянии (deauthenticated state) ([SWS_Dcm_01487]). Поскольку сигнатура не предусматривает альтернативных значений ошибок и всегда возвращает E_OK ([SWS_Dcm_91069]), вызов вне этого состояния, предположительно, отбрасывается без сообщения об ошибке. Вопрос Q-6f14770eae6ce896 (открытый) Специфические события DET или DEM в спецификации не определены.

Срок действия и жизненный цикл

Если роль для деаутентифицированного состояния успешно принята ([SWS_Dcm_01486]), это назначение сохраняется временно:

• установленная роль сбрасывается, как только соединение переходит в аутентифицированное состояние (authenticated state) ([SWS_Dcm_01488]).
• срок действия заканчивается не позднее сброса блока управления ([SWS_Dcm_91069]).

Синхронная и реентерабельная функция Dcm_GetSecurityLevel запрашивает текущий активный уровень безопасности DCM и предоставляет его [SWS_Dcm_00338]. Функция объявлена через заголовочный файл Dcm.h и передает определенное значение статуса вызывающей стороне через выходной параметр SecLevel типа Dcm_SecLevelType*. В качестве возвращаемого значения согласно спецификации без исключения возвращается E_OK [SWS_Dcm_00338].

Определение внутреннего уровня безопасности основано на параметре SecurityAccessType, переданном тестером в рамках службы SecurityAccess, в соответствии с фиксированной формулой пересчета SecurityLevel = (SecurityAccessType + 1) / 2 [SWS_Dcm_00338].

Во взаимодействии с вышестоящей обработкой диагностических служб подмодуль DSP среди прочего обращается к этому значению: если модуль принимает сконфигурированный запрос с типом подфункции «requestSeed» (нечетное значение) и соответствующий уровень доступа согласно Dcm_GetSecurityLevel уже активен, подмодуль DSP устанавливает содержимое Seed в 0x00 [SWS_Dcm_00323].

В отношении конкурентности и обработки ошибок функция определена как reentrant [SWS_Dcm_00338]. Поскольку специфические коды ошибок или проверки DET не специфицированы и всегда возвращается E_OK, проверка на нулевой указатель, вероятно, не выполняется; поэтому вызывающие стороны, предположительно, всегда должны передавать действительный указатель на область памяти для SecLevel. Вопрос Q-5402d82ac0151b22 (открытый)

Синхронная функция Dcm_ResetToDefaultSession позволяет приложению сбросить активную диагностическую сессию в стандартную сессию (Default Session) [SWS_Dcm_00520]. Типичным сценарием применения является автоматическое завершение расширенной диагностической сессии, как только автомобиль превышает заданный порог скорости [SWS_Dcm_00520].

Использование и обработка ошибок

• Интерфейс и параметры: функция доступна через Dcm.h с идентификатором службы 0x2a, имеет сигнатуру Std_ReturnType Dcm_ResetToDefaultSession (void) и не требует передаваемых параметров [SWS_Dcm_00520].
• Возвращаемое значение и ошибки: в качестве возвращаемого типа передается Std_ReturnType, причем без исключений возвращается значение E_OK [SWS_Dcm_00520]. Специфические коды ошибок, проверки времени выполнения DET или события DEM в требованиях для этого вызова не специфицированы.

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

Выполнение происходит синхронно и объявлено как реентерабельное [SWS_Dcm_00520].

Помимо фактической смены сессии, Dcm_ResetToDefaultSession в обязательном порядке инициирует смену режима для ModeDeclarationGroupPrototype DcmDiagnosticSessionControl [SWS_Dcm_01062]. При этом функция внутренне вызывает SchM_Switch_<bsnp>_DcmDiagnosticSessionControl(RTE_MODE_DcmDiagnosticSessionControl_DCM_DEFAULT_SESSION), чтобы уведомить системное окружение о переходе в стандартную сессию [SWS_Dcm_01062].

Синхронная функция Dcm_TriggerOnEvent (Service-ID 0x2D), предоставляемая через заголовочный файл Dcm.h, служит для вызова события, связанного с запросом ResponseOnEvent (ROE) [SWS_Dcm_00521].

Вызов и принцип работы

Вызывающая сторона передаёт в качестве единственного параметра RoeEventId (входной параметр типа uint8), идентифицирующий инициируемое событие; входные или выходные параметры отсутствуют [SWS_Dcm_00521]. Как только функция вызывается, DCM проверяет состояние события: если переданный RoeEvent активен, DCM инициирует соответствующее событие [SWS_Dcm_00920]. DCM выполняет связанную с событием службу при условии, что соответствующий режим RoeEventId находится в состоянии «ROE started» [SWS_Dcm_00521].

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

Вызов синхронно возвращает статус типа Std_ReturnType, предоставляющий информацию о валидности параметра [SWS_Dcm_00521]:

• E_OK: переданное значение для RoeEventId валидно [SWS_Dcm_00521].
• E_NOT_OK: значение RoeEventId невалидно [SWS_Dcm_00521].

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

Интерфейс специфицирован как реверсивный (reentrant) [SWS_Dcm_00521]. Таким образом, он может вызываться параллельно для синхронного оповещения DCM о событиях [SWS_Dcm_00521].

Синхронная и реентерабельная функция Dcm_StartOfReception ([SWS_Dcm_00094]) вызывается модулем транспортного протокола в начале приема N-SDU — как для несегментированных сообщений (Single Frame, SF), так и для сегментированных сообщений (First Frame, FF). Она может вызываться в контексте прерывания ([SWS_Dcm_00094]). Вызов приводит, помимо прочего, к остановке таймера S3Server в начале приема ([SWS_Dcm_00141]).

Через info передаются полезные данные и метаданные; для универсальных соединений через него, среди прочего, сохраняются SOURCE_ADDRESS_16 ([SWS_Dcm_00848]) и проверяются TARGET_ADDRESS_16 ([SWS_Dcm_01347]). Если нет ни полезных данных, ни метаданных, передается NULL_PTR ([SWS_Dcm_00094]). Через bufferSizePtr функция возвращает доступный буфер для вычисления размера блока (Block Size, BS) ([SWS_Dcm_00094]). При успешном принятии она возвращает BUFREQ_OK, после чего последующие данные копируются через Dcm_CopyRxData ([SWS_Dcm_00443]).

Случаи ошибок и отклонений сигнализируются через возвращаемое значение:

• BUFREQ_E_OVFL: возвращается, если запрошенная длина TpSduLength превышает доступный в DCM буфер ([SWS_Dcm_00094], [SWS_Dcm_00444]). bufferSizePtr остается без изменений ([SWS_Dcm_00094]).
• BUFREQ_E_NOT_OK: возвращается, если TpSduLength равно 0 ([SWS_Dcm_00642]) или текущий запрос блокируется на том же соединении ([SWS_Dcm_00557]). При другом соединении параметр DcmDslDiagRespOnSecondDeclinedRequest определяет, отклоняется ли он с BUFREQ_E_NOT_OK ([SWS_Dcm_00790]) или принимается с BUFREQ_OK ([SWS_Dcm_00788]). Конкурентные запросы TesterPresent также квитируются с BUFREQ_OK ([SWS_Dcm_00557]).

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

Синхронная функция Dcm_CopyRxData вызывается для передачи принятых данных сегмента I-PDU (N-PDU) верхнему уровню в DCM [SWS_Dcm_00556]. Каждый вызов предоставляет следующую часть данных I-PDU [SWS_Dcm_00556]. Через параметр id идентифицируется принятый I-PDU [SWS_Dcm_00556]. Указатель info предоставляет через SduDataPtr буфер источника, а также через SduLength — количество копируемых байтов [SWS_Dcm_00556]. После завершения операции копирования оставшийся свободный размер буфера в DCM возвращается через bufferSizePtr [SWS_Dcm_00556], [SWS_Dcm_00443].

Если Dcm_CopyRxData вызывается с SduLength, равным 0, это служит исключительно для опроса буфера [SWS_Dcm_00556]. В этом случае SduDataPtr может быть NULL_PTR; функция возвращает BUFREQ_OK и записывает оставшийся размер буфера приема в bufferSizePtr [SWS_Dcm_00556], [SWS_Dcm_00996].

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

Перед копированием функция Dcm_StartOfReception должна быть завершена с BUFREQ_OK; последующие вызовы Dcm_CopyRxData копируют данные из предоставленного буфера в буфер DCM и обновляют bufferSizePtr [SWS_Dcm_00443].

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

Функция возвращает статус в виде BufReq_ReturnType: BUFREQ_OK подтверждает успешное копирование или опрос буфера, тогда как BUFREQ_E_NOT_OK указывает на то, что из-за ошибки данные скопированы не были [SWS_Dcm_00556], [SWS_Dcm_00996].

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

Dcm_CopyRxData специфицирована как реентерабельная и может вызываться в контексте прерывания [SWS_Dcm_00556]. Интерфейс предоставляется через Dcm.h [SWS_Dcm_00556].

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

Синхронная функция Dcm_TpRxIndication вызывается после приема I-PDU через TP-API, обычно модулем PduR [SWS_Dcm_00093], [SWS_Dcm_00112]. Она передает идентификатор PDU (id), а также результат приема (result) и не возвращает значения [SWS_Dcm_00093]. Поскольку функция является реентерабельной и может вызываться в контексте прерывания, вызывающая сторона и состояния модуля должны быть рассчитаны на соответствующую конкурентность [SWS_Dcm_00093].

Поведение при ошибочном приеме

Если Dcm_TpRxIndication вызывается со значением результата, отличным от E_OK, модуль Dcm не должен анализировать буфер, назначенный ссылочному I-PDU [SWS_Dcm_00344].

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

Субмодуль DSL передает принятые данные субмодулю DSD исключительно в том случае, если вызов был выполнен со значением параметра result = E_OK [SWS_Dcm_00111]. При этом для диагностических запросов действуют специфические правила:

• Если успешно принятый запрос (Result = E_OK) представляет собой команду TesterPresent с установленным suppressPosRspMsgIndicationBit (SID 0x3E, субфункция 0x80), субмодуль DSL сбрасывает таймер таймаута сессии S3Server [SWS_Dcm_00112].
• В этом случае запрос не передается субмодулем DSL субмодулю DSD для дальнейшей интерпретации [SWS_Dcm_00113].

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

Синхронная и реентерабельная функция Dcm_CopyTxData вызывается модулями нижнего уровня (такими как транспортные протоколы) для извлечения данных сегмента I-PDU (N-PDU) для передачи [SWS_Dcm_00092]. Через параметр info вызывающая сторона передает целевой буфер SduDataPtr и требуемую длину в байтах SduLength. Значение 0 для SduLength может использоваться для сигнализации об изменениях статуса через retry или для запроса количества доступных данных; SduDataPtr в этом случае может быть NULL_PTR [SWS_Dcm_00092]. Через availableDataPtr DCM сообщает оставшееся количество байтов в буфере передачи, которое может использоваться модулями TP для определения размеров последующих сегментов и не должно превышать количество байтов, которые еще предстоит отправить [SWS_Dcm_00092], [SWS_Dcm_00350].

Управление буфером и повтор передачи

Через параметр retry управляется квитирование или повтор данных [SWS_Dcm_00092]:

• Если retry представляет собой NULL_PTR, данные разрешается удалить из буфера непосредственно после процесса копирования [SWS_Dcm_00092].
• При TP_CONFPENDING ранее скопированные данные должны оставаться в буфере TP для возможного устранения ошибок [SWS_Dcm_00092].
• TP_DATACONF подтверждает освобождение всех данных, скопированных до этого вызова [SWS_Dcm_00092].
• TP_DATARETRY повторно копирует данные начиная со смещения TxTpDataCnt относительно текущей позиции [SWS_Dcm_00092].

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

Если данные были успешно и полностью скопированы, функция возвращает BUFREQ_OK [SWS_Dcm_00092], [SWS_Dcm_00346]. Если недостаточно данных для передачи доступно, операция копирования не выполняется и возвращается BUFREQ_E_BUSY; нижний уровень может повторить вызов позже [SWS_Dcm_00092]. Если запрос завершается неудачно, функция возвращает BUFREQ_E_NOT_OK [SWS_Dcm_00092]. В этом случае запрос на отправку из PduR_DcmTransmit() еще не завершен; только завершающий вызов Dcm_TpTxConfirmation завершает операцию и делает возможными новые передачи [SWS_Dcm_00350].

Параллелизм

Функция является реентерабельной и может также вызываться в контексте прерывания [SWS_Dcm_00092].

Функция обратного вызова Dcm_TpTxConfirmation ([SWS_Dcm_00351]) синхронно вызывается нижним транспортным уровнем после того, как диагностический I-PDU был передан по сети. Через параметр id идентифицируется соответствующий I-PDU, в то время как result сообщает об успехе или неудаче операции отправки ([SWS_Dcm_00351]). Функция не имеет возвращаемого значения, является реентерабельной и может явно выполняться в контексте прерывания ([SWS_Dcm_00351]).

При вызове Dcm_TpTxConfirmation модуль DCM выполняет центральные процедуры очистки и переходы состояний:

• Назначенный буфер передачи разблокируется ([SWS_Dcm_00352]).
• Текущие процедуры контроля ошибок, такие как таймауты страничного буфера, а также таймауты P2ServerMax и P2*ServerMax, останавливаются ([SWS_Dcm_00353]).
• Заблокированный с момента приема (Dcm_TpRxIndication) DcmPduId соединения освобождается, благодаря чему могут приниматься последующие запросы ([SWS_Dcm_00241]).
• Текущий протокол не завершается подтверждением ответа DSL (вызов xxx_StopProtocol отсутствует) ([SWS_Dcm_00624]).

В случае ошибки (если result указывает на ошибку или подтверждается прерывание после неудачного Dcm_CopyTxData) [SWS_Dcm_00350] обязательно требует этого завершающего вызова, чтобы формально закрыть задание на передачу и сделать возможными новые передачи через PduR_DcmTransmit(). При ошибочном подтверждении субмодуль DSD не должен повторно отправлять диагностический ответ ([SWS_Dcm_00118]).

Кроме того, подтверждение ответа (отличного от NRC 0x78) отмечает регулярное завершение диагностического запроса ([SWS_Dcm_01378]). После подтверждения положительного ответа на EcuReset модуль DCM во время обработки сброса игнорирует все дальнейшие запросы ([SWS_Dcm_00834]).

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

Синхронный интерфейс Dcm_TxConfirmation (идентификатор службы 0x40, объявленный в Dcm.h) согласно [SWS_Dcm_01092] вызывается нижележащим интерфейсным модулем связи для подтверждения отправки PDU или сообщения о сбое передачи. Функция не имеет возвращаемого значения и обрабатывает два входных параметра:

• TxPduId: идентификатор (PduIdType) отправленного PDU.
• result: статус передачи (Std_ReturnType). Допустимыми значениями являются E_OK при успешной передаче, а также E_NOT_OK в случае, если передача PDU не удалась.

Обработка ошибок и обратная связь по состоянию

Результат передачи сигнализируется DCM напрямую через параметр result ([SWS_Dcm_01092]). Специфические сообщения об ошибках DET или DEM в предоставленном фрагменте спецификации для этой функции не определены.

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

Что касается реентерабельности, Dcm_TxConfirmation является реентерабельной для вызовов с различными идентификаторами PDU-ID, однако нереентерабельна для одного и того же TxPduId ([SWS_Dcm_01092]). Следует учитывать, что вызов нижележащим модулем может происходить в контексте прерывания ([SWS_Dcm_01092]).

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

В случае периодической передачи (PeriodicTransmission) DCM согласно [SWS_Dcm_01073] вызывается через Dcm_TxConfirmation для получения соответствующего результата отправки.

Синхронная и реентерабельная функция Dcm_ComM_NoComModeEntered (идентификатор службы 0x21) информирует модуль DCM о переходе коммуникационной сети в состояние COMM_NO_COMMUNICATION [SWS_Dcm_00356]. Интерфейс предоставляется через заголовочный файл Dcm_ComM.h, не имеет возвращаемого значения и идентифицирует затронутую сеть через входной параметр NetworkId типа uint8 [SWS_Dcm_00356].

При этом вызове DCM отключает любую коммуникацию в указанной сети, так что как прием, так и передача сообщений полностью деактивируются [SWS_Dcm_00148]. Это в обязательном порядке включает следующие виды передачи:

• предотвращение передач ResponseOnEvent [SWS_Dcm_00149],
• деактивация периодических передач через ReadDataByPeriodicIdentifier (periodicId) [SWS_Dcm_00150], а также
• отключение обычных передач [SWS_Dcm_00151].

Вследствие этого модуль DCM после выполнения Dcm_ComM_NoComModeEntered для данного контекста больше не должен вызывать функцию PduR PduR_DcmTransmit() [SWS_Dcm_00152].

Если функция вызывается с NetworkId, который не соответствует ни одному каналу ComM, на который ссылается DCM через параметр конфигурации DcmDslProtocolComMChannelRef, модуль DCM не выполняет никаких действий и немедленно возвращает управление [SWS_Dcm_01324].

Синхронная и реентерабельная функция Dcm_ComM_SilentComModeEntered ([SWS_Dcm_00358]) служит для того, чтобы проинформировать модуль DCM о переходе коммуникационной сети в состояние COMM_SILENT_COMMUNICATION. Интерфейс имеет идентификатор службы 0x22, не возвращает значения и ожидает в качестве входного параметра NetworkId идентификатор соответствующей сети ([SWS_Dcm_00358]). Он предоставляется через заголовочный файл Dcm_ComM.h ([SWS_Dcm_00358]).

Как только происходит этот вызов, DCM должен полностью прекратить все действия по передаче на соответствующем сетевом канале ([SWS_Dcm_00153]). В деталях это включает следующие меры:

• деактивацию всех обычных передач ([SWS_Dcm_00156]),
• предотвращение передач Response-on-Event ([SWS_Dcm_00154]), а также
• деактивацию периодических отправок в рамках ReadDataByPeriodicIdentifier ([SWS_Dcm_00155]).

Относительно обработки ошибок и граничных условий установлено, что DCM должен возвращать управление без каких-либо дальнейших действий, если переданный NetworkId соответствует каналу ComM, на который в DCM нет ссылки через параметр конфигурации DcmDslProtocolComMChannelRef ([SWS_Dcm_01325]). Специфические ошибки разработки или возвращаемые значения ошибок для этого вызова не специфицированы.

Интерпретация: вызов, вероятно, обычно выполняется модулем ComM, как только совершается переход в тихий режим коммуникации. Вопрос Q-fc9b6303ae0c0e41 (открытый)

Синхронная и реентерабельная функция Dcm_ComM_FullComModeEntered предоставляется через заголовочный файл Dcm_ComM.h и информирует модуль DCM о переходе коммуникационной сети в состояние COMM_FULL_COMMUNICATION [SWS_Dcm_00360]. В качестве входного параметра служит NetworkId, идентифицирующий сеть, затронутую сменой режима [SWS_Dcm_00360].

Благодаря вызову активируется вся коммуникация для этой сети, так что разрешаются как прием, так и передача сообщений [SWS_Dcm_00157]. Это включает следующие виды передачи:

• обычные передачи [SWS_Dcm_00161],
• передачи Response-on-Event [SWS_Dcm_00159], а также
• периодические передачи с помощью ReadDataByPeriodicIdentifier [SWS_Dcm_00160].

Как только Dcm_ComM_FullComModeEntered была вызвана, DCM без ограничений обрабатывает внутренние функции DslInternal_ResponseOnOneDataByPeriodicId() и DslInternal_ResponseOnOneEvent() [SWS_Dcm_00162]. В хронологической последовательности DCM должен дождаться этого вызова перед тем, как инициировать передачу диагностического ответа; время ожидания с момента поступления запроса не должно превышать P2ServerMax [SWS_Dcm_01142].

В случае ошибки, если переданный NetworkId относится к каналу ComM, который не сконфигурирован в DCM (параметр DcmDslProtocolComMChannelRef), функция немедленно возвращает управление без дальнейших действий [SWS_Dcm_01326].

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

Синхронная и реэнтрантная функция обратного вызова Dcm_CsmAsyncJobFinished вызывается Crypto Service Manager (CSM), как только завершается асинхронная обработка задания [SWS_Dcm_91076]. В качестве входного параметра она принимает через result типа Csm_ResultType результат завершённого задания CSM [SWS_Dcm_91076]. В качестве возвращаемого значения функция всегда возвращает E_OK [SWS_Dcm_91076].

Конфигурация и граничные условия

Интеграторы должны сконфигурировать имя этой функции в конфигурации ECUC модуля CSM в качестве обратного вызова для асинхронных заданий [SWS_Dcm_91076]. Для DCM доступен исключительно единственный такой обратный вызов; идентификация завершённого задания выполняется согласно спецификации путём анализа параметра задания [SWS_Dcm_91076]. Однако, поскольку сигнатура C-функции передаёт только result, DCM, вероятно, определяет соответствующее задание внутренне по состоянию транзакции текущей аутентификации. Вопрос Q-04ad1d5fb514f467 (открытый)

Интерфейс доступен только в том случае, если в конфигурации установлен параметр DcmDspAuthenticationConnection (не равен null) [SWS_Dcm_91076]. Специфическая обработка ошибок или сообщения DET для этого вызова не специфицированы, поскольку возвращаемое значение неизменно равно E_OK [SWS_Dcm_91076].

Синхронная и реэнтрантная функция обратного вызова Dcm_KeyMAsyncCertificateVerifyFinished вызывается модулем KeyM после завершения асинхронной верификации сертификата [SWS_Dcm_91077]. Она информирует DCM о завершении, а также о результате процесса проверки и всегда возвращает E_OK в качестве возвращаемого значения [SWS_Dcm_91077].

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

• CertID: идентификатор сертификата, верификация которого была завершена. На основе этого идентификатора DCM определяет, какое задание проверки завершилось [SWS_Dcm_91077].
• Result: возвращаемое значение и статус асинхронного задания верификации из KeyM [SWS_Dcm_91077].

Конфигурация и граничные условия

Интеграторы должны сконфигурировать это имя функции в конфигурации ECUC модуля KeyM в качестве обратного вызова для асинхронных заданий [SWS_Dcm_91077]. Поскольку для этого уведомления доступен только один обратный вызов, DCM вынужден определять соответствующий сертификат через параметр CertID [SWS_Dcm_91077].

Интерфейс доступен исключительно тогда, когда сконфигурирован параметр конфигурации DcmDspAuthenticationConnection по пути Dcm/DcmDsp/DcmDspAuthentication (!= null) [SWS_Dcm_91077]. Особые коды ошибок или сообщения DET для этого вызова не специфицированы [SWS_Dcm_91077].

Функция callout Dcm_ReadMemory ([SWS_Dcm_00539]), объявленная в Dcm_Externals.h, служит модулю DCM для считывания данных памяти сервера на основе начального адреса (MemoryAddress) и размера в байтах (MemorySize). Функция требуется для UDS-сервисов ReadMemoryByAddress (0x23) ([SWS_Dcm_00495]), ReadDataByIdentifier (0x22) для динамических DID в диапазоне адресов от 0xF200 до 0xF3FF ([SWS_Dcm_00653]), RequestUpload, а также TransferData ([SWS_Dcm_00539]). Если параметр MemoryIdentifier не используется, он должен быть установлен в 0 ([SWS_Dcm_00539]).

Интерфейс является асинхронным и нереентерабельным ([SWS_Dcm_00539]). Статус вызова передается через OpStatus со значениями DCM_INITIAL, DCM_PENDING, DCM_CANCEL или DCM_FORCE_RCRRP_OK. Пока процесс чтения продолжается, функция возвращает DCM_READ_PENDING ([SWS_Dcm_00985]). Если вызов возвращает DCM_READ_FORCE_RCRRP, DCM незамедлительно инициирует отправку сообщения RCR-RP (NRC 0x78) и приостанавливает дальнейшие вызовы до подтверждения отправки ([SWS_Dcm_00839]). После подтверждения RCR-RP модуль DCM повторно вызывает функцию из Dcm_MainFunction с OpStatus = DCM_FORCE_RCRRP_OK ([SWS_Dcm_00840]).

В случае успеха считанные данные записываются в буфер MemoryData и возвращается DCM_READ_OK ([SWS_Dcm_00539], [SWS_Dcm_00985]). Если операция завершается сбоем, функция возвращает DCM_READ_FAILED и устанавливает ErrorCode. После этого DCM отправляет отрицательный ответ с соответствующим значением NRC ([SWS_Dcm_00644]).

Объявленная в Dcm_Externals.h функция callout Dcm_WriteMemory вызывается модулем DCM асинхронно и нереентерабельно для записи данных памяти на основе начального адреса и размера в байтах [SWS_Dcm_00540]. Она служит для реализации UDS-сервисов WriteMemoryByAddress (0x3D), RequestDownload и TransferData [SWS_Dcm_00540]. При приеме WriteMemoryByAddress DCM вызывает callout только после проверки запроса [SWS_Dcm_00491].

Для управления последовательностью передается OpStatus (возможные значения: DCM_INITIAL, DCM_PENDING, DCM_CANCEL или DCM_FORCE_RCRRP_OK) [SWS_Dcm_00540]. Параметры MemoryAddress и MemorySize определяют целевую область памяти, в то время как MemoryData указывает на диагностический буфер DCM [SWS_Dcm_00540]. Если MemoryIdentifier или MemoryAddress не используются (например, при сжатых данных), они должны быть установлены в 0 [SWS_Dcm_00540].

Возвращаемое значение Dcm_ReturnWriteMemoryType [SWS_Dcm_00986] определяет дальнейшую обработку в DCM:

• DCM_WRITE_OK: процесс записи прошел успешно [SWS_Dcm_00540], [SWS_Dcm_00986].
• DCM_WRITE_PENDING: операция еще не завершена и требует последующих вызовов [SWS_Dcm_00540], [SWS_Dcm_00986].
• DCM_WRITE_FORCE_RCRRP: DCM незамедлительно инициирует отправку ответа Response Pending (NRC 0x78) и приостанавливает дальнейшие вызовы до подтверждения отправки [SWS_Dcm_00837]. После этого выполняется повторный вызов из Dcm_MainFunction с DCM_FORCE_RCRRP_OK [SWS_Dcm_00838].
• DCM_WRITE_FAILED: при ошибке DCM отправляет отрицательный ответ со значением NRC, переданным через выходной параметр ErrorCode [SWS_Dcm_00540], [SWS_Dcm_00643].

Функция callout Dcm_SetProgConditions позволяет интегратору персистентно сохранять актуальную информацию перед переходом в загрузчик или сбросом в результате запроса ECUReset [SWS_Dcm_00543]. Соответствующие данные контекста передаются через указатель на структуру Dcm_ProgConditionsType, которая объединяет, среди прочего, адреса соединений и исходные адреса тестера, идентификаторы сервисов и субфункций, а также управляющие флаги, такие как ReprogramingRequest и ResponseRequired [SWS_Dcm_00988]. При приеме UDS-сервиса 0x10 с субфункцией 0x02 DCM устанавливает эти флаги и вызывает интерфейс [SWS_Dcm_01182].

Вызов выполняется асинхронно и не является реентерабельным (Non Reentrant) [SWS_Dcm_00543]. Через параметр OpStatus управляются состояния DCM_INITIAL, DCM_PENDING, DCM_CANCEL или DCM_FORCE_RCRRP_OK [SWS_Dcm_00543]. Если выполнение продолжается и функция возвращает DCM_E_PENDING, DCM снова вызывает интерфейс в следующем цикле главной функции, чтобы завершить установку [SWS_Dcm_00543], [SWS_Dcm_01184]. С помощью DCM_E_FORCE_RCRRP можно принудительно запустить передачу ответа Response Pending (NRC 0x78) [SWS_Dcm_00543]. В зависимости от конфигурации вызов со стороны DCM выполняется только после успешной передачи NRC 0x78 [SWS_Dcm_00535].

Если условия были установлены безошибочно и callout возвращает E_OK, DCM инициирует смену режима ModeDeclarationGroupPrototype DcmEcuReset на EXECUTE [SWS_Dcm_00719], [SWS_Dcm_01163], [SWS_Dcm_01180]. Если же состояние сохранить невозможно и функция отвечает E_NOT_OK, сброс и переход в загрузчик не выполняются, смена режима блокируется и DCM отправляет отрицательный ответ NRC 0x22 (Conditions not correct) [SWS_Dcm_00715], [SWS_Dcm_01181].

Функция callout Dcm_GetProgConditions с идентификатором сервиса 0x62 вызывается во время инициализации DCM, чтобы определить, необходимо ли отправить ожидающий диагностический ответ на сервис $50 или $51 [SWS_Dcm_00544]. Объявление интерфейса предоставляется через заголовочный файл Dcm_Externals.h [SWS_Dcm_00544].

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

Выполнение функции происходит синхронно, при этом обычные входные или входные/выходные параметры не передаются [SWS_Dcm_00544]:

• Выходные параметры: через указатель ProgConditions типа Dcm_ProgConditionsType* callout возвращает условия, при которых был запрошен предыдущий переход из загрузчика [SWS_Dcm_00544]. Соответствующие параметры контекста сохранены в типе данных Dcm_ProgConditionsType [SWS_Dcm_00544].
• Возвращаемое значение: функция возвращает вызывающей стороне значение статуса типа Dcm_EcuStartModeType [SWS_Dcm_00544].

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

Функция классифицирована как нереентерабельная (Non Reentrant) и поэтому не может выполняться параллельно [SWS_Dcm_00544]. Для этого callout в спецификации интерфейса не определены конкретные коды ошибок для DET или DEM [SWS_Dcm_00544].

Callout-функция Dcm_ProcessRequestAddFile вызывается DCM для инициации службы RequestFileTransfer с режимом работы 0x01 (AddFile) ([SWS_Dcm_91078]). Она доступна через Dcm_Externals.h, имеет идентификатор службы (Service ID) 0x72 и специфицирована как нереэнтрантная (Non Reentrant), а также асинхронная ([SWS_Dcm_91078]).

Управление ходом асинхронного вызова осуществляется через параметр OpStatus:

• DCM_INITIAL: все входные параметры валидны. Сюда входят путь и имя файла (filePathAndName с filePathAndNameLength), байт dataFormatIdentifier (старший полубайт для сжатия, младший полубайт для шифрования), а также несжатый и сжатый размер файла (fileSizeUncompressed, fileSizeCompressed) ([SWS_Dcm_91078]).
• DCM_PENDING, DCM_CANCEL и DCM_FORCE_RCRRP_OK: в этих последующих вызовах все входные параметры установлены в 0x00 ([SWS_Dcm_91078]).

В качестве возвращаемых значений функция возвращает E_OK при успешном выполнении, DCM_E_PENDING при продолжающейся обработке или DCM_E_FORCE_RCRRP, если приложение запрашивает отправку предварительного ответа (NRC 0x78) ([SWS_Dcm_91078], [SWS_Dcm_91086]). В случае успеха maxNumberOfBlockLength определяет максимально допустимую длину блока будущих сообщений TransferData без SID и счётчика блоков ([SWS_Dcm_91078]).

В случае ошибки функция возвращает E_NOT_OK. В этом случае через параметр ErrorCode должен быть передан отрицательный код ответа (NRC), который DCM отправляет клиенту в отрицательном диагностическом ответе ([SWS_Dcm_91078]). Если конфигурация DcmRequestFileTransferUsePort активирована, эта функциональность альтернативно предоставляется как операция порта ProcessRequestAddFile интерфейса RequestFileTransfer ([SWS_Dcm_91086]).

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

Callout-функция Dcm_ProcessRequestDeleteFile вызывается DCM, чтобы в рамках диагностической службы RequestFileTransfer инициировать удаление файла (modeOfOperation = 0x02) на сервере [SWS_Dcm_91079]. Функция объявлена в Dcm_Externals.h и работает асинхронно, а также нереэнтрантно (Non Reentrant) [SWS_Dcm_91079].

Передача и анализ осуществляются на основе параметра OpStatus:

• DCM_INITIAL: указывает на старт операции. При этом все входные параметры валидны; filePathAndName передаёт место сохранения и имя удаляемого файла, длина которого в байтах специфицирована через filePathAndNameLength [SWS_Dcm_91079].
• DCM_PENDING, DCM_CANCEL или DCM_FORCE_RCRRP_OK: при продолжении обработки или отмене все входные параметры установлены в 0x00 [SWS_Dcm_91079].

В качестве возвращаемых значений функция возвращает E_OK при успешном выполнении, DCM_E_PENDING, если выполнение всё ещё продолжается и требует дальнейших вызовов, или DCM_E_FORCE_RCRRP, если приложение запрашивает отправку промежуточного сообщения с NRC 0x78 (Response Pending) [SWS_Dcm_91079], аналогично службе RequestFileTransfer [SWS_Dcm_91086].

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

Если обработка завершается неудачно, функция возвращает E_NOT_OK. В этом случае через выходной параметр ErrorCode должен быть предоставлен отрицательный код ответа, который DCM передаёт тестеру в качестве отрицательного ответа (NRC) [SWS_Dcm_91079].

Callout-функция Dcm_ProcessRequestReplaceFile вызывается DCM для инициации диагностического процесса для RequestFileTransfer с режимом работы 0x03 (ReplaceFile) [SWS_Dcm_91080]. Функция определена как нереэнтрантная (Non Reentrant) и асинхронная и предоставляется через заголовочный файл Dcm_Externals.h [SWS_Dcm_91080].

Управление процессом асинхронной обработки осуществляется через параметр OpStatus:

• При начальном вызове с DCM_INITIAL DCM передаёт все входные параметры валидными, включая путь и имя файла (filePathAndName с указанием длины filePathAndNameLength), идентификатор для сжатия и шифрования (dataFormatIdentifier), а также несжатый и сжатый размер файла (fileSizeUncompressed, fileSizeCompressed) [SWS_Dcm_91080].
• При последующих вызовах или отмене (DCM_PENDING, DCM_CANCEL, DCM_FORCE_RCRRP_OK) все входные параметры установлены в 0x00 [SWS_Dcm_91080].
• В случае успеха функция возвращает DCM через выходной параметр maxNumberOfBlockLength максимальную длину полезных данных для последующих запросов TransferData (без SID и счётчика последовательности блоков) [SWS_Dcm_91080].

В качестве возвращаемых значений предусмотрены E_OK при успешном выполнении, DCM_E_PENDING при продолжающейся обработке, а также DCM_E_FORCE_RCRRP для запроса ответа Response Pending (NRC 0x78) [SWS_Dcm_91080], [SWS_Dcm_91086]. Если выполнение завершается неудачно, функция возвращает E_NOT_OK и присваивает параметру ErrorCode соответствующий отрицательный диагностический код ответа (NRC), который DCM передаёт тестеру [SWS_Dcm_91080].

Callout-функция Dcm_ProcessRequestReadFile вызывается DCM, чтобы запустить процесс передачи файлов (служба RequestFileTransfer) с режимом работы ReadFile (modeOfOperation 0x04) [SWS_Dcm_91081]. Функция объявлена в заголовочном файле Dcm_Externals.h, работает асинхронно и является нереэнтрантной (Non Reentrant) [SWS_Dcm_91081].

Вызов выполняется через параметр состояния OpStatus: при начальном вызове DCM_INITIAL все входные параметры действительны, тогда как при последующих вызовах с DCM_PENDING, DCM_CANCEL или DCM_FORCE_RCRRP_OK они устанавливаются в 0x00 [SWS_Dcm_91081]. Приложение получает путь и имя файла через filePathAndName (длина в filePathAndNameLength), формат сжатия и шифрования через dataFormatIdentifier, а также размеры файлов через fileSizeUncompressed и fileSizeCompressed [SWS_Dcm_91081]. В качестве выходного параметра приложение должно заполнить maxNumberOfBlockLength максимальным количеством байтов для последующих ответов TransferData (без SID и счетчика последовательности блоков) [SWS_Dcm_91081].

В качестве возвращаемых значений Std_ReturnType определены E_OK при успешном выполнении, DCM_E_PENDING при все еще продолжающейся асинхронной обработке или DCM_E_FORCE_RCRRP для запроса ответа «Response Pending» (NRC 0x78) [SWS_Dcm_91081]. Если операция завершается сбоем, она возвращает E_NOT_OK; в этом случае DCM передает тестеру отрицательный ответ со значением NRC, заданным в выходном параметре ErrorCode [SWS_Dcm_91081]. Взаимодействие соответствует общей процедуре обработки службы RequestFileTransfer, аналогично тому, как она настраивается для других файловых операций, таких как ProcessRequestAddFile [SWS_Dcm_91086].

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

Колбэк-функция Dcm_ProcessRequestReadDir объявляется через заголовочный файл Dcm_Externals.h и вызывается DCM для асинхронного запуска службы RequestFileTransfer с режимом работы 0x05 (ReadDir) [SWS_Dcm_91082]. Ход обработки управляется через передаваемый параметр OpStatus [SWS_Dcm_91082]. При первом вызове с DCM_INITIAL DCM передает путь или имя через filePathAndName вместе с длиной в байтах filePathAndNameLength [SWS_Dcm_91082]. При последующих вызовах или при отмене (DCM_PENDING, DCM_CANCEL, DCM_FORCE_RCRRP_OK) все входные параметры установлены в 0x00 [SWS_Dcm_91082].

В качестве выходных значений приложение должно предоставить размер данных каталога через dirInfoLength и максимально допустимый размер блока для последующих передач через maxNumberOfBlockLength [SWS_Dcm_91082]. Помимо E_OK при успешном выполнении, функция может возвращать DCM_E_PENDING, если операция все еще продолжается, или DCM_E_FORCE_RCRRP, чтобы инициировать отправку промежуточного ответа (NRC 0x78) [SWS_Dcm_91082].

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

При возникновении ошибки функция должна возвращать E_NOT_OK. В этом случае DCM считывает параметр ErrorCode и передает его значение тестеру в качестве отрицательного кода ответа (NRC) [SWS_Dcm_91082]. Специфические сообщения DET или DEM для данного интерфейса не предусмотрены; поэтому проверка ошибок переданного пути, предположительно, полностью возлагается на реализацию на стороне приложения. Вопрос Q-278dbc3db7b4363b (открытый)

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

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

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

Колбэк-функция Dcm_WriteFile вызывается DCM, когда через UDS-службу TransferData (0x36) принимаются данные и активен процесс загрузки, ранее запущенный с помощью RequestFileTransfer с режимами 0x01 (AddFile) или 0x03 (ReplaceFile) [SWS_Dcm_01444]. Интерфейс доступен через Dcm_Externals.h [SWS_Dcm_91083].

Значения параметров зависят от статуса выполнения OpStatus [SWS_Dcm_91083]:

• DCM_INITIAL: все входные параметры действительны. Указатель Data ссылается на записываемые полезные данные, а DataLength указывает их длину в байтах. Значение DataLength не превышает максимальную длину блока (NumberOfBlockLength), ранее согласованную в Dcm_ProcessRequestFileTransfer.
• DCM_PENDING, DCM_CANCEL и DCM_FORCE_RCRRP_OK: все входные параметры установлены в 0x00.

Асинхронная семантика и возвращаемые значения

Функция работает асинхронно и является нереентерабельной (Non Reentrant) [SWS_Dcm_91083]. Она возвращает следующие значения состояния:

• E_OK: операция записи успешно завершена.
• DCM_E_PENDING: обработка еще не завершена и требует дальнейших вызовов.
• DCM_E_FORCE_RCRRP: приложение запрашивает отправку ответа ожидания (Response Pending, NRC 0x78).
• E_NOT_OK: операция завершилась сбоем.

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

Если Dcm_WriteFile возвращает значение E_NOT_OK, модуль DCM отправляет отрицательный UDS-ответ, чей NRC соответствует значению, предоставленному через выходной параметр ErrorCode [SWS_Dcm_91083].

Колбэк-функция Dcm_ReadFileOrDir вызывается модулем DCM, когда в рамках текущей выгрузки файла или каталога (ранее запущенной через UDS-службу RequestFileTransfer с режимом 0x04 для ReadFile или 0x05 для ReadDir) поступает корректный по формату запрос для UDS-службы TransferData (0x36) [SWS_Dcm_01445]. Функция служит для предоставления данных, отправляемых клиенту в качестве ответа [SWS_Dcm_91085]. Объявление интерфейса доступно через заголовочный файл Dcm_Externals.h [SWS_Dcm_91085].

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

• Рабочий статус (OpStatus): при начальном вызове с DCM_INITIAL все входные параметры действительны. При последующих вызовах или вызовах отмены с DCM_PENDING, DCM_CANCEL или DCM_FORCE_RCRRP_OK все входные параметры установлены в 0x00 [SWS_Dcm_91085].
• Буфер и длина блока: параметр DataLength на входе передает максимально допустимую длину блока (соответствующую значению maxNumberOfBlockLength, сообщенному клиенту), а на выходе возвращает фактическую длину в байтах, предоставленную в Data, которая не должна превышать входное значение [SWS_Dcm_91085]. Интерпретация: хотя Data в интерфейсе формально объявлен как входной параметр, он, вероятно, служит для передачи считываемых полезных данных. Вопрос Q-53de8a0bdbc4a2b4 (открытый)
• Возвращаемые значения: операция возвращает E_OK при успешном предоставлении данных, DCM_E_PENDING при еще не завершенной обработке или DCM_E_FORCE_RCRRP, если приложение хочет принудительно инициировать отправку промежуточного сообщения (Response Pending, NRC 0x78) [SWS_Dcm_91085].

Если обработка в приложении завершается сбоем, возвращается E_NOT_OK. В этом случае ошибки модуль DCM передает клиенту отрицательный UDS-ответ (NRC), код ошибки которого соответствует значению, установленному в выходном параметре ErrorCode [SWS_Dcm_91085].

Функция Dcm_MainFunction служит для обработки центральных задач основного цикла Diagnostic Communication Manager ([SWS_Dcm_00053]). Она имеет сигнатуру void Dcm_MainFunction(void) и не возвращает значений. Поскольку она предоставляется через заголовочный файл SchM_Dcm.h, ее вызов, вероятно, должен происходить циклически в контексте задачи планировщика базового программного обеспечения. Вопрос Q-e083a72aae447ab5 (открытый)

Важнейшей задачей является управление и продолжение асинхронных процессов через границы циклов:

• Если операция с Dcm_OpStatusType возвращает значение DCM_E_PENDING, DCM повторно вызывает операцию при каждом вызове Dcm_MainFunction с OpStatus = DCM_PENDING, пока сохраняется этот статус ([SWS_Dcm_00530]).
• Если Dem_ClearDTC() возвращает статус DEM_PENDING, функция повторно вызывается в следующем цикле Dcm_MainFunction; DCM при необходимости отправляет NRC 78 (ResponsePending) ([SWS_Dcm_00703]).
• Вызовы Dem_SetDTCFilter() с установленным параметром FilterForFault-DetectionCounter обязательно должны выполняться в контексте Dcm_MainFunction ([SWS_Dcm_00519]).
• После подтверждения передачи RCR-RP DCM снова вызывает операции, такие как Dcm_WriteMemory или Dcm_ReadMemory, из Dcm_MainFunction с OpStatus = DCM_FORCE_RCRRP_OK ([SWS_Dcm_00529], [SWS_Dcm_00838], [SWS_Dcm_00840]).
• Если при Xxx_GetSecurityAttemptCounter возвращается значение DCM_E_PENDING, вызов прерывается и продолжается в следующем цикле ([SWS_Dcm_01351]); при превышении сконфигурированного тайм-аута DCM отменяет отложенную операцию с OpStatus = DCM_CANCEL ([SWS_Dcm_01352]).

Функция Xxx_GetSeed (предоставляемая через Dcm_Externals.h) служит для асинхронного предоставления значения Seed приложением для модуля DCM [SWS_Dcm_01151]. Она вызывается, как только принимается UDS-запрос службы SecurityAccess (0x27) с типом подфункции «requestSeed» и запрошенный уровень безопасности ещё не активен [SWS_Dcm_00862], [SWS_Dcm_00324].

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

Интерфейс определён как нереентерабельный (Non Reentrant) и функционирует асинхронно [SWS_Dcm_01151]:

• SecurityAccessDataRecord: указатель на дополнительные входные данные для вычисления Seed; минимальный размер составляет один байт согласно DcmDspSecurityADRSize [SWS_Dcm_01151].
• OpStatus: указывает текущий статус асинхронной операции [SWS_Dcm_01151].
• Seed: выходной указатель, через который приложение предоставляет вычисленный Seed [SWS_Dcm_01151].
• ErrorCode: выходной параметр для возврата отрицательного кода ошибки (NRC) [SWS_Dcm_01151].

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

• E_OK: Seed успешно определён и предоставлен [SWS_Dcm_01151].
• DCM_E_PENDING: вычисление ещё не завершено; для окончания необходимы последующие вычисления или вызовы [SWS_Dcm_01151].
• E_NOT_OK: запрос завершился неудачей. В этом случае модуль DCM отправляет отрицательный UDS-ответ со значением NRC, переданным в параметре ErrorCode [SWS_Dcm_01151], [SWS_Dcm_00659].

Указания по интеграции

В зависимости от конфигурации DcmDspSecurityUsePort привязка осуществляется как функция Си в USE_ASYNCH_FNC (ссылка через DcmDspSecurityGetSeedFnc) [SWS_Dcm_00862] или как операция Rte в USE_ASYNCH_CLIENT_SERVER [SWS_Dcm_00324]. Если дополнительные данные доступа передавать не требуется, используется альтернативная сигнатура функции без параметра SecurityAccessDataRecord [SWS_Dcm_91003].

Функция Xxx_GetSeed служит асинхронным интерфейсом модуля DCM к приложению для предоставления значения seed в рамках службы UDS SecurityAccess (0x27) при запросе типа «requestSeed» [SWS_Dcm_91003], [SWS_Dcm_00862]. Вызов выполняется субмодулем DCM DSP, если уровень безопасности еще не активен и конфигурация предусматривает USE_ASYNCH_CLIENT_SERVER или USE_ASYNCH_FNC [SWS_Dcm_00324], [SWS_Dcm_00862].

Интерфейс реализован как асинхронный и нереентерабельный (Non Reentrant) [SWS_Dcm_91003]. Управление ходом обработки осуществляется через входной параметр OpStatus (тип Dcm_OpStatusType) [SWS_Dcm_91003]. В качестве возвращаемых значений определены E_OK при успешном предоставлении, E_NOT_OK в случае ошибки, а также DCM_E_PENDING, если генерация seed все еще продолжается и требуются дальнейшие вызовы [SWS_Dcm_91003]. Сгенерированное значение передается через указатель Seed (буфер Inout/Out) [SWS_Dcm_91003].

Если операция завершается неудачно и Xxx_GetSeed возвращает E_NOT_OK, модуль DCM должен отправить отрицательный ответ (NRC) с кодом ошибки, который был установлен через выходной параметр ErrorCode (Dcm_NegativeResponseCodeType) [SWS_Dcm_91003], [SWS_Dcm_00659]. Служба объявлена через заголовочный файл Dcm_Externals.h [SWS_Dcm_91003].

Функция Xxx_CompareKey вызывается модулем Diagnostic Communication Manager ([SWS_Dcm_91004]) асинхронно и нереентерабельно для сверки полученного ключа в рамках UDS-службы SecurityAccess (0x27, подфункция sendKey) с внутренней логикой приложения ([SWS_Dcm_00863]). Она используется, если статус доступа еще не активен, запрос seed был успешным и параметр конфигурации DcmDspSecurityUsePort установлен в USE_ASYNCH_CLIENT_SERVER ([SWS_Dcm_00324]) либо согласно [SWS_Dcm_00863] функциональный интерфейс был сконфигурирован через USE_ASYNCH_FNC/DcmDspSecurityCompareKeyFnc. Интерфейс объявлен в Dcm_Externals.h ([SWS_Dcm_91004]).

Передача включает указатель на проверяемый ключ Key, текущий статус операции OpStatus (типа Dcm_OpStatusType), а также указатель ErrorCode для выдаваемого в случае ошибки кода отрицательного ответа ([SWS_Dcm_91004]). В качестве возвращаемых значений специфицированы:

• E_OK: проверка ключа успешна ([SWS_Dcm_91004]).
• DCM_E_PENDING: проверка еще не завершена; для завершения требуются дальнейшие вызовы модулем DCM ([SWS_Dcm_91004]).
• E_NOT_OK: обработка не удалась. Затем DCM отправляет отрицательный ответ UDS с кодом NRC, установленным в ErrorCode, не изменяя внутренний уровень безопасности и не увеличивая счетчик неудачных попыток (AttemptCounter) ([SWS_Dcm_01150]).
• DCM_E_COMPARE_KEY_FAILED: ключ не совпадает ([SWS_Dcm_91004]).

Если сравнение ключа завершается неудачно (DCM_E_COMPARE_KEY_FAILED), при сконфигурированном DcmDspSecurityNumAttDelay инкрементируется AttemptCounter ([SWS_Dcm_01397]). Если значение счетчика ниже предельного значения, DCM отправляет NRC 0x35 (InvalidKey) ([SWS_Dcm_00660]). Если количество неудачных попыток достигает или превышает сконфигурированный предел DcmDspSecurityNumAttDelay, DCM запускает SecurityDelayTimer с длительностью DcmDspSecurityDelayTime и отправляет NRC 0x36 (exceededNumberOfAttempts) ([SWS_Dcm_01349]). В обоих случаях уровень безопасности остается без изменений.

Асинхронная и нереентерабельная функция [SWS_Dcm_01152] при инициализации DCM считывает из приложения текущий счётчик неудачных попыток для сконфигурированного уровня безопасности. Вызов выполняется для каждой записи в DcmDspSecurityRow, в которой параметр конфигурации DcmDspSecurityAttemptCounterEnabled установлен в TRUE [SWS_Dcm_01154].

Управление последовательностью выполнения осуществляется через параметр OpStatus со значениями DCM_INITIAL, DCM_PENDING или DCM_CANCEL [SWS_Dcm_01152]. Если функция возвращает DCM_E_PENDING, DCM прерывает цепочку вызовов и возобновляет её в следующем цикле Dcm_MainFunction() [SWS_Dcm_01351]. Если контроль времени DcmDspSecurityMaxAttemptCounterReadoutTime, сконфигурированный после первого цикла, превышен, DCM прерывает ещё ожидающую операцию с помощью DCM_CANCEL [SWS_Dcm_01352].

В случае успеха интерфейс возвращает E_OK и передаёт показание счётчика через выходной параметр AttemptCounter [SWS_Dcm_01152]. Если вызов возвращает E_NOT_OK, DCM автоматически устанавливает счётчик в значение, сконфигурированное для этого уровня безопасности DcmDspSecurityNumAttDelay [SWS_Dcm_01156].

Пока все значения счётчиков не будут окончательно определены или прерваны, DCM отклоняет любой запрос на SecurityAccess (0x27) для запроса Seed с отрицательным кодом ответа conditionsNotCorrect (0x22) [SWS_Dcm_01354]. После завершения цепочки опроса DCM проверяет значения счётчиков: если хотя бы один счётчик достигает или превышает пороговое значение DcmDspSecurityNumAttDelay, DCM запускает SecurityDelayTimer с большим значением из DcmDspSecurityDelayTimeOnBoot и DcmDspSecurityDelayTime [SWS_Dcm_01355].

Функция Xxx_SetSecurityAttemptCounter служит для установки счётчика попыток для конкретного уровня безопасности в приложении ([SWS_Dcm_01153]). Она предоставляется через заголовочный файл Dcm_Externals.h.

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

Выполнение происходит асинхронно и специфицировано как нереентерабельное (Non Reentrant) ([SWS_Dcm_01153]). Вызов управляет ходом выполнения через параметр OpStatus со значениями DCM_INITIAL, DCM_PENDING или DCM_CANCEL. Новое значение счётчика передаётся через входной параметр AttemptCounter (uint8).

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

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

• E_OK: запрос успешно завершён.
• E_NOT_OK: выполнение завершилось неудачно.
• DCM_E_PENDING: обработка ещё не окончена; для завершения требуются дальнейшие вызовы.

Если текущая асинхронная операция прерывается, DCM передаёт статус DCM_CANCEL ([SWS_Dcm_01153]).

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

Модуль DCM вызывает Xxx_SetSecurityAttemptCounter, как только он изменил счётчик попыток, чтобы уведомить приложение об обновлении ([SWS_Dcm_01155]). Это предполагает, что параметр конфигурации DcmDspSecurityAttemptCounterEnabled для соответствующего DcmDspSecurityRow сконфигурирован в TRUE ([SWS_Dcm_01155]). Поскольку интерфейс не является реентерабельным, приложение должно исключить параллельное выполнение для одного и того же экземпляра ([SWS_Dcm_01153]).

Синхронная функция Xxx_ReadData запрашивает у приложения текущее значение данных DID или PID, если конфигурационный параметр DcmDspDataUsePort установлен в USE_DATA_SYNCH_CLIENT_SERVER [SWS_Dcm_00793]. Интерфейс предоставляется через заголовочный файл Dcm_Externals.h и имеет Service ID 0x34 [SWS_Dcm_00793]. Вызванное приложение копирует запрошенные полезные данные непосредственно в переданный буфер Data [SWS_Dcm_00793].

В отношении возвращаемого значения установлено, что вызов без исключения возвращает E_OK [SWS_Dcm_00793]. Специфические коды ошибок, отрицательные ответы или сообщения DET/DEM для этой сигнатуры не специфицированы. Интерпретация: сбой предоставления данных на этом уровне интерфейса, вероятно, не предусмотрен, так как в отличие от асинхронного варианта [SWS_Dcm_91005] не существует ни параметра ErrorCode для кодов отрицательного ответа (NRC), ни возвращаемых значений, таких как E_NOT_OK или DCM_E_PENDING. Вопрос Q-adcf0171ecfd37c4 (открытый)

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

• При получении запроса службы OBD $01 с PID, отличными от PID доступности, DCM вызывает соответствующие сконфигурированные функции Xxx_ReadData для всех данных PID, чтобы получить значения ответа [SWS_Dcm_00408].
• При UDS-запросе службы 0x22 (ReadDataByIdentifier) с идентификаторами, отличными от идентификаторов доступности, DCM вызывает функции для всех данных OBDDataIdentifier [SWS_Dcm_01380], а также OBDInfoTypeDataIdentifier [SWS_Dcm_01389].
• Если же требуется асинхронное поведение, задействуются отдельные сигнатуры с OpStatus согласно [SWS_Dcm_91006] или [SWS_Dcm_91005].

Функция Xxx_ReadData служит для того, чтобы асинхронно опрашивать значения данных DID или PID у приложения, если параметр DcmDspDataUsePort сконфигурирован на USE_DATA_ASYNCH_CLIENT_SERVER ([SWS_Dcm_91006]). Она объявляется через заголовочный файл Dcm_Externals.h ([SWS_Dcm_91006]).

При вызове параметр OpStatus (тип Dcm_OpStatusType) управляет ходом текущей операции, тогда как через указатель Data (тип uint8*) передается выходной буфер, в который необходимо скопировать запрошенные данные ([SWS_Dcm_91006]). В качестве возвращаемых значений определены E_OK при успешном завершении и DCM_E_PENDING, если обработка все еще продолжается и требует дальнейших вызовов для завершения ([SWS_Dcm_91006]).

Модуль DCM интегрирует эту функцию в следующие диагностические процессы:

• При получении OBD Service $01 DCM считывает текущие значения PID (за исключением PID доступности) через сконфигурированные функции Xxx_ReadData ([SWS_Dcm_00408]).
• При UDS Service 0x22 (ReadDataByIdentifier) DCM вызывает функцию для OBDDataIdentifier ([SWS_Dcm_01380]) и OBDInfoTypeDataIdentifier ([SWS_Dcm_01389]).

В отношении выполнения функция специфицирована как не reentrant (Non Reentrant) ([SWS_Dcm_91006]). В отличие от синхронного интерфейса ([SWS_Dcm_00793]) или асинхронного варианта с дополнительным параметром ErrorCode ([SWS_Dcm_91005]) данная реализация функции не предусматривает прямого возврата кода отрицательного ответа.

Функция Xxx_ReadData асинхронно запрашивает у приложения значение данных DID или PID, если параметр конфигурации DcmDspDataUsePort установлен в USE_DATA_ASYNCH_CLIENT_SERVER [SWS_Dcm_91005]. Объявление функции предоставляется через файл интерфейса Dcm_Externals.h [SWS_Dcm_91005].

Интерфейс обладает следующими характеристиками вызова и выполнения:

• Семантика и параметры: входной параметр OpStatus управляет ходом текущей операции [SWS_Dcm_91005]. При успешном завершении запрошенные полезные данные копируются в выходной буфер Data и возвращается E_OK [SWS_Dcm_91005]. Если приложению требуется дополнительное время на обработку, оно сигнализирует DCM_E_PENDING, после чего требуются последующие действия [SWS_Dcm_91005].
• Обработка ошибок: если операция завершается сбоем и возвращает E_NOT_OK, модуль DCM анализирует выходной параметр ErrorCode и отправляет отрицательный диагностический ответ с этим кодом NRC [SWS_Dcm_91005].
• Параллелизм: функция определена как нереентерабельная (Non Reentrant) [SWS_Dcm_91005]. Интерпретация: повторные вызовы при незавершенной обработке, вероятно, выполняются последовательно в цикле основной обработки DCM. Вопрос Q-541226d5f242f7c2 (открытый)
• Взаимодействие: модуль DCM вызывает функцию при запросах OBD Service $01 для PID недоступности [SWS_Dcm_00408], а также при UDS-сервисе ReadDataByIdentifier (0x22) для OBDDataIdentifier [SWS_Dcm_01380] и OBDInfoTypeDataIdentifier [SWS_Dcm_01389]. По сравнению с синхронным вариантом [SWS_Dcm_00793] или асинхронными интерфейсами без параметра NRC [SWS_Dcm_91006] данная сигнатура обеспечивает передачу конкретной отрицательной ошибки.

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

Функция Xxx_WriteData вызывается модулем Diagnostic Communication Manager (DCM), чтобы запросить приложение на запись значения данных DID (Data Identifier) ([SWS_Dcm_00794]). Объявление предоставляется через заголовочный файл Dcm_Externals.h. Вызов выполняется синхронно под service ID 0x51 ([SWS_Dcm_00794]).

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

• Data (in): указатель на буфер с записываемыми полезными данными ([SWS_Dcm_00794]).
• ErrorCode (out): указатель на переменную, в которую в случае сбоя должен быть внесен отрицательный код диагностики (NRC) ([SWS_Dcm_00794]).
• Возвращаемое значение (Std_ReturnType): E_OK сигнализирует об успешной записи, E_NOT_OK — о сбое операции ([SWS_Dcm_00794]).

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

Если функция возвращает E_NOT_OK, модуль DCM считывает параметр ErrorCode и отправляет отрицательный диагностический ответ с этим кодом NRC ([SWS_Dcm_00794]).

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

Функция специфицирована как нереентерабельная (Non Reentrant) ([SWS_Dcm_00794]) и не должна выполняться параллельно.

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

Поскольку параметр длины отсутствует, этот вариант, вероятно, предназначен для DID с фиксированной длиной данных. Вопрос Q-ebc074ac1cb66aaa (открытый) Для DID с переменной длиной AUTOSAR предоставляет синхронную сигнатуру с параметром DataLength ([SWS_Dcm_91007]). Кроме того, для длительных процессов существуют асинхронные варианты с OpStatus и возможным возвратом DCM_E_PENDING, как с фиксированной длиной данных ([SWS_Dcm_91008]), так и с параметром переменной длины ([SWS_Dcm_91009]).

Функция обратного вызова Xxx_WriteData служит для того, чтобы запросить у приложения запись значения данных Data Identifier (DID) [SWS_Dcm_91007]. Интерфейс объявлен через заголовочный файл Dcm_Externals.h и имеет Service ID 0x52 [SWS_Dcm_91007]. Вызов происходит синхронно и специфицирован как не reentrant (Non Reentrant), поэтому параллельные вызовы для одной и той же функции не допускаются [SWS_Dcm_91007].

В качестве параметров функция принимает буфер Data с записываемыми полезными данными, а также DataLength с указанием длины в байтах [SWS_Dcm_91007]. В качестве возвращаемого значения она возвращает тип Std_ReturnType с E_OK при успешном выполнении или E_NOT_OK в случае ошибки [SWS_Dcm_91007]. Если операция завершается неудачно и возвращает E_NOT_OK, модуль DCM должен отправить отрицательный ответ диагностическому тестеру; при этом Negative Response Code (NRC) соответствует значению, переданному через параметр-указатель ErrorCode [SWS_Dcm_91007].

В общей системе [SWS_Dcm_91007] представляет собой синхронный вариант для DID с явным указанием длины. В дополнение к этому с [SWS_Dcm_00794] (Service ID 0x51) существует синхронный вариант без параметра DataLength. Для более длительных процессов записи стандарт предусматривает асинхронные интерфейсы: [SWS_Dcm_91008] (Service ID 0x35) без указания длины, а также [SWS_Dcm_91009] (Service ID 0x3e) с DataLength. Обе асинхронные функции управляются через OpStatus и могут наряду с E_OK и E_NOT_OK также возвращать DCM_E_PENDING [SWS_Dcm_91008] [SWS_Dcm_91009].

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

Функция Xxx_WriteData запрашивает у приложения запись значения данных Data Identifier (DID) [SWS_Dcm_91008]. Она объявлена в заголовочном файле Dcm_Externals.h и обладает асинхронной семантикой выполнения с Service ID 0x35 [SWS_Dcm_91008].

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

• Data (IN): указатель на буфер, содержащий записываемые данные.
• OpStatus (IN): статус текущей операции для управления ходом асинхронного вызова.
• ErrorCode (OUT): указатель на код ошибки (NRC), который устанавливается в случае ошибки.
• Возвращаемое значение (Std_ReturnType): E_OK подтверждает успешный процесс записи, E_NOT_OK сообщает о сбое, а DCM_E_PENDING указывает на то, что операция все еще продолжается и требует дальнейших вызовов для завершения.

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

Если вызов возвращает значение E_NOT_OK, модуль DCM должен отправить отрицательный ответ со значением NRC, переданным в выходном параметре ErrorCode [SWS_Dcm_91008]. Функция специфицирована как не reentrant [SWS_Dcm_91008], так что одновременные или перекрывающиеся вызовы для одного и того же экземпляра недопустимы.

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

Этот интерфейс согласно [SWS_Dcm_91008] охватывает асинхронный доступ на запись без отдельного параметра длины. AUTOSAR определяет для этого родственные варианты в DCM: синхронную сигнатуру без указания длины [SWS_Dcm_00794], а также сигнатуры с дополнительным параметром DataLength для синхронных [SWS_Dcm_91007] и асинхронных процессов [SWS_Dcm_91009].

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

Функция Xxx_WriteData запрашивает у приложения запись значения данных идентификатора данных (DID) [SWS_Dcm_91009]. Она объявляется через заголовочный файл Dcm_Externals.h и имеет идентификатор службы 0x3e [SWS_Dcm_91009]. Выполнение происходит асинхронно (Asynchronous), для чего передаются следующие параметры:

• Data (in): указатель на буфер с записываемыми полезными данными [SWS_Dcm_91009].
• DataLength (in): длина записываемых данных в байтах [SWS_Dcm_91009].
• OpStatus (in): статус операции (Dcm_OpStatusType) для управления ходом асинхронной обработки [SWS_Dcm_91009].
• ErrorCode (out): указатель для получения кода отрицательного ответа (NRC) в случае ошибки [SWS_Dcm_91009].

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

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

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

Взаимодействие и варианты интерфейса

Сигнатура [SWS_Dcm_91009] охватывает асинхронные операции записи с явным указанием длины. В DCM существуют другие варианты Xxx_WriteData:

• Синхронное выполнение без указания длины: [SWS_Dcm_00794] (идентификатор службы 0x51).
• Синхронное выполнение с указанием длины: [SWS_Dcm_91007] (идентификатор службы 0x52).
• Асинхронное выполнение без указания длины: [SWS_Dcm_91008] (идентификатор службы 0x35).

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

С помощью функции Xxx_ReadDataLength модуль DCM запрашивает у приложения определение и возврат длины данных некоторого элемента данных в байтах [SWS_Dcm_00796]. Интерфейс объявлен в заголовочном файле Dcm_Externals.h и имеет Service-ID 0x36 [SWS_Dcm_00796]. Запрос выполняется синхронно [SWS_Dcm_00796]. Через выходной параметр DataLength типа uint16* приложение передает модулю DCM длину читаемых данных в байтах [SWS_Dcm_00796]. Входные или входные/выходные параметры не определены [SWS_Dcm_00796]. В качестве возвращаемого значения функция всегда возвращает E_OK типа Std_ReturnType [SWS_Dcm_00796].

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

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

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

Наряду с синхронной функцией существует одноименный асинхронный вариант с Service-ID 0x4c, который также предоставляется через Dcm_Externals.h [SWS_Dcm_91010]. В то время как синхронная версия [SWS_Dcm_00796] обходится без статуса операции, асинхронный аналог требует входной параметр OpStatus типа Dcm_OpStatusType [SWS_Dcm_91010]. Кроме того, асинхронный интерфейс наряду с E_OK может возвращать значение DCM_E_PENDING, если запрос еще не завершен и требует дальнейших вызовов для завершения [SWS_Dcm_91010].

Функция [SWS_Dcm_91010] (Service-ID 0x4c) запрашивает у приложения определение длины элемента данных в байтах. Она объявлена в заголовке Dcm_Externals.h и служит модулю Diagnostic Communication Manager (DCM) для гибкого запроса длины диагностических данных.

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

При вызове модуль DCM передает текущий ход выполнения через входной параметр OpStatus типа Dcm_OpStatusType ([SWS_Dcm_91010]). Результат запроса приложение записывает в выходной параметр DataLength (тип uint16*). Если длина данных недоступна непосредственно, функция сигнализирует через возвращаемое значение DCM_E_PENDING, что обработка продолжается и требуются дальнейшие вызовы ([SWS_Dcm_91010]). Как только результат готов, приложение сообщает о завершении возвратом E_OK.

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

Согласно спецификации функция классифицирована как нереентерабельная ([SWS_Dcm_91010]), поэтому одновременные вызовы со стороны DCM должны быть исключены. Поскольку спецификация не предусматривает конкретных значений ошибок, кроме DCM_E_PENDING, DCM при возврате E_OK, вероятно, всегда исходит из корректно установленного размера в байтах. Вопрос Q-e7ecd3a518e2cbcb (открытый)

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

Асинхронный интерфейс [SWS_Dcm_91010] отличается от родственного синхронного варианта [SWS_Dcm_00796] (Service-ID 0x36). Последний не имеет параметра OpStatus, выполняется синхронно и всегда возвращает длину непосредственно с E_OK. Напротив, [SWS_Dcm_91010] позволяет приложению распределять трудоемкие вычисления асинхронно по нескольким циклам вызова.

Синхронная функция callout Xxx_ConditionCheckRead предоставляется через заголовочный файл Dcm_Externals.h и служит для того, чтобы запросить у приложения, выполнены ли условия для считывания диагностических данных [SWS_Dcm_00797].

Интерфейс не имеет входных параметров и сигнализирует о статусе проверки через возвращаемое значение типа Std_ReturnType [SWS_Dcm_00797]:

• E_OK: проверка прошла успешно, условия для чтения данных выполнены [SWS_Dcm_00797].
• E_NOT_OK: проверка завершилась неудачно, считывание недопустимо [SWS_Dcm_00797].

Если функция возвращает E_NOT_OK, модуль DCM отправляет отрицательный ответ (Negative Response) с кодом ошибки, который приложение передало через выходной параметр ErrorCode (тип Dcm_NegativeResponseCodeType*) [SWS_Dcm_00797].

Относительно параллелизма функция специфицирована как нереентерабельная (Non Reentrant) и выполняется синхронно с идентификатором службы 0x49 [SWS_Dcm_00797]. Поэтому проверка на стороне приложения должна вычисляться непосредственно без блокирующих задержек во избежание замедления синхронной вызывающей стороны DCM. Вопрос Q-ada29c78c29d961e (открытый)

В отличие от этой синхронной операции, [SWS_Dcm_91011] определяет асинхронный вариант под идентификатором службы 0x37. Он дополнительно использует входной параметр OpStatus (тип Dcm_OpStatusType) и помимо E_OK и E_NOT_OK может также возвращать DCM_E_PENDING, если для завершения проверки необходимы последующие шаги [SWS_Dcm_91011].

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

Функция Xxx_ConditionCheckRead предоставляется через заголовочный файл Dcm_Externals.h и служит для запроса у прикладного программного обеспечения, выполнены ли условия для считывания диагностических данных [SWS_Dcm_91011]. Выполнение происходит под Service-ID 0x37 асинхронно [SWS_Dcm_91011]. Через входной параметр OpStatus (тип Dcm_OpStatusType) передается текущий статус выполняемой операции [SWS_Dcm_91011].

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

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

• E_OK: запрос был успешен, и условия считывания выполнены [SWS_Dcm_91011].
• E_NOT_OK: проверка завершилась неудачно [SWS_Dcm_91011]. В этом случае приложение должно через выходной параметр ErrorCode установить код отрицательного ответа (NRC) типа Dcm_NegativeResponseCodeType; модуль DCM затем отправляет отрицательный ответ с этим NRC [SWS_Dcm_91011].
• DCM_E_PENDING: проверка еще не завершена, поэтому для завершения требуются дальнейшие вызовы [SWS_Dcm_91011].

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

Интерфейс специфицирован как нереентерабельный (Non Reentrant) [SWS_Dcm_91011]. В отличие от этого асинхронного варианта, [SWS_Dcm_00797] под Service-ID 0x49 определяет синхронную сигнатуру без параметра OpStatus, которая возвращает исключительно E_OK или E_NOT_OK [SWS_Dcm_00797].

Асинхронный интерфейс Xxx_GetScalingInformation предоставляется через заголовок Dcm_Externals.h и служит для запроса информации о масштабировании элемента данных из приложения [SWS_Dcm_91012]. Модуль DCM вызывает эту функцию, как только принимается диагностический запрос для UDS-службы ReadScalingByIdentifier, а именно для каждого элемента данных, сконфигурированного для запрошенного DID [SWS_Dcm_00394].

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

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

• OpStatus (in): передает текущий статус выполняемой операции.
• ScalingInfo (out): буфер для приема информации о масштабировании (scalingByte и scalingByteExtension).
• ErrorCode (out): принимает код отрицательного ответа, если операция завершается неудачно.

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

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

Если вызов возвращает E_NOT_OK, модуль DCM должен отправить отрицательный ответ, NRC которого соответствует значению, предоставленному через выходной параметр ErrorCode [SWS_Dcm_91012]. Функция специфицирована как нереентерабельная (Non Reentrant) [SWS_Dcm_91012]. Интерпретация: вызывается ли эта асинхронная функция с OpStatus или альтернативно специфицированный синхронный вариант без OpStatus [SWS_Dcm_00798], вероятно, зависит от конфигурации соответствующего DID. Вопрос Q-c4054a798f17a52c (открытый)

Функция Xxx_ReturnControlToECU предоставляется через заголовочный файл Dcm_Externals.h и запрашивает у приложения возврат управления входом/выходом (IOControl) электронному блоку управления (ECU) [SWS_Dcm_01285]. Вызов выполняется синхронно и специфицирован как нереэнтрантный [SWS_Dcm_01285].

Параметры и варианты

Сигнатура функции зависит от конфигурации внешней маски управления [SWS_Dcm_01285]:

• Если DcmDspDidControlMask установлен в DCM_CONTROLMASK_EXTERNAL и размер маски составляет до четырёх байт (DcmDspDidControlMaskSize <= 0x04), передаётся входной параметр controlMask типа Dcm_ControlMask_{DID}Type [SWS_Dcm_01285].
• Если размер маски составляет пять или более байт (DcmDspDidControlMaskSize >= 0x05), вместо этого используется указатель controlMask2 типа uint8* [SWS_Dcm_01285].
• Через выходной параметр ErrorCode (тип Dcm_NegativeResponseCodeType*) функция в случае ошибки передаёт специфический отрицательный код ответа (NRC) модулю DCM [SWS_Dcm_01285].

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

Функция возвращает статус Std_ReturnType. При успешном возврате управления приложение сообщает E_OK [SWS_Dcm_01285]. Если операция завершается неудачно, функция должна возвратить E_NOT_OK; в этом случае модуль DCM отправляет диагностическому тестеру отрицательный ответ с кодом NRC, сохранённым в ErrorCode [SWS_Dcm_01285].

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

DCM вызывает сконфигурированный интерфейс функции (параметр DcmDspDataReturnControlToEcuFnc), если DcmDspDataUsePort сконфигурирован на USE_DATA_SYNCH_FNC, USE_DATA_ASYNCH_FNC или USE_DATA_ASYNCH_FNC_ERROR [SWS_Dcm_01435]. Помимо регулярных диагностических действий, Xxx_ReturnControlToECU вызывается модулем DCM, в частности, когда активная последовательность управления входами/выходами должна быть прервана [SWS_Dcm_01435].

Синхронный функциональный интерфейс Xxx_ResetToDefault предоставляется через заголовочный файл Dcm_Externals.h и служит для запроса приложения сбросить управление вводом-выводом (IOControl) к значению по умолчанию [SWS_Dcm_01286].

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

Функция имеет Service-ID 0x4d, работает синхронно и специфицирована как нереентерабельная [SWS_Dcm_01286]. В зависимости от сконфигурированного размера внешней маски управления передается один из двух альтернативных входных параметров:

• controlMask (тип Dcm_ControlMask_{DID}Type) используется, когда DcmDspDataUsePort сконфигурирован на USE_DATA_SYNCH_FNC, DcmDspDidControlMask установлено на DCM_CONTROLMASK_EXTERNAL и DcmDspDidControlMaskSize составляет не более 0x04 [SWS_Dcm_01286].
• controlMask2 (тип uint8*) используется, когда при идентичных граничных условиях DcmDspDidControlMaskSize сконфигурирован больше или равен 0x05 [SWS_Dcm_01286].

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

Если сброс удалось выполнить успешно, функция возвращает E_OK [SWS_Dcm_01286]. Если операция завершилась неудачно, должно быть возвращено E_NOT_OK. В этом случае приложение заполняет выходной параметр ErrorCode (тип Dcm_NegativeResponseCodeType*) соответствующим отрицательным кодом ответа (NRC), который модуль DCM передает тестеру в качестве отрицательного ответа [SWS_Dcm_01286].

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

Если система рассчитана на асинхронное выполнение интерфейса через USE_DATA_ASYNCH_FNC или USE_DATA_ASYNCH_FNC_ERROR, вместо этой синхронной функции используется асинхронный вариант с дополнительным параметром OpStatus и Service-ID 0x3c [SWS_Dcm_01314].

Асинхронная функция [SWS_Dcm_01314] запрашивает у приложения сброс управления вводом-выводом (IOControl) к его значению по умолчанию. Она объявлена в Dcm_Externals.h и имеет Service-ID 0x3c. Через параметр OpStatus управляется ход выполнения операции. При еще не завершенной обработке функция возвращает DCM_E_PENDING, тогда как успешное завершение подтверждается значением E_OK.

В зависимости от конфигурации и размера маски (от DcmDspDidControlMaskSize до 4 байт или от 5 байт) при внешней маскировке дополнительно передается controlMask или controlMask2 соответственно [SWS_Dcm_01314]. Если сброс завершается неудачно, функция возвращает E_NOT_OK. В этом случае через выходной параметр ErrorCode должен передаваться отрицательный код ответа (NRC), который модуль DCM отправляет тестеру в виде отрицательного ответа (negative response) [SWS_Dcm_01314].

Функция специфицирована как нереентерабельная (Non Reentrant) [SWS_Dcm_01314]. Она используется, когда DcmDspDataUsePort установлено на USE_DATA_ASYNCH_FNC или USE_DATA_ASYNCH_FNC_ERROR. Для синхронных конфигураций интерфейса (USE_DATA_SYNCH_FNC) альтернативно существует синхронный вариант без OpStatus [SWS_Dcm_01286].

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

Синхронная функция Xxx_FreezeCurrentState (представленная в каталоге элементов как Xxx_FreezeCurrentStateManager) служит для того, чтобы запросить у приложения фиксацию текущего состояния управления входом/выходом (IOControl) [SWS_Dcm_01290]. Функция доступна через заголовочный файл Dcm_Externals.h и имеет идентификатор службы (Service ID) 0x4a AUTOSAR_SWS_DiagnosticCommunicationManager с. 279. (Интерпретация: префикс Xxx, вероятно, выступает в качестве заполнителя для соответствующего модуля приложения.) Вопрос Q-f8c864cda732acc2 (открытый)

Параметры интерфейса определяются конфигурацией внешней маски управления (DcmDspDidControlMask на DCM_CONTROLMASK_EXTERNAL) [SWS_Dcm_01290]:

• controlMask (вход, тип Dcm_ControlMask_{DID}Type): передаётся, если размер маски DcmDspDidControlMaskSize сконфигурирован меньше или равен 4 байтам (<= 0x04).
• controlMask2 (вход, тип uint8*): используется вместо этого, если размер маски составляет не менее 5 байт (=> 0x05).
• ErrorCode (выход, тип Dcm_NegativeResponseCodeType*): указатель для приёма отрицательного кода ответа в случае ошибок.

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

Функция возвращает в качестве Std_ReturnType либо E_OK при успешном выполнении, либо E_NOT_OK, если запрос не был успешным [SWS_Dcm_01290]. При возникновении ошибки и возврате E_NOT_OK приложение должно записать в параметр ErrorCode специфический отрицательный код ответа (NRC); после этого модуль DCM отправляет отрицательный диагностический ответ с этим кодом NRC AUTOSAR_SWS_DiagnosticCommunicationManager с. 279.

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

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

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

Асинхронная функция Xxx_FreezeCurrentState вызывается модулем DCM, чтобы запросить у прикладного программного обеспечения фиксацию текущего состояния управления входом/выходом (IOControl) [SWS_Dcm_01315]. Объявление предоставляется через заголовочный файл Dcm_Externals.h [SWS_Dcm_01315].

Параметры и маски управления

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

• OpStatus: передаёт текущий статус асинхронной операции (Dcm_OpStatusType).
• controlMask или controlMask2: если маска управления сконфигурирована как внешняя (DcmDspDidControlMask == DCM_CONTROLMASK_EXTERNAL) и используется асинхронный интерфейс функции, DCM в зависимости от DcmDspDidControlMaskSize передаёт параметр controlMask (типа Dcm_ControlMask_{DID}Type) при размере до 4 байт и указатель controlMask2 (uint8*) при размере от 5 байт.
• ErrorCode: указатель на Dcm_NegativeResponseCodeType для возврата кода ошибки.

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

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

• E_OK: фиксация состояния успешно завершена.
• DCM_E_PENDING: запрос всё ещё находится в обработке и требует последующих передач данных.
• E_NOT_OK: операция завершилась неудачно. В этом случае DCM отправляет отрицательный диагностический ответ со значением NRC, установленным через ErrorCode.

Параллелизм

Интерфейс определён как нереэнтрантный (Non Reentrant) и поэтому требует синхронизированной обработки для каждого экземпляра управления [SWS_Dcm_01315].

Синхронная функция Xxx_ShortTermAdjustment запрашивает у приложения временную корректировку определенного сигнала ввода-вывода [SWS_Dcm_00802]. Она предоставляется через заголовочный файл Dcm_Externals.h и имеет Service-ID 0x50 [SWS_Dcm_00802].

Через указатель ControlStateInfo функция получает информацию о состоянии управления из параметра ControlOptionRecord диагностического запроса InputOutputControlByIdentifier [SWS_Dcm_00802]. Если сконфигурирована внешняя маска управления (DcmDspDidControlMask == DCM_CONTROLMASK_EXTERNAL), то в зависимости от DcmDspDidControlMaskSize дополнительно передается либо controlMask (до 4 байт) типа Dcm_ControlMask_{DID}Type, либо controlMask2 (от 5 байт) как uint8* [SWS_Dcm_00802].

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

• E_OK: корректировка сигнала ввода-вывода выполнена успешно [SWS_Dcm_00802].
• E_NOT_OK: корректировка не удалась [SWS_Dcm_00802]. В этом случае приложение должно через выходной параметр ErrorCode установить определенный отрицательный код ответа (Dcm_NegativeResponseCodeType), который модуль DCM отправляет обратно тестеру в отрицательном диагностическом ответе [SWS_Dcm_00802].

Функция является нереентерабельной (Non Reentrant) и вызывается синхронно [SWS_Dcm_00802]. Этот синхронный вариант используется, когда элемент данных сконфигурирован для синхронных вызовов функций (DcmDspDataUsePort == USE_DATA_SYNCH_FNC) [SWS_Dcm_00802]. Для портов, сконфигурированных как асинхронные (USE_DATA_ASYNCH_FNC или USE_DATA_ASYNCH_FNC_ERROR), напротив, существует асинхронный вариант с Service-ID 0x55 и расширенным набором параметров, включая OpStatus и DataLength [SWS_Dcm_01316].

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

Функция [SWS_Dcm_01316] вызывается Diagnostic Communication Manager (DCM) и предоставляется через Dcm_Externals.h. Она асинхронно запрашивает у приложения корректировку сигнала ввода-вывода в рамках диагностической службы InputOutputControlByIdentifier. Данные управления передаются через указатель ControlStateInfo (из параметра ControlOptionRecord), дополненный длиной в байтах DataLength. Процесс управляется через OpStatus: пока продолжается корректировка, приложение возвращает DCM_E_PENDING; после успешного завершения оно сообщает E_OK.

Варианты и параметры маски

При внешней конфигурации маски управления (DCM_CONTROLMASK_EXTERNAL) передаются дополнительные параметры [SWS_Dcm_01316]:

• Если размер маски меньше или равен 4 байтам, передается controlMask типа Dcm_ControlMask_{DID}Type.
• Если размер маски составляет не менее 5 байтов, вместо этого передается controlMask2 как указатель на uint8.

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

Если управление сигналом завершается неудачно, функция возвращает E_NOT_OK и через указатель ErrorCode устанавливает отрицательный код ответа (NRC), который DCM передает в отрицательном ответе [SWS_Dcm_01316]. Функция специфицирована как нереентерабельная.

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

Интерфейс используется, когда порт данных DID сконфигурирован на USE_DATA_ASYNCH_FNC или USE_DATA_ASYNCH_FNC_ERROR, а тип данных — на UINT8_DYN [SWS_Dcm_01316]. Он отличается от синхронного варианта [SWS_Dcm_00802], который не использует ни OpStatus, ни DataLength и предназначен для синхронных портов при статических типах данных.

Функция Xxx_IsDidAvailable служит для асинхронной проверки того, доступен ли запрошенный Diagnostic Identifier (DID) в пределах определенного диапазона DID [SWS_Dcm_00803]. Она предоставляется через заголовочный файл Dcm_Externals.h и имеет Service-ID 0x53 [SWS_Dcm_00803].

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

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

• DID (In): опрашиваемое значение идентификатора DID [SWS_Dcm_00803].
• OpStatus (In): текущий статус операции для управления асинхронным процессом [SWS_Dcm_00803].
• supported (Out): указывает, доступен ли DID в диапазоне; DCM_DID_SUPPORTED означает поддержку, тогда как DCM_DID_NOT_SUPPORTED указывает на отсутствие поддержки [SWS_Dcm_00803].

Асинхронная семантика и возвращаемые значения

Поскольку функция выполняется асинхронно, определение при определенных обстоятельствах требует нескольких шагов вызова [SWS_Dcm_00803]. Возвращаемое значение DCM_E_PENDING сигнализирует о том, что запрос еще не завершен и для его окончания необходимы дальнейшие вызовы [SWS_Dcm_00803]. Возвращаемое значение E_OK возвращается, когда проверка завершена [SWS_Dcm_00803] (интерпретация: вероятно, E_OK завершает опрос, после чего параметр supported содержит действительный результат). Вопрос Q-22c62d306a7ac4f1 (открытый)

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

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

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

Функция Xxx_ReadDidData (идентификатор службы 0x40) доступна через Dcm_Externals.h и запрашивает у приложения значения данных диагностического идентификатора (DID) [SWS_Dcm_00804]. Передача и обратная связь осуществляются через следующие параметры:

• DID: идентификатор запрошенного Data Identifier [SWS_Dcm_00804].
• Data: указатель на буфер, в который должны быть скопированы прочитанные полезные данные [SWS_Dcm_00804].
• OpStatus: статус выполнения или операции текущего запроса [SWS_Dcm_00804].
• DataLength: длина считываемых данных [SWS_Dcm_00804].
• ErrorCode: выходной параметр для приёма отрицательного кода ответа (NRC) [SWS_Dcm_00804].

Асинхронная семантика и возвращаемые значения

Функция определена как асинхронная (Asynchronous) и возвращает статус типа Std_ReturnType [SWS_Dcm_00804]:

• E_OK: считывание данных прошло успешно [SWS_Dcm_00804].
• DCM_E_PENDING: запрос ещё не завершён; для окончания требуются дальнейшие вызовы [SWS_Dcm_00804].
• E_NOT_OK: операция не увенчалась успехом [SWS_Dcm_00804].

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

Если приложение возвращает для Xxx_ReadDidData возвращаемое значение E_NOT_OK, модуль DCM отправляет диагностическому тестеру отрицательный ответ с кодом NRC, установленным через параметр ErrorCode [SWS_Dcm_00804]. Функция специфицирована как нереентерабельная (Non Reentrant) [SWS_Dcm_00804]. Интерпретация: из-за асинхронной обработки с DCM_E_PENDING вызов обычно должен осуществляться в контексте циклической задачи DCM. Вопрос Q-5e41e9fb7dc261b9 (открытый)

Функция Xxx_WriteDidData вызывается модулем DCM для запроса приложения на запись значения данных DID [SWS_Dcm_00805]. Объявление доступно через заголовочный файл Dcm_Externals.h [SWS_Dcm_00805].

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

Вызов осуществляется асинхронно и определён как нереентерабельный (Non Reentrant) [SWS_Dcm_00805]. При вызове передаются следующие параметры [SWS_Dcm_00805]:

• DID: идентификатор записываемого идентификатора данных.
• Data: указатель на буфер с записываемыми данными.
• OpStatus: статус текущей операции.
• DataLength: длина записываемых данных в байтах.
• ErrorCode: выходной параметр для отрицательного кода ответа (NRC).

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

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

• E_OK: запрос на запись успешно выполнен.
• DCM_E_PENDING: операция еще не завершена; для завершения требуются дальнейшие вызовы.
• E_NOT_OK: операция не увенчалась успехом. В этом случае модуль DCM отправляет отрицательный ответ со значением NRC, переданным в выходном параметре ErrorCode.

Функция Xxx_ReadDidRangeDataLength служит для того, чтобы запросить прикладное программное обеспечение о возврате длины данных для диапазона DID (DID Range) [SWS_Dcm_01271]. Она является частью модуля AUTOSAR Dcm, имеет идентификатор службы 0x5e и предоставляется через заголовочный файл Dcm_Externals.h [SWS_Dcm_01271].

Вызов осуществляется с асинхронной семантикой (Asynchronous) через следующие параметры интерфейса [SWS_Dcm_01271]:

• DID (IN, uint16): обозначает конкретный идентификатор данных (Data ID value) запрошенного диапазона DID [SWS_Dcm_01271].
• OpStatus (IN, Dcm_OpStatusType): указывает текущий статус обработки выполняющейся операции [SWS_Dcm_01271].
• DataLength (OUT, uint16*): указатель на длину данных, которые должны быть прочитаны или записаны [SWS_Dcm_01271].

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

• E_OK: запрос был успешен, и определённая длина готова [SWS_Dcm_01271].
• E_NOT_OK: запрос завершился неудачей [SWS_Dcm_01271].
• DCM_E_PENDING: выполнение ещё не завершено и требует дальнейших последующих вызовов для завершения [SWS_Dcm_01271].

С точки зрения параллелизма интерфейс определён как нереэнтрантный (Non Reentrant) [SWS_Dcm_01271].

Асинхронный интерфейс Xxx_GetInfotypeValueData вызывается модулем DCM, как только принимается диагностический запрос для OBD Service $09 и запрошенный InfoType не является InfoType доступности («availability InfoType») [SWS_Dcm_00423]. Для предоставления данных DCM вызывает все функции, сконфигурированные для этого InfoType, и объединяет значения в качестве ответа на Service $09 [SWS_Dcm_00423]. Объявление доступно через Dcm_Externals.h [SWS_Dcm_91014].

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

• OpStatus (in): отображает текущий статус выполнения текущей операции.
• DataValueBuffer (out): буфер для приёма специфических полезных данных InfoType.
• DataValueBufferSize (inout): содержит при вызове максимально доступный для записи размер буфера в байтах и заполняется вызванной функцией фактическим количеством записанных байтов данных.

Будучи асинхронной функцией, она возвращает E_OK при успешном завершении, E_NOT_OK при ошибках или DCM_E_PENDING, если операция ещё не завершена и требует дальнейших вызовов для завершения [SWS_Dcm_91014]. Поскольку функция специфицирована как нереэнтрантная (Non Reentrant), параллельные вызовы для одной и той же функции недопустимы [SWS_Dcm_91014].

Функция Xxx_Start объявляется через заголовочный файл Dcm_Externals.h и запрашивает прикладное программное обеспечение запустить выполнение диагностической процедуры [SWS_Dcm_01203]. Модуль DCM вызывает эту функцию, как только запрос службы UDS для RoutineControl (0x31) с подфункцией startRoutine был принят и успешно верифицирован [SWS_Dcm_00400], или когда поступает запрос RoutineControl с OBDTestId, не относящимся к проверке доступности [SWS_Dcm_01392].

Интерфейс поддерживает как фиксированные, так и переменные форматы данных и работает асинхронно [SWS_Dcm_01203]:

• Входные параметры: фиксированные входные сигналы от dataIn_1 до dataIn_n или переменные данные через массив байтов dataInVar, а также статус операции OpStatus [SWS_Dcm_01203].
• Выходные параметры: фиксированные выходные сигналы от dataOut_1 до dataOut_n или переменные выходные данные dataOutVar, а также код ошибки ErrorCode для сообщений отрицательного ответа [SWS_Dcm_01203].
• Параметр длины: входной и выходной параметр currentDataLength при переменной длине данных передает количество полезных байтов в dataInVar или dataOutVar соответственно [SWS_Dcm_01203].
• Возвращаемые значения: E_OK подтверждает успешный запуск, E_NOT_OK сообщает о сбое, DCM_E_PENDING сигнализирует о продолжающихся шагах обработки, а DCM_E_FORCE_RCRRP запрашивает досрочную отправку ответа ожидания (NRC 0x78) [SWS_Dcm_01203].

Что касается параллелизма, Xxx_Start определена как нереентерабельная (Non Reentrant) [SWS_Dcm_01203]. При асинхронных процессах с возвращаемым значением DCM_E_PENDING модуль DCM повторно вызывает функцию циклически с продолжающимся OpStatus до тех пор, пока процесс не завершится [SWS_Dcm_01203].

Если операция успешно завершается с E_OK, модуль DCM отправляет обратно положительный ответ UDS с данными, предоставленными через dataOut, в качестве routineStatusRecord [SWS_Dcm_00401]. Если выполнение завершается неудачно с E_NOT_OK, DCM передает отрицательный ответ с NRC, указанным в параметре ErrorCode [SWS_Dcm_01203]. В контексте процедур OBD возвращаемое значение, отличное от E_OK, приводит к отправке NRC 0x22 [SWS_Dcm_01394].

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

Функция Xxx_StartConfirmation согласно [SWS_Dcm_91016] достоверно указывает на передачу ответа на предшествующий запрос StartRoutine. Интерфейс объявлен в заголовочном файле Dcm_Externals.h и обладает синхронной семантикой выполнения ([SWS_Dcm_91016]). В качестве единственного входного параметра передается ConfirmationStatus типа Dcm_ConfirmationStatusType, описывающий статус подтверждения передачи рутины. Дополнительные входные и выходные параметры согласно спецификации отсутствуют ([SWS_Dcm_91016]).

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

В качестве возвращаемого значения функция возвращает значение статуса типа Std_ReturnType ([SWS_Dcm_91016]). При этом значение E_OK подтверждает успешное выполнение запроса, тогда как E_NOT_OK сигнализирует о неуспешной обработке. Конкретные коды ошибок или явные сообщения в Development Error Tracer (DET) или Diagnostic Event Manager (DEM) для этой функции в payload не определены.

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

В отношении параллелизма Xxx_StartConfirmation классифицирована как нереентерабельная (Non Reentrant) ([SWS_Dcm_91016]). Это требует от вызывающей стороны строгого избегания конкурентных или перекрывающихся выполнений. Интерпретация: функция, вероятно, вызывается модулем DCM для уведомления реализации рутины на стороне приложения о завершении процесса отправки. Вопрос Q-be2dafd63bf2a9a5 (открытый)

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

Функция [SWS_Dcm_01204] вызывается DCM для завершения выполнения текущей диагностической рутины в приложении. Вызов происходит в рамках UDS-службы RoutineControl (0x31) с подфункцией stopRoutine, как только требуемые предварительные проверки успешно завершены [SWS_Dcm_00402]. Интерфейс имеет идентификатор службы 0x5c и объявлен через заголовочный файл Dcm_Externals.h [SWS_Dcm_01204].

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

В зависимости от конфигурации рутины DCM передаёт фиксированные или переменные входные данные (от dataIn_1 до dataIn_n или dataInVar) и ссылки на буферы для выходных данных (от dataOut_1 до dataOut_n или dataOutVar) [SWS_Dcm_01204], [SWS_Dcm_00402]. При переменной длине данных currentDataLength содержит количество байтов входных или выходных данных [SWS_Dcm_01204]. В качестве возвращаемых значений Std_ReturnType установлены:

• E_OK: рутина успешно завершена; DCM передаёт положительный UDS-ответ со сгенерированными выходными данными в качестве routineStatusRecord [SWS_Dcm_01204], [SWS_Dcm_00403].
• E_NOT_OK: прерывание рутины не удалось; DCM отправляет отрицательный UDS-ответ с сохранённым в ErrorCode NRC [SWS_Dcm_01204].
• DCM_E_PENDING: операция всё ещё находится в обработке; DCM снова вызывает функцию для завершения [SWS_Dcm_01204].
• DCM_E_FORCE_RCRRP: приложение запрашивает DCM о передаче ответа ожидания (NRC 0x78) [SWS_Dcm_01204].

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

Операция специфицирована как асинхронная и нереентерабельная (Non Reentrant) [SWS_Dcm_01204]. Если при выполнении возникает ошибка, приложение должно записать подходящий Dcm_NegativeResponseCodeType в параметр ErrorCode и вернуть E_NOT_OK [SWS_Dcm_01204].

Синхронная функция Xxx_StopConfirmation служит для индикации передачи ответа на предшествующий запрос StopRoutine [SWS_Dcm_91017]. При вызове система через входной параметр ConfirmationStatus типа Dcm_ConfirmationStatusType передает конкретный статус подтверждения завершения рутины [SWS_Dcm_91017]. В качестве возвращаемого значения интерфейс возвращает значение типа Std_ReturnType: при этом E_OK указывает на то, что запрос был успешно обработан, тогда как E_NOT_OK сигнализирует о неуспешном запросе [SWS_Dcm_91017].

В отношении параллелизма и условий вызова интерфейс специфицирован как нереентерабельный (Non Reentrant) и имеет Service-ID 0x69 [SWS_Dcm_91017]. Объявление предоставляется через заголовочный файл Dcm_Externals.h [SWS_Dcm_91017]. Интерпретация: благодаря предоставлению через Dcm_Externals.h и настраиваемому префиксу Xxx_ функция, вероятно, вызывается модулем DCM и реализуется программным компонентом приложения или соответствующим обработчиком рутин. Вопрос Q-743e69ff8cf92321 (открытый)

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

Функция [SWS_Dcm_91013] вызывается модулем DCM, чтобы запросить у приложения результат выполнения рутины. Это происходит в рамках службы UDS RoutineControl (0x31) с подфункцией requestRoutineResults, как только все входные проверки были успешно пройдены [SWS_Dcm_00404]. Интерфейс доступен через Dcm_Externals.h, работает асинхронно и специфицирован как нереэнтрантный [SWS_Dcm_91013].

Через параметр OpStatus модуль DCM управляет ходом операции. Функция принимает фиксированные входные данные (от dataIn_1 до dataIn_n) или переменные данные (dataInVar), которые выводятся из routineControlOptionRecord [SWS_Dcm_00404]. Через фиксированные выходные параметры (от dataOut_1 до dataOut_n) или переменные выходные буферы (dataOutVar и variableDataLength) приложение передаёт данные результатов модулю DCM [SWS_Dcm_91013].

Если опрос успешно завершается со значением E_OK, модуль DCM объединяет выходные данные на основе параметра конфигурации DcmDspRequestRoutineResultsOut в routineStatusRecord и отправляет положительный ответ [SWS_Dcm_00405]. Если операция всё ещё продолжается, приложение может возвратить DCM_E_PENDING для последующих вызовов или DCM_E_FORCE_RCRRP для отправки предварительного ответа (NRC 0x78) [SWS_Dcm_91013].

В случае ошибки функция возвращает E_NOT_OK и устанавливает ErrorCode в соответствующее значение NRC, после чего модуль DCM передаёт соответствующий отрицательный ответ [SWS_Dcm_91013]. Поскольку функция не является реэнтрантной, её нельзя вызывать параллельно для одной и той же рутины [SWS_Dcm_91013].

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

Функция Xxx_RequestResultsConfirmation служит для подтверждения переданного диагностического ответа на запрос RequestRoutineResults [SWS_Dcm_91018]. Она объявлена в заголовочном файле Dcm_Externals.h и имеет Service-ID 0x70 [SWS_Dcm_91018]. Через входной параметр ConfirmationStatus типа Dcm_ConfirmationStatusType реализация получает информацию о том, с каким статусом была завершена передача результатов рутины [SWS_Dcm_91018]. Вызов выполняется синхронно и возвращает Std_ReturnType, причем E_OK указывает на успешную обработку, а E_NOT_OK сигнализирует о сбое [SWS_Dcm_91018].

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

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

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

Обработка ошибок ограничивается возвращаемым значением E_NOT_OK, так как отдельные ошибки разработки (DET) или производственные ошибки (DEM) для этого вызова не специфицированы [SWS_Dcm_91018]. Интерпретация: функция служит специфической для приложения точкой подтверждения (callback) для DCM, чтобы после отправки результатов рутины синхронизировать завершение диагностической задачи на уровне пользователя. Вопрос Q-d3dd0142a30e1363 (открытый)

Функция Xxx_RequestControl служит для выполнения специфичной для TID функции управления и обычно применяется для реализации службы OBD Service $08 ([SWS_Dcm_01338]). Модуль DCM вызывает сконфигурированную функцию синхронно, как только принимается запрос OBD Service $08, идентификатор теста (TID) которого не является идентификатором доступности («availability TID») ([SWS_Dcm_00419]). Объявление интерфейса предоставляется через заголовочный файл Dcm_Externals.h ([SWS_Dcm_01338]).

Параметры и управление буфером

• InBuffer: указатель на полезные данные принятого OBD-запроса. Количество байт этих входных данных должно точно соответствовать размеру, сконфигурированному в модуле DCM ([SWS_Dcm_00419], [SWS_Dcm_01338]).
• OutBuffer: указатель на выходной буфер, в котором вызванная функция управления сохраняет свои результаты. Размер буфера фиксирован и берется из конфигурации модуля DCM ([SWS_Dcm_00419], [SWS_Dcm_01338]).

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

Функция возвращает в качестве значения статуса Std_ReturnType: значение E_OK сигнализирует об успешной обработке, тогда как E_NOT_OK указывает на состояние ошибки ([SWS_Dcm_01338]). Если Xxx_RequestControl возвращает результат, отличный от E_OK, модуль DCM реагирует отрицательным кодом ответа NRC 0x22 (Conditions Not Correct) по отношению к диагностическому тестеру ([SWS_Dcm_01192]).

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

Функция специфицирована как нереэнтрантная (Non Reentrant) и имеет идентификатор службы (Service ID) 0x63 ([SWS_Dcm_01338]).

Функция обратного вызова Xxx_StartProtocol предоставляется через заголовочный файл Dcm_Externals.h и позволяет приложению при первом запросе диагностического протокола проверять текущие условия окружения и разрешать или отклонять дальнейшую обработку протокола [SWS_Dcm_01339].

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

Вызов выполняется субмодулем DSL модуля DCM синхронно и нереентерабельно для всех сконфигурированных функций [SWS_Dcm_00036], [SWS_Dcm_01339]. В функцию передаются следующие входные параметры [SWS_Dcm_01339]:

• ProtocolType: тип запускаемого диагностического протокола,
• TesterSourceAddress: исходный адрес запрашивающего тестера,
• ConnectionId: уникальный идентификатор соединения.

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

В качестве возвращаемого значения функция Std_ReturnType возвращает E_OK при успешном разрешении, E_NOT_OK при неуспешной проверке или E_PROTOCOL_NOT_ALLOWED, если протокол недопустим [SWS_Dcm_01339]. Если хотя бы одна сконфигурированная функция Xxx_StartProtocol не возвращает E_OK, DCM прерывает запуск протокола и отвечает с NRC 0x22 [SWS_Dcm_00674].

Инициализация после успешного разрешения

Только после того, как все сконфигурированные callback-функции Xxx_StartProtocol вернут E_OK, DCM выполняет дальнейшие шаги инициализации:

• загрузка стандартных параметров тайминга из конфигурации сессии по умолчанию [SWS_Dcm_00144],
• активация таблицы служб [SWS_Dcm_00145],
• сброс состояния безопасности (Security State) [SWS_Dcm_00146],
• сброс состояния сессии на стандартную диагностическую сессию, а также выполнение смены режима через SchM_Switch_<bsnp>_DcmDiagnosticSessionControl на RTE_MODE_DcmDiagnosticSessionControl_DEFAULT_SESSION [SWS_Dcm_00147].

Синхронная callback-функция Xxx_StopProtocol информирует приложение о завершении диагностического протокола ([SWS_Dcm_01340]). Она объявляется через заголовочный файл Dcm_Externals.h и специфицирована как нереентерабельная (Non Reentrant) ([SWS_Dcm_01340]).

Вызов всех сконфигурированных функций Xxx_StopProtocol (сконфигурированных через параметр DcmDslCallbackDCMRequestService) инициируется подмодулем DSL в следующих сценариях вытеснения (preemption):

• текущий диагностический запрос вытесняется более высокоприоритетным запросом другого протокола ([SWS_Dcm_00459]).
• запрос с более низким или равным приоритетом вытесняет более высокоприоритетный протокол, если тот находится в Default Session и ни один активный запрос не находится в фазе выполнения ([SWS_Dcm_00625]).

При вызове передаются тип протокола (ProtocolType), исходный адрес тестера (TesterSourceAddress), а также идентификатор соединения (ConnectionId) ([SWS_Dcm_01340]). В качестве возвращаемого значения функция возвращает E_OK при успешном выполнении или E_NOT_OK ([SWS_Dcm_01340]). Если функция возвращает значение, отличное от E_OK, DCM отвечает с кодом отрицательного ответа NRC 0x22 ([SWS_Dcm_01190]).

Синхронная, нереентерабельная функция Xxx_Indication объявляется через заголовочный файл Dcm_Externals.h [SWS_Dcm_01341]. Она указывает приложению на предстоящее выполнение диагностической службы и позволяет ему отклонить выполнение запроса службы [SWS_Dcm_01341]. Вызов выполняется синхронно субмодулем DSD на всех сконфигурированных портах ServiceRequestIndication, если присутствуют конфигурационные контейнеры DcmDsdServiceRequestManufacturerNotification [SWS_Dcm_00218] или DcmDsdServiceRequestSupplierNotification [SWS_Dcm_00516].

В качестве входных параметров передаются идентификатор службы (SID), данные запроса без SID (RequestData, DataSize), тип адресации (ReqType), идентификатор соединения (ConnectionId), тип протокола (ProtocolType) и исходный адрес тестера (TesterSourceAddress) [SWS_Dcm_01341].

Через возвращаемое значение типа Std_ReturnType приложение управляет реакцией субмодуля DSD [SWS_Dcm_01341]:

• E_OK: запрос был успешен и обрабатывается далее в штатном режиме [SWS_Dcm_01341].
• E_REQUEST_NOT_ACCEPTED: запрос не принимается. Если хотя бы одна вызванная функция индикации возвращает E_REQUEST_NOT_ACCEPTED, субмодуль DSD подавляет любой ответ тестеру [SWS_Dcm_00462], [SWS_Dcm_00517].
• E_NOT_OK: запрос завершился неудачно. В этом случае приложение записывает код отрицательного ответа в выходной параметр ErrorCode [SWS_Dcm_01341]. Если ни один вызов не возвращает E_REQUEST_NOT_ACCEPTED, субмодуль DSD отправляет отрицательный ответ с этим NRC [SWS_Dcm_00463], [SWS_Dcm_00518].

Если при нескольких сконфигурированных уведомлениях несколько функций возвращают E_NOT_OK и ни одна функция не возвращает E_REQUEST_NOT_ACCEPTED, субмодуль DSD в обязательном порядке использует для отрицательного ответа ErrorCode первой функции, ответившей E_NOT_OK [SWS_Dcm_01321], [SWS_Dcm_01322].

Функция обратного вызова Xxx_Confirmation служит для того, чтобы синхронно уведомить приложение о завершении диагностической передачи — об успешной отправке либо об ошибке передачи ([SWS_Dcm_01342]). Объявление предоставляется через заголовочный файл Dcm_Externals.h ([SWS_Dcm_01342]).

При вызове субмодулем DCM DSD (Diagnostic Service Dispatcher) передаются важные контекстные данные диагностического задания ([SWS_Dcm_01342], [SWS_Dcm_00741]):

• SID: идентификатор диагностической службы ([SWS_Dcm_01342]).
• ReqType: тип адресации (0 для физической, 1 для функциональной) ([SWS_Dcm_01342]).
• ConnectionId, ProtocolType и TesterSourceAddress: однозначные атрибуты соединения и протокола, а также исходный адрес тестера ([SWS_Dcm_01342]).
• ConfirmationStatus: информация о состоянии относительно успеха или ошибки передачи ([SWS_Dcm_01342]).

В качестве возвращаемого значения операция возвращает Std_ReturnType (E_OK при успешной обработке подтверждения, иначе E_NOT_OK) ([SWS_Dcm_01342]). DSD вызывает функцию на всех портах, использующих интерфейс ServiceRequestNotification (сконфигурированный через DcmDsdServiceRequestManufacturerNotification или DcmDsdServiceRequestSupplierNotification) ([SWS_Dcm_00741]).

Относительно порядка вызова Xxx_Confirmation штатно выполняется непосредственно вслед за DspInternal_DcmConfirmation() ([SWS_Dcm_00742]). Однако если имеет место особый случай согласно [SWS_Dcm_01172], DSD вызывает исключительно Xxx_Confirmation, в то время как внутренний вызов опускается.

Поскольку Xxx_Confirmation специфицирована как нереентерабельная (Non Reentrant) и синхронная ([SWS_Dcm_01342]), реализация на стороне приложения не должна содержать блокирующих процессов и вызывать реентерабельных обратных вызовов в DCM (интерпретация). Вопрос Q-58ce3e44dc61540b (открытый)

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

Синхронная callout-функция Xxx_ClearDTCCheckFnc предоставляется для приложения через заголовочный файл Dcm_Externals.h [SWS_Dcm_01270]. Она служит для специфической для производителя и поставщика проверки условий перед удалением запрошенной группы диагностических кодов неисправностей (Group of DTC). В качестве входного параметра ей передаётся идентификатор GoDTC типа uint32, специфицирующий удаляемую группу кодов неисправностей [SWS_Dcm_01270].

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

Разрешение запроса на удаление происходит через возвращаемое значение типа Std_ReturnType во взаимодействии с выходным параметром ErrorCode [SWS_Dcm_01270]:

• E_OK: приложение разрешает удаление запрошенной группы кодов неисправностей GoDTC [SWS_Dcm_01270].
• E_NOT_OK: приложение запрещает удаление группы. В этом ошибочном случае через выходной параметр ErrorCode типа Dcm_NegativeResponseCodeType* должен быть установлен отрицательный код ответа. Модуль DCM после этого отправляет отрицательный ответ со значением NRC, указанным в ErrorCode [SWS_Dcm_01270].

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

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

Функция callout Xxx_ProcessRequestDownload ([SWS_Dcm_00754]) вызывается модулем Dcm для инициации операции загрузки при обработке службы UDS RequestDownload. Она определена как асинхронная и нереентерабельная и предоставляется через заголовочный файл Dcm_Externals.h ([SWS_Dcm_00754]).

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

Вызов выполняется пошагово через параметр OpStatus со значениями DCM_INITIAL, DCM_PENDING или DCM_CANCEL ([SWS_Dcm_00754]). В качестве входных параметров передаются методы сжатия и шифрования (DataFormatIdentifier), блок памяти (MemoryIdentifier), начальный адрес (MemoryAddress) и несжатый размер памяти в байтах (MemorySize) ([SWS_Dcm_00754]). Перед вызовом Dcm записывает максимально возможный размер буфера во входной/выходной параметр BlockLength ([SWS_Dcm_01417]). Функция адаптирует это значение к максимально допустимой длине блока для последующих операций записи ([SWS_Dcm_00754]).

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

Функция возвращает E_OK при успешном выполнении, DCM_E_PENDING, если обработка еще продолжается, или E_NOT_OK при ошибке ([SWS_Dcm_00754]):

• Если вызов возвращает E_OK и согласованное значение BlockLength меньше или равно поддерживаемой длине буфера текущего соединения протокола, Dcm отправляет положительный ответ с этим значением в качестве maxNumberOfBlockLength ([SWS_Dcm_01419]).
• Если возвращенная длина буфера превышает поддерживаемый размер буфера соединения протокола, Dcm сообщает об ошибке DET DCM_E_INTERFACE_BUFFER_OVERFLOW ([SWS_Dcm_01418]).
• При возврате E_NOT_OK Dcm отправляет отрицательный ответ UDS (NRC) со значением, установленным в выходном параметре ErrorCode ([SWS_Dcm_00754], [SWS_Dcm_00757]).

Callout-функция Xxx_ProcessRequestTransferExit вызывается модулем DCM для завершения текущего процесса скачивания или выгрузки в рамках UDS-службы RequestTransferExit [SWS_Dcm_00755]. Объявление интерфейса предоставляется через заголовочный файл Dcm_Externals.h [SWS_Dcm_00755].

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

Функция работает асинхронно и определена как нереентерабельная (nicht reentrant) [SWS_Dcm_00755]. Вызов осуществляется с передачей текущего статуса выполнения OpStatus (возможные значения: DCM_INITIAL, DCM_PENDING или DCM_CANCEL) [SWS_Dcm_00755]. В качестве возвращаемых значений типа Std_ReturnType специфицированы:

• E_OK: передача успешно завершена [SWS_Dcm_00755].
• DCM_E_PENDING: завершение передачи ещё не окончено и требует последующих вызовов [SWS_Dcm_00755].
• E_NOT_OK: завершение завершилось сбоем или буфер ответа слишком мал [SWS_Dcm_00755].

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

Если операция Xxx_ProcessRequestTransferExit возвращает значение ошибки E_NOT_OK, через выходной параметр ErrorCode должен быть передан отрицательный код ответа. После этого модуль DCM отправляет диагностическому тестеру отрицательный UDS-ответ (NRC) именно с этим кодом ошибки [SWS_Dcm_00759]. При вызове прерывания модуль DCM передаёт функции статус DCM_CANCEL [SWS_Dcm_00755].