Intel® Quartus® Prime Standard Edition用户指南: 调试工具

下载 PDF
ID 683552
日期 9/24/2018
Public
文档目录
文档目录 x
1. 系统调试工具概述 2. 使用System Console分析和调试设计 3. 调试收发器链路 4. 使用Signal Probe的快速设计调试 5. 使用Signal Tap逻辑分析仪进行设计调试 6. 使用外部逻辑分析器进行在系统调试(In-System Debugging Using External Logic Analyzers) 7. 存储器和常量的在系统修改(In-System Modification of Memory and Constants) 8. 使用In-System Sources and Probes进行设计调试 A. Intel® Quartus® Prime Standard Edition用户指南
1. 系统调试工具概述 x
1.1. 系统调试工具组合 1.2. 用于监控RTL节点的工具 1.3. 激励使能工具(Stimulus-Capable Tools) 1.4. Virtual JTAG Interface Intel® FPGA IP 1.5. 系统级调试架构 1.6. 系统调试工具概述修订历史
1.1. 系统调试工具组合 x
1.1.1. 系统调试工具比较 1.1.2. 对常用调试要求所建议的工具 1.1.3. 调试生态系统
1.2. 用于监控RTL节点的工具 x
1.2.1. 资源使用 1.2.2. 管脚使用 1.2.3. 可用性增强
1.2.1. 资源使用 x
1.2.1.1. 开销逻辑(Overhead Logic) 1.2.1.2. 资源评估
1.2.2. 管脚使用 x
1.2.2.1. For Signal Tap Logic Analyzer 1.2.2.2. For Signal Probe 1.2.2.3. For Logic Analyzer Interface
1.2.3. 可用性增强 x
1.2.3.1. 增量式编译 1.2.3.2. 增量式布线 1.2.3.3. 通过脚本实现自动化 1.2.3.4. 远程调试
1.3. 激励使能工具(Stimulus-Capable Tools) x
1.3.1. In-System Sources and Probes 1.3.2. In-System Memory Content Editor 1.3.3. 系统控制台(System Console)
1.3.1. In-System Sources and Probes x
1.3.1.1. 按钮功能
1.3.2. In-System Memory Content Editor x
1.3.2.1. 生成测试向量
1.3.3. 系统控制台(System Console) x
1.3.3.1. 测试信号完整性 1.3.3.2. 电路板启动和验证(Board Bring-Up and Verification) 1.3.3.3. 使用Transceiver Toolkit测试链路信号完整性
2. 使用System Console分析和调试设计 x
2.1. System Console简介 2.2. System Console调试流程 2.3. 与System Console交互的IP内核 2.4. 启动System Console 2.5. System Console GUI 2.6. System Console命令 2.7. 在命令行模式下运行System Console 2.8. System Console服务 2.9. 使用工具包 2.10. ADC Toolkit 2.11. System Console示例和教程 2.12. 板载 Intel® FPGA Download Cable II支持 2.13. 系统验证流程中的MATLAB*和Simulink* 2.14. 不推荐使用的命令 2.15. 使用System Console分析和调试设计修订历史
2.3. 与System Console交互的IP内核 x
2.3.1. 通过调试代理程序提供的服务
2.4. 启动System Console x
2.4.1. 从 Nios® II Command Shell启动System Console 2.4.2. 启动独立的System Console 2.4.3. 从Platform Designer (Standard)启动System Console 2.4.4. 从 Intel® Quartus® Prime启动System Console 2.4.5. 自定义启动
2.5. System Console GUI x
2.5.1. System Explorer窗格
2.8. System Console服务 x
2.8.1. 查找可用服务 2.8.2. 打开和关闭服务 2.8.3. SLD Service 2.8.4. In-System Sources and Probes服务 2.8.5. 监控服务(Monitor Service) 2.8.6. 器件服务(Device Service) 2.8.7. 设计服务 2.8.8. 字节流服务(Bytestream Service) 2.8.9. JTAG Debug服务
2.8.3. SLD Service x
2.8.3.1. SLD命令
2.8.4. In-System Sources and Probes服务 x
2.8.4.1. In-System Sources and Probes命令
2.8.5. 监控服务(Monitor Service) x
2.8.5.1. Monitor命令
2.8.6. 器件服务(Device Service) x
2.8.6.1. 器件命令
2.8.7. 设计服务 x
2.8.7.1. 设计服务命令
2.8.8. 字节流服务(Bytestream Service) x
2.8.8.1. 字节流命令(Bytestream Commands)
2.8.9. JTAG Debug服务 x
2.8.9.1. JTAG Debug命令
2.9. 使用工具包 x
2.9.1. 将Dashboard脚本转换成Toolkit API 2.9.2. 创建一个工具包描述文件 2.9.3. 注册一个工具包 2.9.4. 启动一个工具包 2.9.5. 将工具包与IP内核匹配 2.9.6. Toolkit API
2.9.6. Toolkit API x
2.9.6.1. 自定义Toolkit API小部件 2.9.6.2. Toolkit API脚本实例 2.9.6.3. Toolkit API GUI实例 2.9.6.4. Toolkit API命令 2.9.6.5. Toolkit API属性
2.9.6.3. Toolkit API GUI实例 x
2.9.6.3.1. Toolkit API GUI Example .tcl文件
2.9.6.4. Toolkit API命令 x
2.9.6.4.1. toolkit_register 2.9.6.4.2. toolkit_open 2.9.6.4.3. get_quartus_ini 2.9.6.4.4. toolkit_get_context 2.9.6.4.5. toolkit_get_types 2.9.6.4.6. toolkit_get_properties 2.9.6.4.7. toolkit_add 2.9.6.4.8. toolkit_get_property 2.9.6.4.9. toolkit_set_property 2.9.6.4.10. toolkit_remove 2.9.6.4.11. toolkit_get_widget_dimensions
2.9.6.5. Toolkit API属性 x
2.9.6.5.1. 小部件类型和属性 2.9.6.5.2. barChart属性 2.9.6.5.3. 按钮属性 2.9.6.5.4. checkBox属性 2.9.6.5.5. comboBox属性 2.9.6.5.6. 表盘属性(dial Properties) 2.9.6.5.7. fileChooserButton属性 2.9.6.5.8. group属性 2.9.6.5.9. label属性 2.9.6.5.10. led属性 2.9.6.5.11. lineChart属性 2.9.6.5.12. list属性 2.9.6.5.13. pieChart属性 2.9.6.5.14. table属性 2.9.6.5.15. text属性 2.9.6.5.16. textField Properties 2.9.6.5.17. timeChart Properties 2.9.6.5.18. xyChart属性
2.10. ADC Toolkit x
2.10.1. ADC Toolkit术语 2.10.2. 设置参考信号的频率 2.10.3. 调整信号生成器 2.10.4. 运行信号质量测试 2.10.5. 运行线性测试 2.10.6. ADC工具包数据视图
2.11. System Console示例和教程 x
2.11.1. Nios® II处理器示例
2.11.1. Nios® II处理器示例 x
2.11.1.1. 处理器命令
2.13. 系统验证流程中的MATLAB*和Simulink* x
2.13.1. 支持的MATLAB* API命令 2.13.2. 高级流程(High Level Flow)
3. 调试收发器链路 x
3.1. Channel Manager 3.2. 收发器调试流程演练 3.3. 修改设计以使能收发器调试 3.4. 将设计编程到Intel FPGA中 3.5. 将设计加载到Transceiver Toolkit中 3.6. 链接硬件资源 3.7. 识别收发器通道 3.8. 创建收发器链路 3.9. 运行链路测试 3.10. 控制PMA模拟设置 3.11. 用户界面设置参考 3.12. 解决常见错误 3.13. 脚本编写API参考 3.14. 调试收发器链路修订历史
3.1. Channel Manager x
3.1.1. 通道显示模式
3.3. 修改设计以使能收发器调试 x
3.3.1. 修改Intel FPGA设计示例 3.3.2. Stratix® V调试系统配置 3.3.3. 例化和参数化 Intel® Arria® 10调试IP内核
3.3.1. 修改Intel FPGA设计示例 x
3.3.1.1. 修改 Stratix® V设计示例
3.3.1.1. 修改 Stratix® V设计示例 x
3.3.1.1.1. 从内部PLL生成reconfig_clk
3.3.2. Stratix® V调试系统配置 x
3.3.2.1. 误码率测试配置( Stratix® V) 3.3.2.2. PRBS信号眼图测试配置( Stratix® V) 3.3.2.3. 定制流量眼图测试配置( Stratix® V) 3.3.2.4. 链路优化测试配置( Stratix® V) 3.3.2.5. PMA模拟设置控制重配置( Stratix® V)
3.3.3. 例化和参数化 Intel® Arria® 10调试IP内核 x
3.3.3.1. 收发器IP内核的调试设置
3.6. 链接硬件资源 x
3.6.1. 将一个设计链接到一个器件 3.6.2. 将两个设计链接到两个器件 3.6.3. 将一个设计链接到两个器件 3.6.4. 链接设计和不同电路板上的器件 3.6.5. 验证硬件连接
3.7. 识别收发器通道 x
3.7.1. 控制收发器通道
3.9. 运行链路测试 x
3.9.1. 运行BER测试 3.9.2. 信号眼裕量测试(Signal Eye Margin Testing ( Stratix® V only)) 3.9.3. 运行自定义流量测试(仅 Stratix® V) 3.9.4. 链路优化测试
3.9.2. 信号眼裕量测试(Signal Eye Margin Testing ( Stratix® V only)) x
3.9.2.1. 运行PRBS信号眼测试(仅 Stratix® V)
3.9.4. 链路优化测试 x
3.9.4.1. 运行自动扫描测试(Auto Sweep Test) 3.9.4.2. 确定最佳布线设置(Determining the Best Tap Settings)
3.10. 控制PMA模拟设置 x
3.10.1. Intel® Arria® 10和 Intel® Cyclone® 10 GX PMA设置
3.13. 脚本编写API参考 x
3.13.1. Transceiver Toolkit命令 3.13.2. Data Pattern Generator命令 3.13.3. Data Pattern Checker命令
4. 使用Signal Probe的快速设计调试 x
4.1. 使用Signal Probe的设计流程 4.2. 脚本支持 4.3. 使用Signal Probe的快速设计调试修订历史
4.1. 使用Signal Probe的设计流程 x
4.1.1. 执行一个完整的编译 4.1.2. 保留Signal Probe管脚 4.1.3. 分配Signal Probe源 4.1.4. 在流水线路径与Signal Probe管脚之间添加寄存器 4.1.5. 执行Signal Probe编译 4.1.6. 分析Signal Probe编译的结果 4.1.7. 一个Signal Probe编译所完成的操作 4.1.8. 了解Signal Probe编译的结果
4.1.8. 了解Signal Probe编译的结果 x
4.1.8.1. 分析Signal Probe布线失败原因
4.2. 脚本支持 x
4.2.1. 生成一个Signal Probe管脚 4.2.2. 删除一个Signal Probe管脚 4.2.3. 使能一个Signal Probe管脚 4.2.4. 禁用一个Signal Probe管脚 4.2.5. 执行一个Signal Probe编译 4.2.6. 保留Signal Probe管脚 4.2.7. 添加Signal Probe源 4.2.8. 分配I/O标准 4.2.9. 添加寄存器用于流水线(pipelining) 4.2.10. 完整编译后立即运行Signal Probe 4.2.11. 手动运行Signal Probe 4.2.12. 使能或禁用所有Signal Probe布线 4.2.13. 允许Signal Probe修改Fitting结果
4.2.5. 执行一个Signal Probe编译 x
4.2.5.1. 脚本示例
4.2.6. 保留Signal Probe管脚 x
4.2.6.1. 保留Signal Probe管脚时的常见问题
5. 使用Signal Tap逻辑分析仪进行设计调试 x
5.1. Signal Tap逻辑分析仪 5.2. Signal Tap Logic Analyzer任务流程概述 5.3. 配置Signal Tap Logic Analyzer 5.4. 定义触发器 5.5. 编译设计 5.6. 对目标器件或者器件编程 5.7. 运行Signal Tap Logic Analyzer 5.8. 查看，分析和使用采集的数据 5.9. 其他功能 5.10. 设计实例：使用Signal Tap Logic Analyzers 5.11. 自定义触发流程应用示例 5.12. Signal Tap脚本支持 5.13. 使用Signal Tap Logic Analyzer进行设计调试修订历史
5.1. Signal Tap逻辑分析仪 x
5.1.1. 硬件和软件要求 5.1.2. Signal Tap Logic Analyzer特性和优点 5.1.3. 向后兼容 Intel® Quartus® Prime软件的先前版本
5.1.1. 硬件和软件要求 x
5.1.1.1. 打开独立的Signal Tap Logic Analyzer GUI
5.2. Signal Tap Logic Analyzer任务流程概述 x
5.2.1. 将Signal Tap Logic Analyzer添加到您的设计中 5.2.2. 配置Signal Tap Logic Analyzer 5.2.3. 定义触发条件 5.2.4. 编译设计 5.2.5. 对目标器件或者器件编程 5.2.6. 运行Signal Tap Logic Analyzer 5.2.7. 查看，分析和使用采集的数据
5.3. 配置Signal Tap Logic Analyzer x
5.3.1. 分配一个采集时钟(Acquisition Clock) 5.3.2. 将信号添加到Signal Tap文件中 5.3.3. 使用插件添加信号 5.3.4. 添加有限状态机状态编码寄存器(Adding Finite State Machine State Encoding Registers) 5.3.5. 指定样本深度 5.3.6. 采集数据到一个特定的RAM类型 5.3.7. 选择缓存采集模式 5.3.8. 指定流水线设置(Specifying Pipeline Settings) 5.3.9. 过滤相关样本 5.3.10. 管理多个Signal Tap文件和配置
5.3.2. 将信号添加到Signal Tap文件中 x
5.3.2.1. 预综合信号(Pre-Synthesis Signals) 5.3.2.2. 后拟合信号(Post-Fit Signals) 5.3.2.3. 信号保留(Signal Preservation) 5.3.2.4. 节点列表信号使用选项 5.3.2.5. 不可用于Signal Tap调试的信号
5.3.2.2. 后拟合信号(Post-Fit Signals) x
5.3.2.2.1. 使用Technology Map Viewer分配数据信号
5.3.2.4. 节点列表信号使用选项 x
5.3.2.4.1. 禁用和使能一个Signal Tap实例
5.3.4. 添加有限状态机状态编码寄存器(Adding Finite State Machine State Encoding Registers) x
5.3.4.1. 修改和还原状态机的助记符表 5.3.4.2. Signal Tap中的状态机的其他考量
5.3.7. 选择缓存采集模式 x
5.3.7.1. 非分段缓存 5.3.7.2. 分段缓存
5.3.8. 指定流水线设置(Specifying Pipeline Settings) x
5.3.8.1. 从Platform Designer (Standard)指定流水线设置(Pipeline Settings)
5.3.9. 过滤相关样本 x
5.3.9.1. 输入端口模式 5.3.9.2. Transitional模式 5.3.9.3. Conditional模式 5.3.9.4. Start/Stop模式 5.3.9.5. 基于状态(State-Based) 5.3.9.6. 显示数据不连续性 5.3.9.7. 禁用存储限定符
5.3.10. 管理多个Signal Tap文件和配置 x
5.3.10.1. Data Log窗格 5.3.10.2. SOF Manager
5.4. 定义触发器 x
5.4.1. 基本触发条件 5.4.2. Comparison触发条件 5.4.3. 高级触发条件 5.4.4. Custom Trigger HDL对象 5.4.5. 触发条件流程控制 5.4.6. 指定触发位置 5.4.7. 上电触发器 5.4.8. 外部触发器(External Triggers)
5.4.1. 基本触发条件 x
5.4.1.1. 使用Basic OR触发条件和嵌套组
5.4.2. Comparison触发条件 x
5.4.2.1. 指定Comparison触发条件
5.4.3. 高级触发条件 x
5.4.3.1. 高级触发表达式的示例
5.4.4. Custom Trigger HDL对象 x
5.4.4.1. 使用Custom Trigger HDL对象 5.4.4.2. Custom Trigger HDL模块所需输入和输出 5.4.4.3. Custom Trigger HDL模块属性
5.4.5. 触发条件流程控制 x
5.4.5.1. 顺序触发(Sequential Triggering) 5.4.5.2. 基于状态的触发 5.4.5.3. Signal Tap Trigger Flow Description Language 5.4.5.4. 基于状态的存储限定符功能
5.4.5.1. 顺序触发(Sequential Triggering) x
5.4.5.1.1. 配置顺序触发流程 5.4.5.1.2. 达到条件后跳过时钟周期的触发 5.4.5.1.3. Post-Fill Count值小于m的存储限定(Storage Qualification)
5.4.5.2. 基于状态的触发 x
5.4.5.2.1. State-Based Triggering Flow选项卡 5.4.5.2.2. 触发锁定模式(Trigger Lock Mode)
5.4.5.3. Signal Tap Trigger Flow Description Language x
5.4.5.3.1. <state_label> 5.4.5.3.2. <boolean_expression> 5.4.5.3.3. <action_list>
5.4.5.4. 基于状态的存储限定符功能 x
5.4.5.4.1. 基于状态的触发流程的存储限定功能
5.4.6. 指定触发位置 x
5.4.6.1. 填充后计数(Post-fill Count)
5.4.7. 上电触发器 x
5.4.7.1. 使能Power-Up Trigger 5.4.7.2. 配置Power-Up Trigger条件 5.4.7.3. 使用Run-Time和Power-Up Trigger条件管理Signal Tap实例
5.4.8. 外部触发器(External Triggers) x
5.4.8.1. 使用一个分析器的Trigger Out 作为另一个分析器的Trigger In
5.5. 编译设计 x
5.5.1. 使用 Intel® Quartus® Prime增量编译的更快速编译 5.5.2. 防止需要重新编译的更改 5.5.3. 验证是否需要重新编译工程 5.5.4. 通过快速重新编译进行增量式布线(Incremental Route with Rapid Recompile) 5.5.5. 使用Signal Tap Logic Analyzer的时序保留 5.5.6. 性能和资源考量
5.5.1. 使用 Intel® Quartus® Prime增量编译的更快速编译 x
5.5.1.1. 对您的设计使能增量编译 5.5.1.2. 使用Signal Tap Logic Analyzer的增量编译
5.5.4. 通过快速重新编译进行增量式布线(Incremental Route with Rapid Recompile) x
5.5.4.1. 使用Incremental Route流程 5.5.4.2. 实现最大加速的技巧
5.5.6. 性能和资源考量 x
5.5.6.1. 关键路径中的Signal Tap逻辑 5.5.6.2. 使用关键资源的Signal Tap逻辑
5.6. 对目标器件或者器件编程 x
5.6.1. 确保.stp与.sof文件之间的设置兼容性
5.7. 运行Signal Tap Logic Analyzer x
5.7.1. 运行时可重配置选项 5.7.2. Signal Tap状态消息
5.8. 查看，分析和使用采集的数据 x
5.8.1. 使用分段缓存采集数据 5.8.2. 不同采集模式之间的预填充写入行为的差异 5.8.3. 为比特码型创建助记符(Creating Mnemonics for Bit Patterns) 5.8.4. 使用插件的自动助记符 5.8.5. 在设计中定位一个节点 5.8.6. 保存采集的数据 5.8.7. 将采集的数据导出为其他文件格式 5.8.8. 创建一个Signal Tap列表文件
5.8.2. 不同采集模式之间的预填充写入行为的差异 x
5.8.2.1. 示例
5.9. 其他功能 x
5.9.1. 从设计实例创建Signal Tap文件 5.9.2. 使用Signal Tap MATLAB* MEX函数采集数据 5.9.3. 在实验室环境中使用Signal Tap 5.9.4. 使用Signal Tap Logic Analyzer进行远程调试 5.9.5. 在具备配置比特流安全性的器件中使用Signal Tap Logic Analyzer 5.9.6. 监控Signal Tap Logic Analyzer使用的FPGA资源
5.9.1. 从设计实例创建Signal Tap文件 x
5.9.1.1. 从一个设计实例创建一个.stp文件
5.9.4. 使用Signal Tap Logic Analyzer进行远程调试 x
5.9.4.1. 使用本地PC和SoC进行调试 5.9.4.2. 使用本地PC和远程PC进行调试
5.9.4.2. 使用本地PC和远程PC进行调试 x
5.9.4.2.1. 设备设置
5.11. 自定义触发流程应用示例 x
5.11.1. 设计示例1：指定一个自定义触发位置 5.11.2. 设计示例2：当在triggercond2和triggercond3之间triggercond1出现十次时触发
5.12. Signal Tap脚本支持 x
5.12.1. Signal Tap命令行选项 5.12.2. 从命令行采集数据
6. 使用外部逻辑分析器进行在系统调试(In-System Debugging Using External Logic Analyzers) x
6.1. 关于 Intel® Quartus® Prime Logic Analyzer Interface 6.2. 选择一个逻辑分析器 6.3. 使用LAI的流程 6.4. 在运行期间控制活动bank 6.5. 使用LAI及增量编译 6.6. LAI核心参数 6.7. 使用外部逻辑分析器进行在系统调试修订历史(In-System Debugging Using External Logic Analyzers Revision History)
6.2. 选择一个逻辑分析器 x
6.2.1. 所需组件
6.3. 使用LAI的流程 x
6.3.1. 定义Logic Analyzer Interface的参数 6.3.2. 将LAI文件管脚映射到可用的I/O管脚 6.3.3. 将内部信号映射到LAI bank 6.3.4. 编译 Intel® Quartus® Prime工程 6.3.5. 使用LAI对Intel支持的器件进行编程
6.4. 在运行期间控制活动bank x
6.4.1. 获取Logic Analyzer上的数据
7. 存储器和常量的在系统修改(In-System Modification of Memory and Constants) x
7.1. 设置在系统可修改的存储器和常量 7.2. 运行In-System Memory Content Editor 7.3. 存储器和常量的在系统修改修订历史
7.2. 运行In-System Memory Content Editor x
7.2.1. Instance Manager 7.2.2. 对Hex Editor窗格中显示的数据进行编译 7.2.3. 导入和导出存储器文件 7.2.4. 脚本支持 7.2.5. 使用In-System Memory Content Editor对器件进行编程 7.2.6. 示例：使用In-System Memory Content Editor和Signal Tap Logic Analyzer
8. 使用In-System Sources and Probes进行设计调试 x
8.1. 硬件和软件要求 8.2. 使用In-System Sources and Probes Editor的设计流程 8.3. 编译设计 8.4. 运行In-System Sources and Probes IP Core 8.5. In-System Sources and Probes Editor的Tcl界面 8.6. 设计示例：动态PLL重配置 8.7. 使用In-System Sources and Probes进行设计调试修订历史
8.2. 使用In-System Sources and Probes Editor的设计流程 x
8.2.1. 例化In-System Sources and Probes IP Core 8.2.2. In-System Sources and Probes IP Core参数
8.4. 运行In-System Sources and Probes IP Core x
8.4.1. In-System Sources and Probes Editor GUI 8.4.2. 使用JTAG链配置对器件编程 8.4.3. Instance Manager 8.4.4. In-System Sources and Probes Editor窗格
8.4.4. In-System Sources and Probes Editor窗格 x
8.4.4.1. 读取探针数据(Reading Probe Data) 8.4.4.2. 写数据(Writing Data) 8.4.4.3. 组织数据(Organizing Data)
1. 系统调试工具概述
2. 使用System Console分析和调试设计
3. 调试收发器链路
4. 使用Signal Probe的快速设计调试
5. 使用Signal Tap逻辑分析仪进行设计调试
6. 使用外部逻辑分析器进行在系统调试(In-System Debugging Using External Logic Analyzers)
7. 存储器和常量的在系统修改(In-System Modification of Memory and Constants)
8. 使用In-System Sources and Probes进行设计调试
A. Intel® Quartus® Prime Standard Edition用户指南

