分享 在任何媒介以任何形式复制、发行本文档
演绎 修改、转换或以本文档为基础进行创作
只要你遵守许可协议条款,许可人就无法收回你的这些权利
署名 您必须提供适当的证书,提供一个链接到许可证,并指示是否作出更改。您可以以任何合理的方式这样做,但不是以任何方式表明,许可方赞同您或您的使用。
非商业性使用 您不得将本文档用于商业目的。
相同方式共享 如果您的修改、转换,或以本文档为基础进行创作,仅得依本素材的授权条款来散布您的贡献作品。
没有附加限制 您不能增设法律条款或科技措施,来限制别人依授权条款本已许可的作为。
当您使用本素材中属于公众领域的元素,或当法律有例外或限制条款允许您的使用,则您不需要遵守本授权条款。
未提供保证。本授权条款未必能完全提供您预期用途所需要的所有许可。例如:形象权、隐私权、著作人格权等其他权利,可能限制您如何使用本素材。
为了方便用户理解,这是协议的概述. 可以访问网址了解完整协议内容。
本文档介绍Huawei LiteOS的体系结构,并介绍如何进行开发和调试。
本文档主要适用于Huawei LiteOS的开发者,主要适用于以下对象:
在本文中可能出现下列标志,它们所代表的含义如下。
修改记录累积了每次文档更新的说明,最新版本的文档包含以前所有文档版本的更新内容。
Huawei LiteOS基础内核是最精简的Huawei LiteOS操作系统代码,包括任务管理、内存管理、时间管理、通信机制、中断管理、队列管理、事件管理、定时器等操作系统基础组件,可以单独运行。
超小内核,基础内核体积可以裁剪至不到10K。
支持动态加载、分散加载。
提供任务的创建、删除、延迟、挂起、恢复等功能,以及锁定和解锁任务调度。支持任务按优先级高低的抢占调度及同优先级时间片轮转调度。
提供中断、定时器等功能。
提供事件、消息队列功能。
从系统的角度看,任务是竞争系统资源的最小运行单元。任务可以使用或等待CPU、使用内存空间等系统资源,并独立于其它任务运行。
Huawei LiteOS的任务模块可以给用户提供多个任务,实现了任务之间的切换和通信,帮助用户管理业务程序流程。这样用户可以将更多的精力投入到业务功能的实现中。
Huawei LiteOS是一个支持多任务的操作系统。在Huawei LiteOS中,一个任务表示一个线程。
Huawei LiteOS中的任务是抢占式调度机制,同时支持时间片轮转调度方式。
高优先级的任务可打断低优先级任务,低优先级任务必须在高优先级任务阻塞或结束后才能得到调度。
Huawei LiteOS的任务一共有32个优先级(0-31),最高优先级为0,最低优先级为31。
Huawei LiteOS系统中的每一任务都有多种运行状态。系统初始化完成后,创建的任务就可以在系统中竞争一定的资源,由内核进行调度。
任务状态通常分为以下四种:
任务创建后进入就绪态,发生任务切换时,就绪列表中最高优先级的任务被执行,从而进入运行态,但此刻该任务依旧在就绪列表中。
正在运行的任务发生阻塞(挂起、延时、获取互斥锁、读消息、读信号量等待等)时,该任务会从就绪列表中删除,任务状态由运行态变成阻塞态,然后发生任务切换,运行就绪列表中剩余最高优先级任务。
阻塞态→就绪态(阻塞态→运行态):
阻塞的任务被恢复后(任务恢复、延时时间超时、读信号量超时或读到信号量等),此时被恢复的任务会被加入就绪列表,从而由阻塞态变成就绪态;此时如果被恢复任务的优先级高于正在运行任务的优先级,则会发生任务切换,将该任务由就绪态变成运行态。
任务也有可能在就绪态时被阻塞(挂起),此时任务状态会由就绪态转变为阻塞态,该任务从就绪列表中删除,不会参与任务调度,直到该任务被恢复。
有更高优先级任务创建或者恢复后,会发生任务调度,此刻就绪列表中最高优先级任务变为运行态,那么原先运行的任务由运行态变为就绪态,依然在就绪列表中。
运行中的任务运行结束,内核自动将此任务删除,任务状态由运行态变为退出态。
阻塞的任务调用删除接口,任务状态由阻塞态变为退出态。
任务ID,在任务创建时通过参数返回给用户,作为任务的一个非常重要的标识。用户可以通过任务ID对指定任务进行任务挂起、任务恢复、查询任务名等操作。
优先级表示任务执行的优先顺序。任务的优先级决定了在发生任务切换时即将要执行的任务。在就绪列表中的最高优先级的任务将得到执行。
每个新任务得到调度后将执行的函数。该函数由用户实现,在任务创建时,通过任务创建结构体指定。
每一个任务都含有一个任务控制块(TCB)。TCB包含了任务上下文栈指针(stack pointer)、任务状态、任务优先级、任务ID、任务名、任务栈大小等信息。TCB可以反映出每个任务运行情况。
每一个任务都拥有一个独立的栈空间,我们称为任务栈。栈空间里保存的信息包含局部变量、寄存器、函数参数、函数返回地址等。任务在任务切换时会将切出任务的上下文信息保存在自身的任务栈空间里面,以便任务恢复时还原现场,从而在任务恢复后在切出点继续开始执行。
任务在运行过程中使用到的一些资源,如寄存器等,我们称为任务上下文。当这个任务挂起时,其他任务继续执行,在任务恢复后,如果没有把任务上下文保存下来,有可能任务切换会修改寄存器中的值,从而导致未知错误。
因此,Huawei LiteOS在任务挂起的时候会将本任务的任务上下文信息,保存在自己的任务栈里面,以便任务恢复后,从栈空间中恢复挂起时的上下文信息,从而继续执行被挂起时被打断的代码。
任务切换包含获取就绪列表中最高优先级任务、切出任务上下文保存、切入任务上下文恢复等动作。
Huawei LiteOS任务管理模块提供任务创建、任务删除、任务延时、任务挂起和任务恢复、更改任务优先级、锁任务调度和解锁任务调度、根据任务控制块查询任务ID、根据ID查询任务控制块信息功能。
在任务模块初始化时,系统会先申请任务控制块需要的内存空间,如果系统可用的内存空间小于其所需要的内存空间,任务模块就会初始化失败。如果任务初始化成功,则系统对任务控制块内容进行初始化。
用户创建任务时,系统会将任务栈进行初始化,预置上下文。此外,系统还会将“任务入口函数”地址放在相应位置。这样在任务第一次启动进入运行态时,将会执行“任务入口函数”。
任务创建后,内核可以执行锁任务调度,解锁任务调度,挂起,恢复,延时等操作,同时也可以设置任务优先级,获取任务优先级。任务结束的时候,则进行当前任务自删除操作。
Huawei LiteOS 系统中的任务管理模块为用户提供下面几种功能。
创建任务,并使该任务进入suspend状态,并不调度 |
创建任务,并使该任务进入ready状态,并调度 |
显式放权,调整指定优先级的任务调度顺序 |
监控所有任务,获取所有任务的信息 |
获取即将被调度的任务的ID |
以创建任务为例,讲解开发流程。
配置LOSCFG_BASE_CORE_TSK_DEFAULT_STACK_SIZE默认任务栈大小,用户根据自己的需求进行配置,在用户创建任务时,可以进行针对性设置。
Huawei LiteOS任务的状态由内核自动维护,对用户不可见,不需要用户去操作。
对任务存在失败可能性的操作,包括创建任务、删除任务、挂起任务、恢复任务、延时任务等等,均需要返回对应的错误码,以便快速定位错误原因。
等待这个任务被恢复后,再去尝试挂起这个任务 | |
不允许操作软件定时器任务 | 用户不要试图去操作软件定时器任务的设置 |
中断期间,进行任务延时 | 等待退出中断后再进行延时操作 |
任务被锁的状态下,进行延时 | 等待解锁任务之后再进行延时操作 |
将被排入行程的任务是无效的 | |
没有或者仅有一个可用任务能进行行程安排 | |
没有空闲的任务控制块可用 | |
任务的钩子函数数量超过界限 | |
检查任务ID,不要试图操作IDLE任务 | |
将被挂起的任务处于被锁状态 | 等待任务解锁后再尝试挂起任务 |
创建一个IDLE任务后执行任务转换 | |
不允许挂起软件定时器任务 | 检查任务ID, 不要试图挂起软件定时器任务 |
错误码定义: 错误码是一个32位的存储单元,31~24位表示错误等级,23~16位表示错误码标志,15~8位代表错误码所属模块,7~0位表示错误码序号,如下
错误码序号 0x16、0x1c、0x0b,未被定义,不可用。
下面的示例介绍任务的基本操作方法,包含任务创建、任务延时、任务锁与解锁调度、挂起和恢复、查询当前任务PID、根据PID查询任务信息等操作,阐述任务优先级调度的机制以及各接口的应用。
编译运行得到的结果为:
内存管理模块管理系统的内存资源,它是操作系统的核心模块之一。主要包括内存的初始化、分配以及释放。
在系统运行过程中,内存管理模块通过对内存的申请/释放操作,来管理用户和OS对内存的使用,使内存的利用率和使用效率达到最优,同时最大限度地解决系统的内存碎片问题。
Huawei LiteOS的内存管理分为静态内存管理和动态内存管理,提供内存初始化、分配、释放等功能。
动态内存管理,即在内存资源充足的情况下,从系统配置的一块比较大的连续内存(内存池),根据用户需求,分配任意大小的内存块。当用户不需要该内存块时,又可以释放回系统供下一次使用。
与静态内存相比,动态内存管理的好处是按需分配,缺点是内存池中容易出现碎片。
DLINK动态内存管理结构如下图所示:
第一部分: 堆内存(也称内存池)的起始地址及堆区域总大小。
第二部分: 本身是一个数组,每个元素是一个双向链表,所有free节点的控制头都会被分类挂在这个数组的双向链表中。
2min+2的free节点,依次类推第n个双向链表存储的是所有size为2min+n-1<size< 2min+n的free节点。每次申请内存的时候,会从这个数组检索最合适大小的free节点,进行分配内存。每次释放内存时,会将该片内存作为free节点存储至这个数组,以便下次再利用。
第三部分: 占用内存池极大部分的空间,是用于存放各节点的实际区域。以下是LOS\_MEM\_DYN\_NODE
节点结构体申明以及简单介绍:
LiteOS的动态内存分配支持最佳适配算法,即BEST LITTLE,每次分配时选择内存池中最小最适合的内存块进行分配。LiteOS动态内存管理在最佳适配算法的基础上加入了SLAB机制,用于分配固定大小的内存块,进而减小产生内存碎片的可能性。
初始化内存管理时,首先初始化内存池,然后在初始化后的内存池中按照最佳适配算法申请4个SLAB CLASS,再逐个按照SLAB内存管理机制初始化4个SLAB CLASS。
每次申请内存时,先在满足申请大小的最佳SLAB CLASS中申请,(比如用户申请20字节内存,就在SLAB块大小为32字节的SLAB CLASS中申请),如果申请成功,就将SLAB内存块整块返回给用户,释放时整块回收。如果满足条件的SLAB CLASS中已无可以分配的内存块,则继续向内存池按照最佳适配算法申请。需要注意的是,如果当前的SLAB CLASS中无可用SLAB块了,则直接向内存池申请,而不会继续向有着更大SLAB块空间的SLAB CLASS申请。
释放内存时,先检查释放的内存块是否属于SLAB CLASS,如果是SLAB CLASS的内存块,则还回对应的SLAB CLASS中,否则还回内存池中。
静态内存实质上是一块静态数组,静态内存池内的块大小在初始化时设定,初始化后块大小不可变更。
静态内存池由一个控制块和若干相同大小的内存块构成。控制块位于内存池头部,用于内存块管理。内存块的申请和释放以块大小为粒度。
内存管理的主要工作是动态的划分并管理用户分配好的内存区间。
动态内存管理主要是在用户需要使用大小不等的内存块的场景中使用。
当用户需要分配内存时,可以通过操作系统的动态内存申请函数索取指定大小内存块,一旦使用完毕,通过动态内存释放函数归还所占用内存,使之可以重复使用。
Huawei LiteOS系统中的动态内存管理模块为用户提供下面几种功能,具体的API详见接口手册。
初始化一块指定的动态内存池,大小为size。 | |
从指定动态内存池中申请size长度的内存。 | |
按size大小重新分配内存块,并保留原内存块内容。 | |
从指定动态内存池中申请长度为size且地址按boundary字节对齐的内存。 | |
获取指定内存池的统计信息 | |
查看内存池中最大可用空闲块 | 获取指定内存池的最大可用空闲块 |
OS_SYS_MEM_ADDR:系统动态内存池起始地址,一般不需要修改。
OS_SYS_MEM_SIZE:系统动态内存池大小,以byte为单位,系统默认分配DDR后未使用的空间。
LOSCFG_BASE_MEM_NODE_INTEGRITY_CHECK:内存越界检测开关,默认关闭。打开后,每次申请动态内存时执行动态内存块越界检查;每次释放静态内存时执行静态内存块越界检查。
初始一个内存池后如图,生成一个 EndNode,并且剩余的内存全部被标记为FreeNode节点。
EndNode作为内存池末尾的节点,size为0。
判断动态内存池中是否存在申请量大小的空间,若存在,则划出一块内存块,以指针形式返回,若不存在,返回NULL。
调用三次LOS_MemAlloc函数可以创建三个节点,假设名称分别为UsedA,UsedB,UsedC,大小分别为sizeA,sizeB,sizeC。因为刚初始化内存池的时候只有一个大的FreeNode,所以这些内存块是从这个FreeNode中切割出来的。
当内存池中存在多个FreeNode的时候进行malloc,将会适配最合适大小的FreeNode用来新建内存块,减少内存碎片。若新建的内存块不等于被使用的FreeNode的大小,则在新建内存块后,多余的内存又会被标记为一个新的FreeNode。
回收内存块,供下一次使用。
OS_SYS_MEM_ADDR:系统动态内存池起始地址,需要用户指定。
OS_SYS_MEM_SIZE:系统动态内存池大小,以byte为单位,需要用户正确计算。
SLAB_MEM_COUNT:该配置位于内核中,一般不需要改动,表示SLAB CLASS的数量,目前内核初始化为4。
SLAB_MEM_ALLOCATOR_SIZE:该配置位于内核中,一般不需要改动,表示每个SLAB CLASS的最大可分配的块的总空间。
调用LOS_MemInit函数初始化用户指定的动态内存池,若用户使能了SLAB机制并且内存池中的可分配内存大于SLAB需要的最小内存,则会进一步初始化SLAB CLASS。
调用LOS_MemAlloc函数从指定的内存池中申请指定大小的内存块,申请时内存管理先向SLAB CLASS申请,申请失败后继续向堆内存空间申请,最后将申请结果返回给用户。在向堆内存空间申请时,会存在内存块的切分。
调用LOS_MemFree函数向指定的动态内存池释放指定的内存块,释放时会先判断该内存块是否属于SLAB CLASS,若属于,则将该内存块还回SLAB CLASS。否则,向堆内存空间释放内存块。在向堆内存空间释放时,会存在内存块的合并。
Huawei LiteOS运行期间,用户需要频繁的使用内存资源,而内存资源有限,必须确保将有限的内存资源分配给急需的程序,同时释放不用的内存。
通过Huawei LiteOS内存管理模块可以保证高效、正确的申请、释放内存。
当用户需要使用固定长度的内存时,可以使用静态内存分配的方式获取内存,一旦使用完毕,通过静态内存释放函数归还所占用内存,使之可以重复使用。
Huawei LiteOS的静态内存管理主要为用户提供以下功能。
初始化一个静态内存池,设定其起始地址、总大小及每个块大小 |
获取静态内存池的统计信息 |
本节介绍使用静态内存的典型场景开发流程。
Huawei LiteOS运行期间,用户需要频繁的使用内存资源,而内存资源有限,必须确保将有限的内存资源分配给急需的程序,同时释放不用的内存。
通过内存管理模块可以保证正确且高效的申请释放内存。
中断是指出现需要时,CPU暂停执行当前程序,转而执行新程序的过程。即在程序运行过程中,系统出现了一个必须由CPU立即处理的事务。此时,CPU暂时中止当前程序的执行转而处理这个事务,这个过程就叫做中断。
众多周知,CPU的处理速度比外设的运行速度快很多,外设可以在没有CPU介入的情况下完成一定的工作,但某些情况下需要CPU为其做一定的工作。
通过中断机制,在外设不需要CPU介入时,CPU可以执行其它任务,而当外设需要CPU时通过产生中断信号使CPU立即中断当前任务来响应中断请求。这样可以使CPU避免把大量时间耗费在等待、查询外设状态的操作上,因此将大大提高系统实时性以及执行效率。
与中断相关的硬件可以划分为三类:设备、中断控制器、CPU本身。
设备:发起中断的源,当设备需要请求CPU时,产生一个中断信号,该信号连接至中断控制器。
中断控制器:中断控制器是CPU众多外设中的一个,它一方面接收其它外设中断引脚的输入,另一方面,它会发出中断信号给CPU。可以通过对中断控制器编程实现对中断源的优先级、触发方式、打开和关闭源等设置操作。常用的中断控制器有VIC(Vector Interrupt Controller)和GIC(General Interrupt Controller),在ARM
CPU:CPU会响应中断源的请求,中断当前正在执行的任务,转而执行中断处理程序。
中断号:每个中断请求信号都会有特定的标志,使得计算机能够判断是哪个设备提出的中断请求,这个标志就是中断号。
中断请求:“紧急事件”需向CPU提出申请(发一个电脉冲信号),要求中断,及要求CPU暂停当前执行的任务,转而处理该“紧急事件”,这一申请过程称为中断申请。
中断优先级:为使系统能够及时响应并处理所有中断,系统根据中断时间的重要性和紧迫程度,将中断源分为若干个级别,称作中断优先级。Huawei LiteOS支持中断控制器的中断优先级及中断嵌套,同时中断管理未对优先级和嵌套进行限制。
中断处理程序:当外设产生中断请求后,CPU暂停当前的任务,转而响应中断申请,即执行中断处理程序。
中断触发:中断源发出并送给CPU控制信号,将接口卡上的中断触发器置“1”,表明该中断源产生了中断,要求CPU去响应该中断,CPU暂停当前任务,执行相应的中断处理程序。
中断触发类型:外部中断申请通过一个物理信号发送到NVIC,可以是电平触发或边沿触发。
中断向量:中断服务程序的入口地址。
中断向量表:存储中断向量的存储区,中断向量与中断号对应,中断向量在中断向量表中按照中断号顺序存储。
当有中断请求产生时,CPU暂停当前的任务,转而去响应外设请求。根据需要,用户通过中断申请,注册中断处理程序,可以指定CPU响应中断请求时所执行的具体操作。
Huawei LiteOS 系统中的中断模块为用户提供下面几种功能。
硬中断创建,注册硬中断处理程序 |
恢复到关中断之前的状态 |
目前的中断测试代码提供了基本框架,中断硬件初始化代码请用户根据开发板硬件情况在Example_Exti0_Init()函数中自行实现。
队列又称消息队列,是一种常用于任务间通信的数据结构,实现了接收来自任务或中断的不固定长度的消息,并根据不同的接口选择传递消息是否存放在自己空间。任务能够从队列里面读取消息,当队列中的消息是空时,挂起读取任务;当队列中有新消息时,挂起的读取任务被唤醒并处理新消息。
用户在处理业务时,消息队列提供了异步处理机制,允许将一个消息放入队列,但并不立即处理它,同时队列还能起到缓冲消息作用。
Huawei LiteOS中使用队列数据结构实现任务异步通信工作,具有如下特性:
每个队列控制块中都含有队列状态,表示该队列的使用情况:
创建队列时,根据用户传入队列长度和消息节点大小来开辟相应的内存空间以供该队列使用,返回队列ID。
在队列控制块中维护一个消息头节点位置Head和一个消息尾节点位置Tail来表示当前队列中消息存储情况。Head表示队列中被占用消息的起始位置。Tail表示队列中被空闲消息的起始位置。刚创建时Head和Tail均指向队列起始位置。
写队列时,根据Tail找到被占用消息节点末尾的空闲节点作为数据写入对象。如果Tail已经指向队列尾则采用回卷方式。根据usWritableCnt判断队列是否可以写入,不能对已满(usWritableCnt为0)队列进行写队列操作。
读队列时,根据Head找到最先写入队列中的消息节点进行读取。如果Head已经指向队列尾则采用回卷方式。根据usReadableCnt判断队列是否有消息读取,对全部空闲(usReadableCnt为0)队列进行读队列操作会引起任务挂起。
删除队列时,根据传入的队列ID寻找到对应的队列,把队列状态置为未使用,释放原队列所占的空间,对应的队列控制头置为初始状态。
队列读写数据操作示意图
读取指定队列中的数据。(buff里存放的是队列节点的地址) |
向指定队列写数据。(写入队列节点中的是buff的地址) |
读取指定队列中的数据。(buff里存放的是队列节点中的数据) |
向指定队列写数据。(写入队列节点中的是buff中的数据) |
向指定队列的头部写数据 |
使用队列模块的典型流程如下:
对队列存在失败可能性的操作,包括创建队列、删除队列等等,均需要返回对应的错误码,以便快速定位错误原因。
队列资源的最大数目配置为0 | 配置要大于0的队列资源的最大数量。如果不使用队列模块,则将配置项设置为将队列资源的最大数量的剪裁设置为NO。 |
为队列块分配更大的内存分区,或减少队列资源的最大数量 | |
队列创建的内存未能被请求 | 为队列分配更多的内存,或减少要创建的队列中的队列长度和节点的数目。 |
队列创建时消息长度超过上限 | 更改创建队列中最大消息的大小至不超过上限 |
已超过创建的队列的数量的上限 | 增加队列的配置资源数量 |
当任务被锁定时,禁止在队列中被阻塞 | |
等待处理队列的时间超时 | 检查设置的超时时间是否合适 |
阻塞任务的队列不能被删除 | 使任务能够获得资源而不是在队列中被阻塞 |
在中断处理程序中不能写队列 | 将写队列设为非阻塞模式 |
检查队列中传递的句柄是否有效 | |
队列创建过程中传递的参数为空指针 | 确保传递的参数不为空指针 |
队列创建过程中传递的队列长度或消息节点大小为0 | 传入正确的队列长度和消息节点大小 |
读取队列、写入队列的handle无效 | 检查队列中传递的handle是否有效 |
队列读取过程中传递的指针为空 | 检查指针中传递的是否为空 |
队列读取过程中传递的缓冲区大小为0 | 通过一个正确的缓冲区大小 |
队列写入过程中传递的指针为空 | 检查指针中传递的是否为空 |
队列写入过程中传递的缓冲区大小为0 | 通过一个正确的缓冲区大小 |
队列写入过程中传递的缓冲区大小比队列大小要大 | 减少缓冲区大小,或增大队列节点 |
在队列写入过程中没有可用的空闲节点 | 确保在队列写入之前,可以使用空闲的节点 |
正在获取队列信息时传递的指针为空 | 检查指针中传递的是否为空 |
在中断处理程序中不能读队列 | 将读队列设为非阻塞模式 |
正在释放队列的内存时传递的队列的handle无效 | 检查队列中传递的handle是否有效 |
传入的消息内存池指针为空 | |
传入非空membox内存指针 | |
确保在读取队列时包含消息 | |
读缓冲区大小小于队列大小 | 增加缓冲区大小,或减小队列节点大小 |
创建一个队列,两个任务。任务1调用发送接口发送消息;任务2通过接收接口接收消息。
/*任务1发送数据*/ /*将abuf里的数据写入队列*/ /*任务2接收数据*/ LOS_TaskLock();//锁住任务,防止新创建的任务比本任务高而发生调度事件是一种实现任务间通信的机制,可用于实现任务间的同步,但事件通信只能是事件类型的通信,无数据传输。一个任务可以等待多个事件的发生:可以是任意一个事件发生时唤醒任务进行事件处理;也可以是几个事件都发生后才唤醒任务进行事件处理。事件集合用32位无符号整型变量来表示,每一位代表一个事件。
多任务环境下,任务之间往往需要同步操作,一个等待即是一个同步。事件可以提供一对多、多对多的同步操作。一对多同步模型:一个任务等待多个事件的触发;多对多同步模型:多个任务等待多个事件的触发。
任务可以通过创建事件控制块来实现对事件的触发和等待操作。Huawei LiteOS的事件仅用于任务间的同步,不提供数据传输功能。
uwEventID
:用于标识该任务发生的事件类型,其中每一位表示一种事件类型(0表示该事件类型未发生、1表示该事件类型已经发生),一共31种事件类型,第25位系统保留。
在读事件时,可以选择读取模式。读取模式如下:
读事件时,可以根据入参事件掩码类型uwEventMask读取事件的单个或者多个事件类型。事件读取成功后,如果设置LOS_WAITMODE_CLR会清除已读取到的事件类型,反之不会清除已读到的事件类型,需显式清除。可以通过入参选择读取模式,读取事件掩码类型中所有事件还是读取事件掩码类型中任意事件。
写事件时,对指定事件写入指定的事件类型,可以一次同时写多个事件类型。写事件会触发任务调度。
清除事件时,根据入参事件和待清除的事件类型,对事件对应位进行清0操作。
事件可应用于多种任务同步场合,能够一定程度替代信号量。
Huawei LiteOS系统中的事件模块为用户提供下面几个接口。
读取指定事件类型,超时时间为相对时间:单位为Tick |
根据用户传入的事件值、事件掩码及校验模式,返回用户传入的事件是否符合预期 |
使用事件模块的典型流程如下:
对事件存在失败的可能性操作,包括事件初始化,事件销毁,事件读写,时间清除。
事件ID的第25个bit不能设置为1,因为该位已经作为错误码使用 | |
增加等待时间或者重新读取 | |
入参的事件ID是无效的 | 传入有效的事件ID参数 |
启动新的任务来获取事件 | |
读取事件的mode无效 | 传入有效的mode参数 |
任务锁住,不能读取事件 | |
错误码定义: 错误码是一个32位的存储单元,31~24位表示错误等级,23~16位表示错误码标志,15~8位代表错误码所属模块,7~0位表示错误码序号,如下
可以通过打印的先后顺序理解事件操作时伴随的任务切换。
/*事件控制结构体*/ /*等待的事件类型*/ /*用例任务入口函数*/ /*超时 等待方式读事件,超时时间为100 Tick 若100 Tick 后未读取到指定事件,读事件超时,任务直接唤醒*/ /*写用例任务等待的事件类型*/
编译运行得到的结果为:
互斥锁又称互斥型信号量,是一种特殊的二值性信号量,用于实现对共享资源的独占式处理。
任意时刻互斥锁的状态只有两种,开锁或闭锁。当有任务持有时,互斥锁处于闭锁状态,这个任务获得该互斥锁的所有权。当该任务释放它时,该互斥锁被开锁,任务失去该互斥锁的所有权。当一个任务持有互斥锁时,其他任务将不能再对该互斥锁进行开锁或持有。
多任务环境下往往存在多个任务竞争同一共享资源的应用场景,互斥锁可被用于对共享资源的保护从而实现独占式访问。另外,互斥锁可以解决信号量存在的优先级翻转问题。
多任务环境下会存在多个任务访问同一公共资源的场景,而有些公共资源是非共享的,需要任务进行独占式处理。互斥锁怎样来避免这种冲突呢?
用互斥锁处理非共享资源的同步访问时,如果有任务访问该资源,则互斥锁为加锁状态。此时其他任务如果想访问这个公共资源则会被阻塞,直到互斥锁被持有该锁的任务释放后,其他任务才能重新访问该公共资源,此时互斥锁再次上锁,如此确保同一时刻只有一个任务正在访问这个公共资源,保证了公共资源操作的完整性。
互斥锁可以提供任务之间的互斥机制,用来防止两个任务在同一时刻访问相同的共享资源。
Huawei LiteOS 系统中的互斥锁模块为用户提供下面几种功能。
互斥锁典型场景的开发流程:
对互斥锁存在失败的可能性操作,包括互斥锁创建,互斥锁删除,互斥锁申请,互斥锁释放。
减少互斥锁限制数量的上限 | |
传入有效的互斥锁的ID | |
增加互斥锁限制数量的上限 | |
锁失败,因为锁被其他线程使用 | 等待其他线程解锁或者设置等待时间 |
在中断中禁止调用此接口 | |
任务调度没有使能,线程等待另一个线程释放锁 | 设置PEND为非阻塞模式或者使能任务调度 |
增加等待时间或者设置一直等待模式 | |
错误码定义: 错误码是一个32位的存储单元,31~24位表示错误等级,23~16位表示错误码标志,15~8位代表错误码所属模块,7~0位表示错误码序号,如下
编译运行得到的结果为:
信号量(Semaphore)是一种实现任务间通信的机制,实现任务之间同步或临界资源的互斥访问。常用于协助一组相互竞争的任务来访问临界资源。
在多任务系统中,各任务之间需要同步或互斥实现临界资源的保护,信号量功能可以为用户提供这方面的支持。
通常一个信号量的计数值用于对应有效的资源数,表示剩下的可被占用的互斥资源数。其值的含义分两种情况:
以同步为目的的信号量和以互斥为目的的信号量在使用有如下不同:
信号量初始化,为配置的N个信号量申请内存(N值可以由用户自行配置,受内存限制),并把所有的信号量初始化成未使用,并加入到未使用链表中供系统使用。
信号量创建,从未使用的信号量链表中获取一个信号量资源,并设定初值。
信号量申请,若其计数器值大于0,则直接减1返回成功。否则任务阻塞,等待其它任务释放该信号量,等待的超时时间可设定。当任务被一个信号量阻塞时,将该任务挂到信号量等待任务队列的队尾。
信号量释放,若没有任务等待该信号量,则直接将计数器加1返回。否则唤醒该信号量等待任务队列上的第一个任务。
信号量删除,将正在使用的信号量置为未使用信号量,并挂回到未使用链表。
信号量允许多个任务在同一时刻访问同一资源,但会限制同一时刻访问此资源的最大任务数目。访问同一资源的任务数达到该资源的最大数量时,会阻塞其他试图获取该资源的任务,直到有任务释放该信号量。
信号量是一种非常灵活的同步方式,可以运用在多种场合中,实现锁、同步、资源计数等功能,也能方便的用于任务与任务,中断与任务的同步中。
Huawei LiteOS 系统中的信号量模块为用户提供下面几种功能。
信号量的开发典型流程:
对可能导致信号量操作失败的情况,包括创建信号量、申请信号量、释放信号量、删除信号量等,均需要返回对应的错误码,以便快速定位错误原因。
任务被锁,无法获得信号量 | |
将时间设置在合理范围内 | |
信号量允许pend次数超过最大值 | |
等待信号量的任务队列不为空 | 唤醒所有等待该型号量的任务后删除该信号量 |
错误码定义: 错误码是一个32位的存储单元,31~24位表示错误等级,23~16位表示错误码标志,15~8位代表错误码所属模块,7~0位表示错误码序号,如下
/*测试任务优先级*/
/*定时阻塞模式申请信号量,定时时间为10Tick*/
/*定时时间到,未申请到信号量*/
/*永久阻塞模式申请信号量,获取不到时程序阻塞,不会返回*/
/*永久阻塞模式申请信号量*/
编译运行得到的结果为:
时间管理以系统时钟为基础。时间管理提供给应用程序所有和时间有关的服务。
系统时钟是由定时/计数器产生的输出脉冲触发中断而产生的,一般定义为整数或长整数。输出脉冲的周期叫做一个“时钟滴答”。系统时钟也称为时标或者Tick。一个Tick的时长可以静态配置。
用户是以秒、毫秒为单位计时,而芯片CPU的计时是以Tick为单位的,当用户需要对系统操作时,例如任务挂起、延时等,输入秒为单位的数值,此时需要时间管理模块对二者进行转换。
Tick与秒之间的对应关系可以配置。
Huawei LiteOS的时间管理模块提供时间转换、统计、延迟功能以满足用户对时间相关需求的实现。
系统最小的计时单位。Cycle的时长由系统主频决定,系统主频就是每秒钟的Cycle数。
Tick是操作系统的基本时间单位,对应的时长由系统主频及每秒Tick数决定,由用户配置。
用户需要了解当前系统运行的时间以及Tick与秒、毫秒之间的转换关系等。
Huawei LiteOS系统中的时间管理主要提供以下两种功能:
时间管理的典型开发流程:
在下面的例子中,介绍了时间管理的基本方法,包括:
编译运行得到的结果为:
示例中系统时钟频率为80MHZ。
软件定时器,是基于系统Tick时钟中断且由软件来模拟的定时器,当经过设定的Tick时钟计数值后会触发用户定义的回调函数。定时精度与系统Tick时钟的周期有关。
硬件定时器受硬件的限制,数量上不足以满足用户的实际需求,因此为了满足用户需求,提供更多的定时器,Huawei LiteOS操作系统提供软件定时器功能。
软件定时器扩展了定时器的数量,允许创建更多的定时业务。
软件定时器功能上支持:
软件定时器是系统资源,在模块初始化的时候已经分配了一块连续的内存,系统支持的最大定时器个数由los_config.h中的LOSCFG_BASE_CORE_SWTMR_LIMIT宏配置。
软件定时器使用了系统的一个队列和一个任务资源,软件定时器的触发遵循队列规则,先进先出。定时时间短的定时器总是比定时时间长的靠近队列头,满足优先被触发的准则。
软件定时器以Tick为基本计时单位,当用户创建并启动一个软件定时器时,Huawei LiteOS会根据当前系统Tick时间及用户设置的定时间隔确定该定时器的到期Tick时间,并将该定时器控制结构挂入计时全局链表。
当Tick中断到来时,在Tick中断处理函数中扫描软件定时器的计时全局链表,看是否有定时器超时,若有则将超时的定时器记录下来。
Tick中断处理函数结束后,软件定时器任务(优先级为最高)被唤醒,在该任务中调用之前记录下来的定时器的超时回调函数。
系统在定时器模块初始化的时候将系统中所有定时器资源初始化成该状态。
在未使用状态下调用LOS_SwtmrCreate接口或者启动后调用LOS_SwtmrStop接口后,定时器将变成该状态。
在定时器创建后调用LOS_SwtmrStart接口,定时器将变成该状态,表示定时器运行时的状态。
Huawei LiteOS的软件定时器提供二类定时器机制:
Huawei LiteOS系统中的软件定时器模块为用户提供下面几种功能,下面具体的API详见软件定时器对外接口手册。
获得软件定时器剩余Tick数 | 获得软件定时器剩余Tick数 |
软件定时器的典型开发流程:
对软件定时器存在失败可能性的操作,包括创建、删除、暂停、重启定时器等等,均需要返回对应的错误码,以便快速定位错误原因。
软件定时器回调函数为空 | 定义软件定时器回调函数 |
软件定时器间隔时间为0 | |
不正确的软件定时器模式 | 确认软件定时器模式,范围为[0,2] |
软件定时器ID指针入参为NULL | 定义ID变量,传入指针 |
软件定时器个数超过最大值 | 重新定义软件定时器最大个数,或者等待一个软件定时器释放资源 |
不正确的软件定时器ID入参 | |
软件定时器链表创建内存不足 | 申请一块足够大的内存供软件定时器使用 |
不正确的软件定时器个数最大值 | |
修改源代码确保不在中断中使用 | |
软件定时器队列创建失败 | 检查用以创建队列的内存是否足够 |
软件定时器任务创建失败 | 检查用以创建软件定时器任务的内存是否足够并重新创建 |
不正确的软件定时器状态 | 检查确认软件定时器状态 |
用以获取软件定时器超时tick数的入参指针为NULL |
**错误码定义:**错误码是一个32位的存储单元,3124位表示错误等级,2316位表示错误码标志,158位代表错误码所属模块,70位表示错误码序号,如下
在下面的例子中,演示如下功能:
双向链表是指含有往前和往后两个方向的链表,即每个结点中除存放下一个节点指针外,还增加一个指向其前一个节点的指针。其头指针head是唯一确定的。
从双向链表中的任意一个结点开始,都可以很方便地访问它的前驱结点和后继结点,这种数据结构形式使得双向链表在查找时更加方便,特别是大量数据的遍历。由于双向链表具有对称性,能方便地完成各种插入、删除等操作,但需要注意前后方向的操作。
Huawei LiteOS系统中的双向链表模块为用户提供下面几个接口。
将新节点添加到链表中。 |
将节点插入到双向链表尾端 |
将指定的节点从链表中删除 |
将指定的节点从链表中删除,并使用该节点初始化链表 |
双向链表的典型开发流程:
使用双向链表,首先要申请内存,删除节点的时候要注意释放掉内存。
编译运行得到的结果为:
Agent Tiny是部署在具备广域网能力、对功耗/存储/计算资源有苛刻限制的终端设备上的轻量级互联互通中间件,开发者只需调用几个简单的API接口,便可实现设备快速接入到华为IoT云平台(OceanConnect)以及数据上报和命令接收等功能。
以彩灯应用举例,Agent Tiny工作原理如下:
开发者只需实现平台抽象层接口,即可对接OceanConncet平台。
Agent Tiny互联互通中间件为用户提供以下几类接口:
Agent Tiny申明和调用,开发者实现。该接口是LwM2M标准对象向设备下发命令的统一入口,比如读写设备数据,下发复位,升级命令等。为了避免死锁,该接口中禁止调用Agent Tiny对外接口 |
Agent Tiny申明和调用,开发者实现,Agent Tiny把注册过程的关键状态,以及运行过程的关键事件通知用户,便于用户根据自身的应用场景灵活地做可靠性处理。此外,为了避免死锁,该接口中禁止调用Agent Tiny对外接口 |
Agent Tiny的主函数体,由Agent Tiny实现,开发者调用,调用成功后,不会返回。该接口是Agent Tiny主循环体,实现了LwM2M协议处理,注册状态机,重传队列,订阅上报 |
Agent Tiny的去初始化接口,由Agent Tiny实现,开发者调用,该接口为阻塞式接口,调用该接口时,会直到agent tiny主任务退出,资源释放完毕,该接口才会退出 |
Agent Tiny数据上报接口,由agent Tiny实现,开发者调用,用户APP数据使用该接口上报,该接口为阻塞接口,不允许在中断中使用 |
Agent Tiny对外接口和依赖接口,可能存在的错误,统一用以下错误码。
0 |
检查系统资源,比如信号量,套接字个数等,是否配置过少,或是否有泄漏 |
检查psk,服务器信息等是否正确 |
检查网络配置和参数是否正确 |
在工程配置中,WITH_DTLS编译选项打开。