写在前面：
由于时间的不足与学习的碎片化，写博客变得有些奢侈。
但是对于记录学习（忘了以后能快速复习）的渴望一天天变得强烈。
既然如此
不如以天为单位，以时间为顺序，仅仅将博客当做一个知识学习的目录，记录笔者认为最通俗、最有帮助的资料，并尽量总结几句话指明本质，以便于日后搜索起来更加容易。


标题的结构如下：“类型”：“知识点”——“简短的解释”
部分内容由于保密协议无法上传。


点击此处进入学习日记的总目录

六十五、UCOSIII：User文件夹函数概览（uC-LIB文件夹）第二部分

4、uC-LIB文件夹

这些文件通常是 Micrium OS (UC/OS-III) 提供的库文件，用于提供一些常用的功能，如ASCII字符处理、数学计算、内存操作和字符串处理等。

这些文件的功能是为了提供一些常用的工具函数，使得开发者可以更方便地进行字符处理、数学计算、内存操作和字符串处理等操作，而无需自己实现这些功能。这样可以减少重复的工作量，并提高代码的可读性和可维护性。

uC-LIB文件夹

这些文件通常是 Micrium OS (UC/OS-III) 提供的库文件，用于提供一些常用的功能，如ASCII字符处理、数学计算、内存操作和字符串处理等。

这些文件的功能是为了提供一些常用的工具函数，使得开发者可以更方便地进行字符处理、数学计算、内存操作和字符串处理等操作，而无需自己实现这些功能。这样可以减少重复的工作量，并提高代码的可读性和可维护性。

lib_def.h文件

这个头文件定义了一些通用的宏和类型定义，用于在 Micrium OS 中实现通用的功能和数据结构。
可能包括了数据类型的定义、错误码的定义、布尔值的定义等。

1. NULL指针：

   • DEF_NULL：代表空指针。

2. 布尔值：

   • DEF_FALSE和DEF_TRUE：代表布尔值中的假和真。
   • DEF_NO和DEF_YES：另一种表示布尔值中的假和真。

3. 开关状态：

   • DEF_DISABLED和DEF_ENABLED：用于表示某个功能、模块或状态的禁用和启用。
   • DEF_INACTIVE和DEF_ACTIVE：表示某个状态的非激活和激活。
   • DEF_INVALID和DEF_VALID：表示某个数据或对象的无效和有效状态。
   • DEF_OFF和DEF_ON：表示开关或标志的关闭和打开状态。
   • DEF_CLR和DEF_SET：表示清除和设置某个标志或状态。

4. 函数返回值：

   • DEF_FAIL和DEF_OK：表示函数执行结果的失败和成功。

5. 位操作相关：

   • DEF_BIT_NONE：表示没有任何位被设置。
   • DEF_BIT_00到DEF_BIT_63：表示在对应位置上被设置的位。

6. 对齐相关：

   • DEF_ALIGN_MAX_NBR_OCTETS：表示数据对齐时的最大字节数。

7. 整数相关：

   • 定义了不同位数的整数类型（8位、16位、32位、64位）的最大值和最小值，以及位数相关的宏。

8. 时间相关：

   • 定义了与时间相关的常量，如每天的小时数、分钟数、秒数等，以及常见的时间单位换算。

lib_math.c / lib_math.h文件

这对文件提供了数学计算功能的实现和接口。
这里是uC/LIB库中的一个数学操作模块，主要包括了伪随机数生成器的实现。

Math_Init

• 参数：无
  返回值：无
• 描述：初始化数学模块，主要是设置伪随机数生成器的种子值。
  注意：使用了Math_RandSetSeed()函数将随机数生成器的种子值设置为默认值。

Math_RandSetSeed

• 参数：seed，初始的种子值。
  返回值：无
• 描述：设置当前伪随机数生成器的种子值。
  注意：这个函数要求在关键段中访问和更新Math_RandSeedCur以确保线程安全。

Math_Rand

• 参数：无
  返回值：下一个伪随机数。
• 描述：计算下一个伪随机数，通过调用Math_RandSeed()来实现。
  注意：与Math_RandSeed()函数一样，为了实现可重入性，Math_RandSeedCur必须在关键段中访问和更新。

Math_RandSeed

• 参数：seed，用于初始化伪随机数生成器的种子值。
  返回值：下一个伪随机数。
• 描述：根据给定的种子值计算下一个伪随机数。
  注意：这个函数是可重入的，因为它只使用了局部变量来计算下一个随机数。

lib_mem.c / lib_mem.h文件

这对文件提供了内存操作功能的实现和接口。
可能包括了内存拷贝、内存清零、内存比较等功能的实现。

Mem_Init

• 参数：无
  返回值：无
• 描述：初始化内存模块，主要是设置堆内存池的初始值。
  注意：该函数在编译选项中检查了内存分配功能是否启用，如果启用则进行内存池的初始化操作。

Mem_Clr

• 参数：
  pmem：要清零的内存区域的起始地址。
  size：要清零的内存区域的大小。
  返回值：无
• 描述：将指定内存区域的内容清零。
  注意：在清零之前进行了参数检查，确保传入的参数有效。

Mem_Set

• 参数：
  pmem：要设置的内存区域的起始地址。
  data_val：要设置的数据值。
  size：要设置的内存区域的大小。
  返回值：无
• 描述：将指定内存区域的内容设置为指定的数据值。
  注意：在设置内存之前进行了参数检查，确保传入的参数有效。

Mem_Copy

