Home |
RTTarget-32 Programming Manual Running Win32 Programs without Win32 Locate Command Running a Program on the Target Compiling and Linking with On Time RTOS-32 |
Locate CommandThe Locate command maps a program entity to one of the memory regions of the target hardware. The general syntax is: Locate Entity Name Region[->PRegion] [Size [Align [Access [Alloc]]] ParametersEntitySpecifies what kind of entity is to be located. All possible values of Entity are discussed in the following sections. NameSpecifies the name of the entity. For some entities, the name can have a special meaning (see the sections on different entities below). RegionSpecifies in which region the entity will be mapped. Region must have been defined in a previous Region or Virtual command. If Region references a virtual region, the name of the physical region for the entity must also be specified as parameter ->PRegion. There must be no spaces between parameters Region and ->PRegion. SizeSpecifies how many bytes RTLoc should allocate to the entity. This parameter is optional, since RTLoc can automatically determine the size for most entities; specify it only to override RTLoc's defaults. If zero is given, RTLoc will try to determine the size automatically. AlignCan be used to override the default alignment for this particular entity. If zero is specified, the default alignment specified with the Align command is used. AccessSpecifies the type of access you want RTLoc to assign to this entity. Supported values are: Assign, NoAccess, SysRead, System, ReadOnly, ReadWrite (see section Region Command for details). The default is Assign which instructs RTLoc to select the appropriate access value automatically. AllocSupports values AllocDefault, BottomUp, and TopDown. If it is not specified, AllocDefault is assumed which in turn causes discardable entities not covered by any HEX or BIN file to be allocated TopDown and all others BottomUp. BottomUp allocated entities will receive the lowest available address in the specified region while TopDown entities will receive the highest available address. All supported values for parameter Entity are discussed in the following sections.
|