为 reComputer R1000 构建 balenaOS
本文档由 AI 翻译。如您发现内容有误或有改进建议,欢迎通过页面下方的评论区,或在以下 Issue 页面中告诉我们:https://github.com/Seeed-Studio/wiki-documents/issues
什么是 balena?
balena 是一个物联网 (IoT) 平台,旨在帮助开发人员构建、部署和管理跨设备群的 IoT 应用程序。它支持多种设备架构,并包含容器化应用程序部署功能,使您能够轻松更新 IoT 软件和 HostOS,修复错误并在 IoT 应用程序中引入新功能。balena 提供了一种统一的方式来推送代码更新、管理设备配置,并确保设备在现场可靠、安全地运行,无论其位置或网络条件如何。
本教程将向您展示如何为 R1000 编译、配置和烧录 balenaOS。

开始准备
在开始这个项目之前,您可能需要提前准备好硬件和软件,如下所述。
硬件准备
reComputer R1000 |
---|
![]() |
软件
- yocto 环境
- docker 环境
- balenaEtcher 用于烧录 CM4 内存。
硬件配置
步骤 1:您需要将 R1000 侧面的开关设置为启动模式,然后为设备通电。
开关位置 | 模式 | 描述 | nRPI-BOOT |
---|---|---|---|
![]() | 普通模式 | 从 eMMC 启动 | 低电平 |
![]() | 烧录模式 | 从 USB 启动 | 高电平 |
步骤 2:请使用 USB Type-C 数据线将 reComputer R1000 连接到您的电脑。

编译 R1000-balenaOS
步骤 1:下载以下库,并确保当前环境支持编译 yocto 项目。
sudo apt install gawk wget git diffstat unzip texinfo gcc build-essential chrpath socat cpio python3 python3-pip python3-pexpect xz-utils debianutils iputils-ping python3-git python3-jinja2 python3-subunit zstd liblz4-tool file locales libacl1 jq nodejs npm
sudo locale-gen en_US.UTF-8
步骤 2:输入以下指令下载并配置 balena-seeed-cm4
,最后编译 yocto 项目。
git clone https://github.com/Seeed-Studio/balena-seeed-cm4.git
cd balena-seeed-cm4
git submodule update --init --recursive
./balena-yocto-scripts/build/barys --dry-run
source layers/poky/oe-init-build-env
MACHINE=seeed-recomputer-r100x bitbake balena-image

步骤 3:编译后的镜像名为 balena-image-seeed-recomputer-r100x.balenaos-img
,位于 build/tmp/deploy/images/seeed-recomputer-r100x
目录中。至此,镜像编译完成,下一步是进行配置。
此仓库的默认 balenaOS 版本为 5.3.27+rev1。版本信息位于 VERSION
文件中。如果需要编译其他版本的 balenaOS,请更改 VERSION
文件中的内容。
配置 R1000-balenaOS
步骤 1:进入编译镜像所在目录,然后进入命令行界面,输入 balena login
,登录到 balena Cloud
。

步骤 2:创建一个新的 Fleet
,选择类型为 Raspberry Pi 4 (using 64bit os)
。

步骤 3:输入以下命令预加载镜像。
balena preload ./balena-image-seeed-recomputer-r100x.balenaos-img --fleet [fleet name]

步骤 4:将新设备注册到 Fleet,并生成设备 ID。
balena device register [fleet name]

步骤 5:生成配置文件。
balena config generate --device [uuid] --version 3.0.15+atsss --dev -o config.json

步骤 6:加载配置文件。
balena os configure balena-image-seeed-recomputer-r100x.balenaos-img --config config.json --device [uuid] --version 3.0.15+atsss --dev

步骤 7:复制最终的镜像文件,此镜像可以烧录到 reComputer R1000。
cp balena-image-seeed-recomputer-r100x.balenaos-img recomputer_balenaos-dev.img

烧录 balena OS 的步骤
步骤 1:打开 rpiboot 软件,系统将显示新磁盘。
步骤 2:打开烧录工具 balenaEtcher,选择 balena 镜像文件,然后选择目标磁盘,最后点击烧录。

步骤 3:烧录完成后,重启 R1000。一段时间后,您将在 balena Cloud 上看到新设备成功上线。

技术支持与产品讨论
感谢您选择我们的产品!我们将为您提供多种支持,以确保您使用我们的产品时体验顺畅。我们提供了多种沟通渠道,以满足不同的偏好和需求。