Microchip Curiosity PIC32MZ EF 入門 - 免費RTOS

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

Microchip Curiosity PIC32MZ EF 入門

重要

此參考集成託管在亞馬遜的 FreeRTOS 存儲庫上,該存儲庫已被棄用。建議您在建立新專案時從這裡開始。如果您已經有一個現有的 FreeRTOS 專案以目前已取代的亞馬遜免費伺服器儲存庫為基礎,請參閱Amazon-FreeRTOS Github 儲存庫遷移指南.

注意

在與微晶協議下,我們將從 FreeRTOS 參考整合儲存庫主要分支移除好奇心 PIC32MZEF (DM320104),並且將不再於新版本中攜帶。微晶已發出正式通知,表示不再建議將 PIC32MZEF (DM320104) 用於新設計。PIC32MZEF 專案和原始程式碼仍可透過舊版標籤存取。微晶片建議客戶在新設計上使用好奇心 PIC32MZ-EF-2.0 開發板 (DM320209)。Pic32MZv1 平台仍然可以在 FreeRTOS 參考整合儲存庫的 v202012.00 中找到。不過,《自由服務參考》的 v202107.00 已不再支援該平台。

本教學課程提供 Microchip Curiosity PIC32MZ EF 入門指示。如果您沒有微晶片好奇心 PIC32MZ EF 套裝軟體,請造訪AWS合作夥伴裝置目錄,向我們的合作夥伴購買。

套件包含下列項目:

您也需要使用以下項目進行偵錯:

在開始之前,您必須先設定 FreeRTOSAWS IoT 並下載,才能將裝置連線到AWS雲端。如需說明,請參閱 首要步驟

重要
  • 在本主題中,FreeRTOS 下載目錄的路徑稱為freertos

  • freertos 路徑中的空格字元可能會導致建置失敗。當您複製或拷貝儲存庫時,請確定您建立的路徑不包含空格字元。

  • Microsoft Windows 的檔案路徑長度上限為 260 個字元。長 FreeRTOS 下載目錄路徑可能會導致建置失敗。

  • 由於原始程式碼可能包含符號連結,因此如果您使用 Windows 來擷取歸檔,您可能必須:

    • 啟用開發人員模式或,

    • 使用以系統管理員身分提高權限的主控台。

    如此一來,Windows 可以在擷取歸檔時正確建立符號連結。否則,符號鏈接將被寫入為普通文件,其中包含符號鏈接的路徑作為文本或為空。如需更多資訊,請參閱部落格文章:Windows 10 中的符號連結!

    如果您在 Windows 下使用 Git,您必須啟用開發人員模式,或者您必須:

    • 使用下列命令設定core.symlinks為 true:

      git config --global core.symlinks true
    • 每當您使用寫入系統的 git 命令時,請使用以管理員身份提升的主控台 (例如git pullgit clone、、和git submodule update --init --recursive)。

概要

本教學課程包含以下入門步驟的指示:

  1. 將主機板連線到主機機器。

  2. 在主機機器上安裝軟體以對微控制器主機板的內嵌應用程式進行開發和除錯。

  3. 將 FreeRTOS 示範應用程式交叉編譯為二進位映像檔。

  4. 將應用程式二進位映像載入主機板,然後執行應用程式。

  5. 透過序列連線與在開發板上執行的應用程式互動,以便進行監控和除錯。

