elehobica/pico_fatfs

📦 FatFs cho Raspberry Pi Pico/Pico 2 — SPI & SPI PIO双模式, hỗ trợ exFAT

Thư viện FatFs chính thống R0.15 được port sẵn cho RP2040/RP2350, cho phép chọn SPI hardware (tốc độ cao) hoặc SPI PIO (gán chân tự do) chỉ bằng một lệnh cấu hình.

pico_fatfs là bản port của thư viện FatFs nổi tiếng của Elm-Chan (phiên bản R0.15) lên nền tảng Raspberry Pi Pico (RP2040) và Pico 2 (RP2350). Dự án cung cấp sẵn lớp trừu tượng SPI hai chế độ: dùng khối SPI hardware gốc của vi điều khiển khi chân gán tuân theo quy ước, hoặc tự động chuyển sang SPI PIO (lập trình I/O có thể lập trình) khi cần gán chân tùy ý. Hỗ trợ đầy đủ các loại thẻ SD/SDHC/SDXC và hệ thống tệp FAT16, FAT32, exFAT — phù hợp cho ghi log dữ liệu, lưu hình ảnh, firmware update hoặc bất kỳ ứng dụng nhúng nào cần lưu trữ cục bộ tin cậy. Mã nguồn đi kèm project test benchmark tốc độ đọc/ghi, sơ đồ mạch tham chiếu và hướng dẫn build chi tiết cho cả Linux/macOS và Windows.

✨ Điểm nổi bật

• Hai chế độ SPI: SPI hardware (spi0/spi1) cho hiệu năng tối đa, SPI PIO (NULL) cho gán chân tự do — chuyển đổi tự động qua pico_fatfs_set_config().
• Hỗ trợ exFAT: Bổ sung định dạng exFAT bên cạnh FAT16/FAT32, cho phép lưu tệp >4 GB trên thẻ SDXC.
• Tương thích Pico & Pico 2: Đã test trên RP2040 (Pico/Pico W) và RP2350 (Pico 2/Pico 2W).
• Cấu hình clock linh hoạt: clk_slow 100 kHz (khởi tạo) và clk_fast 50 MHz (vận hành), tần số thực tế tối đa 31.25 MHz (RP2040) / 37.5 MHz (RP2350) cho SPI hardware, 20.83 / 25 MHz cho SPI PIO.
• Pull-up nội bộ/ngoài: Bật/tắt pull-up cho MISO/MOSI qua tham số pullup trong cấu hình.
• GPIO yếu tố yếu: Cảnh báo độ dài dây nối Pico–thẻ SD rất nhạy cảm, khuyến nghị dây ngắn để tránh lỗi Mount/Preallocation/Write fail.
• Benchmark sẵn có: Project test đo tốc độ đọc/ghi thực tế giúp đánh giá hiệu năng trước khi tích hợp.
• Build hệ thống Pico SDK chuẩn: Hướng dẫn clone pico-sdk, pico-examples, pico-extras cùng cấp, biến môi trường PICO_SDK_PATH/EXTRAS_PATH/EXAMPLES_PATH, xác nhận với Pico SDK 2.1.1.

💡 Vì sao đáng chú ý

Khác với việc tự port FatFs thủ công — thường mất thời gian xử lý driver SPI, timing, và port layer disk I/O — pico_fatfs đã gói gọn mọi thứ thành một thư viện CMake sẵn sàng add_subdirectory(). Điểm mạnh nhất là cơ chế tự chọn SPI hardware hoặc SPI PIO dựa trên gán chân: bạn chỉ khai báo chân mong muốn, thư viện tự quyết định dùng khối SPI cứng (nhanh hơn) hay PIO (linh hoạt hơn) và trả về kết quả qua giá trị trả về của pico_fatfs_set_config(). Điều này cho phép thiết kế PCB tự do bố trí chân SD card mà không lo hiệu năng bị giảm sút khi vẫn dùng được SPI hardware. Hỗ trợ exFAT out-of-the-box cũng loại bỏ rào cản 4 GB tệp tin của FAT32 — rất quan trọng cho ứng dụng ghi video, audio hoặc dataset lớn trên thiết bị nhúng. Dự án phù hợp cho firmware data logger, camera trap, bộ thu GPS, hoặc bất kỳ dự án RP2040/RP2350 nào cần lưu trữ tin cậy, hiệu năng cao, và dễ tích hợp vào quy trình build Pico SDK hiện có.

#FatFs #RaspberryPiPico #RP2040 #RP2350 #EmbeddedStorage #exFAT #SPI #PIO #TiniX