Web Client

Topics
	Web Client Error Codes

Classes
class	ParsedURI
	Parsed Uniform Resource Identifier Class (URI) More...

Functions
void	SetHttpDiag (bool b)
	Enable/disable Web Client HTTP diagnostics to the console port.
int	DoMultipartStartPost (ParsedURI &TheUri, const char *separator, uint16_t TIMEOUT_WAIT=10 *TICKS_PER_SECOND, uint32_t contentLength=0)
	Start a multipart HTTP post using a pre-parsed URI object.
int	DoMultipartStartPost (const char *pUrl, const char *separator, uint16_t TIMEOUT_WAIT=10 *TICKS_PER_SECOND, uint32_t contentLength=0)
	Start a multipart HTTP post using a pointer to a URL.
void	DoMultipartItem (int tcpfd, const char *Disposition, const char *separator, const unsigned char *data, int len)
	Send a multipart item.
void	DoMultipartBoundary (int tcpfd, const char *Disposition, const char *separator)
	Send a multipart boundary.
bool	DoMultipartFinished (int tcpfd, const char *separator, buffer_object &result_buffer, uint16_t TIMEOUT_WAIT=10 *TICKS_PER_SECOND)
	Send a multipart item.
bool	DoUrlEncodedFormPost (ParsedURI &TheUri, char *headers, char *form_data, buffer_object &result_buffer, uint16_t TIMEOUT_WAIT)
	Post a JSON file using a HTTP Form Post and a a ParsedURI object.
bool	DoUrlEncodedFormPost (const char *pUrl, char *headers, char *form_data, buffer_object &result_buffer, uint16_t TIMEOUT_WAIT)
	Post a JSON file using a HTTP POST and a URL string and pointer to JSON data.
bool	DoJsonPost (const char *pUrl, const char *Json_Data_To_Post, buffer_object &result_buffer, const char *AdditionalHeaders=NULL, uint16_t TIMEOUT_WAIT=10 *TICKS_PER_SECOND)
	Post a JSON file using a HTTP POST and a URL string and pointer to JSON data.
bool	DoJsonPost (ParsedURI &TheUri, const char *Json_Data_To_Post, buffer_object &result_buffer, const char *AdditionalHeaders=NULL, uint16_t TIMEOUT_WAIT=10 *TICKS_PER_SECOND)
	Post a JSON file using a HTTP POST and a ParsedURI object.
bool	DoJsonPost (const char *pUrl, ParsedJsonDataSet &jsonout, buffer_object &result_buffer, const char *AdditionalHeaders, uint16_t TIMEOUT_WAIT=10 *TICKS_PER_SECOND)
	Post a JSON file using a HTTP POST and a URL string.
bool	DoJsonPost (ParsedURI &TheUri, ParsedJsonDataSet &jsonout, buffer_object &result_buffer, const char *AdditionalHeaders, uint16_t TIMEOUT_WAIT=10 *TICKS_PER_SECOND)
	Post a JSON file using HTTP and a ParsedURI object.
bool	DoJsonPostHttpFile (const char *pUrl, const char *FragmentName, buffer_object &result_buffer, const char *AdditionalHeaders, uint16_t TIMEOUT_WAIT=10 *TICKS_PER_SECOND)
	Post a JSON file using HTTP and a URL string.
bool	DoJsonPostHttpFile (ParsedURI &TheUri, const char *FragmentName, buffer_object &result_buffer, const char *AdditionalHeaders, uint16_t TIMEOUT_WAIT=10 *TICKS_PER_SECOND)
	Post a JSON file using HTTP and a ParsedURI object.
bool	DoGet (ParsedURI &TheUri, buffer_object &result_buffer, uint16_t TIMEOUT_WAIT=10 *TICKS_PER_SECOND)
bool	DoGetEx (ParsedURI &TheUri, const char *headers, buffer_object &result_buffer, uint16_t TIMEOUT_WAIT=10 *TICKS_PER_SECOND)
bool	DoGet (const char *pUrl, buffer_object &result_buffer, uint16_t TIMEOUT_WAIT=10 *TICKS_PER_SECOND)
	Execute a HTTP/HTTPS GET request using a pointer to a URL string.
bool	DoGetEx (const char *pUrl, const char *headers, buffer_object &result_buffer, uint16_t TIMEOUT_WAIT=10 *TICKS_PER_SECOND)
	Execute a HTTP/HTTPS GET request using a pointer to a URL string.
