freescale

Freescale 系列单片机常用模块与综合系统设计

/** ###################################################################
**     THIS COMPONENT MODULE IS GENERATED BY THE TOOL. DO NOT MODIFY IT.
**     Filename  : Timer1_40kHz.H
**     Project   : handheld_ultrasonic_rangefinder
**     Processor : MC9S08JM60CLHE
**     Component : PWM
**     Version   : Component 02.211, Driver 01.24, CPU db: 3.00.046
**     Compiler  : CodeWarrior HCS08 C Compiler
**     Date/Time : 2010-1-21, 16:19
**     Abstract  :
**         This bean implements a pulse-width modulation generator
**         that generates signal with variable duty and fixed cycle. 
**     Settings  :
**         Used output pin             : 
**             ----------------------------------------------------
**                Number (on package)  |    Name
**             ----------------------------------------------------
**                       8             |  PTF4_TPM2CH0
**             ----------------------------------------------------
**
**         Timer name                  : TPM2 [16-bit]
**         Counter                     : TPM2CNT   [$0061]
**         Mode register               : TPM2SC    [$0060]
**         Run register                : TPM2SC    [$0060]
**         Prescaler                   : TPM2SC    [$0060]
**         Compare register            : TPM2C0V   [$0066]
**         Flip-flop register          : TPM2C0SC  [$0065]
**
**         Interrupt name              : Vtpm2ch0
**         Interrupt enable reg.       : TPM2C0SC  [$0065]
**         Priority                    : 
**         User handling procedure     : Timer1_40kHz_OnEnd
**         This event is called when the 1 of cycles is generated
**
**         Port name                   : PTF
**         Bit number (in port)        : 4
**         Bit mask of the port        : $0010
**         Port data register          : PTFD      [$000A]
**         Port control register       : PTFDD     [$000B]
**
**         Initialization:
**              Output level           : low
**              Timer                  : Enabled
**              Event                  : Enabled
**         High speed mode
**             Prescaler               : divide-by-1
**             Clock                   : 24000000 Hz
**           Initial value of            period     pulse width
**             Xtal ticks              : 300        0
**             microseconds            : 25         0
**             seconds (real)          : 0.000025   0.0
**
**     Contents  :
**         SetRatio16 - byte Timer1_40kHz_SetRatio16(word Ratio);
**         SetDutyUS  - byte Timer1_40kHz_SetDutyUS(word Time);
**         SetDutyMS  - byte Timer1_40kHz_SetDutyMS(word Time);
**
**     Copyright : 1997 - 2009 Freescale Semiconductor, Inc. All Rights Reserved.
**     
**     http      : www.freescale.com
**     mail      : [e-mail]
** ###################################################################*/

#ifndef __Timer1_40kHz
#define __Timer1_40kHz

/* MODULE Timer1_40kHz. */

/*Include shared modules, which are used for whole project*/
#include "PE_Types.h"
#include "PE_Error.h"
#include "PE_Const.h"
#include "IO_Map.h"
#include "PE_Timer.h"
#include "Cpu.h"

#define Timer1_40kHz_PERIOD_VALUE              0x0257 /* Initial period value in ticks of the timer in high speed mode */
#define Timer1_40kHz_PERIOD_VALUE_HIGH         0x0257 /* Period value in ticks of the timer in high speed mode */


byte Timer1_40kHz_SetRatio16(word Ratio);
/*
** ===================================================================
**     Method      :  Timer1_40kHz_SetRatio16 (component PWM)
**
**     Description :
**         This method sets a new duty-cycle ratio.
**     Parameters  :
**         NAME       - DESCRIPTION
**         Ratio      - Ratio is expressed as an 16-bit unsigned integer
**                      number. 0 - 0xFFFF value is proportional
**                      to ratio 0 - 100%
**         Note: Calculated duty depends on the timer possibilities
**               and on the selected period.
**     Returns     :
**         ---        - Error code, possible codes:
**                           ERR_OK - OK
**                           ERR_SPEED - This device does not work in
**                           the active speed mode
** ===================================================================
*/

byte Timer1_40kHz_SetDutyUS(word Time);
/*
** ===================================================================
**     Method      :  Timer1_40kHz_SetDutyUS (component PWM)
**
**     Description :
**         This method sets the new duty value of the output signal.
**         The duty is expressed in microseconds as a 16-bit
**         unsigned integer number.
**     Parameters  :
**         NAME            - DESCRIPTION
**         Time            - Duty to set [in microseconds]
**                      (0 to 25 us in high speed mode)
**     Returns     :
**         ---             - Error code, possible codes:
**                           ERR_OK - OK
**                           ERR_SPEED - This device does not work in
**                           the active speed mode
**                           ERR_MATH - Overflow during evaluation
**                           ERR_RANGE - Parameter out of range
** ===================================================================
*/

byte Timer1_40kHz_SetDutyMS(word Time);
/*
** ===================================================================
**     Method      :  Timer1_40kHz_SetDutyMS (component PWM)
**
**     Description :
**         This method sets the new duty value of the output signal.
**         The duty is expressed in milliseconds as a 16-bit
**         unsigned integer number.
**     Parameters  :
**         NAME            - DESCRIPTION
**         Time            - Duty to set [in milliseconds]
**         Note: The period is too short. The method will return
**               just the error code in high speed mode.
**     Returns     :
**         ---             - Error code, possible codes:
**                           ERR_OK - OK
**                           ERR_SPEED - This device does not work in
**                           the active speed mode
**                           ERR_MATH - Overflow during evaluation
**                           ERR_RANGE - Parameter out of range
** ===================================================================
*/

void Timer1_40kHz_Init(void);
/*
** ===================================================================
**     Method      :  Timer1_40kHz_Init (component PWM)
**
**     Description :
**         Initializes the associated peripheral(s) and the beans 
**         internal variables. The method is called automatically as a 
**         part of the application initialization code.
**         This method is internal. It is used by Processor Expert only.
** ===================================================================
*/

__interrupt void Timer1_40kHz_Interrupt(void);
/*
** ===================================================================
**     Method      :  Timer1_40kHz_Interrupt (component PWM)
**
**     Description :
**         The method services the interrupt of the selected peripheral(s)
**         and eventually invokes the beans event(s).
**         This method is internal. It is used by Processor Expert only.
** ===================================================================
*/

/* END Timer1_40kHz. */

#endif /* ifndef __Timer1_40kHz */
/*
** ###################################################################
**
**     This file was created by Processor Expert 3.07 [04.34]
**     for the Freescale HCS08 series of microcontrollers.
**
** ###################################################################
*/