00.開發(fā)指南入門aworks m1050sdk快速keil v1.04

1、UM01010101V1.0.0Date:2018/11/21廣州致遠電子類別內(nèi)容AWorks、SDK、Keil、i.MX RT105x摘 要本文描述了 Keil 開發(fā)環(huán)境的搭建、同時簡單介紹了如何在 Keil 中編寫、編譯、調(diào)試 SDK 程序UserManual修訂歷史版本日期原因發(fā)布 1.0.02018/11/21創(chuàng)建文檔目錄1.2.簡介1搭建開發(fā)環(huán)境2環(huán)境簡介22.1.1 Keil Vision 集成開發(fā)環(huán)境22.12.1.2 J-Link器22.2MDK-ARM 軟件安裝22.2.1 MDK-ARM 軟件獲取22.2.2 MDK-ARM 軟件安裝4支持包（PACK）安裝82.32.4安

2、裝 J-Link 軟件及器驅(qū)動102.4.1 J-Link 軟件安裝10器驅(qū)動安裝122.4.2 J-Link3.編寫應用程序173.1 從模板新建工程173.1.1 打開工程183.2 編寫程序203.3 編譯程序21調(diào)試應用程序234.4.1準備工作234.1.1 連接器234.1.2 啟動方式配置234.1.3 目標板上電24在 SDRAM 中調(diào)試應用程序244.2.1 J-Link 調(diào)試配置244.2.2 開始調(diào)試304.2.3 停止調(diào)試36在 QSPI Flash 中調(diào)試應用程序364.24.34.3.14.3.24.3.3添加 FLM36J-Link 調(diào)試配置37配置 QSPI F

3、lash 啟動46開始調(diào)試464.3.4程序到 QSPI Flash484.4免責Keil 直接5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501.簡介本文主要介紹如何在 Keil Vision 集成開發(fā)環(huán)境中使用 aworks_m105x_sdk_1.0.0-alpha 軟件包進行工

4、程的導入、新建工程、編譯Vision 集成開發(fā)環(huán)境下的應用程序開發(fā)。文檔中對應的硬件為 M105x_EV_Board 開發(fā)板，軟件模版為 img_rt1050_debug_mdk，其它目標硬件或 SDK 的用法相同。和調(diào)試等操作，幫助用戶快速掌握 Keil2. 搭建開發(fā)環(huán)境2.1 環(huán)境簡介2.1.1 Keil Vision 集成開發(fā)環(huán)境Keil Vision 是原是 Keil 公司開發(fā)的一個集成開發(fā)環(huán)境，目前共有 Vision2、Vision3、Vision4 以及 Vision5 幾個版本。Keil Vision 對應的安裝文件為 MDK-ARM。MDK-ARM 包含了完整的軟件開發(fā)環(huán)境。安

5、裝后，可用于開發(fā)基于 Cortex-M、Cortex-R4、ARM7 和 ARM9 內(nèi)核的微控制器。MDK-ARM 是為微控制器應用程序開發(fā)特別設(shè)計的，非常容易學習和使用，適用于目前大部分的應用程序開發(fā)。2.1.2 J-Link器J-Link 是 SEGGER 公司為支持ARM 內(nèi)核推出的同時支持 JTAG/SWD 調(diào)試接口的器。配合 Keil Vision，IAR EWAR，ADS，eclipse，WINARM，RealView 等集成開發(fā)環(huán)境支持所有 Cortex-M、Cortex-R4、ARM7、ARM9、ARM11 內(nèi)核RDI 接口和各集成開發(fā)環(huán)境無縫連接。的，通過2.2 MDK-AR

6、M 軟件安裝2.2.1 MDK-ARM 軟件獲取進入ht/download/product/ 這個 ARM，然后點擊如 圖 1 所示的紅色方框，進入到下一個頁面。圖 1: MDK-ARM網(wǎng)頁在下一個頁面中，拷貝 Flexlicense 序列號，用于圖 2 所示。各個版本的 MDK-ARM 軟件，如圖 2: 拷貝 Flexlicense 序列號拷貝完成后，返回到上一個界面，在【PSN or LLC】輸入選項中，粘貼輸入剛才拷貝的Flexlicense 序列號，再點擊【Submit】選項，進入下一個頁面，如 圖 3 所示。在接下來出現(xiàn)的頁面中會各種 MDK-ARM 版本的，可見目前最新的 MDK-

