LOFT-Q 主流系统快速指南¶

主流 Uboot 代码获取¶

loftq-uboot-next 下载指令如下：

git clone https://github.com/mixtile/loftq-uboot-next.git

主流 Uboot 代码构建¶

loftq-uboot-next 的构建指令如下：

cd loftq-uboot-next

make CROSS_COMPILE=arm-linux-gnueabi- mixtile_loftq_defconfig

make CROSS_COMPILE=arm-linux-gnueabi-

在构建完成后，在 loftq-uboot-next 目录中生成 u-boot-sunxi-with-spl.bin 文件。

主流内核代码获取¶

目前 LOFT-Q 项目实时跟进 Linux 最新代码的进度，提供了一些配置文件的定制和更新。最新的代码已经托管在 Mixtile 项目的 github 仓库。相关代码获取指令如下

git clone https://github.com/mixtile/linux.git -b loftq-dev

备注： 我们的 master 分支为主流分支，而定制分支为 loftq-dev。

主流内核代码构建¶

在获取了上述的代码之后，需要执行如下过程来构建主流内核代码：

cp arch/arm/configs/mixtile_loftq_defconfig .config

make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi-

make INSTALL_MOD_PATH=output ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- modules_install

在主流内核代码构建完成之后将会生成如下我们所需要的文件和目录：

• arch/arm/boot/zImage，主流内核文件 。
• arch/arm/boot/dts/sun6i-a31-mixtile-loftq.dtb，主流内核所需的 dts 配置文件。
• output/lib/modules，主流内核对应的内核模块。

对于上述生成的内核，dts文件，以及内核模块，我们需要将它们分别添加到 GNU/Linux 系统 rootfs 指定路径，对于不同的系统可能会有所不同，当然也可以根据自己的需要进行配置。

文件准备¶

对于 Debian 的构建，根据我们所使用的内核不同，需要不同的准备文件。

全志内核依赖配置文件：

• script.bin: 全志平台专用的配置文件，用于内核和uboot的配置，由 sys_config.fex 生成。

主流内核依赖配置文件：

• sun6i-a31-mixtile-loftq.dtb: 主流内核启动所需要的 dts 配置文件，在内核构建时会自动生成该文件。

其他两者都需要的文件：

• boot.scr: UBoot 可加载执行文件，主要包含 UBoot 启动内核之前所需要执行的一系列指令和配置，由 boot.cmd 生成，对于全志内核和主流内核，两者会有很大不同。
• u-boot-sunxi-with-spl.bin: 基于 linux-sunxi 社区提供的 mainline uboot 定制的用于 LOFT-Q 的 UBoot 代码，该版本基于 u-boot-sunxi 的 next 分支。
• uImage 及内核模块: LOFT-Q 的 linux 内核及模块文件。
• rootfs 压缩包: ARM 平台的系统 rootfs 所需要的根文件系统压缩包，包含一系列 GNU/Linux 系统用的基础系统和配置。

获取 Debian rootfs¶

Debian 的根文件系统可以使用如下方式获取，更多信息可以参考 https://wiki.debian.org/ArmHardFloatChroot 。

• 使用 qemu-debootstrap 获取最新的 armhf 基础系统。

  qemu-debootstrap --no-check-gpg --arch=armhf sid /chroots/sid-armhf ftp://ftp.debian.org/debian/
  

  指令的执行可能需要比较长的时间。

• 添加 debian 源，在 /chroots/sid-armhf/etc/apt/sources.list 中添加如下内容：

  deb http://ftp.debian.org/debian sid main
  deb-src http://ftp.debian.org/debian sid main
  

script.bin 生成¶

script.bin 是全志平台所用到的UBoot和内核配置文件，您可以在如下地址获取到最新的文件：

• script.bin 获取地址：https://github.com/mixtile/loftq-build/tree/master/bsp-legacy/binary/boot

或者可以使用下述指令来生成 script.bin 文件。

cd loftq-build/bsp/configs

./bin/fexc sys_config.fex script.bin

上述指令生成的 script.bin 即为可用的配置文件。

boot.scr 生成¶

boot.scr 是 UBoot 可以加载和执行的指令文件，主要用于执行加载内核以及执行内核之前的一些配置。当然，该文件也可以直接使用已生成的文件。

• 预编译 boot.scr: https://github.com/mixtile/loftq-build/tree/master/bsp/binary/boot .

• 如果根据自己的需要进行定制，具体的定制方法可以参考 boot.cmd 规则说明 在定制完成之后可以使用如下命令：

  cd loftq-build/bsp/configs
  
  mkimage -C none -A arm -T script -d boot_single.cmd boot.scr
  

  Note

  • 对于全志旧版内核，boot.scr 配置位于： loftq-build/bsp-legacy/configs/configs/boot_single.cmd
  • 对于主流内核，boot.scr 配置位于： loftq-build/bsp/configs/boot_single.cmd

bootdelay=3
console=ttyS0,115200
mmc_root=/dev/mmcblk0p1
init=/sbin/init
loglevel=8

setenv bootargs noinitrd console=${console} console=tty0 init=${init} loglevel=${loglevel} vmalloc=${vmalloc} partitions=${partitions} root=${mmc_root} rootwait rw rootfstype=ext4 panic=10 consoleblank=0 ${extra}

