mirror of
https://github.com/cesanta/mongoose.git
synced 2024-12-30 13:08:02 +08:00
150 lines
6.3 KiB
C
150 lines
6.3 KiB
C
/*
|
||
* Copyright 2017 - 2020 NXP
|
||
* All rights reserved.
|
||
*
|
||
*
|
||
* SPDX-License-Identifier: BSD-3-Clause
|
||
*/
|
||
#ifndef _FSL_DEBUG_CONSOLE_CONF_H_
|
||
#define _FSL_DEBUG_CONSOLE_CONF_H_
|
||
|
||
#include "fsl_common.h"
|
||
|
||
/*!
|
||
* @addtogroup debug_console_config
|
||
* @ingroup debugconsole
|
||
* @{
|
||
*/
|
||
|
||
/****************Debug console configuration********************/
|
||
|
||
/*! @brief If Non-blocking mode is needed, please define it at project setting,
|
||
* otherwise blocking mode is the default transfer mode.
|
||
* Warning: If you want to use non-blocking transfer,please make sure the corresponding
|
||
* IO interrupt is enable, otherwise there is no output.
|
||
* And non-blocking is combine with buffer, no matter bare-metal or rtos.
|
||
* Below shows how to configure in your project if you want to use non-blocking mode.
|
||
* For IAR, right click project and select "Options", define it in "C/C++ Compiler->Preprocessor->Defined symbols".
|
||
* For KEIL, click "Options for Target…", define it in "C/C++->Preprocessor Symbols->Define".
|
||
* For ARMGCC, open CmakeLists.txt and add the following lines,
|
||
* "SET(CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS_DEBUG} -DDEBUG_CONSOLE_TRANSFER_NON_BLOCKING")" for debug target.
|
||
* "SET(CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE} -DDEBUG_CONSOLE_TRANSFER_NON_BLOCKING")" for release target.
|
||
* For MCUxpresso, right click project and select "Properties", define it in "C/C++ Build->Settings->MCU C
|
||
* Complier->Preprocessor".
|
||
*
|
||
*/
|
||
#ifdef DEBUG_CONSOLE_TRANSFER_NON_BLOCKING
|
||
/*! @brief define the transmit buffer length which is used to store the multi task log, buffer is enabled automatically
|
||
* when
|
||
* non-blocking transfer is using,
|
||
* This value will affect the RAM's ultilization, should be set per paltform's capability and software requirement.
|
||
* If it is configured too small, log maybe missed , because the log will not be
|
||
* buffered if the buffer is full, and the print will return immediately with -1.
|
||
* And this value should be multiple of 4 to meet memory alignment.
|
||
*
|
||
*/
|
||
#ifndef DEBUG_CONSOLE_TRANSMIT_BUFFER_LEN
|
||
#define DEBUG_CONSOLE_TRANSMIT_BUFFER_LEN (512U)
|
||
#endif /* DEBUG_CONSOLE_TRANSMIT_BUFFER_LEN */
|
||
|
||
/*! @brief define the receive buffer length which is used to store the user input, buffer is enabled automatically when
|
||
* non-blocking transfer is using,
|
||
* This value will affect the RAM's ultilization, should be set per paltform's capability and software requirement.
|
||
* If it is configured too small, log maybe missed, because buffer will be overwrited if buffer is too small.
|
||
* And this value should be multiple of 4 to meet memory alignment.
|
||
*
|
||
*/
|
||
#ifndef DEBUG_CONSOLE_RECEIVE_BUFFER_LEN
|
||
#define DEBUG_CONSOLE_RECEIVE_BUFFER_LEN (1024U)
|
||
#endif /* DEBUG_CONSOLE_RECEIVE_BUFFER_LEN */
|
||
|
||
/*!@brief Whether enable the reliable TX function
|
||
* If the macro is zero, the reliable TX function of the debug console is disabled.
|
||
* When the macro is zero, the string of PRINTF will be thrown away after the transmit buffer is full.
|
||
*/
|
||
#ifndef DEBUG_CONSOLE_TX_RELIABLE_ENABLE
|
||
#define DEBUG_CONSOLE_TX_RELIABLE_ENABLE (1U)
|
||
#endif /* DEBUG_CONSOLE_TX_RELIABLE_ENABLE */
|
||
|
||
#else
|
||
#define DEBUG_CONSOLE_TRANSFER_BLOCKING
|
||
#endif /* DEBUG_CONSOLE_TRANSFER_NON_BLOCKING */
|
||
|
||
/*!@brief Whether enable the RX function
|
||
* If the macro is zero, the receive function of the debug console is disabled.
|
||
*/
|
||
#ifndef DEBUG_CONSOLE_RX_ENABLE
|
||
#define DEBUG_CONSOLE_RX_ENABLE (1U)
|
||
#endif /* DEBUG_CONSOLE_RX_ENABLE */
|
||
|
||
/*!@brief define the MAX log length debug console support , that is when you call printf("log", x);, the log
|
||
* length can not bigger than this value.
|
||
* This macro decide the local log buffer length, the buffer locate at stack, the stack maybe overflow if
|
||
* the buffer is too big and current task stack size not big enough.
|
||
*/
|
||
#ifndef DEBUG_CONSOLE_PRINTF_MAX_LOG_LEN
|
||
#define DEBUG_CONSOLE_PRINTF_MAX_LOG_LEN (128U)
|
||
#endif /* DEBUG_CONSOLE_PRINTF_MAX_LOG_LEN */
|
||
|
||
/*!@brief define the buffer support buffer scanf log length, that is when you call scanf("log", &x);, the log
|
||
* length can not bigger than this value.
|
||
* As same as the DEBUG_CONSOLE_BUFFER_PRINTF_MAX_LOG_LEN.
|
||
*/
|
||
#ifndef DEBUG_CONSOLE_SCANF_MAX_LOG_LEN
|
||
#define DEBUG_CONSOLE_SCANF_MAX_LOG_LEN (20U)
|
||
#endif /* DEBUG_CONSOLE_SCANF_MAX_LOG_LEN */
|
||
|
||
/*! @brief Debug console synchronization
|
||
* User should not change these macro for synchronization mode, but add the
|
||
* corresponding synchronization mechanism per different software environment.
|
||
* Such as, if another RTOS is used,
|
||
* add:
|
||
* \#define DEBUG_CONSOLE_SYNCHRONIZATION_XXXX 3
|
||
* in this configuration file and implement the synchronization in fsl.log.c.
|
||
*/
|
||
/*! @brief synchronization for baremetal software */
|
||
#define DEBUG_CONSOLE_SYNCHRONIZATION_BM 0
|
||
/*! @brief synchronization for freertos software */
|
||
#define DEBUG_CONSOLE_SYNCHRONIZATION_FREERTOS 1
|
||
|
||
/*! @brief RTOS synchronization mechanism disable
|
||
* If not defined, default is enable, to avoid multitask log print mess.
|
||
* If other RTOS is used, you can implement the RTOS's specific synchronization mechanism in fsl.log.c
|
||
* If synchronization is disabled, log maybe messed on terminal.
|
||
*/
|
||
#ifndef DEBUG_CONSOLE_DISABLE_RTOS_SYNCHRONIZATION
|
||
#ifdef DEBUG_CONSOLE_TRANSFER_NON_BLOCKING
|
||
#ifdef SDK_OS_FREE_RTOS
|
||
#define DEBUG_CONSOLE_SYNCHRONIZATION_MODE DEBUG_CONSOLE_SYNCHRONIZATION_FREERTOS
|
||
#else
|
||
#define DEBUG_CONSOLE_SYNCHRONIZATION_MODE DEBUG_CONSOLE_SYNCHRONIZATION_BM
|
||
#endif /* SDK_OS_FREE_RTOS */
|
||
#else
|
||
#define DEBUG_CONSOLE_SYNCHRONIZATION_MODE DEBUG_CONSOLE_SYNCHRONIZATION_BM
|
||
#endif /* DEBUG_CONSOLE_TRANSFER_NON_BLOCKING */
|
||
#endif /* DEBUG_CONSOLE_DISABLE_RTOS_SYNCHRONIZATION */
|
||
|
||
/*! @brief echo function support
|
||
* If you want to use the echo function,please define DEBUG_CONSOLE_ENABLE_ECHO
|
||
* at your project setting.
|
||
*/
|
||
#ifndef DEBUG_CONSOLE_ENABLE_ECHO
|
||
#define DEBUG_CONSOLE_ENABLE_ECHO_FUNCTION 0
|
||
#else
|
||
#define DEBUG_CONSOLE_ENABLE_ECHO_FUNCTION 1
|
||
#endif /* DEBUG_CONSOLE_ENABLE_ECHO */
|
||
|
||
/*********************************************************************/
|
||
|
||
/***************Debug console other configuration*********************/
|
||
|
||
/*! @brief Definition to select virtual com(USB CDC) as the debug console. */
|
||
#ifndef BOARD_USE_VIRTUALCOM
|
||
#define BOARD_USE_VIRTUALCOM 0U
|
||
#endif
|
||
/*******************************************************************/
|
||
|
||
/*! @} */
|
||
|
||
#endif /* _FSL_DEBUG_CONSOLE_CONF_H_ */
|