雾化器库使用说明.doc

雾化器库使用说明本文档为赛元提供的雾化器库的使用说明，雾化器库支持1.7M频率和2.4M频率的雾化片，库提供了函数接口进行设置。其中1.7M雾化片适用于大功率加湿器（功率在15W以上），2.4M雾化片适用于小功率的香薰机（功率在6-12W）。雾化器库提供了自动追频、功率设置、雾化工作、触控检水功能。库共提供了11个函数接口供用户调用，实现雾化器功能。1、 雾化器库介绍：雾化器Atomizer文件夹中包含：SC91F832_C.H MCU头文件Atomizer.h 包含雾化器外部调用接口函数SOC_Atomizer_lib_V0.1.LIB 雾化器库文件实现雾化器工作需要占用一定的系统资源，雾化器库资源占用：ROM：1.8K DATA: 50BYTE XDATA:60BYTE定时器：定时器0PWM： PWM1 ADC：两路ADCEEPROM: 4byteTouch Key: 两路2、 雾化器的工作流程3、 雾化器库函数接口和接口说明雾化器库共提供10个函数接口和3个全局变量：变量：bit TrackFreqFlag; 变量说明：追频完成标志0：未完成；1：完成 变量：bit AjustPowerFlag; 变量说明：功率调整完成标志0：未完成；1：完成变量：bit Water_flag; 变量说明：水位检测输出结果 0：缺水；1：有水函数：bit SOCAPI_GetTrackFreqStaus(void); 函数功能：获取雾化器追频状态，返回1为已追频，0为未追频函数：void SOCAPI_SetFreq(void) ; 函数功能：设置雾化器工作频率，当得到已追踪过频率可以调用该函数设置雾化器的频率函数：void SOCAPI_Atomizer_Init(INT8U mode);函数说明：雾化器初始化，设置PWM和定时器0;设置mode为0时雾化器的工作频率设置为1.7M;mode为1时为2.4M函数：void SOCAPI_TrackFreq_Init(void);函数功能：雾化器追频初始化，设置了追频所需的变量，需要在追频前调用函数：void SOCAPI_TrackFreq(void);函数功能：雾化器追频，该函数需要在SOCAPI_TrackFreq_Init之后在主程序中一直调用，直到TrackFreqFlag变量置1，追频完成后进入功率调整函数：void SOCAPI_AtomizerSetPower(INT8U Power);函数功能：设置雾化器工作时最大档功率，1.7M:设置范围 15-21W；2.4M：设置范围6-12W函数：void SOCAPI_AdjustPower(void); 函数功能：进行功率调整，将最大档功率调制到设定功率，需要在SOCAPI_AtomizerSetPower之后调用函数：void SOCAPI_AtomizerSetGear(INT8U Gear);函数功能：设置档位，16档可调，0为低档，16为高档位，用户可以在当中选择任意档位作为目标功率函数：void SOCAPI_AtomizerWork(void);函数说明：雾化器雾化工作，该函数需要在主函数中无阻塞调用函数: void SOCAPI_WaterLevelDetectorInit(INT16U Initial_Diff,int ThresholdTmp,INT8U Speed); 函数说明：水位检测初始化，设置水位检测参数函数：void SOCAPI_WaterLevelDetector(void);函数功能：水位检测，检测结果由Water_flag输出四、雾化器库的具体使用 雾化器库使用准备： 雾化器的检水功能需要使用到Touch Key，赛元提供触控库帮助用户使用赛元的触控功能，具体使用见触控库的使用说明或者联系赛元的工程师，在项目工程中添加触控库；采集TK通道的数据，设置main.h中以下三个参数：#define CH_INITIAL_DIFF 668参数说明：检测通道与参考通道的初始比例，采样通道无水时RAWdata/参考通道RAWdata*1000#define WATERThresholdtmp 1300参数说明：检测通道有无水差值*0.6，如完全覆的差值为2166，则设置为1300。 #define WATERCHECK_SPEED 20参数说明：水位检测的确认次数 ，取值范围10-249，确认时间为10*Nms 通过函数SOCAPI_WaterLevelDetectorInit()进行设置； 本软件库适用于赛元的SC91F831和SC91F832芯片，用户使用时需将Atomizer文件夹添加到项目工程中，并在KEIL项目中添加Atomizer文件夹中的SOC_Atomizer_lib_V0.1.LIB，1、 在工程主文件中调用雾化器库文件#include AtomizerAtomizer.h /包含雾化器外部调用接口函数2、 清除EEPROM空间在主文件中加入INT8U code EE_Data4=0,0,0,0; /清除EEPROM的空间设置工程配置的BL51 Locate选项卡中的CODE为?CO?MAIN(0X1f00)3、 初始化雾化器工作根据使用的雾化片频率调用函数SOCAPI_Atomizer_Init(0); 对雾化器进行初始化4、 水位检测初始化调用以下函数对雾化器进行初始化，该函数需要在水位检测函数调用前进行设置SOCAPI_WaterLevelDetectorInit(CH_INITIAL_DIFF,WATERThresholdtmp,WATERCHECK_SPEED);5、 查询是否追频调用函数SOCAPI_GetTrackFreqStaus，返回是否已追踪过频率，若已追频则调用函数SOCAPI_SetFreq设置雾化器工作的频率，若未追踪过频率则进行追频6、 追踪频率调用函数SOCAPI_AtomizerSetPower设置雾化器工作的最大档功率，建议加湿器设置为16-21W，香薰机设置为6-12W；设置雾化器的功率后调用SOCAPI_TrackFreq_Init()对追频进初始化；在主函数中无阻塞的调用函数SOCAPI_TrackFreq_Init直到TrackFreqFlag变量置1，追频完成后进入功率调整7、 功率调整追频完成后将ADC切换到检测电流的ADC口，无阻塞调用函数 SOCAPI_AdjustPower进行功率调整，将最大档的功能调整到设定值；由于器件差异，调整后功率误差在正负1W左右；8、 雾化器雾化在主函数中无阻塞的调用函数SOCAPI_AtomizerWork()进行雾化工作，切勿在追频和调整功率过程调用该函数9、 档位调整在雾化器正常雾化过程可以调用函数SOCAPI_AtomizerSetGear进行设置档位，函数支持16吉档位设置，雾化器库将最大档均分成16级档位，用户可以根据所需的各档位功率选择合适的档位作为实际工作的档位。10、 检测水位雾化器库已经在雾化时调用了水位检测函数，检测结果由Water_flag输出，若用户需要在雾化器不正常雾化下检水则需要在主函数中调用程序段： if(SOCAPI_TouchKeyStatus&0x80)/ Bit7：一轮按键扫描是否完成