第一个工程

概述

本文档指导您创建第一个 EmeyeStudio 工程，完成从准备工作到成功采集数据的完整流程。

准备工作

硬件准备

  1. 目标设备
    - 支持 XCP 协议的嵌入式设备
    - 已烧录包含 XCP 从站协议的固件

  2. 连接线缆
    - USB 转串口线缆（如 CP2102、CH340 等）
    - 确保线缆质量良好

  3. 电脑要求
    - Windows 7/10/11 操作系统
    - 可用的 USB 端口
    - 已安装 USB 转串口驱动

软件准备

  1. EmeyeStudio
    - 已安装 EmeyeStudio 软件
    - 版本建议：最新稳定版

  2. ELF 文件
    - 目标设备的 ELF 可执行文件（.elf 或 .axf）
    - 与烧录到设备的固件完全匹配

创建工程

步骤 1：创建工作区

  1. 启动 EmeyeStudio
  2. 点击「文件」→「新建工作区」
  3. 选择工作区保存位置
  4. 输入工作区名称
  5. 点击「确定」

步骤 2：创建工程

  1. 点击「文件」→「创建工程」
  2. 输入工程名称（如「电机调试工程」）
  3. 选择工程保存位置（建议在工作区目录下）
  4. 点击「确定」

步骤 3：添加 ELF 文件

  1. 在资源浏览器中，右键「ELF资源」节点
  2. 选择「添加」
  3. 浏览并选择目标设备的 ELF 文件
  4. 点击「打开」
  5. 等待 ELF 文件解析完成

步骤 4：导入变量

  1. 右键 ELF 文件节点
  2. 选择「查找全局变量」
  3. 在搜索对话框中：
    - 输入变量名关键字（如 g_ 查找全局变量）
    - 或使用树形视图浏览所有变量
  4. 勾选需要观测的变量
  5. 点击「添加到工程」

变量将出现在工程的「变量引用」节点下。

步骤 5：配置观测变量

  1. 打开「多变量图形分析」窗口（菜单「视图」→「多变量参数窗口」）
  2. 在资源浏览器中，选择要观测的变量
  3. 右键 →「添加到图形分析」
  4. 在多变量图形分析窗口中：
    - 勾选「显示」列以在波形图中显示
    - 设置显示颜色（可选）

连接设备

步骤 1：添加设备

  1. 在资源浏览器中，右键「设备」节点
  2. 选择「添加设备」
  3. 选择设备类型（如「串口设备」）
  4. 配置设备参数：
    - 端口：选择正确的 COM 端口
    - 波特率：115200（或根据目标设备设置）
    - 数据位：8
    - 停止位：1
    - 校验：无
  5. 点击「确定」

步骤 2：连接设备

  1. 将目标设备通过 USB 连接到电脑
  2. 确认目标设备已上电
  3. 在资源浏览器中，右键设备节点
  4. 选择「连接」
  5. 等待状态栏显示「已连接」

启动采集

步骤 1：解析变量地址

  1. 右键工程节点
  2. 选择「解析所有地址」
  3. 等待地址解析完成
  4. 检查输出窗口，确认无错误

步骤 2：启动 DAQ

  1. 确认工具栏的工程选择下拉框中已选中当前工程
  2. 点击工具栏「开始」按钮（或按 F5）
  3. 观察状态栏，确认显示「运行中」
  4. 查看波形视图，应该能看到变量的实时波形

观察数据

波形视图

  • 实时波形：查看变量的实时变化趋势
  • 缩放：使用鼠标滚轮或工具栏按钮缩放
  • 平移：按住鼠标左键拖动平移
  • 分析尺：显示分析尺，测量特定时间点的数值

Watch 窗口

  1. 打开「Watch 窗口」（菜单「视图」→「Watch 窗口」）
  2. 将变量从资源浏览器拖拽到 Watch 窗口
  3. 查看变量的实时数值

坐标窗口

  1. 打开「坐标窗口」（菜单「视图」→「坐标窗口」）
  2. 在波形视图中移动光标
  3. 查看光标位置的精确数值和时间

保存数据

保存当前波形

  1. 在波形视图中右键
  2. 选择「保存数据」
  3. 输入数据名称
  4. 点击「确定」

数据将保存到工程的 Data 目录下，文件格式为 .xcpdata。

导出数据

  1. 在资源浏览器中，右键数据文件节点
  2. 选择「导出」
  3. 选择导出格式（CSV 或 MDF4）
  4. 选择保存位置
  5. 点击「保存」

停止采集

  1. 点击工具栏「停止」按钮（或按 F6）
  2. 观察状态栏，确认显示「已停止」
  3. 如需断开设备连接，右键设备节点 →「断开」

加载历史数据

  1. 在资源浏览器中，展开「数据」节点
  2. 找到之前保存的数据文件
  3. 右键 →「加载」
  4. 数据将加载到波形视图中

下一步

完成第一个工程后，您可以学习：

  1. 触发采集
    - 设置触发条件捕获特定事件
    - 参考触发条件

  2. 记录模式
    - 配置长时间记录参数
    - 参考记录模式

  3. 数据分析
    - 使用分析尺进行精确测量
    - 参考波形分析

  4. 硬件配置
    - 关联硬件配置导入变量
    - 参考硬件设备管理

常见问题

Q: 无法连接到设备？

A: 检查以下几点：
- USB 线缆是否连接牢固
- 驱动程序是否正确安装
- COM 端口选择是否正确
- 目标设备是否已上电

Q: DAQ 无法启动？

A: 检查以下几点：
- 设备是否已连接
- 变量地址是否已解析
- 是否有观测变量（多变量图形分析窗口中勾选了「显示」）

Q: 波形显示为直线？

A: 可能原因：
- 变量值为常量（正常现象）
- 变量地址解析错误（检查 ELF 文件是否匹配）
- Y 轴范围设置不当（右键 →「适应窗口」）

Q: 如何修改采样率？

A:
1. 停止 DAQ
2. 打开多变量图形分析窗口
3. 修改采样率设置
4. 重新启动 DAQ

相关文档