TinkerLab
ARTIFACT // SETUP-HAILO10H-AND-RK3588-EDGE-LLM.SH (SH)

Jetson AGX Thor (T5000)、树莓派 5 AI HAT+ 2 (`Hailo-10H` 8GB) 与 RK3588 边缘大模型部署脚本 (setup-hailo10h-and-rk3588-edge-llm.sh)

自动识别边缘算力平台(Jetson AGX Thor T5000、树莓派 5 Hailo-10H 独立 8GB NPU 或瑞芯微 RK3588),核验 PCIe 3.0 链路与 NPU 定频策略,并拉起本地推理服务。

[核心实测结论 / TL;DR]本配置包「Jetson AGX Thor (T5000)、树莓派 5 AI HAT+ 2 (`Hailo-10H` 8GB) 与 RK3588 边缘大模型部署脚本」(文件名:setup-hailo10h-and-rk3588-edge-llm.sh,格式:SH)是 Tinker AI 实测工坊配套指南《jetson-agx-thor-t5000-128gb-vs-pi5-ai-hat-plus-2-hailo10h-8gb-and-rk3588-edge-llm-benchmark》的参数化生产模板。支持在本地浏览器实时定制 目标边缘硬件平台 (`hailo10h` / `rk3588` / `thor`) (EDGE_PLATFORM=hailo10h)、目标边缘模型标识 (EDGE_MODEL_TAG=qwen2.5-instruct:1.5b)、边缘大模型服务监听端口 (API_PORT=11434) 等 3 项核心变量,默认遵循 127.0.0.1 回环绑定与最小权限规范。
03 // MAKERAI 创客 / STEM· 验证日期:2026-11-04
查看全部 42 套配置附件 →
setup-hailo10h-and-rk3588-edge-llm.sh

Jetson AGX Thor (T5000)、树莓派 5 AI HAT+ 2 (`Hailo-10H` 8GB) 与 RK3588 边缘大模型部署脚本

自动识别边缘算力平台(Jetson AGX Thor T5000、树莓派 5 Hailo-10H 独立 8GB NPU 或瑞芯微 RK3588),核验 PCIe 3.0 链路与 NPU 定频策略,并拉起本地推理服务。

查看配套实测指南 →
参数化定制变量 (Variables — 自动保存在本地浏览器)
UTF-8 编码 · 零延迟实时编译
#!/usr/bin/env bash
# Tinker AI — Next-Gen Edge LLM Bootstrap: Hailo-10H (8GB) / RK3588 NPU / Jetson Thor (Guide #35)
set -euo pipefail

PLATFORM="hailo10h"
MODEL_TAG="qwen2.5-instruct:1.5b"
PORT="11434"

echo "=== [1/3] Auditing Edge Accelerator Platform: $PLATFORM ==="
if [ "$PLATFORM" = "hailo10h" ]; then
  lspci | grep -i "Hailo" || echo "[WARN] Hailo-10H not detected on PCIe bus!"
  hailortcli fw-control identify || true
  echo "=== [2/3] Starting hailo-ollama on Dedicated 8GB NPU RAM (Port $PORT) ==="
  HAILO_OLLAMA_HOST="0.0.0.0:$PORT" hailo-ollama serve &
  sleep 2
  curl -sS "http://127.0.0.1:$PORT/api/tags" || true
elif [ "$PLATFORM" = "rk3588" ]; then
  echo "=== [2/3] Locking RK3588 6 TOPS NPU & DMC Memory Frequency to Performance ==="
  ulimit -l unlimited || true
  cat /sys/kernel/debug/rknpu/version 2>/dev/null || true
  grep -i "Cma" /proc/meminfo || true
  echo "Ready to launch rkllm_server with W4A16 .rkllm model on port $PORT."
else
  echo "=== [2/3] Jetson AGX Thor (T5000 128GB): Locking nvpmodel & jetson_clocks ==="
  sudo nvpmodel -q || true
  sudo jetson_clocks --show || true
  echo "=== [3/3] Launching TensorRT Edge-LLM / vLLM NVFP4 for $MODEL_TAG ==="
fi
PARAMETER SPECIFICATION // 参数化变量规范说明表

「setup-hailo10h-and-rk3588-edge-llm.sh」可定制环境变量与默认值说明

本配置模板(SH 格式)支持 3 项运行时参数注入,所有替换均在本地浏览器内完成。

模板占位符参数用途说明安全默认值填写示例
{{EDGE_PLATFORM}}目标边缘硬件平台 (`hailo10h` / `rk3588` / `thor`)hailo10hhailo10h
{{EDGE_MODEL_TAG}}目标边缘模型标识qwen2.5-instruct:1.5bqwen2.5-instruct:1.5b
{{API_PORT}}边缘大模型服务监听端口1143411434
PAIRED HARDWARE MANIFEST // 配套实测环境与边界记录

配套指南《新一代边缘 AI 与具身智能硬件实测:NVIDIA Jetson AGX Thor (128GB · 2070 TFLOPS) 对决树莓派 5 AI HAT+ 2 (Hailo-10H 独立 8GB) 与 RK3588 NPU》验证基线

实测硬件与操作系统 (Hardware & OS)

NVIDIA Jetson AGX Thor 开发套件 (T5000 · 128GB · 273 GB/s · 2070 FP4 TFLOPS) | 树莓派 5 (8GB) + AI HAT+ 2 (Hailo-10H 40 TOPS · 板载 8GB 独立内存) | RK3588 开发板 (16GB · 6 TOPS NPU)

锁定软件栈与模型版本 (Pinned Versions)
vLLM 0.8.2 / TensorRT Edge-LLM (JetPack 7.0 NVFP4)hailo-ollama 0.2.1 + HailoRT 5.1.0 (`hailo-h10-all`)RKNN-LLM (`rkllm-runtime`) 1.2.1 (`W4A16` `.rkllm`)
离线与安全边界 (100% 边缘终端/机器人机载纯离线运行)

全部 HEF、RKLLM 与 NVFP4 权重均在无外网环境下由电池或机载直流电源直接驱动运行。

已知限制与失败边界 (Known Limits)
  • 树莓派 AI HAT+ 2 (`Hailo-10H`) 板载的 **8GB LPDDR4X 为 NPU 独占显存**,因此最高支持 `1.5B–3B INT4` 量级模型(如 `Qwen2.5-1.5B`、`Llama-3.2-3B`),且必须使用通过 Hailo Dataflow Compiler 编译的 `.hef` 权重(由 `hailo-ollama` 直接拉取管理)。
  • 瑞芯微 RK3588 的 6 TOPS NPU 与 CPU 共享系统内存(带宽约 34 GB/s),运行 `1.5B W4A16` 极限约为 16 tok/s,运行 `3B W4A16` 约为 11–12 tok/s。
DEPLOYMENT CHECKLIST // 配置落地核验步骤

部署 setup-hailo10h-and-rk3588-edge-llm.sh 后的 3 步验收清单

  1. 在树莓派 5 + AI HAT+ 2 (`Hailo-10H`) 上已安装专用 `hailo-h10-all` 驱动栈并开启 `dtparam=pciex1_gen=3`。
  2. 在 RK3588 开发板上已设置 `ulimit -l unlimited` 并将 NPU 与 DMC 内存控制器锁定为 `performance` 定频模式。
  3. 已在 Jetson AGX Thor (128GB) 上按供电预算切换 `nvpmodel`(60W 移动模式或 130W MAXN)并清理页缓存。