Previous

Next

Configuration for Debug and Release Builds

Typically, the RTTarget-32 Debug Monitor will be resident on the target computer during the development phase of a project to allow downloading and source level debugging. On the other hand, the final configuration will probably require including boot code instead.

RTLoc's preprocessor can be used to easily switch between these configurations without the need to edit any configuration files.

Suppose we have the following configuration files to build the Monitor and program TestProg to run on a PC, booted from disk:

Hardware.cfg:

Region  NullPage    0     4k  RAM 
Region  LowMem      4k  636k  RAM 
Region  VideoM  B0000h    4k  Device  ReadWrite 
Region  VideoC  B8000h    4k  Device  ReadWrite 
Region  HighMem     1M    3M  RAM 

#ifdef BOOT 
 Locate  BootCode    Biosboot.exe  LowMem 
 Locate  BootData    SystemData    LowMem 
 Locate  DiskBuffer  Buffer        LowMem 
#else 
 Reserve Monitor 
#endif 

BOOTFLAGS  BF_NO_FPU 
VideoRAM   VideoC 
COMPort    COM1  115200

Monitor.cfg:

Locate  Section     CODE       LowMem  1 
Locate  Header      Monitor    LowMem  0   4 
Locate  Section     DATA       LowMem  2 
Locate  Stack       Stack      LowMem  1k  4 

Locate  PageTable   PageTable  LowMem 
Locate  DecompCode  Expand     LowMem 
Locate  DecompData  ExBuffer   LowMem 

Locate  Copy        CODE       LowMem 
Locate  Copy        DATA       LowMem 
Locate  Copy        Pages      LowMem

Testprog.cfg:

Virtual ProgMem   4M 
Virtual StackMem  5M 
Virtual HeapMem   6M 
FillRAM HeapMem 

Locate  Header      TestProg  LowMem 
Locate  PageTable   Paging    LowMem 

Locate  NTSection   CODE      ProgMem->HighMem 
Locate  NTSection   DATA      ProgMem->LowMem 
Locate  Stack       Stack     StackMem->HighMem  16k 
Locate  Heap        Heap      HeapMem 

Locate  DecompCode  Expand    LowMem 
Locate  DecompData  ExBuffer  LowMem 

Locate  Copy        CODE      LowMem 
Locate  Copy        DATA      LowMem 
Locate  Copy        Paging    LowMem

Now you can build the Monitor, TestProg for debugging, and TestProg's release version with the following commands:

RTLoc -DBOOT Monitor  Hardware.cfg Monitor.cfg 

RTLoc        TestProg Hardware.cfg TestProg.cfg 

RTLoc -DBOOT TestProg Hardware.cfg TestProg.cfg

Advanced Topics

Avoid Repeated Downloads

Using Data Compression