int	DoGet (ParsedURI &TheUri, unsigned char *result, int maxl, uint16_t TIMEOUT_WAIT=10 *TICKS_PER_SECOND)
	Execute a HTTP/HTTPS GET request using a reference to a parsed Uniform Resource Identifier (URI)
int	DoGetEx (ParsedURI &TheUri, const char *headers, unsigned char *result, int maxl, uint16_t TIMEOUT_WAIT=10 *TICKS_PER_SECOND)
	Execute a HTTP/HTTPS GET request using a reference to a parsed Uniform Resource Identifier (URI)
int	DoGet (const char *pUrl, unsigned char *result, int maxl, uint16_t TIMEOUT_WAIT=10 *TICKS_PER_SECOND)
	Execute a HTTP/HTTPS GET request using a pointer to a URL string.
int	DoGetEx (const char *pUrl, const char *headers, unsigned char *result, int maxl, uint16_t TIMEOUT_WAIT=10 *TICKS_PER_SECOND)
	Execute a HTTP/HTTPS GET request using a pointer to a URL string.
int	DoGetUpdate (ParsedURI &TheUri, uint16_t TIMEOUT_WAIT=10 *TICKS_PER_SECOND)
	Execute a firmware update from the specified URI.
int	DoGetUpdate (const char *pUrl, uint16_t TIMEOUT_WAIT=10 *TICKS_PER_SECOND)
	Execute a firmware update from the specified URI.
int	PopulateAuthHeader (const char *user, const char *password, char *buffer, int maxlen)
	Fill in a username and password into a buffer for use as an extra header.
bool	DoActualClientRequest (ParsedURI &TheUri, uint16_t &next_time_delay)
	Callback to specify for performing and handle a WebClient request.
bool	StartWebClient (int prio, const char *url1, const char *url2=NULL, bool bDoNtp=false)
	Start the web client using a URL string.
bool	StartWebClient (int prio, const NBString &url1, const NBString &url2, bool bDoNtp=false)
	Start the web client using a NBString.
bool	StartWebClient (int prio, const NBString &url1, bool bDoNtp=false)
	Start the web client using a NBString.

Variables
WebErrorReporterFunc *	pWebErrorReporter
	Set this variable to a callback function to specify a handler for errors.

Detailed Description

#include< http_funcs.h >

Functions for interacting with the web, like HTTP GET/POST requests.

An easy way to get web data (from our GetNonJsonFromServer example):

const char *purl = "http://www.example.com/";
int result = 0;
static unsigned char ResultBuffer[5000];
 
result = DoGet(purl, ResultBuffer, 5000, 60 * TICKS_PER_SECOND);
 
if (result > 0)
{
    printf("Result = %d\r\n[", result);
    for (int i = 0; i < result; i++)
    {
        printf("%c", ResultBuffer[i]);
    }
    printf("]\r\n");
}
else
{
    iprintf("Failed to contact server\r\n");
}

#include< web_client.h >

Functions for instantiating a periodic web client

From our WebClient examples:

const char *url = "http://www.example.com";
 
void HandleErrorState(int state)
{
    if (state == WEB_CLIENT_ERROR_NO_ERROR) return;
    if ((state <= WEB_CLIENT_ERROR_LAST_STATE) && (state > 0))
        iprintf("Set Error state [%d] [%s]\r\n", state, web_error_state_text[state]);
    else
        iprintf("Error state unknown %d\r\n", state);
}
 
bool DoActualClientRequest(ParsedURI &TheUri, uint16_t &next_time_delay)
{
    static unsigned char ResultBuffer[5000];
 
    bool result = DoGet(TheUri, ResultBuffer);
    if (result)
    {
        printf("Result = %d\r\n[", result);
        for (int i = 0; i < result; i++)
        {
            printf("%c", ResultBuffer[i]);
        }
        printf("]\r\n");
        next_time_delay = 10 * TICKS_PER_SECOND;
        return true;
    }
 
    next_time_delay = 10 * TICKS_PER_SECOND;
    return false;
}
 
