Download CubeSuite+ V1.00.00 Integrated Development Environment User`s

CubeSuite+ Ver.1.00.00
APPENDIX B COMMAND REFERENCE
_rcopy4
[Overview]
- Copies default data or RAM textNote (4 byte).
Note Data section with default value which is to be allocated to RAM, and text section for internal RAM.
[Format]
int
_rcopy4(&label, number)
unsigned long
label;
long
number;
[Description]
- _rcopy4(&label, number) copies the default value data of section number number to be copied, or text to be
allocated to RAM, to the RAM area 4 byte at a time, based on the information in the rompsec section allocated
starting at the address following the address indicated by label. If -1 is specified as number, all sections in the
rompsec section are copied. Section number number is a positive number that starts from 1.
- By default, sections are allocated in the order in which they appear in the input file. If sections to be allocated to
the rompsec section are specified by the "-p" or "-t" option of the ROMization processor, they are allocated in the
order in which they are specified.
- With CubeSuite+, on the Property panel, from the [ROMization Process Options] tab, in the [Section List] category,
set the [Output ROMization section file] property to [Yes]. A C source header file that makes "number" and "label"
correspond to each other by #define is generated, and number can be specified by a label name.
- See "B.4.5 Example of using copy function" for specific examples.
[Return value]
0
Normal completion (if copied correctly)
-1
Abnormal termination (if not copied correctly)
[Cautions]
- Data is not copied if the address indicated by label is not at the start of the rompsec section.
- _rcopy4 copies data in accordance with the information generated by the ROMization processor.
When executing _rcopy4, it is not possible to add an offset to the destination address.
- No data is copied if data may be overwritten as a result of copying.
- Specify a global label having an absolute value or an absolute address as the first argument of _rcopy4, label. If
any other value or address is specified, the result is not guaranteed.
R20UT0557EJ0100 Rev.1.00
Apr 01, 2011
Page 594 of 782