20 mac_downloadsimpleiqfirmware – ElmoMC Multi-Axis Motion Controller-Maestro User Manual
Page 122
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