


SGS-THOMSON MICROELECTRONICS CONDITIONS OF USAGE OF THE ENCLOSED SOFTWARE
-------------------------------------------------------------------------

The enclosed application software are demonstration software.
SGS-THOMSON Microelectronics (following known as vendor) disclaims any 
responsability for this software, which shall be used at the buyer's (following know as user) sole risk.
Consequently the vendor shall not be liable for loss, damage or injury, direct
or indirect, including loss of profit or other special, incidental or 
consequential damage, even if the vendor has been informed in writing of such 
usage.

Vendor in all cases shall only be responsible for manufacturing products 
according to the product technical specifications. User shall indemnify vendor 
from any claim and expenses vendor may incur as a result of buyer's 
incorporation of this software in its product.





	   ******************************************
	   *   ST623X STARTER KIT SOFTWARE PACKAGE  *
	   *   MAY 1997                             *
	   *  BETA VERSION                          *
	   *   INFORMATION FILE:                    *
	   *   - Disk contents description          *
	   *   - Release notes                      *
	   ******************************************

This software package is a beta version dedicated to the use of st623x starter kit. 

This README file gives information about the files and sub-directories containedin this floppy disk.
It also describes the last releases improvements and gives some information that
are not in the KIT USER MANUAL.

To save floppy disk space, files are shrinked and are not available for direct
"read" operation.
The INSTALL procedure must be used to expand the files content and make them
available.

Once INSTALLED, the disk directories organisation is the following one:

   ROOT directory_____ SK623XLI sub-dir
		   |
		   |___ SIMEX sub-dir
		   |
		   |___ EXAMPLES sub-dir _______ CALCUL sub-dir
					   |____ DATAROM sub-dir
					   |____ EEPROM sub-dir
					   |____ EXOS sub-dir
					   |____ IRTRANS sub-dir
					   |____ KEYBOARD sub-dir
					   |____ POWER sub-dir
					   |____ REGISTER sub-dir
					   |____ SERIAL sub-dir
					   |____ TIMING sub-dir
					   |____ RS232 sub-dir
					   |____ MUSIC sub-dir
					   |____ LCD sub-dir
					   |____ UNIMOT sub-dir
					   |____ DCMOT sub-dir
					   |____ BAT_CHG sub-dir
					   |____ HOME sub-dir______ POW_LIN
					   |                  |____ PHONE
					   |____ A_TIPS sub-dir



		    ***********************
		    *   ROOT DIRECTORY    *
		    ***********************

The root directory contains the following files:

INSTALL file 
------------
INSTALL.EXE file

   This file is provided to automatically expand the shrinked files and install the ST623X STARTER KIT software package into your PC-AT compatible computer
   Hard Disk Drive.

   The files will be installed into the current directory.

   Please insert the floppy disk into the A (or B) floppy drive of your computer
   and move to the directory into which you want to perform the installation.
   Then type the command:
			    A(or B):INSTALL <cr>

   and follow the instructions of the INSTALL procedure.


SIMST6: ST6 CORE and I/Os SIMULATOR SOFTWARE
--------------------------------------------
- SIMST6.EXE file
- SIMST6.DSD file
- SIMST6.ERR file
- SIMST6.HLP file
- SIMST6.MEN file
- SIMST6.CNF file

    Please refer to your ST6 SOFTWARE TOOLS MANUAL for complete
    description of the SIMST6 simulator.

Note that in the SIMEX sub-directory, examples are provided to learn how
to use tne I/Os simulation features. Read the readme included in that
sub-directory to know how to run an example.


AST6/LST6 ASSEMBLER/LINKER SOFTWARE
-----------------------------------
- AST6.EXE: Execution file of the ST6 family assembler software.
- LST6.EXE: Execution file of the ST6 family linker software.

    Please refer to your ST6 SOFTWARE TOOLS MANUAL for complete
    description.


