add more comments

2025-11-18 00:40:02 +08:00
parent 9b3e035b75
commit 7e463e56ad
48 changed files with 2334 additions and 497 deletions
@@ -1,3 +1,12 @@
+/****************************************************************************
+文件名称   : chrg_south.h
+完成日期   : 
+当前版本号 : V1.0
+主要功能   : 实现南向通信交互，包括接收命令解析，发送请求命令，切换通路。以独立线程处理。
+版本历史   : 创建原始版本
+说明      : 
+******************************************************************************/
+
 #ifndef __CHRG_SOUTH_H__
 #define __CHRG_SOUTH_H__

@@ -39,11 +48,34 @@ struct chrg_south_t {

 extern struct chrg_south_t chrgsouth;

-// 南向通道选择
+/*****************************************************************
+函数名称： chrg_south_switch
+函数描述： 南向通道选择
+输入参数： ch: 南向通道
+输出参数： -
+返回说明：  <0: 错误
+其它说明： -
+*****************************************************************/
 extern int chrg_south_switch (eIDX_SOU_CH ch);

+/*****************************************************************
+函数名称： chrg_south_send
+函数描述： 南向数据发送
+输入参数： *data: 数据  length: 数据长度
+输出参数： -
+返回说明：  <0: 错误 >0:发送数据长度
+其它说明： -
+*****************************************************************/
 extern int chrg_south_send (rt_uint8_t *data, rt_size_t length);

+/*****************************************************************
+函数名称： chrg_south_thread_entry
+函数描述： 南向通道数据接收线程体
+输入参数： *data: 本线程信息
+输出参数： -
+返回说明： -
+其它说明： -
+*****************************************************************/
 extern void chrg_south_thread_entry (void *data);