Collaboration diagram for TTY device interfaces:

Modules
	TTY files

Classes
struct	MagAOX::tty::telnetConn
	A Telnet connection manager, wrapping `libtelnet`. More...

struct	MagAOX::tty::usbDevice
	A USB device as a TTY device. More...

Functions
std::string	MagAOX::tty::ttyErrorString (int ec)
	Get a text explanation of a TTY_E_ error code. More...

int	MagAOX::tty::ttyOpenRaw (int &fileDescrip, std::string &deviceName, speed_t speed)
	Open a file as a raw-mode tty device. More...

bool	MagAOX::tty::isEndOfTrans (const std::string &strRead, const std::string &eot)
	Check if the end of the buffer contains the end-of-transmission string. More...

int	MagAOX::tty::ttyWrite (const std::string &buffWrite, int fd, int timeoutWrite)
	Write to the tty console indicated by a file descriptor. More...

int	MagAOX::tty::ttyRead (std::string &strRead, const std::string &eot, int fd, int timeoutRead)
	Read from a tty console indicated by a file-descriptor, until an end of transmission string is read. More...

int	MagAOX::tty::ttyWriteRead (std::string &strRead, const std::string &strWrite, const std::string &eot, bool swallowEcho, int fd, int timeoutWrite, int timeoutRead)
	Write to a tty on an open file descriptor, then get the result. More...

int	MagAOX::tty::ttyUSBDevName (std::string &devName, const std::string &vendor, const std::string &product, const std::string &serial)
	Get the ttyUSB device name. More...

Variables
static const telnet_telopt_t	MagAOX::tty::telopts []
	libtelnet option table. More...

Detailed Description

Using Scren

Using screen to talk to TTY devices.

The screen program needs to be installed. You will need root privileges (sudo works).

$ screen /dev/ttyUSBX 115200

where you replace the dev node with the correct path, and the baud rate with the correct value. See the particular devices specs for the correct baud rate to use. Also See https:// for a list of baud rates.

Note that screen does not echo, so if the device doesn't echo you won't see the characters you type.

Function Documentation

◆ isEndOfTrans()

bool MagAOX::tty::isEndOfTrans	(	const std::string &	strRead,
		const std::string &	eot
	)

inline

Check if the end of the buffer contains the end-of-transmission string.

Returns: true if the last N chars of buffRead are equal to eot, where N is the length of eot.; false otherwise.

Parameters

[in]	strRead	The read buffer to check
[in]	eot	The end-of-transmission string

Definition at line 153 of file ttyIOUtils.hpp.

Referenced by MagAOX::tty::telnetConn::read(), MagAOX::tty::ttyRead(), and MagAOX::tty::telnetConn::writeRead().

◆ ttyErrorString()

std::string MagAOX::tty::ttyErrorString ( int ec )

inline

Get a text explanation of a TTY_E_ error code.

Parameters

[in] ec the error code

Definition at line 50 of file ttyErrors.hpp.

◆ ttyOpenRaw()

int MagAOX::tty::ttyOpenRaw	(	int &	fileDescrip,
		std::string &	deviceName,
		speed_t	speed
	)

Open a file as a raw-mode tty device.

Returns: TTY_E_NOERROR on success.; TTY_E_TCGETATTR on a error from tcgetattr.; TTY_E_TCSETATTR on an error from tcsetattr.; TTY_E_SETISPEED on a cfsetispeed error.; TTY_E_SETOSPEED on a cfsetospeed error.

Parameters

