Previous

Next

Function RTLoadRTBFile

The use of this function is deprecated. Please use .bin files instead as demonstarted by demo program FTPLoader.

Function RTLoadRTBFile reads an .RTB file produced by RTLoc and copies all entities it contains to their respective target addresses:

typedef void * (RTTAPI * RTDataCallback)(void * dest, 
                                         const void * src, 
                                         unsigned int n); 
RTAppHeader * RTLoadRTBFile(const char * Name, 
                            RTDataCallback DataCallback);

Parameters

Name

The file name of the .RTB file to process (note that RTFiles-32 is required to read disk files instead of RAM/ROM files).

DataCallback

Can point to a function which RTLoadRTBFile will call to transfer data to the target. Supply a function if special processing is required (e.g., programming the data into flash memory, etc.). If not specified, RTLoadRTBFile will simply memcpy the data directly to the addresses given in the .RTB file.

return value

The return value is a pointer to the application's header or NULL if the function fails.

Note that this function is not guaranteed to correctly read .RTB files produced by different versions of RTTarget-32. If cross version compatibility is required, use BIN files instead of .RTB files to transfer On Time RTOS-32 program images.

Function RTRunProgram