Detailed Description

This class provides support for emulated serial communications on the ClearCore's USB port.

For more detailed information on the ClearCore Connector interface, check out the ClearCore Connector System informational page.

ClearCore Serial USB Connector class. More...

#include <SerialUsb.h>

Inheritance diagram for ClearCore::SerialUsb:

Collaboration diagram for ClearCore::SerialUsb:

Public Member Functions
void	Flush () override

void	FlushInput () override

void	PortOpen () override

void	PortClose () override

int16_t	CharGet () override
	Attempt to read the next character from serial channel. More...

int16_t	CharPeek () override
	Attempt to get the next character from the serial channel without pulling the character out of the buffer. More...

bool	SendChar (uint8_t charToSend) override
	Send an ascii character on the serial channel. More...

int32_t	AvailableForRead () override

int32_t	AvailableForWrite () override
	Determines the number of characters available in the transmit buffer. More...

void	WaitForTransmitIdle () override

bool	PortIsOpen () override
	Return whether or not the port is open. More...

bool	Parity (Parities newParity) override
	Set UART transmission parity format. More...

Parities	Parity () override
	Return current port UART transmission parity. More...

bool	StopBits (uint8_t bits) override
	Change the number of stop bits used in UART communication. More...

bool	CharSize (uint8_t size) override
	Change the number of bits in a character. More...

virtual ConnectorModes	Mode () override
	Get the connector's operational mode. More...

bool	Mode (ConnectorModes newMode) override
	Set the connector's operational mode. More...

Connector::ConnectorTypes	Type () override
	Get connector type. More...

bool	IsWritable () override
	Get R/W status of the connector. More...

	operator bool () override
	Returns whether the serial port is open and the other end is connected. More...

Public Member Functions inherited from ClearCore::ISerial
virtual bool	Speed (uint32_t bitsPerSecond)=0
	Change the baud rate for the port. More...

virtual uint32_t	Speed ()=0
	Gets the baud rate of the port. More...

bool	SendLine ()
	Send carriage return and newline characters. More...

bool	Send (const char *buffer, size_t bufferSize)
	Send the array of characters out the port. More...

bool	SendLine (const char *buffer, size_t bufferSize)
	Send the array of characters out the port. Terminate the line with carriage return and newline characters. More...

bool	Send (const char *nullTermStr)
	Send a string of characters out the port. More...

bool	SendLine (const char *nullTermStr)
	Send a string of characters out the port. Terminate the line with carriage return and newline characters. More...

bool	Send (char theChar)
	Send a character to be printed to the serial port. More...

bool	SendLine (char theChar)
	Send a character to be printed to the serial port. Terminate the line with carriage return and newline characters. More...

bool	Send (double number, uint8_t precision=2)
	Send a floating point number to the serial port. More...

bool	SendLine (double number, uint8_t precision=2)
	Send a floating point number to the serial port. Terminate the line with carriage return and newline characters. More...

bool	Send (int8_t number, uint8_t radix=10)
	Send an 8-bit signed number to be printed to the serial port. More...

bool	SendLine (int8_t number, uint8_t radix=10)
	Send an 8-bit signed number to be printed to the serial port. Terminate the line with carriage return and newline characters. More...

bool	Send (uint8_t number, uint8_t radix=10)
	Send an 8-bit unsigned number to be printed to the serial port. More...

bool	SendLine (uint8_t number, uint8_t radix=10)
	Send an 8-bit unsigned number to be printed to the serial port. Terminate the line with carriage return and newline characters. More...

bool	Send (int16_t number, uint8_t radix=10)
	Send a 16-bit signed number to be printed to the serial port. More...

bool	SendLine (int16_t number, uint8_t radix=10)
	Send a 16-bit signed number to be printed to the serial port. Terminate the line with carriage return and newline characters. More...

bool	Send (uint16_t number, uint8_t radix=10)
	Send a 16-bit unsigned number to be printed to the serial port. More...

bool	SendLine (uint16_t number, uint8_t radix=10)
	Send a 16-bit unsigned number to be printed to the serial port. Terminate the line with carriage return and newline characters. More...

bool	Send (int32_t number, uint8_t radix=10)
	Send a 32-bit signed number to be printed to the serial port. More...

bool	SendLine (int32_t number, uint8_t radix=10)
	Send a 32-bit signed number to be printed to the serial port. Terminate the line with carriage return and newline characters. More...

bool	Send (uint32_t number, uint8_t radix=10)
	Send a 32-bit unsigned number to be printed to the serial port. More...

