先决条件 |ETDump - ExecuTorch 转储¶
ETDump (ExecuTorch Dump) 是 ExecuTorch 开发人员工具的核心组件之一。通过该机制,可以从运行时中提取所有形式的分析和调试数据。用户不能直接解析 ETDump;相反,他们应该将其传递给 Inspector API,该 API 对数据进行反序列化,从而为灵活的分析和调试提供接口。
生成 ETDump¶
生成 ETDump 是一个相对简单的过程。用户可以按照下面详述的步骤将其集成到使用 ExecuTorch 的应用程序中。
在代码中包含 ETDump 标头。
#include <executorch/devtools/etdump/etdump_flatcc.h>
创建 ETDumpGen 类的实例,并将其传递到运行时调用的调用中。
load_method
executorch::etdump::ETDumpGen etdump_gen;
Result<Method> method =
program->load_method(method_name, &memory_manager, &etdump_gen);
Dump Out the ETDump Buffer - 推理迭代完成后,用户可以转储 ETDump 缓冲区。如果用户在具有文件系统的设备上,他们只需将其写出到文件系统即可。对于更受限的嵌入式设备,用户必须通过最适合他们的机制(例如 UART、JTAG 等)从设备中提取 ETDump 缓冲区。
etdump_result result = etdump_gen.get_etdump_data();
if (result.buf != nullptr && result.size > 0) {
// On a device with a file system users can just write it out
// to the file-system.
FILE* f = fopen(FLAGS_etdump_path.c_str(), "w+");
fwrite((uint8_t*)result.buf, 1, result.size, f);
fclose(f);
free(result.buf);
}
使用带有预处理器标志的 CMake 编译二进制文件,以便在 ExecuTorch 运行时内跟踪事件并将其记录到 ETDump 中。此标志需要添加到 ExecuTorch 库和您正在编译为二进制文件的任何运算符库中。作为参考,您可以看一下 。感兴趣的行是:
ET_EVENT_TRACER_ENABLED
examples/sdk/CMakeLists.txt
target_compile_options(executorch INTERFACE -DET_EVENT_TRACER_ENABLED)
target_compile_options(portable_ops_lib INTERFACE -DET_EVENT_TRACER_ENABLED)
使用 ETDump¶
将此 ETDump 传递到 Inspector API 中以访问此数据并进行运行后分析。