ext4load mmc 0 0x46000000 boot/mainline/zImage
ext4load mmc 0 0x48000000 boot/mainline/sun6i-a31-mixtile-loftq.dtb
bootz 0x46000000 - 0x48000000

ext4load mmc 0 0x43000000 boot/script.bin
ext4load mmc 0 0x48000000 boot/uImage
bootm 0x48000000

下载并构建 loftq-uboot-next¶

主流 Uboot 构建，可以参考 主流 Uboot 构建 。

linux 内核及模块构建¶

对于 Linux 内核及模块构建，可以参考 主流 Linux 构建 。

SD 卡分区¶

对于可启动的 SD/EMMC，其分区如下：

对于 SD/emmc 的分区，我们需要进行如下的设置。我们假定所使用的 sd 卡设备为 /dev/mmcblk0 。

• 清除原有分区信息，请在执行该动作之前，保存SD卡中原有重要数据。

  sudo dd if=/dev/zero of=/dev/mmcblk0 bs=1M count=1
  

• 新建 ext4 分区

  sudo fdisk /dev/mmcblk0
  

• 执行分区

  Command (m for help): n                                 # 输入 n
  Partition type:
     p   primary (0 primary, 0 extended, 4 free)
     e   extended
  Select (default p):                                     # 按下 Enter
  Using default response p
  Partition number (1-4, default 1):                      # 按下 Enter
  Using default value 1
  First sector (2048-15523839, default 2048):             # 按下 Enter
  Using default value 2048
  Last sector, +sectors or +size{K,M,G} (2048-15523839, default 15523839):      # 按下 Enter
  
  Command (m for help): w                                   # 输入 w 并 按下 Enter
  
  The partition table has been altered!
  

• 格式化分区为 ext4 格式

  sudo mkfs.ext4 /dev/mmcblk0p1
  

SD 卡写入 U-Boot¶

在完成分区的划分之后，执行下述指令向 SD/EMMC 中写入 U-Boot 文件。

sudo dd if=u-boot-sunxi-with-spl.bin of=/dev/mmcblk0 bs=1024 seek=8

拷贝 rootfs 到 SD 卡的 ext4 分区¶

sudo mount -t ext4 /dev/mmcblk0p1 /mnt

sudo cp -r /chroot/sid-armhf/* /mnt

拷贝 BSP 文件到 ext4 分区¶

在完成 rootfs 的拷贝之后，我们需要将 BSP 相关文件拷贝到指定的位置。

sudo cp boot.scr /mnt/boot
sudo cp linux/arch/arm/boot/zImage /mnt/boot/mainline
sudo cp linux/arch/arm/boot/dts/sun6i-a31-mixtile-loftq.dtb /mnt/boot/mainline
sudo cp -r linux/output/lib/modules /mnt/lib
sudo sync
sudo umount /mnt

sudo cp boot.scr /mnt/boot
sudo cp loftq-linux/arch/arm/boot/uImage /mnt/boot
sudo cp script.bin /mnt/boot
sudo cp -r loftq-linux/output/lib/modules /mnt/lib
sudo sync
sudo umount /mnt

JeOS rootfs 下载¶

openSUSE 社区提供了多个版本的 JeOS rootfs 可供下载，如下：

• Factory 版本: http://download.opensuse.org/ports/armv7hl/factory/images/
• 13.1 版本: http://download.opensuse.org/ports/armv7hl/distribution/13.1/appliances/
• 12.3 版本: http://download.opensuse.org/ports/armv7hl/distribution/12.3/images/

我们可以从中选择一个版本的进行测试使用, 更多有关各个版本之间的异同信息, 可以参阅 https://en.opensuse.org/HCL:Chroot 。

以 13.1 版本的 openSUSE Jeos 根文件系统为例，我们需要下载名称如 openSUSE-*-ARM-JeOS.armv7-rootfs-*.tbz 的镜像文件，对于可启动 SD 卡的创建，其步骤和需要的文件与 Debian 构建 相同。只是在 rootfs 的生成和拷贝过程存在不同，其他过程按照 Debian 构建过程进行即可。

那么对于 rootfs 到 ext4 分区的拷贝，我们以 openSUSE-Factory-ARM-JeOS.armv7-rootfs.armv7l-Current.tbz 为例，所需执行指令如下：

sudo tar -C /mnt -xjf openSUSE-Factory-ARM-JeOS.armv7-rootfs.armv7l-Current.tbz

在执行完该步骤之后，参照 Debian 构建 的步骤，在相应位置添加 BSP 及内核模块文件。

Linux 系统¶

为了方便快速的在 LOFT-Q 上使用 GNU/Linux 系统，我们为 LOFT-Q 提供了预编译了内核，启动配置文件的 Linux 系统压缩包，列表如下：

• Debian sid 版本
• openSUSE 13.1 版本
• openSUSE Factory 版本

链接地址: http://www.mixtile.com/downloads/loft-q/

您只需要参照 SD 卡分区 和 SD 卡写入 U-Boot 完成分区和 U-Boot 烧录后，将上述的压缩文件解压到 Ext4 分区即可。