Merge pull request 'om拿下' (#23) from gonghao_branch into main

src/kernel_liteos_a/kernel/base/om/los_err.c

@@ -31,9 +31,29 @@
 
 #include "los_err.h"
 
+/**
+基本概念
+	错误处理指程序运行错误时，调用错误处理模块的接口函数，上报错误信息，并调用注册的钩子函数
+	进行特定处理，保存现场以便定位问题。通过错误处理，可以控制和提示程序中的非法输入，防止程序崩溃。
 
-LITE_OS_SEC_BSS STATIC LOS_ERRORHANDLE_FUNC g_errHandleHook = NULL;
+运作机制
+	错误处理是一种机制，用于处理异常状况。当程序出现错误时，会显示相应的错误码。
+	此外，如果注册了相应的错误处理函数，则会执行这个函数。
 
+系统中只有一个错误处理的钩子函数。当多次注册钩子函数时，最后一次注册的钩子函数会覆盖前一次注册的函数
+ */
+
+LITE_OS_SEC_BSS STATIC LOS_ERRORHANDLE_FUNC g_errHandleHook = NULL;///< 错误接管钩子函数
+
+/**
+ * @brief 调用钩子函数，处理错误
+ * @param fileName 存放错误日志的文件名,系统内部调用时，入参为"os_unspecific_file" 
+ * @param lineNo 发生错误的代码行号系统内部调用时，若值为0xa1b2c3f8，表示未传递行号
+ * @param errorNo 错误码
+ * @param paraLen 入参para的长度系统内部调用时，入参为0
+ * @param para 错误标签系统内部调用时，入参为NULL
+ * @return LITE_OS_SEC_TEXT_INIT 
+ */
 LITE_OS_SEC_TEXT_INIT UINT32 LOS_ErrHandle(CHAR *fileName, UINT32 lineNo, UINT32 errorNo,
                                            UINT32 paraLen, VOID *para)
 {
@@ -43,7 +63,7 @@ LITE_OS_SEC_TEXT_INIT UINT32 LOS_ErrHandle(CHAR *fileName, UINT32 lineNo, UINT32
 
     return LOS_OK;
 }
-
+///设置钩子函数，处理错误
 LITE_OS_SEC_TEXT_INIT VOID LOS_SetErrHandleHook(LOS_ERRORHANDLE_FUNC fun)
 {
     g_errHandleHook = fun;