This class is a wrapper around the dashboard server. More...

#include <dashboard_client.h>

Inheritance diagram for urcl::DashboardClient:

Public Member Functions
bool	commandAddToLog (const std::string &log_text)
	Send text to log. More...

bool	commandBrakeRelease ()
	Send Brake release command. More...

bool	commandClearOperationalMode ()
	Send Clear operational mode command. More...

bool	commandClosePopup ()
	Send Close popup command. More...

bool	commandCloseSafetyPopup ()
	Send Close safety popup command. More...

bool	commandGenerateFlightReport (const std::string &report_type)
	Send Generate flight report command. More...

bool	commandGenerateSupportFile (const std::string &dir_path)
	Send Generate support file command. More...

bool	commandGetLoadedProgram (std::string &loaded_program)
	Get Loaded Program. More...

bool	commandGetOperationalMode (std::string &operational_mode)
	Get Operational mode. More...

bool	commandGetRobotModel (std::string &robot_model)
	Get Robot model. More...

bool	commandGetSerialNumber (std::string &serial_number)
	Get Serial number. More...

bool	commandGetUserRole (std::string &user_role)
	Send Get user role command (Only available for CB3) More...

bool	commandIsInRemoteControl ()
	Send "Is in remote control" query command. More...

bool	commandIsProgramSaved ()
	Send "Is program saved" request command. More...

bool	commandLoadInstallation (const std::string &installation_file_name)
	Send Load installation command. More...

bool	commandLoadProgram (const std::string &program_file_name)
	Send Load program command. More...

bool	commandPause ()
	Send Pause program command. More...

bool	commandPlay ()
	Send Play program command. More...

bool	commandPolyscopeVersion (std::string &polyscope_version)
	Get Polyscope version. More...

bool	commandPopup (const std::string &popup_text)
	Send popup command. More...

bool	commandPowerOff ()
	Send Power off command. More...

bool	commandPowerOn (const std::chrono::duration< double > timeout=std::chrono::seconds(300))
	Send Power on command. More...

bool	commandProgramState (std::string &program_state)
	Get Program state. More...

bool	commandQuit ()
	Send Quit command. More...

bool	commandRestartSafety ()
	Send Restart Safety command. More...

bool	commandRobotMode (std::string &robot_mode)
	Get Robot mode. More...

bool	commandRunning ()
	Send Running command. More...

bool	commandSafetyMode (std::string &safety_mode)
	Get Safety mode. More...

bool	commandSafetyStatus (std::string &safety_status)
	Get Safety status. More...

bool	commandSaveLog ()
	Flush the polyscope log to the log_history.txt file. More...

bool	commandSetOperationalMode (const std::string &operational_mode)
	Send Set operational mode command (Only available for e-series) More...

bool	commandSetUserRole (const std::string &user_role)
	Send Set user role command (Only available for CB3) More...

bool	commandShutdown ()
	Send Shutdown command. More...

bool	commandStop ()
	Send Stop program command. More...

bool	commandUnlockProtectiveStop ()
	Send Unlock Protective stop popup command. More...

bool	connect ()
	Opens a connection to the dashboard server on the host as specified in the constructor. More...

	DashboardClient (const std::string &host)
	Constructor that shall be used by default. More...

	DashboardClient ()=delete

void	disconnect ()
	Makes sure no connection to the dashboard server is held inside the object. More...

bool	retryCommand (const std::string &requestCommand, const std::string &requestExpectedResponse, const std::string &waitRequest, const std::string &waitExpectedResponse, const std::chrono::duration< double > timeout, const std::chrono::duration< double > retry_period=std::chrono::seconds(1))
	Keep Sending the requesting Command and wait until it returns the expected answer. More...

std::string	sendAndReceive (const std::string &command)
	Sends a command through the socket and waits for an answer. More...

bool	sendRequest (const std::string &command, const std::string &expected)
	Sends command and compare it with the expected answer. More...

std::string	sendRequestString (const std::string &command, const std::string &expected)
	Sends command and compare it with the expected answer. More...

bool	waitForReply (const std::string &command, const std::string &expected, std::chrono::duration< double > timeout=std::chrono::seconds(30))
	brief Sends a command and wait until it returns the expected answer More...

virtual	~DashboardClient ()=default

Public Member Functions inherited from urcl::comm::TCPSocket
void	close ()
	Closes the connection to the socket. More...

std::string	getIP () const
	Determines the local IP address of the currently configured socket. More...

int	getSocketFD ()
	Getter for the file descriptor of the socket. More...

