龙芯2K0300开发板终极使用指南：从开箱到系统烧录完整教程

龙芯2K0300开发板终极使用指南：从开箱到系统烧录完整教程

【免费下载链接】docs-2k03002k0300 平台板卡的产品规格书，用户手册等文档项目地址: https://gitcode.com/open-loongarch/docs-2k0300

想要快速上手龙芯2K0300开发板？这篇终极指南将带你从零开始，掌握国产龙芯2K0300开发板的所有关键操作！无论你是嵌入式开发新手还是经验丰富的工程师，这份详细的操作手册都能帮你快速掌握开发板的使用技巧。

🚀 开发板快速上手：5分钟进入工作状态

龙芯2K0300作为国产处理器的重要代表，在嵌入式开发领域拥有广泛的应用。但很多开发者拿到开发板后不知道如何开始，本文将为你提供最直接的解决方案。

硬件连接第一步

电源与调试串口连接是启动开发板的关键步骤：

1. 电源连接：使用Type-C接口为开发板供电
2. 串口连接：连接调试串口到PC（UART0作为Debug串口）
3. 网络连接：配置TFTP网络环境（可选）
4. 存储设备：准备U盘或TF卡用于系统安装

小贴士：如果板卡负载较大，建议将Type-C的USB-A接口接在5V电源适配器上，然后使用网络或TTL调试串口进行调试。

串口调试工具配置

Windows用户推荐使用MobaXterm，配置步骤如下：

1. 选择"Serial"选项
2. 设置串口号（如COM17）
3. 波特率设为115200
4. 参数配置为8N1（数据位8、停止位1、无校验）

Linux用户可以使用minicom：

配置要点：

• 端口：/dev/ttyUSB0
• 参数：115200 8N1

首次启动与登录

按下开发板上POWER键启动，系统默认自动登录进入预置Busybox系统。系统默认账户为root，默认密码为123，默认IP为192.168.1.10。

🔌 网络连接与文件传输

SSH远程连接配置

开发板集成了有线网口和WIFI模块，支持SSH远程访问：

有线网络连接步骤：

1. 将板卡与电脑通过网线直连
2. 配置电脑IP为192.168.1.2（与u-boot默认serverip一致）
3. 使用SSH客户端连接192.168.1.10:22

快速检查：如果板卡Ping不通电脑但电脑可以Ping通板卡，请检查电脑防火墙状态，将其关闭后再试。

WIFI无线连接

开发板支持WIFI模块，可以通过NetworkManager或iw/wpa工具连接：

NetworkManager连接WIFI：

# 扫描WIFI nmcli dev wifi # 连接WIFI nmcli dev wifi connect "wifi-test" password "wifi-test123"

wpa工具连接WIFI：

# 设置WIFI密码 wpa_passphrase "wifi-test" "wifi-test123" > /etc/wpa_supplicant.config # 连接WIFI wpa_supplicant -B -i wlan0 -c /etc/wpa_supplicant.config # 获取IP dhcpcd wlan0

💾 U-Boot菜单操作指南

进入U-Boot菜单

开机按住键盘上的字母"m"键进入u-boot菜单，或者在u-boot命令终端输入bootmenu命令：

菜单选项包括：

• [1] System boot select - 系统启动选择
• [2] Update kernel - 更新内核
• [3] Update rootfs - 更新文件系统
• [4] Update u-boot - 更新固件
• [5] Update ALL - 更新所有
• [6] System install or recover - 系统安装或恢复
• [7] Board product - 板卡产品信息
• [8] Video resolution select - 视频分辨率选择
• [9] Video rotation select - 视频旋转选择
• [a] U-Boot console - U-Boot控制台

启动模式选择

蜂鸟板支持从多种介质启动系统，默认从EMMC启动：

1. u-boot菜单选择"[1] System boot select"
2. 选择"[1] System Boot from emmc"或"[2] System Boot from sdcard"

LCD分辨率切换

开发板适配了多种LCD屏分辨率（800x480, 1024x600, 1280x800），覆盖4.3', 7', 10.1'等主流尺寸：

注意事项：如果切换后显示花屏，检查是否使用了新的u-boot和kernel，以及板卡供电是否满足。

📁 文件系统更新与安装

U盘准备与使用

考虑到Linux与Windows的兼容性，推荐将U盘格式设为FAT32：

U盘准备步骤：

1. U盘格式化为FAT32
2. 在U盘目录下创建update文件夹
3. 在U盘update目录下放入要更新的文件：
   • 内核：uImage
   • 固件：u-boot-with-spl.bin或u-boot.bin
   • 文件系统：rootfs.img

TFTP网络服务配置

Linux平台TFTP服务器配置：

1. 安装tftpd-hpa服务
2. 设置tftp文件根目录（如/home/loongson/tftproot/）
3. 将要更新的文件放在此目录下
4. 查看服务器IP地址（如192.168.1.2）

U-Boot网络设置：

# 查看环境变量 => printenv # 更改服务器IP => setenv serverip 192.168.1.2 # 更改本机IP => setenv ipaddr 192.168.1.20 # 保存配置 => saveenv

🔧 系统安装与更新

EMMC安装系统方法

方法1：直接安装rootfs.img

1. 将rootfs.img放在tftp服务器根目录或U盘update目录
2. u-boot菜单选择"[3] Update rootfs"
3. 选择更新方式（USB或TFTP）
4. 升级完成后重启

