電子發(fā)燒友App
標(biāo)準(zhǔn)外設(shè)庫(kù)遵從以下命名規(guī)則 PPP表示任一外設(shè)縮寫，例如：ADC。源程序文件和頭文件命名都以“stm32f10x_”作為開頭，例如：stm32f10x_conf.h。常量?jī)H被應(yīng)用于一個(gè)文件的，定義于該文件中；被應(yīng)用于多個(gè)文件的，在對(duì)應(yīng)頭文件中定義。所有常量都由英文字母大寫書寫。寄存器作為常量處理。他們的命名都由英文字母大寫書寫。在大多數(shù)情況下，他們采用與縮寫規(guī)范一致。外設(shè)函數(shù)的命名以該外設(shè)的縮寫加下劃線為開頭。每個(gè)單詞的第一個(gè)字母都由英文字母大寫書寫，例如：SPI_SendData。在函數(shù)名中，只允許存在一個(gè)下劃線，用以分隔外設(shè)縮寫和函數(shù)名的其它部分。對(duì)于函數(shù)命名，總的來(lái)說(shuō)有以下規(guī)則：
l 名為PPP_Init的函數(shù)，其功能是根據(jù)PPP_InitTypeDef中指定的參數(shù)，初始化外設(shè)PPP，例如TIM_Init.
l 名為PPP_DeInit的函數(shù)，其功能為復(fù)位外設(shè)PPP的所有寄存器至缺省值，例如TIM_DeInit.
l 名為PPP_Init的函數(shù)，其功能為通過(guò)設(shè)置PPP_InitTypeDef 結(jié)構(gòu)中的各種參數(shù)來(lái)定義外設(shè)的功能，例如：USART_Init .
l 名為PPP_Cmd的函數(shù)，其功能為使能或者失能外設(shè)PPP，例如： SPI_Cmd.
l 名為PPP_ITConfig的函數(shù)，其功能為使能或者失能來(lái)自外設(shè)PPP某中斷源，例如： RCC_ITConfig.
l 名為PPP_DMAConfig的函數(shù)，其功能為使能或者失能外設(shè)PPP的DMA接口，例如：TIM1_DMAConfig.
l 用以配置外設(shè)功能的函數(shù)，總是以字符串“Config”結(jié)尾，例如GPIO_PinRemapConfig.
l 名為PPP_GetFlagStatus的函數(shù)，其功能為檢查外設(shè)PPP某標(biāo)志位被設(shè)置與否，例如：I2C_GetFlagStatus.
l 名為PPP_ClearFlag的函數(shù)，其功能為清除外設(shè)PPP標(biāo)志位，例如：I2C_ClearFlag.
l 名為PPP_GetITStatus的函數(shù)，其功能為判斷來(lái)自外設(shè)PPP的中斷發(fā)生與否，例如：I2C_GetITStatus.
l 名為PPP_ClearITPendingBit的函數(shù)，其功能為清除外設(shè)PPP中斷待處理標(biāo)志位，例如： I2C_ClearITPendingBit.
這樣的命名方式非常便于程序的編寫和閱讀，以標(biāo)準(zhǔn)外設(shè)庫(kù)中的示例函數(shù)為例，下面摘錄了STM32F10x_StdPeriph_Examples\ADC\3ADCs_DMA\mian.c中的一段程序。
1 DMA_InitType Def DMA_InitStructure; 2 3 /* DMA1 channel1 configuration ----------------------------------------------*/ 4 5 DMA_DeInit(DMA1_Channel1); 6 7 DMA_InitStructure.DMA_PeripheralBaseAddr = ADC1_DR_Address; 8 9 DMA_InitStructure.DMA_MemoryBaseAddr = (uint32_t)&ADC1ConvertedValue; 10 11 DMA_InitStructure.DMA_DIR = DMA_DIR_PeripheralSRC; 12 13 DMA_InitStructure.DMA_BufferSize = 1; 14 15 DMA_InitStructure.DMA_PeripheralInc = DMA_PeripheralInc_Disable; 16 17 DMA_InitStructure.DMA_MemoryInc = DMA_MemoryInc_Disable; 18 19 DMA_InitStructure.DMA_PeripheralDataSize = DMA_PeripheralDataSize_HalfWord; 20 21 DMA_InitStructure.DMA_MemoryDataSize = DMA_MemoryDataSize_HalfWord; 22 23 DMA_InitStructure.DMA_Mode = DMA_Mode_Circular; 24 25 DMA_InitStructure.DMA_Priority = DMA_Priority_High; 26 27 DMA_InitStructure.DMA_M2M = DMA_M2M_Disable; 28 29 DMA_Init(DMA1_Channel1, &DMA_InitStructure); 30 31 /* Enable DMA1 channel1 */ 32 33 DMA_Cmd(DMA1_Channel1, ENABLE);
工商網(wǎng)監(jiān)
評(píng)論