RKToolMac

一些Rockchip Mac版本使用但官方未提供的工具集 (Some tools used for Rockchip Mac versions but not supply by official).

快速开始 (Quick Start)

# 自动检测设备模式 (烧录模式 / ADB模式) 并写入 SN + MAC
./rktool.sh --sn 02000001 --wifi AA:BB:CC:DD:EE:01 --verify --reboot

# 读取当前 SN / MAC
./rktool.sh --read

# 烧录模式: 写入 SN + MAC + 刷固件
./rktool.sh --sn 02000001 --wifi ... --flash update.img

# 仅预览 (不执行)
./rktool.sh --sn 02000001 --dry-run

rktool.sh 会自动检测设备处于哪种模式:

• 烧录模式 (Maskrom/Loader): 通过 USB 连接，设备未启动 Android → 使用 upgrade_tool wl 直接写 eMMC vendor_storage
• ADB 模式 (Android 已启动): 通过 ADB 连接 → 推送 rk_write_tool 到设备执行

包含的工具 (Included Tools)

rktool.sh — 统一入口脚本

自动检测设备模式，统一写入 SN / WiFi MAC / LAN MAC / BT MAC:

检测模式	设备状态	写入方式	需要 Root
烧录模式 (Maskrom)	USB 连接，未开机	upgrade_tool db + wl 7168	否
烧录模式 (Loader)	USB 连接，未开机	upgrade_tool wl 7168	否
ADB 模式	Android 已启动，USB 调试	rk_write_tool via /dev/vendor_storage	是

用法: rktool.sh [options]

写入:
  --sn <serial>          序列号
  --wifi <MAC>           WiFi MAC (XX:XX:XX:XX:XX:XX)
  --lan <MAC>            LAN (以太网) MAC
  --bt <MAC>             蓝牙 MAC

操作:
  --read                 读取并显示当前 SN/MAC
  --verify               写入后读回验证
  --reboot               写入后重启设备
  --flash <update.img>   写入后刷固件 (仅烧录模式)

其他:
  --noreset              刷固件后不重置
  --dry-run              仅预览，不执行
  -h, --help             帮助

WriteToolMac

在 Rockchip 安卓设备上直接写入序列号 (SN) 和 MAC 地址的命令行工具 (设备端运行)。

• 无需 Windows，通过 ADB 推送到设备端运行。
• 支持写入 SN, LAN MAC, WIFI MAC, BT MAC。
• 查看详细文档

BurnToolMac

在烧录模式 (Maskrom/Loader) 下直接写入 SN 和 MAC 地址到 eMMC vendor_storage，无需设备启动 Android。

• 使用 Rockchip upgrade_tool (Mac 版) 通过 USB 协议操作 eMMC。
• gen_vendor_storage.py 生成 vendor_storage 二进制镜像，支持合并已有数据。
• burn_sn.sh / burn_mac.sh 可独立使用的烧录模式专用脚本。
• 查看详细文档

vendor_storage 技术细节

项目	值
eMMC 位置	LBA 7168 (0x1C00)
结构	4 副本 x 128 扇区 (64KB) = 256KB
Tag	0x524B5644 ("RKVD")
SN ID	1 (ASCII)
WiFi MAC ID	2 (6 bytes binary)
LAN MAC ID	3 (6 bytes binary)
BT MAC ID	4 (6 bytes binary)

vendor_storage 位于 IDB 和第一个分区之间，upgrade_tool uf 刷固件不会覆盖此区域。

目录结构

RKToolMac/
├── rktool.sh                 # 统一入口: 自动检测模式，写入 SN/MAC
├── WriteToolMac/             # ADB 模式工具 (设备端运行)
│   ├── bin/rk_write_tool     # ARM aarch64 静态二进制
│   └── src/rk_write_tool.c   # 源码
├── BurnToolMac/              # 烧录模式工具 (Mac 端运行)
│   ├── bin/
│   │   ├── upgrade_tool      # Rockchip 升级工具 (Mac v2.3)
│   │   └── MiniLoaderAll.bin # RK3568 Loader
│   └── lib/
│       ├── gen_vendor_storage.py  # vendor_storage 镜像生成/解析
│       ├── burn_sn.sh             # 独立 SN 写入脚本
│       └── burn_mac.sh            # 独立 MAC 写入脚本
├── LICENSE
└── README.md

关于作者

Eron来自 开博尔 (Kaiboer inc.)。 我们致力于提供高品质的影音视听设备，在开发过程中发现 Mac 下缺乏好用的 Rockchip 开发工具，故编写此工具并开源，希望对社区有所帮助。

License

This project is licensed under the MIT License - see the LICENSE file for details.