Python API接口¶
软件定义了一系列的API接口，可以在python脚本中使用这些API接口，实现软件操作的自动化。
使用方法¶
1import gcm
2gcm.start()
API¶
start¶
开始测试
参数
无参数
返回值
无返回值
pause¶
暂停测试
参数
无参数
返回值
无返回值
stop¶
停止测试
参数
无参数
返回值
无返回值
add_device¶
向试验中添加测试模块
参数
设备名称，字符串
设备序列号，整数
IP地址，字符串
返回值
无返回值
save_to_file¶
将试验保存到文件中
参数
文件名，字符串
返回值
无返回值
set_global_variable¶
设置全局变量
参数
变量名，字符串
变量值，字符串
返回值
无返回值
create_default_signal¶
根据添加设备创建默认信号量
参数
无参数
返回值
无返回值
get_path_name¶
获取当前试验文件路径及名称
参数
无参数
返回值
试验文件的路径及名称，字符串
add_layout¶
向试验中添加显示模板
参数
显示模板文件名称，字符串
返回值
无返回值
active_layout¶
将显示模板设置为默认显示模板
参数
默认显示模板文件名称，字符串
返回值
无返回值
set_script_name_list¶
向试验中添加脚本
参数
脚本文件名，字符串
返回值
无返回值
dev_get_parameter¶
获取设备参数值
参数
设备名称，字符串
设备序列号，整数
参数名，字符串
返回值
参数值，（整数，浮点数，字符串，元组）
dev_set_parameter¶
设置设备参数值
参数
设备名称，字符串
设备序列号，整数
参数名，字符串
参数值，（整数，浮点数，字符串，元组）
返回值
无返回值
dev_get_setting¶
获取设备所有的参数配置，以xml格式返回
参数
设备名称，字符串
设备序列号，整数
返回值
设备所有参数，xml格式的字符串
dev_write_to_flash¶
控制设备将当前参数写入Flash，实现掉电不丢失
参数
设备名称，字符串
设备序列号，整数
返回值
无返回值
dev_upload_setting¶
控制设备上传所有参数
参数
设备名称，字符串
设备序列号，整数
返回值
无返回值
dev_enable_calibration¶
控制设备进入标定模式，在此模式下不会对采集数据根据标定数据进行修正
参数
设备名称，字符串
设备序列号，整数
返回值
无返回值
dev_disable_calibration¶
控制设备退出标定模式，对采集数据根据标定数据进行修正
参数
设备名称，字符串
设备序列号，整数
返回值
无返回值
dev_set_channel_parameter¶
控制设备设置通道配置参数，例如输入信号类型，输入信号量程
参数
设备名称，字符串
设备序列号，整数
通道号，整数，从1开始
通道参数名称，字符串
通道参数数值，字符串
返回值
无返回值
参数名称 |
参数值 |
|---|---|
function |
func_volt_n10_p10 |
func_iepe |
|
func_curr |
|
func_rtd |
|
func_tc |
|
func_bridge |
|
func_cal_v_1d4 |
|
func_cal_v_2 |
|
func_cal_v_8 |
|
func_cal_curr |
|
func_cal_iepe |
|
func_cal_diff_x1 |
|
func_cal_diff_x2 |
|
func_cal_diff_x10 |
|
func_cal_diff_x50 |
|
func_cal_diff_x100 |
|
func_cal_rtd |
|
func_cal_amb |
|
func_cal_tc |
|
voltage_range |
range_n10v_p10v |
range_n1v_p1v |
|
range_n100mv_p100mv |
|
rtd_type |
rtd_2l_4l_pt100 |
rtd_3l_pt100 |
|
rtd_2l_4l_pt1000 |
|
rtd_3l_pt1000 |
|
tc_type |
tc_k |
tc_t |
|
tc_j |
|
bridge_type |
bridge_2x |
bridge_10x |
|
bridge_50x |
|
bridge_100x |
es1501_set_voltage¶
控制ES1501输出设定电压(此电压是标称电压，实际输出电压可能与此电压不同)
参数
通道号，整数
电压值，浮点数
返回值
无返回值
es1501_get_voltage¶
获取ES1501当前输出实际电压值
参数
通道号，整数
电压值，浮点数
返回值
实际输出电压值，对应标称电压值的实际电压值，浮点数
sa3101_set_calibration¶
将标定数据写入到SA3101中
参数
设备序列号，整数
通道号，整数
系数k，浮点数
系数b，浮点数
返回值
无返回值
hw3021_set_calibration¶
将标定数据写入到3021中
参数
设备序列号，整数
通道号，整数
测量范围，整数
系数k，浮点数
系数b，浮点数
返回值
无返回值
hw3021_set_signal_type¶
设置3021通道的输入信号类型
参数
设备序列号，整数
通道号，整数
信号类型，字符串(Voltage, IEPE, Current)
返回值
无返回值
hw3021_set_voltage_range¶
设置3021通道的输入电压量程
参数
设备序列号，整数
通道号，整数
量程，字符串([-10V...+10V], [-1V...+1V], [-100mV...+100mV])
返回值
无返回值
hw3027_set_calibration¶
将标定数据写入到3027中
参数
设备序列号，整数
通道号，整数
测量范围，整数
系数k，浮点数
系数b，浮点数
返回值
无返回值
ui_plot¶
画曲线图
参数
数据系列，元组
返回值
无返回值
ui_dialog¶
弹出对话框
参数
对话框标题，字符串
对话框文本，字符串
返回值
无返回值
get_data¶
获取最新的内部数据，包括采集数据、计算结果等
参数
数据名称，字符串
返回值
元组(时间戳，数据，坐标数据)
get_axis_name¶
获取数据名称对应的坐标轴名称
参数
数据名称，字符串
返回值
坐标轴名称，字符串
set_data¶
将数据写入到软件中
参数
数据名称，字符串
时间戳，64位整数
坐标轴名称，字符串
数据值，元组
数据类型，整数。可选值如下，多个值可以用 或 组合
DT_CHAR, 字符串
DT_INT, 整数
DT_FLOAT, 浮点数
DT_VALUE, 数值
DT_DICT, 字典
DT_CURVE, 一维数据组
DT_MAP, 二维数据组
DT_CA, 基于角度数据
DT_TIME, 基于时间数据
DT_FREQ, 基于频率数据
返回值
无返回值
sleep¶
休眠设定时间
参数
休眠时间，整数，单位ms
返回值
无返回值