Sirve para desencadenar de forma dirigida anuncios de vehículo DoIP en una interfaz de red especificada.
GENERADO POR IAno revisadoModelo: gemini-3.8-flash-medium · Esfuerzo: medium · Temperatura: no controlable · Prompt: f854d0aec1c7ProcedenciaPreguntas abiertas (1)
traducido de la guía alemanagemini-3.8-flash-low · 2026-10-13 · Original en alemán
Sirve para desencadenar de forma dirigida anuncios de vehículo DoIP en una interfaz de red especificada.
La clase [SWS_DM_00820] sirve a las Adaptive Applications para solicitar explícitamente a Diagnostic Management el envío de anuncios de vehículo DoIP según ISO 13400-2 en una interfaz de red determinada. El acceso no se realiza mediante instanciación propia, sino estáticamente a través de una referencia de objeto proporcionada por el sistema ([SWS_DM_00821]). Para interfaces con control dependiente de línea de activación, la llamada explícita no está permitida, ya que en ellas el envío se realiza de forma completamente automática ([SWS_DM_00822]).
La creación y destrucción de instancias de la clase DoIPTriggerVehicleAnnouncement está sujeta a especificaciones estrictas: tanto el constructor predeterminado ([SWS_DM_02100]) como el destructor ([SWS_DM_02101]) están declarados como delete, son privados y su concreción es específica del fabricante. Por tanto, las aplicaciones no pueden instanciar ni destruir directamente objetos de esta clase.
El acceso a la interfaz se efectúa de forma estática mediante la función GetDoIPTriggerVehicleAnnouncement() ([SWS_DM_00821]). Esta devuelve un ara::core::Result<std::reference_wrapper<DoIPTriggerVehicleAnnouncement>>, por lo que el invocador obtiene una referencia al objeto de servicio suministrado por el DM. Interpretación: debido a los constructores privados y eliminados y a la devolución de una referencia a un objeto, es de suponer que el DM gestione internamente la clase como un singleton persistente. Pregunta Q-cecb961746b3ad13 (abierta)
En cuanto a la concurrencia, ni la consulta de la interfaz GetDoIPTriggerVehicleAnnouncement() ni la llamada al método TriggerVehicleAnnouncement() están especificadas como seguras para hilos («not thread-safe») ([SWS_DM_00821], [SWS_DM_00822]). Un acceso concurrente desde múltiples hilos requiere, por tanto, sincronización externa. Ambos métodos están especificados como seguros frente a excepciones («exception safe») ([SWS_DM_00821], [SWS_DM_00822]).
Ruta de uso
La secuencia típica para solicitar un anuncio de vehículo DoIP se estructura en los siguientes pasos:
Obtener instancia: la aplicación invoca estáticamente ara::diag::DoIPTriggerVehicleAnnouncement::GetDoIPTriggerVehicleAnnouncement() ([SWS_DM_00821]).
Evaluar resultado: se comprueba si el ara::core::Result resultante contiene errores; en caso de éxito, se extrae la referencia.
Solicitar anuncio: a través del método TriggerVehicleAnnouncement(networkInterfaceId) se desencadena el envío en la interfaz de red deseada ([SWS_DM_00822]).
Envío del mensaje por DM: el DM procesa la solicitud y envía mensajes de anuncio de vehículo según ISO 13400-2 en la interfaz identificada mediante networkInterfaceId ([SWS_DM_00815]).
Un escenario de error central en el uso de TriggerVehicleAnnouncement afecta a las interfaces de red dependientes de línea de activación: si la networkInterfaceId suministrada pertenece a una configuración de interfaz (DoIPNetworkConfiguration) en la que está establecida la propiedad isActivationLineDependent = TRUE, la llamada provocará un error ([SWS_DM_00822]). En tales interfaces, el DM ya desencadena automáticamente el envío de mensajes de anuncio tan pronto como la línea de activación está activa y se ha asignado una dirección IP ([SWS_DM_00816], [SWS_DM_00822]).
Para las funciones GetDoIPTriggerVehicleAnnouncement() y TriggerVehicleAnnouncement() no se han especificado códigos de error estandarizados ([SWS_DM_00821], [SWS_DM_00822]). Los posibles errores de ejecución o estados de error específicos del fabricante se transmiten en el ara::core::Result devuelto y deben ser verificados por la aplicación invocadora.
Esta guía de clases ha sido generada a partir de la especificación AUTOSAR Adaptive R25-11.
Called by application to trigger DM sending out vehicle announcements on the given network interface Id.
GENERADO POR IAno revisadoModelo: gemini-3.8-flash-medium · Esfuerzo: medium · Temperatura: no controlable · Prompt: fd0a2f72ec5aProcedenciaPreguntas abiertas (1)
traducido de la guía alemanagemini-3.8-flash-low · 2026-10-13 · Original en alemán
El método TriggerVehicleAnnouncement de la interfaz ara::diag::DoIPTriggerVehicleAnnouncement[SWS_DM_00820] sirve para hacer que Diagnostic Management (DM) envíe anuncios de vehículo DoIP según ISO 13400-2 en una interfaz de red indicada [SWS_DM_00815], [SWS_DM_00822].
Uso y semántica
La función acepta el parámetro networkInterfaceId (std::uint8_t), que identifica la interfaz de red de destino, y devuelve un ara::core::Result<void>[SWS_DM_00822]. Está declarada como noexcept y no lanza excepciones [SWS_DM_00822].
Tratamiento de errores y condiciones límite
No se han definido códigos de error estandarizados para este método [SWS_DM_00822]. Se presenta un caso de error cuando la networkInterfaceId pasada pertenece a una configuración de red con la propiedad isActivationLineDependent = TRUE[SWS_DM_00822]. En tales interfaces, la emisión ya se inicia automáticamente tras la activación de la línea de activación o la asignación de la dirección IP [SWS_DM_00816], [SWS_DM_00822]. Interpretación: Dado que no existen códigos de error estandarizados, es de esperar que el error se señalice mediante un código de error específico del fabricante en el objeto Result. Pregunta Q-ee2ea52f0b3064ce (abierta)
This function does not specify any standardized errors.
Hinweise: If the reported DoIPNetworkConfiguration.networkInterfaceId belongs to a DoIPNetwork Configuration with property isActivationLineDependent = TRUE, this is an error as on those interfaces sending of announcements happens automatically after activation line going up/IP address assignment.
Request a governed re-review of this record. The record is not changed immediately.
gemini-3.8-flash-low· 2026-10-13 · Original en alemán