7、ARM 版本為 V5.24a，推薦用戶使用我司驗證過的 MDK-ARM V5.17 版本來進行應用開發(fā)。本文默認使用的 Keil 版本為 5.17，點擊如 圖 4 所示的紅色方框即可進行。圖 4:MDK-ARM V5.172.2.2 MDK-ARM 軟件安裝完成后，雙擊剛剛的 MDK-ARM V5.17 軟件，開始進行 MDK-ARM V5.17 的安裝，軟件安裝過程如下：1、軟件開始安裝后，在安裝向?qū)ы撁纥c擊 【下一步】，如 圖 5 所示。圖 5: MDK-ARM 安裝向?qū)?12、勾選 【I agree】，使安裝能往下進行，如 圖 6 所示。圖 6: MDK-ARM 安裝向?qū)?23、選擇安裝

8、路徑為默認安裝路徑 (推薦使用默認安裝路徑，確有特殊需要可點擊【Browse】 選擇其它安裝路徑)，如 圖 7 所示。圖 7: MDK-ARM 選擇安裝目錄4、進入用戶信息填寫界面，如圖 8 所示，根據(jù)實際情況填入相關(guān)用戶信息，然后點擊【Next】。圖 8: 填寫用戶信息5、接下來，MDK-ARM 便開始安裝。如 圖 9 所示。圖 9: MDK-ARM 安裝進行中6、在安裝過程結(jié)束之后，彈出如 圖 10 所示的框，如果不需要查看版本相關(guān)的說明，可以取消默認勾選上的【Show Release Notes】，然后點擊【Finish】完成安裝，此時會在桌面看到如 圖 11 所示的圖標。圖 10: 安

9、裝完成圖 11: MDK-ARM 應用程序圖標2.3 支持包（PACK）安裝Keil5 相對之前的版本，增加了軟件接口，并且為支持的微控制器提供了軟件支持包。如需使用一款具體，需要先安裝該的 Pack 支持包。在 01. 開發(fā)環(huán)境中提供了NXP.MIMXRT1052_DFP.10.0.1.pack 軟件支持包，使用 Pack Installer 進行安裝。點擊 Keil 界面中的圖標啟動 Pack Installer，如 圖 12 所示。Pack Installer 窗口如圖 13 所示，選擇【File】- 【import】，彈出 Import Packs框，選擇剛剛的 Pack，如 圖 14

10、 所示，點擊【打開】，進行安裝。接著，可以觀察 Pack Installer 窗口進度條，查看安裝進度，直至安裝完成。圖 12: 啟動 Pack installer圖 13: Pack installer 窗口圖 14: 選擇需要安裝的 Pack2.4 安裝 J-Link 軟件及2.4.1 J-Link 軟件安裝器驅(qū)動J-Link器可以作為開發(fā)板的調(diào)試器，首次使用需要安裝 J-Link 軟件。在“M105x系列光盤資料 V04. 軟件開發(fā)指南04. 軟件開發(fā)指南02.器驅(qū)動” 目錄中，我們提供了 “JLink_Windows_V614b.exe” 版本的 JLink 軟件，用戶無需自行。左鍵雙

11、擊 J-link 軟件后，開始進行安裝，安裝過程如下：1、軟件開始安裝后，在安裝向?qū)ы撁纥c擊 【Next】，如 圖 15 所示。圖 15: J-Link 軟件安裝向?qū)?、點擊 【I Agree】，使安裝能往下進行，如 圖 16 所示。注意: V614b 版本 JLink 兼容性較好，推薦使用此版本。圖 16: J-Link 軟件安裝向?qū)?、選擇安裝路徑為默認安裝路徑 (然后點擊 【Install】，如 圖 17 所示。特殊需要可點擊【Browse】選擇其它安裝路徑)，4、等待安裝完成后，會彈出提示界面，點擊 【Finish】 結(jié)束安裝，如 圖 18 所示。1圖 18: J-Link 軟件成功安

