CAEN wavedump使用方法

CAEN wavedump软件使用说明

Wavedump是基于C语言开发的控制应用程序，用于实现CAEN数字化仪的基础功能，如波形采集及脉冲信息数字化输出、基础硬件设置等功能，相较于CAEN的数字脉冲处理（DPP）固件，wavedump的固件（waveform）是免费的。Wavedump适用于720、V1721-V1731、724、725、730、740、742、751、761系列数字化仪。本文以DT5730为例进行说明。

1. 首先连接设备到电脑。电源线-电源适配器-DT5730-USB连接线-电脑。
2. 从官网下载设备驱动并安装，

https://www.caen.it/download/?filter=DT5730

选择正确的操作系统和版本。下载完后是zip压缩文件，将其解压到某个位置。

右键计算机-管理-设备管理器，找到带黄色感叹号的“CAEN DT5xxx USB 1.0”。

右键选择“更新驱动程序”-“浏览我的计算机以查找驱动程序软件”-“浏览”，选择解压好的驱动文件包。

等待驱动程序安装成功。

1. 查看该设备中已安装的固件版本。

打开CAENUpgrader软件（需安装JAVA环境），选择“Get Firmware Release”

选择正确的设备型号和连接方式。（这里以DT5730,USB连接为例），点击“Get Fw Rel”，可以看到ROC和AMC两个FPGA的固件版本号，连起来便是“4.15_139.08”。

打开CAEN官网，找到DT5730的下载页面-固件中可以找到对应的版本号，可以确定当前已安装的固件为DPP-PHA。（若版本号与官网上的不能对应，说明固件版本不是最新的，版本号接近的便是该固件类型）。

1. 根据CAEN固件-软件对应关系可以判断，如果需要使用wavedump软件，则需安装waveform固件。

从官网选择下载waveform固件（免费）并通过CAENUpgrader更换固件。

选择“Upgrade Firmware”，浏览下载好的固件，点击“upgrade”。

更换固件完成后重启设备。

1. 从官网上下载wavedump软件并安装。

https://www.caen.it/download/?filter=CAEN%20WaveDump

1. 安装完成后从开始菜单找到“wavedump folder”，不要直接点开“wavedump”。

1. 点开“bin”-“WaveDumpConfig”，（连接方式统一选择“WaveDumpConfig”文件进行配置，对于其他配置选项，740系列选择“WaveDumpConfig_X740”，742系列选择“WaveDumpConfig_X742”）。

1. 该文本文档是wavedump软件的配置文件，所有设备参数的配置均需在此文档中修改， 首先选择正确的连接方式，上方为程序功能描述，下方为选项，文档中以“#”表示忽略该行，以取消“#”表示选择该行。这里我们选择“OPEN USB 0 0”。

9.完成连接方式的选择后，即可正常运行wavedump软件，点击开始菜单中的“wavedump”快捷方式或bin文件夹下的“wavedump”。

10.出现此界面即表明已正确连接到设备。

11.输入“s”-开始/停止采集；

“q”-退出；

“空格”-帮助界面。

帮助界面中有更多的操作指令介绍，注意：输入大小写会实现不同的功能。

12.例如按以下步骤操作：s-T-P(开始采集-持续软件触发-持续绘图)。（当前无信号输入）

输入“w”或“W”键可以记录波形数据，文件保存在“wave_n”中(n为通道编号)。

13.在gnuplot graph直方图界面中，可以通过“鼠标右键-挪动-鼠标左键”操作放大图像，通过“p”键可以返回上一缩放。输入“a”键可以自动放大x轴和y轴，输入“y”键设置为满量程的y轴。

14.关于对信号的具体参数进行改动，在“WaveDumpConfig”可以进行设置，详细说明请参考“wavedump参数说明”或使用说明书“User Manual UM2091”。

15. wavedump参数说明

# ****************************************************************

# WaveDump Configuration File

# ****************************************************************

# NOTE:

# The lines between the commands @OFF and @ON will be skipped.

