Nuvoton / Mbed OS NuMaker-mbed-emWin-example

NuMaker emWin HMI

emWin/Include/SEGGER.h@10:c8165817d92a, 7 months ago (annotated)

Committer:
csyang2
Date:
Mon Mar 04 15:47:41 2024 +0800
Revision:
10:c8165817d92a
Parent:
1:c0f972361605 
Support NuMaker-IoT-M467

Who changed what in which revision?

UserRevisionLine numberNew contents of line
csyang2 1:c0f972361605 1 /*********************************************************************
csyang2 1:c0f972361605 2 * SEGGER Software GmbH *
csyang2 1:c0f972361605 3 * Solutions for real time microcontroller applications *
csyang2 1:c0f972361605 4 **********************************************************************
csyang2 1:c0f972361605 5 * *
csyang2 1:c0f972361605 6 * (c) 1996 - 2018 SEGGER Microcontroller GmbH *
csyang2 1:c0f972361605 7 * *
csyang2 1:c0f972361605 8 * Internet: www.segger.com Support: support@segger.com *
csyang2 1:c0f972361605 9 * *
csyang2 1:c0f972361605 10 **********************************************************************
csyang2 1:c0f972361605 11
csyang2 1:c0f972361605 12 ** emWin V5.48 - Graphical user interface for embedded applications **
csyang2 1:c0f972361605 13 All Intellectual Property rights in the Software belongs to SEGGER.
csyang2 1:c0f972361605 14 emWin is protected by international copyright laws. Knowledge of the
csyang2 1:c0f972361605 15 source code may not be used to write a similar product. This file may
csyang2 1:c0f972361605 16 only be used in accordance with the following terms:
csyang2 1:c0f972361605 17
csyang2 1:c0f972361605 18 The software has been licensed by SEGGER Software GmbH to Nuvoton Technology Corporationat the address: No. 4, Creation Rd. III, Hsinchu Science Park, Taiwan
csyang2 1:c0f972361605 19 for the purposes of creating libraries for its
csyang2 1:c0f972361605 20 Arm Cortex-M and Arm9 32-bit microcontrollers, commercialized and distributed by Nuvoton Technology Corporation
csyang2 1:c0f972361605 21 under the terms and conditions of an End User
csyang2 1:c0f972361605 22 License Agreement supplied with the libraries.
csyang2 1:c0f972361605 23 Full source code is available at: www.segger.com
csyang2 1:c0f972361605 24
csyang2 1:c0f972361605 25 We appreciate your understanding and fairness.
csyang2 1:c0f972361605 26 ----------------------------------------------------------------------
csyang2 1:c0f972361605 27 Licensing information
csyang2 1:c0f972361605 28 Licensor: SEGGER Software GmbH
csyang2 1:c0f972361605 29 Licensed to: Nuvoton Technology Corporation, No. 4, Creation Rd. III, Hsinchu Science Park, 30077 Hsinchu City, Taiwan
csyang2 1:c0f972361605 30 Licensed SEGGER software: emWin
csyang2 1:c0f972361605 31 License number: GUI-00735
csyang2 1:c0f972361605 32 License model: emWin License Agreement, signed February 27, 2018
csyang2 1:c0f972361605 33 Licensed platform: Cortex-M and ARM9 32-bit series microcontroller designed and manufactured by or for Nuvoton Technology Corporation
csyang2 1:c0f972361605 34 ----------------------------------------------------------------------
csyang2 1:c0f972361605 35 Support and Update Agreement (SUA)
csyang2 1:c0f972361605 36 SUA period: 2018-03-26 - 2019-03-27
csyang2 1:c0f972361605 37 Contact to extend SUA: sales@segger.com
csyang2 1:c0f972361605 38 ----------------------------------------------------------------------
csyang2 1:c0f972361605 39 File : SEGGER.h
csyang2 1:c0f972361605 40 Purpose : Global types etc & general purpose utility functions
csyang2 1:c0f972361605 41 Revision: $Rev: 6176 $
csyang2 1:c0f972361605 42 ---------------------------END-OF-HEADER------------------------------
csyang2 1:c0f972361605 43 */
csyang2 1:c0f972361605 44
csyang2 1:c0f972361605 45 #ifndef SEGGER_H // Guard against multiple inclusion
csyang2 1:c0f972361605 46 #define SEGGER_H
csyang2 1:c0f972361605 47
csyang2 1:c0f972361605 48 #include <stdarg.h>
csyang2 1:c0f972361605 49 #include "Global.h" // Type definitions: U8, U16, U32, I8, I16, I32
csyang2 1:c0f972361605 50
csyang2 1:c0f972361605 51 #if defined(__cplusplus)
csyang2 1:c0f972361605 52 extern "C" { /* Make sure we have C-declarations in C++ programs */
csyang2 1:c0f972361605 53 #endif
csyang2 1:c0f972361605 54
csyang2 1:c0f972361605 55 /*********************************************************************
csyang2 1:c0f972361605 56 *
csyang2 1:c0f972361605 57 * Keywords/specifiers
csyang2 1:c0f972361605 58 *
csyang2 1:c0f972361605 59 **********************************************************************
csyang2 1:c0f972361605 60 */
csyang2 1:c0f972361605 61
csyang2 1:c0f972361605 62 #ifndef INLINE
csyang2 1:c0f972361605 63 #ifdef _WIN32
csyang2 1:c0f972361605 64 //
csyang2 1:c0f972361605 65 // Microsoft VC6 and newer.
csyang2 1:c0f972361605 66 // Force inlining without cost checking.
csyang2 1:c0f972361605 67 //
csyang2 1:c0f972361605 68 #define INLINE __forceinline
csyang2 1:c0f972361605 69 #else
csyang2 1:c0f972361605 70 #if (defined(__GNUC__))
csyang2 1:c0f972361605 71 //
csyang2 1:c0f972361605 72 // Force inlining with GCC
csyang2 1:c0f972361605 73 //
csyang2 1:c0f972361605 74 #define INLINE inline __attribute__((always_inline))
csyang2 1:c0f972361605 75 #elif (defined(__ICCARM__) || defined(__CC_ARM) || defined(__RX) || defined(__ICCRX__))
csyang2 1:c0f972361605 76 //
csyang2 1:c0f972361605 77 // Other known compilers.
csyang2 1:c0f972361605 78 //
csyang2 1:c0f972361605 79 #define INLINE inline
csyang2 1:c0f972361605 80 #else
csyang2 1:c0f972361605 81 //
csyang2 1:c0f972361605 82 // Unknown compilers.
csyang2 1:c0f972361605 83 //
csyang2 1:c0f972361605 84 #define INLINE
csyang2 1:c0f972361605 85 #endif
csyang2 1:c0f972361605 86 #endif
csyang2 1:c0f972361605 87 #endif
csyang2 1:c0f972361605 88
csyang2 1:c0f972361605 89 /*********************************************************************
csyang2 1:c0f972361605 90 *
csyang2 1:c0f972361605 91 * Function-like macros
csyang2 1:c0f972361605 92 *
csyang2 1:c0f972361605 93 **********************************************************************
csyang2 1:c0f972361605 94 */
csyang2 1:c0f972361605 95
csyang2 1:c0f972361605 96 #define SEGGER_COUNTOF(a) (sizeof((a))/sizeof((a)[0]))
csyang2 1:c0f972361605 97 #define SEGGER_MIN(a,b) (((a) < (b)) ? (a) : (b))
csyang2 1:c0f972361605 98 #define SEGGER_MAX(a,b) (((a) > (b)) ? (a) : (b))
csyang2 1:c0f972361605 99
csyang2 1:c0f972361605 100 #ifndef SEGGER_USE_PARA // Some compiler complain about unused parameters.
csyang2 1:c0f972361605 101 #define SEGGER_USE_PARA(Para) (void)Para // This works for most compilers.
csyang2 1:c0f972361605 102 #endif
csyang2 1:c0f972361605 103
csyang2 1:c0f972361605 104 /*********************************************************************
csyang2 1:c0f972361605 105 *
csyang2 1:c0f972361605 106 * Defines
csyang2 1:c0f972361605 107 *
csyang2 1:c0f972361605 108 **********************************************************************
csyang2 1:c0f972361605 109 */
csyang2 1:c0f972361605 110
csyang2 1:c0f972361605 111 #define SEGGER_PRINTF_FLAG_ADJLEFT (1 << 0)
csyang2 1:c0f972361605 112 #define SEGGER_PRINTF_FLAG_SIGNFORCE (1 << 1)
csyang2 1:c0f972361605 113 #define SEGGER_PRINTF_FLAG_SIGNSPACE (1 << 2)
csyang2 1:c0f972361605 114 #define SEGGER_PRINTF_FLAG_PRECEED (1 << 3)
csyang2 1:c0f972361605 115 #define SEGGER_PRINTF_FLAG_ZEROPAD (1 << 4)
csyang2 1:c0f972361605 116 #define SEGGER_PRINTF_FLAG_NEGATIVE (1 << 5)
csyang2 1:c0f972361605 117
csyang2 1:c0f972361605 118 /*********************************************************************
csyang2 1:c0f972361605 119 *
csyang2 1:c0f972361605 120 * Types
csyang2 1:c0f972361605 121 *
csyang2 1:c0f972361605 122 **********************************************************************
csyang2 1:c0f972361605 123 */
csyang2 1:c0f972361605 124
csyang2 1:c0f972361605 125 typedef struct {
csyang2 1:c0f972361605 126 char* pBuffer;
csyang2 1:c0f972361605 127 int BufferSize;
csyang2 1:c0f972361605 128 int Cnt;
csyang2 1:c0f972361605 129 } SEGGER_BUFFER_DESC;
csyang2 1:c0f972361605 130
csyang2 1:c0f972361605 131 typedef struct {
csyang2 1:c0f972361605 132 int CacheLineSize; // 0: No Cache. Most Systems such as ARM9 use a 32 bytes cache line size.
csyang2 1:c0f972361605 133 void (*pfDMB) (void); // Optional DMB function for Data Memory Barrier to make sure all memory operations are completed.
csyang2 1:c0f972361605 134 void (*pfClean) (void *p, unsigned NumBytes); // Optional clean function for cached memory.
csyang2 1:c0f972361605 135 void (*pfInvalidate)(void *p, unsigned NumBytes); // Optional invalidate function for cached memory.
csyang2 1:c0f972361605 136 } SEGGER_CACHE_CONFIG;
csyang2 1:c0f972361605 137
csyang2 1:c0f972361605 138 typedef struct SEGGER_SNPRINTF_CONTEXT_struct SEGGER_SNPRINTF_CONTEXT;
csyang2 1:c0f972361605 139
csyang2 1:c0f972361605 140 struct SEGGER_SNPRINTF_CONTEXT_struct {
csyang2 1:c0f972361605 141 void* pContext; // Application specific context.
csyang2 1:c0f972361605 142 SEGGER_BUFFER_DESC* pBufferDesc; // Buffer descriptor to use for output.
csyang2 1:c0f972361605 143 void (*pfFlush)(SEGGER_SNPRINTF_CONTEXT *); // Callback executed once the buffer is full. Callback decides if the buffer gets cleared to store more or not.
csyang2 1:c0f972361605 144 };
csyang2 1:c0f972361605 145
csyang2 1:c0f972361605 146 typedef struct {
csyang2 1:c0f972361605 147 void (*pfStoreChar) (SEGGER_BUFFER_DESC* pBufferDesc, SEGGER_SNPRINTF_CONTEXT* pContext, char c);
csyang2 1:c0f972361605 148 int (*pfPrintUnsigned) (SEGGER_BUFFER_DESC* pBufferDesc, SEGGER_SNPRINTF_CONTEXT* pContext, U32 v, unsigned Base, char Flags, int Width, int Precision);
csyang2 1:c0f972361605 149 int (*pfPrintInt) (SEGGER_BUFFER_DESC* pBufferDesc, SEGGER_SNPRINTF_CONTEXT* pContext, I32 v, unsigned Base, char Flags, int Width, int Precision);
csyang2 1:c0f972361605 150 } SEGGER_PRINTF_API;
csyang2 1:c0f972361605 151
csyang2 1:c0f972361605 152 typedef void (*SEGGER_pFormatter)(SEGGER_BUFFER_DESC* pBufferDesc, SEGGER_SNPRINTF_CONTEXT* pContext, const SEGGER_PRINTF_API* pApi, va_list* pParamList, char Lead, int Width, int Precision);
csyang2 1:c0f972361605 153
csyang2 1:c0f972361605 154 typedef struct SEGGER_PRINTF_FORMATTER {
csyang2 1:c0f972361605 155 struct SEGGER_PRINTF_FORMATTER* pNext; // Pointer to next formatter.
csyang2 1:c0f972361605 156 SEGGER_pFormatter pfFormatter; // Formatter function.
csyang2 1:c0f972361605 157 char Specifier; // Format specifier.
csyang2 1:c0f972361605 158 } SEGGER_PRINTF_FORMATTER;
csyang2 1:c0f972361605 159
csyang2 1:c0f972361605 160 /*********************************************************************
csyang2 1:c0f972361605 161 *
csyang2 1:c0f972361605 162 * Utility functions
csyang2 1:c0f972361605 163 *
csyang2 1:c0f972361605 164 **********************************************************************
csyang2 1:c0f972361605 165 */
csyang2 1:c0f972361605 166
csyang2 1:c0f972361605 167 void SEGGER_ARM_memcpy(void* pDest, const void* pSrc, int NumBytes);
csyang2 1:c0f972361605 168 void SEGGER_memcpy (void* pDest, const void* pSrc, int NumBytes);
csyang2 1:c0f972361605 169 void SEGGER_memxor (void* pDest, const void* pSrc, unsigned NumBytes);
csyang2 1:c0f972361605 170
csyang2 1:c0f972361605 171 void SEGGER_StoreChar (SEGGER_BUFFER_DESC* pBufferDesc, char c);
csyang2 1:c0f972361605 172 void SEGGER_PrintUnsigned(SEGGER_BUFFER_DESC* pBufferDesc, U32 v, unsigned Base, int Precision);
csyang2 1:c0f972361605 173 void SEGGER_PrintInt (SEGGER_BUFFER_DESC* pBufferDesc, I32 v, unsigned Base, int Precision);
csyang2 1:c0f972361605 174 //int SEGGER_snprintf (char* pBuffer, int BufferSize, const char* sFormat, ...);
csyang2 1:c0f972361605 175 int SEGGER_vsnprintf (char* pBuffer, int BufferSize, const char* sFormat, va_list ParamList);
csyang2 1:c0f972361605 176 int SEGGER_vsnprintfEx (SEGGER_SNPRINTF_CONTEXT* pContext, const char* sFormat, va_list ParamList);
csyang2 1:c0f972361605 177
csyang2 1:c0f972361605 178 int SEGGER_PRINTF_AddFormatter (SEGGER_PRINTF_FORMATTER* pFormatter, SEGGER_pFormatter pfFormatter, char c);
csyang2 1:c0f972361605 179 void SEGGER_PRINTF_AddDoubleFormatter(void);
csyang2 1:c0f972361605 180 void SEGGER_PRINTF_AddIPFormatter (void);
csyang2 1:c0f972361605 181 void SEGGER_PRINTF_AddHTMLFormatter (void);
csyang2 1:c0f972361605 182
csyang2 1:c0f972361605 183 #if defined(__cplusplus)
csyang2 1:c0f972361605 184 } /* Make sure we have C-declarations in C++ programs */
csyang2 1:c0f972361605 185 #endif
csyang2 1:c0f972361605 186
csyang2 1:c0f972361605 187 #endif // Avoid multiple inclusion
csyang2 1:c0f972361605 188
csyang2 1:c0f972361605 189 /*************************** End of file ****************************/