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
- 開啟您的 Arduino IDE。
- 點選上方選單列的 「草稿碼 (Sketch)」。
- 選擇 「匯入程式庫 (Include Library)」。
- 點擊 「加入 .ZIP 程式庫... (Add .ZIP Library...)」。
- 在彈出的視窗中,選擇您剛剛下載的
SdFat-master.zip檔案並按下「開啟」,IDE 便會在右下角提示安裝成功。
▲ 圖 1:SdFat 程式庫必須透過下載 ZIP 檔手動匯入,且日後千萬不可進行全域更新。
🛑 第三部分:開發防呆重要提醒
因為這個 SdFat 程式庫版本,已經由開發者針對 Datalogger 主板與軟體 SPI 進行了「客製化最佳調整」。
日後當您開啟 Arduino IDE,且電腦有連上網路時,IDE 右下角經常會跳出提示:
「部分程式庫有更新檔。(Some libraries have updates available.)」
- 請絕對不要點擊「全部安裝 (Update All)」!
- 請務必選擇「稍後 (Later)」或是「手動安裝 (Manual Install)」。
若您不小心點擊了全部更新,原本為 Datalogger 最佳化的設定檔將會被官方標準版覆蓋,這會導致您的 SD 卡功能失效,甚至是與 LoRa 模組發生衝突當機。若不慎覆蓋,請重新執行上述的 ZIP 檔匯入步驟即可修復。