# This can be used to exclude parts of the file.

# —————————————————————-

# Settings common to all channels

# —————————————————————-

[COMMON]

# OPEN: open the digitizer

# options: USB 0 0 Desktop/NIM digitizer through USB

桌面/NIM数字化仪通过USB方式连接

# USB 0 BA VME digitizer through USB-V1718 (BA = BaseAddress of the VME board, 32 bit hex)

VME数字化仪通过V1718的USB端口连接（BA=VME板子的基础地址，32位16进制）

# PCI 0 0 0 Desktop/NIM/VME through CONET (optical link)

桌面/NIM/VME数字化仪通过光纤直连

# PCI 0 0 BA VME digitizer through V2718 (BA = BaseAddress of the VME board, 32 bit hex)

VME数字化仪通过V2718的光纤端口连接（BA=VME板子的基础地址，32位16进制）

OPEN USB 0 0

#OPEN USB 0 32100000

#OPEN PCI 0 0 0

#OPEN PCI 0 0 32100000

# RECORD_LENGTH = number of samples in the acquisition window

计数长度=每个触发（采集窗口）的采样数

RECORD_LENGTH 1024

# DECIMATION_FACTOR: change the decimation factor for the acquisition.

抽取因子=更改采集的抽取因子

# options: 1 2 4 8 16 32 64 128

DECIMATION_FACTOR 1

# POST_TRIGGER: post trigger size in percent of the whole acquisition window

后触发=后触发长度在整个采集窗口的百分比

# options: 0 to 100

POST_TRIGGER 50

#PULSE_POLARITY: input signal polarity.

输入信号极性

#options: POSITIVE, NEGATIVE

#

PULSE_POLARITY POSITIVE

# EXTERNAL_TRIGGER: external trigger input settings. When enabled, the ext. trg. can be either

外部触发器的使用方式

# propagated (ACQUISITION_AND_TRGOUT) or not (ACQUISITION_ONLY) through the TRGOUT

# options: DISABLED忽略外部触发, ACQUISITION_ONLY触发器到达前面板（TRG-IN）导致在所有通道获取一个事件, ACQUISITION_AND_TRGOUT与ACQUISITION_ONLY相同，此外外部触发还会传到TRG-OUT或GPO连接器

EXTERNAL_TRIGGER DISABLED

# FPIO_LEVEL: type of the front panel I/O LEMO connectors

前面板I/O LEMO连接类型

# options: NIM, TTL

FPIO_LEVEL NIM

# OUTPUT_FILE_FORMAT: output file can be either ASCII (column of decimal numbers) or binary

输出文件可以是ASCII（十进制）或二进制

# (2 bytes per sample)每个样本2字节

# options: BINARY, ASCII

OUTPUT_FILE_FORMAT ASCII

# OUTPUT_FILE_HEADER: if enabled, the header is included in the output file data

启用则将标题包含在输出的数据文件中

# options: YES, NO

OUTPUT_FILE_HEADER NO

# TEST_PATTERN: if enabled, data from ADC are replaced by test pattern (triangular wave)

启用则将来自ADC的数据用三角波代替

# options: YES, NO

TEST_PATTERN NO

# WRITE_REGISTER: generic write register access. This command allows the user to have a direct write access

通用写入寄存器访问权限，该命令允许直接在寄存器中写入值，

address是寄存器的十六进制地址偏移量（16位值）;

data是要写入寄存器的数据（16位或32位值）;

mask是数据写入的位掩码（16或32位值）：只修改掩码中1的位。

# to the registers of the board. NOTE: all the direct write accesses are executed AFTER the other settings,

所有读写需设置后进行

# thus it might happen that the direct write overwrites a specific setting.

可能会发生直接覆盖写入特殊设置的情况

# To avoid this use the right “MASK”.

为避免这种情况，请使用正确的“MASK”。

# Syntax: WRITE_REGISTER ADDRESS DATA MASK, where ADDRESS is the address offset of the register (16 bit hex), DATA

