Conversation class to establish connection with a Diagnostic Server. More...

#include <diagnostic_client_conversation.h>

Classes
class	DiagClientConversationImpl

Public Types
enum class	ConnectResult : std::uint8_t { kConnectSuccess = 0U , kConnectFailed , kConnectTimeout = 2U , kTlsRequired }
	Definitions of Connection results. More...

enum class	DisconnectResult : std::uint8_t { kDisconnectSuccess = 0U , kDisconnectFailed , kAlreadyDisconnected = 2U }
	Definitions of Disconnection results. More...

enum class	DiagError : std::uint8_t { kDiagGenericFailure = 1U , kDiagRequestSendFailed = 2U , kDiagAckTimeout = 3U , kDiagNegAckReceived = 4U , kDiagResponseTimeout = 5U , kDiagInvalidParameter = 6U , kDiagBusyProcessing = 7U }
	Definitions of Diagnostics Request Response results. More...

using	IpAddress = uds_message::UdsMessage::IpAddress
	Type alias of ip address type. More...

Public Member Functions
	DiagClientConversation (std::string_view conversation_name) noexcept
	Constructor an instance of DiagClientConversation. More...

	DiagClientConversation (const DiagClientConversation &other) noexcept=delete
	Deleted copy assignment and copy constructor. More...

DiagClientConversation &	operator= (const DiagClientConversation &other) noexcept=delete

	DiagClientConversation (DiagClientConversation &&other) noexcept=default
	Move assignment and move constructor. More...

DiagClientConversation &	operator= (DiagClientConversation &&other) noexcept=default

	~DiagClientConversation () noexcept
	Destructor an instance of DiagClientConversation -Conversation-Destruction. More...

void	Startup () noexcept
	Function to startup the Diagnostic Client Conversation. More...

void	Shutdown () noexcept
	Function to shutdown the Diagnostic Client Conversation. More...

ConnectResult	ConnectToDiagServer (std::uint16_t target_address, IpAddress host_ip_addr) noexcept
	Function to connect to Diagnostic Server using Target address and IP address of the server. More...

DisconnectResult	DisconnectFromDiagServer () noexcept
	Function to disconnect from Diagnostic Server. More...

Result< uds_message::UdsResponseMessagePtr, DiagError >	SendDiagnosticRequest (uds_message::UdsRequestMessageConstPtr message) noexcept
	Function to send Diagnostic Request and get Diagnostic Response. More...

Private Attributes
std::unique_ptr< DiagClientConversationImpl >	diag_client_conversation_impl_
	Unique pointer to diag client conversation implementation. More...

Detailed Description

Conversation class to establish connection with a Diagnostic Server.

This only support DoIP communication protocol for diagnostic communication with remote Diagnostic Server

Definition at line 24 of file diagnostic_client_conversation.h.

Member Typedef Documentation

◆ IpAddress

using diag::client::conversation::DiagClientConversation::IpAddress = uds_message::UdsMessage::IpAddress

Type alias of ip address type.

Definition at line 29 of file diagnostic_client_conversation.h.

Member Enumeration Documentation

◆ ConnectResult

enum diag::client::conversation::DiagClientConversation::ConnectResult : std::uint8_t

strong

Definitions of Connection results.

Enumerator
kConnectSuccess	Successfully connected to the Diagnostic Server
kConnectFailed	Connection failure to the Diagnostic Server, check logs for more failure information
kConnectTimeout	No Connection response received from the Diagnostic Server
kTlsRequired	The Diagnostic Server only accepts secured connections, open TLS connection

Definition at line 35 of file diagnostic_client_conversation.h.

                            : std::uint8_t {
     kConnectSuccess = 0U, 
     kConnectFailed =
         1U, 
     kConnectTimeout = 2U, 
     kTlsRequired =
         3U 
   };

◆ DiagError

enum diag::client::conversation::DiagClientConversation::DiagError : std::uint8_t

strong

