一、构建源工程和待提交工程
1.1、构建源工程
1、先创建两个文件夹,分别作为源工程和待提交工程
2、打开CUBEMX,根据比赛的芯片型号选择(C1117-M4是STM32G431RBT6),然后打开工程
3、NVIC,SYS不用动,RCC中的最上面High Speed Clock改为晶振那个(Crystal/.....)
4、打开上面四个的Clock Configuration,进行时钟树配置
5、点开TOOL,然后命名,地址,ApplicationStructure选Basic,Toolchain为MDK
6、要把这个鼠标放置的地方选上,这样生成的代码就会有相应的独立的.c文件
注意:这时生成的keil文件还无法使用,编译会报错,因为少了一个启动文件,这时我们需要从比赛时给我们的LCD液晶驱动参考例程中选择下面这个文件
然后放到源文件的里面,如下图
然后在keil中添加一下
6、打开keil,点开魔术棒,改成DAP那个
1.2、构建待提交工程
直接把源工程内部的文件copy就行
注:可以把时钟配置部分的函数放到bsp中间层,然后打包成一个文件rcc
二、添加bsp_led和bsp_led文件
2.1、如何构建bsp中间层
1、先在project文件夹里建两个文件,一个是inc(放置.h文件),一个为src(放置.c文件),两个文件里面都建bsp文件
2、需要什么功能就建立什么文件夹,例如led,key等
注:下面建立文件各种bsp_xxx文件就不多赘述
2.2、建立bsp_key或者bsp-led文件
1、对照上方原理图,根据题目要求设置PA0,PB0,PB1,PB2的工作模式(注意为输入模式,led对应引脚为输出)
2、由于上面led为共阳极,所以要想led在上电后是灭的状态,就要设置默认电平为high
然后把原工程MDK中股票那个文件里的定义部分转移到bsp_led或者bsp_key文件中,在编译后出现的.h文件中添加main.h
2.3、文件里的子函数(不包括定义)
led
//函数名:LED_Disp
//入口参数:ucLed
//出口参数:void
//函数功能:LD8-LD1对应ucLed的8个位
void LED_Disp(unsigned char ucLed)
{
//**将所有的灯熄灭
HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13|GPIO_PIN_14|GPIO_PIN_15|GPIO_PIN_8
|GPIO_PIN_9|GPIO_PIN_10|GPIO_PIN_11|GPIO_PIN_12, GPIO_PIN_SET);
HAL_GPIO_WritePin(GPIOD, GPIO_PIN_2, GPIO_PIN_SET);
HAL_GPIO_WritePin(GPIOD, GPIO_PIN_2, GPIO_PIN_RESET);
//根据ucLed的数值点亮相应的灯
HAL_GPIO_WritePin(GPIOC, ucLed<<8, GPIO_PIN_RESET);
HAL_GPIO_WritePin(GPIOD, GPIO_PIN_2, GPIO_PIN_SET);
HAL_GPIO_WritePin(GPIOD, GPIO_PIN_2, GPIO_PIN_RESET);
}
key
unsigned char Key_Scan(void)
{
unsigned char unKey_Val = 0;
if(HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_0) == GPIO_PIN_RESET)
unKey_Val = 1;
if(HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_1) == GPIO_PIN_RESET)
unKey_Val = 2;
if(HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_2) == GPIO_PIN_RESET)
unKey_Val = 3;
if(HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) == GPIO_PIN_RESET)
unKey_Val = 4;
return unKey_Val;
}
2.4、main.c里面的函数
创建控制速度的变量
Key_Proc()
void Key_Proc(void)
{
if((uwTick - uwTick_Key_Set_Point)<3000) return;//减速函数
uwTick_Key_Set_Point = uwTick;
//pwm借用
if(jj == 400) jj = 700;
else jj = 400;
__HAL_TIM_SET_COMPARE(&htim15,TIM_CHANNEL_1,jj);
//分成几种情况
//情况1:100ms两次扫描,按键得到的结果从0(都没按下)到B4按下,产生了下降沿。
//ucKey_Val = 4(0000 0100)
//unKey_Down = 0000 0100 & ( 0000 0000 ^ 0000 0100) = 0000 0100 & 0000 0100 = 0000 0100 (4)
//ucKey_Up = 1111 1011 & 0000 0100 = 0000 0000
//ucKey_Old = 4
//情况2:B4产生了下降沿后,按键一直按着
//ucKey_Val = 4(0000 0100)
//unKey_Down = 0000 0100 & ( 0000 0100 ^ 0000 0100) = 0000 0100 & 0000 0000 = 0000 0000 (0)
//ucKey_Up = 1111 1011 & 0000 0000 = 0000 0000
//ucKey_Old = 4
//情况3:B4按键一直按着随后弹起
//ucKey_Val = 0(0000 0000)
//unKey_Down = 0000 0000 & ( 0000 0100 ^ 0000 0000) = 0000 0000 & 0000 0100 = 0000 0000 (0)
//ucKey_Up = 1111 1111 & 0000 0100 = 0000 0100 (4)
//ucKey_Old = 0
ucKey_Val = Key_Scan();
unKey_Down = ucKey_Val & (ucKey_Old ^ ucKey_Val);
ucKey_Up = ~ucKey_Val & (ucKey_Old ^ ucKey_Val);
ucKey_Old = ucKey_Val;
if(unKey_Down == 4)
{
LED_Disp(0x88);
}
if(unKey_Down == 3)
{
LED_Disp(0x00);
}
}
三、构建bsp_lcd文件
因为lcd涉及到字库等信息,比赛的时候官方会给出相关文件的,直接添加即可,lcd.c复制到提交工程的src中,把lcd.h和fonts.h复制到inc中(当然该怎么添加上面有)
四、构建bsp_usart文件
注意事项:
1、注意在Driver层中添加uart.c文件,并且要把#define HAL_UART_MODULE_ENABLED 注释部分解除掉
2、如果卡在接收中断里,绝大部分可能是因为优先级不对(uart的优先级比滴答的优先级高要调)
3、在最开始定义中注意时钟配置中也会有usart1的东西,注意复制到相关位置
4、要在main.c中把void Error_Handler(void)写出来,如下
五、构建bsp_adc文件
1、按照这个硬件在cubemx中pb15和pb12引脚选相应的,然后在左侧栏中选择adc进行配置
配置时钟(ADC也需要配置时钟) 时钟相关的代码不要忘记改
2、先把相对应的通道使能
3、下面的Configuration按照下面配置
实际上就修改了两个,一个是异步二分频,另一个是采样时间
4、在bsp层添加bsp_adc.c文件和bsp_adc.h文件
5、把生成的代码粘贴到文件里
6、要在main.h中打开adc相关命令(和usart那个一样)
7、底层添加adc的代码
8、添加相关函数
(1)、getadc()
打开,然后读取数值,返回数值
六、构建bsp_iic文件
I2C不需要我们去初始化,比赛会给出相应的文件(注意是hal那个)
代码内容是需要修改的,下面是需要修改的部分:
(1)、因为bsp中间层构建不同的原因,需要修改头文件名称,由#include"i2c.h"改为#include"I2C\bsp_i2c.h"
(2)、在I2CWaitAck(void)函数(I2C等待确认信号)中右下面图片中上面那张改为下面那张
就是把Output_Mode 那个函数挪到最下面
自己还需要添加的代码,具体内容如下:
//24C02的相关代码
void iic_24c02_write(unsigned char *pucBuf, unsigned char ucAddr, unsigned char ucNum)
{
I2CStart();
I2CSendByte(0xa0);
I2CWaitAck();
I2CSendByte(ucAddr);
I2CWaitAck();
while(ucNum--)
{
I2CSendByte(*pucBuf++);
I2CWaitAck();
}
I2CStop();
delay1(500);
}
void iic_24c02_read(unsigned char *pucBuf, unsigned char ucAddr, unsigned char ucNum)
{
I2CStart();
I2CSendByte(0xa0);
I2CWaitAck();
I2CSendByte(ucAddr);
I2CWaitAck();
I2CStart();
I2CSendByte(0xa1);
I2CWaitAck();
while(ucNum--)
{
*pucBuf++ = I2CReceiveByte();
if(ucNum)
I2CSendAck();
else
I2CSendNotAck();
}
I2CStop();
}
//MCP4017的相关代码
void write_resistor(uint8_t value)
{
I2CStart();
I2CSendByte(0x5E);
I2CWaitAck();
I2CSendByte(value);
I2CWaitAck();
I2CStop();
}
uint8_t read_resistor(void)
{
uint8_t value;
I2CStart();
I2CSendByte(0x5F);
I2CWaitAck();
value = I2CReceiveByte();
I2CSendNotAck();
I2CStop();
return value;
}
七、构建bsp_basic_tim.c文件
别忘了要改中断优先级
要在main.h中打开tim相关命令(和usart,和adc那个一样)
也要加入tim.c(有了就不用加了,一般有了)
1、使能TIM6
注意配置预分频系数(Prescaler)和计数大小(Counter-Period)的时候要注意要减1,
注意:要打开中断
输入捕获:
PA15选TIM2_CH1和PB4定时器三的通道一
配置TIM2和TIM3,两个配置是一样的,下面以TIM2为例
1、打开从模式
然后第一个通道上升沿触发,第二个通道下降沿触发
注意:这个也要打开中断
PWM输出
输出比较
注意:这个也要打开中断
main.c
#include "main.h"
#include "led\bsp_led.h"
#include "key\bsp_key.h"
#include "lcd\bsp_lcd.h"
#include "usart\bsp_usart.h"
#include "iic\bsp_iic.h"
#include "adc\bsp_adc.h"
#include "basic_tim6\bsp_basic_tim6.h"
#include "pwm\bsp_pwm.h"
#include "rtc\bsp_rtc.h"
//变量创建区
__IO uint32_t uwTick_Key_Set_Point = 0;//控制Key_Proc的执行速度
__IO uint32_t uwTick_Lcd_Set_Point = 0;//控制Lcd_Proc的执行速度
__IO uint32_t uwTick_Usart_Set_Point = 0;//控制Usart_Proc的执行速度
unsigned char i;
unsigned int jj = 400;
//*按键扫描专用变量
unsigned char ucKey_Val, unKey_Down, ucKey_Up, ucKey_Old;
//*LCD显示专用变量
unsigned char Lcd_Disp_String[21];//最多显示20个字符
//*串口专用变量
int counter = 0;
char str[40];
unsigned char rx_buffer;
//*EEPROM的相关变量
unsigned char EEPROM_String_1[5] = {0x11,0x22,0x33,0x44,0x55};
unsigned char EEPROM_String_2[5] = {0};
//*4017相关变量
uint8_t RES_4017;
//*pwm相关变量
uint16_t PWM1_T_Count;
uint16_t PWM2_T_Count;
uint16_t PWM1_D_Count;
uint16_t PWM2_D_Count;
float PWM1_Duty;
float PWM2_Duty;
//**rtc相关变量
RTC_TimeTypeDef H_M_S_Time;
RTC_DateTypeDef Y_M_D_Date;
uint8_t Second;
//子函数声明区
void SystemClock_Config(void);
void Key_Proc(void);
void Lcd_Proc(void);
void Usart_Proc(void);
//主函数
int main(void)
{
//内核和时钟的初始化
HAL_Init();
SystemClock_Config();
//外设函数的初始化
LED_Init();
KEY_Init();
LCD_Init();
LCD_Clear(White);
LCD_SetBackColor(White);
LCD_SetTextColor(Blue);
USART1_Init();
I2CInit();
ADC1_Init();
ADC2_Init();
BASIC_TIM6_Init();//1s中断一次
HAL_TIM_Base_Start_IT(&htim6);
//对定时器3的通道1进行初始化配置,从模式,捕获通道1的数值
PWM_Input_TIM3_Init();
/* 启动定时器 */
// HAL_TIM_Base_Start_IT(&htim3);
HAL_TIM_Base_Start(&htim3);
/* 启动定时器通道输入捕获并开启中断 */
HAL_TIM_IC_Start_IT(&htim3,TIM_CHANNEL_1);
HAL_TIM_IC_Start_IT(&htim3,TIM_CHANNEL_2);
//对定时器2的通道1进行初始化配置,从模式,捕获通道1的数值
PWM_Input_TIM2_Init();
/* 启动定时器 */
HAL_TIM_Base_Start(&htim2);
/* 启动定时器通道输入捕获并开启中断 */
HAL_TIM_IC_Start_IT(&htim2,TIM_CHANNEL_1);
HAL_TIM_IC_Start_IT(&htim2,TIM_CHANNEL_2);
//利用定时器输出方波的初始化程序
Squ_Output_TIM4_Init();
/* 启动CH1比较输出 */
HAL_TIM_OC_Start_IT(&htim4,TIM_CHANNEL_1);
HAL_TIM_OC_Start_IT(&htim4,TIM_CHANNEL_2);
//利用定时器15输出PWM波
PWM_Output_TIM15_Init();
/* 启动通道PWM输出 */
HAL_TIM_PWM_Start(&htim15,TIM_CHANNEL_1);
HAL_TIM_PWM_Start(&htim15,TIM_CHANNEL_2);
//**EEPROM测试
iic_24c02_write(EEPROM_String_1, 0, 5);
HAL_Delay(1);
iic_24c02_read(EEPROM_String_2, 0, 5);
//**MCP4017测试
write_resistor(0x77);
RES_4017 = read_resistor();
//**串口中断打开
HAL_UART_Receive_IT(&huart1, &rx_buffer, 1);
//RTC的初始化
RTC_Init();
while (1)
{
Key_Proc();
Lcd_Proc();
Usart_Proc();
}
}
void Key_Proc(void)
{
if((uwTick - uwTick_Key_Set_Point)<3000) return;//减速函数
uwTick_Key_Set_Point = uwTick;
//pwm借用
if(jj == 400) jj = 700;
else jj = 400;
__HAL_TIM_SET_COMPARE(&htim15,TIM_CHANNEL_1,jj);
//分成几种情况
//情况1:100ms两次扫描,按键得到的结果从0(都没按下)到B4按下,产生了下降沿。
//ucKey_Val = 4(0000 0100)
//unKey_Down = 0000 0100 & ( 0000 0000 ^ 0000 0100) = 0000 0100 & 0000 0100 = 0000 0100 (4)
//ucKey_Up = 1111 1011 & 0000 0100 = 0000 0000
//ucKey_Old = 4
//情况2:B4产生了下降沿后,按键一直按着
//ucKey_Val = 4(0000 0100)
//unKey_Down = 0000 0100 & ( 0000 0100 ^ 0000 0100) = 0000 0100 & 0000 0000 = 0000 0000 (0)
//ucKey_Up = 1111 1011 & 0000 0000 = 0000 0000
//ucKey_Old = 4
//情况3:B4按键一直按着随后弹起
//ucKey_Val = 0(0000 0000)
//unKey_Down = 0000 0000 & ( 0000 0100 ^ 0000 0000) = 0000 0000 & 0000 0100 = 0000 0000 (0)
//ucKey_Up = 1111 1111 & 0000 0100 = 0000 0100 (4)
//ucKey_Old = 0
ucKey_Val = Key_Scan();
unKey_Down = ucKey_Val & (ucKey_Old ^ ucKey_Val);
ucKey_Up = ~ucKey_Val & (ucKey_Old ^ ucKey_Val);
ucKey_Old = ucKey_Val;
if(unKey_Down == 4)
{
LED_Disp(0x88);
}
if(unKey_Down == 3)
{
LED_Disp(0x00);
}
}
void Lcd_Proc(void)
{
if((uwTick - uwTick_Lcd_Set_Point)<100) return;//减速函数
uwTick_Lcd_Set_Point = uwTick;
// i++;
//RTC借用
HAL_RTC_GetTime(&hrtc, &H_M_S_Time, RTC_FORMAT_BIN);//读取日期和时间必须同时使用
HAL_RTC_GetDate(&hrtc, &Y_M_D_Date, RTC_FORMAT_BIN);
sprintf((char *)Lcd_Disp_String, "Time:%02d-%02d-%02d",(unsigned int)H_M_S_Time.Hours,(unsigned int)H_M_S_Time.Minutes,(unsigned int)H_M_S_Time.Seconds);
LCD_DisplayStringLine(Line0, Lcd_Disp_String);
sprintf((char *)Lcd_Disp_String, "TIM6_Count_Num: %03d",(unsigned int)i);
LCD_DisplayStringLine(Line1, Lcd_Disp_String);
sprintf((char *)Lcd_Disp_String, "EE:%x%x%x%x%x R:%x",EEPROM_String_2[0],EEPROM_String_2[1],EEPROM_String_2[2],EEPROM_String_2[3],EEPROM_String_2[4], RES_4017);
LCD_DisplayStringLine(Line2, Lcd_Disp_String);
sprintf((char *)Lcd_Disp_String, "RES_K:%5.2fK",0.7874*RES_4017);
LCD_DisplayStringLine(Line3, Lcd_Disp_String);
sprintf((char *)Lcd_Disp_String, "VOLTAGE:%6.3fV",3.3*((0.7874*RES_4017)/(0.7874*RES_4017+10)));
LCD_DisplayStringLine(Line4, Lcd_Disp_String);
sprintf((char *)Lcd_Disp_String, "R38_Vol:%6.3fV",((((float)getADC1())/4096)*3.3));
LCD_DisplayStringLine(Line6, Lcd_Disp_String);
sprintf((char *)Lcd_Disp_String, "R37_Vol:%6.3fV",((((float)getADC2())/4096)*3.3));
LCD_DisplayStringLine(Line7, Lcd_Disp_String);
sprintf((char *)Lcd_Disp_String, "PWM1:%05dHz,%4.1f%%",(unsigned int)(1000000/PWM1_T_Count),PWM1_Duty*100);
LCD_DisplayStringLine(Line8, Lcd_Disp_String);
sprintf((char *)Lcd_Disp_String, "PWM2:%05dHz,%4.1f%%",(unsigned int)(1000000/PWM2_T_Count),PWM2_Duty*100);
LCD_DisplayStringLine(Line9, Lcd_Disp_String);
}
void Usart_Proc(void)
{
if((uwTick - uwTick_Usart_Set_Point)<500) return;//减速函数
uwTick_Usart_Set_Point = uwTick;
// sprintf(str, "%04d:Hello,world.\r\n", counter);
// HAL_UART_Transmit(&huart1,(unsigned char *)str, strlen(str), 50);
if(++counter == 10000)
counter = 0;
}
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart)
{
LED_Disp(0xff);
HAL_Delay(300);
LED_Disp(0x00);
HAL_UART_Receive_IT(&huart1, &rx_buffer, 1);
}
//计数器更新中断回调函数
void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)
{
if(htim->Instance==TIM6)
{
i++;
HAL_TIM_Base_Start_IT(&htim6);
}
}
//输入捕获中断回调函数
void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim)
{
if(htim->Instance==TIM2)
{
if(htim->Channel == HAL_TIM_ACTIVE_CHANNEL_1)
{
PWM2_T_Count = HAL_TIM_ReadCapturedValue(htim,TIM_CHANNEL_1)+1;
PWM2_Duty = (float)PWM2_D_Count/PWM2_T_Count;
}
else if(htim->Channel == HAL_TIM_ACTIVE_CHANNEL_2)
{
PWM2_D_Count = HAL_TIM_ReadCapturedValue(htim,TIM_CHANNEL_2)+1;
}
}
if(htim->Instance==TIM3)
{
if(htim->Channel == HAL_TIM_ACTIVE_CHANNEL_1)
{
PWM1_T_Count = HAL_TIM_ReadCapturedValue(htim,TIM_CHANNEL_1)+1;
PWM1_Duty = (float)PWM1_D_Count/PWM1_T_Count;
}
else if(htim->Channel == HAL_TIM_ACTIVE_CHANNEL_2)
{
PWM1_D_Count = HAL_TIM_ReadCapturedValue(htim,TIM_CHANNEL_2)+1;
}
}
}
//方波输出中断
void HAL_TIM_OC_DelayElapsedCallback(TIM_HandleTypeDef *htim)
{
if(htim->Instance==TIM4)
{
if(htim->Channel == HAL_TIM_ACTIVE_CHANNEL_1)
{
__HAL_TIM_SET_COMPARE(htim,TIM_CHANNEL_1,(__HAL_TIM_GetCounter(htim)+200));//5Khz
}
else if(htim->Channel == HAL_TIM_ACTIVE_CHANNEL_2)
{
__HAL_TIM_SET_COMPARE(htim,TIM_CHANNEL_2,(__HAL_TIM_GetCounter(htim)+500)); //1Khz
}
}
}
void SystemClock_Config(void)
{
RCC_OscInitTypeDef RCC_OscInitStruct = {0};
RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};
RCC_PeriphCLKInitTypeDef PeriphClkInit = {0};
/** Configure the main internal regulator output voltage
*/
HAL_PWREx_ControlVoltageScaling(PWR_REGULATOR_VOLTAGE_SCALE1);
/** Initializes the RCC Oscillators according to the specified parameters
* in the RCC_OscInitTypeDef structure.
*/
RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
RCC_OscInitStruct.HSEState = RCC_HSE_ON;
RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
RCC_OscInitStruct.PLL.PLLM = RCC_PLLM_DIV3;
RCC_OscInitStruct.PLL.PLLN = 20;
RCC_OscInitStruct.PLL.PLLP = RCC_PLLP_DIV2;
RCC_OscInitStruct.PLL.PLLQ = RCC_PLLQ_DIV2;
RCC_OscInitStruct.PLL.PLLR = RCC_PLLR_DIV2;
if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
{
Error_Handler();
}
/** Initializes the CPU, AHB and APB buses clocks
*/
RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
|RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2;
RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;
RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV1;
RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1;
if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2) != HAL_OK)
{
Error_Handler();
}
/** Initializes the peripherals clocks
*/
PeriphClkInit.PeriphClockSelection = RCC_PERIPHCLK_RTC|RCC_PERIPHCLK_USART1
|RCC_PERIPHCLK_ADC12;
PeriphClkInit.Usart1ClockSelection = RCC_USART1CLKSOURCE_PCLK2;
PeriphClkInit.Adc12ClockSelection = RCC_ADC12CLKSOURCE_SYSCLK;
PeriphClkInit.RTCClockSelection = RCC_RTCCLKSOURCE_HSE_DIV32;
if (HAL_RCCEx_PeriphCLKConfig(&PeriphClkInit) != HAL_OK)
{
Error_Handler();
}
}
/**
* @brief This function is executed in case of error occurrence.
* @retval None
*/
void Error_Handler(void)
{
/* USER CODE BEGIN Error_Handler_Debug */
/* User can add his own implementation to report the HAL error return state */
__disable_irq();
while (1)
{
}
/* USER CODE END Error_Handler_Debug */
}
#ifdef USE_FULL_ASSERT
/**
* @brief Reports the name of the source file and the source line number
* where the assert_param error has occurred.
* @param file: pointer to the source file name
* @param line: assert_param error line source number
* @retval None
*/
void assert_failed(uint8_t *file, uint32_t line)
{
/* USER CODE BEGIN 6 */
/* User can add his own implementation to report the file name and line number,
ex: printf("Wrong parameters value: file %s on line %d\r\n", file, line) */
/* USER CODE END 6 */
}
#endif /* USE_FULL_ASSERT */
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/