UDPStream Class Reference

A UDP class which makes sure that we can use UDP as AudioSource and AudioSink. By default the WiFiUDP object is used and we login to wifi if the ssid and password is provided and we are not already connected. More...

#include <UDPStream.h>

Inheritance diagram for UDPStream:

Public Member Functions
	UDPStream ()=default
	Default Constructor.
	UDPStream (const char *ssid, const char *password)
	Convinience constructor which defines the optional ssid and password.
	UDPStream (UDP &udp)
	Constructor which defines an alternative UDP object. By default we use WiFiUDP.
int	available () override
int	availableForWrite ()
virtual bool	begin ()
bool	begin (IPAddress a, uint16_t port)
	Starts to send data to the indicated address / port.
bool	begin (uint16_t port, uint16_t port_ext=0)
	Starts to receive data from/with the indicated port.
bool	beginMulticast (IPAddress address, uint16_t port)
	Starts to receive data in multicast from/with the indicated address / port.
virtual void	end ()
virtual void	flush () override
	operator bool ()
size_t	readBytes (uint8_t *data, size_t len) override
	Reads bytes using WiFi::readBytes.
IPAddress	remoteIP ()
	We use the same remote ip as defined in begin for write.
uint16_t	remotePort ()
	We use the same remote port as defined in begin for write.
void	setPassword (const char *pwd)
void	setSSID (const char *ssid)
void	setUDP (UDP &udp)
	Defines an alternative UDP object. By default we use WiFiUDP.
size_t	write (const uint8_t *data, size_t len) override
	Replys will be sent to the initial remote caller.
virtual size_t	write (uint8_t ch) override

Protected Member Functions
void	connect ()
	connect to WIFI if necessary
void	refillReadBuffer ()

Protected Attributes
int	_timeout = 10
WiFiUDP	default_udp
UDP *	p_udp = &default_udp
const char *	password = nullptr
IPAddress	remote_address_ext
uint16_t	remote_port_ext
const char *	ssid = nullptr
RingBuffer< uint8_t >	tmp_in {0}
RingBuffer< uint8_t >	tmp_out {0}

Detailed Description

A UDP class which makes sure that we can use UDP as AudioSource and AudioSink. By default the WiFiUDP object is used and we login to wifi if the ssid and password is provided and we are not already connected.

Author

Phil Schatzmann

Copyright

GPLv3

Constructor & Destructor Documentation

UDPStream() [1/2]

UDPStream ( const char *  ssid, const char *  password  )

inline

Convinience constructor which defines the optional ssid and password.

Parameters

ssid
password

UDPStream() [2/2]

UDPStream ( UDP &  udp )

inline

Constructor which defines an alternative UDP object. By default we use WiFiUDP.

Parameters

udp

Member Function Documentation

available()

int available ( )

inlineoverridevirtual

Provides the available size of the current package and if this is used up of the next package

Reimplemented from BaseStream.

availableForWrite()

int availableForWrite ( )

inlinevirtual

Always return 1492 (MTU 1500 - 8 byte header) as UDP packet available to write

Reimplemented from BaseStream.

begin()

virtual bool begin ( )

inlinevirtualinherited

Reimplemented in AudioOutputWithCallback, HLSStream, SPDIFOutput, VS1053Stream, WM8960Stream, ESPNowStream, TimerCallbackAudioStream, QueueStream< T >, QueueStream< uint8_t >, DynamicMemoryStream, AudioFFTBase, AnalogAudioArduino, AnalogAudioStream, MemoryStream, GeneratedSoundStream< T >, GeneratedSoundStream< int16_t >, FormatConverterStream, and Pipeline.

end()

virtual void end ( )

inlinevirtualinherited

Reimplemented in FaustStream< DSP >, HLSStream, I2SCodecStream, VS1053Stream, WM8960Stream, ESPNowStream, I2SStream, TimerCallbackAudioStream, QueueStream< T >, QueueStream< uint8_t >, AudioFFTBase, AudioKitStream, AnalogAudioStream, HttpRequest, ICYStreamT< T >, GeneratedSoundStream< T >, GeneratedSoundStream< int16_t >, InputMixer< T >, InputMerge< T >, and Pipeline.

flush()

virtual void flush ( )

inlineoverridevirtualinherited

Reimplemented from Print.

Reimplemented in ResampleStream, BufferedTaskStream, and BufferedStream.

readBytes()

size_t readBytes ( uint8_t *  data, size_t  len  )

inlineoverridevirtual

Reads bytes using WiFi::readBytes.

Implements BaseStream.

setUDP()

void setUDP ( UDP &  udp )

inline

Defines an alternative UDP object. By default we use WiFiUDP.

Parameters

udp

write() [1/2]

size_t write ( const uint8_t *  data, size_t  len  )

inlineoverridevirtual

Replys will be sent to the initial remote caller.

Implements BaseStream.

write() [2/2]

virtual size_t write ( uint8_t  ch )

inlineoverridevirtualinherited

Reimplemented in BufferedTaskStream, and BufferedStream.

---

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

• src/AudioTools/Communication/UDPStream.h