SocketState	getState ()
	Getter for the state of the socket. More...

bool	read (char *character)
	Reads one byte from the socket. More...

bool	read (uint8_t *buf, const size_t buf_len, size_t &read)
	Reads data from the socket. More...

void	setReceiveTimeout (const timeval &timeout)
	Setup Receive timeout used for this socket. More...

void	setReconnectionTime (std::chrono::seconds reconnection_time)
	Set reconnection time, if the server is unavailable during connection this will set the time before trying connect to the server again. More...

	TCPSocket ()
	Creates a TCPSocket object. More...

bool	write (const uint8_t *buf, const size_t buf_len, size_t &written)
	Writes to the socket. More...

virtual	~TCPSocket ()

Public Attributes
const int	DASHBOARD_SERVER_PORT = 29999

Protected Member Functions
virtual bool	open (int socket_fd, struct sockaddr *address, size_t address_len)

Protected Member Functions inherited from urcl::comm::TCPSocket
virtual void	setOptions (int socket_fd)

bool	setup (std::string &host, int port)

Private Member Functions
void	assertVersion (const std::string &e_series_min_ver, const std::string &cb3_min_ver, const std::string &required_call)
	Makes sure that the dashboard_server's version is above the required version. More...

std::string	read ()

void	rtrim (std::string &str, const std::string &chars="\\\")

bool	send (const std::string &text)

Private Attributes
std::string	host_

VersionInformation	polyscope_version_

int	port_

std::mutex	write_mutex_

Additional Inherited Members
Protected Attributes inherited from urcl::comm::TCPSocket
std::unique_ptr< timeval >	recv_timeout_

Detailed Description

This class is a wrapper around the dashboard server.

For every Dashboard command there exists a wrapper function that will send the request and wait for the server's response.

For documentation about the dashboard server, please see

Definition at line 46 of file dashboard_client.h.

Constructor & Destructor Documentation

◆ DashboardClient() [1/2]

urcl::DashboardClient::DashboardClient ( const std::string & host )

Constructor that shall be used by default.

Parameters

host	IP address of the robot

Definition at line 41 of file dashboard_client.cpp.

◆ DashboardClient() [2/2]

urcl::DashboardClient::DashboardClient ( )

delete

◆ ~DashboardClient()

virtual urcl::DashboardClient::~DashboardClient ( )

virtualdefault

Member Function Documentation

◆ assertVersion()

void urcl::DashboardClient::assertVersion	(	const std::string &	e_series_min_ver,
		const std::string &	cb3_min_ver,
		const std::string &	required_call
	)

private

Makes sure that the dashboard_server's version is above the required version.

Parameters

e_series_min_ver	SW version for e-Series
cb3_min_ver	SW version for cb3
required_call	The dashboard call that should be checked

Exceptions

UrException if the robot's version isn't large enough

Definition at line 475 of file dashboard_client.cpp.

◆ commandAddToLog()

bool urcl::DashboardClient::commandAddToLog ( const std::string & log_text )

Send text to log.

Parameters

log_text The text to be sent to the log

Returns: True succeeded

Definition at line 336 of file dashboard_client.cpp.

◆ commandBrakeRelease()

bool urcl::DashboardClient::commandBrakeRelease ( )

Send Brake release command.

Returns: True succeeded

Definition at line 236 of file dashboard_client.cpp.

◆ commandClearOperationalMode()

bool urcl::DashboardClient::commandClearOperationalMode ( )

Send Clear operational mode command.

Exceptions

an	UrException when called on CB3 robots

Returns: True succeeded

Definition at line 423 of file dashboard_client.cpp.

◆ commandClosePopup()

bool urcl::DashboardClient::commandClosePopup ( )

Send Close popup command.

Returns: True succeeded

Definition at line 274 of file dashboard_client.cpp.

◆ commandCloseSafetyPopup()

bool urcl::DashboardClient::commandCloseSafetyPopup ( )

Send Close safety popup command.

Returns: True succeeded

Definition at line 280 of file dashboard_client.cpp.

◆ commandGenerateFlightReport()

bool urcl::DashboardClient::commandGenerateFlightReport ( const std::string & report_type )

Send Generate flight report command.

Parameters

report_type The report type to set for the flight report

Returns: True succeeded

Definition at line 443 of file dashboard_client.cpp.

◆ commandGenerateSupportFile()

bool urcl::DashboardClient::commandGenerateSupportFile ( const std::string & dir_path )

Send Generate support file command.

Parameters

dir_path The path to the directory of an already existing directory location inside the programs directory, where the support file is saved

Returns: True succeeded

Definition at line 456 of file dashboard_client.cpp.

◆ commandGetLoadedProgram()

bool urcl::DashboardClient::commandGetLoadedProgram ( std::string & loaded_program )

Get Loaded Program.

Parameters

loaded_program The path to the loaded program

Returns: True succeeded

Definition at line 376 of file dashboard_client.cpp.

◆ commandGetOperationalMode()

bool urcl::DashboardClient::commandGetOperationalMode ( std::string & operational_mode )

Get Operational mode.

Parameters

operational_mode The operational mode of the robot returned (Only available for e-series)

Exceptions

an	UrException when called on CB3 robots

Returns: True succeeded

Definition at line 408 of file dashboard_client.cpp.

◆ commandGetRobotModel()

bool urcl::DashboardClient::commandGetRobotModel ( std::string & robot_model )

Get Robot model.

Parameters

robot_model The string for the robot model returned

Returns: True succeeded

Definition at line 352 of file dashboard_client.cpp.

◆ commandGetSerialNumber()

bool urcl::DashboardClient::commandGetSerialNumber ( std::string & serial_number )

Get Serial number.

Parameters

serial_number The serial number of the robot returned

Returns: True succeeded

Definition at line 360 of file dashboard_client.cpp.

◆ commandGetUserRole()

bool urcl::DashboardClient::commandGetUserRole ( std::string & user_role )

Send Get user role command (Only available for CB3)

Parameters

user_role The user role on the robot

Exceptions

an	UrException when called on e-series robots

Returns: True succeeded

Definition at line 435 of file dashboard_client.cpp.

◆ commandIsInRemoteControl()

bool urcl::DashboardClient::commandIsInRemoteControl ( )

Send "Is in remote control" query command.

Exceptions

an	UrException when called on CB3 robots

Returns: True if the robot is currently in remote control

Definition at line 322 of file dashboard_client.cpp.

◆ commandIsProgramSaved()

bool urcl::DashboardClient::commandIsProgramSaved ( )

Send "Is program saved" request command.

Returns: True if the program is saved correctly

Definition at line 316 of file dashboard_client.cpp.

◆ commandLoadInstallation()

bool urcl::DashboardClient::commandLoadInstallation ( const std::string & installation_file_name )

Send Load installation command.

Parameters

installation_file_name The installation file name with the installation extension

Returns: True succeeded

Definition at line 249 of file dashboard_client.cpp.

◆ commandLoadProgram()

bool urcl::DashboardClient::commandLoadProgram ( const std::string & program_file_name )

Send Load program command.

Parameters

program_file_name The urp program file name with the urp extension

Returns: True succeeded

Definition at line 242 of file dashboard_client.cpp.

◆ commandPause()

bool urcl::DashboardClient::commandPause ( )

Send Pause program command.

Returns: True succeeded

Definition at line 262 of file dashboard_client.cpp.

◆ commandPlay()

bool urcl::DashboardClient::commandPlay ( )

Send Play program command.

Returns: True succeeded

Definition at line 256 of file dashboard_client.cpp.

◆ commandPolyscopeVersion()

bool urcl::DashboardClient::commandPolyscopeVersion ( std::string & polyscope_version )

Get Polyscope version.

Parameters

polyscope_version The string for the polyscope version number returned

Returns: True succeeded

Definition at line 342 of file dashboard_client.cpp.

◆ commandPopup()

bool urcl::DashboardClient::commandPopup ( const std::string & popup_text )

Send popup command.

Parameters

popup_text The text to be shown in the popup

Returns: True succeeded

Definition at line 330 of file dashboard_client.cpp.

◆ commandPowerOff()

bool urcl::DashboardClient::commandPowerOff ( )

Send Power off command.

Returns: True succeeded

Definition at line 224 of file dashboard_client.cpp.

◆ commandPowerOn()

bool urcl::DashboardClient::commandPowerOn ( const std::chrono::duration< double > timeout = std::chrono::seconds(300) )

Send Power on command.

Parameters

timeout Timeout in seconds - The robot might take some time to boot before this call can be made successfully.

Returns: True succeeded

Definition at line 230 of file dashboard_client.cpp.

◆ commandProgramState()

bool urcl::DashboardClient::commandProgramState ( std::string & program_state )

Get Program state.

Parameters

program_state The program state of the robot returned

Returns: True succeeded

Definition at line 400 of file dashboard_client.cpp.

◆ commandQuit()

bool urcl::DashboardClient::commandQuit ( )

Send Quit command.

Returns: True succeeded

Definition at line 304 of file dashboard_client.cpp.

◆ commandRestartSafety()

bool urcl::DashboardClient::commandRestartSafety ( )

Send Restart Safety command.

Returns: True succeeded

Definition at line 286 of file dashboard_client.cpp.

◆ commandRobotMode()

bool urcl::DashboardClient::commandRobotMode ( std::string & robot_mode )

Get Robot mode.

Parameters

robot_mode The mode of the robot returned

Returns: True succeeded

Definition at line 368 of file dashboard_client.cpp.

◆ commandRunning()

bool urcl::DashboardClient::commandRunning ( )

Send Running command.

Returns: True succeeded

Definition at line 310 of file dashboard_client.cpp.

◆ commandSafetyMode()

bool urcl::DashboardClient::commandSafetyMode ( std::string & safety_mode )

Get Safety mode.

Parameters

safety_mode The safety mode of the robot returned

Returns: True succeeded

Definition at line 384 of file dashboard_client.cpp.

◆ commandSafetyStatus()

bool urcl::DashboardClient::commandSafetyStatus ( std::string & safety_status )

Get Safety status.

Parameters

safety_status The safety status of the robot returned

Returns: True succeeded

Definition at line 392 of file dashboard_client.cpp.

◆ commandSaveLog()

bool urcl::DashboardClient::commandSaveLog ( )

Flush the polyscope log to the log_history.txt file.

Returns: True succeeded

Definition at line 469 of file dashboard_client.cpp.

◆ commandSetOperationalMode()

bool urcl::DashboardClient::commandSetOperationalMode ( const std::string & operational_mode )

Send Set operational mode command (Only available for e-series)

Parameters

operational_mode The operational mode to set on the robot

Exceptions

an	UrException when called on CB3 robots

Returns: True succeeded

Definition at line 416 of file dashboard_client.cpp.

◆ commandSetUserRole()

bool urcl::DashboardClient::commandSetUserRole ( const std::string & user_role )

Send Set user role command (Only available for CB3)

Parameters

user_role The user role to set on the robot

Exceptions

an	UrException when called on e-series robots

Returns: True succeeded

Definition at line 429 of file dashboard_client.cpp.

◆ commandShutdown()

bool urcl::DashboardClient::commandShutdown ( )

Send Shutdown command.

Returns: True succeeded

Definition at line 298 of file dashboard_client.cpp.

◆ commandStop()

bool urcl::DashboardClient::commandStop ( )

Send Stop program command.

Returns: True succeeded

Definition at line 268 of file dashboard_client.cpp.

◆ commandUnlockProtectiveStop()

bool urcl::DashboardClient::commandUnlockProtectiveStop ( )

Send Unlock Protective stop popup command.

Returns: True succeeded

Definition at line 292 of file dashboard_client.cpp.

◆ connect()

bool urcl::DashboardClient::connect ( )

Opens a connection to the dashboard server on the host as specified in the constructor.

Returns: True on successful connection, false otherwise.

Definition at line 50 of file dashboard_client.cpp.

◆ disconnect()

void urcl::DashboardClient::disconnect ( )

Makes sure no connection to the dashboard server is held inside the object.

Definition at line 93 of file dashboard_client.cpp.

◆ open()

virtual bool urcl::DashboardClient::open	(	int	socket_fd,
		struct sockaddr *	address,
		size_t	address_len
	)

inlineprotectedvirtual

Reimplemented from urcl::comm::TCPSocket.

Definition at line 433 of file dashboard_client.h.

◆ read()

std::string urcl::DashboardClient::read ( )

private

Definition at line 107 of file dashboard_client.cpp.

◆ retryCommand()

bool urcl::DashboardClient::retryCommand	(	const std::string &	requestCommand,
		const std::string &	requestExpectedResponse,
		const std::string &	waitRequest,
		const std::string &	waitExpectedResponse,
		const std::chrono::duration< double >	timeout,
		const std::chrono::duration< double >	retry_period = `std::chrono::seconds(1)`
	)

Keep Sending the requesting Command and wait until it returns the expected answer.

Parameters

requestCommand	Request command that will be sent to the server
requestExpectedResponse	The expected reply to the request
waitRequest	The status request
waitExpectedResponse	The expected reply on the status
timeout	Timeout before the command is ultimately considered failed
retry_period	Retries will be done with this period

Returns: True when both the requested command was receive with the expected reply as well as the resulting status also is as expected within the timeout time

Definition at line 205 of file dashboard_client.cpp.

◆ rtrim()

void urcl::DashboardClient::rtrim	(	std::string &	str,
		const std::string &	chars = `"\t\n\v\f\r "`
	)

private

Definition at line 45 of file dashboard_client.cpp.

◆ send()

bool urcl::DashboardClient::send ( const std::string & text )

private

Definition at line 99 of file dashboard_client.cpp.

◆ sendAndReceive()

std::string urcl::DashboardClient::sendAndReceive ( const std::string & command )

Sends a command through the socket and waits for an answer.

Parameters

command Command that will be sent to the server.

Exceptions

UrException if no response was read from the dashboard server

Returns: Answer as received by the server cut off any trailing newlines.

Definition at line 130 of file dashboard_client.cpp.

◆ sendRequest()

bool urcl::DashboardClient::sendRequest	(	const std::string &	command,
		const std::string &	expected
	)

Sends command and compare it with the expected answer.

Parameters

command	Command that will be sent to the server.
expected	Expected response

Returns: True if the reply to the command is as expected

Definition at line 152 of file dashboard_client.cpp.

◆ sendRequestString()

std::string urcl::DashboardClient::sendRequestString	(	const std::string &	command,
		const std::string &	expected
	)

Sends command and compare it with the expected answer.

Parameters

command	Command that will be sent to the server.
expected	Expected response

Exceptions

UrException if the received answer does not match the expected one.

Returns: Answer string as received by the server

Definition at line 164 of file dashboard_client.cpp.

◆ waitForReply()

bool urcl::DashboardClient::waitForReply	(	const std::string &	command,
		const std::string &	expected,
		std::chrono::duration< double >	timeout = `std::chrono::seconds(30)`
	)

brief Sends a command and wait until it returns the expected answer

Parameters

command	Command that will be sent to the server
expected	Expected replay
timeout	Timeout to wait before the command is considered failed.

Returns: True if the reply was as expected within the timeout time

Definition at line 176 of file dashboard_client.cpp.

Member Data Documentation

◆ DASHBOARD_SERVER_PORT

const int urcl::DashboardClient::DASHBOARD_SERVER_PORT = 29999

Definition at line 58 of file dashboard_client.h.

◆ host_

std::string urcl::DashboardClient::host_

private

Definition at line 455 of file dashboard_client.h.

◆ polyscope_version_

VersionInformation urcl::DashboardClient::polyscope_version_

private

Definition at line 454 of file dashboard_client.h.

◆ port_

int urcl::DashboardClient::port_

private

Definition at line 456 of file dashboard_client.h.

◆ write_mutex_

std::mutex urcl::DashboardClient::write_mutex_

private

Definition at line 457 of file dashboard_client.h.

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

Public Member Functions

Public Attributes

Protected Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ DashboardClient() [1/2]

◆ DashboardClient() [2/2]

◆ ~DashboardClient()

Member Function Documentation

◆ assertVersion()

◆ commandAddToLog()

◆ commandBrakeRelease()

◆ commandClearOperationalMode()

◆ commandClosePopup()

◆ commandCloseSafetyPopup()

◆ commandGenerateFlightReport()

◆ commandGenerateSupportFile()

◆ commandGetLoadedProgram()

◆ commandGetOperationalMode()

◆ commandGetRobotModel()

◆ commandGetSerialNumber()

◆ commandGetUserRole()

◆ commandIsInRemoteControl()

◆ commandIsProgramSaved()

◆ commandLoadInstallation()

◆ commandLoadProgram()

◆ commandPause()

◆ commandPlay()

◆ commandPolyscopeVersion()

◆ commandPopup()

◆ commandPowerOff()

◆ commandPowerOn()

◆ commandProgramState()

◆ commandQuit()

◆ commandRestartSafety()

◆ commandRobotMode()

◆ commandRunning()

◆ commandSafetyMode()

◆ commandSafetyStatus()

◆ commandSaveLog()

◆ commandSetOperationalMode()

◆ commandSetUserRole()

◆ commandShutdown()

◆ commandStop()

◆ commandUnlockProtectiveStop()

◆ connect()

◆ disconnect()

◆ open()

◆ read()

◆ retryCommand()

◆ rtrim()

◆ send()

◆ sendAndReceive()

◆ sendRequest()

◆ sendRequestString()

◆ waitForReply()

Member Data Documentation

◆ DASHBOARD_SERVER_PORT

◆ host_

◆ polyscope_version_

◆ port_

◆ write_mutex_