12、裝2.4.2 J-Link器驅(qū)動安裝首次使用 J-Link器時，一般情況下，如果安裝了 J-Link 軟件，只要用 USB 線將 PC機和 J-Link器連接起來，即可自動完成驅(qū)動的安裝。驅(qū)動安裝完成后，可以在設(shè)備管理器（鼠標選中計算機- 右鍵- 管理- 設(shè)備管理器）中看到 J-Link 設(shè)備，如 圖 19 所示。1圖 19: J-Link器驅(qū)動已正確安裝若無法自動完成安裝，則可以選擇手動安裝，按照以下步驟操作即可：1、通過 USB 數(shù)據(jù)線將 J-Link器和 PC 機連接起來，打開設(shè)備管理器（鼠標選中計算機- 右鍵- 管理- 設(shè)備管理器），打開后如 圖 20 所示?？梢钥吹?【其它設(shè)備】 中

13、，有一個帶黃色感嘆號的 【J-Link】。1圖 20: J-Link器驅(qū)動安裝出錯2、雙擊帶黃色感嘆號的【J-Link】，選中右擊后，選擇【更新驅(qū)動程序】。接著彈出選擇如何搜索驅(qū)動程序軟件序軟件】 這一選項。框，如 圖 21 所示，在圖中選擇【瀏覽計算機以查找驅(qū)動程1圖 21: 選擇更新驅(qū)動程序的方式3、接著設(shè)置驅(qū)動程序路徑，如 圖 22 所示，填入 J-Link 軟件安裝目錄下相應驅(qū)動程序的路徑即可，也可以選擇【瀏覽】找到驅(qū)動程序的目錄。對應的驅(qū)動程序路徑即為：C:Program Files (x86)SEGGERJLink_V614bUSBDriverx64，如果是 32 位系統(tǒng)，路徑的末

14、尾應該是 x86。選擇路徑后，直接點擊 【下一步】 進入驅(qū)動安裝，等待安裝結(jié)束即可1圖 22: 選擇驅(qū)動程序路徑安裝結(jié)束后，可以在設(shè)備管理器中看到如 圖 19 所示的界面，表明驅(qū)動已經(jīng)正確安裝，J-Link器可以正常使用。至此，基于 i.MX RT105x 的 Keil 快速入門所需要的開發(fā)環(huán)境已經(jīng)搭建完畢。13.編寫應用程序下面簡單介紹一下在 Keil Vision 中使用 aworks_m105x_sdk_1.0.0-alpha 軟件包在M105x_EV_Board 開發(fā)板上進行應用程序開發(fā)的常見操作，如工程導入與新建，編譯及調(diào)試等。約定在本文中的 aworks_m105x_sdk_1.0

15、.0-alpha 軟件包簡稱為 SDK，并以 SDK 代表該軟件包的根目錄。3.1 從模板新建工程SDK 中提供了工程模板，位于 SDKprojectsimg_rt1050_debug_mdk 。用戶無需“從零”開始建立工程。只需要簡單的拷貝一份工程模板，然后命名為自己的工程名字即可。如圖 23 所示，是初始時 SDKprojects 目錄下文件視圖，img_rt1050_debug_mdk 為工程模板。圖 23: 工程模板所在目錄如需新建工程，如建立名為led 的工程，直接一份 img_rt1050_debug_mdk 并粘貼（注意：只能粘貼在 SDKprojects 目錄下，即與 img_

16、rt1050_debug_mdk 處于同一級目錄，不可隨意拷貝、粘貼于 SDK 的其它地方）。粘貼后如圖 24 所示。1注意: SDK 包不能放在中文路徑下，否則調(diào)試時有可能找不到源文件。圖 24:一份模板工程模板工程成功后，然后將 img_rt1050_debug_mdk - 副本重命名為自己期望的工程名即可，如命名為 led。重命名后如 圖 25 所示。圖 25: 重命名工程目錄至此，“新建”工程完成。3.1.1 打開工程打開 led 目錄，如 圖 26 所示1圖 26: led 工程目錄只要正確安裝了 Keil，雙擊 圖 26 中的 imxrt105x.uvprojx 即可打開工程。打開

