# rktoolbox 发布版本：0.4 日期：2019.11 作者邮箱：mark.huang@rock-chips.com、yp.xiao@rock-chips.com 文件密级：公开资料 --- **前言** **概述** rktoolbox旨在提供一个各个模块调试接口的总入口平台。 **产品版本** | **芯片名称** | **内核版本** | Android版本 | | ------------ | ------------ | ----------- | | 全平台 | 与内核无关 | 10.0 | **读者对象** 本文档（本指南）主要适用于以下对象： 软件开发工程师 **修订记录** | **日期** | **版本** | **作者** | **修改说明** | | ---------- | -------- | -------- | ------------------------------ | | 2019.11.07 | V0.1 | 肖亚鹏 | 初始版本 | | 2019.11.13 | V0.2 | 肖亚鹏 | 新增模块添加说明 | | 2019.11.29 | V0.3 | 黄建财 | 添加当前版本支持功能列表 | | 2019.12.23 | V0.4 | 黄建财 | 更新支持列表，支持显示模块工具 | | | | | | --- [TOC] --- ## 简介 **1.传参区分指令** 当我们在shell下键入命令时，是shell创建一个进程运行对应你键入的程序，这些命令程序之间没什么联系，故他们之间公共的代码需要在每个命令二进制程序中都有拷贝，而toybox相当于shell下各种命令的集合体，我们可以看成是它们链接而成的，这样这些命令之间公共的部分就只有一份拷贝了，从而可以减少这些命令程序的二进制文件总量，这些在象嵌入式系统这些资源紧张的系统中是很有必要的。那busybox又是怎样区分不同命令的呢。有两种方法： 1.用toybox命令 命令的参数,如 toybox ls -al 2.通常用的一种是添加软链接为每个命令建立一个链接文件，如 ln -s toybox ls 执行时就执行./ls命令就可以 第一种方式实现原理很容易知道，命令是作为busybox的参数传入，然后就可以调用具体参数对应的指令。 第二种方式可能难理解一点，由符号链接我们可知，当键入具体命令时，都是执行toybox ，如当键入ls是，由于ls是toybox 的链接，其实执行的是toybox ，那怎样来区分不同命令呢，其实当我们键入ls，ls这个字符串就作为toybox 的第一个参数传入了，只是它隐晦一点，在第一种情况下，命令是通过第二个参数传入了。 **2.了解toybox原理** ``` lrwxr-xr-x 1 root shell 6 2009-01-01 00:00 ps -> toybox lrwxr-xr-x 1 root shell 6 2009-01-01 00:00 pwd -> toybox lrwxr-xr-x 1 root shell 6 2009-01-01 00:00 xxd -> toybox lrwxr-xr-x 1 root shell 6 2009-01-01 00:00 yes -> toybox ``` 可以看到，ps命令其实只是一个链接名称，程序执行的时候还是调用toybox，这里有一个比较巧妙的设计，比如执行ps，会调用起toybox程序，同时ps会作为参数传入，调用起里面的ps_main()方法。 toybox中采用了函数指针的处理方法去进行方法调用，采用toy_list结构体来保存命令（ps）和函数（ps_main）的映射。 ``` vi /external/toybox/toys.h extern struct toy_list { char *name; void (*toy_main)(void); char *options; unsigned flags; } toy_list[]; ``` 映射的初始化在 /external/toybox/main.c ,这里使用了字符串拼接的方法 ``` #undef NEWTOY #undef OLDTOY #define NEWTOY(name, opts, flags) {#name, name##_main, OPTSTR_##name, flags}, #define OLDTOY(name, oldname, flags) \ {#name, oldname##_main, OPTSTR_##oldname, flags}, struct toy_list toy_list[] = { #include "generated/newtoys.h" //映射表文件 }; generated/newtoys.h USE_TOYBOX(NEWTOY(toybox, NULL, TOYFLAG_STAYROOT)) USE_SH(OLDTOY(-sh, sh, 0)) USE_SH(OLDTOY(-toysh, sh, 0)) USE_TRUE(OLDTOY(:, true, TOYFLAG_NOFORK|TOYFLAG_NOHELP)) USE_ACPI(NEWTOY(acpi, "abctV", TOYFLAG_USR|TOYFLAG_BIN)) USE_GROUPADD(OLDTOY(addgroup, groupadd, TOYFLAG_NEEDROOT|TOYFLAG_SBIN)) USE_USERADD(OLDTOY(adduser, useradd, TOYFLAG_NEEDROOT|TOYFLAG_UMASK|TOYFLAG_SBIN)) USE_ARP(NEWTOY(arp, "vi:nDsdap:A:H:[+Ap][!sd]", TOYFLAG_USR|TOYFLAG_BIN)) USE_ARPING(NEWTOY(arping, "<1>1s:I:w#<0c#<0AUDbqf[+AU][+Df]", TOYFLAG_USR|TOYFLAG_SBIN)) USE_ASCII(NEWTOY(ascii, 0, TOYFLAG_USR|TOYFLAG_BIN)) USE_BASE64(NEWTOY(base64, "diw#<0=76[!dw]", TOYFLAG_USR|TOYFLAG_BIN)) ``` ## rktoolbox 集合工具一般有两种方式来调用各个模块的功能： 1. 所有模块工具编译在一个bin文件中。这种方式缺点就是bin文件会比较大，优点是没有依赖文件，一个文件拷贝到哪里都可以使用。 2. 主入口通过映射表来动态调用模块，单模块编译成bin文件，复制到system/bin目录.这种方式和第一种优缺点刚好相反，但是有个好处就是不用关注模块是提供的源码还是bin文件都可以兼容 考虑到不一定所有模块都能提供源码，所以使用第二种方式。 ``` 映射表结构体: enum{ E_DUMP_API_FLAGS = 0x01, }; #define SYSTEM_PATH "/system/bin/rk_" #define VENDOR_PATH "/vendor/bin/rk_" static struct { const char *name; const char *path; const char *info; int flags； //是否支持标准接口，或者支持哪些标准接口 } tools[] = { #define TOOL(name, flags, info) { #name, SYSTEM_PATH#name, #info, flags}, #include "tools.h" #undef TOOL { 0, 0 }, }; ``` 映射文件添加 ，利用脚本对映射文件name属性排序，方便运行时使用二分查找法查找对应指令。 **调用方式** 所有模块：rktoolbox -dump 调用所有支持dump api的模块 ``` foreach tool tools: if tool.flags & DUMP_API_FLAG == 1 printf("HEAD") exec(tool.path + argv[3]); printf("end") ``` 单个模块：rktoolbox media -dump 对应模块dump 接口。 exec("/system/bin/media -dump") **模块添加** 添加新的模块这里提供两种方式： 1.可以提供的源码的情况，可以参考deviceinfo目录 ``` a.在rktoolbox下创建对应的目录并把源码拷贝到目录下 b.根据情况修改模块参数适配统一接口 c.修改tools.h添加模块映射表信息 d.编写Android.mk和rktoolbox一起编译，编译出的模块名字需要添加 rk_ 前缀 ``` 2.只提供bin文件，可以参考dr-g目录 ``` a.在rktoolbox下创建对应的目录并把bin拷贝到目录下 b.根据情况是否添加转接模块以便适配统一接口 c.修改tools.h添加模块映射表信息 d.编写Android.mk和rktoolbox一起编译，编译出的模块名字需要添加 rk_ 前缀 ``` 3.版本功能支持列表： 后续会更新在：https://kdocs.cn/l/sev1EsCQw?f=501 | **模块** | **工具版本** | **命令说明** | **备注** | | -------------------- | ------------ | ------------------------------------------------------------ | -------- | | rktoolbox | V0.3 | rktoolbox
-version:
打印工具版本号
-help:
打印帮助信息
-dump:
打印所有子命令的-dump结果 | | | rktoolbox deviceinfo | V0.5 | rktoolbox deviceinfo
-help：
打印帮助信息
-dump:
打印设备信息，包含设备名称，序列号、版本信息、芯片信息、基本显示信息、安全信息cpu/ddr/gpu频率支持列表等
-dvfs:
打印内核相关信息：当前cpu/ddr/gpu等频率及支持列表，opp频率电压表等；
-log:
抓取系统日志并保存到data/deviceinfo下供拉取;
-lastlog:
打印上次关机前设备日志（lastlog）;
-stresstest:
启动stresstest测试;
-devicetest:
启动devicetest老化测试;
-version:打印版本信息 || |rktoolbox dr-g | V1.6 | rktoolbox dr-g
-help:
打印帮助信息
-dump:会从系统中获取平台与显示组件相关版本信息，打包到/data/dr-g-file/dumpInfo.tar供模块人员分析
-sys-set perf:
设置性能模式，该命令执行后，CPU，GPU，DDR 设置最高频率，温控关闭
-sys-set info:
获取当前状态，该命令执行后，回显打印当前 CPU，GPU，DDR 当前频率，温控状态
-sys-set gpu low/mid/high:
设置 GPU 三档频率，常用于 GPU 瓶颈的应用调试
-sys-set cpu low/mid/high:
设置 cpu 三档频率，常用于 cpu 瓶颈的应用调试
-sys-set ddr low/mid/high:
设置 ddr 三档频率，常用于 ddr 瓶颈的应用调试
-sys-set reset:
CPU，DDR，GPU 恢复系统调频模式，温控恢复
-io-qos set/get:
总线优先级设置或查询
-rga info:
打印 RGA 版本，硬件支持的数据格式，缩放倍数。最大输入输出分辨率信息| | |rktoolbox display | V1.0 | rktoolbox display
-help：
打印帮助信息
-dump:
打印设备显示相关信息，包括基本的分辨率、dpi、fbinfo、hdmi设备状态、支持格式及分辨率列表，hdcp1x状态，cec工作状态，hdmi详细工作状态，如：clk，分辨率，颜色，baseparameter显示分区信息等
-log:
hdmi显示信息日志一键收集，包括版本信息，属性表信息，window信息，surfacefliner信息，hdmi状态信息，hdmi ctrl和phy寄存器信息，hdmi edid信息，hdmi cec信息，显示分区信息，内核和logcat信息等，启动后将收集信息打包到data/display/hdmi_log.tar.gz，供拉取。 | | | | | | | 注： 1.dr-g工具以gpu组发布的文档说明为准.