void UserMain(void *pd)
{
    init();
    WaitForActiveNetwork(TICKS_PER_SECOND * 5);
 
    pWebErrorReporter = HandleErrorState;
    StartWebClient(MAIN_PRIO - 2, url);
 
    while (1)
    {
        OSTimeDly(TICKS_PER_SECOND * 1);
    }
} 

Function Documentation

DoActualClientRequest()

bool DoActualClientRequest	(	ParsedURI &	TheUri,
		uint16_t &	next_time_delay )

#include <web_client.h>

Callback to specify for performing and handle a WebClient request.

Parameters

TheUri	Pointer to a ParsedURI object (representing the URL)
next_time_delay	Pointer to the number of ticks to wait before the next request

Returns

True on success, false on failure.

DoGet() [1/4]

bool DoGet	(	const char *	pUrl,
		buffer_object &	result_buffer,
		uint16_t	TIMEOUT_WAIT = 10 *TICKS_PER_SECOND )

#include <http_funcs.h>

Execute a HTTP/HTTPS GET request using a pointer to a URL string.

This function will parse the URL string to connect to the host.

Parameters

pUrl	Pointer to a URL string. A DNS lookup will be done if necessary.
&result_buffer	Reference to the memory buffer in which to store the result.
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.

Returns

True on success, false on failure.

DoGet() [2/4]

int DoGet	(	const char *	pUrl,
		unsigned char *	result,
		int	maxl,
		uint16_t	TIMEOUT_WAIT = 10 *TICKS_PER_SECOND )

#include <http_funcs.h>

Execute a HTTP/HTTPS GET request using a pointer to a URL string.

This function will parse the URL string to connect to the host.

Parameters

pUrl	Pointer to a URL string. A DNS lookup will be done if necessary.
result	Pointer to the buffer in which to store the result.
maxl	Maximum length of the result buffer.
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.

Returns

DoGet() [3/4]

bool DoGet	(	ParsedURI &	TheUri,
		buffer_object &	result_buffer,
		uint16_t	TIMEOUT_WAIT = 10 *TICKS_PER_SECOND )

#include <http_funcs.h>

Parameters

&TheUri	Reference to the pre-parsed URI.
&result_buffer	Reference to the location to store the result.
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.

Returns

True on success, false on failure.

DoGet() [4/4]

int DoGet	(	ParsedURI &	TheUri,
		unsigned char *	result,
		int	maxl,
		uint16_t	TIMEOUT_WAIT = 10 *TICKS_PER_SECOND )

#include <http_funcs.h>

Execute a HTTP/HTTPS GET request using a reference to a parsed Uniform Resource Identifier (URI)

This function uses a reference to a parsed URI, providing faster execution and avoiding parsing a URL, DNS, etc.

Parameters

TheUri	Reference to the ParsedURI object.
result	Pointer to the buffer in which to store the result.
maxl	Maximum length of the result buffer.
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.

Returns

DoGetEx() [1/4]

bool DoGetEx	(	const char *	pUrl,
		const char *	headers,
		buffer_object &	result_buffer,
		uint16_t	TIMEOUT_WAIT = 10 *TICKS_PER_SECOND )

#include <http_funcs.h>

Execute a HTTP/HTTPS GET request using a pointer to a URL string.

This function will parse the URL string to connect to the host.

Parameters

pUrl	Pointer to a URL string. A DNS lookup will be done if necessary.
headers	Additional HTTP header fields. Multiple header fields should be concatenated together and separated by by \r\n Do not put \r\n for last header (no trailing \r\n)
&result_buffer	Reference to the memory buffer in which to store the result.
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.

Returns

True on success, false on failure.

DoGetEx() [2/4]

int DoGetEx	(	const char *	pUrl,
		const char *	headers,
		unsigned char *	result,
		int	maxl,
		uint16_t	TIMEOUT_WAIT = 10 *TICKS_PER_SECOND )

#include <http_funcs.h>

Execute a HTTP/HTTPS GET request using a pointer to a URL string.

This function will parse the URL string to connect to the host.

Parameters

pUrl	Pointer to a URL string. A DNS lookup will be done if necessary.
headers	Additional HTTP header fields. Multiple header fields should be concatenated together and separated by by \r\n Do not put \r\n for last header (no trailing \r\n)
result	Pointer to the buffer in which to store the result.
maxl	Maximum length of the result buffer.
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.

Returns

DoGetEx() [3/4]

