名称	主机	操作系统	当前版本	版本日期
C28x 信号发生器库	PC	Win98/2000/ME/NT/XP	0.9a	04/07/2004

;*************************************************************************************
;*********************** 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.