[out]	fileDescrip	the file descriptor. Set to 0 on an error.
[in]	deviceName	the device path name, e.g. /dev/ttyUSB0
[in]	speed	indicates the baud rate (see http://pubs.opengroup.org/onlinepubs/7908799/xsh/termios.h.html)

Definition at line 101 of file ttyIOUtils.hpp.

Referenced by MagAOX::tty::usbDevice::connect().

◆ ttyRead()

int MagAOX::tty::ttyRead	(	std::string &	strRead,
		const std::string &	eot,
		int	fd,
		int	timeoutRead
	)

inline

Read from a tty console indicated by a file-descriptor, until an end of transmission string is read.

Returns: TTY_E_NOERROR on success; TTY_E_TIMEOUTONREADPOLL if the poll times out.; TTY_E_ERRORONREADPOLL if an error is returned by poll.; TTY_E_TIMEOUTONREAD if a timeout occurs during the read.; TTY_E_ERRORONREAD if an error occurs reading from the file.

Parameters

[out]	strRead	The string in which to store the output.
[in]	eot	A sequence of characters which indicates the end of transmission.
[in]	fd	The file descriptor of the open tty.
[in]	timeoutRead	The timeout in milliseconds.

Definition at line 233 of file ttyIOUtils.hpp.

Referenced by MagAOX::tty::ttyWriteRead().

◆ ttyUSBDevName()

int MagAOX::tty::ttyUSBDevName	(	std::string &	devName,
		const std::string &	vendor,
		const std::string &	product,
		const std::string &	serial
	)

inline

Get the ttyUSB device name.

Returns: TTY_E_NOERROR on success; TTY_E_NODEVNAMES if no device names found in sys; TTY_E_UDEVNEWFAILED if initializing libudev failed.; TTY_E_DEVNOTFOUND if no matching device found.

Parameters

[out]	devName	the /dev/ttyUSBX device name.
[in]	vendor	the 4-digit vendor identifier.
[in]	product	the 4-digit product identifier.
[in]	serial	the serial number. Can be "".

Definition at line 36 of file ttyUSB.hpp.

Referenced by MagAOX::tty::usbDevice::getDeviceName().

◆ ttyWrite()

int MagAOX::tty::ttyWrite	(	const std::string &	buffWrite,
		int	fd,
		int	timeoutWrite
	)

inline

Write to the tty console indicated by a file descriptor.

Returns: TTY_E_NOERROR on success; TTY_E_TIMEOUTONWRITEPOLL if the poll times out.; TTY_E_ERRORONWRITEPOLL if an error is returned by poll.; TTY_E_TIMEOUTONWRITE if a timeout occurs during the write.; TTY_E_ERRORONWRITE if an error occurs writing to the file.

Parameters

[in]	buffWrite	The characters to write to the tty.
[in]	fd	The file descriptor of the open tty.
[in]	timeoutWrite	The timeout in milliseconds.

Definition at line 182 of file ttyIOUtils.hpp.

Referenced by MagAOX::tty::ttyWriteRead().

◆ ttyWriteRead()

int MagAOX::tty::ttyWriteRead	(	std::string &	strRead,
		const std::string &	strWrite,
		const std::string &	eot,
		bool	swallowEcho,
		int	fd,
		int	timeoutWrite,
		int	timeoutRead
	)

inline

Write to a tty on an open file descriptor, then get the result.

The read is conducted until an end-of-transmission string is received. Echo characters are swallowed if desired.

Returns: TTY_E_NOERROR on success; TTY_E_TIMEOUTONWRITEPOLL if the poll times out.; TTY_E_ERRORONWRITEPOLL if an error is returned by poll.; TTY_E_TIMEOUTONWRITE if a timeout occurs during the write.; TTY_E_ERRORONWRITE if an error occurs writing to the file.; TTY_E_TIMEOUTONREADPOLL if the poll times out.; TTY_E_ERRORONREADPOLL if an error is returned by poll.; TTY_E_TIMEOUTONREAD if a timeout occurs during the read.; TTY_E_ERRORONREAD if an error occurs reading from the file.

Parameters

[out]	strRead	The string in which to store the output.
[in]	strWrite	The characters to write to the tty.
[in]	eot	A sequence of characters which indicates the end of transmission.
[in]	swallowEcho	If true, strWrite.size() characters are read after the write
[in]	fd	The file descriptor of the open tty.
[in]	timeoutWrite	The write timeout in milliseconds.
[in]	timeoutRead	The read timeout in milliseconds.

Definition at line 311 of file ttyIOUtils.hpp.

Variable Documentation

◆ telopts

const telnet_telopt_t MagAOX::tty::telopts[]

static

Initial value:

= {
            { TELNET_TELOPT_ECHO,       TELNET_WONT, TELNET_DO   },
            { TELNET_TELOPT_TTYPE,      TELNET_WILL, TELNET_DONT },
            { TELNET_TELOPT_COMPRESS2,  TELNET_WONT, TELNET_DO   },
            { TELNET_TELOPT_MSSP,       TELNET_WONT, TELNET_DO   },
            { -1, 0, 0 }                    }

libtelnet option table.

Definition at line 49 of file telnetConn.hpp.

Modules

Classes

Functions

Variables

Detailed Description

Using Scren

Function Documentation

◆ isEndOfTrans()

◆ ttyErrorString()

◆ ttyOpenRaw()

◆ ttyRead()

◆ ttyUSBDevName()

◆ ttyWrite()

◆ ttyWriteRead()

Variable Documentation

◆ telopts