SmarTest 开发环境入门Eclipse IDE 集成与工作区管理系列Advantest V93000 SmarTest 8 核心概念解析第 1 篇共 8 篇适合读者初次接触 SmarTest 的测试工程师、ATE 软件开发者前言很多工程师第一次打开 SmarTest看到的是一个长得像 Eclipse 的东西。没错SmarTest 的开发环境确实是基于 Eclipse 构建的——但它不是一个简单的皮肤而是在 Eclipse 的扩展机制之上深度定制了专门面向半导体测试的工具链。本篇介绍三个基础概念Workspace工作区、Work Center工作中心、Project项目以及几个容易踩坑的细节。一、SmarTest 是什么样的 IDESmarTest 的开发界面叫做Work Center是 Eclipse IDE 的专属定制版本。启动 SmarTest 后弹出的主窗口就是 Work Center它围绕三类主要工作流预定义了多套Perspective视图配置Setup编写测试配置文件measurement spec、timing、pattern 等Device Debug调试 DUT 和测试程序Analysis分析测试结果每个 Perspective 都是一套固定布局的 Editor View 组合。你也可以自定义 Perspective但配置会绑定到当前 Workspace。Editor 和 View 的区别这个区别在日常使用中很容易混淆类型用途保存方式Editor打开并编辑文件配置文件、测试方法代码等需要手动 CtrlS 保存View显示和分析数据或修改选中对象的属性修改立即自动保存这意味着在 View 里做的操作是无法用 CtrlZ 撤销的操作前需要格外注意。二、WorkspaceSmarTest 的工作目录Workspace 是 SmarTest 的工作根目录用来组织你的项目引用和个人偏好设置。本质上它是 Eclipse 标准 Workspace 的特化版本但有几条 SmarTest 特有的约束。2.1 三条必须记住的规则规则一Workspace 不能在 Project 目录内部Project 目录可以放在 Workspace 里但强烈建议不要这样做。原因是如果你删除一个 Workspace里面的 Project 也会被一并删除。推荐做法是把 Project 放在 Workspace 之外然后通过**引用reference**的方式导入 Workspace这样删除 Workspace 不会影响 Project。规则二Workspace 不能多用户共享也不能被多个 SmarTest 实例同时使用如果想在团队之间共享数据共享的单位是Project而不是 Workspace。规则三Workspace 与 SmarTest 版本绑定SmarTest 8 的 Workspace 无法用 SmarTest 7 打开。版本升级后通常需要转换旧 Workspace但降级则几乎不可行。2.2 Workspace 的文件结构一个 SmarTest Workspace 根目录下有两个核心文件workspace_root/ ├── projects.map ← 必须存在记录所有项目 └── remote.map ← 可选仅当项目来自远程网络时存在projects.map 详解这是 Workspace 最重要的元数据文件纯文本格式UTF-8记录了当前 Workspace 引用的所有 Project 名称和路径。格式规则每行一个keyvalue键值对key 是 Project 名称value 是路径行尾用\n等号两侧的空格会被自动去除\用于转义适合路径中含空格或的情况#开头的行是注释注意注释不会被写回文件支持环境变量$(ENV_VAR_NAME)路径格式有三种# 1. 绝对路径Workspace 外部项目 GlobalProjectName1/opt/libraries/project1 # 2. 环境变量相对路径Workspace 外部项目适合多机共享 SharedProjectName$(SRC_ROOT)/project3 # 3. Workspace 相对路径Workspace 内部项目不推荐 WorkspaceLocalProjectNamesomeDir/project4推荐使用第 2 种环境变量路径便于在不同机器或用户之间共享项目配置而不硬编码绝对路径。remote.map当项目来源于网络文件系统的远程位置时SmarTest 会在本地缓存一份并在 remote.map 中记录远程地址remote{$PATH$}这与 Local Cache 功能配合使用适合多人开发环境下的只读库引用场景。三、SmarTest Project测试程序的基本单元Project项目是 SmarTest 组织测试数据的基本单元。一个 Project 对应文件系统上的一个文件夹内部存放测试程序文件、配置文件、测试方法代码等。3.1 Project 的必要组成一个最小化的可运行 SmarTest Project 需要project_folder/ ├── src/ ← 源文件夹必须有至少一个 │ └── 功能子目录/ │ ├── *.prog ← 测试程序文件必须在 src 下 │ ├── *.flow ← testflow 文件 │ ├── *.spec ← measurement specification 文件 │ └── *.java ← 测试方法不能直接放在 src 下必须在子目录 ├── bin/ ← 输出文件夹SmarTest 自动管理勿手动修改 ├── .asourcepath ← 自动生成勿修改 ├── .aclasspath ← 自动生成勿修改 ├── .aproject ← 自动生成勿修改 └── .gitignore ← 自动生成可用于 Git 版本控制几个重要约束测试方法 Java 文件必须放在 src 的子目录中不能直接放在 src 下bin 目录由 SmarTest 全权管理不要手动修改src 下的所有文件在 binding绑定阶段都会被读取所以不要把非配置文件放到 src 里否则会拖慢绑定速度3.2 推荐的目录结构Advantest 推荐三种组织方式按需选择方式 A按文件类型组织适合小型项目src/ └── myDevice/ ├── common/ ← DUT board、主 testflow 等公共文件 ├── rxTest/ ← Rx 测试相关的所有文件 └── txTest/ ← Tx 测试相关的所有文件方式 B按测试流程组织适合流程复杂的项目src/ └── myDevice/ ├── common/ ├── functional/ │ ├── patterns/ │ ├── specs/ │ └── opSeq/ └── dc/方式 C按 IP Core 组织适合多核 SOC 项目src/ └── myDevice/ ├── common/ ├── coreA/ ├── coreB/ └── coreC/无论哪种方式都建议把跨测试共用的文件DUT board description、主 testflow统一放在common目录下。3.3 Project 命名规则命名规则严格遵循 Java 风格第一个字符只能是A-Z、a-z、_、$不能以数字开头其余字符可以是a-z、A-Z、0-9、_、$不能使用 SmarTest 关键字作为文件名或文件夹名同一 Workspace 内 Project 名称必须唯一Project 名称可以与文件夹名不同命名惯例建议文件夹名首字母小写文件名首字母大写以便在 IDE 中一眼区分。3.4 Project 之间的共享与引用SmarTest 支持跨 Project 共享测试数据有两种方式引用Reference推荐项目在原位置不动通过 SmarTest Build Path 链接过来。右键目标 Project → SmarTest Build Path → New SmarTest Project Link。复制Copy不推荐将文件复制到当前 Project。会导致数据不一致难以维护。引用机制还会同步 Metadata如路径变量、显示过滤器这意味着共享 Project 也会共享相关偏好设置协作时需要注意。四、C 集成JNI 与 SWIGSmarTest 的测试方法主体是 Java但如果已有 C 编写的算法库或需要调用底层 native 代码SmarTest 提供两条路径Java Native Interface (JNI)JNI 是 Java 标准的 native 调用框架允许 Java 测试方法调用 C 函数也允许 C 函数反向操作 Java 对象。需要手写 JNI 胶水代码复杂但开销最小。Simplified Wrapper and Interface Generator (SWIG)SWIG 是开源工具能自动生成 JNI 绑定代码大幅减少手工编写量。代价是对复杂类型参数仍需手写转换代码且部分场景会引入性能开销。两种方式都需要一个独立的Bridge Project来存放 C 代码和.so共享库bridge_project/ └── lib/ └── *.so ← C 共享库必须放在这里注意Bridge Project 的代码在 SmarTest 启动时加载修改后必须重新激活测试程序才能生效。Foreign Function and Memory (FFM) API较新方式FFM API 是 Java 17 引入的 native 调用机制SmarTest 8 也支持。与 JNI/SWIG 不同使用 FFM API不需要单独创建 Bridge Project可以直接在测试方法中通过natives包调用.so库更简洁。五、Model File测试头硬件的配置描述Model File 是连接软件与硬件的关键文件默认位于/etc/opt/hp93000/soc/tester.model它描述了测试头test head上安装了哪些卡card、各卡的功能特性、以及这些卡到 DUT board 接口上 pogo block 的映射关系。此外还指定了测试系统的参考时钟信号。SmarTest 在启动时读取该文件Online 模式光纤连接正常读取实际硬件并在报告窗口中输出MAXIMUM POSSIBLE CONFIGURATION表Offline 模式无硬件连接按 model file 定义的配置模拟运行在典型安装中tester.model通常是一个软链接指向/etc/opt/hp93000/soc_common/tester.model这样多版本的 SmarTest 可以共享同一个硬件描述文件。如果需要版本特定的配置也可以在默认路径放一个真实文件。总结概念一句话关键约束Workspace工作根目录管理项目引用和个人偏好不可共享、版本绑定、不要把 Project 放在里面Work CenterSmarTest 定制的 Eclipse IDE 主窗口Perspective 配置绑定 WorkspaceProject测试程序及配置文件的存储单元命名遵循 Java 风格推荐引用而非复制共享projects.mapWorkspace 中所有 Project 的索引文件纯文本 keyvalue支持环境变量路径Model File描述测试头硬件配置软件与硬件绑定的核心桥梁下一篇将介绍 SmarTest 测试程序的整体架构从 Test Program 到 Test Method 的四层层级结构。