未验证 提交 5d028345 编写于 作者: O openharmony_ci 提交者: Gitee

!2508 删除纯净版中不适合的表格引用,解决dac_des中图形丢失问题

Merge pull request !2508 from liyan/master
......@@ -9,7 +9,7 @@
## Audio驱动框架介绍<a name="section2000"></a>
## Audio驱动框架介绍
Audio驱动框架基于[HDF驱动框架](https://device.harmonyos.com/cn/docs/documentation/guide/driver-hdf-overview-0000001051715456)实现。Audio驱动架构组成:
......
......@@ -5,7 +5,7 @@
### 功能简介
Sensor驱动模型屏蔽硬件器件差异,为上层Sensor服务系统提供稳定的Sensor基础能力接口,包括Sensor列表查询、Sensor启停、Sensor订阅及取消订阅,Sensor参数配置等功能;Sensor设备驱动的开发是基于HDF驱动框架基础上,结合操作系统适配层(OSAL)和平台驱动接口(比如I2C/SPI/UART总线等平台资源)能力,屏蔽不同操作系统和平台总线资源差异,实现Sensor驱动“一次开发,多系统部署”的目标。Sensor驱动模型如[图1](#Sensor驱动模型图)所示。
Sensor驱动模型屏蔽硬件器件差异,为上层Sensor服务系统提供稳定的Sensor基础能力接口,包括Sensor列表查询、Sensor启停、Sensor订阅及取消订阅,Sensor参数配置等功能;Sensor设备驱动的开发是基于HDF驱动框架基础上,结合操作系统适配层(OSAL)和平台驱动接口(比如I2C/SPI/UART总线等平台资源)能力,屏蔽不同操作系统和平台总线资源差异,实现Sensor驱动“一次开发,多系统部署”的目标。Sensor驱动模型如图1所示。
**图 1** Sensor驱动模型图
......@@ -21,7 +21,7 @@ Sensor驱动模型屏蔽硬件器件差异,为上层Sensor服务系统提供
### 运作机制
通过介绍Sensor驱动模型的加载以及运行流程,对模型内部关键组件以及关联组件之间的关系进行了划分,整体加载流程如[图2](#Sensor驱动运行图)所示:
通过介绍Sensor驱动模型的加载以及运行流程,对模型内部关键组件以及关联组件之间的关系进行了划分,整体加载流程如图2所示:
**图 2** Sensor驱动运行图
......@@ -60,7 +60,7 @@ Sensor驱动模型对外开放的API接口能力如下:
- 提供同一类型Sensor器件驱动归一接口, 寄存器配置解析操作接口,总线访问抽象接口,平台抽象接口。
- 提供开发者实现的能力接口:依赖HDF驱动框架的HCS(HDF Configuration Source)配置管理,根据同类型Sensor差异化配置,实现Sensor器件参数序列化配置和器件部分操作接口,简化Sensor器件驱动开发。
Sensor驱动模型对外开放的API接口能力的具体实现参考[表1](#Sensor驱动模型对外API接口功能介绍)
Sensor驱动模型对外开放的API接口能力的具体实现请参考
**表 1** Sensor驱动模型对外API接口功能介绍
......@@ -77,7 +77,7 @@ Sensor驱动模型对外开放的API接口能力的具体实现参考[表1](#Sen
Sensor驱动模型对驱动开发者开放的功能接口,驱动开发者无需实现,直接使用,参考[表2](#Sensor驱动模型对驱动开发者开放的功能接口列表)
Sensor驱动模型对驱动开发者开放的功能接口,驱动开发者无需实现,直接使用,请参考
**表2** Sensor驱动模型对驱动开发者开放的功能接口列表
......@@ -97,7 +97,7 @@ Sensor驱动模型对驱动开发者开放的功能接口,驱动开发者无
Sensor驱动模型要求驱动开发者实现的接口功能,参考[表3](#Sensor驱动模型要求驱动开发者实现的接口列表)
Sensor驱动模型要求驱动开发者实现的接口功能,请参考
**表 3** Sensor驱动模型要求驱动开发者实现的接口列表
......@@ -514,9 +514,8 @@ Sensor驱动模型要求驱动开发者实现的接口功能,参考[表3](#Sen
>![](../public_sys-resources/icon-note.gif) **说明:**
>
>- 传感器驱动模型已经提供一部分能力集,包括驱动设备管理能力、抽象总线和平台操作接口能力、通用配置操作接口能力、配置解析操作接口能力,接口参考[表2](#Sensor驱动模型对驱动开发者开放的功能接口列表)。
>
>- 需要开发人员实现部分有:传感器部分操作接口([表3](#Sensor驱动模型要求驱动开发者实现的接口列表))和传感器HCS差异化数据配置。
>- 传感器驱动模型已经提供一部分能力集,包括驱动设备管理能力、抽象总线和平台操作接口能力、通用配置操作接口能力、配置解析操作接口能力,相关接口请参考表2。
>- 需要开发人员实现部分有:传感器部分操作接口(请参考表3)和传感器HCS差异化数据配置。
>- 驱动基本功能验证。
### 调测验证
......
......@@ -5,7 +5,7 @@
### 功能简介
为了快速开发传感器驱动,基于HDF(Hardware Driver Foundation)驱动框架开发了马达驱动模型。马达驱动模型,屏蔽设备驱动与系统交互的实现,为硬件服务层提供统一稳定的驱动接口能力,为驱动开发者提供开放的接口和解析接口的能力。用于不同操作系统马达设备部件的部署指导和马达设备部件驱动的开发。马达驱动模型如[图1](#马达驱动模型图)所示:
为了快速开发传感器驱动,基于HDF(Hardware Driver Foundation)驱动框架开发了马达驱动模型。马达驱动模型,屏蔽设备驱动与系统交互的实现,为硬件服务层提供统一稳定的驱动接口能力,为驱动开发者提供开放的接口和解析接口的能力。用于不同操作系统马达设备部件的部署指导和马达设备部件驱动的开发。马达驱动模型如图1所示:
**图 1** 马达驱动模型图
......@@ -25,7 +25,7 @@
### 运作机制
通过介绍马达驱动模型的加载以及运行流程,对模型内部关键组件以及关联组件之间的关系进行了划分,整体加载流程如[图2](#马达驱动运行图)所示:
通过介绍马达驱动模型的加载以及运行流程,对模型内部关键组件以及关联组件之间的关系进行了划分,整体加载流程如图2所示:
**图2** 马达驱动运行图
......@@ -52,7 +52,7 @@
### 接口说明
马达驱动模型支持静态HCS配置和动态参数两种振动效果配置能力。马达硬件服务调用StartOnce接口动态配置持续振动;调用Start接口启动静态配置的振动效果。马达驱动模型对HDI开放的API接口能力,参考[表1](#马达驱动模型对外API接口能力介绍)
马达驱动模型支持静态HCS配置和动态参数两种振动效果配置能力。马达硬件服务调用StartOnce接口动态配置持续振动;调用Start接口启动静态配置的振动效果。马达驱动模型对HDI开放的API接口能力,如下所示
**表 1** 马达驱动模型对外API接口能力介绍
......
# DAC<a name="1"></a>
# DAC
- [概述](#section1)
- [功能简介](#section2)
- [基本概念](#section3)
- [运作机制](#section4)
- [约束与限制](#section5)
- [使用指导](#section6)
- [场景介绍](#section7)
- [接口说明](#section8)
- [开发步骤](#section9)
- [使用实例](#section10)
## 概述<a name="section1"></a>
## 概述
### 功能简介<a name="section2"></a>
### 功能简介
- DAC(Digital to Analog Converter)是一种通过电流、电压或电荷的形式将数字信号转换为模拟信号的设备 。
......@@ -22,7 +12,7 @@
- DAC设置目标值:设置DAC设备需要将数字信号转成模拟信号的目标值。
### 基本概念<a name="section3"></a>
### 基本概念
DAC模块支持数模转换的开发,它主要用于:
......@@ -41,50 +31,50 @@ DAC模块支持数模转换的开发,它主要用于:
转换速度一般由建立时间决定。从输入由全0突变为全1时开始,到输出电压稳定在FSR±½LSB范围(或以FSR±x%FSR指明范围)内为止,这段时间称为建立时间,它是DAC的最大响应时间,所以用它衡量转换速度的快慢。
满量程范围FSR( Full Scale Range ),是指DAC输出信号幅度的最大范围,不同的DAC有不同的满量程范围, 该范围可以用正、负电流或者正、负电压来限制 。
满量程范围FSR(Full Scale Range),是指DAC输出信号幅度的最大范围,不同的DAC有不同的满量程范围, 该范围可以用正、负电流或者正、负电压来限制 。
最低有效位LSB(Least Significant Byte),指的是一个二进制数字中的第0位(即最低位)。
### 运作机制<a name="section4"></a>
### 运作机制
在HDF框架中,同类型设备对象较多时(可能同时存在十几个同类型配置器),如果采用独立服务模式则需要配置更多的设备节点,且相关服务会占据更多的内存资源。相反,采用统一服务模式可以使用一个设备服务作为管理器,统一处理所有同类型对象的外部访问(这会在配置文件中有所体现),实现便捷管理和节约资源的目的。DAC模块接口适配模式采用统一服务模式[如图1](#fig14423182615525)所示)
在HDF框架中,同类型设备对象较多时(可能同时存在十几个同类型配置器),如果采用独立服务模式则需要配置更多的设备节点,且相关服务会占据更多的内存资源。相反,采用统一服务模式可以使用一个设备服务作为管理器,统一处理所有同类型对象的外部访问(这会在配置文件中有所体现),实现便捷管理和节约资源的目的。DAC模块接口适配模式采用统一服务模式,如图1所示
DAC模块各分层的作用为:接口层提供打开设备,写入数据,关闭设备的接口。核心层主要提供绑定设备、初始化设备以及释放设备的能力。适配层实现其他具体的功能。
![](../public_sys-resources/icon-note.gif) 说明:核心层可以调用接口层的函数,核心层通过钩子函数调用适配层函数,从而适配层间接的可以调用接口层函数,但是不可逆转接口层调用适配层函数。
**图 1** DAC统一服务模式<a name="fig14423182615525"></a>
![](figures/DAC统一服务模式结构图.png "DAC统一服务模式")
**图 1** DAC统一服务模式
### 约束与限制<a name="section5"></a>
![DAC统一服务模式](figures/统一服务模式结构图.png "DAC统一服务模式")
### 约束与限制
DAC模块当前仅支持轻量和小型系统内核(LiteOS) 。
## 使用指导<a name="section6"></a>
## 使用指导
### 场景介绍<a name="section7"></a>
### 场景介绍
DAC模块的主要工作是以电流、电压或电荷的形式将数字信号转换为模拟信号,主要应用于音频设备中。日常所见的音响、耳机等,均使用DAC模块作为数模转换的通道。
### 接口说明<a name="section8"></a>
### 接口说明
DAC模块提供的主要接口如[表1](#table1)所示,更多关于接口的介绍请参考对应的API接口文档。
DAC模块提供的主要接口如所示,更多关于接口的介绍请参考对应的API接口文档。
**表 1** DAC驱动API接口功能介绍
<a name="table1"></a>
| 接口名 | 描述 |
| ------------------------------------------------------------ | ------------ |
| 接口名 | 描述 |
| :------------------------------------------------------------| :------------ |
| DevHandle DacOpen(uint32_t number) | 打开DAC设备 |
| void DacClose(DevHandle handle) | 关闭DAC设备 |
| int32_t DacWrite(DevHandle handle, uint32_t channel, uint32_t val) | 设置DA目标值 |
### 开发步骤<a name="section9"></a>
### 开发步骤
使用DAC设备的一般流程如[图2](#fig2)所示。
使用DAC设备的一般流程如图2所示。
**图 2** DAC使用流程图<a name="fig2"></a>
![](figures/DAC使用流程图.png "DAC使用流程图")
**图 2** DAC使用流程图
![DAC使用流程图](figures/DAC使用流程图.png "DAC使用流程图")
#### 打开DAC设备
......@@ -96,8 +86,6 @@ DevHandle DacOpen(uint32_t number);
**表 2** DacOpen参数和返回值描述
<a name="table2"></a>
| 参数 | 参数描述 |
| ---------- | ----------------- |
| number | DAC设备号 |
......@@ -128,7 +116,6 @@ int32_t DacWrite(DevHandle handle, uint32_t channel, uint32_t val);
**表 3** DacWrite参数和返回值描述
<a name="table3"></a>
| 参数 | 参数描述 |
| ---------- | -------------- |
......@@ -155,9 +142,9 @@ DAC通信完成之后,需要关闭DAC设备,关闭函数如下所示:
```
void DacClose(DevHandle handle);
```
**表 4** DacClose参数和返回值描述
<a name="table4"></a>
| 参数 | 参数描述 |
| ---------- | -------------- |
......@@ -173,7 +160,7 @@ void DacClose(DevHandle handle);
DacClose(dacHandle); /* 关闭DAC设备 */
```
## 使用实例<a name="section10"></a>
## 使用实例
DAC设备的具体使用方式可以参考如下示例代码,示例代码步骤主要如下:
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册