为了提升驱动代码在不同内核子系统间的可复用能力，OpenHarmony HDF（Hardware Driver Foundation）驱动框架提供了OSAL(Operating System Abstraction Layer)操作系统抽象层接口。OSAL为驱动程序提供了任务、定时器、互斥锁、信号量等基础库相关接口，使驱动相关的实现不再依赖于具体的内核或POSIX接口，是实现驱动可迁移的基石。OpenHarmony HDF驱动框架已经在LiteOS-M，LiteOS-A，Linux内核完成适配，可直接使用。

本文主要分析下驱动适配代码仓中的OSAL的相关接口，主要以适配LiteOS-M内核的OSAL接口为例。OSAL在HDF驱动框架中的位置，见HDF架构图。

1、OSAL头文件

在文件夹drivers/framework/include/osal中定义了OSAL的头文件，对这些头文件的说明如下。

头文件 头文件描述
osal_atomic.h 原子变量相关接口
osal_cdev.h 字符设备相关接口
osal_file.h 文件相关接口
osal_firmware.h 固件文件相关接口
osal_io.h I/O操作类接口
osal_irq.h 中断相关接口
osal_mem.h 内存申请释放接口
osal_mutex.h 互斥锁相关接口
osal_sem.h 信号量相关接口
osal_spinlock.h 自旋锁相关接口
osal_thread.h 线程相关接口
osal_time.h 时间相关接口
osal_timer.h 定时器相关接口

2、原子变量相关接口

在头文件drivers\framework\include\osal\osal_atomic.h中定义了原子变量相关接口。对于LiteOS-M内核，接口实现程序定义在文件drivers\adapter\khdf\liteos_m\osal\include\osal_atomic_def.h中。

接口 接口描述
OsalAtomicRead(v) 读取原子类型的计数变量值
OsalAtomicSet(v, counter) 设置原子类型的计数变量值
OsalAtomicInc 原子类型的计数变量值加1
OsalAtomicIncReturn 原子类型的计数变量值加1，并返回更新后的值
OsalAtomicDec 原子类型的计数变量值减1
OsalAtomicDecReturn 原子类型的计数变量值减1，并返回更新后的值
OsalTestBit 测试指定变量指定位的值
OsalTestSetBit 设置指定变量指定位的值，并返回设置前的值
OsalTestClearBit 清除指定变量指定位的值，并返回清除前的值
OsalClearBit 清除指定变量指定位的值

3、内存申请释放接口

在头文件drivers\framework\include\osal\osal_mem.h中定义了内存申请释放相关接口。对于LiteOS-M内核，接口实现程序定义在文件drivers\adapter\khdf\liteos_m\osal\src\osal_mem.c中。

接口 接口描述
void *OsalMemAlloc(size_t size) 申请内存接口
void *OsalMemCalloc(uint32_t size) 申请内存接口，并把申请的内存清零
void OsalMemAllocAlign(size_t alignment, size_t size) 申请内存接口，内存地址按照指定大小进行边界对齐
void OsalMemFree(void mem) 释放内存接口

4、互斥锁相关接口

在头文件drivers\framework\include\osal\osal_mutex.h中定义了互斥锁相关接口。对于LiteOS-M内核，接口实现程序定义在文件drivers\adapter\khdf\liteos_m\osal\src\osal_mutex.c中。

接口 接口描述
int32_t OsalMutexInit(struct OsalMutex *mutex) 初始化互斥锁
int32_t OsalMutexDestroy(struct OsalMutex *mutex) 销毁互斥锁
int32_t OsalMutexLock(struct OsalMutex *mutex) 获取互斥锁
int32_t OsalMutexTimedLock(struct OsalMutex *mutex, uint32_t ms) 获取到互斥锁或者超时时返回
int32_t OsalMutexUnlock(struct OsalMutex *mutex) 释放互斥锁

5、自旋锁相关接口

在头文件drivers\framework\include\osal\osal_spinlock.h中定义了自旋锁相关接口。对于LiteOS-M内核，接口实现程序定义在文件drivers\adapter\khdf\liteos_m\osal\src\osal_spinlock.c中。

接口 接口描述
int32_t OsalSpinInit(OsalSpinlock *spinlock) 初始化自旋锁
int32_t OsalSpinDestroy(OsalSpinlock *spinlock) 销毁自旋锁
int32_t OsalSpinLock(OsalSpinlock *spinlock) 获取自旋锁
int32_t OsalSpinUnlock(OsalSpinlock *spinlock) 释放自旋锁
int32_t OsalSpinLockIrq(OsalSpinlock *spinlock) 获取自旋锁接口，并且去使能中断
int32_t OsalSpinUnlockIrq(OsalSpinlock *spinlock) 释放自旋锁接口，并且使能中断
int32_t OsalSpinLockIrqSave(OsalSpinlock *spinlock, uint32_t *flags) 获取自旋锁接口，并且去使能中断，保存中断状态
int32_t OsalSpinUnlockIrqRestore(OsalSpinlock *spinlock, uint32_t *flags) 释放自旋锁接口，并且使能中断，恢复保存的中断状态

