1. 开发环境准备与路径检查刚拿到国科GK7202V300开发板时我最先踩的坑就是环境配置问题。这个芯片虽然对标海思方案但开发环境搭建还是有不少独特之处。建议先准备Ubuntu 18.04系统实测20.04会有库兼容问题内存至少16GB硬盘预留100GB空间。安装基础工具链时千万别直接用apt默认版本必须严格按照SDK文档要求的版本来。注意每次打开新终端都要先执行source ./build/env.sh这个步骤我至少忘了十几次每次都会报arm-gcc not found的错误。后来我直接把这条命令写进了~/.bashrc省心不少。路径问题绝对是新手杀手。我有次编译uboot花了半小时最后发现是SDK解压路径包含中文空格符。现在我的项目路径固定是~/workspace/gk7202v300所有操作都在这个目录下进行。特别提醒SDK中的build/、out/这些目录都是绝对路径引用移动工程文件夹会导致编译失败。2. uboot编译问题全解析2.1 编译前的必要清理第一次编译uboot前一定要先执行make mrproper make distclean这两个命令的区别很多人搞不清mrproper会清除所有生成文件和配置文件而distclean还会删除编辑器备份文件等。我遇到过因为残留.config导致GPIO配置冲突的情况现在养成了每次git pull后都执行清理的习惯。2.2 内存不足引发的诡异错误当看到section header offset11259033430261812这种离谱报错时别急着怀疑人生。这通常是内存不足导致的数据错乱。建议减少并行编译线程make -j4代替make -j$(nproc)关闭Chrome等内存大户添加swap空间sudo fallocate -l 8G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile2.3 证书文件缺失问题遇到debian/canonical-certs.pem报错时不要按网上教程删除证书配置正确做法是打开.config文件找到CONFIG_SYSTEM_TRUSTED_KEYS修改为CONFIG_SYSTEM_TRUSTED_KEYS3. SDK编译的坑与技巧3.1 首次编译必现问题第一次执行make build时建议make build -j48 21 | tee build.log这个组合拳的好处是-j48充分利用多核虽然芯片是4核但编译任务IO密集21 | tee既能实时查看输出又能保存日志。当看到ignoring unsupported character错误时大概率是Kconfig文件中用了C风格的//注释要全部替换成#。3.2 rootfs配置的玄学修改rootfs后不生效这是文件系统缓存的坑。正确的操作顺序make rootfs_clean会清空out/target/rootfs备份自定义文件比如我的web后台程序make rootfscp -r my_files/* out/target/rootfs/3.3 驱动加载的特殊要求驱动报invalid module format时记住国科和海思的区别海思直接使用source/kernel/下的ko文件国科必须用out/linux4.9.y/下的ko文件这是因为国科的模块签名校验更严格。我写了个自动拷贝脚本#!/bin/bash ko_pathout/linux4.9.y/drivers/char/my_driver.ko test -f $ko_path sudo cp $ko_path /lib/modules/$(uname -r)/4. 烧写与启动问题排查4.1 FastBurn工具使用技巧用FastBurn烧写时串口和USB的坑最多Windows设备管理器里查看COM端口号关闭所有串口工具包括虚拟机如果一直超时试试先按住开发板复位键再点击烧写我常用的命令组合fastburn -p COM3 -b uboot.bin -k kernel.img -r rootfs.jffs24.2 开机脚本报错分析遇到Sxx: not found时按这个顺序检查文件头必须是#!/bin/sh不能有空格文件权限要有执行位chmod x /etc/init.d/S99myapp用dos2unix转换格式从Windows拷贝的文件会有^M字符4.3 内存保护警告处理This architecture does not have kernel memory protection这个警告可以忽略但如果你想消除它make menuconfig然后进入Security options→ 关闭Enable kernel memory protection。不过实测对性能没影响建议保持默认。5. 芯片特性深度适配5.1 IO复用配置秘籍国科的IO复用命令xmmm和海思的himm用法相似但地址格式不同# 海思写法 himm 0x20150008 0xFF # 国科正确写法 xmmm 0x0_112C_0048 0x1A05地址映射规则在《GK7202V300寄存器手册》附录C有详细说明。我整理了个常用配置对照表功能海思地址国科地址UART0_TX0x201500000x0_112C_0040I2C1_SCL0x201500480x0_112C_00885.2 编译器版本陷阱当看到automake needs newer version时千万别直接升级正确姿势sudo apt-get install automake1:1.15.1-3ubuntu2 sudo apt-mark hold automake国科SDK对automake版本极其敏感我用1.16版本编译必现Kconfig解析错误。5.3 内核保护模式设置在make menuconfig时这几个选项要特别注意Processor type and features → [ ] Enable kernel memory protection Device Drivers → Character devices → [*] Enable tiny config quick start取消勾选tiny config quick start能解决90%的模块加载问题但会增加编译时间约15分钟。
【实战指南】国科GK7202V300芯片开发避坑手册：从uboot到SDK的常见问题解析
1. 开发环境准备与路径检查刚拿到国科GK7202V300开发板时我最先踩的坑就是环境配置问题。这个芯片虽然对标海思方案但开发环境搭建还是有不少独特之处。建议先准备Ubuntu 18.04系统实测20.04会有库兼容问题内存至少16GB硬盘预留100GB空间。安装基础工具链时千万别直接用apt默认版本必须严格按照SDK文档要求的版本来。注意每次打开新终端都要先执行source ./build/env.sh这个步骤我至少忘了十几次每次都会报arm-gcc not found的错误。后来我直接把这条命令写进了~/.bashrc省心不少。路径问题绝对是新手杀手。我有次编译uboot花了半小时最后发现是SDK解压路径包含中文空格符。现在我的项目路径固定是~/workspace/gk7202v300所有操作都在这个目录下进行。特别提醒SDK中的build/、out/这些目录都是绝对路径引用移动工程文件夹会导致编译失败。2. uboot编译问题全解析2.1 编译前的必要清理第一次编译uboot前一定要先执行make mrproper make distclean这两个命令的区别很多人搞不清mrproper会清除所有生成文件和配置文件而distclean还会删除编辑器备份文件等。我遇到过因为残留.config导致GPIO配置冲突的情况现在养成了每次git pull后都执行清理的习惯。2.2 内存不足引发的诡异错误当看到section header offset11259033430261812这种离谱报错时别急着怀疑人生。这通常是内存不足导致的数据错乱。建议减少并行编译线程make -j4代替make -j$(nproc)关闭Chrome等内存大户添加swap空间sudo fallocate -l 8G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile2.3 证书文件缺失问题遇到debian/canonical-certs.pem报错时不要按网上教程删除证书配置正确做法是打开.config文件找到CONFIG_SYSTEM_TRUSTED_KEYS修改为CONFIG_SYSTEM_TRUSTED_KEYS3. SDK编译的坑与技巧3.1 首次编译必现问题第一次执行make build时建议make build -j48 21 | tee build.log这个组合拳的好处是-j48充分利用多核虽然芯片是4核但编译任务IO密集21 | tee既能实时查看输出又能保存日志。当看到ignoring unsupported character错误时大概率是Kconfig文件中用了C风格的//注释要全部替换成#。3.2 rootfs配置的玄学修改rootfs后不生效这是文件系统缓存的坑。正确的操作顺序make rootfs_clean会清空out/target/rootfs备份自定义文件比如我的web后台程序make rootfscp -r my_files/* out/target/rootfs/3.3 驱动加载的特殊要求驱动报invalid module format时记住国科和海思的区别海思直接使用source/kernel/下的ko文件国科必须用out/linux4.9.y/下的ko文件这是因为国科的模块签名校验更严格。我写了个自动拷贝脚本#!/bin/bash ko_pathout/linux4.9.y/drivers/char/my_driver.ko test -f $ko_path sudo cp $ko_path /lib/modules/$(uname -r)/4. 烧写与启动问题排查4.1 FastBurn工具使用技巧用FastBurn烧写时串口和USB的坑最多Windows设备管理器里查看COM端口号关闭所有串口工具包括虚拟机如果一直超时试试先按住开发板复位键再点击烧写我常用的命令组合fastburn -p COM3 -b uboot.bin -k kernel.img -r rootfs.jffs24.2 开机脚本报错分析遇到Sxx: not found时按这个顺序检查文件头必须是#!/bin/sh不能有空格文件权限要有执行位chmod x /etc/init.d/S99myapp用dos2unix转换格式从Windows拷贝的文件会有^M字符4.3 内存保护警告处理This architecture does not have kernel memory protection这个警告可以忽略但如果你想消除它make menuconfig然后进入Security options→ 关闭Enable kernel memory protection。不过实测对性能没影响建议保持默认。5. 芯片特性深度适配5.1 IO复用配置秘籍国科的IO复用命令xmmm和海思的himm用法相似但地址格式不同# 海思写法 himm 0x20150008 0xFF # 国科正确写法 xmmm 0x0_112C_0048 0x1A05地址映射规则在《GK7202V300寄存器手册》附录C有详细说明。我整理了个常用配置对照表功能海思地址国科地址UART0_TX0x201500000x0_112C_0040I2C1_SCL0x201500480x0_112C_00885.2 编译器版本陷阱当看到automake needs newer version时千万别直接升级正确姿势sudo apt-get install automake1:1.15.1-3ubuntu2 sudo apt-mark hold automake国科SDK对automake版本极其敏感我用1.16版本编译必现Kconfig解析错误。5.3 内核保护模式设置在make menuconfig时这几个选项要特别注意Processor type and features → [ ] Enable kernel memory protection Device Drivers → Character devices → [*] Enable tiny config quick start取消勾选tiny config quick start能解决90%的模块加载问题但会增加编译时间约15分钟。
