NtpClient Class Reference

NTP client class. More...

#include <NtpClient.h>

Inheritance diagram for NtpClient:

Public Member Functions
	NtpClient ()
	Instantiates NTP client object. More...
	NtpClient (NtpTimeResultDelegate onTimeReceivedCb)
	Instantiates NTP client object. More...
	NtpClient (const String &reqServer, unsigned reqIntervalSeconds, NtpTimeResultDelegate onTimeReceivedCb=nullptr)
	Instantiates NTP client object. More...
void	requestTime ()
	Request time from NTP server. More...
void	setNtpServer (const String &server)
	Set the NTP server. More...
void	setAutoQuery (bool autoQuery)
	Enable / disable periodic query. More...
void	setAutoQueryInterval (unsigned seconds)
	Set query period. More...
void	setAutoUpdateSystemClock (bool autoUpdateClock)
	Enable / disable update of system clock. More...

Protected Member Functions
void	onReceive (pbuf *buf, IPAddress remoteIP, uint16_t remotePort) override
	Handle UDP message reception. More...
void	internalRequestTime (IPAddress serverIp)
	Send time request to NTP server. More...
void	startTimer (uint32_t milliseconds)
	Start the timer running. More...
void	stopTimer ()
virtual bool	listen (int port)
virtual bool	connect (IPAddress ip, uint16_t port)
virtual void	close ()
virtual bool	send (const char *data, int length)
bool	sendString (const char *data)
bool	sendString (const String &data)
virtual bool	sendTo (IPAddress remoteIP, uint16_t remotePort, const char *data, int length)
bool	sendStringTo (IPAddress remoteIP, uint16_t remotePort, const char *data)
bool	sendStringTo (IPAddress remoteIP, uint16_t remotePort, const String &data)
bool	initialize (udp_pcb *pcb=nullptr)

Static Protected Member Functions
static void	staticOnReceive (void *arg, struct udp_pcb *pcb, struct pbuf *p, LWIP_IP_ADDR_T *addr, u16_t port)

Protected Attributes
String	server
	IP address or Hostname of NTP server. More...
NtpTimeResultDelegate	delegateCompleted = nullptr
	NTP result handler delegate. More...
bool	autoUpdateSystemClock = false
	True to update system clock with NTP time. More...
bool	autoQueryEnabled = false
unsigned	autoQuerySeconds = NTP_DEFAULT_AUTOQUERY_SECONDS
Timer	timer
	Deals with timeouts, retries and autoquery updates. More...
udp_pcb *	udp = nullptr
UdpConnectionDataDelegate	onDataCallback = nullptr

Detailed Description

NTP client class.

Constructor & Destructor Documentation

NtpClient::NtpClient ( )

inline

Instantiates NTP client object.

NtpClient::NtpClient ( NtpTimeResultDelegate  onTimeReceivedCb )

inline

Instantiates NTP client object.

Parameters

onTimeReceivedCb

Callback delegate to be called when NTP time result is received

NtpClient::NtpClient	(	const String &	reqServer,
		unsigned	reqIntervalSeconds,
		NtpTimeResultDelegate	onTimeReceivedCb = nullptr
	)

Instantiates NTP client object.

Parameters

reqServer	IP address or hostname of NTP server
reqIntervalSeconds	Quantity of seconds between NTP requests
onTimeReceivedCb	Callback delegate to be called when NTP time result is received (Default: None)

Member Function Documentation

void NtpClient::internalRequestTime ( IPAddress  serverIp )

protected

Send time request to NTP server.

Parameters

serverIp

IP address of NTP server

void NtpClient::onReceive ( pbuf *  buf, IPAddress  remoteIP, uint16_t  remotePort  )

overrideprotectedvirtual

Handle UDP message reception.

Parameters

buf	Pointer to data buffer containing UDP payload
remoteIP	IP address of remote host
remotePort	Port number of remote host

Reimplemented from UdpConnection.

void NtpClient::requestTime

(

)

Request time from NTP server.

Note

Instigates request. Result is handled by NTP result handler function if defined

void NtpClient::setAutoQuery

(

bool

autoQuery

)

Enable / disable periodic query.

Parameters

autoQuery

True to enable periodic query of NTP server

void NtpClient::setAutoQueryInterval

(

unsigned

seconds

)

Set query period.

Parameters

seconds

Period in seconds between periodic queries

void NtpClient::setAutoUpdateSystemClock ( bool  autoUpdateClock )

inline

Enable / disable update of system clock.

Parameters

autoUpdateClock

True to update system clock with NTP result.

void NtpClient::setNtpServer ( const String &  server )

inline

Set the NTP server.

Parameters

server

IP address or hostname of NTP server

void NtpClient::startTimer ( uint32_t  milliseconds )

inlineprotected

Start the timer running.

Parameters

time	to run in milliseconds

Member Data Documentation

bool NtpClient::autoUpdateSystemClock = false

protected

True to update system clock with NTP time.

NtpTimeResultDelegate NtpClient::delegateCompleted = nullptr

protected

NTP result handler delegate.

String NtpClient::server

protected

IP address or Hostname of NTP server.

Timer NtpClient::timer

protected

Deals with timeouts, retries and autoquery updates.