GTN_GetLaserFollowPro¶

指令原型：

GT_API GTN_GetLaserFollowPro(short core,short laserChannel,TLaserFollowPro *pLaserFollowPro)

指令类型：

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

指令说明：

读取激光能量跟随信息。

指令参数说明：

core 核号，正整数，取值范围请参照核号参数范围一栏。

laserChannel 激光通道号，整数，取值范围请参照激光通道号参数范围一栏。

pLaserFollowPro

指令流信息结构体指针。详情说明请参照TLaserFollowPro

TLaserFollowPro

typedef struct
{
    short enable;
    short mode;
    short errorCode;
    short returnValue;

    double power;
    double powerAnother;

    TLaserFollowPrmPro ratioPrm;
    TLaserFollowTablePrmPro tablePrm;
    TLaserFollowDuoTablePrmPro duoTablePrm;
}TLaserFollowPro;

enable：激光能量跟随使能状态。

0：激光能量跟随使能
1：激光能量跟随关闭

mode：激光能量跟随模式。

LASER_FOLLOW_MODE_NONE(0)：未设置能量跟随。
LASER_FOLLOW_MODE_RATIO(1)：按比例系数进行能量跟随。
LASER_FOLLOW_MODE_TABLE(2)：按能量跟随表进行能量跟随。
LASER_FOLLOW_MODE_DUO_TABLE(3)：双表能量跟随。

errorCode：激光能量跟随模式。

LASER_FOLLOW_PRO_ERROR_CODE_NONE(0)：无错误。
LASER_FOLLOW_PRO_ERROR_CODE_MODE(1)：模式错误。
LASER_FOLLOW_PRO_ERROR_CODE_CALCULATE_POWER(2)：计算能量值出错。
LASER_FOLLOW_PRO_ERROR_CODE_SET_PWM_DUTY(3)：设置pwm占空比出错。
LASER_FOLLOW_PRO_ERROR_CODE_SET_PWM_FREQUENCY(4)：设置pwm频率出错。
LASER_FOLLOW_PRO_ERROR_CODE_SET_PWM_PULSE_WIDTH(5)：设置pwm频率出错。
LASER_FOLLOW_PRO_ERROR_CODE_SET_VOLTAGE(6)：设置模拟量出错。
LASER_FOLLOW_PRO_ERROR_CODE_SET_PARALLEL(7)：设置并口能量出错。
LASER_FOLLOW_PRO_ERROR_CODE_POWER_TYPE(8)：能量类型错误。

returnValue：能量跟随整个功能出错地方的返回值。
power：当前周期实际输出能量值。
powerAnother：同时调整两种能量时的另一种能量值。
ratioPrm：激光能量跟随系数跟随模式参数。详情说明请参照 [TLaserFollowPrmPro](TLaserFollowPrmPro.md) ???+ note "TLaserFollowPrmPro"

typedef struct
{
    short powerType;
    short group;
    short source;
    short coordSystem;
    double ratio;
    double minPower;
    double maxPower;
}TLaserFollowPrmPro;

powerType：激光能量跟随的能量信号类型。

LASER_FOLLOW_POWER_TYPE_DUTY(0)：占空比。
LASER_FOLLOW_POWER_TYPE_FREQUENCY(1)：频率。
LASER_FOLLOW_POWER_TYPE_PULSE_WIDTH(2)：脉宽。
LASER_FOLLOW_POWER_TYPE_VOLTAGE(3)：模拟量。
LASER_FOLLOW_POWER_TYPE_PARALLEL(4)：并口。

group： group号，正整数，取值范围请参照group号参数范围一栏。
source：激光能量跟随合成速度源。

LASER_FOLLOW_SYNCH_VEL_SOURCE_PROFILE(0)：规划器合成速度。
LASER_FOLLOW_SYNCH_VEL_SOURCE_ENCODER(1)：编码器合成速度。

coordSystem：激光能量跟随合成速度的坐标系。

COORD_SYSTEM_PCS(0)：PCS坐标系。
COORD_SYSTEM_MCS(1)：MCS坐标系。
COORD_SYSTEM_ACS(2)：ACS坐标系。

ratio：激光能量跟随比例系数。
minPower：激光能量跟随能量最小限制值。
maxPower：激光能量跟随能量最大限制值。
（1）当能量跟随为占空比时，则输出能量限制的取值范围：[0，100]，单位：%；
（2）如果能量跟随为频率模式，则输出能量限制的取值范围：[0,1562.5]，单位：kHz；
（3）如果能量跟随为脉宽模式，则输出能量限制的取值范围：[0,65535]，单位：us;
（4）当能量跟随信号为模拟量时，则输出能量限制的取值范围：[0,10]，单位：V。
（5）当能量跟随信号为并口时，则输出能量限制的取值范围：[0.255]。
（6）激光能量跟随实际输出能量最小值，以指令GTN_SetLaserPwmPrmPro(能量跟随信号为PWM时)、指令GTN_SetLaserVoltagePrmPro(能量跟随信号为模拟量时)、指令GTN_SetLaserParallelPrmPro(能量跟随信号为并口时)和指令GTN_SetLaserFollowPrmPro中最小能量较大值为基准。 tablePrm：激光能量跟随表模式参数。详情说明请参照[TLaserFollowTablePrmPro](TLaserFollowTablePrmPro.md) ???+ note "TLaserFollowTablePrmPro"

