RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
581
Ctrl Command read_image_eth
Function Standalone Functionality: Reads out data for automatic booting from the NAND Memory
and saves it as a binary file on the PC.
Prerequisite RTC6 Software Package V1.7.0 and BIOS-ETH 26.
Call
Result = read_image_eth( Name )
Parameters
Name
Name of the binary file.
As a pointer to a \0-terminated ANSI string.
Result
Result
Error code.
As an unsigned 32-bit value.
Value Description
0 No error.
1 No RTC6 Ethernet Board.
2 Empty string has been specified as file name.
3 Access denied.
4 RTC6 Ethernet Board is BUSY list execution status.
5 Timeout error (RTC6 Ethernet Board does not respond).
6 File cannot be opened.
7 Ethernet error, see eth_get_last_error.
8 NAND Memory error.
9 Aborted, see eth_get_last_error.
Comments • read_image_eth is not executed (get_last_error return code
RTC6_BUSY
), if:
– the BUSY list execution status is set
– the INTERNAL-BUSY list execution status is set
• If the
Name
cannot be opened, a get_last_error return code
RTC6_PARAM_ERROR
is
generated.
• The content of an already existing binary file is deleted.
• During the execution of read_image_eth the 10 µs clock cycle of the DSP is
interrupted for up to 2 minutes.
• read_image_eth is only allowed with RTC6 Ethernet Boards.
Otherwise, a get_last_error return code
RTC6_TYPE_REJECTED
is generated.
• See Chapter 16.7 ”Standalone Functionality”, page 908.
RTC4RTC6 New command.
RTC5RTC6 New command.
Version info Available as of DLL 618, OUT 618, RBF 623.
References write_image_eth, store_program
To Next Page
Loading...