Interface class to handle connection between two layers. More...

#include <connection.h>

Inheritance diagram for uds_transport::Connection:

Collaboration diagram for uds_transport::Connection:

Public Types
using	ConnectionId = std::uint8_t
	Type alias for connection id. More...

using	InitializationResult = uds_transport::UdsTransportProtocolHandler::InitializationResult
	Type alias for Initialization result. More...

Public Member Functions
	Connection (std::string_view connection_name, ConnectionId connection_id, uds_transport::ConversionHandler const &conversation_handler) noexcept
	Constructor to create a new connection. More...

virtual	~Connection ()=default
	Destruct an instance of Connection. More...

virtual InitializationResult	Initialize ()=0
	Function to initialize the connection. More...

ConnectionId	GetConnectionId () const noexcept
	Function to get the connection id. More...

std::string_view	GetConnectionName () const noexcept
	Function to get the connection name. More...

virtual void	Start ()=0
	Function to start the connection. More...

virtual void	Stop ()=0
	Function to stop the connection. More...

virtual bool	IsConnectToHost ()=0
	Function to check if connected to host remote server. More...

virtual UdsTransportProtocolMgr::ConnectionResult	ConnectToHost (UdsMessageConstPtr message)=0
	Function to establish connection to remote host server. More...

virtual UdsTransportProtocolMgr::DisconnectionResult	DisconnectFromHost ()=0
	Function to disconnect from remote host server. More...

virtual std::pair< UdsTransportProtocolMgr::IndicationResult, UdsMessagePtr >	IndicateMessage (UdsMessage::Address source_addr, UdsMessage::Address target_addr, UdsMessage::TargetAddressType type, ChannelID channel_id, std::size_t size, Priority priority, ProtocolKind protocol_kind, core_type::Span< std::uint8_t const > payload_info)=0
	Function to indicate a start of reception of message. More...

virtual UdsTransportProtocolMgr::TransmissionResult	Transmit (UdsMessageConstPtr message)=0
	Function to transmit a valid Uds message. More...

virtual void	HandleMessage (UdsMessagePtr message)=0
	Function to Hands over a valid received Uds message. More...

Protected Attributes
uds_transport::ConversionHandler const &	conversation_handler_
	Store the conversation handler. More...

Private Attributes
ConnectionId	connection_id_
	Store the connection id. More...

std::string	connection_name_
	Store the connection name. More...

Detailed Description

Interface class to handle connection between two layers.

Definition at line 45 of file connection.h.

Member Typedef Documentation

◆ ConnectionId

using uds_transport::Connection::ConnectionId = std::uint8_t

Type alias for connection id.

Definition at line 50 of file connection.h.

◆ InitializationResult

using uds_transport::Connection::InitializationResult = uds_transport::UdsTransportProtocolHandler::InitializationResult

Type alias for Initialization result.

Definition at line 55 of file connection.h.

Constructor & Destructor Documentation

◆ Connection()

uds_transport::Connection::Connection	(	std::string_view	connection_name,
		ConnectionId	connection_id,
		uds_transport::ConversionHandler const &	conversation_handler
	)

inlinenoexcept

Constructor to create a new connection.

Parameters

[in]	connection_name	The name of the connection
[in]	connection_id	The connection identification
[in]	conversation_handler	The reference to conversation handler

Definition at line 66 of file connection.h.

       : conversation_handler_{conversation_handler},
         connection_id_{connection_id},
         connection_name_{CreateConnectionName(connection_name, connection_id_)} {}

◆ ~Connection()

virtual uds_transport::Connection::~Connection ( )

virtualdefault

Destruct an instance of Connection.

Member Function Documentation

◆ ConnectToHost()

virtual UdsTransportProtocolMgr::ConnectionResult uds_transport::Connection::ConnectToHost ( UdsMessageConstPtr message )

pure virtual

Function to establish connection to remote host server.

Parameters

[in] message The connection message

Returns: Connection result

Implemented in doip_client::connection::DoipUdpConnection, and doip_client::connection::DoipTcpConnection.

◆ DisconnectFromHost()

virtual UdsTransportProtocolMgr::DisconnectionResult uds_transport::Connection::DisconnectFromHost ( )

pure virtual

Function to disconnect from remote host server.

Returns: Disconnection result

Implemented in doip_client::connection::DoipUdpConnection, and doip_client::connection::DoipTcpConnection.

◆ GetConnectionId()

ConnectionId uds_transport::Connection::GetConnectionId ( ) const

inlinenoexcept

Function to get the connection id.

Returns: The connection id

Definition at line 87 of file connection.h.

87 { return connection_id_; }

References connection_id_.

◆ GetConnectionName()

std::string_view uds_transport::Connection::GetConnectionName ( ) const

inlinenoexcept

Function to get the connection name.

Returns: The connection name

Definition at line 93 of file connection.h.

93 { return connection_name_; }

References connection_name_.

◆ HandleMessage()

virtual void uds_transport::Connection::HandleMessage ( UdsMessagePtr message )

pure virtual

Function to Hands over a valid received Uds message.

Parameters

[in] message The Uds message ptr (unique_ptr semantics) with the request. Ownership of the UdsMessage is given back to the conversation here

