¶ 简介
| 更多信息： Banana Pi BPI-M2 Super |
¶ 规格参数
¶ 开发
¶ 准备
-
准备一根 USB 转串口线和一个 5 V/3 A Type-C 电源适配器。串口线用于控制台调试，Type-C 数据线用于下载 Android 镜像和 ADB 调试。
-
Linux 开发需要一张至少 8 GB 的 SD 卡；Android 仅支持从 eMMC 启动。
-
SoC ROM 首先尝试从 eMMC 启动。因此，只要 eMMC 中存在可启动镜像，开发板就无法从 SD 卡启动。更多信息请参阅“启动顺序”一节。
-
仅 A311D 版本的开发板支持摄像头、MIPI 显示屏和 NPU。
¶ Android
¶ 准备
-
下载并安装 AML USB Burning Tool，用于通过 Type-C 下载 Android 镜像；该工具仅支持 Windows。
-
下载最新的 Android 镜像，并确认 MD5 校验值正确。
¶ 使用 USB Burning Tool 安装镜像
-
打开 USB_Burning_Tool.exe，选择菜单 File → Import image，然后选择 Android 镜像文件 aml_upgrade_package.img。
-
按住开发板上的 USB 按钮，同时用 Type-C USB 数据线连接 PC；如果已经接通电源适配器，也可以按 RST 按钮。约两秒后松开按钮，工具应能正确识别开发板。
-
单击下载工具中的 Start 按钮，等待升级完成。
-
写入成功后，拔下 Type-C USB 数据线，再连接电源适配器启动开发板。
-
单击 Stop 按钮取消升级过程，然后关闭 USB Burning Tool。
¶ 使用 Aml Flash Tool 安装镜像
Aml-flash-tool 是一款在 Linux 平台上为 Amlogic Android 设备写入镜像的开源工具。
$ ./flash-tool.sh --img=/path/to/aml_upgrade_package.img --parts=all --wipe --soc=g12a --reset=y
¶ 构建 Android 源代码
-
获取 Android 9.0源代码
git clone https://github.com/BPI-SINOVOIP/BPI-A311D-Android9也可以从 百度网盘（提取码：8888）或 Google Drive下载源码 tar 包。
-
构建 Android 9.0 源代码
请阅读源代码 README.md
¶ Android DTB Overlay
下表列出 Banana Pi M2S 的 DTBO idx 值；发布镜像中的默认 idx 为 0。
| Banana Pi M2S DTBO idx 值表 | ||
|---|---|---|
idx 值 |
设备树 Overlay |
说明 |
0 |
android_p_overlay |
默认 DTBO，不启用额外功能 |
1 |
wifi_bt_rtl8822cs |
启用 Banana Pi RTL8822CS Wi-Fi/蓝牙模块 |
2 |
i2c1 |
启用 i2c 1 |
3 |
i2c2 |
启用 i2c 2 |
4 |
sdio |
启用 SDIO |
5 |
uart1 |
启用双引脚 UART 1 |
6 |
uart1_cts_rts |
启用四引脚 UART 1 |
7 |
uart2 |
启用双引脚 UART 2 |
8 |
hifi_pcm5122 |
启用 I2S PCM5122 HiFi DAC |
如何应用新的 dtbo
-
通过 sysfs 的 ADB 命令
root@dangku-desktop:/tmp# adb root restarting adbd as root root@dangku-desktop:/tmp# adb remount remount succeeded root@dangku-desktop:/tmp# adb shell bananapi_m2s:/ # echo dtbo > /sys/class/unifykeys/name bananapi_m2s:/ # echo "1" > /sys/class/unifykeys/write bananapi_m2s:/ # reboot -
通过 sysfs 执行 UART 控制台命令
console:/ $ console:/ $ su console:/ # echo dtbo > /sys/class/unifykeys/name [ 115.702781@0] unifykey: name_store() 1302, name dtbo, 4 [ 115.702856@0] unifykey: name_store() 1311 console:/ # console:/ # echo "1" > /sys/class/unifykeys/write [ 129.262659@0] unifykey: write_store() is a string [ 129.262733@0] unifykey: dtbo, 1, 1 [ 129.265312@0] unifykey: amlkey_write 393 [ 129.292347@1] emmc_key_write:149, write ok console:/ # console:/ # reboot -
设置应用（待完成）
检查启动时的 UART 调试信息，确认实际加载的 DTBO。这里的“1”表示设置 idx=1，以应用 wifi_bt_rtl8822cs DTBO。
load dtb from 0x1000000 ...... Amlogic multi-dtb tool Single dtb detected find 2 dtbos dtbos to be applied: 1 Apply dtbo 1Unifykeys 保存在 eMMC 的特定分区中。在 USB_Burning_Tool 中选择“Normal erase”不会清除该数据，后续升级仍会保留。若希望下载镜像后应用默认 DTBO idx，必须选择“Erase all”。
构建使用指定默认 DTBO 的 Android 镜像。
-
默认内置 Overlay 定义在 device/bananapi/bananapi_m2s/Kernel.mk 中，可以在此处添加新的 DTBO Overlay。
DTBO_DEVICETREE := android_p_overlay wifi_bt_rtl8822cs i2c1 i2c2 sdio uart1 uart1_cts_rts uart2 hifi_pcm5122 -
默认应用的 DTBO idx 定义在 device/bananapi/bananapi_m2s/BoardConfig.mk 中，可以修改 idx 值来选择默认应用的 DTBO Overlay。
BOARD_KERNEL_CMDLINE += androidboot.dtbo_idx=0 -
DTS 文件位于 common/arch/arm64/boot/dts/amlogic/overlay/bananapi_m2s/
有关 Android 设备树 Overlay 的更多信息，请参阅 Android 官方文档。
¶ 安装 OpenGapps
-
从 OpenGApps 下载安装包；Android 发布镜像使用 ARM/Android 9.0 版本。
-
下载 device_id.apk。
-
将 OpenGApps 软件包复制到 U 盘或 SD 卡根目录。
-
在 U 盘或 SD 卡根目录创建名为 factory_update_param.aml 的文本文件，写入以下 Android Recovery 参数，并将文件名替换为实际下载的软件包名称。
U 盘：--wipe_cache --update_package=/udisk/open_gapps-arm-9.0-pico-20210327.zipSD 卡：
--wipe_cache --update_package=/sdcard/open_gapps-arm-9.0-pico-20210327.zip -
将 U 盘或 SD 卡插入开发板，然后开机。
-
安装 OpenGApps 并完成认证。
YouTube 视频： https://youtu.be/fXOKmWfpqF8
也可以在 哔哩哔哩观看此视频。
¶ 切换 MIPI 显示屏
由于硬件在启动时无法自动识别不同的 MIPI 显示屏，默认 Android 发布镜像一次只支持一种显示屏。系统默认启用 [800x1280 BPI panel]，也可以在 Settings → Panel Output 中将默认显示屏切换为 [1200x1920 BPI panel]。
¶ 面板旋转
两款 10 英寸 MIPI 显示屏在硬件上均为竖屏，因此默认 Android 发布镜像采用竖屏模式。可以通过以下两种方式将其旋转 90/180/270 度。
-
在 Settings → Display → Screen rotation 中旋转 UI
-
使用 SurfaceFlinger 旋转，需要 修改 Android 源代码并重新构建
修改默认的 SurfaceFlinger 旋转属性：
diff --git a/device/bananapi/bananapi_m2s/bananapi_m2s.mk b/device/bananapi/bananapi_m2s/bananapi_m2s.mk index 1f51703..d592a44 100644 --- a/device/bananapi/bananapi_m2s/bananapi_m2s.mk +++ b/device/bananapi/bananapi_m2s/bananapi_m2s.mk @@ -579,6 +579,6 @@ PRODUCT_PROPERTY_OVERRIDES += \ else PRODUCT_PROPERTY_OVERRIDES += \ ro.sf.lcd_density=213 \ - ro.sf.primary_display_orientation=0 + ro.sf.primary_display_orientation=90 endif修改 DTS 中的触摸屏旋转配置：
diff --git a/common/arch/arm64/boot/dts/amlogic/bananapi_m2s.dts b/common/arch/arm64/boot/dts/amlogic/bananapi_m2s.dts index 4a698b0..3d41b63 100755 --- a/common/arch/arm64/boot/dts/amlogic/bananapi_m2s.dts +++ b/common/arch/arm64/boot/dts/amlogic/bananapi_m2s.dts @@ -876,8 +876,8 @@ reg = <0x5d>; reset-gpio = <&gpio GPIOA_6 GPIO_ACTIVE_HIGH>; irq-gpio = <&gpio GPIOA_5 GPIO_ACTIVE_HIGH>; - rotation = <4>; /* sf_rotation 0 */ - //rotation = <0>; /* sf_rotation 90*/ + //rotation = <4>; /* sf_rotation 0 */ + rotation = <0>; /* sf_rotation 90*/ //rotation = <5>; /* sf_rotation 180 */ //rotation = <3>; /* sf_rotation 270 */
¶ 自定义 Android 启动徽标
Android 引导加载程序默认将启动徽标帧缓冲区限制为 1080p60/1920x1080；Android 内核 DTB 分区表默认将启动徽标分区大小限制为 16 MB。
-
准备一个 16 位 BMP 文件，并命名为 boot-logo.bmp。
-
将 bmp 文件压缩为 boot-logo.bmp.gz
$ gzip boot-logo.bmp -
解压该工具包。
$ unzip m2s_android_bootlogo_tool.zip $ cd m2s_android_bootlogo_tool/ $ ls -l logo/ -rwxr--r-- 1 dangku dangku 525054 Sep 25 16:54 bootup.bmp -rwxr--r-- 1 dangku dangku 525054 Sep 25 16:54 bootup_secondary.bmp -rwxr--r-- 1 dangku dangku 184 May 19 2020 upgrade_bar.bmp -rwxr--r-- 1 dangku dangku 180072 May 19 2020 upgrade_error.bmp -rwxr--r-- 1 dangku dangku 180072 May 19 2020 upgrade_fail.bmp -rwxr--r-- 1 dangku dangku 180072 May 19 2020 upgrade_logo.bmp -rwxr--r-- 1 dangku dangku 180072 May 19 2020 upgrade_success.bmp -rwxr--r-- 1 dangku dangku 184 May 19 2020 upgrade_unfocus.bmp -rwxr--r-- 1 dangku dangku 180072 May 19 2020 upgrade_upgrading.bmp -
复制 boot-logo.bmp.gz
$ cp boot-logo.bmp.gz logo/bootup.bmp $ cp boot-logo.bmp.gz logo/bootup_secondary.bmp -
使用镜像打包工具创建目标 logo.img；m2s_android_bootlogo_tool 的二进制文件和相关库复制自 <android-source-dir>/out/host/linux-x86。
$ ./logo_img_packer -r logo logo.img -
使用 fastboot 写入启动徽标
$ adb root $ adb remount $ adb reboot fastboot等待几秒，然后检查 fastboot 是否已连接：
$ fastboot device 1234567890 fastboot $ fastboot flashing unlock_critical $ fastboot flashing unlock $ fastboot flash logo logo.img $ fastboot reboot
¶ Linux
¶ 准备
-
Linux 镜像支持从 SD 卡或 eMMC 启动。
-
建议使用容量至少为 8 GB 的 A1 等级存储卡。
-
若要从 SD 卡启动，请先格式化带有可启动系统的 eMMC。
-
若要从 eMMC 启动并将 SD 卡用作存储，请确保 SD 卡已格式化且未写入 Linux 镜像。
-
在 Linux PC 上安装 bpi-tools（如果使用其他工具写入镜像，可跳过此步）。如果无法访问该地址或安装时遇到问题，请前往 bpi-tools 源码仓库手动下载并安装。
$ apt-get install pv $ curl -sL https://github.com/BPI-SINOVOIP/bpi-tools/raw/master/bpi-tools | sudo -E bash -
下载最新的 Linux 镜像，并确认 MD5 校验值正确。
-
默认登录： pi/bananapi 或 root/bananapi
-
本 Wiki 指南仅适用于 Banana Pi 4.9 BSP Ubuntu/Debian 镜像。
¶ 将镜像写入 SD 卡
使用 Balena Etcher 写入镜像，支持 Windows、Linux 和 macOS。
Balena Etcher 是 Balena 提供的开源图形化镜像写入工具，可将操作系统镜像写入 SD 卡或 U 盘。
单击“Flash from file”选择镜像，单击“Select target”选择目标设备，再单击“Flash!”开始写入。
使用 Balena CLI 写入镜像，支持 Windows、Linux 和 macOS。
Balena CLI 是 balenaCloud/openBalena 的命令行工具，可用于写入 Linux 镜像。从 balena-io Releases下载安装程序或独立软件包，并按照 安装说明正确安装到 PC。随后可使用 Balena 的“local flash”命令将 Linux 镜像写入 SD 卡或 U 盘。
$ sudo balena local flash path/to/xxx-bpi-m2s-xxx.img.zip
$ sudo balena local flash path/to/xxx-bpi-m2s-xxx.img.zip --drive /dev/disk2
$ sudo balena local flash path/to/xxx-bpi-m2s-xxx.img.zip --drive /dev/disk2 --yes在 Linux 中使用 dd 命令写入镜像
如果 SD 卡设备 /dev/sdX 的分区已自动挂载，请先将其卸载。bpi-copy 的实际写入方式与此 dd 命令相同。
$ sudo apt-get install pv unzip
$ sudo unzip -p xxx-bpi-m2s-xxx.img.zip | pv | dd of=/dev/sdX bs=10M status=noxfer在 Linux 中使用 bpi-tools 写入镜像
将 SD 卡插入 Linux PC，然后运行：
$ sudo apt-get install pv unzip
$ sudo bpi-copy xxx-bpi-m2s-xxx.img.zip /dev/sdX¶ 安装镜像到 eMMC
-
准备一张已写入 Linux 镜像的 SD 卡，并用该 SD 卡启动开发板。
-
将 Linux 镜像复制到 U 盘，把 U 盘插入开发板并挂载。
-
可通过以下两种方式将 Linux 镜像安装到开发板。
-
使用 dd 命令安装，如果自动安装，则 umount mmcblk0p1 和 mmcblk0p2 分区。其实 bpi-copy 与此 dd 命令相同。
$ sudo apt-get install pv unzip $ sudo unzip -p xxx-bpi-m2s-xxx.img.zip | pv | dd of=/dev/mmcblk0 bs=10M status=noxfer -
使用 bpi-tools 命令安装 U 盘中的 Linux 镜像
$ sudo apt-get install pv unzip $ sudo bpi-copy xxx-bpi-m2s-xxx.img.zip /dev/mmcblk0
-
-
下载完成后，安全关闭电源并弹出 SD 卡。
¶ 构建 Linux 源代码
-
获取 Linux BSP 源代码
$ git clone https://github.com/BPI-SINOVOIP/BPI-M2S-bsp -
构建 BSP 源代码
请阅读源代码 README.md -
如果要分别构建 U-Boot 和内核，请下载 U-Boot 和 内核源码，并从 BPI-M2S-bsp获取工具链、启动脚本和其他配置文件。
¶ DTB Overlay
-
DTB Overlay 用于配置 40 针 GPIO 的复用功能，文件安装在 VFAT 启动分区中。可以使用 mount 命令查看挂载点。
root@bananapi:~# ls /boot/overlays/ custom_ir.dtbo pwm_b-backlight.dtbo spi0.dtbo ds3231.dtbo pwm_c-beeper.dtbo uart1_cts_rts.dtbo hifi_pcm5102a.dtbo pwm_cd-c.dtbo uart1.dtbo hifi_pcm5122.dtbo pwm_cd.dtbo uart2.dtbo i2c1.dtbo pwm_ef.dtbo waveshare_tft24_lcd.dtbo i2c2.dtbo pwm_ef-f.dtbo waveshare_tft35c_lcd.dtbo pwm_ab.dtbo sdio.dtbo waveshare_tft35c_rtp.dtbo -
更新 VFAT 分区中 /boot/env.txt 的 Overlay 环境变量，启用所需功能。
# Device Tree Overlays # uart1 -- Enable UART1 (uart_A, GPIO Header PIN8 & PIN10) # pwm_c -- Enable PWM_C (GPIO Header PIN7) # i2c2 -- Enable i2c2 (GPIO Header PIN3 & PIN5) # spi0 -- Enable SPI0 (GPIO Header PIN19 & PIN21 & PIN23 & PIN24) overlays="i2c2 spi0 uart1" -
必须重新启动开发板才能加载 DTB Overlay。
¶ 启用摄像头
Linux 发布镜像默认禁用摄像头，可按以下步骤启用。
-
更新 /boot/env.txt 中的 DTB Overlay 环境变量，启用摄像头 DTBO。
overlays="os08a10" -
将摄像头模块添加到 /etc/modules：
iv009_isp_iq iv009_isp_lens iv009_isp_sensor iv009_isp -
创建 /etc/modprobe.d/os08a10.conf，并添加摄像头模块选项：
#choose camera calibration parameters options iv009_isp_iq cali_name=0 #choose isp register sequence options iv009_isp_sensor isp_seq_num=0 -
启用摄像头 ISP systemd 服务：
$ sudo systemctl enable camera_isp_3a_server.service重新启动后，摄像头设备为 /dev/video0。
¶ 切换 MIPI 显示屏
由于硬件在启动时无法自动识别不同的 MIPI 显示屏，默认 Linux 发布镜像一次只支持一种显示屏。系统默认启用 800x1280 BPI 显示屏，也可以在 /boot/lcd_env.txt 中将默认显示屏改为 [1200x1920 BPI panel]。
# Mipi panel type
# Symbol | Resolution
# ----------------------+-------------
# "lcd_0" | 10" 800x1280 panel
# "lcd_1" | 10" 1200x1920 panel
panel_type=lcd_0| 注意：Linux 不支持双屏显示，因此使用 MIPI 显示屏时请断开 HDMI 线。 |
¶ 面板旋转
两款 10 英寸 MIPI 显示屏在硬件上均为竖屏，因此默认发布镜像采用竖屏模式，也可以将其旋转 90/180/270 度。
对于桌面镜像，创建 Xorg 配置文件 /usr/share/X11/xorg.conf.d/10-fbdev-rotate.conf，内容如下：
Section "Device"
Identifier "Configured Video Device"
# Rotate off
# Option "Rotate" "off"
# Rotate Right / clockwise, 90 degrees
Option "Rotate" "CW"
# Rotate upside down, 180 degrees
# Option "Rotate" "UD"
# Rotate counter clockwise, 270 degrees
# Option "Rotate" "CCW"
EndSection
Section "InputClass"
Identifier "Coordinate Transformation Matrix"
MatchIsTouchscreen "on"
MatchProduct "goodix-ts"
MatchDevicePath "/dev/input/event0"
MatchDriver "libinput"
# Rotate Right / clockwise, 90 degrees
Option "CalibrationMatrix" "0 1 0 -1 0 1 0 0 1"
# Rotate upside down, 180 degrees
# Option "CalibrationMatrix" "-1 0 1 0 -1 1 0 0 1"
# otate counter clockwise, 270 degrees
# Option "CalibrationMatrix" "0 -1 1 1 0 0 0 0 1"
EndSection对于服务器镜像，可以通过以下两种方式更改帧缓冲区旋转：
-
通过 sysfs 动态修改。
echo 0 > /sys/class/graphics/fbcon/rotate //origin 0 degree echo 1 > /sys/class/graphics/fbcon/rotate //90 degree echo 2 > /sys/class/graphics/fbcon/rotate //180 degree echo 3 > /sys/class/graphics/fbcon/rotate //270 degree -
修改启动配置。
更改 /boot/env.txt 中的 fb_rotate 环境变量：# Framebuffer Rotate # 0 - origin 0 degree # 1 - 90 degree # 2 - 180 degree # 3 - 270 degree fb_rotate=0
¶ WiringPi
| 注意：此 WiringPi 仅支持配置 40 针 GPIO 的输出、输入、PWM 或软件 PWM。对于 I2C、SPI 等 I/O 功能，必须在 boot.ini 中启用 DTB Overlay。 |
-
构建并安装 WiringPi。在 Debian 中，构建前必须 安装 sudo。
$ sudo apt-get update $ sudo apt-get install build-essential git $ git clone https://github.com/Dangku/amlogic-wiringPi $ cd amlogic-wiringPi $ chmod a+x build $ sudo ./build -
运行 gpio readall 查看全部 40 针引脚的状态。
-
BPI GPIO 扩展板及示例见 amlogic-wiringPi/examples。
blinkall：不使用扩展板，使所有 GPIO 引脚闪烁。
lcd-bpi：BPI LCD 1602 显示模块示例。
52pi-bpi：BPI OLED 显示模块示例。
matrix-bpi：BPI RGB LED 矩阵扩展模块示例。
berryclip-bpi：BPI BerryClip 模块示例。
¶ RPi.GPIO
构建并安装 RPi.GPIO。在 Debian 中，构建前必须 安装 sudo。
$ sudo apt-get update
$ sudo apt-get install build-essential python3 python3-pip python3-dev python3-setuptools git
$ git clone https://github.com/Dangku/RPi.GPIO-Amlogic.git
$ cd RPi.GPIO-Amlogic
$ sudo python3 setup.py clean --all
$ sudo python3 setup.py install创建并安装 wheel 软件包：
$ sudo python3 setup.py bdist_wheel
$ sudo pip3 install dist/RPi.GPIO-XXX.whl直接从 Git 源码安装，无需本地构建：
$ sudo pip3 install git+https://github.com/Dangku/RPi.GPIO-Amlogic.git如果已经安装该软件包，应先卸载旧版本再安装新版本，或使用 --force-reinstall 选项强制重新安装。
¶ WiringPi2-Python
构建并安装 WiringPi2-Python。在 Debian 中，构建前必须 安装 sudo。
$ sudo apt-get update
$ sudo apt-get install build-essential python3 python3-dev python3-setuptools swig git
$ git clone --recursive https://github.com/Dangku/WiringPi2-Python-Amlogic.git
$ cd WiringPi2-Python-Amlogic
$ sudo python3 setup.py install¶ Luma 示例
Luma.examples 默认使用 GPIO.BCM 编号模式，因此需要将 40 针排针映射到 BCM GPIO 编号，并正确连接硬件。
-
构建并安装 RPi.GPIO 由于 Luma 使用 Python 3，请用 python3 而不是 python 构建 Banana Pi M2S 的 RPi.GPIO。
$ sudo apt-get update $ sudo apt-get install build-essential python3 python3-dev python3-setuptools git $ git clone https://github.com/Dangku/RPi.GPIO-Amlogic.git $ cd RPi.GPIO-Amlogic $ sudo python3 setup.py clean --all $ sudo python3 setup.py install可以根据硬件背光 GPIO 修改 test/led.py 中的 bcmledpin 变量，然后运行脚本检查 RPi.GPIO 是否正常工作。
$ sudo python3 test/led.py硬件背光会反复开启和关闭。
-
luma.examples 库安装
$ sudo usermod -a -G i2c,spi,gpio pi如果组不存在，以下命令将创建它：
$ sudo groupadd --system xxx $ sudo apt-get install python3-dev python3-pip libfreetype6-dev libjpeg-dev build-essential $ sudo apt-get install libsdl-dev libportmidi-dev libsdl-ttf2.0-dev libsdl-mixer1.2-dev libsdl-image1.2-dev $ git clone https://github.com/rm-hull/luma.examples.git $ cd luma.examples安装 luma.core、luma.emulator、luma.lcd、luma.led-matrix 和 luma.oled 等 pip 库。确保此步骤没有报错或下载中断；如有错误，请重试。
$ sudo -H pip install -e .或
$ sudo -H pip3 install -e .Debian Buster（Python 3.7）的 python3-pip 软件包不包含 /usr/bin/pip，使用 pip3 安装 Luma 软件包时可能出现以下错误：
... WARNING, No "Setup" File Exists, Running "buildconfig/config.py" Using UNIX configuration... /bin/sh: 1: sdl2-config: not found /bin/sh: 1: sdl2-config: not found /bin/sh: 1: sdl2-config: not found ...安装 SDL2 相关软件包解决此问题，然后再次使用 pip3 安装 Luma 库：
$ sudo apt-get install libsdl2-dev libsdl2-ttf-dev libsdl2-mixer-dev libsdl2-image-dev $ sudo -H pip3 install -e . check installed luma pip libs $ pip3 list | grep luma luma.core 2.4.0 luma.emulator 1.4.0 luma.lcd 2.10.0 luma.led-matrix 1.7.0 luma.oled 3.11.0 -
示例测试
运行测试示例前，先启用 I2C 或 SPI Overlay。$ cd examples $ sudo python3 bounce.py --config ../conf/ili9341.conf
¶ HDMI LCD
| Banana Pi M2 Super 已测试的 HDMI LCD | |
|---|---|
显示屏 |
/boot/boot.ini |
setenv display_autodetect "false" |
|
setenv display_autodetect "false" |
|
setenv display_autodetect "false" |
|
setenv display_autodetect "false" |
|
背光控制：https://github.com/Dangku/Waveshare-USB-Brightness
¶ 自定义 Linux 启动徽标
Linux U-Boot 默认将启动徽标帧缓冲区限制为 1080p60/1920x1080，因此默认镜像不支持更高分辨率；可以修改 U-Boot 源代码来提供支持。
-
准备一个 24 位 BMP 文件，并命名为 boot-logo.bmp。
-
将目标文件复制到 /boot/firmware/ 或 /boot/ 目录。
¶ 其他开发
¶ 启动顺序
在控制台调试信息开头检查引导加载程序是从 SD 卡还是 eMMC 加载。
-
ROM 从 SD 卡加载引导加载程序（Linux 日志示例）
... BL2 Built : 15:21:42, Mar 26 2020. g12a g486bc38 - gongwei.chen@droid11-sz Board ID = 1 Set cpu clk to 24M Set clk81 to 24M Use GP1_pll as DSU clk. DSU clk: 1200 Mhz CPU clk: 1200 MHz Set clk81 to 166.6M board id: 1 Load FIP HDR DDR from SD, src: 0x00010200, des: 0xfffd0000, size: 0x00004000, part: 0 fw parse done PIEI prepare done fastboot data verify result: 255 Cfg max: 12, cur: 1. Board id: 255. Force loop cfg DDR4 probe ... -
ROM 从 eMMC 加载引导加载程序（Android 日志示例）
... Board ID = 1 Set cpu clk to 24M Set clk81 to 24M Use GP1_pll as DSU clk. DSU clk: 1200 Mhz CPU clk: 1200 MHz Set clk81 to 166.6M eMMC boot @ 0 sw8 s board id: 1 Load FIP HDR DDR from eMMC, src: 0x00010200, des: 0xfffd0000, size: 0x00004000, part: 0 fw parse done PIEI prepare done 00000000 emmc switch 1 ok ddr saved addr:00016000 Load ddr parameter from eMMC, src: 0x02c00000, des: 0xfffd0000, size: 0x00001000, part: 0 00000000 ...
¶ 为从 SD 卡启动而擦除 eMMC
需要注意四种情况：eMMC 中已写入 Android 镜像、eMMC 中已写入 Linux 镜像、启动过程在 BL2 阶段挂起，以及 eMMC 为空。
-
eMMC 中存在可启动的 Android 镜像
-
使用 USB Burning Tool，在下载进度到达 7% formatting 时拔下 Type-C USB 数据线。
-
使用 Android Fastboot 工具。操作前请确认 PC 上的 adb/fastboot 工具可以正常工作。
root@dangku-desktop:/tmp# adb root adbd is already running as root root@dangku-desktop:/tmp# adb remount remount succeeded root@dangku-desktop:/tmp# adb shell bananapi_m2s:/ # reboot fastboot等待几秒，让开发板重新启动到 fastboot 模式。
root@dangku-desktop:/tmp# fastboot devices 1234567890 fastboot root@dangku-desktop:/tmp# fastboot flashing unlock_critical ... OKAY [ 0.044s] finished. total time: 0.044s root@dangku-desktop:/tmp# fastboot flashing unlock ... OKAY [ 0.047s] finished. total time: 0.047s root@dangku-desktop:/tmp# fastboot erase bootloader erasing 'bootloader'... OKAY [ 0.059s] finished. total time: 0.059s root@dangku-desktop:/tmp# fastboot erase bootloader-boot0 erasing 'bootloader-boot0'... OKAY [ 0.036s] finished. total time: 0.036s root@dangku-desktop:/tmp# fastboot erase bootloader-boot1 erasing 'bootloader-boot1'... OKAY [ 0.035s] finished. total time: 0.035s -
使用 U-Boot 命令：连接调试控制台线，开机时按 Esc 键进入 U-Boot 命令行。
bananapi_m2s_v1#amlmmc erase 1 emmckey_is_protected(): protect start = 0,end = 57343 start = 221184,end = 30535679 Erasing blocks 0 to 8192 @ boot0 start = 0,end = 8191 Erasing blocks 0 to 8192 @ boot1 start = 0,end = 8191 bananapi_m2s_v1#reset resetting ... SM1:BL:511f6b:81ca2f;FEAT:A0F83180:20282000;POC:F;RCY:0;EMMC:0;READ:0;CHK:1F;READ:0;CHK:1F;READ:0;CHK;以上两种方法实际擦除的是 eMMC 中 Android 引导加载程序所在的分区。从 SD 卡启动 Linux 后，建议 使用 dd 命令格式化整个 eMMC。
-
最简单的方法是在开机前插入已写入 Linux 镜像的 SD 卡。Android 引导加载程序会检查 SD 卡 VFAT 分区中是否存在 boot.ini，从而启动 SD 卡中的 Linux。启动后，可以 使用 dd 命令格式化整个 eMMC，再将 Linux 镜像写入 eMMC。
... BPI: try boot from sdcard reading boot.ini 2453 bytes read in 3 ms (797.9 KiB/s) ## Executing script at 03080000 Starting boot.ini... reading env.txt 3483 bytes read in 7 ms (485.4 KiB/s) HDMI: Autodetect: 1080p60hz reading Image.gz 10924573 bytes read in 611 ms (17.1 MiB/s) reading bananapi_m2s.dtb 88054 bytes read in 12 ms (7 MiB/s) reading uInitrd 11704481 bytes read in 655 ms (17 MiB/s) reading overlays/wifi_bt_rtl8822cs.dtbo 729 bytes read in 6 ms (118.2 KiB/s)
-
-
eMMC 中存在可启动的 Linux 镜像
-
使用 U-Boot 命令：连接调试控制台线，开机时按 Esc 键进入 U-Boot 命令行。
bananapi_m2s# mmc erase 0 1000 -
Linux U-Boot 也会检查 SD 卡 VFAT 分区中是否存在 boot.ini，以便从 SD 卡启动 Linux。启动后，可以使用 dd 命令格式化整个 eMMC，或直接将 Linux 镜像写入 eMMC。
-
-
一种 极端情况 是引导加载程序或 U-Boot 已损坏：ROM 从 eMMC 加载后在 U-Boot 或 BL2 阶段挂起，例如 DRAM 初始化失败时会停在 eMMC 的 BL2 阶段。此时只能使用 USB Burning Tool 格式化 eMMC，或先完整下载 Android 镜像，再尝试用其他方法擦除 eMMC 或写入 Linux 镜像。
-
如果 eMMC 为空，ROM 会直接尝试从 SD 卡加载引导加载程序。
¶ 使用 dd 命令擦除 eMMC 中的 Android
如果开发板此前写入过 Android，而现在要从 SD 卡启动 Linux，则必须使用以下命令擦除整个 eMMC。
$ sudo dd if=/dev/zero of=/dev/mmcblk0boot0 bs=1M status=noxfer
$ sudo dd if=/dev/zero of=/dev/mmcblk0boot1 bs=1M status=noxfer
$ sudo dd if=/dev/zero of=/dev/mmcblk0 bs=1M status=noxfer
$ sync¶ Wi-Fi/蓝牙支持
-
Android 已测试和支持的设备：
rtl8723bu wifi/bt(usb) rtl8188eu wifi(usb) rtl8821cu wifi/bt(usb) rtl8822cs wifi/bt(sdio/uart) rtl8814au wifi(usb), please get the aircrack-ng driver and install.如何启用 Android Wi-Fi/蓝牙
USB 类型：将 USB 网卡插入 USB Host 接口并重新启动系统。启动后，可以在 Settings 应用中启用或禁用 Wi-Fi 和蓝牙。
SDIO/UART 类型：将硬件模块正确连接到 40 针排针，并 配置 Android DTB Overlay以启用模块。注意：Android 不支持以太网与 Wi-Fi 同时联网。以太网优先级高于 Wi-Fi：以太网已连接时 Wi-Fi 无法联网，插入网线后 Wi-Fi 连接也会断开。 -
Linux 已测试和支持的设备：
rtl8188eu wifi(usb) rtl8192eu wifi(usb) rtl8723bu wifi/bt(usb) rtl8811au wifi(usb) rtl8812au wifi(usb) rtl8812bu wifi(usb) rtl8821cu wifi/bt(usb) rtl8822cs wifi/bt(sdio/uart)如何启用 Linux Wi-Fi
Wi-Fi 模块驱动程序已预编译到发布镜像中。
USB 类型：将 USB 网卡插入 USB Host 接口，驱动程序会自动加载。 SDIO/UART 类型：
-
将硬件模块正确连接到 40 针排针。
-
配置 DTB Overlay。
overlays="wifi_bt_rtl8822cs" -
将 Wi-Fi 模块名称添加到 /etc/modules，以便下次启动时自动加载。
# This file contains the names of kernel modules that should be loaded # at boot time, one per line. Lines beginning with "#" are ignored. 88x2cs
如何启用 Linux 蓝牙
-
下载 rtk-linux-bt-driver 源代码，构建 USB 或 UART 版 Realtek Linux 蓝牙驱动与固件，并安装到镜像中。
-
USB 类型：将 USB 蓝牙适配器插入 USB Host 接口，驱动程序会自动加载。
-
UART 类型：安装蓝牙驱动和固件前，按照与 Wi-Fi 相同的方式配置 DTB Overlay。rtk-hciuart.service 启动时会加载 hci_uart 驱动。
-
¶ Cloud-init 和 Snap
Cloud-init 和 Snap 服务默认启用，您可以禁用或删除它们。
-
禁用或删除 cloud-init
$ sudo touch /etc/cloud/cloud-init.disabled或
$ sudo apt purge cloud-init -
禁用或删除 Snap
$ sudo apt purge snapd
¶ 启用 rc-local
发布镜像中已包含 systemd 服务 rc-local.service，但其单元文件中没有 [Install] 部分，因此 systemd 无法启用该服务。首先需要更新此文件。
$ sudo nano /lib/systemd/system/rc-local.service [Unit]
Description=/etc/rc.local Compatibility
Documentation=man:systemd-rc-local-generator(8)
ConditionFileIsExecutable=/etc/rc.local
After=network.target
[Service]
Type=forking
ExecStart=/etc/rc.local start
TimeoutSec=0
RemainAfterExit=yes
GuessMainPID=no
[Install]
WantedBy=multi-user.target
Alias=rc-local.service创建 /etc/rc.local 文件。
sudo nano /etc/rc.local
#!/bin/sh
#
# rc.local
#
# This script is executed at the end of each multiuser runlevel.
# Make sure that the script will "exit 0" on success or any other
# value on error.
#
# In order to enable or disable this script just change the execution
# bits.
#
# By default this script does nothing.
exit 0为 /etc/rc.local 添加可执行权限：
$ sudo chmod +x /etc/rc.local启用 rc-local.service 并重新启动：
$ sudo systemctl enable rc-local.service
$ sudo reboot¶ 在 Debian 中启用 sudo
Debian 发布镜像默认不安装 sudo，可以使用“su -”命令切换到 root。如果需要 sudo，可以按以下方式安装。
$ su root
Password:(enter bananapi)
# apt-get update
# apt-get install sudo
# adduser pi sudo然后注销并重新登录。
¶ 安装 Docker Engine
在 Ubuntu 20.04 Server 上安装 Docker Engine
-
设置存储库 更新 apt 软件包索引并安装软件包以允许 apt 通过 HTTPS 使用存储库：
$ sudo apt-get update $ sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release添加 Docker 官方 GPG 密钥：
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg设置稳定存储库
$ echo \ "deb [arch=arm64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null -
安装 Docker Engine
$ sudo apt-get update $ sudo apt-get install docker-ce docker-ce-cli containerd.io -
运行 hello-world 镜像，验证 Docker Engine 是否正确安装。
$ sudo docker run hello-world
也可以使用以下简单命令安装 Docker：
$ curl -sSL get.docker.com | sudo sh其他 Linux 发行版请参阅 Docker Engine 安装文档。