龙芯2K0300平台开发实战指南

开发环境配置指南

搭建稳定高效的开发环境是基于龙芯2K0300平台进行项目开发的首要步骤。根据目标BSP版本的不同，环境配置存在显著差异，需严格遵循版本匹配原则。

BSP版本环境对比

龙芯2K0300平台提供两个主要BSP版本，各自对应不同的开发环境要求：

环境要素	BSP1.0	BSP2.0
推荐操作系统	Ubuntu 18.04 或 20.04	Ubuntu 22.04 或 24.04
交叉工具链	GCC 8.3	GCC 13.3
核心组件版本	U-Boot 2022.04 Linux 5.10	U-Boot 2022.04 Linux 6.12

💡 版本兼容性警告：不同BSP版本的工具链和系统组件不兼容，混用会导致编译错误或运行异常。建议使用Docker容器隔离不同版本的开发环境。

开发环境搭建步骤

1. 系统准备 安装推荐的Ubuntu版本后，执行以下命令更新系统并安装基础依赖：

   sudo apt update && sudo apt upgrade -y
   sudo apt install build-essential git wget curl libncurses-dev flex bison
   

2. 工具链安装

   • BSP1.0工具链安装：

     wget https://example.com/loongarch-gcc8.3-toolchain.tar.gz
     sudo tar -zxvf loongarch-gcc8.3-toolchain.tar.gz -C /opt/
     echo "export PATH=/opt/loongarch-gcc8.3/bin:\$PATH" >> ~/.bashrc
     source ~/.bashrc
     

   • BSP2.0工具链安装：

     wget https://example.com/loongarch-gcc13.3-toolchain.tar.gz
     sudo tar -zxvf loongarch-gcc13.3-toolchain.tar.gz -C /opt/
     echo "export PATH=/opt/loongarch-gcc13.3/bin:\$PATH" >> ~/.bashrc
     source ~/.bashrc
     

3. 环境验证 安装完成后验证工具链版本：

   loongarch64-linux-gnu-gcc --version
   

   应显示对应版本号（BSP1.0显示8.3.x，BSP2.0显示13.3.x）

硬件适配说明

龙芯2K0300平台支持多种板卡类型，每种板卡针对不同应用场景进行了优化设计。了解硬件特性是进行项目开发的基础。

板卡类型及应用场景

目前支持四种主要板卡类型，各具特色：

1. 蜂鸟核心板：最小系统设计，适合嵌入式产品原型开发
2. 蜂鸟板：扩展了I/O接口，适合教育和创客项目
3. 先锋派：强化了多媒体处理能力，适合边缘计算应用
4. 工业板：宽温设计，支持工业总线，适合工业控制场景

蜂鸟板采用紧凑设计，集成丰富接口，适合嵌入式原型开发

硬件接口解析

以先锋派为例，其硬件接口布局如下：

先锋派板卡接口布局，标注了主要功能接口位置

关键接口功能说明：

• 40PIN GPIO插针：提供通用输入输出功能，支持PWM、I2C、SPI等
• eMMC存储：板载高速闪存，用于系统存储
• DDR4内存：提供运行内存，支持最大4GB容量
• 网口PHY：千兆以太网接口，支持网络通信
• USB HUB：扩展多个USB2.0接口，方便外设连接

功能架构解析

龙芯2K0300处理器的功能架构决定了板卡的核心能力：

龙芯2K0300处理器功能框图，展示了内部模块与外部接口的连接关系

核心功能模块包括：

• 存储控制器：支持DDR4、eMMC、SPI NOR Flash等多种存储设备
• 网络接口：集成GMAC控制器，支持千兆以太网
• 多媒体接口：提供24bit RGB显示输出，支持LCD屏幕
• 外设接口：丰富的UART、I2C、SPI等低速接口
• 电源管理：支持多种电源模式，优化功耗表现

系统功能解析

龙芯2K0300平台支持多种操作系统，不同BSP版本提供的系统支持有所差异，选择合适的系统是项目成功的关键。

