zephyrrtos.cnZEPHYR RTOS 本土生态工作组
ARM64 · Armbian · 远端开发 · DSH

远端开发沙盒(ROCK 5B+)

一台基于 Radxa ROCK 5B+ 的国产化 ARM64 开发机(出厂形态为「通用型人工智能个人代码数据中心」), 被我们当作 远端 Armbian 开发沙盒使用:编译、调试、文件同步都在板子上跑, 而你只需要在 DSH 里下命令——完全通过 dsh-ubuntu-sandbox 与 DSH 完成开发

为什么要做成「远端沙盒」

板子放在机柜里、没有键鼠显示器,照样能当开发机用——关键是会话与文件都在远端,且断线不丢。

不占桌面,随时接入

板子联网即用:不用插显示器、不用抢 USB 口,从 DSH 里直接操作远端 shell 与文件。

会话持久(默认开启)

dsh-ubuntu-sandbox 默认用 tmux 持久会话:cd / export / 后台任务跨调用保持,SSH 断线重连也不丢。

远程读写一体

列目录、读文件、写文件都走同一套工具;写文件自动建父目录,和本地工具同样的退出码与超时标记。

和 Zephyr 工具链天然配合

机器上 westcmakeninjagitpython3 已就绪,远端直接 west build,产物留在板子上。

快速接入(3 步)

前提:DSH 已安装 dsh-ubuntu-sandbox 插件(安装与更新教程), 并把板子加进 SSH 主机库(~/.dsh/dsh-ssh.json,可在 SSH 面板里管理)。

  1. 选中沙盒主机 sb_cwd alias:<你的别名>(例如 deepseek / armbian)——之后所有 sb_* 工具都默认作用在这台板子上。
  2. 确认会话模式 sb_session action:status:应显示 mode: on (default)session: runningcd 到工程目录后,后续调用都留在那里。
  3. 开始干活 sb_exec 跑命令、sb_ls / sb_read / sb_write 操作远端文件;本地 Windows 文件继续用本地工具(pwsh / read / write / edit)。
# 典型会话(DSH 对话框里直接说,或让 agent 执行)
sb_cwd    "alias: deepseek"                      # 1) 选定远端沙盒主机
sb_session "action: status"                      # 2) 确认 tmux 持久会话已开
sb_exec   "uname -a; nproc; free -h"             # 3) 看板子状态
sb_exec   "cd ~/zephyrproject/zephyr && west build -b rock5b samples/hello_world" workdir:"~"
sb_ls     "~/zephyrproject/zephyr/build/zephyr"  # 产物就留在板子上
sb_write  "~/notes/board.md" "# ROCK 5B+ 记录"
沙盒与本地工具的分工:远端命令、远端文件用 sb_*;本机(Windows)文件与命令用 pwsh / read / write / edit。 需要传大文件或二进制时用 dsh-ssh 的 ssh_upload / ssh_download

平台规格(Radxa 官方产品简介)

摘自 Radxa ROCK 5B+ Product Brief(Rev 1.0,2024-06-25)。 下载原始 PDF ↓

SoCRockchip RK3588:4×Cortex‑A76 @2.2/2.4GHz + 4×Cortex‑A55 @1.8GHz(Arm DynamIQ)
GPUArm Mali‑G610MC4(OpenGL ES 1.1/2.0/3.2、OpenCL 1.1/1.2/2.2、Vulkan 1.1/1.2)
NPU算力最高 6 TOPS,支持 INT4 / INT8 / INT16 / FP16 / BF16 / TF32
内存 / 存储LPDDR5 5500MT/s,4/8/16/24/32GB;板载 eMMC 16–256GB
扩展2× M.2 M‑Key(PCIe 3.0 ×2),1× M.2 B‑Key(4G 模块),1× SIM 卡槽
网络2.5GbE(支持 PoE,需 PoE HAT)· Wi‑Fi 6 (802.11ax) · BT 5.2 / BLE
显示 / 视频2× HDMI(8Kp60 + 4Kp60)、1× HDMI 输入(4Kp60)、前置 USB‑C DP(4Kp60)、MIPI DSI;解码最高 8K@60fps
USB2× USB3 Type‑A、2× USB2 Type‑A、1× USB‑C(供电)、1× USB‑C OTG/HOST
40‑pinUART×2、SPI×2、I²C×2、PCM/I²S、SPDIF、PWM、ADC、GPIO×6、5V/3.3V 供电
电源 / 环境USB‑C PD 2.0(9/12/15/20V);建议 ≥24W(带 M.2 SSD 建议 40W);工作温度 0–50°C,SoC 80°C 起降频
软件支持Debian / Ubuntu Linux、Android 12、OpenFyde(Chromium OS fork)、RKNPU2 软件栈

