在Banana Pi M2+上运行Flutter-pi的注意事项

Flutter-pi是一个专为嵌入式Linux设备设计的Flutter运行时环境，能够帮助开发者在资源受限的设备上运行Flutter应用。本文将详细介绍在Banana Pi M2+单板计算机上运行Flutter-pi时可能遇到的问题及其解决方案。

硬件与软件环境要求

Banana Pi M2+是一款基于Allwinner A31s四核Cortex-A7处理器的单板计算机，配备Mali400 MP2 GPU。要成功运行Flutter-pi，需要满足以下条件：

1. 操作系统：推荐使用Armbian 22.11.1 Jammy或更新版本
2. 内核版本：建议使用6.1.63或更高版本的内核
3. 图形驱动：需要正确安装Mali GPU驱动和Mesa图形库
4. 依赖库：libdrm、gbm、libinput、xkbcommon等必要库

常见问题及解决方案

1. 显示输出问题

在较旧的内核版本(如5.15.80)下，可能会出现显示控制器驱动报告空格式列表的问题。这会导致Flutter-pi无法找到合适的DRM平面来推送帧缓冲区。错误信息通常表现为：

modesetting.c: Could not find a suitable unused DRM plane for pushing the framebuffer.
window.c: Couldn't present flutter layer on screen. surface_present_kms: Input/output error

解决方案： 升级内核到6.1.63或更高版本可以解决此问题。新内核中的显示控制器驱动能正确报告支持的格式列表。

2. DRM平面分配问题

Flutter-pi需要分配DRM平面来渲染内容。在调试模式下，可以看到详细的平面分配过程：

modesetting.c: checking if plane with id 31 qualifies...
modesetting.c: does not qualify: plane type is overlay but allow_overlay is false
modesetting.c: checking if plane with id 37 qualifies...
modesetting.c: does qualify.

调试建议： 可以通过在CMake配置中添加-DDEBUG_DRM_PLANE_ALLOCATIONS=ON选项来启用DRM平面分配的详细调试信息，帮助诊断问题。

3. GBM表面创建问题

有时会遇到GBM表面创建失败的情况：

egl_gbm_render_surface.c: Couldn't create GBM surface for rendering. 
gbm_surface_create_with_modifiers: Invalid argument
egl_gbm_render_surface.c: Will retry without modifiers

解决方案： Flutter-pi会自动尝试不使用修改器(modifiers)重新创建GBM表面。如果问题持续，可以检查Mesa图形驱动是否正确安装。

性能优化建议

1. 设备像素比设置：如果显示器没有提供有效的物理尺寸信息，Flutter-pi会默认使用1.0的设备像素比。可以通过-d参数手动指定显示器的物理尺寸以获得更准确的DPI计算。

2. 渲染配置：在Mali400 GPU上，建议使用OpenGL ES 2.0配置，这是该GPU原生支持的API版本。

3. 内存管理：Banana Pi M2+内存有限，建议优化Flutter应用的资源使用，特别是图像和动画资源。

构建与部署

构建Flutter-pi时，建议使用以下CMake配置：

cmake -DCMAKE_BUILD_TYPE=Debug -DDEBUG_DRM_PLANE_ALLOCATIONS=ON ..

对于Flutter应用本身，可以使用以下构建命令：

flutter pub global run flutterpi_tool build --release --arch=arm

结论

在Banana Pi M2+上运行Flutter应用是完全可行的，但需要注意内核版本和图形驱动的兼容性。通过合理配置和必要的系统升级，可以确保Flutter-pi在该平台上稳定运行。对于开发者来说，理解底层图形系统的工作原理有助于快速诊断和解决可能出现的问题。