Merge pull request 'limited' (#32) from zhoumingyang_branch into main

src/kernel_liteos_a/kernel/base/misc/kill_shellcmd.c

@@ -48,6 +48,23 @@
 #include "shell.h"
 #endif
 
+/********************************************* 
+命令功能
+命令用于发送特定信号给指定进程。
+
+命令格式
+kill [signo | -signo] [pid]
+
+参数		参数说明		取值范围
+signo	信号ID	[1,30]
+pid		进程ID	[1,MAX_INT]
+
+须知： signo有效范围为[0,64]，建议取值范围为[1,30]，其余为保留内容。
+
+使用指南
+必须指定发送的信号编号及进程号。
+进程编号取值范围根据系统配置变化，例如系统最大支持pid为256，则取值范围缩小为[1-256]。
+*********************************************/
 LITE_OS_SEC_TEXT_MINOR VOID OsPrintKillUsage(VOID)
 {
     PRINTK("\nkill: usage: kill [sigspec] [pid]\n");

src/kernel_liteos_a/kernel/base/misc/los_misc.c

@@ -31,7 +31,10 @@
 
 #include "los_task_pri.h"
 
-
+// 这个函数接受两个参数，一个是地址（addr），另一个是对齐边界（boundary）。它返回一个对齐后的地址。
+// 这个函数首先检查地址加上边界再减去1是否大于地址，如果是，
+// 就返回地址加上边界再减去1然后与~((UINTPTR)(boundary - 1))进行位与运算的结果，
+// 否则就返回地址与~((UINTPTR)(boundary - 1))进行位与运算的结果。这实际上是在对地址进行对齐。
 LITE_OS_SEC_TEXT UINTPTR LOS_Align(UINTPTR addr, UINT32 boundary)
 {
     if ((addr + boundary - 1) > addr) {
@@ -41,13 +44,14 @@ LITE_OS_SEC_TEXT UINTPTR LOS_Align(UINTPTR addr, UINT32 boundary)
     }
 }
 
+
 LITE_OS_SEC_TEXT_MINOR VOID LOS_Msleep(UINT32 msecs)
 {
     UINT32 interval;
-
+    // 这个函数接受一个参数，毫秒数（msecs）。这个函数首先检查毫秒数是否为0，如果是，就将间隔设置为0。
     if (msecs == 0) {
         interval = 0;
-    } else {
+    // } else { 否则，它将毫秒数转换为tick数（可能是操作系统的时间单位），如果转换后的间隔为0，就将间隔设置为1。然后，它调用LOS_TaskDelay函数来延迟指定的间隔。
         interval = LOS_MS2Tick(msecs);
         if (interval == 0) {
             interval = 1;

src/kernel_liteos_a/kernel/base/misc/los_stackinfo.c

@@ -37,7 +37,31 @@
 #include "shcmd.h"
 #include "shell.h"
 #endif
-
+/**
+ * @file los_stackinfo.c
+ * @brief 栈内容
+ * @verbatim
+    @note_pic OsExcStackInfo 各个CPU栈布局图,其他栈也是一样,CPU各核硬件栈都是紧挨着
+    __undef_stack(SMP)
+    +-------------------+ <--- cpu1 top
+    |                   |
+    |  CPU core1        |
+    |                   |
+    +--------------------<--- cpu2 top
+    |                   |
+    |  cpu core 2       |
+    |                   |
+    +--------------------<--- cpu3 top
+    |                   |
+    |  cpu core 3       |
+    |                   |
+    +--------------------<--- cpu4 top
+    |                   |
+    |  cpu core 4       |
+    |                   |
+    +-------------------+
+ * @endverbatim
+ */
 
 const StackInfo *g_stackInfo = NULL;    ///< CPU所有工作模式的栈信息
 UINT32 g_stackNum;  ///< CPU所有工作模式的栈数量