STC库函数使用参考.docx

《STC库函数使用参考.docx》由会员分享，可在线阅读，更多相关《STC库函数使用参考.docx（43页珍藏版）》请在三一文库上搜索。

1、STC库函数使用参考版本： V10日期： 2013-5-28编写：STC司基本说明：本函数库适用于STC/IAP15F/L2K61S2系歹U MCU具体的MCU勺资源，请参考用户手册中对应的章节。使用以下的库函数，都必须包含“”文件，里面包含了“”头文件。在自己的工程中，加入库函数文件，并且在使用库函数的 C 文件中，包含对应的头文件。这个文档仅仅解释各个库函数里的参数定义和取值，具体的应用例子，请参考例程。相关功能的具体描述，请参考用户手册。函数目录IO 口 初 始 化 函 数 ： GPIO_Inilize2定 时 器 初 始 化 函 数 ： Timer_Inilize 3ADC 初始 化

2、函 数 ： ADC_Inilize 4ADC 电 源 控 制 函 数 ： ADC_PowerControl 6ADC 查 询 转 换 函 数 ： Get_ADC10bitResult 6通 用 软 件 延 时 函 数 ： delay_ms 7串 口 初 始 化 函 数 ： USART_Configuration 7串 口 1 写 缓 冲 函 数 ： TX1_write2buff9串 口 2 写 缓 冲 函 数 ： TX2_write2buff10串 口 1 写 数 据 块 函 数 ： PrintString110串 口 2 写 数 据 块 函 数 ： PrintString210模 拟 串 口

3、 字 节 发 送 函 数 ： TxSend 10模 拟 串 口 写 数 据 块 函 数 ： PrintString 11EEPROM 多 字 节 读 函 数 ： EEPROM_read_n- 11EEPROM 多 字 节 写 函 数 ： EEPROM_write_n- 11EEPROM 扇 区 擦 除 函 数 ： EEPROM_SectorErase12PCA 初 始 化 函 数 ：PCA_Init12UpdatePwmExt_InilizePWM 更 新占 空 比 函 数15外中断初始化函数15IO 口初始化函数： GPIO_Inilize函数名GPIO_Inilize函数原形u8 GPIO

4、_Inilize(u8 GPIO, GPIO_InitTypeDef *GPIOx)所在文件功能描述对IO 口初始化输入参数1GPIQ 选择以下之一：GPIO_P0 GPIO_P1 GPIO_P2 GPIO_P3GPIO_P4 GPIO_P5输入参数2GPIOx配置IO 口的指针，指定配置的引脚和输入、输出方式，见 下表描述。返回U8,返回0表示配置成，返回非0表示配置错误。GPIO_InitTypeDef的定义见于文件typedef structu8 Mode;u8 Pin;/要设置的端口 GPIO_InitTypeDef;Mode:配置IO的模式，取值见下表:Mod凛值功能描述GPIO_P

5、ullUp准双向口，内部弱上拉，可以输出，也可以当输入，当输入时，要先写1。GPIO_HighZ高阻输入，只能做输入。GPIO_OUT_CDF漏输出，输出。时拉低，输出1时局阻，可以做输入/输出。GPIO_OUT_PP隹挽输出，职能做输出，根据具体电路，可能要串电阻以限制电 流。Pin：要配置的某一个回多个IO,取值见下表:Pin取值功能描述GPIC_Pin_0配置。GPIO_Pin_1配置。GPIO_Pin_2配置。GPIO_Pin_3配置。GPIO_Pin_4配置。GPIO_Pin_5配置。GPIO_Pin_6配置。GPIO_Pin_7配置。GPIO_Pin_All配置整个8位口。以上参数

6、可以使用或运算，比如：=GPIO_Pin_0 | GPIO_Pin_1 | GPIO_Pin_7;定时器初始化函数：Timer Inilize函数名Timer_Inilize函数原形u8 Timer_Inilize(u8 TIM, TIM_InitTypeDef *TIMx)所在文件功能描述对定时器初始化输入参数1TIM:选择以下之一：Timer 0 , Timer 1 , Timer 2。输入参数2TIMx:配置定时器的指针，指定配置的功能，见下表描述。返回U8,返回0表示配置成，返回非0表示配置错误。TIM_InitTypeDef的定义见于文件typedef structu8 TIM_Mo

