Debugging Utilities.
A set of utilities for printing to the debug backchannel.
See ember-debug.h
for source code.
#define emberDebugInit |
( |
|
port | ) |
do {} while (false) |
- Parameters
-
port | Ignored because the port used for debug communication is automatically determined for each platform. |
void emberDebugAssert |
( |
PGM_P |
filename, |
|
|
int |
linenumber |
|
) |
| |
- Parameters
-
filename | The name of the file where the assert occurred. |
linenumber | The line number in the file where the assert occurred. |
void emberDebugBinaryPrintf |
( |
PGM_P |
formatString, |
|
|
|
... |
|
) |
| |
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 (PGM_P).
- xxxp - pointer to RAM, length is xxx (max 255).
- lp - pointer to RAM, length is uint8_t argument.
- xxxf - pointer to Flash (PGM_P), length is xxx (max 255).
- lf - pointer to Flash (PGM_P), length is uint8_t argument.
- b - EmberMessageBuffer.
Examples:
1 emberDebugBinaryPrintf("BWD", status, panId, channelMask);
2 emberDebugBinaryPrintf("F8p", "string example", eui64);
3 emberDebugBinaryPrintf("lp64fb", length, bytes, dataTable, buffer);
- Parameters
-
formatString | A string of conversion specification characters describing the arguments to be printed. |
... | The arguments to be printed. |
void emberDebugMemoryDump |
( |
uint8_t * |
start, |
|
|
uint8_t * |
end |
|
) |
| |
- Parameters
-
start | The start address of the block of RAM to dump. |
end | The end address of the block of RAM to dump (address of the last byte). |
void emberDebugPrintf |
( |
PGM_P |
formatString, |
|
|
|
... |
|
) |
| |
- Parameters
-
formatString | Takes the following: |
%% | Percent sign |
%c | Single-byte char |
%s | RAM string |
%p | Flash string (does not follow the printf standard) |
%u | Two-byte unsigned decimal |
%d | Two-byte signed decimal |
%x, %%2x, %%4x | 1-, 2-, 4-byte hex value (always 0 padded; does not follow the printf standard) |
bool emberDebugReportOff |
( |
void |
| ) |
|
- Returns
- The current state (true for on, false for off).
void emberDebugReportRestore |
( |
bool |
state | ) |
|
- Parameters
-
state | The state returned from emberDebugReportOff(). This is done so that debug output is not blindly turned on. |
void emDebugSendVuartMessage |
( |
const uint8_t * |
buff, |
|
|
uint8_t |
len |
|
) |
| |
- Parameters
-
buff | A pointer to the data to send |
len | Lenght of the data to send |