STC库函数使用参考

STC函数库使用参考V1.01STC库函数使用参考版本：V10日期：2013-5-28编写：STC公司基本说明：本函数库适用于STC/IAP15F/L2K61S2系列MCU，具体的MCU的资源，请参考用户手册中对应的章节。使用以下的库函数，都必须包含“config.h”文件，里面包含了“STC15Fxxxx.H”头文件。在自己的工程中，加入库函数文件，并且在使用库函数的C文件中，包含对应的头文件。这个文档仅仅解释各个库函数里的参数定义和取值，具体的应用例子，请参考例程。相关功能的具体描述，请参考用户手册。函数目录IO口初始化函数：GPIO_Inilize----------------------------------------------------------------------------------------2定时器初始化函数：Timer_Inilize------------------------------------------------------------------------------------3ADC初始化函数：ADC_Inilize------------------------------------------------------------------------------------------4ADC电源控制函数：ADC_PowerControl-----------------------------------------------------------------------------6ADC查询转换函数：Get_ADC10bitResult---------------------------------------------------------------------------6通用软件延时函数：delay_ms-----------------------------------------------------------------------------------------7串口初始化函数：USART_Configuration----------------------------------------------------------------------------7串口1写缓冲函数：TX1_write2buff--------------------------------------------------------------------------------9串口2写缓冲函数：TX2_write2buff------------------------------------------------------------------------------10串口1写数据块函数：PrintString1--------------------------------------------------------------------------------10串口2写数据块函数：PrintString2--------------------------------------------------------------------------------10模拟串口字节发送函数：TxSend-----------------------------------------------------------------------------------10模拟串口写数据块函数：PrintString-------------------------------------------------------------------------------11EEPROM多字节读函数：EEPROM_read_n-----------------------------------------------------------------------11EEPROM多字节写函数：EEPROM_write_n----------------------------------------------------------------------11EEPROM扇区擦除函数：EEPROM_SectorErase----------------------------------------------------------------12PCA初始化函数：PCA_Init-------------------------------------------------------------------------------------------12PWM更新占空比函数：UpdatePwm-----------------------------------------------------------------------------15外中断初始化函数：Ext_Inilize-------------------------------------------------------------------------------------15STC函数库使用参考V1.02IO口初始化函数：GPIO_Inilize函数名GPIO_Inilize函数原形u8GPIO_Inilize(u8GPIO,GPIO_InitTypeDef*GPIOx)所在文件GPIO.c功能描述对IO口初始化输入参数1GPIO：选择以下之一：GPIO_P0，GPIO_P1，GPIO_P2，GPIO_P3，GPIO_P4，GPIO_P5输入参数2GPIOx：配置IO口的指针，指定配置的引脚和输入、输出方式，见下表描述。返回U8，返回0表示配置成，返回非0表示配置错误。GPIO_InitTypeDef的定义见于文件“GPIO.H”。typedefstruct{u8Mode;u8Pin;//要设置的端口}GPIO_InitTypeDef;Mode:配置IO的模式，取值见下表：Mode取值功能描述GPIO_PullUp准双向口，内部弱上拉，可以输出，也可以当输入，当输入时，要先写1。GPIO_HighZ高阻输入，只能做输入。GPIO_OUT_OD开漏输出，输出0时拉低，输出1时高阻，可以做输入/输出。GPIO_OUT_PP推挽输出，职能做输出，根据具体电路，可能要串电阻以限制电流。Pin：要配置的某一个回多个IO，取值见下表：Pin取值功能描述GPIO_Pin_0配置Px.0。GPIO_Pin_1配置Px.1。GPIO_Pin_2配置Px.2。GPIO_Pin_3配置Px.3。GPIO_Pin_4配置Px.4。GPIO_Pin_5配置Px.5。GPIO_Pin_6配置Px.6。GPIO_Pin_7配置Px.7。GPIO_Pin_All配置整个8位口。以上参数可以使用或运算，比如：GPIO_InitStructure.Pin=GPIO_Pin_0|GPIO_Pin_1|GPIO_Pin_7;STC函数库使用参考V1.03定时器初始化函数：Timer_Inilize函数名Timer_Inilize函数原形u8Timer_Inilize(u8TIM,TIM_InitTypeDef*TIMx)所在文件Timer.c功能描述对定时器初始化输入参数1TIM：选择以下之一：Timer0，Timer1，Timer2。输入参数2TIMx：配置定时器的指针，指定配置的功能，见下表描述。返回U8，返回0表示配置成，返回非0表示配置错误。TIM_InitTypeDef的定义见于文件“timer.H”。typedefstruct{u8TIM_Mode;//工作模式u8TIM_Polity;//优先级设置u8TIM_Interrupt;//中断允许u8TIM_ClkSource;//时钟源u8TIM_ClkOut;//可编程时钟输出u16TIM_Value;//装载初值u8TIM_Run;//是否运行}TIM_InitTypeDef;TIM_Mode：定时器的工作模式：TIM_Mode取值功能描述TIM_16BitAutoReload配置成16位自动重装模式。TIM_16Bit配置成16位（手工重装）模式。TIM_8BitAutoReload配置成8位自动重装模式。TIM_16BitAutoReloadNoMask配置成16位自动重装模式，中断自动打开，并且不能屏蔽（禁止）。TIM_Polity：中断的优先级：TIM_Polity取值功能描述PolityHigh中断设置为高优先级。PolityLow中断设置为低优先级（默认）。STC函数库使用参考V1.04TIM_Interrupt：中断允许或禁止：TIM_Interrupt取值功能描述ENABLE允许中断。DISABLE禁止中断（默认）。TIM_ClkSource：定时器的时钟源选择：TIM_ClkSource取值功能描述TIM_CLOCK_1T定时器的时钟使用系统时钟1T模式。TIM_CLOCK_12T定时器的时钟使用系统时钟12T模式。TIM_CLOCK_Ext定时器的时钟使用外部输入。TIM_ClkOut：定时器溢出时取反对应IO输出高速时钟：TIM_ClkOut取值功能描述ENABLE允许定时器溢出时取反对应IO输出高速时钟。DISABLE禁止定时器溢出时取反对应IO输出高速时钟。TIM_Value：一个16位的初值。TIM_Run：初始化后是否运行定时器：TIM_Run取值功能描述ENABLE初始化后运行定时器。DISABLE初始化后停止定时器。ADC初始化函数：ADC_Inilize函数名ADC_Inilize函数原形voidADC_Inilize(ADC_InitTypeDef*ADCx)所在文件Adc.c功能描述对ADC初始化输入参数1ADCxx：配置ADC的指针，见下面描述。返回无ADC_InitTypeDef的定义见于文件“ADC.H”。STC函数库使用参考V1.05typedefstruct{u8ADC_Px;//设置要做ADC的IO,ADC_P10~ADC_P17,ADC_P1_Allu8ADC_Speed;//ADC速度ADC_90T,ADC_180T,ADC_360T,ADC_540Tu8ADC_Power;//ADC功率允许/关闭ENABLE,DISABLEu8ADC_AdjResult;//ADC结果调整,ADC_RES_H2L8,ADC_RES_H8L2u8ADC_Polity;//优先级设置PolityHigh,PolityLowu8ADC_Interrupt;//中断允许ENABLE,DISABLE}ADC_InitTypeDef;ADC_Px：设置要做ADC的IO：ADC_Px取值功能描述ADC_P10设置P1.0为ADC输入口。ADC_P11设置P1.1为ADC输入口。ADC_P12设置P1.2为ADC输入口。ADC_P13设置P1.3为ADC输入口。ADC_P14设置P1.4为ADC输入口。ADC_P15设置P1.5为ADC输入口。ADC_P16设置P1.6为ADC输入口。ADC_P17设置P1.7为ADC输入口。ADC_P1_All配置整个8位P1口为ADC输入。以上参数可以使用或运算，比如：ADC_InitStructure.ADC_Px=ADC_P10|ADC_P11|ADC_P12;ADC_Speed：设置ADC的速度：ADC_Speed取值功能描述ADC_90T设置ADC时钟为90个主时钟周期。ADC_180T设置ADC时钟为180个主时钟周期。ADC_360T设置ADC时钟为360个主时钟周期。ADC_540T设置ADC时钟为540个主时钟周期。ADC_Power：ADC电源控制：ADC_Power取值功能描述ENAB