DEENESPTFRRUARHIKOZHNL

estructura ara::diag::CommunicationControl::ComCtrlRequestParamsType

[SWS_DM_00805] Upstream: RS_Diag_04278

struct ComCtrlRequestParamsType {...};

ComCtrlRequestParamsType is a structure, which holds all parameters of an UDS 0x28 communicationControl request.

Header-Datei#include "ara/diag/communication_control.h"
Forwarding-Header#include "ara/diag/diag_fwd.h"
Scopeclass ara::diag::CommunicationControl

Guía del usuarioGENERADO POR IA

Sirve como contenedor de parámetros para la evaluación y el procesamiento de solicitudes UDS 0x28 para el control de la comunicación.
GENERADO POR IA no revisado Modelo: gemini-3.8-flash-medium · Esfuerzo: medium · Temperatura: no controlable · Prompt: edde1b3d434e Procedencia Preguntas abiertas (3)
traducido de la guía alemanagemini-3.8-flash-low · 2026-10-13 · Original en alemán

Sirve como contenedor de parámetros para la evaluación y el procesamiento de solicitudes UDS 0x28 para el control de la comunicación.

La estructura de datos agrupa todos los parámetros de entrada de una solicitud de servicio UDS 0x28 para el control de la comunicación adaptativa conforme a [SWS_DM_00805]. Al recibir un mensaje de diagnóstico de este tipo, la plataforma deserializa los tipos de control y de comunicación, así como la identificación del nodo, y transfiere la estructura rellenada al manejador de servicio correspondiente. El software de aplicación evalúa los valores contenidos para influir de forma selectiva en el comportamiento de transmisión y recepción de segmentos de red definidos (AUTOSAR_AP_SWS_Diagnostics §8.7.2 «Struct: ComCtrlRequestParamsType»). Como contenedor de datos sin estado, la estructura no posee sincronización de concurrencia propia, motivo por el cual los accesos deberían permanecer en el contexto de ejecución del manejador.

Contexto

La estructura ara::diag::CommunicationControl::ComCtrlRequestParamsType es un tipo central de transferencia de datos dentro de la interfaz funcional de diagnóstico de AUTOSAR Adaptive [SWS_DM_00805]. Está declarada en el archivo de cabecera ara/diag/communication_control.h y sirve como contenedor estandarizado de parámetros que encapsula todos los parámetros de entrada de una solicitud de diagnóstico del servicio UDS 0x28 (CommunicationControl) (AUTOSAR_AP_SWS_Diagnostics §8.7.2 «Struct: ComCtrlRequestParamsType»).

En el sistema global, la estructura actúa como intermediaria entre la gestión de diagnóstico de AUTOSAR (Diagnostic Management) y el software de aplicación adaptativo, el cual es responsable del control de la comunicación específico del vehículo. Los comandos de diagnóstico entrantes procedentes de equipos de prueba externos se deserializan en el nivel de plataforma y se transfieren a la aplicación a través de esta estructura. La estructura comprende tres variables miembro públicas (AUTOSAR_AP_SWS_Diagnostics §8.7.2.1 «Public Member Variables»):

Ciclo de vida

Como estructura C++ elemental (struct) [SWS_DM_00805], ComCtrlRequestParamsType presenta las características de un tipo de valor simple (Plain Old Data / POD). No posee ninguna máquina de estados interna, ningún puntero de función virtual ni zonas de memoria asignadas dinámicamente (AUTOSAR_AP_SWS_Diagnostics §8.7.2.1 «Public Member Variables»).

La creación de una instancia suele realizarse de forma volátil mediante el framework de Diagnostic Management: tan pronto como se recibe y valida formalmente un mensaje UDS 0x28, la pila instancia la estructura e inicializa las variables miembro con los datos útiles decodificados (interpretación: la creación de objetos compete por completo al middleware en el marco de la aceptación de la solicitud). Pregunta Q-1abe8049ce5759f2 (abierta) Las relaciones de propiedad están estrictamente limitadas al contexto de la llamada al método. La plataforma suele transferir la instancia por valor o por referencia constante al manejador de servicio de la aplicación; la aplicación receptora no asume la propiedad permanente de la instancia.

En consecuencia, no existen fases de ciclo de vida ni cambios de estado complejos. La destrucción de la instancia se produce automáticamente al salir del ámbito de visibilidad de la llamada de callback respectiva. En lo relativo a la concurrencia, ComCtrlRequestParamsType no implementa mecanismos de sincronización propios. Puesto que, tras la inicialización por parte de la plataforma, el software de aplicación normalmente evalúa los miembros solo en modo de lectura, el acceso debería ser seguro para subprocesos, siempre que la instancia se transfiera de forma local al subproceso en el contexto de procesamiento (interpretación: no se requieren bloqueos externos para la evaluación). Pregunta Q-d654753d06273bca (abierta)

Ruta de uso