Implemented in doip_client::connection::DoipUdpConnection, and doip_client::connection::DoipTcpConnection.

Referenced by doip_client::channel::tcp_channel::DoipTcpChannel::HandleMessage(), and doip_client::channel::udp_channel::DoipUdpChannel::HandleMessage().

Here is the caller graph for this function:

◆ IndicateMessage()

virtual std::pair<UdsTransportProtocolMgr::IndicationResult, UdsMessagePtr> uds_transport::Connection::IndicateMessage	(	UdsMessage::Address	source_addr,
		UdsMessage::Address	target_addr,
		UdsMessage::TargetAddressType	type,
		ChannelID	channel_id,
		std::size_t	size,
		Priority	priority,
		ProtocolKind	protocol_kind,
		core_type::Span< std::uint8_t const >	payload_info
	)

pure virtual

Function to indicate a start of reception of message.

This is called to indicate the reception of new message by underlying transport protocol handler

Parameters

[in]	source_addr	The UDS source address of message
[in]	target_addr	The UDS target address of message
[in]	type	The indication whether its is phys/func request
[in]	channel_id	The transport protocol channel on which message start happened
[in]	size	The size in bytes of the UdsMessage starting from SID
[in]	priority	The priority of the given message, used for prioritization of conversations
[in]	protocol_kind	The identifier of protocol kind associated to message
[in]	payload_info	The view onto the first received payload bytes, if any. This view shall be used only within this function call. It is recommended that the TP provides at least the first two bytes of the request message, so the DM can identify a functional TesterPresent

Returns: std::pair< IndicationResult, UdsMessagePtr > The pair of IndicationResult and a pointer to UdsMessage owned/created by DM core and returned to the handler to get filled

Implemented in doip_client::connection::DoipUdpConnection, and doip_client::connection::DoipTcpConnection.

Referenced by doip_client::channel::tcp_channel::DoipTcpChannel::IndicateMessage(), and doip_client::channel::udp_channel::DoipUdpChannel::IndicateMessage().

Here is the caller graph for this function:

◆ Initialize()

virtual InitializationResult uds_transport::Connection::Initialize ( )

pure virtual

Function to initialize the connection.

Returns: The initialization result

Implemented in doip_client::connection::DoipUdpConnection, and doip_client::connection::DoipTcpConnection.

◆ IsConnectToHost()

virtual bool uds_transport::Connection::IsConnectToHost ( )

pure virtual

Function to check if connected to host remote server.

Returns: True if connection, False otherwise

Implemented in doip_client::connection::DoipUdpConnection, and doip_client::connection::DoipTcpConnection.

◆ Start()

virtual void uds_transport::Connection::Start ( )

pure virtual

Function to start the connection.

Implemented in doip_client::connection::DoipUdpConnection, and doip_client::connection::DoipTcpConnection.

◆ Stop()

virtual void uds_transport::Connection::Stop ( )

pure virtual

Function to stop the connection.

Implemented in doip_client::connection::DoipUdpConnection, and doip_client::connection::DoipTcpConnection.

◆ Transmit()

virtual UdsTransportProtocolMgr::TransmissionResult uds_transport::Connection::Transmit ( UdsMessageConstPtr message )

pure virtual

Function to transmit a valid Uds message.

Parameters

[in] message The Uds message ptr (unique_ptr semantics) with the request.

Implemented in doip_client::connection::DoipUdpConnection, and doip_client::connection::DoipTcpConnection.

Member Data Documentation

◆ connection_id_

ConnectionId uds_transport::Connection::connection_id_

private

Store the connection id.

Definition at line 180 of file connection.h.

Referenced by GetConnectionId().

◆ connection_name_

std::string uds_transport::Connection::connection_name_

private

Store the connection name.

Definition at line 185 of file connection.h.

Referenced by GetConnectionName().

◆ conversation_handler_

uds_transport::ConversionHandler const& uds_transport::Connection::conversation_handler_

protected

Store the conversation handler.

Definition at line 174 of file connection.h.

Referenced by doip_client::connection::DoipTcpConnection::HandleMessage(), doip_client::connection::DoipUdpConnection::HandleMessage(), doip_client::connection::DoipTcpConnection::IndicateMessage(), and doip_client::connection::DoipUdpConnection::IndicateMessage().

The documentation for this class was generated from the following file:

/home/runner/work/diag-client-lib/diag-client-lib/diag-client-lib/lib/uds-transport-layer-api/uds_transport/connection.h

Public Types

Public Member Functions

Protected Attributes

Private Attributes

Detailed Description

Member Typedef Documentation

◆ ConnectionId

◆ InitializationResult

Constructor & Destructor Documentation

◆ Connection()

◆ ~Connection()

Member Function Documentation

◆ ConnectToHost()

◆ DisconnectFromHost()

◆ GetConnectionId()

◆ GetConnectionName()

◆ HandleMessage()

◆ IndicateMessage()

◆ Initialize()

◆ IsConnectToHost()

◆ Start()

◆ Stop()

◆ Transmit()

Member Data Documentation

◆ connection_id_

◆ connection_name_

◆ conversation_handler_