See Debugging Utilities for documentation.

License#

Copyright 2018 Silicon Laboratories Inc. www.silabs.com

The licensor of this software is Silicon Laboratories Inc. Your use of this software is governed by the terms of Silicon Labs Master Software License Agreement (MSLA) available at www.silabs.com/about-us/legal/master-software-license-agreement. This software is distributed to you in Source Code format and is governed by the sections of the MSLA applicable to Source Code.

/***************************************************************************/
#ifndef SILABS_EMBER_DEBUG_H
#define SILABS_EMBER_DEBUG_H

#ifndef UC_BUILD
// Define the values for DEBUG_LEVEL
#define NO_DEBUG    0
#define BASIC_DEBUG 1
#define FULL_DEBUG  2
#endif // UC_BUILD

#define emberDebugInit(port) do {} while (false)

#if (defined(DEBUG_LEVEL) && defined(BASIC_DEBUG) && (DEBUG_LEVEL >= BASIC_DEBUG)) || defined(DOXYGEN_SHOULD_SKIP_THIS) || defined(UC_BUILD)

#define DEBUG_ROUTINES_PRESENT

void emberDebugAssert(const char * filename, int linenumber);

void emberDebugMemoryDump(uint8_t *start, uint8_t *end);

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

void sli_util_debug_send_vuart_message(uint8_t *buff, uint8_t len);

//#if (DEBUG_LEVEL == FULL_DEBUG) || defined(DOXYGEN_SHOULD_SKIP_THIS)
void emberDebugError(EmberStatus code);

bool emberDebugReportOff(void);

void emberDebugReportRestore(bool state);

// Format: Same as emberSerialPrintf
// emberDebugPrintf("format string"[, parameters ...])
void emberDebugPrintf(const char * formatString, ...);

#else // (DEBUG_LEVEL >= BASIC_DEBUG) || defined(DOXYGEN_SHOULD_SKIP_THIS) || defined(UC_BUILD)
  #define emberDebugAssert(filename, linenumber) do {} while (false)
  #define emberDebugMemoryDump(start, end) do {} while (false)
  #define emberDebugBinaryPrintf(formatstring, ...) do {} while (false)
  #define sli_util_debug_send_vuart_message(buff, len) do {} while (false)
  #define emberDebugError(code) do {} while (false)
// Note the following doesn't have a do{}while(false)
//   because it has a return value
  #define emberDebugReportOff() (false)
  #define emberDebugReportRestore(state) do {} while (false)
  #define emberDebugPrintf(...) do {} while (false)
#endif // (defined(DEBUG_LEVEL) && defined(BASIC_DEBUG) && (DEBUG_LEVEL >= BASIC_DEBUG)) || defined(DOXYGEN_SHOULD_SKIP_THIS) || defined(UC_BUILD)

#endif // SILABS_EMBER_DEBUG_H

(port)

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