Definitions of Diagnostics Request Response results.

Enumerator
kDiagGenericFailure	Generic Diagnostic Error, see logs for more information
kDiagRequestSendFailed	Diagnostic request message transmission failure
kDiagAckTimeout	No diagnostic acknowledgement response received within 2 seconds
kDiagNegAckReceived	Diagnostic negative acknowledgement received
kDiagResponseTimeout	No diagnostic response message received within P2/P2Star time
kDiagInvalidParameter	Passed parameter value is not valid
kDiagBusyProcessing	Conversation is already busy processing previous request

Definition at line 57 of file diagnostic_client_conversation.h.

                        : std::uint8_t {
     kDiagGenericFailure = 1U,    
     kDiagRequestSendFailed = 2U, 
     kDiagAckTimeout = 3U, 
     kDiagNegAckReceived = 4U,  
     kDiagResponseTimeout = 5U, 
     kDiagInvalidParameter = 6U, 
     kDiagBusyProcessing = 7U    
   };

◆ DisconnectResult

enum diag::client::conversation::DiagClientConversation::DisconnectResult : std::uint8_t

strong

Definitions of Disconnection results.

Enumerator
kDisconnectSuccess	Successfully disconnected from Diagnostic Server
kDisconnectFailed	Disconnection failure with Diagnostic Server, check logs for more information
kAlreadyDisconnected	Not connected to Diagnostic Server

Definition at line 47 of file diagnostic_client_conversation.h.

                               : std::uint8_t {
     kDisconnectSuccess = 0U, 
     kDisconnectFailed =
         1U, 
     kAlreadyDisconnected = 2U 
   };

Constructor & Destructor Documentation

◆ DiagClientConversation() [1/3]

diag::client::conversation::DiagClientConversation::DiagClientConversation ( std::string_view conversation_name )

explicitnoexcept

Constructor an instance of DiagClientConversation.

Parameters

[in] conversation_name The name of conversation configured as json parameter under "ConversationName" -Conversation-Construction, DiagClientLib-DoIP-Support

Definition at line 91 of file diagnostic_client_conversation.cpp.

92 : diag_client_conversation_impl_{

93 std::make_unique<DiagClientConversationImpl>(conversation_name)} {}

diag::client::conversation::DiagClientConversation::diag_client_conversation_impl_

std::unique_ptr< DiagClientConversationImpl > diag_client_conversation_impl_

Unique pointer to diag client conversation implementation.

Definition: diagnostic_client_conversation.h:148

◆ DiagClientConversation() [2/3]

diag::client::conversation::DiagClientConversation::DiagClientConversation ( const DiagClientConversation & other )

deletenoexcept

Deleted copy assignment and copy constructor.

◆ DiagClientConversation() [3/3]

diag::client::conversation::DiagClientConversation::DiagClientConversation ( DiagClientConversation && other )

defaultnoexcept

Move assignment and move constructor.

◆ ~DiagClientConversation()

diag::client::conversation::DiagClientConversation::~DiagClientConversation ( )

defaultnoexcept

Destructor an instance of DiagClientConversation -Conversation-Destruction.

Member Function Documentation

◆ ConnectToDiagServer()

DiagClientConversation::ConnectResult diag::client::conversation::DiagClientConversation::ConnectToDiagServer	(	std::uint16_t	target_address,
		DiagClientConversation::IpAddress	host_ip_addr
	)

noexcept

Function to connect to Diagnostic Server using Target address and IP address of the server.

This shall initiate a TCP connection with server and then send DoIP Routing Activation request

Parameters

[in]	target_address	Logical address of the Remote server
[in]	host_ip_addr	IP address of the Remote server

Returns: ConnectResult The connection result -Conversation-Connect

Definition at line 101 of file diagnostic_client_conversation.cpp.

                                                                                        {
   return diag_client_conversation_impl_->ConnectToDiagServer(target_address, host_ip_addr);
 }

