RK3568 Android 15驱动开发实战：从环境搭建到HAL层适配

这次我们来看一个专门针对RK3568平台和Android 15系统的驱动开发实战课程——《蔡工RK3568_Android15驱动开发实战课程-基于正点原子的开发板》。这个课程最大的特点是基于正点原子ATK-DLRK3568开发板从零开始讲解Android 15系统下的驱动开发全流程。对于嵌入式开发者来说RK3568作为一款中高端ARM处理器在智能终端、工业控制、边缘计算等领域应用广泛。而Android 15作为最新的Android版本带来了许多底层驱动架构的更新。这个课程正好填补了市场空白提供了从环境搭建到实战开发的完整解决方案。课程的核心价值在于实战性——不是单纯的理论讲解而是基于真实的开发板进行实际操作。从材料看课程涵盖了驱动开发的基础知识、RK3568硬件特性、Android 15内核配置、各种外设驱动开发以及实际项目案例。对于想要深入理解Android底层驱动或者需要在RK3568平台上进行产品开发的工程师来说这是一个很实用的学习资源。1. 核心能力速览能力项说明目标平台正点原子ATK-DLRK3568开发板系统版本Android 15开发重点Linux内核驱动、HAL层适配、外设驱动开发硬件要求开发板、USB转串口工具、调试器软件环境Linux开发环境、Android源码、编译工具链适合人群嵌入式驱动工程师、Android系统开发人员实战内容从环境搭建到项目实战的完整流程2. 适用场景与使用边界这个课程主要面向有一定嵌入式基础的开发者特别是那些需要在实际项目中应用RK3568和Android 15的工程师。如果你正在从事以下工作这个课程会很有帮助智能终端设备开发如POS机、广告机、工业平板等Android系统定制化开发需要添加新的硬件支持嵌入式Linux驱动开发需要了解最新的Android驱动架构从其他平台迁移到RK3568的移植工作不过需要注意的是这个课程需要一定的前置知识基本的Linux操作和Shell命令C语言编程能力嵌入式系统基础概念简单的硬件知识对于完全的初学者建议先补充这些基础知识再开始学习。另外课程基于特定的开发板如果使用其他RK3568开发板可能需要适当的调整。3. 环境准备与前置条件开始学习前需要准备好以下环境和工具3.1 硬件准备正点原子ATK-DLRK3568开发板核心组件Type-C数据线用于供电和ADB调试USB转串口模块用于串口调试网线用于网络调试和文件传输SD卡用于系统烧录和实验电源适配器5V/2A以上3.2 软件环境Linux开发机Ubuntu 20.04/22.04推荐Android 15源码包需要提前下载RK3568相关的工具链和编译工具串口调试工具minicom、picocom等ADB调试工具Fastboot烧录工具3.3 开发工具# 安装基本的开发工具 sudo apt update sudo apt install git curl wget vim build-essential sudo apt install android-tools-adb android-tools-fastboot sudo apt install minicom picocom # 安装编译依赖 sudo apt install git-core gnupg flex bison build-essential \ zip curl zlib1g-dev gcc-multilib g-multilib libc6-dev-i386 \ libncurses5 lib32ncurses5-dev x11proto-core-dev libx11-dev \ lib32z1-dev libgl1-mesa-dev libxml2-utils xsltproc unzip fontconfig4. 开发环境搭建详细步骤环境搭建是驱动开发的第一步也是最重要的一步。下面详细说明如何搭建完整的开发环境。4.1 源码下载与配置Android 15源码体积较大建议准备至少200GB的磁盘空间。下载过程可能需要较长时间建议使用稳定的网络环境。# 创建工作目录 mkdir -p ~/rk3568_android15 cd ~/rk3568_android15 # 初始化repo工具 mkdir -p ~/.bin PATH${HOME}/.bin:${PATH} curl https://storage.googleapis.com/git-repo-downloads/repo ~/.bin/repo chmod arx ~/.bin/repo # 配置git信息 git config --global user.name Your Name git config --global user.email youexample.com # 初始化Android源码具体仓库地址以课程提供为准 repo init -u https://android.googlesource.com/platform/manifest -b android-15.0.0_r1 repo sync -j44.2 RK3568特定配置RK3568需要特定的内核配置和设备树支持。正点原子开发板有专门的内核分支和设备树文件。# 进入内核目录 cd kernel/rockchip/rk3568 # 切换到正点原子支持的分支 git checkout atomic-rk3568-android15 # 配置内核 make ARCHarm64 rockchip_defconfig make ARCHarm64 menuconfig # 编译内核 make ARCHarm64 -j84.3 编译系统镜像完整的Android系统编译需要配置设备特定的makefile和驱动模块。# 设置环境变量 source build/envsetup.sh # 选择目标设备以正点原子开发板为例 lunch atomic_rk3568-userdebug # 开始编译首次编译需要较长时间 make -j8编译成功后会在out/target/product/atomic_rk3568/目录下生成系统镜像文件包括boot.img、system.img、vendor.img等。5. 驱动开发基础实战驱动开发是课程的核心内容下面通过几个典型实例来说明开发流程。5.1 字符设备驱动开发字符设备驱动是最基础的驱动类型适合简单的IO设备控制。#include linux/module.h #include linux/fs.h #include linux/cdev.h #include linux/device.h #define DEVICE_NAME atomic_demo #define CLASS_NAME atomic static int major_number; static struct class* atomic_class NULL; static struct device* atomic_device NULL; static int device_open(struct inode *inode, struct file *file) { printk(KERN_INFO Atomic device opened\n); return 0; } static int device_release(struct inode *inode, struct file *file) { printk(KERN_INFO Atomic device closed\n); return 0; } static ssize_t device_read(struct file *file, char __user *buffer, size_t length, loff_t *offset) { char message[] Hello from Atomic RK3568!\n; int message_len strlen(message); if (*offset message_len) return 0; if (copy_to_user(buffer, message *offset, length) ! 0) return -EFAULT; *offset length; return length; } static struct file_operations fops { .open device_open, .release device_release, .read device_read, }; static int __init atomic_init(void) { major_number register_chrdev(0, DEVICE_NAME, fops); if (major_number 0) { printk(KERN_ALERT Failed to register device\n); return major_number; } atomic_class class_create(THIS_MODULE, CLASS_NAME); atomic_device device_create(atomic_class, NULL, MKDEV(major_number, 0), NULL, DEVICE_NAME); printk(KERN_INFO Atomic driver loaded\n); return 0; } static void __exit atomic_exit(void) { device_destroy(atomic_class, MKDEV(major_number, 0)); class_destroy(atomic_class); unregister_chrdev(major_number, DEVICE_NAME); printk(KERN_INFO Atomic driver unloaded\n); } module_init(atomic_init); module_exit(atomic_exit); MODULE_LICENSE(GPL); MODULE_AUTHOR(Atomic Team);对应的Makefile配置obj-m atomic_demo.o KDIR : /path/to/kernel/source all: make -C $(KDIR) M$(PWD) modules clean: make -C $(KDIR) M$(PWD) clean5.2 GPIO驱动控制实战GPIO是嵌入式开发中最常用的接口RK3568提供了丰富的GPIO资源。#include linux/gpio/consumer.h #include linux/interrupt.h #include linux/module.h struct gpio_desc *led_gpio; struct gpio_desc *button_gpio; static int irq_number; static irqreturn_t button_interrupt(int irq, void *dev_id) { int button_state gpiod_get_value(button_gpio); // 按钮按下时翻转LED状态 gpiod_set_value(led_gpio, !gpiod_get_value(led_gpio)); printk(KERN_INFO Button pressed, LED toggled\n); return IRQ_HANDLED; } static int __init gpio_demo_init(void) { // 获取LED GPIO根据实际硬件连接调整 led_gpio gpiod_get_index(NULL, led, 0, GPIOD_OUT_LOW); if (IS_ERR(led_gpio)) { printk(KERN_ERR Failed to get LED GPIO\n); return PTR_ERR(led_gpio); } // 获取按钮GPIO button_gpio gpiod_get_index(NULL, button, 0, GPIOD_IN); if (IS_ERR(button_gpio)) { printk(KERN_ERR Failed to get button GPIO\n); gpiod_put(led_gpio); return PTR_ERR(button_gpio); } // 获取中断号 irq_number gpiod_to_irq(button_gpio); if (irq_number 0) { printk(KERN_ERR Failed to get IRQ number\n); gpiod_put(button_gpio); gpiod_put(led_gpio); return irq_number; } // 注册中断处理函数 if (request_irq(irq_number, button_interrupt, IRQF_TRIGGER_RISING, atomic_button, NULL)) { printk(KERN_ERR Failed to request IRQ\n); gpiod_put(button_gpio); gpiod_put(led_gpio); return -EIO; } printk(KERN_INFO GPIO demo driver loaded\n); return 0; } static void __exit gpio_demo_exit(void) { free_irq(irq_number, NULL); gpiod_put(button_gpio); gpiod_put(led_gpio); printk(KERN_INFO GPIO demo driver unloaded\n); } module_init(gpio_demo_init); module_exit(gpio_demo_exit); MODULE_LICENSE(GPL);5.3 I2C设备驱动开发RK3568支持多个I2C控制器常用于连接传感器、EEPROM等设备。#include linux/i2c.h #include linux/module.h /* I2C设备ID匹配表 */ static const struct i2c_device_id atomic_sensor_id[] { { atomic_sensor, 0 }, { } }; MODULE_DEVICE_TABLE(i2c, atomic_sensor_id); /* 设备树匹配表 */ static const struct of_device_id atomic_sensor_of_match[] { { .compatible atomic,sensor }, { } }; MODULE_DEVICE_TABLE(of, atomic_sensor_of_match); /* 传感器读取函数 */ static int atomic_sensor_read_data(struct i2c_client *client, u8 reg) { return i2c_smbus_read_byte_data(client, reg); } /* 传感器写入函数 */ static int atomic_sensor_write_data(struct i2c_client *client, u8 reg, u8 data) { return i2c_smbus_write_byte_data(client, reg, data); } /* Probe函数 - 设备被发现时调用 */ static int atomic_sensor_probe(struct i2c_client *client, const struct i2c_device_id *id) { struct device *dev client-dev; int ret; // 检查设备是否响应 ret i2c_smbus_read_byte(client); if (ret 0) { dev_err(dev, Device not responding\n); return ret; } // 初始化传感器 ret atomic_sensor_write_data(client, 0x00, 0x01); if (ret 0) { dev_err(dev, Failed to initialize sensor\n); return ret; } dev_info(dev, Atomic sensor probed successfully\n); return 0; } /* Remove函数 - 设备移除时调用 */ static int atomic_sensor_remove(struct i2c_client *client) { dev_info(client-dev, Atomic sensor removed\n); return 0; } /* I2C驱动结构体 */ static struct i2c_driver atomic_sensor_driver { .driver { .name atomic_sensor, .of_match_table atomic_sensor_of_match, }, .probe atomic_sensor_probe, .remove atomic_sensor_remove, .id_table atomic_sensor_id, }; module_i2c_driver(atomic_sensor_driver); MODULE_LICENSE(GPL); MODULE_DESCRIPTION(Atomic I2C Sensor Driver);对应的设备树配置i2c1 { status okay; atomic_sensor: sensor48 { compatible atomic,sensor; reg 0x48; vdd-supply vcc_3v3; interrupt-parent gpio0; interrupts RK_PA0 IRQ_TYPE_EDGE_RISING; }; };6. Android HAL层开发实战Android HALHardware Abstraction Layer是连接底层驱动和上层框架的关键层。6.1 HAL模块定义首先定义HAL模块的接口文件// hardware/atomic/sensor/1.0/IAtomicSensor.h #pragma once #include hidl/MQDescriptor.h #include hidl/Status.h #include vendor/atomic/sensor/1.0/IAtomicSensor.h namespace vendor { namespace atomic { namespace sensor { namespace V1_0 { namespace implementation { using ::android::hardware::hidl_array; using ::android::hardware::hidl_memory; using ::android::hardware::hidl_string; using ::android::hardware::hidl_vec; using ::android::hardware::Return; using ::android::hardware::Void; using ::android::sp; struct AtomicSensor : public IAtomicSensor { AtomicSensor(); ~AtomicSensor(); // 实现HIDL接口方法 Returnvoid getSensorData(getSensorData_cb _hidl_cb) override; Returnint32_t setSensorMode(int32_t mode) override; Returnint32_t calibrate() override; private: bool initializeSensor(); int readRawData(); }; } // namespace implementation } // namespace V1_0 } // namespace sensor } // namespace atomic } // namespace vendor6.2 HAL服务实现实现具体的HAL服务逻辑// AtomicSensor.cpp #include AtomicSensor.h namespace vendor { namespace atomic { namespace sensor { namespace V1_0 { namespace implementation { AtomicSensor::AtomicSensor() { initializeSensor(); } AtomicSensor::~AtomicSensor() { // 清理资源 } Returnvoid AtomicSensor::getSensorData(getSensorData_cb _hidl_cb) { SensorData data; int rawValue readRawData(); // 转换原始数据 data.temperature rawValue * 0.1f; data.humidity (rawValue % 100) * 0.5f; data.timestamp android::elapsedRealtimeNano(); _hidl_cb(data); return Void(); } Returnint32_t AtomicSensor::setSensorMode(int32_t mode) { // 实现模式设置逻辑 int fd open(/dev/atomic_sensor, O_RDWR); if (fd 0) { ALOGE(Failed to open sensor device); return -1; } int ret ioctl(fd, ATOMIC_SENSOR_SET_MODE, mode); close(fd); return ret; } bool AtomicSensor::initializeSensor() { // 初始化传感器硬件 int fd open(/dev/atomic_sensor, O_RDWR); if (fd 0) { ALOGE(Failed to open sensor device); return false; } // 执行初始化操作 int init_cmd 1; ioctl(fd, ATOMIC_SENSOR_INIT, init_cmd); close(fd); return true; } int AtomicSensor::readRawData() { // 从设备读取原始数据 int fd open(/dev/atomic_sensor, O_RDWR); if (fd 0) { ALOGE(Failed to open sensor device); return -1; } int raw_data; ioctl(fd, ATOMIC_SENSOR_READ, raw_data); close(fd); return raw_data; } } // namespace implementation } // namespace V1_0 } // namespace sensor } // namespace atomic } // namespace vendor6.3 HAL服务注册在Android系统中注册HAL服务// service.cpp #include hidl/LegacySupport.h #include vendor/atomic/sensor/1.0/IAtomicSensor.h using vendor::atomic::sensor::V1_0::IAtomicSensor; using vendor::atomic::sensor::V1_0::implementation::AtomicSensor; int main() { return defaultPassthroughServiceImplementationIAtomicSensor(); }对应的Android.bp构建文件cc_binary { name: vendor.atomic.sensor1.0-service, relative_install_path: hw, proprietary: true, srcs: [service.cpp], init_rc: [vendor.atomic.sensor1.0-service.rc], shared_libs: [ liblog, libhidlbase, libhidltransport, vendor.atomic.sensor1.0, ], }7. 系统烧录与调试实战开发完成后需要将系统烧录到开发板进行测试。7.1 烧录工具配置使用Rockchip提供的烧录工具配置开发板进入烧录模式# 进入烧录模式 adb reboot bootloader # 或者通过按键组合进入Loader模式 # 开发板断电按住Recovery键上电等待进入烧录模式 # 使用rkdeveloptool烧录 sudo rkdeveloptool db rk356x_spl_loader_v1.09.111.bin sudo rkdeveloptool ul rk356x_spl_loader_v1.09.111.bin sudo rkdeveloptool wl 0x0 idbloader.img sudo rkdeveloptool wl 0x4000 uboot.img sudo rkdeveloptool wl 0x6000 boot.img sudo rkdeveloptool wl 0x8000 system.img sudo rkdeveloptool rd7.2 串口调试配置串口调试是驱动开发中最重要的调试手段# 查看串口设备 ls /dev/ttyUSB* # 使用minicom连接串口 sudo minicom -D /dev/ttyUSB0 -b 1500000 # 或者使用picocom sudo picocom -b 1500000 /dev/ttyUSB0串口连接成功后可以看到系统启动日志这是排查驱动问题的重要依据。7.3 内核日志分析通过dmesg和kmsg分析内核运行状态# 查看内核日志 adb shell dmesg # 实时查看内核日志 adb shell cat /proc/kmsg # 查看特定驱动的日志 adb shell dmesg | grep atomic_driver # 查看系统日志 adb logcat8. 常见问题与排查方法在RK3568 Android 15驱动开发过程中经常会遇到各种问题。下面列出一些典型问题及解决方法。问题现象可能原因排查方式解决方案编译失败环境配置错误、依赖缺失查看编译错误日志检查环境变量、安装缺失依赖驱动加载失败权限问题、设备树配置错误dmesg查看内核日志检查设备树节点、驱动权限HAL服务无法启动SELinux策略限制、权限不足logcat查看系统日志调整SELinux策略、检查权限设备无法识别驱动未编译进内核、设备地址错误检查/dev下设备节点确认驱动配置、检查设备地址系统启动卡住内核panic、驱动初始化失败串口查看启动日志分析panic信息、检查驱动初始化性能问题时钟配置不当、DMA配置错误使用perf工具分析优化时钟配置、调整DMA参数8.1 驱动加载问题排查当驱动模块无法正常加载时可以按照以下步骤排查# 检查驱动是否编译成功 ls -la *.ko # 手动加载驱动测试 adb push atomic_demo.ko /data/ adb shell insmod /data/atomic_demo.ko # 查看加载结果 adb shell lsmod | grep atomic adb shell dmesg | tail -20 # 检查设备节点 adb shell ls -la /dev/atomic_demo # 测试设备访问 adb shell cat /dev/atomic_demo8.2 设备树问题排查设备树配置错误是常见问题特别是引脚复用配置# 导出当前设备树配置 adb shell cat /proc/device-tree/atomic,sensor/status # 检查引脚复用配置 adb shell cat /sys/kernel/debug/pinctrl/pinctrl-rockchip-pinctrl/pinmux-pins # 检查时钟配置 adb shell cat /sys/kernel/debug/clk/clk_summary8.3 HAL层问题排查HAL服务问题通常需要结合系统日志分析# 查看HAL服务状态 adb shell getprop | grep hal # 检查服务是否注册 adb shell lshal | grep atomic # 查看详细日志 adb logcat | grep -i atomic # 手动启动服务测试 adb shell start vendor.atomic.sensor1.0-service9. 性能优化与最佳实践在RK3568 Android 15驱动开发中性能优化是关键环节。9.1 驱动性能优化中断优化合理使用中断上下半部避免在中断处理函数中执行耗时操作。// 使用工作队列处理耗时任务 static struct work_struct sensor_work; static void sensor_work_handler(struct work_struct *work) { // 处理传感器数据 process_sensor_data(); } static irqreturn_t sensor_interrupt(int irq, void *dev_id) { // 触发工作队列 schedule_work(sensor_work); return IRQ_HANDLED; } static int __init sensor_driver_init(void) { INIT_WORK(sensor_work, sensor_work_handler); // ... 其他初始化 }DMA优化对于大量数据传输使用DMA减少CPU占用。static int setup_dma_transfer(struct device *dev, dma_addr_t dma_handle, size_t size, enum dma_data_direction dir) { struct dma_chan *chan; dma_cookie_t cookie; struct dma_device *dmadev; struct dma_async_tx_descriptor *tx; chan dma_request_chan(dev, rx-tx); if (IS_ERR(chan)) { return PTR_ERR(chan); } tx chan-device-device_prep_dma_memcpy(chan, dma_handle, phys_addr, size, 0); if (!tx) { dma_release_channel(chan); return -EIO; } cookie dmaengine_submit(tx); dma_async_issue_pending(chan); return 0; }9.2 电源管理优化合理的电源管理可以显著降低系统功耗#include linux/pm_runtime.h static int sensor_runtime_suspend(struct device *dev) { struct sensor_data *data dev_get_drvdata(dev); // 关闭传感器电源 regulator_disable(data-vdd); // 禁用时钟 clk_disable_unprepare(data-clk); return 0; } static int sensor_runtime_resume(struct device *dev) { struct sensor_data *data dev_get_drvdata(dev); // 启用时钟 clk_prepare_enable(data-clk); // 开启传感器电源 regulator_enable(data-vdd); // 重新初始化传感器 sensor_init_hardware(data); return 0; } static const struct dev_pm_ops sensor_pm_ops { .runtime_suspend sensor_runtime_suspend, .runtime_resume sensor_runtime_resume, };9.3 调试与日志优化在生产环境中需要合理控制日志输出// 使用动态调试代替静态printk #define sensor_dbg(dev, format, ...) \ dev_dbg(dev, %s: format, __func__, ##__VA_ARGS__) #define sensor_info(dev, format, ...) \ dev_info(dev, %s: format, __func__, ##__VA_ARGS__) #define sensor_err(dev, format, ...) \ dev_err(dev, %s: format, __func__, ##__VA_ARGS__) // 条件编译调试代码 #ifdef DEBUG #define SENSOR_DEBUG 1 #else #define SENSOR_DEBUG 0 #endif #define sensor_debug(dev, format, ...) \ do { \ if (SENSOR_DEBUG) \ dev_dbg(dev, %s: format, __func__, ##__VA_ARGS__); \ } while (0)10. 项目实战与进阶方向完成基础驱动开发后可以尝试更复杂的项目实战。10.1 摄像头驱动开发RK3568支持MIPI CSI接口可以开发摄像头驱动// 摄像头驱动框架 struct atomic_camera { struct v4l2_device v4l2_dev; struct video_device vdev; struct v4l2_subdev *sensor_sd; struct media_device mdev; struct media_pad pad; }; static int atomic_camera_probe(struct platform_device *pdev) { struct atomic_camera *cam; int ret; cam devm_kzalloc(pdev-dev, sizeof(*cam), GFP_KERNEL); if (!cam) return -ENOMEM; // 初始化V4L2设备 ret v4l2_device_register(pdev-dev, cam-v4l2_dev); if (ret) return ret; // 注册视频设备 cam-vdev atomic_video_template; cam-vdev.v4l2_dev cam-v4l2_dev; video_set_drvdata(cam-vdev, cam); ret video_register_device(cam-vdev, VFL_TYPE_VIDEO, -1); if (ret) { v4l2_device_unregister(cam-v4l2_dev); return ret; } return 0; }10.2 显示驱动开发LVGL在RK3568上的移植和优化// 显示驱动框架 struct atomic_display { struct drm_device *drm_dev; struct rockchip_drm_private *private; struct drm_connector connector; struct drm_encoder encoder; }; static const struct drm_encoder_funcs atomic_encoder_funcs { .destroy drm_encoder_cleanup, }; static const struct drm_encoder_helper_funcs atomic_encoder_helper_funcs { .mode_set atomic_encoder_mode_set, .enable atomic_encoder_enable, .disable atomic_encoder_disable, };10.3 网络驱动开发PCIe转2.5G网络驱动移植// 网络驱动框架 struct atomic_netdev { struct pci_dev *pdev; struct net_device *netdev; void __iomem *bar_addr; struct napi_struct napi; }; static int atomic_netdev_probe(struct pci_dev *pdev, const struct pci_device_id *id) { struct atomic_netdev *anet; int ret; // PCI设备初始化 ret pci_enable_device(pdev); if (ret) return ret; pci_set_master(pdev); // 映射BAR空间 anet-bar_addr pci_iomap(pdev, 0, 0); if (!anet-bar_addr) { ret -EIO; goto err_disable; } // 注册网络设备 anet-netdev alloc_etherdev(sizeof(*anet)); if (!anet-netdev) { ret -ENOMEM; goto err_unmap; } SET_NETDEV_DEV(anet-netdev, pdev-dev); // 设置网络操作函数 anet-netdev-netdev_ops atomic_netdev_ops; anet-netdev-ethtool_ops atomic_ethtool_ops; ret register_netdev(anet-netdev); if (ret) goto err_free_netdev; return 0; err_free_netdev: free_netdev(anet-netdev); err_unmap: pci_iounmap(pdev, anet-bar_addr); err_disable: pci_disable_device(pdev); return ret; }这个RK3568 Android 15驱动开发课程提供了从基础到实战的完整学习路径。通过系统性的学习开发者可以掌握最新的Android驱动开发技术为智能设备开发打下坚实基础。课程中的实战案例和问题排查方法都是基于真实项目经验总结具有很高的参考价值。