Skip to content

D
Docs

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

通知 161
Star 293
Fork 28
D
Docs
“c7aa4a108b214226abec7297c1f299da7fcab29d”上不存在“tests/git@gitcode.net:taosdata/tdengine.git”
未验证 提交 25e19c91 编写于 作者: K king_he 提交者： Gitee
浏览文件
操作

update zh-cn/device-dev/driver/driver-platform-dac-develop.md. 

Signed-off-by: Nking_he <6384784@qq.com>
上级 51bfd905
显示空白变更内容
内联 并排
Showing with 57 addition and 57 deletion
zh-cn/device-dev/driver/driver-platform-dac-develop.md
浏览文件 @ 25e19c91
......@@ -4,15 +4,15 @@
### 功能简介
DAC（Digital to Analog Converter）是一种通过电流、电压或电荷的形式将数字信号转换为模拟信号的设备 。
### 基本概念
DAC（Digital to Analog Converter）是一种通过电流、电压或电荷的形式将数字信号转换为模拟信号的设备。
DAC模块支持数模转换的开发。它主要用于：
1. 作为过程控制计算机系统的输出通道，与执行器相连，实现对生产过程的自动控制。
2. 在利用反馈技术的魔术转换器设计中，作为重要的功能模块呈现。
### 基本概念
- 分辨率
分辨率指的是D/A转换器能够转换的二进制位数，位数越多分辨率越高。
......@@ -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.
先完成此消息的编辑！
想要评论请 注册 或