bool DoGetEx	(	ParsedURI &	TheUri,
		const char *	headers,
		buffer_object &	result_buffer,
		uint16_t	TIMEOUT_WAIT = 10 *TICKS_PER_SECOND )

#include <http_funcs.h>

Parameters

&TheUri	Reference to the pre-parsed URI.
headers	Additional HTTP header fields. Multiple header fields should be concatenated together and separated by by \r\n Do not put \r\n for last header (no trailing \r\n)
&result_buffer	Reference to the location to store the result.
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.

Returns

True on success, false on failure.

DoGetEx() [4/4]

int DoGetEx	(	ParsedURI &	TheUri,
		const char *	headers,
		unsigned char *	result,
		int	maxl,
		uint16_t	TIMEOUT_WAIT = 10 *TICKS_PER_SECOND )

#include <http_funcs.h>

Execute a HTTP/HTTPS GET request using a reference to a parsed Uniform Resource Identifier (URI)

This function uses a reference to a parsed URI, providing faster execution and avoiding parsing a URL, DNS, etc.

Parameters

TheUri	Reference to the ParsedURI object.
headers	Additional HTTP header fields. Multiple header fields should be concatenated together and separated by by \r\n Do not put \r\n for last header (no trailing \r\n)
result	Pointer to the buffer in which to store the result.
maxl	Maximum length of the result buffer.
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.

Returns

DoGetUpdate() [1/2]

int DoGetUpdate	(	const char *	pUrl,
		uint16_t	TIMEOUT_WAIT = 10 *TICKS_PER_SECOND )

#include <http_funcs.h>

Execute a firmware update from the specified URI.

Parameters

pUrl	Pointer to a URL string. A DNS lookup will be done if necessary.
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.

Returns

DoGetUpdate() [2/2]

int DoGetUpdate	(	ParsedURI &	TheUri,
		uint16_t	TIMEOUT_WAIT = 10 *TICKS_PER_SECOND )

#include <http_funcs.h>

Execute a firmware update from the specified URI.

Parameters

TheUri	Reference to the ParsedURI object.
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.

Returns

DoJsonPost() [1/4]

bool DoJsonPost	(	const char *	pUrl,
		const char *	Json_Data_To_Post,
		buffer_object &	result_buffer,
		const char *	AdditionalHeaders = NULL,
		uint16_t	TIMEOUT_WAIT = 10 *TICKS_PER_SECOND )

#include <http_funcs.h>

Post a JSON file using a HTTP POST and a URL string and pointer to JSON data.

Parameters

pUrl	Pointer to a URL string.
Json_Data_To_Post	Pointer to serialized JSON data
&result_buffer	Reference to the location in which to store the result.
AdditionalHeaders	Additional HTTP header fields. Multiple header fields should be concatenated together and separated by by \r\n Do not put \r\n for last header (no trailing \r\n)
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.

Returns

True on success, false on failure.

DoJsonPost() [2/4]

bool DoJsonPost	(	const char *	pUrl,
		ParsedJsonDataSet &	jsonout,
		buffer_object &	result_buffer,
		const char *	AdditionalHeaders,
		uint16_t	TIMEOUT_WAIT = 10 *TICKS_PER_SECOND )

#include <http_funcs.h>

Post a JSON file using a HTTP POST and a URL string.

Parameters

pUrl	Pointer to a URL string.
jsonout	Reference to NetBurner data object. Please ref JSON lexer.
&result_buffer	Reference to the location in which to store the result.
AdditionalHeaders	Additional HTTP header fields. Multiple header fields should be concatenated together and separated by by \r\n Do not put \r\n for last header (no trailing \r\n)
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.

Returns

True on success, false on failure.

DoJsonPost() [3/4]

bool DoJsonPost	(	ParsedURI &	TheUri,
		const char *	Json_Data_To_Post,
		buffer_object &	result_buffer,
		const char *	AdditionalHeaders = NULL,
		uint16_t	TIMEOUT_WAIT = 10 *TICKS_PER_SECOND )

#include <http_funcs.h>

Post a JSON file using a HTTP POST and a ParsedURI object.

Parameters

&TheUri	Reference to the pre-parsed URI.
Json_Data_To_Post	Serialized JSON data\
&result_buffer	Reference to the location in which to store the result.
AdditionalHeaders	Additional HTTP header fields. Multiple header fields should be concatenated together and separated by by \r\n Do not put \r\n for last header (no trailing \r\n)
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.