7、de; / 工作模式u8 TIM_Polity;/优先级设置u8 TIM_Interrupt; 中断允许u8 TIM_ClkSource; 时钟源u8 TIM_ClkOut; /可编程时钟输出u16 TIM_Value; 装载初值u8 TIM_Run; /是否运行 TIM_InitTypeDef;TIM_Mode定时器的工作模式:TIM_ModeX 值功能描述TIM_16BitAutoReload配置成16位自动重装模式。TIM_16Bit配置成16位（手工重装）模式。TIM_8BitAutoReload配置成8位自动重装模式。TIM_16BitAutoReloadNoMask配置成16位自动

8、重装模式，中断自动打开，并且 不能屏蔽（禁止）。TIM_Polity :中断的优先级:TIM_Polity 取值功能描述PolityHigh中断设置为高优先级。PolityLow中断设置为低优先级（默认）。TIM_Interrupt :中断允许或禁止:TIM_Interrupt 取值功能描述ENABLE允许中断。DISABLE禁止中断（默认）。TIM_ClkSource：定时器的时钟源选择:功能描述TIM_ClkSource 取值TIM_CLOCK_1T定时器的时钟使用 系统时钟1T模式。TIM_CLOCK_12T定时器的时钟使用 系统时钟12T模式。TIM_CLOCK_Ext定时器的时钟使用

9、外部输入。TIM_ClkOut:定时器溢出时取反对应IO输出高速时钟:TIM_ClkOut 取值功能描述ENABLE允许定时器溢出时取反对应IO输出高速时钟。DISABLE禁止定时器溢出时取反对应IO输出高速时钟。TIM_Value： 一个16位的初值TIM_Run初始化后是否运行定时器:TIM_RunB 值功能描述ENABLE初始化后运行定时器。DISABLE初始化后停止定时器。ADCW 始化函数：ADC_Inilize函数名ADC_Inilize函数原形void ADC_Inilize(ADC_InitTypeDef *ADCx)所在文件功能描述对ADCW始化输入参数1ADCxx配置ADC

10、勺指针，见卜面描述。返回无ADC_InitTypeDef的定义见于文件typedef struct u8 ADC_Px; 设置要做 ADC勺 IO, ADC_P10ADC_P17,ADC_P1_Allu8 ADC_Speed; /ADC 速度ADC_90T,ADC_180T,ADC_360T,ADC_540Tu8 ADC_Power; /ADC 功率允许 / 关闭 ENABLE,DISABLEu8 ADC_AdjResult; ADC 结果调整,ADC_RES_H2L8,ADC_RES_H8L2u8 ADC_Polity; / 优先级设置PolityHigh,PolityLowu8 ADC_I

11、nterrupt; /中断允许ENABLE,DISABLE ADC_InitTypeDef;ADC_Px设置要做 ADC勺IO:功能描述ADC_Px 取值ADC_P10设置为ADCt入口。ADC_P11设置为ADCt入口。ADC_P12设置为ADCt入口。ADC_P13设置为ADCt入口。ADC_P14设置为ADCt入口。ADC_P15设置为ADCt入口。ADC_P16设置为ADCt入口。ADC_P17设置为ADCt入口。ADC_P1_All配置整个8位P1 口为ADO入。以上参数可以使用或运算，比如:=ADC_P10 | ADC_P11 | ADC_P12;ADC_Speed设置ADC勺速度

12、:ADC_Spee取值功能描述ADC_90T设置ADC寸钟为90个主时钟周期。ADC_180T设置ADC寸车防180个主时钟周期。ADC_360T设置ADC寸车防 360个主时钟周期。ADC_540T设置ADC寸车防 540个主时钟周期。ADC_Power ADOfe源控制:ADC_Powe散值功能描述ENABLE初始化后由开ADCfe源。DISABLE初始化后关闭ADCfe源。ADC_AdjResult: ADC吉果调整:ADC_AdjResult 取值功能描述ADC_RES_H2L8ADC吉果寄存器高字节为结果的高2位，低字节为低8 位。ADC_RES_H8L2ADC吉果寄存器高字节为结果

13、的高8位，低字节为低2 位。ADC_Polity:中断的优先级:ADC_Polity 取值功能描述PolityHigh中断设置为高优先级。PolityLow中断设置为低优先级（默认）。ADC_Interrupt :中断允许或禁止:ADC_Interrupt 取值功能描述ENABLE允许中断。DISABLE禁止中断（默认）。ADOfe 源控制函数：ADC_PowerControl函数名ADC_PowerControl函数原形void ADC_PowerControl(u8 pwr)所在文件功能描述开/关ADCt源。输入参数1pwr：取值 ENABLE 开 ADCt源，取值 DISABLE!33

