猫盘 (ARMADA A3720) 刷机教程

简介

猫盘又是一款矿难机，配置如下

CPU: Marvell ARMADA A3720 1.0Ghz 2xCortex-A53
RAM: 512M DDR3
eMMC: 8G HS200
网络: Marvell 88e1512 千兆phy
外设: 原生SATA，主板引出USB2.0和TTL，带1个风扇和aw2013控制的三色LED
电源: 5V3A

由于espressobin开发板的配置与本机器比较接近，所以内核是通用的，但是需要适配dts，适配好的dts请看参考资料里面的Github仓库

Marvell目前提供有4.4和4.14的bsp内核（猫盘原厂固件就是4.4bsp内核），另外linux主线内核对armada的支持也不错，espressobin的armbian固件就是采用主线内核（4.19 LTS），我会尽快更新build-catdrive加入4.19内核的armbian固件（此固件不重新编译内核，仅适配dtb，因此phy的LED不会闪烁，三色LED也不工作）

在build-catdrive中的其他固件均采用Marvell的4.14 bsp内核，已经加入了aw2013的驱动，LED正常工作，可以通过sysfs控制，在系统poweroff之后LED熄灭。另外网口的LED灯也会闪烁。

猫盘通过spi nor flash启动的，rootfs放在emmc中，若不慎刷砖，只需用编程器刷spi flash即可救砖

原厂的uboot无法保存环境变量（复位后自动恢复默认env），因此需要刷入新的uboot，然后在新uboot中启动U盘/硬盘的临时系统，最后将新的rootfs镜像写入emmc

资料下载

准备工作

空的2.5寸硬盘(需要移动硬盘盒或者易驱线)或U盘(需要将USB母座接到主板上的USB排针上，见下图)
USB转TTL线，如ch340等，按下图接线，波特率为115200，注意千万别接VCC

UART与USB排针

刷入uboot: 方法1

U盘/硬盘格式化为mbr的ext4或fat32分区，将flash-image.bin复制到其根目录下，然后插到猫盘上
接好TTL后上电,在倒计时结束前反复按回车进入原厂uboot
在uboot控制台依次输入以下命令:

setenv bootargs "console=ttyMV0,115200 root=/dev/mmcblk0p1 rootwait rw init=/bin/sh"
ext4load mmc 0:1 0x1000000 boot/armada-3720-customer0.dtb
ext4load mmc 0:1 0x2000000 boot/Image
booti 0x2000000 - 0x1000000

等待系统启动完成进入无需登陆的shell

进入shell后依次输入以下命令（这一步是把flash-image.bin复制到emmc的第2分区上）
当同时插入U盘和硬盘的时候，有可能需要挂载/dev/sdb1

mount -t proc /proc
mount /dev/mmcblk0p2 /media
mount /dev/sda1 /mnt
cp -f /mnt/flash-image.bin /media
umount /media
umount /mnt

然后直接拔电

上电，在倒计时结束前反复按回车再次进入原厂uboot
在uboot控制台依次输入以下命令 (切勿在uboot控制台中反复按回车)

ext4load mmc 0:2 0x1000000 flash-image.bin
sf probe
sf erase 0x0 0x200000
sf write 0x1000000 0x0 0x200000

确保上一步的命令正常执行完毕之后，输入reset复位，然后在倒计时结束前反复按回车进入新uboot
在uboot控制台依次输入以下命令，注意mac地址要改成你自己的

env default -a
setenv ethaddr "4c:65:a8:10:e2:55"
saveenv

此时新uboot已经部署完毕，可以直接拔电准备下一步操作

刷入uboot: 救砖

如果在常规步骤中操作失误，导致上电后不能进入uboot控制台，则需要拆下板子上面的spi flash, 用编程器将flash-image.bin写入spi flash, 再焊回去, 之后按照常规操作的第4步恢复环境变量和mac地址即可
除此之外，还可以使用A3700-utils中提供的wtptp串口工具救砖（需要Linux环境），具体操作请看参考资料

刷emmc

确保已经正确刷入新uboot，将img镜像解压后用etcher或者其他工具写入硬盘或者U盘，插回板子上

对于硬盘刷机：
上电，在倒计时结束前反复按回车进入新uboot
在uboot控制台依次输入以下命令:

setenv boot_targets "sata mmc0 usb"
boot

对于U盘刷机：
插好U盘后直接上电即可

进入U盘/硬盘的临时系统后(应该是一个alpine，用户名：root；密码：admin)，运行

emmc-install.sh

等待刷入完成，然后输入poweroff关机，输出示例如下：

alpine:~# emmc-install.sh 
flash emmc...
1000MiB 0:00:33 [29.8MiB/s] [================================>] 100%            
7+7144 records in
7+7144 records out
1048576000 bytes (1.0 GB, 1000 MiB) copied, 34.5134 s, 30.4 MB/s
flash done, please unplug USB drive and reboot now!
alpine:~# poweroff

如果是用U盘刷机的话则需要拔掉U盘后再启动，即可进入新系统，而对于硬盘刷机则无需拔除硬盘，可在新系统中直接将其格式化

在刷好新uboot之后，若要刷入build-catdrive中的其他linux发行版，直接从刷emmc这一步开始即可
由于猫盘内存较小，建议设置1GB的swap，具体操作请看下面

系统相关设置

设置swap

dd if=/dev/zero of=/swapfile bs=1M count=1000 #创建1GB的swap
chmod 600 /swapfile
mkswap /swapfile
echo "/swapfile swap swap defaults 0 0" >> /etc/fstab

风扇控制（主线内核不可用）

echo 0 > /sys/class/thermal/cooling_device0/cur_state  #关闭风扇
echo 1 > /sys/class/thermal/cooling_device0/cur_state  #打开风扇

LED灯控制（主线内核不可用）

echo 0 > /sys/class/leds/blue/brightness  #关闭蓝灯
echo 255 > /sys/class/leds/green/brightness  #点亮最高亮度的绿灯
echo 128 > /sys/class/leds/red/brightness  #点亮中等亮度的红灯

echo 2 > /sys/class/leds/red/blink #点亮红色呼吸灯，可设为其他值
echo 0 > /sys/class/leds/green/blink #关闭绿色呼吸灯

硬盘休眠
build-catdrive中的固件已经设置好10分钟无操作自动休眠硬盘，如果需要调整时长，请修改/etc/udev/rules.d/99-hdparm.rules里面的hdparm -S之后的参数，默认值是120（10分钟）

ACTION=="add", SUBSYSTEM=="block", KERNEL=="sd*",ENV{ID_BUS}=="ata", ENV{DEVTYPE}=="disk", RUN+="/sbin/hdparm -S 120 $env{DEVNAME}"

读写uboot环境变量

fw_setenv foo bar
fw_printenv

uboot其他操作

在新uboot里从U盘根目录中刷入uboot

bubt flash-image.bin spi usb

在新uboot里从tftp中刷入uboot

setenv ipaddr 192.168.1.100 #设定本机ip
setenv serverip 192.168.1.2 #设定tftp服务器ip
bubt flash-image.bin spi tftp

在新uboot里改变启动顺序

setenv boot_targets "usb sata mmc0" #默认为usb->mmc0->sata
saveenv

已知问题

主线内核中无法控制风扇的gpio（会导致以太网phy重新复位），所以poweroff后风扇不停