bool	SendLine (uint32_t number, uint8_t radix=10)
	Send a 32-bit unsigned number to be printed to the serial port. Terminate the line with carriage return and newline characters. More...

bool	Send (int number, uint8_t radix=10)
	Send an integer to be printed to the serial port. More...

bool	SendLine (int number, uint8_t radix=10)
	Send an integer to be printed to the serial port. More...

Public Member Functions inherited from ClearCore::Connector
void	Reinitialize ()
	Reinitialize this connector to the power-up state. More...

int32_t	ConnectorIndex ()
	Accessor for the bit index of this connector in the input register. More...

virtual int16_t	State ()=0
	Get the connector's last sampled value. More...

virtual bool	State (int16_t newState)=0
	Set the state of a R/W connector. More...

virtual bool	IsInHwFault ()=0
	Get whether the connector is in a hardware fault state. More...

uint32_t	InputRegMask ()
	Get a bit mask representing this connector. More...

Additional Inherited Members
Public Types inherited from ClearCore::ISerial
enum	_Parities { PARITY_E = 0, PARITY_O, PARITY_N }

typedef enum ClearCore::ISerial::_Parities	Parities

Public Types inherited from ClearCore::Connector
enum	ConnectorModes { INVALID_NONE, INPUT_ANALOG, INPUT_DIGITAL, OUTPUT_ANALOG, OUTPUT_DIGITAL, OUTPUT_H_BRIDGE, OUTPUT_PWM, OUTPUT_TONE, OUTPUT_WAVE, CPM_MODE_A_DIRECT_B_DIRECT, CPM_MODE_STEP_AND_DIR, CPM_MODE_A_DIRECT_B_PWM, CPM_MODE_A_PWM_B_PWM, TTL, RS232, SPI, CCIO, USB_CDC }
	All possible operational modes for a connector. More...

enum	ConnectorTypes { DIGITAL_IN_TYPE, DIGITAL_IN_OUT_TYPE, SHIFT_REG_TYPE, ANALOG_IN_DIGITAL_IN_TYPE, ANALOG_OUT_DIGITAL_IN_OUT_TYPE, H_BRIDGE_TYPE, CPM_TYPE, SERIAL_TYPE, SERIAL_USB_TYPE, CCIO_DIGITAL_IN_OUT_TYPE }
	The different types of ClearCore connectors. More...

Member Function Documentation

int32_t ClearCore::SerialUsb::AvailableForRead ( )

overridevirtual

Returns number of characters waiting in the receive buffer.

Implements ClearCore::ISerial.

int32_t ClearCore::SerialUsb::AvailableForWrite ( )

overridevirtual

Determines the number of characters available in the transmit buffer.

if (ConnectorCOM0.AvailableForWrite() < 10) {
    // There are less than 10 free characters in COM-0's transmit buffer
}

Returns: Returns number of free characters in transmit buffer

Currently hard-coded to one packet size. While more data can be sent, this is the maximum amount of data that will be buffered. Writing anything larger will require the data pointer to remain valid during the writing.

Implements ClearCore::ISerial.

int16_t ClearCore::SerialUsb::CharGet ( )

overridevirtual

Attempt to read the next character from serial channel.

Returns: Returns the first character in the serial buffer, or SerialBase::EOB if no data are available. If a character is found, it will be consumed and removed from the serial buffer.

Implements ClearCore::ISerial.

int16_t ClearCore::SerialUsb::CharPeek ( )

overridevirtual

Attempt to get the next character from the serial channel without pulling the character out of the buffer.

Returns: Returns the first character in the serial buffer, or SerialBase::EOB if no data are available. If a character is found, it will not be consumed, and will remain in the serial buffer for reading.

Implements ClearCore::ISerial.

bool ClearCore::SerialUsb::CharSize ( uint8_t size )

inlineoverridevirtual

Change the number of bits in a character.

For USB Serial ports, only 8-bit characters are supported.

Implements ClearCore::ISerial.

void ClearCore::SerialUsb::Flush ( )

overridevirtual

Flush the serial port's transmit buffer

// Flush COM-0's transmit buffer

ConnectorCOM0.Flush();

Blocks until data in the write buffer is sent.

Implements ClearCore::ISerial.

void ClearCore::SerialUsb::FlushInput ( )

overridevirtual

Flush the serial port's receive buffer

// Flush COM-0's receive buffer

ConnectorCOM0.FlushInput();

Implements ClearCore::ISerial.

