SD Card 專屬程式庫 (SdFat) 安裝指南

Datalogger IoT 實戰:
SD Card 專屬程式庫 (SdFat) 安裝指南

手動匯入最佳化版本,確保本地資料儲存穩定運行

在 Datalogger IoT 專案中,SD 卡扮演著「離線資料備份」的關鍵角色。為了確保 SD 卡能與 LoRa 通訊模組完美地在主板上雙軌運行(避免 SPI 匯流排衝突),開發者已經對 SD 卡的 SdFat 程式庫 進行了深度的底層最佳化。

⚠️ 因此,我們不能直接從 Arduino IDE 的程式庫管理員下載,而是必須「手動下載 ZIP 檔」來進行安裝!


📥 安裝步驟:下載與匯入 .ZIP 程式庫

Step 1. 下載專屬 SdFat 壓縮檔

請前往 Datalogger IoT 的官方 GitHub 程式庫下載頁面:
👉 Datalogger_Iot / libraries 頁面

在該頁面中,找到名為 SdFat-master.zip 的檔案,點擊進入後,按下右側的下載按鈕(Download raw file),將這個 ZIP 壓縮檔儲存到您的電腦中。

Step 2. 匯入 Arduino IDE

  1. 開啟您的 Arduino IDE
  2. 點選上方選單列的 「草稿碼 (Sketch)」
  3. 選擇 「匯入程式庫 (Include Library)」
  4. 點擊 「加入 .ZIP 程式庫... (Add .ZIP Library...)」
  5. 在彈出的視窗中,選擇您剛剛下載的 SdFat-master.zip 檔案並按下「開啟」,IDE 便會在右下角提示安裝成功。
1. GitHub 下載專屬版本 📁 libraries / SdFat-master.zip ⬇️ 下載 ZIP 檔 2. Arduino IDE 匯入 .ZIP 草稿碼 (Sketch) 驗證/編譯 上傳 匯入程式庫 鐾 加入 .ZIP 程式庫... ! ⚠️ 極度重要:絕對不要更新此程式庫! 當 Arduino IDE 啟動並跳出「部分程式庫有更新檔」時, 請務必點擊「稍後」「手動安裝」,千萬不要覆蓋掉優化版本!

▲ 圖 1:SdFat 程式庫必須透過下載 ZIP 檔手動匯入,且日後千萬不可進行全域更新。


🛑 第三部分:開發防呆重要提醒

因為這個 SdFat 程式庫版本,已經由開發者針對 Datalogger 主板與軟體 SPI 進行了「客製化最佳調整」

日後當您開啟 Arduino IDE,且電腦有連上網路時,IDE 右下角經常會跳出提示:
「部分程式庫有更新檔。(Some libraries have updates available.)」

  • 請絕對不要點擊「全部安裝 (Update All)」!
  • 請務必選擇「稍後 (Later)」或是「手動安裝 (Manual Install)」。

若您不小心點擊了全部更新,原本為 Datalogger 最佳化的設定檔將會被官方標準版覆蓋,這會導致您的 SD 卡功能失效,甚至是與 LoRa 模組發生衝突當機。若不慎覆蓋,請重新執行上述的 ZIP 檔匯入步驟即可修復。