【luckfox】从零开始：开发环境搭建全攻略

1. 开发环境准备Ubuntu系统配置如果你是第一次接触Luckfox开发板搭建开发环境可能会觉得有点复杂。别担心跟着我的步骤来保证你能顺利搞定。我刚开始接触Luckfox时也踩过不少坑现在把这些经验都分享给你。首先你需要准备一台运行Ubuntu系统的电脑。我推荐使用Ubuntu 20.04 LTS版本因为这个版本比较稳定社区支持也好。如果你用的是Windows系统可以考虑安装WSL2或者直接装个虚拟机。我个人更推荐虚拟机方案因为WSL2有时候会遇到一些奇怪的兼容性问题。安装好Ubuntu后第一件事就是更新系统。打开终端运行以下命令sudo apt update sudo apt upgrade -y接下来安装必要的开发工具链。Luckfox的编译需要一些基础工具这些工具在后续的开发过程中也会经常用到sudo apt install -y git build-essential cmake python3 python3-pip特别提醒一下如果你是在国内可能会遇到下载速度慢的问题。这时候可以考虑更换软件源。我常用的方法是使用清华源或者阿里源具体操作可以搜索Ubuntu更换国内源网上有很多详细教程。2. 获取Luckfox源码有了基础环境现在可以获取Luckfox的官方源码了。Luckfox的代码托管在GitHub上我们可以直接用git命令克隆下来。在终端中执行git clone https://github.com/LuckfoxTECH/luckfox-pico.git这个命令会把Luckfox的整个代码仓库下载到当前目录下的luckfox-pico文件夹中。下载完成后建议你先把代码切换到最新的稳定分支cd luckfox-pico git checkout main有时候网络不好可能会导致克隆失败特别是GitHub在国内访问不太稳定。如果遇到这种情况可以尝试使用代理或者换个时间段再试。另外代码仓库比较大下载可能需要一些时间耐心等待就好。3. 编译Luckfox固件源码下载完成后就可以开始编译了。Luckfox提供了一个很方便的编译脚本大大简化了编译过程。首先进入源码目录cd luckfox-pico然后运行配置脚本./build.sh lunch这个命令会弹出一个菜单让你选择要编译的目标板型号。根据你手上的Luckfox开发板型号选择对应的选项。如果你是用的Luckfox Pico就选择RV1103相关的配置。配置完成后就可以开始正式编译了./build.sh编译过程可能会持续比较长时间具体取决于你的电脑性能。我的经验是第一次编译通常需要30分钟到1小时不等。编译过程中会输出大量日志信息如果看到报错不要慌仔细看错误信息大部分问题都能通过搜索引擎解决。4. 安装驱动和刷机工具编译完成后我们需要准备刷机工具和驱动。Luckfox使用的是瑞芯微的芯片所以需要安装瑞芯微的开发工具。你可以在幸狐官网找到完整的驱动和工具包。下载后解压里面应该包含以下几个重要组件瑞芯微驱动安装程序刷机工具(RKDevTool)ADB和Fastboot工具首先安装驱动。在Windows下直接运行驱动安装程序即可。在Ubuntu下可能需要手动安装具体步骤可以参考官方文档。刷机工具RKDevTool是Windows程序如果你主要用Ubuntu开发可以考虑在虚拟机里运行Windows来使用这个工具。不过我更推荐直接在Windows主机上操作刷机步骤这样更稳定。5. 准备SD卡和刷入镜像现在我们要把编译好的镜像刷入SD卡。首先需要准备一张至少8GB的microSD卡建议使用品牌卡质量有保障。刷机步骤如下将SD卡插入读卡器连接到电脑打开RKDevTool选择RV1103芯片配置选择SD启动模式点击选择固件找到编译生成的.img文件点击执行开始刷机刷机过程中不要断开SD卡或关闭程序。完成后安全弹出SD卡然后插入Luckfox开发板的卡槽。这里有个小技巧刷机前最好先格式化SD卡。Windows下可以用SD Formatter工具Ubuntu下可以用gparted。这样可以避免一些奇怪的问题。6. 连接开发板和调试最后一步是连接开发板并验证系统是否正常工作。用USB线将Luckfox开发板连接到电脑然后在终端中运行adb devices如果一切正常你应该能看到设备列表中出现你的Luckfox开发板。这时候就可以开始愉快的开发之旅了。如果adb找不到设备可能是驱动没装好或者开发板没有正确启动。可以尝试以下排查步骤检查USB线是否连接正常查看设备管理器中有没有未知设备重新插拔USB线重启开发板我在实际使用中发现有时候开发板启动需要一点时间耐心等待30秒左右再试通常就能解决问题。