8.5. In-System Sources and Probes Editor的Tcl界面

为了支持自动化，In-System Sources and Probes Editor以Tcl命令的形式支持本章中描述的过程步骤。运行quartus_stp时，默认包含In-System Sources and Probes Editor的Tcl package。

In-System Sources and Probes Editor的Tcl界面提供了一个设计调试的强大平台。Tcl界面 对于调试需要切换多组控制输入的设计特别有用。您可以将多个命令与Tcl脚本结合使用以定义一个定制命令集。

表 71.  In-System Sources and Probes Tcl命令
命令 参数 描述
start_insystem_source_probe -device_name <device name>
-hardware_name <hardware name> 打开一个包含指定硬件的器件的句柄。

在开始任何传输之前，请调用此命令。
get_insystem_source_
probe_instance_info -device_name <device name>
-hardware_name <hardware name> 返回设计中的所有ALTSOURCE_PROBE实例。返回的每个记录均采用以下格式：

{<instance Index>, <source width>, <probe width>, <instance name>}

read_probe_data -instance_index <instance_index>
-value_in_hex (optional) 检索探针的当前值。

返回一个字符串，该字符串指定每个探针的状态，其中MSB为最左边的位。
read_source_data -instance_index <instance_index>
-value_in_hex (optional) 检索源的当前值。

