RMCLink C++ Wrapper Class CRMCLink::WriteImageFromFile Method |
Loads the controller image from the specified file, writes it to the controller and applies it. By default, the image will be saved to flash and the controller will be restarted. The controller image file must have been created using the ReadImageToFile method. For saving and restoring the controller image using an array in memory instead of using a file, use the ReadImage and WriteImage methods. This method is only supported on the RMC75E, RMC150E, and RMC200 controllers.
C++ |
HRESULT WriteImageFromFile( UINT flags, LPCTSTR fileName ); |
flags
Options to use when applying the image. Refer to the RMCTools documentation on the Image Area for a current list of options. As of this writing, a single option has been defined. Specify zero (0) to use default options.
+0 |
Save Image to Flash, and Restart Controller to Apply |
+16 |
Apply Image Immediately and Save To Flash (not supported by RMC200) |
fileName
File name and path to load the controller image from.
Returns S_OK on success. Otherwise, an error code is returned. Possible error codes are listed below.
This method is synchronous, which means that it will not return until the write is completed, which may take several seconds. If this method is called on the main thread, then the application will likely be unresponsive until this method completes. For applications where this is not acceptable, this and other synchronous methods should be called from a worker thread, and may use the CancelRequest method to cancel an in progress request.
Member Name |
Description |
E_OUTOFMEMORY |
Out of memory. |
E_INVALIDARG |
The flags parameter has an unsupported value. |
RMCLINK_E_DISCONNECTING |
Link is being disconnected by another thread. |
RMCLINK_E_DISCONNECTED |
The link has not been connected. |
RMCLINK_E_SOCK_INTERNAL |
Internal socket error. |
RMCLINK_E_CANCELLED |
Operation cancelled by call to CancelRequest. |
RMCLINK_E_TIMEOUT |
Operation timed out. |
RMCLINK_E_SOCK_GRACEFUL_CLOSE |
TCP/IP connection closed by remote device. |
RMCLINK_E_SOCK_ERROR_RD |
Connection error while waiting for response from the remote device. |
RMCLINK_E_SOCK_INV_RD_LEN |
Connection error while waiting for response from the remote device. |
RMCLINK_E_SOCK_ERROR_WR |
Connection error while sending request to the remote device. |
RMCLINK_E_SOCK_INV_WR_LEN |
Connection error while sending request to the remote device. |
RMCLINK_E_CONN_BROKEN |
Connection broken. |
RMCLINK_E_PARTIAL_WRITE |
Unable to send full request to the remote device. |
RMCLINK_E_USB_SETTIMEOUT |
Internal USB driver error. |
RMCLINK_E_USB_OP_ABORT |
Unsuccessful transfer of data between the PC and the controller. Ensure that the physical connection between the PC and controller is still intact. |
RMCLINK_E_USB_DISCONNECT |
The controller appears to have been disconnected from the USB port. Ensure that the physical connection between the PC and controller is still intact. |
RMCLINK_E_NOT_SUPPORTED |
Operation not supported on this controller type. The controller must be an RMC75E, RMC150E, or RMC200 with firmware supporting the image read/write. |
RMCLINK_E_DL_CANT_RESET |
Unable to reset Image Area for download. |
RMCLINK_E_DL_FAILED |
Unable to download controller image. |
RMCLINK_E_BAD_IMAGE |
Image format is invalid. |
RMCLINK_E_APPLY_TIMEOUT |
Unable to download controller image. |
RMCLINK_E_APPLY_STATE |
Unexpected state encountered while applying image. |
RMCLINK_E_APPLY_RSTREQ |
Image not applied because restart required. |
RMCLINK_E_APPLY_FLASH |
Error writing to flash memory while applying image. |
RMCLINK_E_APPLY_NOTINRUN |
Image cannot be applied without restart while in RUN mode. |
RMCLINK_E_APPLY_WRONGHW |
Image not applied because of hardware mismatch. |
RMCLINK_E_FILE_NOT_FOUND |
Unable the find the specified file. |
RMCLINK_E_PATH_NOT_FOUND |
Unable the find the specified file path. Check that the drive and folder specified exist. |
RMCLINK_E_ACCESS_DENIED |
Access denied to the file or path. Verify that the file is not opened by another application and that you have access to the folder and file. |
RMCLINK_E_DRIVE_NOT_READY |
Removable drive not ready. Verify that media has been inserted into the removable drive. |
The following code example illustrates the use of the WriteImageFromFile method.
C++ |
#include <windows.h>
#include <stdio.h>
#include "RMCLink.h"
void main()
{
// In order to create COM objects, we must initialize the COM sub-system.
::CoInitialize(0);
// Create a new RMCLink object.
CRMCLink* pRMC = CRMCLink::CreateUSBLink(CRMCLink::dtRMC70, _T("7573091001"));
if ( pRMC != NULL )
{
// Establish the connection.
HRESULT hr = pRMC->Connect();
if ( SUCCEEDED(hr) )
{
hr = pRMC->WriteImageFromFile(0, _T("RMCImage.bin"));
if ( SUCCEEDED(hr) )
{
printf("Successfully applied controller image.");
} // Close the connection.
pRMC->Disconnect();
}
// Free the RMCLink object we created.
delete pRMC;
} // Release the COM sub-system.
::CoUninitialize();
}
|
See Also
CRMCLink Class | RMCLink C++ Wrapper Class | CRMCLink::ReadImageToFile Method | CRMCLink::ReadImage | CRMCLink::WriteImage
Copyright (c) 2024 Delta Computer Systems, Inc. dba Delta Motion