32位基于ARM_CortexM4微控制器KinetisK系固件庫(kù)版本本手冊(cè)介紹了32位基于ARM_CortexM4微控制器KinetisK系列的固件函數(shù)庫(kù)CKEIIAC等。此份固件庫(kù)用戶手冊(cè)的整體架構(gòu)如定義、文檔約定和固件函數(shù)固件函數(shù)庫(kù)概述（包的內(nèi)容，庫(kù)的架構(gòu)），庫(kù)使用實(shí)固件庫(kù)具體描述：設(shè)置架構(gòu)和每個(gè)外設(shè)KinetisK系列微處理器在整個(gè)文檔中被寫(xiě)作K60注：此版本為第一版庫(kù)函數(shù)，由前期各模塊函數(shù)整理而來(lái)，如遇本資料與代碼實(shí) 情況，請(qǐng)按照實(shí)例代碼操作，帶來(lái)不便還請(qǐng)見(jiàn)諒，疑問(wèn)和建議請(qǐng)加入 群進(jìn)行交流。通過(guò)本群也可獲得的模塊開(kāi)發(fā)代碼，飛思MCU/DSP超核電日期：2013年8 (不詳之處請(qǐng)參考源文件代碼 KinetisK系列固件庫(kù)戶手 .-1 錄..................................................................................................................................-2文檔和庫(kù)規(guī) 縮 命名規(guī) 編碼規(guī) 變 布爾 功能狀態(tài)類 固件函數(shù) 壓縮包描 文件夾 文件夾 文件夾 文件夾 外設(shè)的初始化和設(shè) 位段（Bit- 映射...............................................................................................................應(yīng)用實(shí) 運(yùn)行時(shí)間檢 外設(shè)固件概 通用輸入輸出模塊(GPIO)..............................................................................................-18GPIO模塊主要寄存器結(jié)構(gòu)......................................................................................-18GPIO庫(kù)函數(shù)..............................................................................................................-18GPIO_Init.............................................................................................................-18GPIO_WriteBit.....................................................................................................-20 .-20GPIO_ResetBits...................................................................................................-21GPIO_ToggleBit...................................................................................................-21GPIO_Write.........................................................................................................-22GPIO_ReadOutputDataBit...................................................................................-22GPIO_ReadOutputData.......................................................................................-22GPIO_ReadInputDataBit......................................................................................-23GPIO_ReadInputData........................................................................................-23GPIO_GetITStates..............................................................................................-23GPIO_ClearITPendingBit....................................................................................-24通用異步收發(fā)器(UART)...............................................................................................-24UART模塊主要寄存器結(jié)構(gòu)......................................................................................-24UART庫(kù)函數(shù)..............................................................................................................-25UART_Init............................................................................................................-25UART_SendData..................................................................................................-26UART_ReceiveData..............................................................................................-26UART_SendDataInt..............................................................................................-27DisyCPUInfo....................................................................................................-27UART_SendDataIntProcess.................................................................................-27UART_DMACmd..................................................................................................-28UART_DebugPortInit...........................................................................................-28UART_ITConfig....................................................................................................-28UART_GetITStatus.............................................................................................-29周期中斷定時(shí)器(PIT).....................................................................................................-29PIT模塊主要寄存器結(jié)構(gòu)..........................................................................................-29PIT庫(kù)函數(shù)..................................................................................................................-30PIT_Init................................................................................................................-30PIT_GetLoadValue...............................................................................................-31PIT_GetCurrentValue..........................................................................................-31PIT_SetLoadValue...............................................................................................-31 .-32PIT_Stop..............................................................................................................-32PIT_ITConfig........................................................................................................-32PIT_GetITStatus...................................................................................................-33PIT_ClearITPendingBit.........................................................................................-33實(shí)時(shí)時(shí)鐘(RTC)................................................................................................................-33RTC模塊主要寄存器結(jié)構(gòu)........................................................................................-34RTC庫(kù)函數(shù)................................................................................................................-34RTC_Init...............................................................................................................-34RTC_SecondIntProcess........................................................................................-34RTC_ReadData....................................................................................................-35RTC_SetData.......................................................................................................-35RTC使用實(shí)例............................................................................................................-36內(nèi)部集成電路總線(I2C).................................................................................................-36I2C模塊主要寄存器結(jié)構(gòu)..........................................................................................-36I2C庫(kù)函數(shù).................................................................................................................-37I2C_Init................................................................................................................-37I2C_GenerateSTART............................................................................................-38I2C_GenerateSTOP..............................................................................................-39I2C_SendData......................................................................................................-39I2C_Send7bitAddress..........................................................................................-39I2C_WaitAck........................................................................................................-40I2C_SetMasterMode...........................................................................................-40I2C_GenerateAck................................................................................................-40I2C_EnableAck...................................................................................................-41I2C_ITConfig......................................................................................................-41I2C_GetITStatus.................................................................................................-41I2C_DMACmd....................................................................................................-42I2C_ClearITPendingBit.......................................................................................-42I2C使用實(shí)例：..........................................................................................................-43串行外設(shè)總線 .-43SPI模塊主要寄存器結(jié)構(gòu)..........................................................................................-44SPI庫(kù)函數(shù)..................................................................................................................-44SPI_Init................................................................................................................-44SPI_ReadWriteByte.............................................................................................-47SPI_ITConfig........................................................................................................-47SPI_GetITStatus...................................................................................................-48SPI_ClearITPendingBit.........................................................................................-489.2.5SPI_DMACmd......................................................................................................-48模數(shù)轉(zhuǎn)換器(ADC).........................................................................................................-49ADC模塊主要寄存器結(jié)構(gòu)......................................................................................-49ADC庫(kù)函數(shù)..............................................................................................................-49ADC_Init............................................................................................................-49ADC_GetConversionValue.................................................................................-50ADC_ITConfig....................................................................................................-51ADC_GetITStatus...............................................................................................-51ADC_DMACmd..................................................................................................-52數(shù)模轉(zhuǎn)換器(DAC).........................................................................................................-52DAC模塊主要寄存器結(jié)構(gòu)......................................................................................-52DAC庫(kù)函數(shù)..............................................................................................................-52DAC_Init............................................................................................................-53DAC_StructInit...................................................................................................-54DAC_DMACmd..................................................................................................-54DAC_ITConfig....................................................................................................-54DAC_GetITStatus...............................................................................................-55DAC_SoftwareTrigger........................................................................................-55DAC_SetBuffer..................................................................................................-56DAC_SetValue...................................................................................................-56看門狗模塊(WDOG).....................................................................................................-56WDOG模塊主要寄存器結(jié)構(gòu)..................................................................................-57WDOG庫(kù)函 .-57WDOG_Init........................................................................................................-57WDOG_Open.....................................................................................................-57WDOG_Close.....................................................................................................-58WDOG_Feed......................................................................................................-58靈活定時(shí)器(FTM).........................................................................................................-58FTM模塊主要寄存器結(jié)構(gòu)......................................................................................-59FTM庫(kù)函數(shù).............................................................................................................-59FTM_Init............................................................................................................-59FTM__ChangeDuty...................................................................................-60直接內(nèi)存存取控制器(DMA)........................................................................................-60DMA模塊主要寄存器結(jié)構(gòu).....................................................................................-60DMA庫(kù)函數(shù)............................................................................................................-61DMA_Init...........................................................................................................-61DMA_SetEnableReq..........................................................................................-62plete..............................................................................................-62 ounter................................................................................-63 ounter...............................................................................-63DMA_ClearITPendingBit....................................................................................-63DMA_ITConfig...................................................................................................-64系統(tǒng)設(shè)置(SYS).............................................................................................................-64主要寄存器結(jié)構(gòu).....................................................................................................-64SYS函數(shù)...................................................................................................................-65SystemClockSetup.............................................................................................-65SystemSoftReset...............................................................................................-66GetCPUInfo........................................................................................................-66EnableInterrupts...............................................................................................-66DisableInterrupts..............................................................................................-67SetVectorTable..................................................................................................-6715.2.9NVIC_Init...........................................................................................................-6715.2.10 .-68延時(shí)模塊(DELAY)..........................................................................................................-68SysTick模塊主要寄存器結(jié)構(gòu).................................................................................-68DELAY函數(shù)..............................................................................................................-68DelayInit............................................................................................................-69DelayUs.............................................................................................................-69DelayMs.............................................................................................................-69使用實(shí)例.................................................................................................................-70低功耗計(jì)時(shí)器(LPTM)...................................................................................................-70LPTM模塊主要寄存器結(jié)構(gòu)....................................................................................-70LPTM函數(shù)................................................................................................................-70LPTM_Init..........................................................................................................-70pareValue..................................................................................-71pareValue..................................................................................-72LPTM_GetTimerCounterValue..........................................................................-72LPTM_ITConfig..................................................................................................-72LPTM_GetITStatus.............................................................................................-73LPTM_ClearITPendingBit...................................................................................-7317.2.9LPTM_ResetTimeCounter.................................................................................-73可編程延時(shí)模塊(PDB).................................................................................................-74PDB模塊主要寄存器結(jié)構(gòu)......................................................................................-74PDB函數(shù)..................................................................................................................-74PDB_Init.............................................................................................................-74PDB_ADC_TriggerInit........................................................................................-76PDB_ITConfig.....................................................................................................-76PDB_GetITStatus...............................................................................................-76PDB_DMACmd..................................................................................................-77PDB_ClearITPendingBit.....................................................................................-77局域網(wǎng)控制器(CAN)...................................................................................................-78CAN模塊主要寄存器結(jié)構(gòu)......................................................................................-78CAN函 .-78CAN_Init............................................................................................................-78CAN_EnableReceiveMB.....................................................................................-80CAN_Receive.....................................................................................................-80CAN_Transmit...................................................................................................-80CAN_ITConfig....................................................................................................-81CAN_GetITStatus...............................................................................................-81CAN_ClearITPendingBit.....................................................................................-82CAN_ClearAllITPendingBit.................................................................................-82FLASH器(FLASH).................................................................................................-82FLASH模塊主要寄存器結(jié)構(gòu)...................................................................................-83FLASH函數(shù)..............................................................................................................-83FLASH_Init.........................................................................................................-83FLASH_ReadByte...............................................................................................-83FLASH_WriteSector...........................................................................................-84FLASH_EraseSector...........................................................................................-84SDIO模塊(SD)............................................................................................................-84SD模塊主要寄存器結(jié)構(gòu)........................................................................................-85SD函數(shù)....................................................................................................................-85SD_Init...............................................................................................................-85SD_GetCapacity.................................................................................................-86SD_ReadSingleBlock..........................................................................................-86SD_WriteSingleBlock.........................................................................................-87觸摸感應(yīng)輸入(TSI).......................................................................................................-87TSI模塊主要寄存器結(jié)構(gòu)........................................................................................-87TSI函數(shù)....................................................................................................................-87TSI_Init..............................................................................................................-88TSI_SelfCalibration............................................................................................-89TSI_GetCounter.................................................................................................-89TSI_ITConfig.......................................................................................................-90 .-90TSI_GetChannelOutOfRangleFlag.....................................................................-90TSI_ClearITPendingBit.......................................................................................-91TSI_GetITStatus.................................................................................................-91以太網(wǎng)控制器(ENET)....................................................................................................-92ENET模塊主要寄存器結(jié)構(gòu)....................................................................................-92ENET函數(shù)................................................................................................................-92ENET_Init...........................................................................................................-92ENET_MacSendData..........................................................................................-93ENET_MacRecData............................................................................................-9323.2.7ENET_MiiLinkState............................................................................................-9324修訂記 本用戶手冊(cè)和固件函數(shù)庫(kù)按照以下章節(jié)所描述的規(guī)范編縮Table1.縮 外設(shè)/單元/作 看門狗模 Systick構(gòu)成的 看門狗模 直接內(nèi)存存取控制 通用異步串行口(串口 通用異步串行口(串口 通用輸入輸出口包括外部引 周期性中斷定時(shí) 數(shù)模轉(zhuǎn)換 數(shù)模轉(zhuǎn)換 串行外設(shè)接 CAN總線控制 CAN總線控制 電容觸摸控制模 靈活定時(shí)器波產(chǎn)生定時(shí)中斷AB相正 低功耗定時(shí)器（產(chǎn)生定時(shí) 低功耗定時(shí)器（產(chǎn)生定時(shí)中 單相脈沖計(jì)數(shù)等 MAC\PHY固件函數(shù)庫(kù)遵從以下命名規(guī)PPP表示任一外設(shè)縮寫(xiě)，例如：ADC外設(shè)函數(shù)名以該外設(shè)的縮寫(xiě)加下劃線為開(kāi)頭。每個(gè)單詞的第一個(gè)字母都由英文字母寫(xiě)書(shū)寫(xiě)，例如：RT_Sedaa。在函數(shù)名中，只允許存在一個(gè)下劃線，用以分隔外設(shè)名為P_iP_nTyeePP如GO_i.名為PPP_StructInit的函數(shù)，其功能為通過(guò)設(shè)置PPP_InitTypeDef結(jié)構(gòu)中的各種參數(shù)來(lái)定名為PPP_ITConfig的函數(shù)，其功能為使能或者失能來(lái)自外設(shè)PPP某中斷源，例如：名為PPP_GetITStatus的函數(shù)，其功能為判斷來(lái)自外設(shè)PPP的中斷發(fā)生與否，例如名為PPP_ClearITPendingBit的函數(shù)，其功能為清除外設(shè)PPP中斷待處理標(biāo)志位，例如本章節(jié)描述了固件函書(shū)庫(kù)的編碼規(guī)變signedtypedeftypedefunsignedtypedeftypedef布爾在文件sys.h中，布爾形變量被定義如下typedefenum{FALSE=0,TRUE=!FALSE}在文件sys.h中，我們定義功能狀態(tài)類型 type）的2個(gè)可能值為“使能與“失能”（ENABLEorDISABLE）typedefenum{DISABLE=0,ENABLE=!DISABLE}60固件函數(shù)庫(kù)被壓縮在一個(gè)p文件中。解壓該文件會(huì)產(chǎn)生一個(gè)文件夾,此文件夾中包含3個(gè)文件夾分別為OBJPRJSRCOBJ文件存放編譯器產(chǎn)生的文件，PRJ是建立工程的SRCb60h：xxx模塊的相關(guān)變量和宏定義。注：所有的例程的使用，都不受不同軟件開(kāi)發(fā)環(huán)境的影ARDAEh：xxx功能函數(shù)的相關(guān)變量和宏定義注：所有代碼都按照 ANSI-C標(biāo)準(zhǔn)書(shū)寫(xiě)，都不受不同軟件開(kāi)發(fā)環(huán)境的影響文件夾STARTUP包含了工程啟動(dòng)的引導(dǎo)文件和工作頻率等的設(shè)置。startup_MK60DZ10.s：Kinetis系類的啟動(dòng)引導(dǎo)文件，由KEIL軟件自帶。startup_MK60DZ10.c：Kinetis系類時(shí)鐘配置源代碼，由KEIL軟件自帶。文件夾USER包含了四個(gè)文件isr.c：Kinetis系類的啟動(dòng)引導(dǎo)文件，由KEIL軟件自帶。isr.h：Kinetis系類時(shí)鐘配置源代碼，由KEIL軟件自帶。 本節(jié)按步驟描述了如何初始化和設(shè)置任意外設(shè)。這里PPP代表任意外設(shè)在主應(yīng)用文件中，一個(gè)結(jié)構(gòu)PPP_InitTypeDef，例如 這里PPP_InitStructure是一個(gè)位于內(nèi)存中的工作變量，用來(lái)初始化一個(gè)或者多個(gè)PPP PPP_InitStructure.member2=val2;PPP_InitStructure.memberN=/*N代表結(jié)構(gòu)體的成員數(shù)量以上步驟可以合并在同一行里，用以優(yōu)化代碼大PPP_InitTypeDefPPP_InitStructure={val1,val2,..,b）僅設(shè)置結(jié)構(gòu)體中的部分成員：這種情況下，用戶應(yīng)當(dāng)首先調(diào)用函數(shù)P_Surcnt(..)來(lái)初始化變量P_nttrucue（）PP_InitStructurememberX=valX;/*X、Y代表您期望配置的參數(shù)調(diào)用函數(shù)PPP_Init(..)來(lái)初始化外設(shè)PPP在這一步，外設(shè)PPP已被初始化。可以調(diào)用函數(shù)PPP_Cmd(..)來(lái)使能之PPP_Cmd(PPP,可以通過(guò)調(diào)用一系列函數(shù)來(lái)使用外設(shè)。每個(gè)外設(shè)都擁有各自的功能函數(shù)。細(xì)節(jié)參閱外設(shè)注 在外設(shè)設(shè)置完成以后，繼續(xù)修改它的一些參數(shù)，可以參照如下步驟PPP_InitStucturememberX=valX;PPP_InitStructure.memberYvalY;*僅僅修改X、YPPP_Init(PPP,&PPP_InitStructure);//配置模塊工作位段（Bit-oex?M4包段bband段名行讀改60bbnd1置0231和232給固中位段描。映射映射給出了別名區(qū)中的每個(gè)字是如何對(duì)應(yīng)位帶區(qū)的相應(yīng)位的，如下bit_word_offset=(byte_offsetx32)+(bit_number×4)bit_word_addr=bit_band_base+bit_word_offset其中bit_word_offset是目標(biāo)位在存取器位段區(qū)中的位置 是別名器區(qū)中字的地址，它映射到某個(gè)目標(biāo)位bit_band_base 是包含目標(biāo)位的字節(jié)在位段里的序號(hào)bit_number是目標(biāo)位所在位置（0-31）下例展現(xiàn)了如何將GPIO的各個(gè)引腳映射到別名區(qū)，實(shí)現(xiàn)類似C51單片機(jī)一樣的操作//IO口操作宏定#define #defineMEM_ADDR(addr) *((volatileunsignedlong*)(addr))#defineBIT_ADDR(addr,bitnum) //IO口地址#defineGPIOA_ODR_Addr (PTA_BASE+0)//0x C#defineGPIOB_ODR_Addr (PTB_BASE+0)//0x40010C0C#defineGPIOC_ODR_Addr (PTC_BASE+0)//0x #defineGPIOD_ODR_Addr (PTD_BASE+0)//0x C#defineGPIOE_ODR_Addr (PTE_BASE+0)//0x #defineGPIOF_ODR_Addr (PTF_BASE+0)//0x40011A0C#defineGPIOG_ODR_Addr (PTG_BASE+0)//0x40011E0C#defineGPIOA_IDR_Addr (PTA_BASE+0x10)//0x#defineGPIOB_IDR_Addr #defineGPIOC_IDR_Addr (PTC_BASE+0x10)//0x#defineGPIOD_IDR_Addr #define (PTE_BASE+0x10)#define (PTF_BASE+0x10)#define (PTG_BASE+0x10)//IO口操作，只對(duì)單一的IO#definePAout(n) BIT_ADDR(GPIOA_ODR_Addr,n)//輸出#definePAin(n) //輸入#definePBout(n) BIT_ADDR(GPIOB_ODR_Addr,n)//輸出#definePBin(n) BIT_ADDR(GPIOB_IDR_Addr,n) #definePCout(n) BIT_ADDR(GPIOC_ODR_Addr,n)//輸出#definePCin(n) BIT_ADDR(GPIOC_IDR_Addr,n) #definePDout(n) BIT_ADDR(GPIOD_ODR_Addr,n)//輸出#definePDin(n) //輸入#definePEout(n) #definePEin(n) BIT_ADDR(GPIOE_IDR_Addr,n)//輸入#definePFout(n) #definePFin(n) #definePGout(n) BIT_ADDR(GPIOG_ODR_Addr,n)//輸出#definePGin(n) //輸入固件函數(shù)庫(kù)通過(guò)檢查庫(kù)函書(shū)的輸入來(lái)實(shí)現(xiàn)運(yùn)行時(shí)間錯(cuò)誤偵測(cè)。通過(guò)使asert param來(lái)實(shí)現(xiàn)運(yùn)行時(shí)間檢測(cè)。所有要求輸入?yún)?shù)的函數(shù)都使用這個(gè)宏。它可以檢查輸入?yún)?shù)是否在允許的范圍之內(nèi)。asertara的參數(shù)為aasert_aeasserparar宏assert_param編寫(xiě)于文件sysh中#ifdef#defineassert_param(expr)((expr)?(void)0:assert_failed((uint8_t*)FILE, LINE))voidassert_failed(uint8_t*file,uint32_tline);#endif/*USE_FULL_ASSERT*/函數(shù)assert_failed編寫(xiě)于文件main.c或者其他用戶C文件 voidassert_failed(uint8_t*file,uint32_t{期望發(fā)生錯(cuò)誤后所做的處}注：運(yùn)行時(shí)間檢查，即宏asser_aa應(yīng)當(dāng)只在庫(kù)在ebug模式下編譯時(shí)使用。建議在用戶應(yīng)用代碼的開(kāi)發(fā)和調(diào)試階段使用運(yùn)行時(shí)間檢查，在最終的代碼中去掉它們以改進(jìn)代碼尺如果用戶仍然希望在最終的代碼中保留這項(xiàng)功能，可以在調(diào)用庫(kù)函數(shù)前，重新使3.函數(shù) 外設(shè)函數(shù)的名函輸入?yún)?shù) 輸入?yún)?shù)描功能描 簡(jiǎn)輸入?yún)?shù) 輸入?yún)?shù)描輸出參數(shù) 輸出參數(shù)描返回返