返回一个字符串，该字符串指定每个源的状态，其中MSB为最左边的位。
write_source_data -instance_index <instance_index>
-value <value>
-value_in_hex (optional) 设置来源的值。

一个二进制字符串被发送到源端口，其中MSB作为最左边的位。
end_insystem_source_probe None 释放JTAG链。

所有传输完成后，发出此命令。

该示例显示了Tcl脚本的摘录，其中包含控制设计的ALTSOURCE_PROBE实例的过程，如下图所示。该示例设计包含一个具有ALTSOURCE_PROBE实例的DCFIFO，以读取和写入DCFIFO。在设计中添加了一组控制复用器，以控制输入管脚和ALTSOURCE_PROBE实例之间的DCFIFO数据流。脉冲发生器被添加到读取请求和写入请求控制行，以确保对单个样本进行读取或写入。在下面的示例中与脚本一起使用时，ALTSOURCE_PROBE实例通过执行单个样本写入和读取操作并报告满和空状态标志(full and empty status flags)的状态，从而提供对FIFO内容的可见性。

在调试情况下使用Tcl脚本可以清空或预加载设计中的FIFO。例如，您可以使用此功能预加载FIFO，以匹配Signal Tap Logic Analyzer中设置的触发条件。
图 102. 由Tcl脚本控制的DCFIFO示例设计 


