Debugging Utilities#

emberDebugAssert#

void emberDebugAssert (const char * filename, int linenumber)

Prints the filename and line number to the debug serial port.

emberDebugMemoryDump#

void emberDebugMemoryDump (uint8_t * start, uint8_t * end)

Prints the contents of RAM to the debug serial port.

emberDebugBinaryPrintf#

void emberDebugBinaryPrintf (const char * formatString, ... )

Prints binary data to the debug channel.

This function does not use the normal printf format conventions. To print text debug messages, use emberDebugPrintf(). The format string must contain only these conversion specification characters:

• B - uint8_t value.

• W - uint16_t value, printed least significant byte first.

• D - uint32_t value, printed least significant byte first.

• F - pointer to null terminated string in Flash (const char *).

• xxxp - pointer to RAM, length is xxx (max 255).

• lp - pointer to RAM, length is uint8_t argument.

• xxxf - pointer to Flash (const char *), length is xxx (max 255).

• lf - pointer to Flash (const char *), length is uint8_t argument.

• b - EmberMessageBuffer.

Examples:

emberDebugBinaryPrintf("BWD", status, panId, channelMask);
emberDebugBinaryPrintf("F8p", "string example", eui64);
emberDebugBinaryPrintf("lp64fb", length, bytes, dataTable, buffer);

emDebugSendVuartMessage#

void emDebugSendVuartMessage (uint8_t * buff, uint8_t len)

Sends VUART data out the debug channel.

emberDebugError#

void emberDebugError (EmberStatus code)

Prints an EmberStatus return code to the serial port.

emberDebugReportOff#

bool emberDebugReportOff (void )

Turns off all debug output.

Returns

• The current state (true for on, false for off).

emberDebugReportRestore#

void emberDebugReportRestore (bool state)

Restores the state of the debug output.

emberDebugPrintf#

void emberDebugPrintf (const char * formatString, ... )

Prints text debug messages.

NO_DEBUG#

#define NO_DEBUG

0

BASIC_DEBUG#

#define BASIC_DEBUG

1

FULL_DEBUG#

#define FULL_DEBUG

2

emberDebugInit#

#define emberDebugInit

(port)

This function is obsolete and no longer required to initialize the debug system.