U-Boot 移植

NXP 官方开发板 uboot 编译测试

1、查找 NXP 官方的开发板默认配置文件
uboot 移植的一般流程：
①、在 uboot 中找到参考的开发平台，一般是原厂的开发板。
②、参考原厂开发板移植 uboot 到我们所使用的开发板上。
正点原子的 I.MX6ULL 开发板参考的是 NXP 官方的 I.MX6ULL EVK 开发板做的硬件，因
此我们在移植 uboot 的时候就可以以 NXP 官方的 I.MX6ULL EVK 开发板为蓝本。
在移植之前，我们先编译一下 NXP 官方 I.MX6ULL EVK 开发板对应的 uboot，首先是配置
uboot， configs 目录下有很多跟 I.MX6UL/6ULL 有关的配置
I.MX6UL/6ULL 有 9x9mm 和 14x14mm 两种尺寸的，所
以我们可以看到会有 mx6ull_9x9和 mx6ull_14x14开头的默认配置文件。我们使用的是 14x14mm
的芯片，所以关注 mx6ull_14x14 开头的默认配置文件。正点原子的 I.MX6ULL 有 EMMC 和
NAND 两 个 版 本 的 ， 因 此 我 们 最 终 只 需 要 关 注 mx6ull_14x14_evk_emmc_defconfig 和
mx6ull_14x14_evk_nand_defconfig 这两个配置文件就行了。本章我们讲解 EMMC 版本的移植
（ NAND 版本移植很多类似），所以使用 mx6ull_14x14_evk_emmc_defconfig 作为默认配置文件。

2、编译 NXP 官方开发板对应的 uboot
直接创建个 shell 脚本就行了， shell 脚本名为 mx6ull_14x14_emmc.sh，然后在 shell 脚本里面输入如下
内容：
示例代码 33.1.2.1 mx6ull_14x14_emmc.sh 文件
1 #!/bin/bash
2 make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- distclean
3 make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- mx6ull_14x14_evk_emmc_defconfig
4 make V=1 ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- -j16
记得给 mx6ull_14x14_emmc.sh 这个文件可执行权限，使用 mx6ull_14x14_emmc.sh 脚本编
译 uboot 的时候每次都会清理一下工程，然后全部重新编译，编译的时候直接执行这个脚本就
行了，命令如下：
./mx6ull_14x14_evk_emmc.sh
编译完成以后会生成 u-boot.bin、 u-boot.imx 等文件

3、烧写验证与驱动测试
将 imxdownload 软件拷贝到 uboot 源码根目录下，然后使用 imxdownload 软件将 u-boot.bin
烧写到 SD 卡中，烧写命令如下：
chmod 777 imxdownload //给予 imxdownload 可执行权限
./imxdownload u-boot.bin /dev/sdg //烧写 u-boot.bin 到 SD 卡中
烧写完成以后将 SD 卡插入 I.MX6U-ALPHA 开发板的 TF 卡槽中，最后设置开发板从 SD
卡启动。
uboot 启动正常，虽然我们用的是 NXP 官方 I.MX6ULL 开发板的
uboot，但是在正点原子的 I.MX6ULL 开发板上是可以正常启动的。
1>、 SD 卡和 EMMC 驱动检查
使用命令 mmc list 列出当前的 MMC 设备
检查每个 MMC 设备信息，先检查 MMC 设
备 0，输入如下命令：
mmc dev 0
mmc info
再来检查 MMC 设备 1，输入如下命令：
mmc dev 1
mmc info
2>、 LCD 驱动检查
如果 uboot 中的 LCD 驱动正确的话，启动 uboot 以后 LCD 上应该会显示出 NXP 的 logo
如果你用的不是正点原子的 4.3 寸 480x272 分辨率的屏幕的话，那么 LCD 就不会显示
33.1.3.5 所示 logo 界面。因为 NXP 官方 I.MX6ULL 开发板的屏幕就是 4.3 寸 480x272 分辨率
的，所以 uboot 默认 LCD 驱动是 4.3 寸 480x272 分辨率的。如果使用其他分辨率的 LCD 就需
要修改 LCD 驱动
3>、网络驱动
uboot 启动的时候提示“ Board Net Initialization Failed”和“ No ethernet found.”这两行，说
明网络驱动也有问题，这是因为正点原子开发板的网络芯片复位引脚和 NXP 官方开发板不一
样，因此需要修改驱动。