BSP版本系统支持对比

系统类型	BSP1.0支持	BSP2.0支持	典型应用场景
Buildroot	2021.02	2024.08	嵌入式小型系统
OpenWrt	22.03	24.10	网络设备
OpenHarmony	4.1	5.1	物联网设备
Alpine Linux	不支持	3.21	轻量级服务器
openEuler embedded	不支持	24.03	工业控制

💡 系统选择建议：对于资源受限的嵌入式设备，优先选择Buildroot；需要丰富网络功能时选择OpenWrt；开发物联网应用推荐OpenHarmony；工业场景可考虑openEuler embedded。

核心功能特性

1. 存储系统

   • 支持eMMC、SD卡、NAND Flash等多种存储设备
   • 提供文件系统加密和校验功能
   • 支持存储设备热插拔

2. 网络功能

   • 千兆以太网接口
   • 支持Wi-Fi模块扩展
   • 集成网络协议栈，支持TCP/IP、UDP等协议

3. 多媒体支持

   • LCD显示接口，支持多种分辨率
   • 图像编解码加速
   • 音频输入输出功能

4. 电源管理

   • 多种低功耗模式
   • 动态电压调节
   • 外设电源控制

开发资源获取

获取正确的开发资源是项目开发的基础，龙芯2K0300平台提供多种资源获取方式。

源码获取

推荐通过Git仓库获取最新源码：

git clone https://gitcode.com/open-loongarch/docs-2k0300.git

根据目标BSP版本切换分支：

• BSP1.0：

  git checkout BSP1.0
  

• BSP2.0：

  git checkout main
  

资料包下载

对于网络条件有限的用户，可通过网盘获取完整开发资料包：

• 包含源码、工具链、文档等所有开发资源
• 提取码：1234

辅助开发资源

1. Python仓库 提供专用Python包，简化应用开发：

   pip install loongarch-2k0300-sdk
   

2. Docker镜像 预配置的开发环境镜像：

   docker pull loongarch/2k0300-dev:bsp2.0
   

3. 技术文档

   • 产品规格书：详细硬件参数
   • 用户手册：板卡使用指南
   • 开发指南：系统编译和调试说明

部署实施步骤

完成开发后，需要将系统部署到目标板卡，以下是标准部署流程。

源码编译流程

1. 配置编译环境

   source build/envsetup.sh
   lunch 2k0300_board_defconfig
   

2. 选择目标系统

   make menuconfig
   

   在配置菜单中选择目标系统类型和组件

3. 开始编译

   make -j$(nproc)
   

   编译产物将生成在out/目录下

镜像烧写方法

1. TF卡烧写

   • 将编译生成的sdcard.img写入TF卡：

     sudo dd if=out/sdcard.img of=/dev/sdX bs=4M status=progress
     

   • 将TF卡插入板卡，设置从TF卡启动

2. NAND Flash烧写

   • 通过U-Boot命令行烧写：

     tftp 0x80000000 uboot.bin
     nand erase 0 0x100000
     nand write 0x80000000 0 0x100000
     

3. USB烧写

   • 将镜像文件放入U盘根目录
   • 在U-Boot中执行：

     usb start
     fatload usb 0:1 0x80000000 rootfs.img
     nand erase 0x200000 0x4000000
     nand write 0x80000000 0x200000 0x4000000
     

系统验证

系统启动后，可通过以下方式验证功能：

1. 基本系统检查

   uname -a
   cat /proc/cpuinfo
   free -m
   

2. 网络测试

   ping -c 4 8.8.8.8
   ifconfig
   

3. 外设测试

   ls /dev/ttyUSB*  # 检查串口
   ls /dev/video*   # 检查摄像头
   

💡 调试提示：如果系统无法启动，可通过UART串口查看启动日志，常见问题包括：镜像烧写错误、分区表不正确、电源供应不足等。

通过以上步骤，您可以完成龙芯2K0300平台的开发环境搭建、应用开发和系统部署。根据具体项目需求，可能需要进行额外的定制开发和优化。