📚 课程目录第4章寄存器读写基础

4. 寄存器读写基础：ioremap/readl/writel操作、寄存器地址空间与偏移量计算

在骁龙Camera驱动移植中，寄存器配置校验是确保硬件正确初始化的核心环节。驱动开发者必须掌握如何将物理寄存器地址映射到内核虚拟地址空间，并通过标准接口完成读写操作。本章将系统讲解ioremap、readl、writel三大基础操作，以及地址空间与偏移量的计算方法。

4.1 寄存器地址空间模型

骁龙平台的Camera ISP（图像信号处理器）寄存器分布在多个独立的内存映射区域。驱动通过物理地址 → 虚拟地址的映射机制访问这些寄存器。

关键概念：物理地址是硬件寄存器在总线上的真实地址，驱动不能直接访问。必须通过ioremap将物理地址映射到内核虚拟地址空间后，才能使用readl/writel进行读写。

4.2 ioremap：物理地址到虚拟地址的映射

ioremap 是Linux内核提供的核心API，用于将I/O内存物理地址映射到内核虚拟地址空间。其函数原型如下：

#include <linux/io.h>

void __iomem *ioremap(phys_addr_t phys_addr, unsigned long size);

参数	说明	示例值
phys_addr	寄存器块的物理基地址	0xAC000000
size	需要映射的地址范围长度（字节）	0x10000（64KB）
返回值	映射后的虚拟地址指针（__iomem标记）	0xF0000000

常见错误：映射size过小会导致访问越界寄存器时触发SIGBUS错误；映射完成后必须使用iounmap释放，否则会造成虚拟地址泄漏。

4.3 readl / writel：寄存器读写操作

映射完成后，使用readl读取32位寄存器值，使用writel写入32位寄存器值。这两个API保证对寄存器的访问是原子的，并包含适当的内存屏障。

#include <linux/io.h>

// 读取寄存器
u32 readl(const volatile void __iomem *addr);

// 写入寄存器
void writel(u32 value, volatile void __iomem *addr);

4.3.1 典型读写流程

4.4 偏移量计算：从基地址到目标寄存器

Camera驱动中，寄存器通常以基地址 + 偏移量的方式访问。偏移量由芯片设计手册定义，驱动开发者需要根据寄存器地址表计算正确的偏移值。

4.4.1 偏移量计算公式

目标寄存器虚拟地址 = ioremap返回的基虚拟地址 + 寄存器偏移量

其中：
  寄存器偏移量 = 寄存器物理地址 - 寄存器块物理基地址

4.4.2 实际案例：ISP寄存器访问

假设骁龙Camera ISP寄存器块物理基地址为 0xAC000000，需要访问以下寄存器：

寄存器名称	物理地址	偏移量计算	偏移量（十六进制）
ISP_CTRL	0xAC000000	0xAC000000 - 0xAC000000	0x0000
ISP_STATUS	0xAC000004	0xAC000004 - 0xAC000000	0x0004
ISP_CLK_CTRL	0xAC000100	0xAC000100 - 0xAC000000	0x0100
ISP_FRAME_CFG	0xAC001000	0xAC001000 - 0xAC000000	0x1000

4.5 完整代码示例：寄存器配置与校验

以下代码展示了骁龙Camera驱动中典型的寄存器读写与校验流程：

#include <linux/io.h>
#include <linux/kernel.h>
#include <linux/module.h>

#define CAM_ISP_BASE      0xAC000000
#define CAM_ISP_SIZE      0x10000
#define ISP_CTRL_OFFSET   0x0000
#define ISP_STATUS_OFFSET 0x0004
#define ISP_CLK_CTRL_OFF  0x0100

/* 期望的寄存器值 */
#define ISP_CTRL_EXPECT   0x80000001
#define ISP_CLK_CTRL_EXP  0x00000003

static void __iomem *isp_virt_base;

static int cam_isp_reg_check(void)
{
    u32 reg_val;
    int ret = 0;

    /* 1. ioremap 映射物理地址 */
    isp_virt_base = ioremap(CAM_ISP_BASE, CAM_ISP_SIZE);
    if (!isp_virt_base) {
        pr_err("ioremap failed for 0x%x\n", CAM_ISP_BASE);
        return -ENOMEM;
    }

    /* 2. 写入 ISP_CTRL 寄存器 */
    writel(ISP_CTRL_EXPECT, isp_virt_base + ISP_CTRL_OFFSET);
    pr_info("Write ISP_CTRL: 0x%08x\n", ISP_CTRL_EXPECT);

    /* 3. 回读校验 */
    reg_val = readl(isp_virt_base + ISP_CTRL_OFFSET);
    if (reg_val != ISP_CTRL_EXPECT) {
        pr_err("ISP_CTRL mismatch: read 0x%08x, expect 0x%08x\n",
               reg_val, ISP_CTRL_EXPECT);
        ret = -EIO;
        goto out;
    }
    pr_info("ISP_CTRL verify OK\n");

    /* 4. 配置时钟控制寄存器 */
    writel(ISP_CLK_CTRL_EXP, isp_virt_base + ISP_CLK_CTRL_OFF);
    reg_val = readl(isp_virt_base + ISP_CLK_CTRL_OFF);
    if (reg_val != ISP_CLK_CTRL_EXP) {
        pr_err("ISP_CLK_CTRL mismatch\n");
        ret = -EIO;
        goto out;
    }
    pr_info("ISP_CLK_CTRL verify OK\n");

out:
    /* 5. 释放映射 */
    iounmap(isp_virt_base);
    return ret;
}

  工程要点：
  每次writel后立即readl回读，是寄存器配置校验的标准做法
偏移量必须与芯片手册严格一致，1字节误差会导致操作错误的寄存器
ioremap返回的指针必须用__iomem标记，避免Sparse工具报错
驱动退出时必须调用iounmap，防止虚拟地址泄漏

4.6 常见问题与避坑指南

问题场景	原因分析	解决方案
readl返回全0xFF	物理地址未正确映射或时钟未使能	检查ioremap返回值；确认电源域已上电
writel写入后回读值不变	寄存器为只读或写保护位未清除	查阅手册确认寄存器属性；先写入解锁序列
系统崩溃（SIGBUS）	访问了超出映射范围的地址	检查偏移量是否超过ioremap的size参数
偏移量计算错误	基地址或偏移量使用了错误的值	用十六进制减法验证：offset = addr - base

调试技巧：在驱动初始化阶段，使用dev_dbg或pr_debug打印每次readl/writel的虚拟地址和值，配合示波器或逻辑分析仪验证硬件信号，可以快速定位寄存器配置问题。

4.7 本章小结

ioremap 将物理寄存器地址映射到内核虚拟地址空间，是驱动访问硬件的前提
readl / writel 提供32位原子读写操作，包含必要的内存屏障
偏移量计算 遵循 offset = 寄存器物理地址 - 基物理地址 的简单减法规则
写后回读校验 是寄存器配置正确性的第一道防线
映射资源必须配对使用 ioremap / iounmap，避免资源泄漏