1. st7swex.exe Driver
2. README_C.TXT File Contents

README_C.TXT Driver File Contents (st7swex.exe)

***********************************************
*   NOTE CONCERNING THE ENVIRONMENT CONTENTS  *
***********************************************


This environment holds two directories:

        ENVIRO and DOC_C

ENVIRO: The files from this directory are
        examples of how to create and how
        to manage a project using the Hiware
        C tool chain.
        All the files can be compiled as examples.
        Check the hierachy given for this project as
        it helps you if you do so for your own application.

        The files are not really annotated as everything is
        fully documented in the other directory.

DOC_C:  This directory follows exactly the same structure than 
        the previous one. 
        The main difference is that you cannot run the example
        from this directory as it doesn't compile.
        Each file is commented, explaining more precisely what
        means each particular directive that might be important
        to underline.
        
You may start by reading all the commented files of DOC_C before
running the main.c example of ENVIRO.

Special attention should be paid to configuration files because
they are not directly linked with the C tips explained in the
other files.
These files are:

        default.env
        enviro.prm
        enviro.mak
        
The tree structure of each directory is:



 <ENVIRO>-----<CONFIG>  
       |         |                             
       |         |---enviro.mak                
       |         |                             
       |         |--enviro.prm                 
       |                      
       |-----<SOURCE>            
       |         |                             
       |         |---<intsub>                
       |         |       |                      
       |         |       |---itenviro.c                      
       |         |       |                      
       |         |       |---itenviro.h
       |         |                                                          
       |         |---<lib>                 
       |         |      |                      
       |         |      |---lib_bits.h
       |         |                             
       |         |---<main>                 
       |         |      |                      
       |         |      |---function.c                      
       |         |      |                      
       |         |      |---function.h
       |         |      |                      
       |         |      |---init.c                      
       |         |      |                      
       |         |      |---init.h
       |         |      |                      
       |         |      |---variable.c          
       |         |      |                      
       |         |      |---variable.h
       |         |      |                      
       |         |      |---main.c               
       |         |                             
       |         |---<map>                 
       |               |                      
       |               |---map72251.c       
       |               |                      
       |               |---map72251.h      
       |
       |-----<OBJECT>
       |         |
       |         |---map72251.o
       |         |
       |         |---enviro.abs
       |         |
       |         |---function.o
       |         |
       |         |---init.o
       |         |
       |         |---main.o
       |         |
       |         |---variable.o
       |         |
       |         |---itenviro.o
       |
       |-----default.env
       
       
You will find the same structure in the DOC_C directory but this time
the files are fully documented.
So, if you want more details for a particular file, check its equivalent
in the DOC_C directory.


The software structure is:


                     main.c
                       |
                       |
       ---------------------------------------------------------------
       |             |               |               |               |                
       |             |               |               |               |                
  itenviro.c       init.c         variable.c     function.c      map72251.c                                                         
     
But some files can use eachothers:

        example:
        
                function.c uses variable.c and map72251.c too.
                     

Note:Using WGDB7 with HIWARE.

If you want to use WGDB7 as debugger, you have to create a special file
for WGDB7.
This file must be placed at the same level as your .abs file which will be 
loaded by WGDB7.
This file must have your project's name and its extension is .gdb.
In this file, you will have to give your source's file path so that
WGDB7 can display your .c files.

example:


          enviro.gdb

     directory c:\ST7_lib\c\doc_c\enviro\sources\main
     directory c:\ST7_lib\c\doc_c\enviro\sources\intsub
     directory c:\ST7_lib\c\doc_c\enviro\sources\map

Don't forget to put "directory" before the path as it's a reserved word for
WGDB7.