lib: vc8000nanoe: add trace support

Add debug trace support.

Signed-off-by: Hugues Fruchet <[email protected]>

Author: hfruchet-st

lib/vc8000nanoe/CMakeLists.txt

@@ -4,6 +4,7 @@
 zephyr_library()
 
 zephyr_library_compile_definitions(H1_INTERNAL)
+zephyr_library_compile_definitions(H1_HAVE_ENCDEBUG_H)
 zephyr_include_directories(inc)
 zephyr_include_directories(source/common)
 zephyr_include_directories(source/h264)

lib/vc8000nanoe/inc/encdebug.h

@@ -0,0 +1,74 @@
+/*
+ * Copyright (c) 2025 STMicroelectronics.
+ *
+ ********************************************************************************
+ *
+ * This software is distributed under the terms of
+ * BSD-3-Clause. The following provisions apply :
+ *
+ ********************************************************************************
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ * list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its contributors
+ * may be used to endorse or promote products derived from this software without
+ * specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ ********************************************************************************
+ *
+ *  Description : Encoder debug definitions
+ *
+ ********************************************************************************
+ */
+
+#ifndef __ENC_DEBUG_H__
+#define __ENC_DEBUG_H__
+
+#ifdef CONFIG_ASSERT
+#define STR(x) #x
+#define ASSERT(expr)                                                      \
+	do {                                                              \
+		if (!(expr)) {                                            \
+			EWLassert((bool)(expr), STR(expr), __FILE__, __LINE__);   \
+		}                                                         \
+	} while (false)
+#else
+#define ASSERT(expr)
+#endif
+
+#if CONFIG_VC8000NANOE_LOG_LEVEL >= 4 /* LOG_LEVEL_DBG */
+#define DEBUG_PRINT(s) EWLtrace(s);
+#define COMMENT(s) EWLtrace(s);
+#define APITRACE(s) EWLtrace(s);
+#define APITRACEPARAM(p,v) EWLtraceparam("  %s: %d\n",p,(unsigned int)(v));
+#define APITRACEPARAMX(p,v) EWLtraceparam("  %s: 0x%x\n",p,(unsigned int)(v));
+#define TRACE_BIT_STREAM(v,n)
+#else
+#define DEBUG_PRINT(s)
+#define COMMENT(s)
+#define APITRACE(s)
+#define APITRACEPARAM(p,v)
+#define APITRACEPARAMX(p,v)
+#define TRACE_BIT_STREAM(v,n)
+#endif
+
+#endif

lib/vc8000nanoe/inc/ewl.h

@@ -250,6 +250,11 @@ extern u32 (*pollInputLineBufTestFunc)(void);
 /* Get the base address of on-chip sram used for input MB line buffer. */
 i32 EWLGetInputLineBufferBase(const void *instance, EWLLinearMem_t * info);
 
+/* Debug & trace */
+void EWLassert(bool expr, const char *str_expr, const char *file, unsigned int line);
+void EWLtrace(const char *s);
+void EWLtraceparam(const char *fmt, const char *param, unsigned int val);
+
 #ifdef __cplusplus
 }
 #endif

lib/vc8000nanoe/source/h264/H264EncApi.c

@@ -115,9 +115,13 @@
 #define APITRACEPARAM(str, val) \
   { char tmpstr[255]; sprintf(tmpstr, "  %s: %d", str, (int)val); H264EncTrace(tmpstr); }
 #else
+#ifndef APITRACE
 #define APITRACE(str)
+#endif
+#ifndef APITRACEPARAM
 #define APITRACEPARAM(str, val)
 #endif
+#endif
 
 /*------------------------------------------------------------------------------
     4. Local function prototypes

lib/vc8000nanoe/source/h264/H264Init.c

@@ -76,8 +76,10 @@
 #ifdef H264ENC_TRACE
 #define APITRACE(str) H264EncTrace(str)
 #else
+#ifndef APITRACE
 #define APITRACE(str)
 #endif
+#endif
 
 /*------------------------------------------------------------------------------
     4. Local function prototypes