設定 Microchip Curiosity PIC32MZ EF 硬體

  1. 將 MikroElectronika USB UART 點擊板 Connect 到 microBUS 線 1 連接器上的微型芯片好奇心 PIC32MZ EF。

  2. 將 PIC32 LAN8720 PHY 子板接到 Microchip Curiosity PIC32MZ EF 的 J18 接頭。

  3. 使用 MikroElectronika USB A 到 USB 迷你 B 電纜將 USB 單擊板 Connect 到您的計算機。

  4. 若要將電路板連接至網際網路,請使用下列其中一個選項:

    • 要使用無線網絡連接,無線 MikroElectronika 網絡連接 7 點擊板 microBUS 線 2 連接器上微芯片好奇心 PIC32MZ EF。請參閱 設定免費RTOS示範

    • 若要使用乙太網路來將 Microchip Curiosity PIC32MZ EF 電路板連接至網際網路,請將 PIC32 LAN8720 PHY 子板連接至 Microchip Curiosity PIC32MZ EF 上的 J18 標頭。將乙太網路纜線一端接到 LAN8720 PHY 子板上。將另一端接到您的路由器或其他網際網路連接埠。您還必須定義預處理器宏PIC32_USE_ETHERNET

  5. 請將轉角聯接器 (angle connector) 焊接至 Microchip Curiosity PIC32MZ EF 的 ICSP 頂蓋 (若發現未焊接)。

  6. 將 PICkit 3 Programming Cable Kit 的 ICSP 纜線一端連接至 Microchip Curiosity PIC32MZ EF。

    若您沒有 PICkit 3 Programming Cable Kit,可改為使用 M-F Dupont 跳線做連接。請注意,白色圓形表示接腳 1 (Pin 1) 的位置。

  7. 將 ICSP 纜線 (或跳線) 的另一端連接到 MPLAB Snap Debugger。電路板右下方黑色三角形的標示為 8 針腳 SIL Programming Connector 的接腳 1。

    請確認連接至 Microchip Curiosity PIC32MZ EF 接腳 1 (標示為白色) 的線路與 MPLAB Snap Debugger 的接腳 1 對齊。

    如需有關 MPLAB 鎖點除錯器的詳細資訊,請參閱 MPLAB 鎖點在線除錯器資訊表

使用 PICkit On Board (PKOB) 設定 Microchip Curiosity PIC32MZ EF 硬體

建議您遵循上一節的設定程序。不過,您可以依照下列步驟,使用整合式 PicKit 主機版 (PKOB) 程式設計工具/偵錯工具來評估和執行 FreeRTOS 示範,並進行基本偵錯。

  1. 將 MikroElectronika USB UART 點擊板 Connect 到 microBUS 線 1 連接器上的微型芯片好奇心 PIC32MZ EF。

  2. 若要將電路板連接至網際網路,請執行下列其中一項操作:

    • 要使用無線網絡連接,無線 MikroElectronika 網絡連接 7 點擊板 microBUS 線 2 連接器上微芯片好奇心 PIC32MZ EF。(按照設定免費RTOS示範中的 「設定 Wi-Fi」步驟進行)。

    • 若要使用乙太網路來將 Microchip Curiosity PIC32MZ EF 電路板連接至網際網路,請將 PIC32 LAN8720 PHY 子板連接至 Microchip Curiosity PIC32MZ EF 上的 J18 標頭。將乙太網路纜線一端接到 LAN8720 PHY 子板上。將另一端接到您的路由器或其他網際網路連接埠。您還必須定義預處理器宏PIC32_USE_ETHERNET

  3. 使用 USB type A 轉 USB micro-B 纜線,將 Microchip Curiosity PIC32MZ EF 電路板上名為「USB DEBUG」(USB 偵錯) 的 USB micro-B 連接埠連接至電腦。

  4. 使用 MikroElectronika USB A 到 USB 迷你 B 電纜將 USB 單擊板 Connect 到您的計算機。

設定開發環境

注意

這個裝置的 FreeRTOS 專案是以 MPLAB 和諧 v2 為基礎。若要建置專案,您需要使用與 Harmony v2 相容的 MPLAB 工具,例如 MPLAB XC32 的 v2.10 版和 MPLAB Harmony Configurator (MHC) 的 2.X.X 版。

  1. 安裝 Python 3.x 版或更新版本。

  2. 安裝 MPLAB X IDE:

    注意

    目前僅支援 FreeRTOS 軟體AWS參考整合功能。先前版本的 FreeRTOSAWS 參考整合功能在 MPLabv5.40 上受到支援。

  3. 安裝 MPLAB XC32 編譯器:

  4. 啟動 UART 終端機模擬器,並使用以下設定開啟連線:

    • 傳輸速率:115200

    • 資料:8 位元

    • 同位:無

    • 停止位元:1

    • 流量控制:無