17、后如 圖27 所示。圖 27: 打開工程1圖 28: 顯示工程結(jié)構(gòu)3.2 編寫程序在工程窗口中，目錄user_code 是存放用戶程序的地方，點擊user_code 前面的“+”號可以顯示該結(jié)點下所有的文件，雙擊main.c，便會出現(xiàn)main.c 的代碼編輯窗口，如圖 29 所示。圖 29: main.c 代碼編輯窗口main.c 中用戶程序的是 am_main() ，類似于 C 程序開發(fā)時的 main() 。3.3 編譯程序程序編寫好后，就需要編譯程序，編譯無誤后才能30 所示的 Build 圖標，開始編譯整個工程。到開發(fā)板上實際運行。點擊如 圖圖 30: 編譯工程工程開始編譯后，【Buil

18、d Output】 窗口中會不斷輸出相關(guān)的編譯信息。編譯完成后，可看到如 圖 31 所示。2圖 31: Build Output 最終輸出信息24. 調(diào)試應用程序4.1 準備工作4.1.1 連接J-Link器器支持 JTAG 與 SWD 兩種調(diào)試接口，本文中 M105x_EV_Board 開發(fā)板使用的是 SWD 調(diào)試接口，它們引腳的對應關(guān)系如 圖 32 所示。圖 32: J-Link 與 SWD 引腳關(guān)系對應圖查看開發(fā)板底板上的版本號，按照圖 32 中 SWD 引腳根據(jù)名稱對應連接到 J-Link 引腳器就能正確識別出內(nèi)核與 ID 了。當中，4.1.2 啟動方式配置M105x_EV_Board

19、 開發(fā)板 J10 模塊（啟動方式配置模塊）如 圖 33 所示。圖 33: 啟動模式配置用戶需根據(jù)自己選擇的編譯方式，參照 表 1 配置開發(fā)板為對應的啟動模式。2注意: 本文中使用的器為 J-Link V9。表 1: 啟動方式配置對照表4.1.3 目標板上電正確連接好 J-Link器后，使用外接的 9-12V 電源為 M105x_EV_Board 開發(fā)板供電。4.2 在 SDRAM 中調(diào)試應用程序4.2.1 J-Link 調(diào)試配置硬件準備就緒后，需進行 J-Link 調(diào)試配置，調(diào)試配置只需配置一次。進行配置前，需要確保目標選擇為“Debug sdram”或“Release sdram”，一般使用

20、“Debug sdram”目標進行調(diào)試。如 圖 34 所示：圖 34: 選擇目標然后點擊如圖35 所示的【Target Options】圖標，彈出工程的配置窗口，切換到【Debug】設(shè)置頁面，如 圖 36 所示圖 35: 進入工程設(shè)置2注意: 在程序時，必須用條線帽短接 WDG，硬件看門狗。完成后重啟時可以拔掉 WDG 條線帽。編譯模式啟動方式啟動方式配置Debug sdramsdram 啟動 (掉電丟失)用跳線帽短接 WDG 和 CFG6Release sdramDebug flexspi flashspi flash 啟動 (掉電不丟失)用跳線帽短接 WDGRelease flexspi

21、flash圖 36: 工程配置窗口2、如使用 J-Link示。器，在下拉框中選擇【J-LINK/J-TRACE Cortex】 ，如圖 37 所圖 37: 選用 J-LINK/J-TRACE Cortex 進行23、如圖示，點擊【J-LINK/J-TRACE Cortex】 旁邊的【Settings】 ，將會彈出器的配置選項，如 圖 39 所示。圖 38: 設(shè)置 J-LINK/J-TRACE Cortex2圖 39: J-LINK Debug for ARM 配置選項4、由于器默認設(shè)置的是 JTAG 接口，需要切換到 SWD 接口，才能發(fā)現(xiàn)內(nèi)核，以便程序。在 J-Link器配置頁面中選擇 SW

22、D 調(diào)試接口，如 圖 40 所示。選正確、擇后，即可發(fā)現(xiàn)內(nèi)核，如圖 41 所示。本配置頁面中其他配置選項全部默認設(shè)置即可，無需修改。2圖 40: 選擇 SWD 調(diào)試接口圖 41: 發(fā)現(xiàn)內(nèi)核25. 在 圖 41 中點擊 【確定】 ，回到工程配置窗口，點擊 【Utilites】 選項卡，如 圖 42 。圖 42: 選擇 Utilities在 Utilites 主界面勾選“Use External Tool Flash Programming”選項，如 圖 43 所示。并點擊【OK】工程配置，至此完成了所有的調(diào)試配置工作。2注意: 如切換到 SWD 調(diào)試接口后，還是未發(fā)現(xiàn)內(nèi)核，請檢查開發(fā)板是否正確供

23、電， 器與開發(fā)板是否正確連接，以及器與 PC 是否連接。圖 43: Utilities 設(shè)置4.2.2 開始調(diào)試完成上述設(shè)置后，再次點擊如 圖 44 所示的 Build 圖標，待程序編譯完畢。圖 44: 重新編譯程序點擊如 圖 45 所示的 Debug 圖標啟動調(diào)試。30/51圖 45: 啟動調(diào)試等待程序完成，即進入調(diào)試界面，如 圖 46 所示。3圖 46: 調(diào)試界面進入調(diào)試界面后，在 圖 47 中點擊 Peripherals 外設(shè)寄存器窗口可以查看外設(shè)寄存器的信息; 使用快捷鍵 Ctrl + B 可以查看當前設(shè)置斷點的信息，如 圖 48 ，如果當前沒有設(shè)置斷點，則在斷點窗口顯示空白。同時還可

24、以使用以下常用的調(diào)試方法對應用程序進行調(diào)試：3圖 47: 查看外設(shè)寄存器窗口圖 48: 查看斷點窗口1. 設(shè)置斷點3在代碼行左邊空白處單擊鼠標左鍵可以設(shè)置一個斷點，設(shè)置成功后將出現(xiàn)一個紅色小圓點（如需取消斷點，再次單擊即可）。如在 main() 函數(shù)中代碼行添加一個斷點。如 圖 49所示。圖 49: 設(shè)置斷點2. 常用調(diào)試按鈕調(diào)試過程中，常常需要使用到的操作按鈕，如 圖 50 所示。它們的作用如 表 2 所示。3注意: 所謂斷點，即在進入調(diào)試模式后，如果點擊全速運行，則程序運行至此處時將自動暫停，再次雙擊即可取消斷點。圖 50: 調(diào)試中使用到的操作按鈕表 2: 各調(diào)試按鈕含義點擊如圖 51 所

25、示的全速運行圖標，程序便會開始全速運行，運行至斷點設(shè)置處即會自動暫停，如 圖 52 中紅色方框標記部分所示。圖 51: 全速運行3按鈕作用全速運行 (遇到斷點或手動暫停時暫停程序)暫停程序執(zhí)行 (只有當程序處于全速運行狀態(tài)時有效)運行至當前光標所在行單步執(zhí)行一行程序 (遇到函數(shù)時，會進入函數(shù)繼續(xù)單步執(zhí)行)單步執(zhí)行一行程序 (遇到函數(shù)時，函數(shù)也被當做一行程序執(zhí)行)運行程序至本函數(shù)復位器件，重新開始執(zhí)行程序圖 52: 運行至斷點設(shè)置處4.2.3 停止調(diào)試若不再需要調(diào)試程序，則點擊如 圖 53 所示的停止調(diào)試圖標調(diào)試。圖 53:調(diào)試調(diào)試之后，即可回到代碼編輯窗口后，此時用戶可以重新編輯修改代碼，修改