方法2：安装系统（适合大镜像）

1. 将uImage、rootfs.tar.gz、ramdisk.gz放在tftp根目录或U盘install目录
2. u-boot菜单选择"[6] System install or recover"
3. 选择安装方式开始安装
4. 安装成功后系统自动重启

内核更新步骤

1. 将uImage放在tftp服务器根目录或U盘update目录
2. u-boot菜单选择"[2] Update kernel"
3. 选择更新方式开始升级
4. 升级完成后重启

设备树（DTB）更新

注意事项：可以在Linux内核中执行make dtbs编译新的dtb，生成需要的ls2k300_mini_dp.dtb

更新步骤：

1. 将编译好的ls2k300_mini_dp.dtb改名为dtb.bin
2. 放在U盘update目录或tftp根目录下
3. u-boot菜单选择"Update dtb"
4. 选择更新方式开始升级

⚡ 固件烧录与升级

U-Boot菜单更新固件

重要警告：烧录固件需谨慎，可能导致板卡无法启动！更新固件后第一次启动有个训练内存的过程，在输出LOONGSON(GD)的logo后会有大约15秒左右无输出，这是正常现象。

更新步骤：

1. 将u-boot-with-spl.bin放在tftp服务器根目录或U盘update目录
2. u-boot菜单选择"[4] Update u-boot"
3. 选择更新方式开始升级
4. 升级完成后重启

系统工具更新固件

板卡自带的文件系统含有更新u-boot的软件，存放在/root/sys_config_tool目录下：

# 进入文件目录 cd /root/sys_config_tool/file # 校验固件完整性 md5sum -c u-boot-with-spl.bin.md5 # 更新固件 ./update_uboot # 重启系统 reboot

🛠️ 常见问题与解决方案

串口文件传输问题

将文件传到板卡的步骤：

1. 在串口终端输入rz命令
2. 右键选择"Send file using Z-modem"
3. 选择要下发的文件
4. 等待"Transfer complete"提示

将文件从板卡传到PC的步骤：

1. 在串口终端输入sz xxx命令（xxx为要传输的文件）
2. 右键选择"Receive file using Z-modem"
3. 选择保存位置
4. 等待传输完成

WIFI连接问题排查

如果使用NetworkManager无法连接WIFI，排查思路如下：

1. 先关闭NetworkManager

   systemctl stop NetworkManager

2. 使用wpa工具连接WIFI

   wpa_passphrase "wifi-test" "wifi-test123" > /etc/wpa_supplicant.config wpa_supplicant -B -i wlan0 -c /etc/wpa_supplicant.config dhcpcd wlan0

3. 如果wpa工具连接成功，可能是WIFI芯片不支持Random Mac导致的

   echo -e "[device]\nwifi.scan-rand-mac-address=no" | tee /etc/NetworkManager/conf.d/disable-random-mac.conf reboot

网络下载失败问题

问题：出现网络下载或更新不了的情况

解决方案：检查电脑的防火墙是否为打开状态，如果是打开状态则将其关闭之后再试。

📊 开发板功能框图与系统架构

龙芯2K0300开发板采用模块化设计，主要功能模块包括：

核心处理器：LS2K0300处理器存储系统：

• 512MB DDR4内存
• 8GB eMMC存储
• 2MB SPI NOR FLASH
• Micro SD卡槽

接口与通信：

• 网络：GMAC0（YT8531C）→ RJ45网口
• 音频：I2S（ES8388）→ 音频JACK
• 无线：RTL8188FU → 2.5G WIFI
• USB：CH334R → USB2.0 Type A
• 调试：UART0（CH340K）→ 调试串口

扩展接口：

• GPIO（UART/SPI/I2C/CAN/PWM）
• 12bit ADC（2.0mm插针）
• RTC（CPU RTC）

🎯 实用技巧与最佳实践

性能优化建议

1. 编译优化：使用-O2优化级别
2. 调试技巧：合理使用printk输出
3. 日志分析：利用dmesg查看内核信息

开发效率提升

• 使用版本控制管理代码变更
• 定期备份重要配置文件
• 建立标准化的开发流程

快速检查清单

在开始开发前，确保以下条件：

• ✅ 电源连接正常
• ✅ 串口调试工具配置正确
• ✅ 网络环境配置完成
• ✅ 必要的开发工具已安装
• ✅ 系统镜像准备就绪

📚 总结与下一步

通过本指南，你已经掌握了龙芯2K0300开发板的核心操作技能。从硬件连接到系统烧录，从网络配置到固件更新，每个环节都至关重要。

关键要点回顾：

• 确保交叉工具链路径正确配置
• 安装所有必要的依赖库
• 正确配置串口和网络调试工具
• 熟悉U-Boot菜单操作
• 掌握系统更新和固件烧录方法

现在你可以开始进行龙芯2K0300的嵌入式开发工作，包括U-Boot定制、内核开发、驱动编写等任务。如果在后续开发中遇到问题，可以参考常见问题解决方案部分进行排查。

记住，实践是最好的老师！多动手操作，多尝试不同的配置，你会更快掌握龙芯2K0300开发板的精髓。祝你在国产芯片开发的道路上越走越远！

【免费下载链接】docs-2k03002k0300 平台板卡的产品规格书，用户手册等文档项目地址: https://gitcode.com/open-loongarch/docs-2k0300