beautypg.com

20 mac_downloadsimpleiqfirmware – ElmoMC Multi-Axis Motion Controller-Maestro User Manual

Page 122

background image

LPCTSTR cszLocalPath

Path to log file on desktop computer.

Return Value:

int - Error value:

0

OK,

> 0 communication error codes:

1 The API library is not initialized;
2 Zero Communication Handle;
3 Bad Communication Handle;
4 Unable to create interface ITNElmoPublic;
5 Upload Log failed;

Use MAC_GetLastError to retrieve the error string.

Sample:

int retVal = MAC_UploadLog( hCom, szPath );

6.20 MAC_DownloadSimpleIQFirmware

This function enables the user to download SimpleIQ firmware file to Multi-axes controller.
After this Multi-axes controller can update firmware for SimpleIQ controllers with using
CAN connection. The firmware update process begins at the function, but process execution
status can be received by command FirmwareDownloadStatus.

Syntax:

int MAC_DownloadSimpleIQFirmware

(

COMMUNICATION_HANDLE

hCommunication,

LPCTSTR

cszObjects,

LPCTSTR

cszLocalPath);

Input Parameters:

COMMUNICATION_HANDLE hCommunication

Multi-axes supervisor communication handle.

LPCTSTR cszObjects

Motion object list.
Format:
-

"name1 name2 ... nameN" - object names with

space delimiter;
- "*" - change firmware for all Elmo nodes;

LPCTSTR cszLocalPath

Path to firmware file on desktop computer.

Return Value:

int - Error value:

0

OK,

> 0 communication error codes:

1 The API library is not initialized;
2 Zero Communication Handle;
3 Bad Communication Handle;

Maestro

Software Manual

The Maestro API

MAN-MASSW (Ver. Q)

6-15