## Setup USB hardware  - assumes only USB Blaster is installed and
## an FPGA is the only device in the JTAG chain
set usb [lindex [get_hardware_names] 0]
set device_name [lindex [get_device_names -hardware_name $usb] 0]
## write procedure :  argument value is integer
proc write {value} {
global device_name usb
variable full
start_insystem_source_probe -device_name $device_name -hardware_name $usb
#read full flag
set full [read_probe_data -instance_index 0]
if {$full == 1} {end_insystem_source_probe
return "Write Buffer Full"
}
##toggle select line, drive value onto port, toggle enable
##bits 7:0 of instance 0 is S_data[7:0]; bit 8 = S_write_req;
##bit 9 = Source_write_sel
##int2bits is custom procedure that returns a bitstring from an integer     ## argument
write_source_data -instance_index 0 -value /[int2bits [expr 0x200 | $value]]
write_source_data -instance_index 0 -value [int2bits [expr 0x300 | $value]]
##clear transaction
write_source_data -instance_index 0 -value 0
end_insystem_source_probe
}
proc read {} {
global device_name usb
variable empty
start_insystem_source_probe -device_name $device_name -hardware_name $usb
##read empty flag : probe port[7:0] reads FIFO output; bit 8 reads empty_flag
set empty [read_probe_data -instance_index 1]
if {[regexp {1........} $empty]} { end_insystem_source_probe
return "FIFO empty" }
## toggle select line for read transaction
## Source_read_sel = bit 0; s_read_reg = bit 1
## pulse read enable on DC FIFO
write_source_data -instance_index 1 -value 0x1 -value_in_hex
write_source_data -instance_index 1 -value 0x3 -value_in_hex
set x [read_probe_data -instance_index 1 ]
end_insystem_source_probe
return $x
}
相关信息
二级标题