寄存器地址偏移量（16位16进制）

# is the value being written (32 bit hex) and MASK is the bitmask to be used for DATA masking.

写入值（32位16进制），MASK用户屏蔽数据位掩码

# Example: Set only bit [8] of register 1080 to 1, leaving the other bits to their previous value

将1080的位【8】设置为1，则将其他位保留为原先的值

# WRITE_REGISTER 1080 0100 0100

# Example: Set only bit [8] of register 1080 to 0, leaving the other bits to their previous value

# WRITE_REGISTER 1080 0000 0100

# Example: Set register 1080 to the value of 0x45:

# WRITE_REGISTER 1080 45 FFFFFFFF

# —————————————————————-

# Individual Settings

# —————————————————————-

# The following setting are usually applied on channel by channel

# basis; however, you can put them also in the [COMMON] section in

# order to apply them to all the channels.

# —————————————————————-

# ENABLE_INPUT: enable/disable one group of channels

启用/禁用一组通道

# options: YES, NO

ENABLE_INPUT NO

#BASELINE_LEVEL: baseline position in percent of the Full Scale.

基线位置，以满量程的百分比表示

# The baseline shift is the same for all channels in the group

组中所有通道的基线偏移相同

# POSITIVE PULSE POLARITY (Full Scale = from 0 to + Vpp)

# 0: analog input dynamic range = from 0 to +Vpp

# 50: analog input dynamic range = from +Vpp/2 to +Vpp

# 100: analog input dynamic range = null (usually not used)*

# NEGATIVE PULSE POLARITY (Full Scale = from -Vpp to 0)

# 0: analog input dynamic range = from -Vpp to 0

# 50: analog input dynamic range = from -Vpp/2 to 0

# 100: analog input dynamic range = null (usually not used)*

#

# options: 0 to 100

BASELINE_LEVEL 50

# TRIGGER_THRESHOLD: threshold for the channel auto trigger (ADC counts)

通道自动触发的阈值（ADC计数）

# options 0 to 2^N-1 (N=Number of bit of the ADC)

# *if DC_OFFSET is used the threshold is absolute*

如果启用DC-OFFSET 则阈值是绝对值

# *if BASELINE_SHIFT is used the threshold is relative to the baseline of the first channel in the group*:

如果启用BASELINE-SHIFT 则阈值是相对于组中第一个通道的基线

# POSITIVE PULSE POLARITY: threshold = baseline + TRIGGER_THRESHOLD

# NEGATIVE PULSE POLARITY: threshold = baseline – TRIGGER_THRESHOLD

#

TRIGGER_THRESHOLD 100

# CHANNEL_TRIGGER: channel auto trigger settings. When enabled, the ch. auto trg. can be either

通道自动触发设置

# propagated (ACQUISITION_AND_TRGOUT) or not (ACQUISITION_ONLY) through the TRGOUT

# options: DISABLED, ACQUISITION_ONLY, ACQUISITION_AND_TRGOUT, TRGOUT_ONLY

CHANNEL_TRIGGER ACQUISITION_ONLY

# GROUP_TRG_ENABLE_MASK: channels are grouped 8 by 8; one group of 8 channels has a common trigger that is generated as

频道按8X8分组，一组8个通道有公共触发器

# the OR of the self trigger of the channels in the group that are enabled by this mask.

启用组中自出发的或门

# options: 0 to FF

#In the following, you can see the use of some individual settings to:

# -enable group [0]

# -position the baseline to 10% of the full scale, to use the input dynamic range in a better way

# -set the trigger threshold of group [0] to 50 LSB (relative to the baseline position)

# -enable self trigger for all channels of group [0]

[0]

ENABLE_INPUT YES

BASELINE_LEVEL 10

TRIGGER_THRESHOLD 50

GROUP_TRG_ENABLE_MASK FF

[1]

[2]

[3]

[4]

[5]

[6]

[7]

如需对各通道进行设置，请在[n]下添加参数。