User Manual

bool initRootCA (void)

This function allocates memory for the default list of root certificates and any custom root certificates present.

Normally this function never needs to be called directly, and will be call on an as-needed bases by .addRootCA or

.connectSSL. It is provided as a public function so that other classes can have access to it (AdafruitTCP, etc.).

Parameters: None

Returns: 'True' (1) if the root CA initialisation was successful, otherwise 'false' (0).

bool addRootCA (uint8_t const* root_ca, uint16_t len)

This will add the supplied root certificate to the default root certificate list. The combined root list (default plus custom

root CAs) will be used when trying to verify any certificate chains provided by a remote secure server.

The root certificate chain suppied via 'root_ca' can contain more than one certificate, but must be a byte array

converted from a binary .der file, generated using the python tool included in the '/tools/pycert' folder of the board

support package.

Parameters:

root_ca: A pointer to the .der file byte array generated by `/tools/pycert/pycert.py'

len: The size in bytes of the .der byte array

Returns: 'True' (1) if the root certificate chain was successfully set, otherwise 'false' (0).

bool clearRootCA ( void )

Clears any root certificates currently used by the system (freeing up associated heap memory in FeatherLib).

Parameters: None

Returns: 'True' (1) if the operation succeeded, otherwise 'false' (0).

Print Helpers

The following functions are provided to print out common data and simplify user sketches:

void printVersions (Print& p = Serial)

Displays the bootloader and firmware versions used by the WICED Feather in the following order:

Bootloader version

Broadcom WICED SDK version

FeatherLib version

Arduino (User Code) version

The default root CA list will be enabled by default unless Feather.enableRootCA(false) or

Feather.clearRootCA() is called explicitly.