在雲端中監控 MQTT 訊息

在執行 FreeRTOS 示範專案之前,您可以在主控台中設定 MQTT 用戶端,以監AWS IoT控裝置傳送至AWS雲端的訊息。

使用 AWS IoT MQTT 用戶端訂閱 MQTT 主題
  1. 登入 AWS IoT 主控台

  2. 在導覽窗格中,選擇 [測試],然後選擇 [MQTT 測試用戶端] 以開啟 MQTT 用戶端。

  3. 訂閱主題中輸入 your-thing-name/example/topic,然後選擇訂閱主題

當演示項目成功運行在您的設備上,你會看到「你好世界!」 多次發送到您訂閱的主題。

建置並執行 FreeRTOS 示範專案

在 MPLAB IDE 中開啟 FreeRTOS 使用者示範

  1. 開啟 MPLAB IDE。如果您已安裝多個版本的編譯器,您需要選擇想在 IDE 內使用的編譯器。

  2. File (檔案) 選單中,選擇 Open Project (開啟專案)

  3. 瀏覽至 projects/microchip/curiosity_pic32mzef/mplab/aws_demos 並將它開啟。

  4. 選擇 Open project (開啟專案)

注意

在您首次開啟專案時,您可能會收到有關編譯器的錯誤訊息。在 IDE 中,導覽至 Tools (工具)Options (選項)Embedded (內嵌),然後選擇您要用於專案的編譯器。

若要使用乙太網路連線,您必須定義預處理器巨集PIC32_USE_ETHERNET

若要使用乙太網路透過 MPLAB IDE 進行連線
  1. 在 MPLAB IDE 中,以滑鼠右鍵按一下專案,然後選擇「內容」

  2. 在 [專案屬性] 對話方塊中,選擇 [編譯器名稱 (全域選項)] 以展開它,然後選取 [編譯器名稱- gcc]。

  3. 在 [選項] 類別中,選擇 [預處理] 和 [訊息],然後將字PIC32_USE_ETHERNET串新增至預處理器巨集

執行 FreeRTOS 示範專案

  1. 重新組建專案。

  2. Projects (專案) 標籤中,以滑鼠右鍵按一下 aws_demos 最上層資料夾,然後選擇 Debug (除錯)

  3. 當除錯器停在 main() 中斷點時,請從 Run (執行) 功能表,選擇 Resume (繼續)

使用 CMake 建置 FreeRTOS 使用者示範

如果您不想使用 IDE 進行 FreeRTOS 開發,也可以使用 CMake 來構建和運行使用第三方代碼編輯器和調試工具開發的演示應用程序或應用程序。

若要使用 CMake 建置 FreeRTOS 體示範
  1. 創建一個目錄以包含生成的構建文件,例如構建目錄

  2. 使用下列命令從源代碼中產生文件。

    cmake -DVENDOR=microchip -DBOARD=curiosity_pic32mzef -DCOMPILER=xc32 -DMCHP_HEXMATE_PATH=path/microchip/mplabx/version/mplab_platform/bin -DAFR_TOOLCHAIN_PATH=path/microchip/xc32/version/bin -S freertos -B build-folder
    注意

    您必須指定 Hexmate 和工具鏈二進位檔的正確路徑,例如C:\Program Files (x86)\Microchip\MPLABX\v5.35\mplab_platform\binC:\Program Files\Microchip\xc32\v2.40\bin路徑。

  3. 將目錄更改為構建目錄(構建目錄),然後make從該目錄運行。

如需詳細資訊,請參閱搭配使用 FreeRTOS 體

若要使用乙太網路連線,您必須定義預處理器巨集PIC32_USE_ETHERNET

疑難排解

如需故障診斷資訊,請參閱故障診斷入門