readme.txt

TI公司的TMS320F28xxDSP信号发生库函数

;*************************************************************************************
;*********************** SECTION 1: SIGNAL GENERATOR LIBRARY ************************* 
;*************************************************************************************
Thank you for trying C28x Software Collateral. 
The software is installed in C:\TIDCS\C28\DSP_TBOX\SGEN directory.

The signal generator module repository contains SIN generator ramp generator, trapezoidal & 
profile-generator modules. The signal generator modules are implemented using modulo 
arithmetic counter (i.e. Any overflow is ignored and only the remainder is kept) to precisely 
control the frequency. The frequency of the generated signal is reciprocal of the time it takes 
for successive overflow of modulo counter, which in turn commensurate with the step value added 
to the counter. Thus by changing the step value, one can precisely control the frequency.

The step value is not directly commanded to vary the frequency, instead the modulation 
of frequency is performed using the normalized variable "freq" which is normalized to 
the maximum frequency. The maximum required frequency is predetermined based on the 
application requirement and it set by initializing the "step_max" input. Thus, the 
normalized variable "freq" allows the user to control the frequency of the signal 
between 0 to maximum frequency. This strategy is adopted for all signal generator modules. 

The following table summarizes the set of modules that are available in this library.

SIGNAL GENERATOR LIBRARY
|===============|=======================================================================|
|  Module Name	| Description						        	|
|===============|=======================================================================| 
|  SGENT_1 	| Single Channel SIN Generator (Table look-up) 		  		|
|---------------|-----------------------------------------------------------------------|
|  SGENT_2 	| Dual Channel SIN Generator (Table look-up)				|
|---------------|-----------------------------------------------------------------------|
|  SGENT_3 	| 3-phase SIN Generator (Table look-up)					|
|---------------|-----------------------------------------------------------------------|
|  SGENT_3D 	| Dual 3-phase SIN Generator (Table look-up) 				|
|---------------|-----------------------------------------------------------------------|
|  SGENTI_1 	| Single Channel SIN Generator (Table look-up and Linear Interpolation) |
|---------------|-----------------------------------------------------------------------|
|  SGENTI_2 	| Dual Channel SIN Generator (Table look-up and Linear Interpolation) 	|
|---------------|-----------------------------------------------------------------------|
|  SGENTI_3 	| 3-phase SIN Generator (Table look-up and Linear interpolation) 	|
|---------------|-----------------------------------------------------------------------|
|  SGENTI_3D 	| Dual 3-phase SIN Generator (Table look-up and Linear Interpolation)	|
|---------------|-----------------------------------------------------------------------|
|  SGENHP_1 	| High Precision SIN Generator (Table look-up and Linear Interpolation) |
|---------------|-----------------------------------------------------------------------|
|  SGENHP_2 	| High Precision SIN Generator (Table look-up and Linear Interpolation) |
|---------------|-----------------------------------------------------------------------|
|  RMPGEN 	| Ramp Generator							|
|---------------|-----------------------------------------------------------------------|
|  TZDLGEN 	| Trapezoidal generator 						|
|---------------|-----------------------------------------------------------------------|
|  PROFILE 	| Profile generator  							|
|=======================================================================================|


DOCUMENTATION:
|===============|=======================================================================|
|  DOC		| DIRECTORY LOCATION				        		|
|===============|=======================================================================| 
|  MODULE DOC	| C:\TIDCS\C24\DSP_TBOX\SGEN\DOC\SGEN_MDL.PDF		  		|
|=======================================================================================|


Version History:
================

Version 0.9a dated 12/06/2003 

1. Some the math function had .ref being used in the *.asm, it is changed to .def 
   Because of this bug, compiler was reporting that the function name is not available.

2. Most of the functions did not clear the OVM flag at the end, it is modified.

3. ASP & NASP is been used within functions, we should not disturb the ASP bit.
   It is meant for only interrupt handler. Called function should not change this bit.