168/317
6 - STMicroelectronics Programming Tools
This choice allows you to download the executable program to virtually any commercial
EPROM programmer. When using the WGDB7 debugger, the program is loaded into the de-
bugger using either the Intel or Motorola format.
6.2.3 The back-annotation pass of the assembler
When the WGDB7 debugger is used, to work properly, it expects the listing files to be fully
documented with the actual absolute addresses.
We have seen above that the listing file, when a module uses external references, does not
give the absolute addresses, but temporary values instead that are marked with a
R, waiting
for resolution in the linking process. This is not suitable for the debugger.
To solve this problem, the assembler provides a back-annotation mode for the listing files.
In this mode, once the linking is done, all the source files must be re-assembled using the op-
tion
-FI<name of map file>.MAP
This option forces the assembler to take the map file generated by the linker as the source of
absolute addresses, and to correct the relocatable addresses with the final absolute ad-
dresses. The result is a listing file where all the addresses are absolute. The debugger can
then display the source text and the corresponding code with the actual addresses in a
window.
This extra assembler pass is not required when using another debugger, for the other debug-
gers perform the external resolution themselves using the relocatable listing files and the map
file generated by the linker.
6.3 INSTALLING WINEDIT AND THE SOFTWARE TOOLS
6.3.1 WinEdit text editor
WinEdit is a text editor that is meant for use by anybody who has programs to write in any lan-
guage. It allows the user to configure it to fit his needs when he works on a given project with
given tools. This paragraph will not fully describe this text editor firstly because it comes with
its on-line help that is self-explanatory, and also because editing with a text editor, unlike a
word processor, is straightforward, at least for a user familiar with the Windows environment.
This section will thus only cover how to configure of WinEdit for working with the STMicroelec-
tronics tools.
6.3.1.1 Installing WinEdit
WinEditconsistsofasetofcompressedfilesandaSETUP.EXEfile.Tostarttheinstallation
process, locate this file using the explorer, for example, and double-click on it. The first choice