La ruta de uso típica en el marco del procesamiento de diagnóstico se desarrolla en una secuencia fija de pasos, desde el mensaje de red hasta la reacción de la aplicación (AUTOSAR_AP_SWS_Diagnostics §8.7.2 «Struct: ComCtrlRequestParamsType»):

  1. Recepción del mensaje de diagnóstico: un equipo de prueba de diagnóstico externo envía una solicitud UDS 0x28 a la unidad de control. Adaptive Diagnostic Management recibe el paquete de datos en el nivel de transporte.
  2. Deserialización e instanciación: la pila de diagnóstico analiza la carga útil, crea una instancia de ComCtrlRequestParamsType [SWS_DM_00805] y asigna a los campos controlType [SWS_DM_01562], communicationType [SWS_DM_01563] y nodeIdentificationNumber [SWS_DM_01564] los valores transmitidos.
  3. Transferencia al manejador de servicio: el middleware reenvía la instancia al método de callback implementado de la interfaz CommunicationControl en la aplicación adaptativa.
  4. Evaluación de parámetros y ejecución: la aplicación adaptativa lee la estructura. A partir de nodeIdentificationNumber [SWS_DM_01564] se determina si está direccionado el propio nodo o una subred. A continuación, mediante controlType [SWS_DM_01562] y communicationType [SWS_DM_01563] se activan o desactivan los modos de transmisión y recepción correspondientes.
  5. Notificación de respuesta: tras una ejecución correcta, la aplicación confirma la operación a Diagnostic Management, el cual transmite la respuesta positiva conforme al estándar UDS al equipo de prueba de diagnóstico.
Flujo de la transferencia de parámetros en UDS 0x28DiagnosetesterDiagnosticManagementAdaptiveApplikationUDS-Anfrage 0x28(CommunicationControl)Creación y rellenadoComCtrlRequestParamsTypeAufruf Handler(ComCtrlRequestParamsType)Auswertung von controlType,communicationType, nodeIDDevolución del resultadoUDS-Antwort (0x68)

Diagrama de secuencia: flujo típico del procesamiento de la solicitud, desde el mensaje UDS 0x28 hasta la evaluación de parámetros en la aplicación. Fuentes: [SWS_DM_00805], AUTOSAR_AP_SWS_Diagnostics §8.7.2 «Struct: ComCtrlRequestParamsType»

Esta guía fue generada por un sistema de IA sobre la base de la especificación AUTOSAR AP R25-11.

Mapa de miembros

Diagrama de clases

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G nara__diag__CommunicationControl__ComCtrlRequestParamsType893 «struct» ComCtrlRequestParamsType + communicationType + controlType + nodeIdentificationNumber

Vista de detalle

Selecciona una entrada en el índice.

Constantes

CommunicationType from UDS request.

std::uint8_t communicationType;
controlType variable

ControlType from UDS request.

std::uint8_t controlType;

Node identifier to which the request is addressed to.

std::uint16_t nodeIdentificationNumber;

Documentación de las constantes / variables

variable communicationType [SWS_DM_01563] Upstream: RS_Diag_04278

std::uint8_t communicationType;

CommunicationType from UDS request.

Header-Datei#include "ara/diag/communication_control.h"
Scopestruct ara::diag::CommunicationControl::ComCtrlRequestParamsType
SymbolcommunicationType
Typstd::uint8_t

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01563
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01563@rel:R25-11#3983ac58
Content hash
3983ac58
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01563
Status: valid/unmigrated Version: rel:R25-11#17f27f8c Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01563@rel:R25-11#17f27f8c
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#3983ac582026-09-30
  • R23-11rel:R23-11#17f27f8c2026-10-14
  • R24-11rel:R24-11#17f27f8c2026-10-14
  • R25-11rel:R25-11#17f27f8c2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

variable controlType [SWS_DM_01562] Upstream: RS_Diag_04278

std::uint8_t controlType;

ControlType from UDS request.

Header-Datei#include "ara/diag/communication_control.h"
Scopestruct ara::diag::CommunicationControl::ComCtrlRequestParamsType
SymbolcontrolType
Typstd::uint8_t

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01562
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01562@rel:R25-11#d454975d
Content hash
d454975d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01562
Status: valid/unmigrated Version: rel:R25-11#ca79b2bb Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01562@rel:R25-11#ca79b2bb
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#d454975d2026-09-30
  • R23-11rel:R23-11#ca79b2bb2026-10-14
  • R24-11rel:R24-11#ca79b2bb2026-10-14
  • R25-11rel:R25-11#ca79b2bb2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

variable nodeIdentificationNumber [SWS_DM_01564] Upstream: RS_Diag_04278

std::uint16_t nodeIdentificationNumber;

Node identifier to which the request is addressed to.

Header-Datei#include "ara/diag/communication_control.h"
Scopestruct ara::diag::CommunicationControl::ComCtrlRequestParamsType
SymbolnodeIdentificationNumber
Typstd::uint16_t

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01564
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01564@rel:R25-11#afca7725
Content hash
afca7725
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01564
Status: valid/unmigrated Version: rel:R25-11#70c5e46c Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01564@rel:R25-11#70c5e46c
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#afca77252026-09-30
  • R23-11rel:R23-11#70c5e46c2026-10-14
  • R24-11rel:R24-11#70c5e46c2026-10-14
  • R25-11rel:R25-11#70c5e46c2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill