cmxread.doc

CMEX source code RTOS for atmel atmega128

cmx_init.c	;Is the source code that that should be compiled by 
		;by the user each time the cxconfig.h file (or copy)
		;gets edited. Note: this file may also be a copy, so
		;the user should compile the proper copy named file.
		;This file initializes all CMX variables according to 
		;the user parameters specified in the cxconfig.h
		;file. 

cxver5.c	;this is the CMX "C" file that contains ALL the 
		;CMX functions. This should never be compiled and
		;is given to the user to view ALL the CMX functions
		;together. This is to conceptionize how ALL the
		;CMX functions work together.

		;Technically the user could compile this file and use
		;the output, but the CODE size will be larger, for
		;ALL functions will be in the CODE.

;The following files are the assembly source files that contains the
;CMX scheduler, interrupt handler and interrupt pipe. The proper
;file must be declared, when the user uses the linker, to link the 
;application code with the CMX operating system. This depends on
;the memory model used for the particular appplication

cxsk53s.s90	;for Mega103/603

cmxio3.c	;This is the source code to perform ALL CMX UART functions
		;This is not broken up into individual modules, for
		;it needs to be edited by the user for their specific
		;needs. If the user is going to use any of the CMX
		;UART functions, then this whole module MUST be linked
		;in. The user is free to put #defines in, to disable
		;unused functions from being compiled, if they so
		;like.

		;Also in the CMXMOD sub-directory.
lbavr3s.r90	;Is the CMX library of "C" functions for the NORMAL
		;MODE memory model. For use with the cmxsampn.bat file

		;Also in the CMXMOD sub-directory.
cxfuncs.h	;This is the CMX header file that is used by ALL CMX 
		;functions. Is needed to compile any or all the CMX 
		;functions. Contains the CMX function prototypes. 

		;Also in the CMXMOD sub-directory.
cxstruct.h	;This is the CMX header file that is used by ALL CMX 
		;functions. Is needed to compile any or all the CMX 
		;functions. Contains the CMX function structures.

		;Also in the CMXMOD sub-directory.
cxextern.h	;This is the CMX header file that is used by ALL CMX 
		;functions. Is needed to compile any or all the CMX 
		;functions. Contains the extern CMX data variables.

		;Also in the CMXMOD sub-directory.
cxdefine.h	;This is the CMX header file that is used by ALL CMX 
		;functions. Is needed to compile any or all the CMX 
		;functions. Contains the CMX data definitions. 

		;Also in the CMXMOD sub-directory.
cxvendor.h	;This is the CMX header file that is used by ALL CMX 
		;functions. Is needed to compile any or all the CMX 
		;functions. Contains "C" vendor specifics. 


cmxbug.c	;is the source code, for the CMXBug debugger. MUST be 
		;compiled for the particular memory model that the user 
		;is working with.

		;Also in the CMXMOD sub-directory.
cmxtrack.h	;This is the CMX header file that is used by ALL CMX 
		;functions. Is needed to compile any or all the CMX 
		;functions if CMXTracker is invoked. 

cmxtrack.c	;is the source code, for CMXTracker. MUST be 
		;compiled for the particular memory model that the user 
		;is working with.

; The next 4 files are used to show the user a sample program (Mega103)
cmxsamp.c	;Shows the user a typical user program written in "C".
		;The cmxsamp.c is written to support being compiled with
		;the (-v3 -ms) option.

cmxint.c	;Is the C file to show the user a couple different
		;interrupt handlers. One handler calls the CMX cmx_tic
		;function which determines the timing frequency and the
		;other interrupt calls the CMX int_pipe function. This 
		;is for examples purposes only. 

cmxsam3s.xcl	;Is the cmxsamp command file needed by the linker to
		;properly link the cmxsamp file with the CMX operating
		;system and CMX library


cmxsam3s.bat	;Is a batch file that will properly compile the  
		;cmxsamp.c file, compile the cmx_init.c file,
		;cmxint.c file and assemble the cxsk53s.s90 file 
		;and then link that file into CMX to create an executable 
		;file. WARNING: user must make sure 
		;that their AUTOEXEC.BAT file contains the path to where
		;the IAR compiler, linker, assembler, and librarian
		;executable files are and the IAR *.h include files,
		;or an error will occur. The user may go in and manipulate
		;any of the files that produce an error, because they cannot
		;find a file in the current directory, or thru the SET and
		;PATH command within the AUTOEXEC.BAT file.