ST623XPG EPROM/EEPROM PROGRAMMING SOFTWARE
------------------------------------------
- ST623XPG.BAT: Command file to be invoked to run the programming software.
- KIT623X.EXE file
- KIT623X.DEV file
- KIT623X.LBR file
- AFFICHE.COM file
- BEG.COM file
- END.COM file

    Please refer to your ST623X STARTER KIT MANUAL for complete
    description of programming operations.


DEMOK32 file 
------------
- DEMOK32.HEX : code file of the ST623X STARTER KIT demonstrations.
		This file must be used to re-program an ST6232 MCU in order to 
		perform demonstration routines and communication protocol with
		PC-AT work station
		This is described in STARTER KIT GUIDE.

		Note: the source files are available in SK623XLI sub-directory.

ST6232K3 file 
-------------
- ST6232K3.EXE : This file contains the PC-AT compatible program to be runned to
		 perform the RS232 demonstration routine (DEMONSTRATION D4).

FUZZYKIT file
-------------
- FUZZYKIT.EXE : This file contains the PC-AT compatible program to be runned to
		 perform the "HEATER TEMPERATURE CONTROL" demonstration. 
		 (DEMONSTRATION D6).
		 
CST6 files
------------
Files with extension are also  provided. They must be compiled with CST6 compilator
available on the CD-ROM

README files
------------
- README     : Text file you are reading.
- README.BAT : Commnand file performing the dos command "TYPE README |more <cr>"         
_______________________________________________________________________________


		    ***********************
		    * SK623XLI DIRECTORY  *
		    ***********************

The files included in this directory contain the basic subroutines and data 
definition library used in the DEMOK25 demonstration program.
They are suited for the ST623X STARTER KIT BOARD and are provided for Users 
who wish to develop a program to be runned in STARTER KIT environment.

They can be included into User's program, either by text editor software 
import/export commands, or by using the .INPUT directive of AST6 assembler 
software (see programming manual).
These subroutines may also just be read by Users as an example of ST623X 
application software organisation.

In this directory, User can also find the source files and comments
concerning the demonstration "HEATER TEMPERATURE CONTROL". This demonstration
software has been developped using a FUZZY LOGIC logic description of the
process, through the "fuzzyTECH Explorer" fuzzy logic compiler for ST62xx MCU
family.
All information are provided in the FUZZYKIT.TXT text file.

For former information please move into the SK623XLI directory and type 
the README command.

_______________________________________________________________________________


		    *********************
		    *  SIMEX DIRECTORY  *
		    *********************

The files included in this directory contain some basic ST6 routines provided 
as examples to be runned with the SIMST6 simulator.

For former information please move into the SIMEX directory and type 
the README command.

_______________________________________________________________________________


		    ***********************
		    * EXAMPLES DIRECTORY  *
		    ***********************

This directory contains several examples of ST6 MCU family application programs.
The sources files are grouped into sub-directories according to their
application field:
		  - CALCUL
		  - DATAROM
		  - EEPROM
		  - EXOS
		  - IRTRANS
		  - KEYBOARD
		  - POWER
		  - REGISTER
		  - TIMING
		  - SERIAL
		  - RS232
		  - LCD 
		  - UNIMOT
		  - DCMOT 
		  - BAT_CHG 
		  - HOME _______  POW_LIN
			    |____ PHONE
		  - A_TIPS 


For former information please move into the EXAMPLES directory and type 
the README command.


_______________________________________________________________________________


		    *****************************************
		    * RELEASES NOTES OF ST6 DEMONSTRATION SW*
		    *****************************************

DEMOK32.ASM V1R0 MAY 1997 -> Initial version
-------------------------






******************************************************************
***  BETA VERSION ***  AST6 V4.50 / LST6 V3.40 / SIMST6 V2.38 ***
******************************************************************

AST6 V4.50 MAY 1997 
-------------------

documentation:  MAY 1997 

**************
1) improvement
**************

1.1) Option -d.