总结一下 NXP 官方 I.MX6ULL EVK 开发板的 uboot 在正点原子 EMMC 版本 I.MX6ULL
开发板上的运行情况：
①、 uboot 启动正常， DRAM 识别正确， SD 卡和 EMMC 驱动正常。
②、 uboot 里面的 LCD 驱动默认是给 4.3 寸 480x272 分辨率的，如果使用的其他分辨率的
屏幕需要修改驱动。
③、网络不能工作，识别不出来网络信息，需要修改驱动。
接下来我们要做的工作如下：
①、前面我们一直使用着 NXP 官方开发板的 uboot 配置，接下来需要在 uboot 中添加我们
自己的开发板，也就是正点原子的 I.MX6ULL 开发板。
②、解决 LCD 驱动和网络驱动的问题。

在 U-Boot 中添加自己的开发板

1、添加开发板默认配置文件
先在 configs 目录下创建默认配置文件，复制 mx6ull_14x14_evk_emmc_defconfig，然后重
命名为 mx6ull_alientek_emmc_defconfig，命令如下：
cd configs
cp mx6ull_14x14_evk_emmc_defconfig mx6ull_alientek_emmc_defconfig
然后将文件 mx6ull_alientek_emmc_defconfig 中的内容改成下面的：
示例代码 33.2.1.1 mx6ull_alientek_emmc_defconfig 文件
1 CONFIG_SYS_EXTRA_OPTIONS="IMX_CONFIG=board/freescale/mx6ull_alientek_
emmc/imximage.cfg,MX6ULL_EVK_EMMC_REWORK"
2 CONFIG_ARM=y
3 CONFIG_ARCH_MX6=y
4 CONFIG_TARGET_MX6ULL_ALIENTEK_EMMC=y
5 CONFIG_CMD_GPIO=y
可以看出， mx6ull_alientek_emmc_defconfig 基本和 mx6ull_14x14_evk_emmc_defconfig 中
的内容一样，只是第 1 行和第 4 行做了修改。

2、添加开发板对应的头文件
在 目 录 include/configs 下 添 加 I.MX6ULL-ALPHA 开 发 板 对 应 的 头 文 件 ， 复 制
include/configs/mx6ullevk.h，并重命名为 mx6ull_alientek_emmc.h，命令如下：
cp include/configs/mx6ullevk.h mx6ull_alientek_emmc.h
拷贝完成以后将：
#ifndef __MX6ULLEVK_CONFIG_H
#define __MX6ULLEVK_CONFIG_H
改为：
#ifndef __MX6ULL_ALIENTEK_EMMC_CONFIG_H
#define __MX6ULL_ALIENTEK_EMMC_CONFIG_H
mx6ull_alientek_emmc.h 里面有很多宏定义，这些宏定义基本用于配置 uboot，也有一些
I.MX6ULL 的配置项目。如果我们自己要想使能或者禁止 uboot 的某些功能，那就在
mx6ull_alientek_emmc.h 里面做修改即可。
mx6ull_alientek_emmc.h 文件中基本都是“ CONFIG_”开头
的宏定义，这也说明 mx6ull_alientek_emmc.h 文件的主要功能就是配置或者裁剪 uboot。如果需
要某个功能的话就在里面添加这个功能对应的 CONFIG_XXX 宏即可，如果不需要某个功能的
话就删除掉对应的宏即可。

