1. 项目背景与核心挑战
最近在龙芯k架构平台上进行ST驱动移植的项目让我收获颇丰。作为国产CPU的代表，龙芯平台在嵌入式系统和工业控制领域应用越来越广泛，但外设驱动的适配工作一直是开发者面临的实际难题。这次我负责的ST系列芯片驱动移植，就遇到了不少值得记录的坑和经验。
龙芯k架构采用MIPS64指令集，与常见的x86/ARM架构存在显著差异。ST（意法半导体）的各类传感器、存储器芯片在工业领域应用广泛，但其官方驱动通常只提供ARM或x86版本。这就需要在指令集、内存管理、中断处理等方面进行深度适配，绝非简单的重新编译就能解决。
2. 开发环境搭建要点
2.1 工具链配置
龙芯官方提供了专门的交叉编译工具链，但需要注意版本匹配问题。经过实测，gcc-8.3.0工具链与最新的龙芯k内核兼容性最好。配置时需特别注意：
bash复制export CROSS_COMPILE=loongarch64-linux-gnu-
export ARCH=loongarch
重要提示：不要使用社区版工具链，某些优化选项会导致驱动异常。我就曾因为使用非官方工具链，导致DMA传输时出现内存越界问题，排查了整整两天。
2.2 内核头文件处理
龙芯内核头文件结构与标准Linux存在差异，需要手动指定包含路径。建议在Makefile中添加：
makefile复制EXTRA_CFLAGS += -I$(KERNEL_SRC)/arch/loongarch/include
EXTRA_CFLAGS += -I$(KERNEL_SRC)/arch/loongarch/include/uapi
3. 驱动移植关键技术点
3.1 字节序处理
MIPS架构默认采用大端模式，而ST芯片多为小端设计。在数据传输层需要特别注意字节序转换。对于SPI/I2C通信，建议增加如下转换函数：
c复制static inline u32 cpu_to_st_le32(u32 x)
{
return cpu_to_le32(cpu_to_be32(x));
}
3.2 内存屏障使用
龙芯k的多级缓存架构对内存可见性有特殊要求。在寄存器操作前后必须添加合适的内存屏障：
c复制#define ST_REG_WRITE(addr, val) do { \
writel(val, addr); \
__asm__ __volatile__("sync" ::: "memory"); \
} while (0)
3.3 中断处理优化
ST芯片的中断响应时间要求较高，而龙芯的中断控制器(GIC)配置较为复杂。建议采用以下优化措施：
- 在probe阶段预先分配中断栈空间
- 使用IRQF_NOBALANCING标志防止中断迁移
- 对于高频率中断，考虑使用napi机制
4. 典型问题排查实录
4.1 DMA传输失败
现象：DMA启动后无法触发完成中断
排查过程：
- 检查发现DMA描述符地址未按64字节对齐
- 龙芯k的DMA引擎要求描述符必须缓存行对齐
- 修改分配方式为：
c复制desc = dma_alloc_coherent(dev, size, &dma_handle, GFP_KERNEL | __GFP_ZERO);
4.2 电源管理异常
现象：系统休眠后设备无法唤醒
解决方案：
- 需要在suspend/resume回调中手动保存/恢复寄存器状态
- 特别要注意时钟控制寄存器的处理
- 添加PM运行时支持：
c复制static const struct dev_pm_ops st_pm_ops = {
SET_SYSTEM_SLEEP_PM_OPS(st_suspend, st_resume)
SET_RUNTIME_PM_OPS(st_runtime_suspend, st_runtime_resume, NULL)
};
5. 性能优化技巧
5.1 缓存预取配置
通过调整L2预取策略可提升数据传输效率：
c复制static void optimize_cache_prefetch(void)
{
unsigned long cfg = read_c0_config2();
cfg |= (0x3 << 12); // 开启L2流预取
write_c0_config2(cfg);
}
5.2 中断亲和性设置
对于多核系统，合理绑定中断到特定核心：
c复制irq_set_affinity_hint(irq, cpumask_of(cpu));
6. 测试验证方案
建议采用分层测试策略：
- 单元测试：使用kunit框架验证基础功能
- 压力测试：通过sysfs接口注入测试模式
- 长期稳定性测试：使用内核的ftrace监控异常
创建测试节点的示例：
c复制static ssize_t test_mode_store(struct device *dev,
struct device_attribute *attr, const char *buf, size_t count)
{
int mode;
if (kstrtoint(buf, 0, &mode))
return -EINVAL;
// 执行测试逻辑
return count;
}
DEVICE_ATTR_WO(test_mode);
7. 移植心得与建议
经过这次完整的驱动移植过程，我总结了几个关键经验：
- 龙芯的文档虽然不如x86/ARM丰富，但社区响应很及时，遇到问题不妨多去邮件列表咨询
- 对于时序敏感的操作用示波器实际测量信号非常必要
- 建议在代码中增加详细的架构相关注释，方便后续维护
- 性能调优时要特别注意缓存命中率，可以用perf工具分析
最后分享一个调试小技巧：在龙芯平台上，early_printk的输出在出现严重错误时往往比printk更可靠，建议在关键路径上添加。