Returns

True on success, false on failure.

DoJsonPost() [4/4]

bool DoJsonPost	(	ParsedURI &	TheUri,
		ParsedJsonDataSet &	jsonout,
		buffer_object &	result_buffer,
		const char *	AdditionalHeaders,
		uint16_t	TIMEOUT_WAIT = 10 *TICKS_PER_SECOND )

#include <http_funcs.h>

Post a JSON file using HTTP and a ParsedURI object.

Parameters

&TheUri	Reference to the pre-parsed URI.
jsonout	Reference to NetBurner data object. Please ref JSON lexer.
&result_buffer	Reference to the location in which to store the result.
AdditionalHeaders	Additional HTTP header fields. Multiple header fields should be concatenated together and separated by by \r\n Do not put \r\n for last header (no trailing \r\n)
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.

Returns

True on success, false on failure.

DoJsonPostHttpFile() [1/2]

bool DoJsonPostHttpFile	(	const char *	pUrl,
		const char *	FragmentName,
		buffer_object &	result_buffer,
		const char *	AdditionalHeaders,
		uint16_t	TIMEOUT_WAIT = 10 *TICKS_PER_SECOND )

#include <http_funcs.h>

Post a JSON file using HTTP and a URL string.

Parameters

pUrl	Pointer to a URL string.
FragmentName
&result_buffer	Reference to the location in which to store the result.
AdditionalHeaders	Additional HTTP header fields. Multiple header fields should be concatenated together and separated by by \r\n Do not put \r\n for last header (no trailing \r\n)
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.

Returns

True on success, false on failure.

DoJsonPostHttpFile() [2/2]

bool DoJsonPostHttpFile	(	ParsedURI &	TheUri,
		const char *	FragmentName,
		buffer_object &	result_buffer,
		const char *	AdditionalHeaders,
		uint16_t	TIMEOUT_WAIT = 10 *TICKS_PER_SECOND )

#include <http_funcs.h>

Post a JSON file using HTTP and a ParsedURI object.

Parameters

&TheUri	Reference to the pre-parsed URI.
FragmentName
&result_buffer	Reference to the location in which to store the result.
AdditionalHeaders
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.

Returns

True on success, false on failure.

DoMultipartBoundary()

void DoMultipartBoundary	(	int	tcpfd,
		const char *	Disposition,
		const char *	separator )

#include <http_funcs.h>

Send a multipart boundary.

Parameters

tcpfd	TCP file descriptor returned from DoMultipartStartPost()
Disposition	Content disposition field of multipart body
separator	Separator string to use as the part delimiter between multipart posts.

DoMultipartFinished()

bool DoMultipartFinished	(	int	tcpfd,
		const char *	separator,
		buffer_object &	result_buffer,
		uint16_t	TIMEOUT_WAIT = 10 *TICKS_PER_SECOND )

#include <http_funcs.h>

Send a multipart item.

Parameters

tcpfd	TCP file descriptor returned from DoMultipartStartPost()
separator	Separator string to use as the part delimiter between multipart posts.
result_buffer	Reference to buffer to store result of xxxxx
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.

Returns

****** Need to understand in http_funcs.cpp

DoMultipartItem()

void DoMultipartItem	(	int	tcpfd,
		const char *	Disposition,
		const char *	separator,
		const unsigned char *	data,
		int	len )

#include <http_funcs.h>

Send a multipart item.

Parameters

tcpfd	TCP file descriptor returned from DoMultipartStartPost()
Disposition	Content disposition field of multipart body
separator	Separator string to use as the part delimiter between multipart posts.
data	Item data
len	Data length

DoMultipartStartPost() [1/2]

int DoMultipartStartPost	(	const char *	pUrl,
		const char *	separator,
		uint16_t	TIMEOUT_WAIT = 10 *TICKS_PER_SECOND,
		uint32_t	contentLength = 0 )

#include <http_funcs.h>

Start a multipart HTTP post using a pointer to a URL.

Parameters

pUrl	Pointer to a URL string.
separator	Separator string to use as the part delimiter between multipart posts.
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.
contentLength	If given, content length for the entire multipart post.

Returns

A TCP/TLS file descriptor greater than 0 if a socket was successfully opened, or TCP Socket Status on failure.