14、ADCt源。返回无ADCS询转换函数：Get ADC10bitResult函数名Get_ADC10bitResult函数原形u16 Get_ADC10bitResult(u8 channel)所在文件功能描述查卸过进一次ADC专换。输入参数1channel:要进行转换的ADC!,取值07其中一个，对应。返回10 位 ADC。通用软件延时函数：delay_ms函数名delay_ms函数原形void delay_ms(unsigned char ms)所在文件功能描述延时程序。包含，延时时间会根据主频自动适应。输入参数1ms：延日t 的 ms数，1255。返回无串 口 初始化函数：USART_Co

15、nfiguration函数名USART_Configuration函数原形u8 USART_Configuration(u8 UARTx, COMx_InitDefine *COMx)所在文件功能描述对串口初始化输入参数1UARTx要初始化的串口，取值以下之一：USART1 USART2输入参数2COMx配置串口的参数指针。返回U8,返回0表示配置成，返回非0表示配置错误。COMx_InitDefine的定义见于文件typedef struct u8 UART_Mode;u8 UART_BRT_Use;u32 UART_BaudRate;u8 Morecommunicate;u8 UART_R

16、xEnable;u8 BaudRateDouble;u8 UART_Interrupt;u8 UART_Polity;u8 UART_P_SW;u8 UART_RXD_TXD_Short; COMx_InitDefine;UART_Mode设置USART勺工作模式:UART_Mode 值功能描述UART_ShiftRight串口工作于同步输出方式，仅仅用于USART1UART_8bit_BRTx串口工作于8位数据，可变波特率。UART_9bit串口工作于9位数据，固定波特率。UART_9bit_BRTx串口工作于9位数据，可变波特率。UART_BRT_U s啾用的波特率发生器:UART_BRT

17、_Use取值功能描述BRT_Timer1使用Timeri做波特率发生器，仅仅用于USART1BRT_Timer2使用Timer2做波特率发生器。UART_BaudRate使用的波特率，比如：=115200ul; /UL 表示是 unsigned long 。Morecommunicate： 多机通讯允许:Morecommunicate 取值功能描述ENABLE允许多机通讯。DISABLE禁止多机通讯（默认）。UART_RxEnable 接收允许:UART_RxEnabl现值功能描述ENABLE允许接收。DISABLE禁止接收。BaudRateDouble：波特率加倍（仅仅用于USARD:Bau

18、dRateDouble 取值功能描述ENABLE允许波特率加倍。DISABLE禁止波特率加倍。UART_Interrupt :中断允许或禁止:UART_Interrupt 取值功能描述ENABLE允许中断。DISABLE禁止中断（默认）。UART_Polity:中断的优先级:UART_Polity 取值功能描述PolityHigh中断设置为高优先级。PolityLow中断设置为低优先级（默认）。UART_P_SWH换IO:对于串口 1的取值:UART_P_SW值功能描述UART1_SW_P30_P3,把串口 1切换到、。UART1_SW_P36_P377把串口 1切换到、。UART1_SW_P

19、16_P177把串口 1切换到、。（必须使用内部时钟）。UART_P_SWH换IO:对于串口 2的取值:UART_P_SW值功能描述UART2_SW_P10_P1,把串口 2切换到、。UART2_SW_P46_P4：，把串口 2切换到、。UART_RXD_TXD_Sho呐部TXD与RXDR相缓冲输出做中继： 对于串口 1的取值：UART_RXD_TXD_Shc取值)rt功能描述ENABLE允许内部TXg RXDB相缓冲输出做中继。DISABLE禁止内部TXg RXDB相缓冲输出做中继。串口 1写缓冲函数：TX1_write2buff函数名TX1_write2buff函数原形void TX1_w

20、rite2buff(u8 dat)所在文件功能描述写入串口 1发送缓冲，指针+1输入参数1dat：要发送的一字节数据。返回无。串口 2写缓冲函数：TX2_write2buff函数名TX2_write2buff函数原形void TX2_write2buff(u8 dat)所在文件功能描述写入串口 2发送缓冲，指针+1输入参数1dat:要发送的一字节数据。返回无。串口 1写数据块函数：PrintStringl函数名PrintStringl函数原形void PrintString1(u8 *puts)所在文件功能描述把一个字符串写入串口 1发送缓冲，遇到0结束。输入参数1puts :要发送的字符串指