6、信号量相关接口

在头文件drivers\framework\include\osal\osal_sem.h中定义了信号量相关接口。对于LiteOS-M内核，接口实现程序定义在文件drivers\adapter\khdf\liteos_m\osal\src\osal_sem.c中。

接口 接口描述
int32_t OsalSemInit(struct OsalSem *sem, uint32_t value) 初始化信号量
int32_t OsalSemWait(struct OsalSem *sem, uint32_t ms) 等待信号量
int32_t OsalSemPost(struct OsalSem *sem) 释放信号量
int32_t OsalSemDestroy(struct OsalSem *sem) 销毁信号量

7、线程相关接口

在头文件drivers\framework\include\osal\osal_thread.h中定义了信号量相关接口。对于LiteOS-M内核，接口实现程序定义在文件drivers\adapter\khdf\liteos_m\osal\src\osal_thread.c中。

接口 接口描述
int32_t OsalThreadCreate(struct OsalThread *thread, OsalThreadEntry threadEntry, void *entryPara) 创建线程
int32_t OsalThreadBind(struct OsalThread *thread, unsigned int cpuID) 绑定线程到指定的CPU上运行
int32_t OsalThreadStart(struct OsalThread *thread, const struct OsalThreadParam *param) 启动线程
int32_t OsalThreadDestroy(struct OsalThread *thread) 销毁线程

8、其他接口

类似还有时间、定时器接口，可以自行查看文件drivers\adapter\khdf\liteos_m\osal\src\osal_time.c、drivers\adapter\khdf\liteos_m\osal\src\osal_timer.c，不再一一列举。

小结

本文介绍了HDF驱动框架子系统中的OSAL接口，后续会介绍更多的HDF驱动框架知识。

如果大家想更加深入的学习 OpenHarmony 开发的内容，不妨可以参考以下相关学习文档进行学习，助你快速提升自己：

OpenHarmony 开发环境搭建：https://qr18.cn/CgxrRy

《OpenHarmony源码解析》：https://qr18.cn/CgxrRy

  • 搭建开发环境
  • Windows 开发环境的搭建
  • Ubuntu 开发环境搭建
  • Linux 与 Windows 之间的文件共享
  • ……

系统架构分析：https://qr18.cn/CgxrRy

  • 构建子系统
  • 启动流程
  • 子系统
  • 分布式任务调度子系统
  • 分布式通信子系统
  • 驱动子系统
  • ……

OpenHarmony 设备开发学习手册：https://qr18.cn/CgxrRy

在这里插入图片描述

OpenHarmony面试题（内含参考答案）：https://qr18.cn/CgxrRy

写在最后

  • 如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：
  • 点赞，转发，有你们的 『点赞和评论』，才是我创造的动力。
  • 关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
  • 想要获取更多完整鸿蒙最新学习资源，请移步前往小编：https://qr21.cn/FV7h05
推荐内容
点击阅读全文
# linux # harmonyos # 驱动开发
Logo
HarmonyOS开发者社区

讨论HarmonyOS开发技术，专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐

#跟着晓明学鸿蒙# FormLink组件实现设置页面功能

目录案例介绍代码实现代码详解页面结构设计功能模块实现交互优化样式优化总结 案例介绍 本篇文章将介绍如何使用FormLink组件实现设置页面的高级功能，包括隐私设置、账号安全、通知管理等功能的交互实现。通过本篇文章，你将学习到如何构建一个功能完整、交互友好的设置页面。 代码实现 import router from '@ohos.router'; import promptAc

avatar HarmonyOS开发者社区

#跟着晓明学鸿蒙# FormLink组件实现商品详情操作功能

目录案例介绍代码实现代码详解底部操作栏实现评论项实现样式优化总结 案例介绍 本篇文章将介绍如何在商品详情页中实现底部操作栏和评论展示功能，包括客服咨询、购物车、立即购买等操作按钮，以及评论项的展示效果。 代码实现 import router from '@ohos.router'; @Entry @Component struct ProductDetailDemo { pr

avatar HarmonyOS开发者社区

#跟着晓明学鸿蒙# FormLink组件实现产品详情服务功能

目录案例介绍代码实现代码详解售后服务区域实现底部操作栏实现对话框实现总结 案例介绍 本篇文章将介绍如何在产品详情页中使用FormLink组件实现售后服务区域和底部操作栏的功能，包括服务政策查看、客服咨询和购买操作等功能的实现。 代码实现 import router from '@ohos.router'; @Entry @Component struct ProductDet

avatar HarmonyOS开发者社区