DEV-TOOLS-SUITE

SylixOS 开发辅助工具集，包含板卡调试、自动化测试、文件上传、寄存器读取等常用小工具。

目录概览

路径	说明
autotest_runner/	基于 Telnet 的自动化测试工具，支持按测试项名称选择执行
ftp_sylixos_upload/	将文件上传到 SylixOS 板卡
readreg/	在 Linux 或 SylixOS 下读取寄存器值，用于调试和对比
eth_dual_selftest/	SylixOS 单板双网口原始二层自测用例，区分物理链路验证与吞吐基准

autotest_runner

基于 Telnet 的自动化测试工具，用于循环执行一个或多个测试项，并根据输出自动判定结果。

详细使用说明见 autotest_runner/README.md。

ftp_sylixos_upload

FTP 上传工具，用于手动上传文件到 SylixOS 板卡。

⚠️ 主要在 Linux 环境下使用

功能说明

• 支持解析 SylixOS IDE 导出的 .reproject 自动上传
• 支持上传单个文件到指定远端路径
• 支持使用 upload_list.txt 批量上传多个文件或目录
• 支持直接递归上传整个 rootfs 目录，无需解析 .reproject
• 默认在每个文件上传完成后执行远端 chmod 755
• 默认在全部上传完成后执行一次远端 SITE SYNC

使用方法

# 自动解析项目 .reproject 并上传（推荐）
./ftp_sylixos_upload/ftp_sylixos_upload.py -P /path/to/project

# 使用当前目录的 .reproject
./ftp_sylixos_upload/ftp_sylixos_upload.py -P .

# 指定板卡 IP（覆盖 .reproject 中的配置）
./ftp_sylixos_upload/ftp_sylixos_upload.py -P . -i 10.13.21.100

# 上传单个文件
./ftp_sylixos_upload/ftp_sylixos_upload.py -i 10.13.21.42 -f lyn_drv.ko -t /lib/modules/drivers/lyn_drv.ko

# 上传到指定目录（保持文件名）
./ftp_sylixos_upload/ftp_sylixos_upload.py -i 10.13.21.42 -f liblyn_drv.so -d /lib/

# 使用自定义凭证
./ftp_sylixos_upload/ftp_sylixos_upload.py -i 10.13.21.42 -u admin -p admin123 -f test.ko -t /lib/modules/test.ko

# 批量上传（使用配置文件）
./ftp_sylixos_upload/ftp_sylixos_upload.py -i 10.13.21.42 -c upload_list.txt

# 直接递归上传 rootfs 到板卡根目录
./ftp_sylixos_upload/ftp_sylixos_upload.py -i 10.13.21.42 --rootfs /path/to/rootfs --rootfs-target /

# 如需关闭默认 chmod 或 sync，可显式禁用
./ftp_sylixos_upload/ftp_sylixos_upload.py -i 10.13.21.42 -f test.ko -t /tmp/test.ko --no-chmod --no-sync

参数说明

参数	说明
-P, --project	项目目录路径（自动解析 .reproject）
-i, --ip	板卡 IP 地址
-u, --user	FTP 用户名（默认: root）
-p, --password	FTP 密码（默认: root）
-f, --file	本地文件路径
-t, --target	目标文件路径（完整路径）
-d, --dir	目标目录（保持原文件名）
-c, --config	配置文件（每行格式: 本地路径|目标路径；支持文件或目录）
-r, --rootfs	本地 rootfs 目录路径（递归上传，无需解析 .reproject）
--rootfs-target	rootfs 上传目标根目录（默认: /）
-m, --chmod	上传成功后执行远端 chmod，默认 755
--no-chmod	禁用上传成功后的远端 chmod
--sync	全部上传完成后执行一次远端 sync，默认开启
--no-sync	禁用全部上传完成后的远端 sync

upload_list.txt 示例

配置文件每行格式如下：

本地路径|目标路径

• 左侧是文件时，右侧表示远端完整文件路径
• 左侧是目录时，右侧表示远端目录根，工具会递归上传整个目录树

当前仓库已提供样例文件：

• ftp_sylixos_upload/upload_list.txt

示例内容：

/workspace/sdk/sdk3.2.37/@sylixos-bsp-sdk/rk3568_sdk_experience_64bit@3.2.37-25113000-ECS/images/tl3568_evm_x64/rootfs|/

默认行为

• FTP 连接后使用被动模式
• 每个文件上传完成后默认执行远端 SITE CHMOD 755 <path>
• 全部上传完成后默认执行一次远端 SITE SYNC
• 若板卡不支持这些扩展命令，可使用 --no-chmod 或 --no-sync 关闭

注意事项

• 直接上传完整 rootfs 时，脚本会将所有普通文件统一设置为 755
• 递归上传会跳过符号链接和其他特殊文件，只上传普通目录和普通文件
• 对正在运行中的根文件系统直接覆盖有风险，建议先确认板卡当前场景允许这样操作

---

readreg

用于在 Linux 或 SylixOS 命令行下直接读取寄存器值，便于对比两边同一寄存器地址的实际内容。

文件说明

文件	说明
readreg/readreg_linux.c	Linux 版本，通过 /dev/mem + mmap 读取物理地址
readreg/readreg_sylixos.c	SylixOS 版本，通过直接解引用寄存器地址读取