21、针。返回无。串口 2写数据块函数：PrintString2函数名PrintString2函数原形void PrintString2(u8 *puts)所在文件功能描述把一个字符串写入串口 2发送缓冲，遇到0结束。输入参数1puts :要发送的字符串指针。返回无。模拟串口字节发送函数：TxSend函数名TxSend函数原形void TxSend(u8 dat)所在文件功能描述模拟串口发送，可以定义 任意一个IO做串口发送，固定为9600,8,n,1，修改config里的时钟频率时，程序会自动适应这个频率，始终保持9600的波特率，一般用于测试用途。当发送时，为了避免受中断的影响，会关掉总中断。输

22、入参数1dat:要发送的字节。返回无。模拟串口写数据块函数：Printstring函数名Printstring函数原形void PrintString(u8 *puts)所在文件功能描述模拟串口发送一个字符串，遇到 0结束。用于测试用途。调用了 TxSend函数输入参数1puts :要发送的字符串指针。返回无。EEPRO跻字节读函数：EEPROM read n函数名EEPROM_read_n函数原形void EEPROM_read_n(u16 EE_address,u8 *DataAddress,u16number)所在文件功能描述从EEPRO牍出多个字节。输入参数1EE_address：要读

23、出的EEPROM 16位首地址。输入参数2DataAddress :读出数据存放的指针。输入参数3Number要读出的字节数，取值 165535 （根据实际情况确定最大 值）。返回无。EEPRO跻字节写函数：EEPROM write n函数名EEPROM_write_n函数原形void EEPROM_write_n(u16 EE_address,u8 *DataAddress,u16number)所在文件功能描述把多个字节写入 EEPROM输入参数1EE_address：要写入的EEPROM 16位首地址。输入参数2DataAddress：源数据存放的指针。输入参数3Number要写入的字节数

24、，取值 165535 （根据实际情况确定最大 值）。返回无。EEPROMf 区擦除函数函数：EEPROM_SectorErase函数名EEPROM_SectorErase函数原形void EEPROM_SectorErase(u16 EE_address)所在文件功能描述擦除EEPRO册个扇区。输入参数1EE_address:要擦除的扇区内的任意一个16位地址。返回无。PCAW 始化函数：PCA_Init函数名PCA_Init函数原形void PCA_Init(u8 PCA_id, PCA_InitTypeDef *PCAx)所在文件功能描述初始化PCA输入参数1PCA_id:要初始化的PCA

25、1道，取以卜具一：PCA0 PCA1 PCA2PCA_Counter)输入参数2PCAx初始化参数的结构指针。详情看下面的描述。返回无。PCA_id:选择要初始化的PCAS道:PCA_id取值功能描述PCA0初始化PCA 0通道。PCA1初始化PCA 1通道。PCA2初始化PCA 2通道。PCA_Counter初始化PC焰用计数器，这个最好放在最后初始化。PCA_InitTypeDef的定义见于文件 typedef structu8 PCA_IoUse;u8 PCA_Clock;u8 PCA_Mode;u8 PCA_PWM_Wide;u8 PCA_Interrupt_Mode;u8 PCA_P

26、olity;u16 PCA_Value; PCA_InitTypeDef;PCA_IoUse选择PCA#用的IO:初始化PCA_Counter时的取值，初始化 PCAAPCA2寸忽略：PCA_IoUsea值功能描述PCA_P12_P11_P10_P3；7巴 PCA换至h、。PCA_P34_P35_P36_P3；7巴 PCA换至h、。PCA_P24_P25_P26_P27巴pc刚换至h、。PCA_Clock选择PCA#用的时钟：初始化PCA_Counter时的取值，初始化 PCA0 PCA2时忽略：PCA_Clock 取值功能描述PCA_Clock_1TPCA#用系统 仃做时钟。PCA_Cloc

27、k_2TPCA#用系统2T做时钟。PCA_Clock_4TPCA#用系统4T做时钟。PCA_Clock_6TPCA#用系统6T做时钟。PCA_Clock_8TPCA#用系统8T做时钟。PCA_Clock_12TPCA#用系统12T做时钟。PCA_Clock_Timer0_OFPCA使用Timer。溢出率做时钟。Time。要另外初始化，速度快时不要升Timer。中断。PCA_Clock_ECIPCA使用外部ECI引脚做时钟。PCA_Polity :中断的优先级：初始化PCA_Counter时的取值，初始化PCA（ PCA2时忽略：PCA_Polity 取值功能描述PolityHighPCA中断设