• 参数：
  pdest：目标内存区域的起始地址。
  psrc：源内存区域的起始地址。
  size：要复制的内存区域的大小。
  返回值：无
• 描述：将源内存区域的内容复制到目标内存区域。
  注意：在复制之前进行了参数检查，确保传入的参数有效，并且进行了内存对齐的优化处理。

Mem_Move

• 参数：
  pdest：目标内存地址，将数据移动到这里。
  psrc：源内存地址，从这里获取数据。
  size：要移动的数据大小（以字节为单位）。
  返回值：无
• 描述：将数据从源地址移动到目标地址，可以处理重叠的内存区域。如果源地址在目标地址之后，则直接调用Mem_Copy函数来完成数据复制。

Mem_Cmp

• 参数：
  p1_mem：第一个内存区域的起始地址。
  p2_mem：第二个内存区域的起始地址。
  size：要比较的数据大小（以字节为单位）。
  返回值：如果两个内存区域相等，则返回DEF_YES，否则返回DEF_NO。
• 描述：比较两个内存区域中的数据是否相等。该函数会逐个字节比较，如果遇到不相等的字节则立即返回。

Mem_HeapAlloc

• 参数：
  size：要分配的内存大小（以字节为单位）。
  align：内存对齐要求（以字节为单位）。
  poctets_reqd：用于返回额外所需内存大小的指针（如果分配失败）。
  perr：用于返回函数执行状态的指针。
  返回值：如果分配成功，则返回分配的内存块的起始地址，否则返回NULL。
• 描述：从堆中分配内存。该函数首先计算所需的内存大小，然后尝试从堆中分配内存。如果分配失败，则通过poctets_reqd返回额外所需的内存大小。

Mem_HeapGetSizeRem

• 参数：
  align：内存对齐要求（以字节为单位）。
  perr：用于返回函数执行状态的指针。
  返回值：堆中剩余可用内存的大小（以字节为单位）。
• 描述：获取堆中剩余可用内存的大小。该函数会考虑对齐要求，返回实际可用内存大小。

Mem_SegGetSizeRem

• 参数：
  pmem_pool：内存池指针。
  align：内存对齐要求（以字节为单位）。
  perr：用于返回函数执行状态的指针。
  返回值：指定内存池中剩余可用内存的大小（以字节为单位）。
• 描述：获取指定内存池中剩余可用内存的大小。函数会考虑对齐要求，返回实际可用内存大小。

Mem_PoolClr：

这个函数清除了pmem_pool指向的内存池结构。
它将MEM_POOL结构的所有字段初始化为它们的默认或初始值。
函数接受两个参数：pmem_pool，指向要清除的内存池结构的指针，和perr，一个指针，用于存储在操作过程中遇到的任何错误。

Mem_PoolCreate：

这个函数创建一个用于动态内存分配的内存池。
它初始化了一个内存池结构，并为池的块指针和块本身分配内存。
函数接受几个参数：
pmem_pool：要初始化的内存池结构的指针。
pmem_base_addr：内存池的基地址指针。如果为NULL，则函数从全局堆中分配内存。
mem_size：如果pmem_base_addr不为NULL，则是内存池的大小。
blk_nbr：要在池中分配的块数。
blk_size：每个块的大小。
blk_align：每个块的对齐要求。
poctets_reqd：一个指针，用于存储所需的额外八位字节的数量（如果有的话）。
perr：一个指针，用于存储在操作过程中遇到的任何错误。

Mem_PoolBlkGetNbrAvail：

这个函数检索内存池中可用块的数量。
它返回池中仍然可以分配的块数。
函数接受两个参数：
pmem_pool：指向内存池结构的指针。
perr：一个指针，用于存储在操作过程中遇到的任何错误。

Mem_PoolBlkGet

• 功能：从内存池中获取一个块。
• 参数：
  pmem_pool：指向内存池结构的指针。
  size：要获取的块的大小。
  perr：一个指针，用于存储在操作过程中遇到的任何错误。

Mem_PoolBlkGetUsedAtIx

• 功能：根据索引从内存池中获取一个已使用的块。
• 参数：
  pmem_pool：指向内存池结构的指针。
  used_ix：要获取的已使用块的索引。
  perr：一个指针，用于存储在操作过程中遇到的任何错误。

Mem_PoolBlkFree

• 功能：释放内存池中的一个块。
• 参数：
  pmem_pool：指向内存池结构的指针。
  pmem_blk：要释放的块的指针。
  perr：一个指针，用于存储在操作过程中遇到的任何错误。

Mem_PoolBlkIxGet

• 功能：获取内存块在内存池中的索引。
• 参数：
  pmem_pool：指向内存池结构的指针。
  pmem_blk：要查询的块的指针。
  perr：一个指针，用于存储在操作过程中遇到的任何错误。

Mem_PoolBlkIsValidAddr

• 功能：检查给定的内存块地址是否在指定内存池的有效范围内。
• 参数：
  pmem_pool：指向内存池结构的指针。
  pmem_blk：要检查的内存块的地址。

Mem_SegCalcTotSize

• 功能：计算内存段的总大小，用于分配给内存池。
• 参数：
  pmem_addr：内存段的起始地址。
  blk_nbr：内存块的数量。
  blk_size：每个内存块的大小。
  blk_align：内存块的对齐要求。

Mem_SegAlloc

• 功能：在内存段中分配一块指定大小和对齐要求的内存块。
• 参数：
  pmem_pool：指向内存池结构的指针。
  size：要分配的内存块的大小。
  align：内存块的对齐要求。