◆ DisconnectFromDiagServer()

DiagClientConversation::DisconnectResult diag::client::conversation::DiagClientConversation::DisconnectFromDiagServer ( )

noexcept

Function to disconnect from Diagnostic Server.

This will close the existing TCP connection with Server and reset Routing Activation state

Returns: DisconnectResult Disconnection result returned -Conversation-Disconnect

Definition at line 107 of file diagnostic_client_conversation.cpp.

                                                           {
   return diag_client_conversation_impl_->DisconnectFromDiagServer();
 }

References diag_client_conversation_impl_.

◆ operator=() [1/2]

DiagClientConversation& diag::client::conversation::DiagClientConversation::operator= ( const DiagClientConversation & other )

deletenoexcept

◆ operator=() [2/2]

DiagClientConversation& diag::client::conversation::DiagClientConversation::operator= ( DiagClientConversation && other )

defaultnoexcept

◆ SendDiagnosticRequest()

Result< uds_message::UdsResponseMessagePtr, DiagClientConversation::DiagError > diag::client::conversation::DiagClientConversation::SendDiagnosticRequest ( uds_message::UdsRequestMessageConstPtr message )

noexcept

Function to send Diagnostic Request and get Diagnostic Response.

This is a blocking function i.e. function call either returns with final diagnostic response (Positive/Negative) or with error. It also handles reception of pending response(NRC 0x78) internally within this function call

Parameters

[in] message The diagnostic request message wrapped in a unique pointer

Precondition: Must be connected to diagnostic server

Returns: uds_message::UdsResponseMessagePtr Diagnostic Response message received, DiagError in case of error -Conversation-DiagRequestResponse

Definition at line 112 of file diagnostic_client_conversation.cpp.

                                                            {
   return diag_client_conversation_impl_->SendDiagnosticRequest(std::move(message));
 }

◆ Shutdown()

void diag::client::conversation::DiagClientConversation::Shutdown ( )

noexcept

Function to shutdown the Diagnostic Client Conversation.

Must be called during shutdown phase, no further processing of any function will be allowed after this call -Conversation-Shutdown

Definition at line 99 of file diagnostic_client_conversation.cpp.

99 { diag_client_conversation_impl_->Shutdown(); }

References diag_client_conversation_impl_.

◆ Startup()

void diag::client::conversation::DiagClientConversation::Startup ( )

noexcept

Function to startup the Diagnostic Client Conversation.

Must be called once and before using any other functions of DiagClientConversation -Conversation-StartUp

Definition at line 97 of file diagnostic_client_conversation.cpp.

97 { diag_client_conversation_impl_->Startup(); }

References Startup().

Referenced by Startup().

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

◆ diag_client_conversation_impl_

std::unique_ptr<DiagClientConversationImpl> diag::client::conversation::DiagClientConversation::diag_client_conversation_impl_

private

Unique pointer to diag client conversation implementation.

Definition at line 153 of file diagnostic_client_conversation.h.

Referenced by DisconnectFromDiagServer(), and Shutdown().

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

/home/runner/work/diag-client-lib/diag-client-lib/diag-client-lib/appl/include/diag-client/diagnostic_client_conversation.h
/home/runner/work/diag-client-lib/diag-client-lib/diag-client-lib/appl/src/diag-client/diagnostic_client_conversation.cpp

Classes

Public Types

Public Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

◆ IpAddress

Member Enumeration Documentation

◆ ConnectResult

◆ DiagError

◆ DisconnectResult

Constructor & Destructor Documentation

◆ DiagClientConversation() [1/3]

◆ DiagClientConversation() [2/3]

◆ DiagClientConversation() [3/3]

◆ ~DiagClientConversation()

Member Function Documentation

◆ ConnectToDiagServer()

◆ DisconnectFromDiagServer()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ SendDiagnosticRequest()

◆ Shutdown()

◆ Startup()

Member Data Documentation

◆ diag_client_conversation_impl_