26、完成并重新編譯通過后，可按照 4.2.2 小節(jié)介紹的方法再一次進入調(diào)試。4.3 在 QSPI Flash 中調(diào)試應用程序SDKprojects 中的示例工程支持將程序直接到 M1052板上的 QSPI Flash, 并可在 QSPI Flash 中調(diào)試應用程序，但需要用戶手動添加 Flash 燒寫算法到的 Keil 的安裝目錄下。4.3.1 添加 FLMM1052 光盤資料中“04. 軟件開發(fā)指南04. 燒寫工具M1052_IS25LP064A_FLMM1052”目錄下 M1052_IS25LP064A.FLM 文件到“C:Keil_v5ARMFlash”(Keil 的默認安裝位置是 C 盤，

27、用戶需使用自己的 Keil 安裝路徑) 目錄下。如 圖 54 所示：3圖 54: 添加 FLM 文件4.3.2 J-Link 調(diào)試配置1、目標選擇“Debug flexpsi flash”或“Release flexpsi flash”, 一般選擇“Debug flexpsiflash”進行調(diào)試，如 圖 55 所示。圖 55: 選擇 QSPI Flash 調(diào)試目標然后點擊如圖56 所示的【Target Options】圖標，彈出工程的配置窗口，切換到【Debug】設(shè)置頁面，如 圖 57 所示圖 56: 進入工程設(shè)置3圖 57: 工程配置窗口2、如使用 J-Link示。器，在下拉框中選擇【J-L

28、INK/J-TRACE Cortex】 ，如圖 58 所圖 58: 選用 J-LINK/J-TRACE Cortex 進行33、如圖 59 所示，點擊【J-LINK/J-TRACE Cortex】 旁邊的【Settings】 ，將會彈出器的配置選項，如 圖 60 所示。圖 59: 設(shè)置 J-LINK/J-TRACE Cortex3圖 60: J-LINK Debug for ARM 配置選項4、由于器默認設(shè)置的是 JTAG 接口，需要切換到 SWD 接口，才能發(fā)現(xiàn)內(nèi)核，以便程序。在 J-Link器配置頁面中選擇 SWD 調(diào)試接口，如 圖 61 所示。選正確、擇后，即可發(fā)現(xiàn)內(nèi)核，如圖 62 所示

29、。本配置頁面中其他配置選項全部默認設(shè)置即可，無需修改。40/51圖 61: 選擇 SWD 調(diào)試接口圖 62: 發(fā)現(xiàn)內(nèi)核4點擊 【確定】 ，配置完成，回到工程配置窗口，點擊 【OK】 ，如 圖 63 。圖 63: 完成配置5. 如 圖 64 所示，點擊 【Flash Download】 進入 Flash配置界面，在 Flash配置界面，點擊 【Add】 添加 Flash算法，如 圖 65 所示。4注意: 如切換到 SWD 調(diào)試接口后，還是未發(fā)現(xiàn)內(nèi)核，請檢查開發(fā)板是否正確供電， 器與開發(fā)板是否正確連接，以及器與 PC 是否連接。圖 64: 進入 Flash配置圖 65: 添加 Flash 算法在接

30、下來彈出的算法列表中，選中“ZLG_M1052_IS25LP064A_RevC”，并點擊【Add】4退回到 Flash配置主界面，如 圖 66 所示。圖 66: 選擇 Flash 算法在 Flash配置主界面，修改算法使用的 RAM 容量為 0x8000，然后點擊 【確定】到配置主界面，如 圖 67 所示。圖 67: 設(shè)置 RAM 容量46. 在配置主界面中，如 圖 68 所示選擇 【Utilities】 選項卡，Utilities 主界面選擇“UseTarget Driver for Flash Programming”，如 圖 69 所示。最后點擊【OK】至此完成了所有的 J-Link 調(diào)

31、試配置工作。工程配置。圖 68: 選擇 Utilities4圖 69: Utilities 設(shè)置4.3.3 配置 QSPI Flash 啟動M105x_EV_Board 開發(fā)板可以由用戶選擇啟動方式，在 QSPI Flash 上調(diào)試應用程序，需提前將啟方式設(shè)置為 QSPI Flash 啟動，配置方式參照 4.1.2 。4.3.4 開始調(diào)試完成上述設(shè)置后，再次點擊如 圖 70 所示的 Build 圖標，待程序編譯完畢。圖 70: 重新編譯程序點擊如 圖 71 所示的 Debug 圖標啟動調(diào)試。4圖 71: 啟動調(diào)試等待程序完成，即進入調(diào)試界面，如 圖 72 所示。圖 72: QSPI_Flash 調(diào)試界面4程序的調(diào)試方法與在 SDRAM 中調(diào)試程序的方法一樣，請參見 4.2.2 小