bool ClearCore::SerialUsb::IsWritable ( )

inlineoverridevirtual

Get R/W status of the connector.

Returns: True if the port is open.

Implements ClearCore::Connector.

virtual ConnectorModes ClearCore::SerialUsb::Mode ( )

inlineoverridevirtual

Get the connector's operational mode.

Note: The only valid mode for this connector is USB_CDC.

Returns: The connector's current operational mode.

Reimplemented from ClearCore::Connector.

Examples:: EthernetExamples/EthernetTcpClientHelloWorld/EthernetTcpClientHelloWorld.cpp, EthernetExamples/EthernetTcpServerHelloWorld_automatic/EthernetTcpServerHelloWorld_automatic.cpp, EthernetExamples/EthernetTcpServerHelloWorld_manual/EthernetTcpServerHelloWorld_manual.cpp, and EthernetExamples/EthernetUdpHelloWorld/EthernetUdpHelloWorld.cpp.

bool ClearCore::SerialUsb::Mode ( ConnectorModes newMode )

inlineoverridevirtual

Set the connector's operational mode.

Parameters

[in] newMode The new mode to be set. The only valid mode is USB_CDC.

Returns: Returns false if the mode is invalid or setup fails.

Implements ClearCore::Connector.

ClearCore::SerialUsb::operator bool ( )

overridevirtual

Returns whether the serial port is open and the other end is connected.

ClearCore uses the virtual serial port DTR flag to recognize that the USB host is connected and listening. If DTR is not asserted, no characters will be sent by the SerialUsb Send functions.

ConnectorUsb.PortOpen();
while (!ConnectorUsb) {
    continue;
}
ConnectorUsb.Send("USB Serial is now connected and host is listening.");

Returns: Returns true if the port is open and DTR is asserted.

Implements ClearCore::ISerial.

bool ClearCore::SerialUsb::Parity ( Parities newParity )

inlineoverridevirtual

Set UART transmission parity format.

Returns: Returns true if port accepted the format change request.

Implements ClearCore::ISerial.

Parities ClearCore::SerialUsb::Parity ( )

inlineoverridevirtual

Return current port UART transmission parity.

Returns: Returns transmission parity enumeration.

Implements ClearCore::ISerial.

void ClearCore::SerialUsb::PortClose ( )

overridevirtual

Shut down the port

// Close COM-0's serial port

ConnectorCOM0.PortClose();

Implements ClearCore::ISerial.

bool ClearCore::SerialUsb::PortIsOpen ( )

overridevirtual

Return whether or not the port is open.

if (ConnectorCOM0.PortIsOpen()) {
    // COM-0's port is currently open
}

Returns: True if the port is open, and false otherwise.

Implements ClearCore::ISerial.

void ClearCore::SerialUsb::PortOpen ( )

overridevirtual

Set up the port to allow operations

// Open COM-0's serial port

ConnectorCOM0.PortOpen();

Implements ClearCore::ISerial.

Examples:: EncoderInputExamples/FollowEncoder/FollowEncoder.cpp, EthernetExamples/EthernetTcpClientHelloWorld/EthernetTcpClientHelloWorld.cpp, EthernetExamples/EthernetTcpServerHelloWorld_automatic/EthernetTcpServerHelloWorld_automatic.cpp, EthernetExamples/EthernetTcpServerHelloWorld_manual/EthernetTcpServerHelloWorld_manual.cpp, and EthernetExamples/EthernetUdpHelloWorld/EthernetUdpHelloWorld.cpp.

bool ClearCore::SerialUsb::SendChar ( uint8_t charToSend )

overridevirtual

Send an ascii character on the serial channel.

Parameters

[in] charToSend The character to be sent

Returns: success

Note: No characters will be sent if DTR is not asserted.

Implements ClearCore::ISerial.

bool ClearCore::SerialUsb::StopBits ( uint8_t bits )

inlineoverridevirtual

Change the number of stop bits used in UART communication.

For USB Serial ports, only 1 stop bit is supported.

Implements ClearCore::ISerial.

Connector::ConnectorTypes ClearCore::SerialUsb::Type ( )

inlineoverridevirtual

Get connector type.

Returns: The type of the current connector.

Implements ClearCore::Connector.

void ClearCore::SerialUsb::WaitForTransmitIdle ( )

overridevirtual

Wait for transmission idle.

Implements ClearCore::ISerial.

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

SerialUsb.h

Detailed Description

Public Member Functions

Additional Inherited Members

Member Function Documentation