3、添加开发板对应的板级文件夹
uboot 中每个板子都有一个对应的文件夹来存放板级文件，比如开发板上外设驱动文件等
等。 NXP 的 I.MX 系列芯片的所有板级文件夹都存放在 board/freescale 目录下，在这个目录下
有个名为 mx6ullevk 的文件夹，这个文件夹就是 NXP 官方 I.MX6ULL EVK 开发板的板级文件
夹。复制 mx6ullevk，将其重命名为 mx6ull_alientek_emmc，命令如下：
cd board/freescale/
cp mx6ullevk/ -r mx6ull_alientek_emmc
进 入 mx6ull_alientek_emmc 目 录 中 ， 将 其 中 的 mx6ullevk.c 文 件 重 命 名 为
mx6ull_alientek_emmc.c，命令如下：
cd mx6ull_alientek_emmc
mv mx6ullevk.c mx6ull_alientek_emmc.c
我们还需要对 mx6ull_alientek_emmc 目录下的文件做一些修改：
1>、修改 mx6ull_alientek_emmc 目录下的 Makefile 文件
将 mx6ull_alientek_emmc 下的 Makefile 文件内容改为如下所示：
示例代码 33.2.3.1 Makefile 文件
1 # (C) Copyright 2015 Freescale Semiconductor, Inc.
2 #
3 # SPDX-License-Identifier: GPL-2.0+
4 #
5 6
obj-y := mx6ull_alientek_emmc.o
7 8
extra-$(CONFIG_USE_PLUGIN) := plugin.bin
9 $(obj)/plugin.bin: $(obj)/plugin.o
10 $(OBJCOPY) -O binary --gap-fill 0xff $< $@
重点是第 6 行的 obj-y，改为 mx6ull_alientek_emmc.o，这样才会编译 mx6ull_alientek_emmc.c
这个文件。
2>、修改 mx6ull_alientek_emmc 目录下的 imximage.cfg 文件
将 imximage.cfg 中的下面一句：
PLUGIN board/freescale/mx6ullevk/plugin.bin 0x00907000
改为：
PLUGIN board/freescale/mx6ull_alientek_emmc /plugin.bin 0x00907000
3>、修改 mx6ull_alientek_emmc 目录下的 Kconfig 文件
修改 Kconfig 文件，修改后的内容如下：
示例代码 33.2.3.2 Kconfig 文件
1 if TARGET_MX6ULL_ALIENTEK_EMMC
2 3
config SYS_BOARD
4 default "mx6ull_alientek_emmc"
5 6
config SYS_VENDOR
7 default "freescale"
8 9
config SYS_SOC
10 default "mx6"
11
12 config SYS_CONFIG_NAME
13 default "mx6ull_alientek_emmc"
14
15 endif
4>、修改 mx6ull_alientek_emmc 目录下的 MAINTAINERS 文件
修改 MAINTAINERS 文件，修改后的内容如下：
1 MX6ULL_ALIENTEK_EMMC BOARD
2 M: Peng Fan <peng.fan@nxp.com>
3 S: Maintained
4 F: board/freescale/mx6ull_alientek_emmc/
5 F: include/configs/mx6ull_alientek_emmc.h

4、修改 U-Boot 图形界面配置文件
修改文件
arch/arm/cpu/armv7/mx6/Kconfig(如果用的 I.MX6UL 的话，应该修改 arch/arm/Kconfig 这个文
件)，在 207 行加入如下内容：
示例代码 33.2.4.1 Kconfig 文件
1 config TARGET_MX6ULL_ALIENTEK_EMMC
2 bool "Support mx6ull_alientek_emmc"
3 select MX6ULL
4 select DM
5 select DM_THERMAL
在最后一行的 endif 的前一行添加如下内容：
示例代码 33.2.4.2 Kconfig 文件
1 source "board/freescale/mx6ull_alientek_emmc/Kconfig"

5、使用新添加的板子配置编译 uboot
在 uboot 根目录下新建一个名为 mx6ull_alientek_emmc.sh 的 shell 脚本，在这个 shell 脚本
里面输入如下内容：
1 #!/bin/bash
2 make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- distclean
3 make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- (加空格)
mx6ull_alientek_emmc_defconfig
4 make V=1 ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- -j16
编译完成以后就使用 imxdownload 将新编译出来的 u-boot.bin 烧写到 SD 卡中测试

6、LCD 驱动修改
一般 uboot 中修改驱动基本都是在 xxx.h 和 xxx.c 这两个文件中进行的， xxx 为板子名称，
比如 mx6ull_alientek_emmc.h 和 mx6ull_alientek_emmc.c 这两个文件。
一般修改 LCD 驱动重点注意以下几点：
①、 LCD 所使用的 GPIO，查看 uboot 中 LCD 的 IO 配置是否正确。
②、 LCD 背光引脚 GPIO 的配置。
③、 LCD 配置参数是否正确。
正点原子的 I.MX6U-ALPHA 开发板 LCD 原理图和 NXP 官方 I.MX6ULL 开发板一致，也
就是 LCD 的 IO 和背光 IO 都一样的，所以 IO 部分就不用修改了。需要修改的之后 LCD 参数，
打开文件 mx6ull_alientek_emmc.c，找到如下所示内容：
示例代码 33.2.6.1 LCD 驱动参数
1