28、置为高优先级。PolityLowPCA中断设置为低优先级（默认）。PCA_Interrupt_Mode :中断允许或禁止： 初始化 PCA_Counter时的取值，初始化PCA0 PCA2寸忽略：PCA_Interrupt_Mode功能描述取值ENABLE允许公用PC碇时器中断。DISABLE禁止公用PC碇时器中断（默认）。PCA_Interrupt_Mode :中断允许或禁止： 初始化 PCA0 PCA2时的取值，初始化PCA_Counter时忽略：PCA_Interrupt_Mode取值功能描述ENABLE允许PCA1道中断。DISABLE禁止PCA道中断（默认）。PCA_Rise_Act

29、ivePCA道上升沿中断。PCA_Fall_ActivePCA道下降沿中断。注意：上面的参数可以做如下组合:下降沿中断，允许中断=PCA_Fall_Active | ENABLE; /上升沿中断，允许中断=PCA_Rise_Active | ENABLE; /=PCA_Rise_Active | PCA_Fall_Active | ENABLE; /上升沿、下降沿中断,允许中断。如果后面使用了 | DISABLE ,则中断被禁止。PCA_Clock选择PCA#用的时钟：初始化PCA_Counter时的取值，初始化 PCA0 PCA2时忽略：PCA_Clock 取值功能描述PCA_Clock_1

30、TPCA#用系统 仃做时钟。PCA_Clock_2TPCA#用系统2T做时钟。PCA_Clock_4TPCA#用系统4T做时钟。PCA_Clock_6TPCA#用系统6T做时钟。PCA_Mode设置PCA通道的工作模式：初始化PCA0 PCA2时的取值，初始化PCA Counter时忽略:PCA_ModeX 值功能描述PCA_Mode_PWMPCAS道工作于PW做出模式。PCA_Mode_CapturePCAS道工作于输入捕捉模式。PCA_Mode_SoftTimerPCAS道工作于16位软件定时器模式。PCA_Mode_HighPulseOutputPCA1道工作于16位软件定时器模式，并且

31、高速输出脉冲。PCA_PWM_Wicde置PCAS道工作于PWMI式日t的PW晚度：初始化PCA( PCA2工作于PWMI式时的取彳1,初始化 PCA_Counter时或PCA1道其它模式时忽略：PCA_PWM_Wide 值功能描述PCA_PWM_8bitPCA道工作于PW而出模式，PW酸度为8位。PCA_PWM_7bitPCA道工作于PW而出模式，PW酸度为7位。PCA_PWM_6bitPCA道工作于PW而出模式，PW酸度为6位。PCA_Value设置PCA通道的初值，初始化PCA0 PCA2时的取值，初始化PCA_Counter 时忽略。PWME新占空比函数：UpdatePwm函数名Upd

32、atePwm函数原形void UpdatePwm(u8 PCA_id, u8 pwm_value)所在文件功能描述更新PW曲占空比。输入参数1PCA_id:要更新的PCAM道，取以卜其一：PCA0 PCA1 PCA2输入参数2pwm_value：新的PWMt空比值。这是PW喻出低电平的时间。返回无。外中断初始化函数：Ext Inilize函数名Ext_Inilize函数原形u8 Ext_Inilize(u8 EXT, EXTI_InitTypeDef *INTx)所在文件功能描述外中断初始化。输入参数1EXT要初始化的外中断号，取如下值之： EXT_INT0 EXT_INT1,EXT_INT2

33、 EXT_INT3 EXT_INT4输入参数2INTx:初始化结构参数的指针。返回U8,返回0表示配置成，返回非0表示配置错误。EXTI_InitTypeDef的定义见于文件typedef structu8 EXTI_Mode;u8 EXTI_Polity;u8 EXTI_Interrupt; EXTI_InitTypeDef;EXTI_Mode设置外中断的工作模式：初始化INTO、INT1时的取值，初始化INT2、INT3、INT4时忽略，固定为下降沿中断。EXTI_Mode 取值功能描述EXT_MODE_RiseFall外中断工作于上升、下降沿中断。EXT_MODE_Fall外中断工作于下降沿中断。EXTI_Polity :中断的优先级：初始化INTO、INT1时的取值，初始化INT2、INT3、INT4时忽略，固定为低优先级中断。EXTI_Polity 取值功能描述PolityHigh外中断设置为高优先级。PolityLow外中断设置为低优先级（默认）。EXTI_Interrupt :中断允许或禁止:EXTI_Interrupt 取值功能描述ENABLE允许外部中断。DISABLE禁止外部中断。