龙芯开发者社区技术文档

1. 安装指南

1.1 系统环境准备

• 支持LoongArch架构的龙芯Loongnix系统（建议使用最新稳定版）
• 开发板需匹配仓库中doc-xx目录下的板卡规格说明书要求
• 基础开发工具链（gcc/make等）需预先安装

1.2 镜像烧录

• 从images-xx目录获取对应板卡的镜像文件
• 使用dd命令或专用烧录工具写入存储设备：

  dd if=loongson-image.img of=/dev/sdX bs=4M status=progress
  

2. 项目使用说明

2.1 源码结构说明

• u-boot: 定制化Bootloader源码
• linux-6.12: 适配龙芯的Linux内核源码
• buildroot-2024.08: 嵌入式系统构建工具
• testcase: 包含GPIO/I2C/SPI等接口的测试用例

2.2 开发流程

1. 通过build-xx目录的编译脚本构建系统镜像
2. 使用testcase验证硬件功能
3. 参考doc-loongarch进行底层开发

3. API使用文档

3.1 硬件抽象层API

• 寄存器操作宏定义位于linux-6.12/arch/loongarch/include
• 测试用例演示了以下接口调用：

  // GPIO控制示例
  loongson_gpio_set(port, pin, value);
  loongson_gpio_get(port, pin);
  

3.2 系统调用扩展

• 新增LoongArch专属系统调用见linux-6.12/arch/loongarch/kernel/syscalls

4. 项目安装方式

4.1 基础环境安装

sudo apt install build-essential bc flex bison libssl-dev

4.2 完整系统构建

1. 进入build-xx目录
2. 执行构建命令：

   ./configure --board=ls2k1000
   make -j$(nproc)
   

4.3 交叉编译配置

• 工具链路径需在buildroot-2024.08/configs中指定
• 典型环境变量配置：

  export CROSS_COMPILE=loongarch64-linux-gnu-
  export ARCH=loongarch
  

附录

• 硬件调试请参考对应板卡的doc-xx用户手册
• 体系结构细节见doc-loongarch目录下的ABI规范文档