From 25e19c91d9a0138a79672951719aaa11dac31464 Mon Sep 17 00:00:00 2001 From: king_he <6384784@qq.com> Date: Thu, 12 May 2022 12:08:17 +0000 Subject: [PATCH] update zh-cn/device-dev/driver/driver-platform-dac-develop.md. Signed-off-by: king_he <6384784@qq.com> --- .../driver/driver-platform-dac-develop.md | 114 +++++++++--------- 1 file changed, 57 insertions(+), 57 deletions(-) diff --git a/zh-cn/device-dev/driver/driver-platform-dac-develop.md b/zh-cn/device-dev/driver/driver-platform-dac-develop.md index e49271234b..11a9961805 100644 --- a/zh-cn/device-dev/driver/driver-platform-dac-develop.md +++ b/zh-cn/device-dev/driver/driver-platform-dac-develop.md @@ -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控制器；
channel：uint32_t，传入的通道号；
val：uint32_t，要传入的数据； | 无 | HDF_STATUS相关状态 | 写入DA的目标值 | -| start | device：结构体指针，核心层DAC控制器； | 无 | HDF_STATUS相关状态 | 开启DAC设备 | -| stop | device：结构体指针，核心层DAC控制器； | 无 | HDF_STATUS相关状态 | 关闭DAC设备 | +| write | device：结构体指针，核心层DAC控制器
channel：uint32_t，传入的通道号
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) **说明：**
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. 驱动调试： 【可选】针对新增驱动程序，建议验证驱动基本功能，例如挂载后的测试用例是否成功等。 -- GitLab