typedef struct
{
    short powerType;
    short group;
    short source;
    short coordSystem;
    short tableId;
    short pad[3];
    double minPower;
    double maxPower;
}TLaserFollowTablePrmPro;

powerType：激光能量跟随的能量信号类型。

LASER_FOLLOW_POWER_TYPE_DUTY(0)：占空比。
LASER_FOLLOW_POWER_TYPE_FREQUENCY(1)：频率。
LASER_FOLLOW_POWER_TYPE_PULSE_WIDTH(2)：脉宽。
LASER_FOLLOW_POWER_TYPE_VOLTAGE(3)：模拟量。
LASER_FOLLOW_POWER_TYPE_PARALLEL(4)：并口。

group： --8<-- "docs/附录/通用引用.md:group"
source：激光能量跟随合成速度源。

LASER_FOLLOW_SYNCH_VEL_SOURCE_PROFILE(0)：规划器合成速度。
LASER_FOLLOW_SYNCH_VEL_SOURCE_ENCODER(1)：编码器合成速度。

coordSystem：激光能量跟随合成速度的坐标系。

COORD_SYSTEM_PCS(0)：PCS坐标系
COORD_SYSTEM_MCS(1)：MCS坐标系
COORD_SYSTEM_ACS(2)：ACS坐标系

tableId：激光能量跟随表的表号，取值范围：[1,2]。
pad：保留参数，必须设置成0。
minPower：激光能量跟随能量最小限制值。
maxPower：激光能量跟随能量最大限制值。
（1）当能量跟随为占空比时，则输出能量限制的取值范围：[0，100]，单位：%。
（2）如果能量跟随为频率模式，则输出能量限制的取值范围：[0,1562.5]，单位：kHz。
（3）如果能量跟随为脉宽模式，则输出能量限制的取值范围：[0,65535]，单位：us;
（4）当能量跟随信号为模拟量时，则输出能量限制的取值范围：[0,10]，单位：V。
（5）当能量跟随信号为并口时，则输出能量限制的取值范围：[0.255]。
（6）激光能量跟随实际输出能量最小值，以指令GTN_SetLaserPwmPrmPro(能量跟随信号为PWM时)、指令GTN_SetLaserVoltagePrmPro(能量跟随信号为模拟量时)、指令GTN_SetLaserParallelPrmPro(能量跟随信号为并口时)和指令GTN_SetLaserFollowPrmPro中最小能量较大值为基准。 duoTablePrm：激光能量跟随双表跟随模式参数。详情说明请参照[TLaserFollowDuoTablePrmPro](TLaserFollowDuoTablePrmPro.md) ???+ note "TLaserFollowDuoTablePrmPro"

typedef struct
{
    short group;
    short source;
    short coordSystem;
    short dutyTableId;
    short frequencyTableId;
    short pad[3];
    double minDuty;
    double maxDuty;
    double minFrequency;
    double maxFrequency;
}TLaserFollowDuoTablePrmPro;

group：--8<-- "docs/附录/通用引用.md:group"
source：激光能量跟随合成速度源。

LASER_FOLLOW_SYNCH_VEL_SOURCE_PROFILE(0)：规划器合成速度
LASER_FOLLOW_SYNCH_VEL_SOURCE_ENCODER(1)：编码器合成速度。

coordSystem：激光能量跟随合成速度的坐标系。

COORD_SYSTEM_PCS(0)：PCS坐标系
COORD_SYSTEM_MCS(1)：MCS坐标系
COORD_SYSTEM_ACS(2)：ACS坐标系

dutyTableId：激光能量跟随占空比表的表号，取值范围：[1,2]。
frequencyTableId：激光能量跟随频率表的表号，取值范围：[1,2]。
pad：保留参数，必须设置成0。
minDuty：激光能量跟随占空比最小限制值，取值范围：[0,100]，单位：%。
maxDuty：激光能量跟随占空比最大限制值，取值范围：[0,100]，单位：%。
minFrequency：激光能量跟随频率最小限制值，取值范围：[0,1562.5]，单位：kHz。
maxFrequency：激光能量跟随频率最大限制值，取值范围：[0,1562.5]，单位：kHz。

指令返回值：

17053：激光通道号参数错误。
17055：核号参数错误。

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

指令示例：

注意事项：