编译方式

Linux：

gcc -O2 -Wall -Wextra -o readreg_linux readreg/readreg_linux.c

SylixOS：

${CROSS_COMPILE}gcc -O2 -Wall -Wextra -o readreg_sylixos readreg/readreg_sylixos.c

也可以将 readreg/readreg_sylixos.c 复制到 SylixOS IDE 工程中编译。

Linux 使用方法

# 读取单个 32 位寄存器（默认 32 位）
./readreg_linux 0xfdc60068

# 按 16 位读取
./readreg_linux 0xfdc60068 16

# 连续读取 4 个 32 位寄存器
./readreg_linux 0xfdc60068 32 4

SylixOS 使用方法

# 读取单个 32 位寄存器（默认 32 位）
./readreg_sylixos 0xfdc60068

# 按 16 位读取
./readreg_sylixos 0xfdc60068 16

# 连续读取 4 个 32 位寄存器
./readreg_sylixos 0xfdc60068 32 4

参数说明

readreg_linux：

参数	说明
phys_addr	要读取的物理寄存器地址，支持十进制或 0x 前缀十六进制
width	访问位宽，可选 8、16、32、64，默认 32
count	连续读取的寄存器个数，默认 1。每次按 width / 8 递增地址

readreg_sylixos：

参数	说明
addr	寄存器地址，支持十进制或 0x 前缀十六进制
width	访问位宽，可选 8、16、32、64，默认 32
count	连续读取的寄存器个数，默认 1。每次按 width / 8 递增地址

注意事项

• readreg_linux 依赖 /dev/mem，某些 Linux 内核启用了严格的 /dev/mem 访问限制，程序即使编译成功也可能无法读取目标地址。
• readreg_linux 适用于 Linux 下的 MMIO 物理地址读取，不适用于 I2C、SPI 等非直接物理映射寄存器。
• readreg_sylixos 的前提是当前 SylixOS 环境允许像 *(volatile unsigned int *)0xfdc60068 这样直接访问目标地址。
• 某些寄存器存在“读清零”或其他读副作用，读取前需要先确认芯片手册。
• 地址和访问位宽应与寄存器定义一致，否则可能读到错误值，甚至触发异常。

Tips

Linux 下若不支持 SSH 文件传输，可使用 wget 命令下载：

电脑端开启临时文件服务器：

python -m http.server 8888

将待传输文件放在启动命令时所在的目录下。

板卡端下载文件：

wget http://电脑ip:8888/file

---

eth_dual_selftest

用于 SylixOS 单板双网口直连 场景下的网络自测工具，适合在 没有陪测机 的情况下，快速验证板卡当前双网口网络配置和链路状态是否正常。

该工具适用于：

• 一块板卡上有两个以太网口
• 两个网口之间通过网线直连
• 需要在板端直接测试网络是否可用
• 没有额外 PC 或服务器作为陪测机

文件说明

文件	说明
eth_dual_selftest/eth_dual_selftest.c	SylixOS 版本单板双网口自测工具源码

测试流程图

主要模式

• verify 适合做“配置是否正常、链路是否稳定”的验证模式。更强调验证结果的可靠性。

• bench 适合做“当前双网口直连场景下，大致能跑到多大吞吐”的基准模式。更强调速度观测。

编译方式

该源码面向 SylixOS 工程环境使用，通常做法是：

1. 将 eth_dual_selftest.c 放入 SylixOS App 工程
2. 使用项目已有的 config.mk + multi-platform.mk 构建

如使用交叉编译器单独编译，需确保包含：

• SylixOS.h
• netpacket/packet.h
• net/if_arp.h

以及 SylixOS 的网络头文件搜索路径。

使用方法

默认运行：

./eth_dual_selftest

默认模式为 bench。

常见用法：

# 跑吞吐基准模式，持续 10 秒
./eth_dual_selftest -d 10

# 跑验证模式，持续 5 秒
./eth_dual_selftest -m verify -d 5

# 指定两个网口名
./eth_dual_selftest -a en1 -b en2 -m verify -d 5

# 指定单次测试 payload 大小
./eth_dual_selftest -m bench -d 10 -sl 1472

参数说明

参数	说明
-a <ifname>	指定网口 A，默认 en1
-b <ifname>	指定网口 B，默认 en2
-m <mode>	测试模式，可选 verify 或 bench，默认 bench
-d <sec>	每个阶段持续时间（秒）。设置后按时长运行
-sc <count>	在未指定 -d 时，单方向发送的数据包数量
-sl <bytes>	单方向测试 payload 大小
-sg <usec>	verify 模式下发送间隔（微秒）
-t <msec>	发送结束后接收等待超时（毫秒）

使用建议

• 如果目的是先确认“当前网络配置和链路状态是否正常”，优先使用：

./eth_dual_selftest -m verify -d 5

• 如果目的是看“大致吞吐能力”，优先使用：

./eth_dual_selftest -d 10

• 运行前请确保两个网口已经直连，且接口处于 UP / RUNNING 状态。

典型场景

• 板卡出厂前的单板双口网络自检
• 无陪测机条件下的网络配置快速验证
• 现场调试时快速确认两个网口是否工作正常
• 粗略观测双口直连场景下的板端吞吐水平

---