; The next 5 files are used to show the user a sample program (Mega103)
; using the CMXBug debugger
bugsamp.c	;Shows the user a typical user program written in "C".
		;The bugsamp.c is written to support being compiled with
		;the (-v3 -ms) option.

bug_init.c	;COPY of cmx_init.c, for bugsamp sample program.

bgconfig.h	;COPY of cxconfig.h, for bugsamp sample program.

bugsam3s.xcl	;Is the bugsamp command file needed by the linker to
		;properly link the bugsamp file with the CMX operating
		;system, CMX library and CMXBug debugger.

bugsam3s.bat	;Is a batch file that will properly compile the  
		;bugsamp.c file, compile the bug_init.c file, compile the
		;cmxbug.c file, assemble the cxsk53s.s90 file 
		;and then link that file into CMX to create an executable 
		;file. WARNING: user must make sure 
		;that their AUTOEXEC.BAT file contains the path to where
		;the IAR compiler, linker, assembler, and librarian
		;executable files are and the IAR *.h include files,
		;or an error will occur. The user may go in and manipulate
		;any of the files that produce an error, because they cannot
		;find a file in the current directory, or thru the SET and
		;PATH command within the AUTOEXEC.BAT file.

; The next 6 files are used to show the user a sample program (Mega103)
; using the CMX CMXTracker
trksamp.c	;Shows the user a typical user program written in "C".
		;The trksamp.c is written to support being compiled with
		;the (-v3 -ms) option.

cxsk53st.s90	;COPY of cxsk53s.s90 with switched enabled for
		;inclusion of CMXTracker variables.

trk_init.c	;COPY of cmx_init.c, for trksamp sample program.

tkconfig.h	;COPY of cxconfig.h, for trksamp sample program.

trksam3s.xcl	;Is the trksamp command file needed by the linker to
		;properly link the trksamp file with the CMX operating
		;system, CMX library and CMXTracker

trksam3s.bat	;Is a batch file that will properly compile the  
		;trksamp.c file, compile the trk_init.c file, compile the
		;cmxtrack.c file, assemble the cxsk53st.s90 file 
		;and then link that file into CMX to create an executable 
		;file. WARNING: user must make sure 
		;that their AUTOEXEC.BAT file contains the path to where
		;the IAR compiler, linker, assembler, and librarian
		;executable files are and the IAR *.h include files,
		;or an error will occur. The user may go in and manipulate
		;any of the files that produce an error, because they cannot
		;find a file in the current directory, or thru the SET and
		;PATH command within the AUTOEXEC.BAT file.


\CMXMOD directory


;The following "make" files are in the CMXMOD sub-directory
;It lets the user make different memory model libraries
;choose the file that will be used by make.exe if the user
;changes ANY of the CMX functions, or CMX headers that
;contain the structures, and function prototypes. Also
;the user may go and edit this file to select different
;compiler switches.

mkavr3s.mak	;for mega103/603
mkavr3st.mak	;for inclusion of CMXTracker for mega103/603

		;The following file is under the CMXMOD sub-directory
make.exe	;This is a file by Microsoft, that will maintain the 
		;mkavr??.mak file. Must be used if if any of the CMX 
		;functions, or CMX header (.h) files are changed.
		;Also used to make NEW memory models, if not made.
		;To invoke this, type "make mkavr??.mak"

;The following files, allow the librarian to make a CMX library
;file for the selected memory model. This is automatically performed
;by the selected "mkavr??.mak" file.

xlavr3s.xlb	;for mega103/603
xlavr3st.xlb	;CMXTracker enabled for mega103/603


;The following CMX library files WILL be made by the librarian  
;through the use of the selected mkavr??.mak file, by make.exe
;This is automatically performed by the selected "mkavr??.mak" file.
; INCLUDED
lbavr3s.r90	;for for mega103/603
lbavr3st.r90	;for CMXTracker for mega103/603

**********************************************************
	NOTE:
Remember to include the following files for the linker.

cxsk53s.obj	;the proper CMX assembly module file
cmx_init.obj	;or name of copy of this file
lbavr3s?.r90	;the proper CMX library file
cmxbug.obj	;if CMXBug debugger desired.
cmxtrack.obj	;if CMXTracker desired.
YOUR MODULES