Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
未验证 提交 149d393f 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!3967 【OpenHarmony开源贡献者计划2022】ADC&DAC相关格式及表达问题 

Merge pull request !3967 from king_he/adc-1
上级 3191bf2d 0989d4e8
隐藏空白更改
内联 并排
Showing with 107 addition and 118 deletion
zh-cn/device-dev/driver/driver-platform-adc-des.md
浏览文件 @ 149d393f
# ADC<a name="1"></a>
- [概述](#section1)
- [功能简介](#section2)
- [基本概念](#section3)
- [运作机制](#section4)
- [约束与限制](#section5)
- [使用指导](#section6)
- [场景介绍](#section7)
- [接口说明](#section8)
- [开发步骤](#section9)
- [使用实例](#section10)
## 概述<a name="section1"></a>
### 功能简介<a name="section2"></a>
- ADC（Analog to Digital Converter），即模拟-数字转换器，是一种将模拟信号转换成对应数字信号的设备。
ADC（Analog to Digital Converter），即模拟-数字转换器，是一种将模拟信号转换成对应数字信号的设备。
- ADC接口定义了完成ADC传输的通用方法集合，包括：
- ADC设备管理：打开或关闭ADC设备。
- ADC读取转换结果：读取AD转换结果。
ADC接口定义了完成ADC传输的通用方法集合，包括：
- ADC设备管理：打开或关闭ADC设备。
- ADC读取转换结果：读取AD转换结果。
### 基本概念<a name="section3"></a>
......
zh-cn/device-dev/driver/driver-platform-adc-develop.md
浏览文件 @ 149d393f
......@@ -3,7 +3,7 @@
## 概述
ADC（Analog to Digital Converter），即模拟-数字转换器，是一种将模拟信号转换成对应数字信号的设备，在HDF框架中，ADC模块接口适配模式采用统一服务模式，这需要一个设备服务来作为ADC模块的管理器，统一处理外部访问，这会在配置文件中有所体现。统一服务模式适合于同类型设备对象较多的情况，如ADC可能同时具备十几个控制器，采用独立服务模式需要配置更多的设备节点，且服务会占据内存资源。
ADC（Analog to Digital Converter），即模拟-数字转换器，是一种将模拟信号转换成对应数字信号的设备。在HDF框架中，ADC模块接口适配模式采用统一服务模式，这需要一个设备服务来作为ADC模块的管理器，统一处理外部访问，这会在配置文件中有所体现。统一服务模式适合于同类型设备对象较多的情况，如ADC可能同时具备十几个控制器，采用独立服务模式需要配置更多的设备节点，且服务会占据内存资源。
**图1** ADC统一服务
......@@ -27,36 +27,36 @@ struct AdcMethod {
| 函数成员 | 入参 | 出参 | 返回值 | 功能 |
| -------- | -------- | -------- | -------- | -------- |
| read | device:&nbsp;结构体指针，核心层ADC控制器；<br/>channel：uint32_t，传入的通道号； | val：uint32_t指针，要传出的信号数据; | HDF_STATUS相关状态 | 读取ADC采样的信号数据 |
| stop | device:&nbsp;结构体指针，核心层ADC控制器； | 无 | HDF_STATUS相关状态 | 关闭ADC设备 |
| start | device:&nbsp;结构体指针，核心层ADC控制器； | 无 | HDF_STATUS相关状态 | 开启ADC设备 |
| read | device：结构体指针，核心层ADC控制器<br/>channel：uint32_t，传入的通道号 | val：uint32_t指针，要传出的信号数据 | HDF_STATUS相关状态 | 读取ADC采样的信号数据 |
| stop | device：结构体指针，核心层ADC控制器 | 无 | HDF_STATUS相关状态 | 关闭ADC设备 |
| start | device：结构体指针，核心层ADC控制器 | 无 | HDF_STATUS相关状态 | 开启ADC设备 |
## 开发步骤
ADC模块适配的三个环节是配置属性文件，实例化驱动入口，以及实例化核心层接口函数。
1. **实例化驱动入口：**
1. 实例化驱动入口：
- 实例化HdfDriverEntry结构体成员。
- 调用HDF_INIT将HdfDriverEntry实例化对象注册到HDF框架中。
2. **配置属性文件：**
2. 配置属性文件：
- 在device_info.hcs文件中添加deviceNode描述。
- 【可选】添加adc_config.hcs器件属性文件。
3. **实例化ADC控制器对象：**
3. 实例化ADC控制器对象：
- 初始化AdcDevice成员。
- 实例化AdcDevice成员AdcMethod。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**<br>
> 实例化AdcDevice成员AdcMethod，其定义和成员说明见[接口说明](#接口说明)。
4. **驱动调试：**
4. 驱动调试：
【可选】针对新增驱动程序，建议验证驱动基本功能，例如挂载后的信息反馈，信号采集的成功与否等。
## 开发实例
接下来以 adc_hi35xx.c 为示例， 展示需要厂商提供哪些内容来完整实现设备功能。
接下来以adc_hi35xx.c为示例， 展示需要厂商提供哪些内容来完整实现设备功能。
1. 驱动开发首先需要实例化驱动入口，驱动入口必须为HdfDriverEntry（在 hdf_device_desc.h 中定义）类型的全局变量，且moduleName要和device_info.hcs中保持一致。HDF框架会将所有加载的驱动的HdfDriverEntry对象首地址汇总，形成一个类似数组的段地址空间，方便上层调用。
一般在加载驱动时HDF会先调用Bind函数，再调用Init函数加载该驱动。当Init调用异常时，HDF框架会调用Release释放驱动资源并退出。
......@@ -74,30 +74,30 @@ ADC模块适配的三个环节是配置属性文件，实例化驱动入口，
.Release = Hi35xxAdcRelease,
.moduleName = "hi35xx_adc_driver",//【必要且与HCS文件里面的名字匹配】
};
HDF_INIT(g_hi35xxAdcDriverEntry); //调用HDF_INIT将驱动入口注册到HDF框架中
HDF_INIT(g_hi35xxAdcDriverEntry); // 调用HDF_INIT将驱动入口注册到HDF框架中
//核心层adc_core.c管理器服务的驱动入口
// 核心层adc_core.c管理器服务的驱动入口
struct HdfDriverEntry g_adcManagerEntry = {
.moduleVersion = 1,
.Init = AdcManagerInit,
.Release = AdcManagerRelease,
.moduleName = "HDF_PLATFORM_ADC_MANAGER",//这与device_info文件中device0对应
.moduleName = "HDF_PLATFORM_ADC_MANAGER",// 这与device_info文件中device0对应
};
HDF_INIT(g_adcManagerEntry);
```
2. 完成驱动入口注册之后，下一步请在device_info.hcs文件中添加deviceNode信息，并在adc_config.hcs中配置器件属性。deviceNode信息与驱动入口注册相关，器件属性值对于厂商驱动的实现以及核心层AdcDevice相关成员的默认值或限制范围有密切关系。
统一服务模式的特点是device_info文件中第一个设备节点必须为ADC管理器，其各项参数必须如下设置：
| 成员名 | 值 |
| 成员名 | 值 |
| -------- | -------- |
| moduleName | 固定为&nbsp;HDF_PLATFORM_ADC_MANAGER |
| moduleName | 固定为HDF_PLATFORM_ADC_MANAGER |
| serviceName | 无 |
| policy | 具体配置为0，不发布服务 |
| deviceMatchAttr | 没有使用，可忽略 |
从第二个节点开始配置具体ADC控制器信息，此节点并不表示某一路ADC控制器，而是代表一个资源性质设备，用于描述一类ADC控制器的信息。本例只有一个ADC设备，如有多个设备，则需要在device_info文件增加deviceNode信息，以及在adc_config文件中增加对应的器件属性。
- device_info.hcs 配置参考。
- device_info.hcs配置参考
```
......@@ -125,7 +125,7 @@ ADC模块适配的三个环节是配置属性文件，实例化驱动入口，
}
}
```
- adc_config.hcs 配置参考。
- adc_config.hcs配置参考
```
......@@ -134,13 +134,13 @@ ADC模块适配的三个环节是配置属性文件，实例化驱动入口，
adc_config_hi35xx {
match_attr = "hisilicon_hi35xx_adc";
template adc_device {
regBasePhy = 0x120e0000;//寄存器物理基地址
regSize = 0x34; //寄存器位宽
deviceNum = 0; //设备号
validChannel = 0x1; //有效通道
dataWidth = 10; //信号接收的数据位宽
scanMode = 1; //扫描模式
delta = 0; //delta参数
regBasePhy = 0x120e0000;// 寄存器物理基地址
regSize = 0x34; // 寄存器位宽
deviceNum = 0; // 设备号
validChannel = 0x1; // 有效通道
dataWidth = 10; // 信号接收的数据位宽
scanMode = 1; // 扫描模式
delta = 0; // delta参数
deglitch = 0;
glitchSample = 5000;
rate = 20000;
......@@ -177,7 +177,7 @@ ADC模块适配的三个环节是配置属性文件，实例化驱动入口，
uint32_t rate; //【必要】采样率
};
//AdcDevice是核心层控制器结构体，其中的成员在Init函数中会被赋值
// AdcDevice是核心层控制器结构体，其中的成员在Init函数中会被赋值
struct AdcDevice {
const struct AdcMethod *ops;
OsalSpinlock spin;
......@@ -202,18 +202,18 @@ ADC模块适配的三个环节是配置属性文件，实例化驱动入口，
入参：
HdfDeviceObject是整个驱动对外暴露的接口参数，具备HCS配置文件的信息。
HdfDeviceObject是整个驱动对外暴露的接口参数，具备hcs配置文件的信息。
返回值：
HDF_STATUS相关状态（下表为部分展示，如需使用其他状态，可见//drivers/framework/include/utils/hdf_base.h中HDF_STATUS 定义）。
HDF_STATUS相关状态（下表为部分展示，如需使用其他状态，可见//drivers/framework/include/utils/hdf_base.h中HDF_STATUS定义）。
| 状态(值) | 问题描述 |
| -------- | -------- |
| HDF_ERR_INVALID_OBJECT | 控制器对象非法 |
| HDF_ERR_INVALID_PARAM | 参数非法 |
| HDF_ERR_MALLOC_FAIL | 内存分配失败 |
| HDF_ERR_IO | I/O&nbsp;错误 |
| HDF_ERR_IO | I/O错误 |
| HDF_SUCCESS | 传输成功 |
| HDF_FAILURE | 传输失败 |
......@@ -227,9 +227,9 @@ ADC模块适配的三个环节是配置属性文件，实例化驱动入口，
int32_t ret;
struct DeviceResourceNode *childNode = NULL;
...
//遍历、解析adc_config.hcs中的所有配置节点，并分别调用Hi35xxAdcParseInit函数来初始化device
// 遍历、解析adc_config.hcs中的所有配置节点，并分别调用Hi35xxAdcParseInit函数来初始化device
DEV_RES_NODE_FOR_EACH_CHILD_NODE(device->property, childNode) {
ret = Hi35xxAdcParseInit(device, childNode);//函数定义见下
ret = Hi35xxAdcParseInit(device, childNode);// 函数定义见下
...
}
return ret;
......@@ -258,7 +258,7 @@ ADC模块适配的三个环节是配置属性文件，实例化驱动入口，
return HDF_SUCCESS;
__ERR__:
if (hi35xx != NULL) { //不成功的话，需要反向执行初始化相关函数
if (hi35xx != NULL) { // 不成功的话，需要反向执行初始化相关函数
if (hi35xx->regBase != NULL) {
OsalIoUnmap((void *)hi35xx->regBase);
hi35xx->regBase = NULL;
......@@ -269,11 +269,11 @@ ADC模块适配的三个环节是配置属性文件，实例化驱动入口，
return ret;
}
```
- Release 函数参考
- Release函数参考
入参：
HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息。
HdfDeviceObject是整个驱动对外暴露的接口参数，具备hcs配置文件的信息。
返回值：
......@@ -281,7 +281,7 @@ ADC模块适配的三个环节是配置属性文件，实例化驱动入口，
函数说明：
释放内存和删除控制器，该函数需要在驱动入口结构体中赋值给 Release 接口， 当HDF框架调用Init函数初始化驱动失败时，可以调用 Release 释放驱动资源。所有强制转换获取相应对象的操作**前提**是在Init函数中具备对应赋值的操作。
释放内存和删除控制器，该函数需要在驱动入口结构体中赋值给Release接口，当HDF框架调用Init函数初始化驱动失败时，可以调用Release释放驱动资源。所有强制转换获取相应对象的操作**前提**是在Init函数中具备对应赋值的操作。
```
......@@ -289,9 +289,9 @@ ADC模块适配的三个环节是配置属性文件，实例化驱动入口，
{
const struct DeviceResourceNode *childNode = NULL;
...
//遍历、解析adc_config.hcs中的所有配置节点，并分别进行release操作
// 遍历、解析adc_config.hcs中的所有配置节点，并分别进行release操作
DEV_RES_NODE_FOR_EACH_CHILD_NODE(device->property, childNode) {
Hi35xxAdcRemoveByNode(childNode);//函数定义见下
Hi35xxAdcRemoveByNode(childNode);// 函数定义见下
}
}
......@@ -307,7 +307,7 @@ ADC模块适配的三个环节是配置属性文件，实例化驱动入口，
...
ret = drsOps->GetUint32(node, "deviceNum", (uint32_t *)&deviceNum, 0);
...
//可以调用AdcDeviceGet函数通过设备的deviceNum获取AdcDevice对象， 以及调用AdcDeviceRemove函数来释放AdcDevice对象的内容
// 可以调用AdcDeviceGet函数通过设备的deviceNum获取AdcDevice对象，以及调用AdcDeviceRemove函数来释放AdcDevice对象的内容
device = AdcDeviceGet(deviceNum);
if (device != NULL && device->priv == node) {
AdcDevicePut(device);
......
zh-cn/device-dev/driver/driver-platform-dac-des.md
浏览文件 @ 149d393f
......@@ -5,11 +5,11 @@
### 功能简介
- DAC（Digital to Analog Converter）是一种通过电流、电压或电荷的形式将数字信号转换为模拟信号的设备 。
DAC（Digital to Analog Converter）是一种通过电流、电压或电荷的形式将数字信号转换为模拟信号的设备。
- DAC接口定义了完成DAC传输的通用方法集合，包括：
- DAC设备管理：打开或关闭DAC设备。
- DAC设置目标值：设置DAC设备需要将数字信号转成模拟信号的目标值。
DAC接口定义了完成DAC传输的通用方法集合，包括：
- DAC设备管理：打开或关闭DAC设备。
- DAC设置目标值：设置DAC设备需要将数字信号转成模拟信号的目标值。
### 基本概念
......@@ -31,7 +31,7 @@ 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位（即最低位）。
......@@ -41,7 +41,7 @@ DAC模块支持数模转换的开发，它主要用于：
DAC模块各分层的作用为：接口层提供打开设备，写入数据，关闭设备的接口。核心层主要提供绑定设备、初始化设备以及释放设备的能力。适配层实现其他具体的功能。
![](../public_sys-resources/icon-note.gif) 说明：核心层可以调用接口层的函数，核心层通过钩子函数调用适配层函数，从而适配层间接的可以调用接口层函数，但是不可逆转接口层调用适配层函数。
![](../public_sys-resources/icon-note.gif) 说明：<br>核心层可以调用接口层的函数，核心层通过钩子函数调用适配层函数，从而适配层间接的可以调用接口层函数，但是不可逆转接口层调用适配层函数。
**图 1** DAC统一服务模式
......@@ -49,7 +49,7 @@ DAC模块各分层的作用为：接口层提供打开设备，写入数据，
### 约束与限制
DAC模块当前仅支持轻量和小型系统内核（LiteOS） 。
DAC模块当前仅支持轻量和小型系统内核（LiteOS）。
## 使用指导
......@@ -181,7 +181,7 @@ DAC设备的具体使用方式可以参考如下示例代码，示例代码步
/* DAC例程总入口 */
static int32_t TestCaseDac(void)
{
//设置要写入的val值
// 设置要写入的val值
uint32_t val = 2;
int32_t ret;
DevHandle dacHandle;
......
zh-cn/device-dev/driver/driver-platform-dac-develop.md
浏览文件 @ 149d393f
......@@ -4,15 +4,15 @@
### 功能简介
DAC（Digital to Analog Converter）是一种通过电流、电压或电荷的形式将数字信号转换为模拟信号的设备 。
### 基本概念
DAC（Digital to Analog Converter）是一种通过电流、电压或电荷的形式将数字信号转换为模拟信号的设备。
DAC模块支持数模转换的开发。它主要用于：
1. 作为过程控制计算机系统的输出通道，与执行器相连，实现对生产过程的自动控制。
2. 在利用反馈技术的魔术转换器设计中，作为重要的功能模块呈现。
### 基本概念
- 分辨率
分辨率指的是D/A转换器能够转换的二进制位数，位数越多分辨率越高。
......@@ -35,7 +35,7 @@ DAC模块支持数模转换的开发。它主要用于：
DAC模块各分层的作用为：接口层提供打开设备，写入数据，关闭设备接口的能力。核心层主要提供绑定设备、初始化设备以及释放设备的能力。适配层实现其他具体的功能。
![](../public_sys-resources/icon-note.gif) 说明：核心层可以调用接口层的函数，也可以通过钩子函数调用适配层函数，从而使得适配层间接的可以调用接口层函数，但是不可逆转接口层调用适配层函数。
![](../public_sys-resources/icon-note.gif) 说明：<br>核心层可以调用接口层的函数，也可以通过钩子函数调用适配层函数，从而使得适配层间接的可以调用接口层函数，但是不可逆转接口层调用适配层函数。
**图 1** 统一服务模式
......@@ -62,11 +62,11 @@ DacMethod定义：
```
struct DacMethod {
//写入数据的钩子函数
// 写入数据的钩子函数
int32_t (*write)(struct DacDevice *device, uint32_t channel, uint32_t val);
//启动DAC设备的钩子函数
// 启动DAC设备的钩子函数
int32_t (*start)(struct DacDevice *device);
//停止DAC设备的钩子函数
// 停止DAC设备的钩子函数
int32_t (*stop)(struct DacDevice *device);
};
```
......@@ -77,9 +77,9 @@ struct DacMethod {
| 函数成员 | 入参 | 出参 | 返回值 | 功能 |
| -------- | ------------------------------------------------------------ | ---- | ------------------ | -------------- |
| write | device：结构体指针，核心层DAC控制器；<br>channel：uint32_t，传入的通道号；<br>val：uint32_t，要传入的数据； | 无 | HDF_STATUS相关状态 | 写入DA的目标值 |
| start | device：结构体指针，核心层DAC控制器； | 无 | HDF_STATUS相关状态 | 开启DAC设备 |
| stop | device：结构体指针，核心层DAC控制器； | 无 | HDF_STATUS相关状态 | 关闭DAC设备 |
| write | device：结构体指针，核心层DAC控制器<br>channel：uint32_t，传入的通道号<br>val：uint32_t，要传入的数据 | 无 | HDF_STATUS相关状态 | 写入DA的目标值 |
| start | device：结构体指针，核心层DAC控制器 | 无 | HDF_STATUS相关状态 | 开启DAC设备 |
| stop | device：结构体指针，核心层DAC控制器 | 无 | HDF_STATUS相关状态 | 关闭DAC设备 |
......@@ -92,7 +92,7 @@ DAC模块适配包含以下四个步骤：
- 实例化核心层接口函数。
- 驱动调试。
1. **实例化驱动入口：**
1. 实例化驱动入口：
驱动开发首先需要实例化驱动入口，驱动入口必须为HdfDriverEntry（在 hdf_device_desc.h 中定义）类型的全局变量，且moduleName要和device_info.hcs中保持一致。 HDF框架会汇总所有加载的驱动的HdfDriverEntry对象入口 ，形成一个类似数组的段地址空间，方便上层调用。
......@@ -105,10 +105,10 @@ DAC模块适配包含以下四个步骤：
.Release = VirtualDacRelease,
.moduleName = "virtual_dac_driver", //【必要且与 HCS 里面的名字匹配】
};
HDF_INIT(g_dacDriverEntry); //调用HDF_INIT将驱动入口注册到HDF框架中
HDF_INIT(g_dacDriverEntry); // 调用HDF_INIT将驱动入口注册到HDF框架中
```
2. **配置属性文件：**
2. 配置属性文件：
- 在vendor/hisilicon/hispark_taurus/hdf_config/device_info/device_info.hcs文件中添加deviceNode描述。
......@@ -119,7 +119,7 @@ DAC模块适配包含以下四个步骤：
| 成员名 | 值 |
| --------------- | ------------------------------------------------------------ |
| policy | 具体配置为0，不发布服务|
| priority | 驱动启动优先级（0-200），值越大优先级越低,，优先级相同则不保证device的加载顺序。|
| priority | 驱动启动优先级（0-200），值越大优先级越低，优先级相同则不保证device的加载顺序。|
| permission | 驱动权限|
| moduleName | 固定为HDF_PLATFORM_DAC_MANAGER|
| serviceName | 固定为HDF_PLATFORM_DAC_MANAGER|
......@@ -127,12 +127,12 @@ DAC模块适配包含以下四个步骤：
从第二个节点开始配置具体DAC控制器信息，此节点并不表示某一路DAC控制器，而是代表一个资源性质设备，用于描述一类DAC控制器的信息。本例只有一个DAC设备，如有多个设备，则需要在device_info文件增加deviceNode信息，以及在dac_config文件中增加对应的器件属性。
device_info.hcs 配置参考。
device_info.hcs配置参考。
```
root {
device_dac :: device {
//device0是DAC管理器
// device0是DAC管理器
device0 :: deviceNode {
policy = 0;
priority = 52;
......@@ -141,7 +141,7 @@ DAC模块适配包含以下四个步骤：
moduleName = "HDF_PLATFORM_DAC_MANAGER";
}
}
//dac_virtual是DAC控制器
// dac_virtual是DAC控制器
dac_virtual :: deviceNode {
policy = 0;
priority = 56;
......@@ -154,7 +154,7 @@ DAC模块适配包含以下四个步骤：
```
- 添加dac_test_config.hcs器件属性文件
在vendor/vendor_hisilicon/hispark_taurus/hdf_config/hdf_test/xxx_test_config.hcs目录下新增文件用于驱动配置参数，（例如：vendor/vendor_hisilicon/hispark_taurus/hdf_config/hdf_test/dac_test_config.hcs）其中配置参数如下
在vendor/vendor_hisilicon/hispark_taurus/hdf_config/hdf_test/xxx_test_config.hcs目录下新增文件用于驱动配置参数，（例如：vendor/vendor_hisilicon/hispark_taurus/hdf_config/hdf_test/dac_test_config.hcs）其中配置参数如下：
```
root {
......@@ -162,79 +162,79 @@ DAC模块适配包含以下四个步骤：
dac_config {
match_attr = "virtual_dac"; //【必要】需要和device_info.hcs中的deviceMatchAttr值一致
template dac_device {
deviceNum = 0; //设备号
validChannel = 0x1; //有效通道1
rate = 20000; //速率
deviceNum = 0; // 设备号
validChannel = 0x1; // 有效通道1
rate = 20000; // 速率
}
device_0 :: dac_device {
deviceNum = 0; //设备号
validChannel = 0x2; //有效通道2
deviceNum = 0; // 设备号
validChannel = 0x2; // 有效通道2
}
}
}
}
```
3. **实例化核心层接口函数：**
3. 实例化核心层接口函数：
- 初始化DacDevice成员。
在VirtualDacParseAndInit函数中对DacDevice成员进行初始化操作。
```
//虚拟驱动自定义结构体
// 虚拟驱动自定义结构体
struct VirtualDacDevice {
//DAC设备结构体
// DAC设备结构体
struct DacDevice device;
//DAC设备号
// DAC设备号
uint32_t deviceNum;
//有效通道
// 有效通道
uint32_t validChannel;
//DAC速率
// DAC速率
uint32_t rate;
};
//解析并且初始化核心层DacDevice对象
// 解析并且初始化核心层DacDevice对象
static int32_t VirtualDacParseAndInit(struct HdfDeviceObject *device, const struct DeviceResourceNode *node)
{
//定义返回值
// 定义返回值
int32_t ret;
//DAC设备虚拟指针
// DAC设备虚拟指针
struct VirtualDacDevice *virtual = NULL;
(void)device;
//给virtual指针开辟空间
// 给virtual指针开辟空间
virtual = (struct VirtualDacDevice *)OsalMemCalloc(sizeof(*virtual));
if (virtual == NULL) {
//为空则返回错误参数
// 为空则返回错误参数
HDF_LOGE("%s: Malloc virtual fail!", __func__);
return HDF_ERR_MALLOC_FAIL;
}
//读取属性文件配置参数
// 读取属性文件配置参数
ret = VirtualDacReadDrs(virtual, node);
if (ret != HDF_SUCCESS) {
//读取失败
// 读取失败
HDF_LOGE("%s: Read drs fail! ret:%d", __func__, ret);
//释放virtual空间
// 释放virtual空间
OsalMemFree(virtual);
//指针置为0
// 指针置为0
virtual = NULL;
return ret;
}
//初始化虚拟指针
// 初始化虚拟指针
VirtualDacDeviceInit(virtual);
//对DacDevice中priv对象初始化
// 对DacDevice中priv对象初始化
virtual->device.priv = (void *)node;
//对DacDevice中devNum对象初始化
// 对DacDevice中devNum对象初始化
virtual->device.devNum = virtual->deviceNum;
//对DacDevice中ops对象初始化
// 对DacDevice中ops对象初始化
virtual->device.ops = &g_method;
//添加DAC设备
// 添加DAC设备
ret = DacDeviceAdd(&virtual->device);
if (ret != HDF_SUCCESS) {
//添加设备失败
// 添加设备失败
HDF_LOGE("%s: add Dac controller failed! ret = %d", __func__, ret);
//释放virtual空间
// 释放virtual空间
OsalMemFree(virtual);
//虚拟指针置空
// 虚拟指针置空
virtual = NULL;
return ret;
}
......@@ -257,12 +257,12 @@ DAC模块适配包含以下四个步骤：
uint32_t rate; //【必要】采样率
};
//DacDevice是核心层控制器结构体，其中的成员在Init函数中会被赋值
// DacDevice是核心层控制器结构体，其中的成员在Init函数中会被赋值
struct DacDevice {
const struct DacMethod *ops;
OsalSpinlock spin; //自旋锁
uint32_t devNum; //设备号
uint32_t chanNum; //设备通道号
OsalSpinlock spin; // 自旋锁
uint32_t devNum; // 设备号
uint32_t chanNum; // 设备通道号
const struct DacLockMethod *lockOps;
void *priv;
};
......@@ -275,13 +275,13 @@ DAC模块适配包含以下四个步骤：
```
static const struct DacMethod g_method = {
.write = VirtualDacWrite, //DAC设备写入值
.stop = VirtualDacStop, //停止DAC设备
.start = VirtualDacStart, //开始启动DAC设备
.write = VirtualDacWrite, // DAC设备写入值
.stop = VirtualDacStop, // 停止DAC设备
.start = VirtualDacStart, // 开始启动DAC设备
};
```
![](../public_sys-resources/icon-note.gif) **说明：**
![](../public_sys-resources/icon-note.gif) **说明：**<br>
DacDevice成员DacMethod的定义和成员说明见[接口说明](#接口说明)。
......@@ -289,7 +289,7 @@ DAC模块适配包含以下四个步骤：
入参：
HdfDeviceObject这个是整个驱动对外暴露的接口参数，具备HCS配置文件的信息。
HdfDeviceObject这个是整个驱动对外暴露的接口参数，具备hcs配置文件的信息。
返回值：
......@@ -386,11 +386,11 @@ DAC模块适配包含以下四个步骤：
}
```
- Release 函数参考
- Release函数参考
入参：
HdfDeviceObject是整个驱动对外暴露的接口参数，具备HCS配置文件的信息。
HdfDeviceObject是整个驱动对外暴露的接口参数，具备hcs配置文件的信息。
返回值：
......@@ -461,7 +461,7 @@ DAC模块适配包含以下四个步骤：
}
```
4. **驱动调试：**
4. 驱动调试：
【可选】针对新增驱动程序，建议验证驱动基本功能，例如挂载后的测试用例是否成功等。
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或