DoMultipartStartPost() [2/2]

int DoMultipartStartPost	(	ParsedURI &	TheUri,
		const char *	separator,
		uint16_t	TIMEOUT_WAIT = 10 *TICKS_PER_SECOND,
		uint32_t	contentLength = 0 )

#include <http_funcs.h>

Start a multipart HTTP post using a pre-parsed URI object.

Parameters

&TheUri	Reference to the pre-parsed URI object.
separator	Separator string to use as the part delimiter between multipart posts.
TIMEOUT_WAIT	Timeout in seconds to wait for a response.
contentLength	If given, content length for the entire multipart post.

Returns

A TCP/TLS file descriptor greater than 0 if a socket was successfully opened, or TCP Socket Status on failure.

DoUrlEncodedFormPost() [1/2]

bool DoUrlEncodedFormPost	(	const char *	pUrl,
		char *	headers,
		char *	form_data,
		buffer_object &	result_buffer,
		uint16_t	TIMEOUT_WAIT )

#include <http_funcs.h>

Post a JSON file using a HTTP POST and a URL string and pointer to JSON data.

Parameters

pUrl	Pointer to a URL string.
headers	Additional HTTP header fields. Multiple header fields should be concatenated together and separated by by \r\n Do not put \r\n for last header (no trailing \r\n)
form_data	Pointer to the JSON data you are posting.
&result_buffer	Reference to the location in which to store the result.
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.

Returns

True on success, false on failure.

DoUrlEncodedFormPost() [2/2]

bool DoUrlEncodedFormPost	(	ParsedURI &	TheUri,
		char *	headers,
		char *	form_data,
		buffer_object &	result_buffer,
		uint16_t	TIMEOUT_WAIT )

#include <http_funcs.h>

Post a JSON file using a HTTP Form Post and a a ParsedURI object.

Parameters

&TheUri	Reference to the pre-parsed URI.
headers	Additional HTTP header fields. Multiple header fields should be concatenated together and separated by by \r\n Do not put \r\n for last header (no trailing \r\n)
form_data	Pointer to the JSON data you are posting.
&result_buffer	Reference to the location in which to store the result.
TIMEOUT_WAIT	Timeout in in system time ticks to wait for a response.

Returns

True on success, false on failure.

PopulateAuthHeader()

int PopulateAuthHeader	(	const char *	user,
		const char *	password,
		char *	buffer,
		int	maxlen )

#include <http_funcs.h>

Fill in a username and password into a buffer for use as an extra header.

Parameters

user	Pointer to username
password	Pointer to password
buffer	Destination buffer to put the authenticate header in.
maxlen	Maximum number of chars to put in buffer

Returns

number of chars written, negative if the buffer was too small.

SetHttpDiag()

void SetHttpDiag

(

bool

b

)

#include <http_funcs.h>

Enable/disable Web Client HTTP diagnostics to the console port.

Parameters

b	Set true to enable, false to disable.

StartWebClient() [1/3]

bool StartWebClient	(	int	prio,
		const char *	url1,
		const char *	url2 = NULL,
		bool	bDoNtp = false )

#include <web_client.h>

Start the web client using a URL string.

Parameters

prio	Priority
url1	Pointer to a string representing the URL.
url2	Pointer to a second URL. Optional parameter, default is NULL.
bDoNtp	Enable the Network Time Protocol (NTP). Optional parameter, default is false.

Returns

True on success, false on failure.

StartWebClient() [2/3]

bool StartWebClient	(	int	prio,
		const NBString &	url1,
		bool	bDoNtp = false )

#include <web_client.h>

Start the web client using a NBString.

Parameters

prio	Priority
url1	Reference to a NBString representing the URL.
bDoNtp	Enable the Network Time Protocol (NTP). Optional parameter, default is false.

Returns

True on success, false on failure.

StartWebClient() [3/3]

bool StartWebClient	(	int	prio,
		const NBString &	url1,
		const NBString &	url2,
		bool	bDoNtp = false )

#include <web_client.h>

Start the web client using a NBString.

Parameters

prio	Priority
url1	Reference to a string representing the URL.
url2	Reference to a second URL. Optional parameter, default is NULL.
bDoNtp	Enable the Network Time Protocol (NTP). Optional parameter, default is false.

Returns

True on success, false on failure.