跳转至

GTN_SetWaveformPairAhead

指令原型：

GT_API GTN_SetWaveformPairAhead(short core,short index,TRectangleWaveDutyMode *pRectWave,TStageWavePrm *pStageWave,short loopCount)

指令类型：

立即指令，调用后立即生效。

指令说明：

设置波形控制两路输出提前模式波形参数。

指令参数说明：

core 核号，正整数，取值范围请参照核号参数范围一栏。
index 波形控制索引，取值范围：[1,4]。
pRectWave 矩形波波形占空比模式参数结构体指针。详情说明请参照TRectangleWaveDutyMode
TRectangleWaveDutyMode 
typedef struct
{
    short startMode;
    short pad[3];
    double voltage;
    double frequency;
    double dutyRatio;
} TRectangleWaveDutyMode;
startMode：矩形波输出模式，定义启动输出后的行为。 
RECTANGLE_WAVE_START_MODE_LOW_LEVEL(0)：矩形波输出模式，启动输出后先输出低电平，再输出高电平。
RECTANGLE_WAVE_START_MODE_HIGH_LEVEL(1)：矩形波输出模式，启动输出后先输出高电平，再输出低电平。
pad：保留参数，必须设置成0。
voltage：矩形波输出高电平对应的电压值，取值范围：(0,10]，单位：V。
frequency：矩形波输出频率，取值范围：(0,100)，单位：kHz。
dutyRatio：矩形波输出占空比，即低电平时间占总周期时间的比例，取值范围：(0,100)，单位：%。
pStageWave 矩形波波形占空比模式参数结构体指针。详情说明请参照TStageWavePrm
TStageWavePrm 
typedef struct
{
    short stepCount;
    short pad[3];
    double voltageStart;
    double voltageEnd;
    double aheadTime;
} TStageWavePrm;
stepCount：台阶波输出台阶个数，取值范围：[1,4000]。
pad：保留参数，必须设置成0。
voltageStart：台阶波输出起始电压值，取值范围：(0,10]，单位：V。
voltageEnd：台阶波输出终点电压值，取值范围：(0,10]，单位：V。
aheadTime：台阶波达到目标台阶值的提前时间，取值范围与矩形波宽度相关，单位：ms。
loopCount 波形控制循环次数，取值范围：[1,32767]。

指令返回值： 

17053：波形控制索引index参数错误。
17055：核号core参数错误。
17061：循环次数loopCount参数错误。
17100：波形控制能量输出结构体TRectangleWaveDutyMode，pad参数错误，必须为0。
17100：波形控制能量输出结构体TStageWavePrm，pad参数错误，必须为0。
17510：矩形波结构体TRectangleWaveDutyMode成员变量startMode参数错误。
17511：矩形波结构体TRectangleWaveDutyMode成员变量voltage参数错误。
17515：矩形波结构体TRectangleWaveDutyMode成员变量frequency参数错误。
17516：矩形波结构体TRectangleWaveDutyMode成员变量dutyRatio参数错误。
17517：矩形波结构体TStageWavePrm成员变量stepCount参数错误。
17518：矩形波结构体TStageWavePrm成员变量voltageStart参数错误。
17519：矩形波结构体TStageWavePrm成员变量voltageEnd参数错误。
17520：矩形波结构体TStageWavePrm成员变量aheadTime参数错误。
17521：台阶波单个台阶增量过小，必须大于0.0003V。
17522：台阶波爬台阶时间小于10us。
11059：波形功能已经使能，不允许重新下载数据。

其他返回值请参照通用返回值说明。

指令示例：

波形控制立即输出例程

注意事项：