GTN_ProgramControllerFirmware¶

指令原型：

GT_API GTN_ProgramControllerFirmware(short core,char *pFileName,TProgramStatus *pStatus)

指令类型：

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

指令说明：

烧录控制器的在线升级文件。

指令参数说明：

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

pFileName 在线升级文件文件名

pStatus

烧录状态结构体。详情说明请参照TProgramStatus

TProgramStatus

typedef struct
{
    int16_t version;
    int16_t programType;
    int16_t programStatus;
    int16_t programPercent;
    int16_t errorType;
    int16_t errorCode;
    int16_t errorSubCode;
    int16_t reserve[25];
}TProgramStatus;

version：烧录的版本。
programType：烧录文件类型。
programStatus：烧录状态。 PROGRAM_STATUS_SUCCESS(0)：烧录成功 PROGRAM_STATUS_ERROR(1)：烧录失败 PROGRAM_STATUS_VERIFY(2)：校验在线升级文件中 PROGRAM_STATUS_DOWNLOAD(3)：下载在线升级文件中 PROGRAM_STATUS_ERASE(4)：擦除flash存储信息中 PROGRAM_STATUS_PROGRAM(5)：烧录在线升级文件中 PROGRAM_STATUS_COMPARE(6)：比对在线升级文件中
programPercent：烧录进度百分比。
errorType：错误类型。
PROGRAM_ERROR_TYPE_VERIFY(2)：校验报错 PROGRAM_ERROR_TYPE_DOWNLOAD(3)：下载报错 PROGRAM_ERROR_TYPE_PROGRAM(4)：烧录报错 PROGRAM_ERROR_TYPE_COMPARE(5)：比对报错 errorCode：错误代码。
errorSubCode：错误子代码。
reserve：保留值，为0。

指令返回值：

请参照通用返回值说明。

详细错误信息请查看TProgramStatus中error信息。其中相关报错组合信息如下：

errorType	errorCode	errorSubCode	错误原因。
PROGRAM_ERROR_TYPE_VERIFY(2)	1	-	校验错误类型1。
PROGRAM_ERROR_TYPE_VERIFY(2)	2	-	校验错误类型2。
PROGRAM_ERROR_TYPE_DOWNLOAD(3)	PROGRAM_ERROR_DOWNLOAD_GET_MCINFO(1)	返回值	下载过程错误，获取卡功能信息报错，报错值为errorSubCode。
	PROGRAM_ERROR_DOWNLOAD_WRITE_ENABLE(2)	返回值	下载过程错误，解开写保护错误，报错值为errorSubCode。
	PROGRAM_ERROR_DOWNLOAD_WRITE_DISENABLE(3)	返回值	下载过程错误，打开写保护错误，报错值为errorSubCode。
	PROGRAM_ERROR_DOWNLOAD_FILE_NULL(4)	-	下载过程错误，文件指针为空。
	PROGRAM_ERROR_DOWNLOAD_FILE_CRC_CHECK(5)	-	下载过程错误，文件校验和检查错误，文件可能被篡改。
	PROGRAM_ERROR_DOWNLOAD_FLASH_SELECT(6)	返回值	下载过程错误，flash片选函数报错，报错值为errorSubCode。
	PROGRAM_ERROR_DOWNLOAD_SDRAM_CLEAR(7)	返回值	下载过程错误，sdram清除函数报错，报错值为errorSubCode。
	PROGRAM_ERROR_DOWNLOAD_BLOCK_ERASE(8)	返回值	下载过程错误，flash片擦除报错，报错值为errorSubCode。
	PROGRAM_ERROR_DOWNLOAD_FLASH_PROGRAM(9)	返回值	下载过程错误，在线升级数据下载报错，报错值为errorSubCode。
PROGRAM_ERROR_TYPE_PROGRAM(4)	返回值	-	烧录过程错误，烧录函数报错，报错值为errorCode。
PROGRAM_ERROR_TYPE_COMPARE(5)	PROGRAM_ERROR_COMPARE_FLASH_READ(1)	返回值	比对过程错误，读取flash函数报错，报错值为errorCode。
PROGRAM_ERROR_TYPE_COMPARE(5)	PROGRAM_ERROR_COMPARE_DATA_COMPARE(2)	偏移位置	比对过程错误，比对错误，比对错误数据地址位于errorSubCode处。