You can use the option -d without the directive ".pp_on" .

1.2) New otpion "-w"

The aim of the option -w is to control the warning message output.
The minimum level is 0 and the maximal one is 2.
The warning level of messages is given at the beginnig of message.
You will find here after the list of warning messages with the level precised.
"0> minimum length assumed: "
"1> symbol already imported"
"1> symbol already exported"
"1> symbol declared external but unused: "
"1> Both symbols have a same definition :"
"2> r/w access control not done on data-space operand"

1.3)Use of conditional directives lead to copy all the assembly code in 
the listing file even if the conditions are not true. The consequence is 
that the listing file becomes larger and unreadible as soon as the source
file is bigger. So a new option has been created "-c" to keep the
compatibility with other versions of the assembler. This option deletes
from the listing file the assembly code that doesn't fit to the conditional
directive . So the listing file contains only the assembly code that fits to
the conditional directive. Notice that the directive condition doesn't 
appear anymore in the listing file.

1.4)Now the maximum source line length of the assembler is 400 instead of 200 
characters.

1.5)Now .IFC directives works with signed long constants (32 bits)
For instance :
	.IFC GT (signed long constant)
		....
	.ENDC
	
	
*****************
2) corrected bugs
*****************

2.1) Use of .LIST directive without "-l" option was likely to generate an
error message ("system error : cannot write into <filename.lis>"). This bug
has been corrected. Now use of .LIST directive without "-l" option 
generates no listing file.

2.2) When we call the macro :
	.MACRO copylc value,var
		ldi     a,(value>>24) & 0FFH
		ld      var,a
		ldi     a,(value>>16) & 0FFH
		ld      var+1,a
		ldi     a,(value>>8 ) & 0FFH
		ld      var+2,a
		ldi     a,(value    ) & 0FFH
		ld      var+3,a
	.ENDM
	
using the instruction copylc 12345678H,0A0H it worked OK and using the
instruction copylc 123456789,0A0H it didn't work OK.This bug has been corrected.

2.3) When we use bad command line ( for instance ast6 files [-options]) , the 
assembler generated a runtime error; this bug has been fixed.

       
	
LST6 V3.40 MAY 1997
-------------------
documentation:  MAY 1997 

**************
1) improvement
**************


1) New definition of .WINDOW directive

Previously the .window directive was located by the linker on a
64 byte address multiple. So small size windows generated a waste
of program space.
Now the way the linker locates windows is different. Firstly the
linker relocates the program sections; secondly it locates windows
in the largest free space area.Windows are not necessary bounded on
a 64 byte address multiple.
Provided there is no overlap on such an address , several windows can
be mapped in a 64 byte boundary.
This algorithm allows gain of program space especially when using
small size windows.


*****************
2) corrected bugs
*****************

2.1) Some window labels had the same address in the symbol file. 
This bug occured when the number of windows exceeded 32. This bug 
has been corrected.

2.2) Even if the Data ROM Window could only be placed into the first 
16Kbyte of the ST6 ROM space, the linker allocated windows above this 
area. This bug has been corrected. 
Due to the correction of the previous bug the map file has been changed. 
Only  windows that can be mapped in the memory space are displayed in 
the WINDOWS SECTIONS of the map file.

2.3) The Rommaster generates a regular Intel Hex File Format with 20 byte
of data. The use of "-d" option allows to verify the Intel Hex Format of
the Rommaster . However the assembled code generates a carriage return after
the code changes from ffh to any other Hex value or vice versa. This bug
has been corrected. 

2.4) Use of "-d" option does not fill the reserved area 0ff8h - 0ffbh with
ffh as the Rommaster does. This bug has been corrected.


2.5) When you used command line LST6 -i file and previously you didn't 
generate a .LIS file with the assembler the linker generated a runtime error.
This bug has been corrected.


SIMST6 V2.38  MAY 1997 
----------------------
SIMST6 2.38 is a beta version supporting st623x starter kit.

