手机网站切图,织梦网站模板怎么用,网站域名的作用是什么,ui中国网站OpenHarmony HDF 平台驱动
1.平台驱动概述 系统平台驱动框架是系统驱动框架的重要组成部分#xff0c;它基于HDF驱动框架、操作系统适配层(OSAL, operating system abstraction layer)以及驱动配置管理机制#xff0c;为各类平台设备驱动的实现提供标准模型。 系统平台驱动(…OpenHarmony HDF 平台驱动
1.平台驱动概述 系统平台驱动框架是系统驱动框架的重要组成部分它基于HDF驱动框架、操作系统适配层(OSAL, operating system abstraction layer)以及驱动配置管理机制为各类平台设备驱动的实现提供标准模型。 系统平台驱动(PlatformDriver)即平台设备驱动它用于驱动平台设备(PlatformDevice)为系统及外设驱动提供访接口。这里的平台设备泛指I2C/UART等总线、以及GPIO/RTC等SOC片内硬件资源。 系统平台驱动框架为外设提供了标准的平台设备访问接口使其不必关注具体硬件及OS平台同时为平台设备驱动提供统一的适配接口使其只关注自身硬件的控制。 为实现这个目标OpenHarmony系统平台驱动框架满足如下特性
统一的平台设备访问接口对平台设备操作接口进行统一封装屏蔽不同SOC平台硬件差异以及不同OS形态差异。统一的平台驱动适配接口为平台设备驱动提供统一的适配接口使其只关注自身硬件的控制而不必关注设备管理及公共业务流程。提供设备注册、管理、访问控制等与SOC无关的公共能力。
2.平台驱动框架介绍 OpenHarmony系统平台驱动框架主要由平台接口层、平台核心层以及平台适配层三个部分组成。 平台接口层 以API的形式提供标准的平台设备访问接口。 平台接口层以设备句柄加配套API的形式对外提供统一的、标准的访问接口。 设备句柄是DevHandle类型的实例通过不同设备模块提供的Open/Close方法进行获取、释放。成功获取设备句柄后即可使用相应的API执行设备操作。例如通过I2cTransfer完成一次I2C数据传输。 这是一种代理模式即接口层API不直接引用实际设备对象而是通过DevHandle作为代理间接访问设备而所有来自外设驱动的访问都建议走接口层以获得最佳的稳定性。 平台核心层 提供平台设备模型及公共业务框架。 提供统一适配接口定义了标准的设备对象模型驱动程序仅需关注标准对象模型的适配。 抽取公共业务框架将不同设备模块的公共流程、算法加以抽取使得具体设备驱动更加轻薄。 设备管理设备注册、注销、设备查找、访问控制。 平台适配层 提供特定平台设备的适配驱动并遵守核心层约束。 驱动具体平台设备硬件并创建对应的设备模型对象注册到核心层纳入统一管理。
2.1.平台接口层分析 接口层用DevHandle类型的设备句柄表示一个平台设备对象然后针对不同类型设备提供一套标准的API方法用于设备访问。那么设备句柄和真实的设备对象如何关联呢 drivers_hdf_core/framework/include/platform/platform_if.h:39 /**40 * brief Defines the common device handle of the platform driver.41 *42 * The handle is associated with a specific platform device and is used as the43 * first input parameter for all APIs of the platform driver.44 *45 * since 1.046 */47 typedef void* DevHandle;在内核态这个指针可以直接指向实际设备对象但是对于某些类型的平台设备需要在用户态提供同样的DevHandle类型及配套API而实际设备对象在内核空间导致无法直接获取和使用内核空间的地址。 解决办法将平台设备对象实现为一个HDF设备服务这样借助HDF DeviceManager的设备服务机制可以在用户态、内核态同时获取到设备服务而用户态同内核态通信的问题交由HDF DeviceManager处理。此时DevHandle只需要关联到这个设备服务即可而void*类型保证了足够的灵活性。 根据DevHandle和设备对象关联方式的不同接口层的设计有三种模式
2.1.1.独立服务模式 典型实践是UART模块。 使用范围在用户态和内核态同时提供API的设备类型DevHandle同设备对象的关联方式为 用户态关联到平台设备对应的设备服务 内核态关联到实际平台设备对象或其设备服务(在内核态两者可互相转换) 每一个设备对象会独立发布一个设备服务来处理外部访问服务收到API的访问请求之后通过提取请求参数并调用实际设备对象的相应内部方法。 优点管理比较简单因为它借助了HDF DeviceManager的服务管理能力 缺点需要为每一个设备对象配置设备节点以便发布设备服务。
2.1.2.统一服务模式 典型实践是I2C模块。 同一类型的设备对象可能会很多例如I2C模块可能同时有十几个控制器。如果采用独立服务的模式每一个控制器作为一个平台设备为其创建一个设备服务那么将会有十几个服务被创建不光要配置很多设备节点而且这些服务还会占用内存资源。 因此为一类设备对象创建一个平台设备管理器(PlatformManager)对象并同时对外发布一个管理器服务由这个管理器服务来统一处理外部访问。当用户需要打开某个设备时先通过HDF DeviceManager获取到管理器服务然后管理器服务根据用户指定参数查找到指定设备并返回一个设备描述符而这个描述符仍然可以由DevHandle类型表示。
2.1.3.无服务模式 用于不需要在用户态提供API的设备类型或者没有用户态、内核区分的OS系统其关联方式是DevHandle直接指向设备对象内核态地址。而PlatformManager的实现比较自由它不需要实现设备服务只需做好某种类型的设备管理即可甚至在C语言中由于无法进行OOP编程很多模块直接将这个功能面向过程化了使得没有一个具体的结构体与之对应。
2.2.平台核心层 平台核心层的作用是承上启下其主要内容包括 提供适配接口为具体的平台设备驱动提供统一的适配接口 平台驱动框架为不同设备类型定义了标准的设备对象模型具体设备驱动只需要关注标准设备对象的适配即可 提供设备管理提供设备的注册、注销、查找等功能、访问控制等能力 核心层会提供一系列内部方法用于设备的注册、注销设备对象的查找、获取、释放以及处理多线程访问。例如当向核心层注册一个I2C控制器对象时使用I2cCntlrAdd当希望获取一个I2C控制器对象时通过I2cCntlrGet并指定控制器编号当不再使用这个对象时还需要通过I2cCntlrPut释放。这样做的好处是将每一个具体的操作步骤高度抽象化减小同平台接口层及平台适配层的耦合面便于业务解耦、演进。由于业务需求需要对I2cCntlr对象进行引用计数那么只需要修改I2cCntlrGet/Put这对方法的实现即可并不会影响平台接口层和平台适配层。 公共业务实现抽取公共的业务流程、算法 凡是跟特定硬件无关的业务逻辑都会被抽取到核心层例如RTC时钟的时间格式转换算法GPIO模块的线程中断实现等等。
2.3.平台适配层实现 适配层提供具体平台硬件设备的驱动按照核心层定义的模型创建设备对象并完成对象的初始化(包括必要的成员变量初始化以及钩子方法挂接以及相关的硬件初始化操作)最后使用核心层提供的注册方法将设备对象注册到核心层纳入统一管理。
3.OpenHarmony系统平台驱动适配
3.1.UART模块适配 UART模块适配的核心环节是UartHost对象的创建、初始化及注册。UART模块采用的是独立服务模式要求每一个UartHost对象关联一个HDF设备服务。
1).device_info.hcs: 为每一个UART控制器配置一个HDF设备节点 vendor/hihope/rk3568/hdf_config/khdf/device_info/device_info.hcs:71 device_uart :: device {72 device0 :: deviceNode {73 policy 2;74 priority 40;75 permission 0644;76 moduleName HDF_PLATFORM_UART;77 serviceName HDF_PLATFORM_UART_0;78 deviceMatchAttr rockchip_rk3568_uart_0;79 }80 device1 :: deviceNode {81 policy 2;82 permission 0644;83 priority 40;84 moduleName HDF_PLATFORM_UART;85 serviceName HDF_PLATFORM_UART_1;86 deviceMatchAttr rockchip_rk3568_uart_1;87 }88 device2 :: deviceNode {89 policy 2;90 permission 0644;91 priority 40;92 moduleName HDF_PLATFORM_UART;93 serviceName HDF_PLATFORM_UART_3;94 deviceMatchAttr rockchip_rk3568_uart_3;95 }96 }说明 policy大于等于1如需对用户态可见为2仅内核态可见为1 moduleName需要与驱动Entry中moduleName 保持一致 serviceName必须要按照HDF_PLATFORM_UART_X的格式X为UART控制器编号 deviceMatchAttr用于配置控制器私有数据要与uart_config.hcs中对应控制器保持一致如不需要则忽略。
2). uart_config.hcs每一个UART控制器配置私有数据 如果控制器需要配置一些私有数据例如寄存器基地址初始化波特率等等可以在uart_config.hcs中配置该文件将在产品配置目录的hdf.hcs中导入具体路径可由产品自由配置。 vendor/hihope/rk3568/hdf_config/khdf/platform/rk3568_uart_config.hcs1 root {2 platform {3 uart_config {4 template uart_device {5 serviceName ;6 match_attr ;7 driver_name ttyS;8 num 0;9 }1011 device_uart_0x0000 :: uart_device {12 match_attr rockchip_rk3568_uart_0;13 }14 device_uart_0x0001 :: uart_device {15 num 1;16 match_attr rockchip_rk3568_uart_1;17 }18 device_uart_0x0003 :: uart_device {19 num 3;20 match_attr rockchip_rk3568_uart_3;21 }22 }23 }24 }hihope/rk3568/hdf_config/khdf/hdf.hcs1 #include device_info/device_info.hcs2 #include platform/adc_config_linux.hcs3 #include platform/pwm_config.hcs4 #include platform/rk3568_watchdog_config.hcs5 #include platform/rk3568_uart_config.hcs6 #include platform/sdio_config.hcs7 #include platform/emmc_config.hcs8 #include platform/rk3568_spi_config.hcs9 #include input/input_config.hcs10 #include wifi/wlan_platform.hcs11 #include wifi/wlan_chip_ap6275s.hcs12 #include camera/camera_config.hcs13 #include sensor/sensor_config.hcs14 #include audio/audio_config.hcs15 #include audio/codec_config.hcs16 #include audio/dai_config.hcs17 #include audio/dma_config.hcs18 #include audio/dsp_config.hcs19 #include audio/analog_headset_config.hcs20 #include light/light_config.hcs21 #include vibrator/vibrator_config.hcs22 #include vibrator/linear_vibrator_config.hcs23 #include vibrator/drv2605l_linear_vibrator_config.hcs24 #include lcd/lcd_config.hcs3).驱动的Entry结构
先执行Bind方法绑定服务后执行Init 初始化。
drivers_hdf_core\framework\sample\platform\uart\src\uart_sample.c
struct HdfDriverEntry g_sampleUartDriverEntry {.moduleVersion 1,.moduleName UART_SAMPLE,.Bind SampleUartDriverBind,.Init SampleUartDriverInit,.Release SampleUartDriverRelease,
};// Initialize HdfDriverEntry
HDF_INIT(g_sampleUartDriverEntry);Bind方法调用UartHostCreate创建 UartHost 控制器对象并完成服务绑定。
drivers_hdf_coreframework\support\platform\include\uart\uart_core.h:
struct UartHost {struct IDeviceIoService service;struct HdfDeviceObject *device;uint32_t num;OsalAtomic atom;void *priv;struct UartHostMethod *method;
};drivers_hdf_core\framework\sample\platform\uart\src\uart_sample.c
static int32_t SampleUartDriverBind(struct HdfDeviceObject *device)
{struct UartHost *uartHost NULL;HDF_LOGD(%s: Enter, __func__);uartHost UartHostCreate(device);uartHost-service.Dispatch SampleDispatch;return HDF_SUCCESS;
}drivers_hdf_core/framework/support/platform/src/uart/uart_core.c79 struct UartHost *UartHostCreate(struct HdfDeviceObject *device)80 {81 struct UartHost *host NULL;8288 host (struct UartHost *)OsalMemCalloc(sizeof(*host));9394 host-device device;95 device-service (host-service);96 host-device-service-Dispatch UartIoDispatch;97 OsalAtomicSet(host-atom, 0);98 host-priv NULL;99 host-method NULL;
100 return host;
101 }该方法中将UartHost对象同HdfDeviceObject进行关联
为HdfDeviceObject的service成员进行赋值使其指向UartHost的IDeviceIoService类型的成员对象同时为service成员的Dispatch方法赋值。 UartHostCreate函数设置host-device-service-Dispatch UartIoDispatch; 最后SampleUartDriverBind函数使用uartHost-service.Dispatch SampleDispatch; 进行覆盖UartIoDispatch。 这样做的结果 为HdfDeviceObject对象绑定IDeviceIoService类型的服务对象 UartHost和其IDeviceIoService类型的成员对象service可以相互转换 通过UartHost对象即可获取HdfDeviceObject对象 通过HdfDeviceObject对象即可间接获取UartHost对象(先获取service再转为host)
4). Init方法 完成UartHost对象的初始化。代码调用流程
SampleUartDriverInit-AttachUartDevice-AddUartDevice-AddRemoveUartDev-register_driver-host-method g_sampleUartHostMethod;代码分析
drivers_hdf_core\framework\sample\platform\uart\src\uart_sample.c
static int32_t SampleUartDriverInit(struct HdfDeviceObject *device)
{int32_t ret;struct UartHost *host NULL;HDF_LOGD(%s: Enter, __func__);host UartHostFromDevice(device);ret AttachUartDevice(host, device);host-method g_sampleUartHostMethod;return ret;
}struct UartHostMethod g_sampleUartHostMethod {.Init SampleUartHostInit,.Deinit SampleUartHostDeinit,.Read NULL,.Write SampleUartHostWrite,.SetBaud SampleUartHostSetBaud,.GetBaud SampleUartHostGetBaud,.SetAttribute NULL,.GetAttribute NULL,.SetTransMode NULL,
};通过UartHostFromDevice从HdfDeviceObject对象获取之前关联的UartHost对象然后调用 AttachUartDevice方法完成host对象的初始化最后为host对象挂接钩子方法g_sampleUartHostMethod。 小结 UART适配关键是在驱动Entry的Bind方法中创建UartHost对象而且是使用UartHostCreate创建。这个创建动作同时也是注册的动作因为它将UartHost以HDF设备服务的形式同HdfDeviceObject进行绑定这样就完成了服务的发布HDF Manager对设备服务的管理也就是对UartHost的管理核心层可以通过HDF提供的服务获取接口来访问UartHost。 UART适配采用独立服务模式每一个UartHost对象同时也是一个设备服务其优点是可以直接利用HDF Manager进行管理缺点是需要在device_info.hcs为每一个UartHost对象定义设备节点。
3.2.UART模块主要接口
drivers/hdf_core/framework/include/platform/uart_if.h
DevHandle UartOpen(uint32_t port) UART获取设备句柄
void UartClose(DevHandle handle) UART释放设备句柄
int32_t UartRead(DevHandle handle, uint8_t *data, uint32_t size) 从UART设备中读取指定长度的数据
int32_t UartWrite(DevHandle handle, uint8_t *data, uint32_t size) 向UART设备中写入指定长度的数据
int32_t UartGetBaud(DevHandle handle, uint32_t *baudRate) UART获取波特率
int32_t UartSetBaud(DevHandle handle, uint32_t baudRate) UART设置波特率
int32_t UartGetAttribute(DevHandle handle, struct UartAttribute *attribute) UART获取设备属性
int32_t UartSetAttribute(DevHandle handle, struct UartAttribute *attribute) UART设置设备属性
int32_t UartSetTransMode(DevHandle handle, enum UartTransMode mode) UART设置传输模式本文涉及的UART所有接口支持内核态及用户态使用。 3.2.1.UartOpen
UartOpen-UartGetObjGetByBusNum(port);- DevSvcManagerClntGetService(name) - UartHostRequest((struct UartHost *)handle);UartGetObjGetByBusNum 调用DevSvcManagerClntGetService根据name“HDF_PLATFORM_UART_port” (framework/sample/config/device_info/device_info.hcs) 获取到handle 即host。UartHostRequest 调用host-method-Init即UartHostDevInituart_asr.c
3.2.2.UartWrite
int32_t UartWrite(struct DevHandle *handle, uint8_t *data, uint32_t size)
{int ret;struct HdfIoService *service NULL;struct HdfSBuf *sBuf HdfSbufObtainDefaultSize();if (!HdfSbufWriteBuffer(sBuf, data, size)) {HDF_LOGE(Failed to write sbuf);HdfSbufRecycle(sBuf);return HDF_FAILURE;}service (struct HdfIoService *)handle-object;ret service-dispatcher-Dispatch(service-object, UART_WRITE, sBuf, NULL);HdfSbufRecycle(sBuf);return ret;
}调用Dispatch接口进行写操作即SampleDispatch通过传输cmd 为UART_WRITE调用SampleDispatchWrite然后调用UartPl011Write调用底层代码进行传输数据。
drivers_hdf_core\framework\sample\platform\uart\src\uart_dispatch_sample.c
int32_t SampleDispatch(struct HdfDeviceIoClient *client, int cmdId, struct HdfSBuf *data, struct HdfSBuf *reply)
{int32_t result HDF_FAILURE;(void)reply;struct UartHost *uartHost (struct UartHost *)client-device-service;struct UartDevice *uartDevice (struct UartDevice *)uartHost-priv;switch (cmdId) {case UART_WRITE: {result SampleDispatchWrite(uartDevice, data);break;}default:break;}return result;
}static int32_t SampleDispatchWrite(struct UartDevice *device, struct HdfSBuf *txBuf)
{uint32_t idx;uint32_t dataSize 0;const uint8_t *data NULL;struct UartRegisterMap *regMap (struct UartRegisterMap *)device-resource.physBase;if (!HdfSbufReadBuffer(txBuf, (const void **)data, dataSize)) {HDF_LOGE(%s: Failed to read sbuf, __func__);return HDF_FAILURE;}regMap (struct UartRegisterMap *)device-resource.physBase;for (idx 0; idx dataSize; idx) {UartPl011Write(regMap, data[idx]);}return HDF_SUCCESS;
}drivers_hdf_core\framework\sample\platform\uart\include\uart_pl011_sample.h
static inline void UartPl011Write(struct UartRegisterMap *regMap, uint8_t byte)
{while (UartPl011IsBusy(regMap)) {}regMap-dr byte;
}3.3.用户层测试代码
通过/dev/uartdev-%d 节点访问
drivers_hdf_core\framework\sample\platform\uart\dev\hello_uart_dev.c
int main(void)
{int ret;int fd;const char info[INFO_SIZE] { HELLO UART! };fd open(/dev/uartdev-5, O_RDWR);if (fd 0) {HDF_LOGE(uartdev-5 open failed %d, fd);return -1;}ret write(fd, info, INFO_SIZE);if (ret ! 0) {HDF_LOGE(write uartdev-5 ret is %d, ret);}ret close(fd);if (ret ! 0) {HDF_LOGE(uartdev-5 close failed %d, fd);return -1;}return ret;
}使用UartOpen 接口进行方法
drivers_hdf_core\framework\sample\platform\uart\dispatch\hello_uart_dispatch.c
int main(void)
{const char *info HELLO UART! ;struct DevHandle *handle UartOpen(UART_PORT);int ret UartWrite(handle, (uint8_t *)info, strlen(info));UartClose(handle);return ret;
}refer to
git clone https://gitee.com/openharmony/drivers_hdf_core.githttps://blog.csdn.net/HarmonyOS_666/article/details/140824175https://blog.csdn.net/maniuT/article/details/141064333https://blog.csdn.net/zxc95279527q/article/details/143062695