这台机器的实测配置

下面是我们在沙盒里实际读到的参数(不是宣传页数据):

设备型号Radxa ROCK 5B+(/proc/device-tree/model
操作系统Armbian 24.11.2 bookworm(board family rockchip-rk3588,Xfce 形态可自选)
内核Linux 6.1.75‑vendor‑rk35xx(aarch64)
CPU / 内存8 核 · 15 GiB RAM(zram 交换已启用)
存储eMMC 116.5 GB(系统盘 /)+ 2× 119.2 GB NVMeRAID1md127,状态 [2/2] [UU],挂载 /mnt/raid1
网络无线 192.168.2.240(当前沙盒入口;有线 2.5GbE 可同时使用)
已装工具链tmux · docker · git 2.39 · cmake 3.31 · ninja 1.11 · west 1.4 · python3 3.11 · /opt/SEGGER(J‑Link 工具)
共享目录/mnt/raid1/{shared,data,rknn_data}

出厂预置服务的当前状态(按需启动):

正在运行active SSH(22)· Samba(139/445)· RAID1(md127)
已安装未启动inactive Gitea(:3000,手册见下)· Docker
手册提及、按需启用OpenMediaVault(NAS)· Kodi(家庭娱乐)· DeepSeek‑R1‑distill 本地大模型服务 · 基于 RKNN 的图片分类服务 · Trae_cn AI‑SSH‑agent‑console
手册(2025‑04 版)描述出厂系统为 Rock 5B Plus / 内核 5.10.105 / Xfce;本机当前为 Armbian 24.11.2 / 内核 6.1.75‑vendor‑rk35xx, 说明系统经历过升级或重装。以本表实测值为准,手册作为功能与操作说明参考。

安装说明(出厂手册摘要)

完整图文步骤见随机手册:下载 Getting Start PDF ↓。以下是接入所需的四件事:

  1. 先把 IP 固定下来 登录家用路由器 → 局域网设置 → 静态 IP 绑定;机器正面贴条上有有线网卡与 Wi‑Fi 的 MAC 地址,分别为两者绑定固定的 IP(不要与已占用地址冲突)。用随机附带的网线把板子接到路由器 LAN 口。
  2. Samba 访问共享目录(可选但方便) Windows:此电脑 → 映射网络驱动器 → \\<ip>\shared,用户名 armbian,密码 armbian;macOS:Finder → 前往 → 连接服务器 → smb://<ip>
  3. SSH 登录 共享目录 tools\ 内有 putty-64bit-0.83-installer.msi,安装后用 SSH 登录 armbian@<ip>;也可以直接把板子加进 DSH 的 SSH 主机库,用沙盒工具操作。
  4. 配置无线网 SSH 终端里执行 armbian-config(密码 armbian)→ Network → Fixed and wireless network settings 连接 Wi‑Fi;天线信号弱时可多连几次。

按手册还可以继续启用:Gitea 本地代码托管(改 /mnt/raid1/gitea_config/app.ini 里的 IP, sudo systemctl start gitea,浏览器打开 <ip>:3000首个注册用户自动成为管理员)、 SSH 端口转发对外提供内网服务、RAID1 ext4 文件系统、DeepSeek‑R1‑distill 大模型服务、RKNN 图片分类、Samba 文件服务器、 OpenMediaVault NAS、Kodi 家庭娱乐终端等。

下载安装手册(PDF) 下载平台产品简介(PDF)
问智能体 Zephyr 问题问答 · 直接问智能体