文档首页> LiteOS> 内核> 信号量> 开发指导
更新时间:2021-07-08 GMT+08:00
分享

开发指导

使用场景

在多任务系统中,信号量是一种非常灵活的同步方式,可以运用在多种场合中,实现锁、同步、资源计数等功能,也能方便的用于任务与任务,中断与任务的同步中。信号量常用于协助一组相互竞争的任务访问共享资源。

功能

Huawei LiteOS 的信号量模块为用户提供下面几种功能,接口详细信息可以查看API参考。

功能分类

接口名

描述

创建/删除信号量

LOS_SemCreate

创建信号量,返回信号量ID

LOS_BinarySemCreate

创建二值信号量,其计数值最大为1

LOS_SemDelete

删除指定的信号量

申请/释放信号量

LOS_SemPend

申请指定的信号量,并设置超时时间

LOS_SemPost

释放指定的信号量

信号量有三种申请模式:无阻塞模式、永久阻塞模式、定时阻塞模式。

  • 无阻塞模式:即任务申请信号量时,入参timeout等于0。若当前信号量计数值不为0,则申请成功,否则立即返回申请失败。
  • 永久阻塞模式:即任务申请信号量时,入参timeout等于0xFFFFFFFF。若当前信号量计数值不为0,则申请成功。否则该任务进入阻塞态,系统切换到就绪任务中优先级最高者继续执行。任务进入阻塞态后,直到有其他任务释放该信号量,阻塞任务才会重新得以执行。
  • 定时阻塞模式:即任务申请信号量时,0<timeout<0xFFFFFFFF。若当前信号量计数值不为0,则申请成功。否则,该任务进入阻塞态,系统切换到就绪任务中优先级最高者继续执行。任务进入阻塞态后,超时前如果有其他任务释放该信号量,则该任务可成功获取信号量继续执行,若超时前未获取到信号量,接口将返回超时错误码。

信号量错误码

对存在失败可能性的操作返回对应的错误码,以便快速定位错误原因。

序号

定义

实际数值

描述

参考解决方案

1

LOS_ERRNO_SEM_NO_MEMORY

0x02000700

初始化信号量时,内存空间不足

调整OS_SYS_MEM_SIZE以确保有足够的内存供信号量使用,或减小系统支持的最大信号量数LOSCFG_BASE_IPC_SEM_LIMIT

2

LOS_ERRNO_SEM_INVALID

0x02000701

信号量ID不正确或信号量未创建

传入正确的信号量ID或创建信号量后再使用

3

LOS_ERRNO_SEM_PTR_NULL

0x02000702

传入空指针

传入合法指针

4

LOS_ERRNO_SEM_ALL_BUSY

0x02000703

创建信号量时,系统中已经没有未使用的信号量

及时删除无用的信号量或增加系统支持的最大信号量数LOSCFG_BASE_IPC_SEM_LIMIT

5

LOS_ERRNO_SEM_UNAVAILABLE

0x02000704

无阻塞模式下未获取到信号量

选择阻塞等待或根据该错误码适当处理

6

LOS_ERRNO_SEM_PEND_INTERR

0x02000705

中断期间非法调用LOS_SemPend申请信号量

中断期间禁止调用LOS_SemPend

7

LOS_ERRNO_SEM_PEND_IN_LOCK

0x02000706

任务被锁,无法获得信号量

在任务被锁时,不能调用LOS_SemPend申请信号量

8

LOS_ERRNO_SEM_TIMEOUT

0x02000707

获取信号量超时

将时间设置在合理范围内

9

LOS_ERRNO_SEM_OVERFLOW

0x02000708

信号量计数值已达到最大值,无法再继续释放该信号量

根据该错误码适当处理

10

LOS_ERRNO_SEM_PENDED

0x02000709

等待信号量的任务队列不为空

唤醒所有等待该信号量的任务后,再删除该信号量

11

LOS_ERRNO_SEM_PEND_IN_SYSTEM_TASK

0x0200070a

在系统任务中获取信号量,如idle和软件定时器

不要在系统任务中获取信号量

错误码定义见错误码简介。8~15位的所属模块为信号量模块,值为0x07。

开发流程

信号量的开发典型流程:

  1. 执行make menuconfig命令,进入Kernel ---> Enable Sem菜单,完成信号量的配置。

    配置项

    含义

    取值范围

    默认值

    依赖

    LOSCFG_BASE_IPC_SEM

    信号量模块裁剪开关

    YES/NO

    YES

    LOSCFG_BASE_IPC_SEM_LIMIT

    系统支持的信号量最大数

    [0, 65535]

    1024

  2. 创建信号量LOS_SemCreate,若要创建二值信号量则调用LOS_BinarySemCreate。
  3. 申请信号量LOS_SemPend。
  4. 释放信号量LOS_SemPost。
  5. 删除信号量LOS_SemDelete。

平台差异性

无。

分享:

    相关文档

    相关产品

close