polpo/rp2040-psram

🧠 Thư viện PIO SPI cho PSRAM trên RP2040 — tốc độ 140MHz mà hardware SPI không làm được

Thư viện header-only cho RP2040, truy cập SPI PSRAM qua PIO thay vì hardware SPI, đạt 140MHz hiệu quả.

polpo/rp2040-psram là thư viện C header-only cho phép truy cập chip PSRAM ngoài qua giao tiếp SPI trên vi điều khiển RP2040 (dùng trên Raspberry Pi Pico). Do yêu cầu timing nghiêm ngặt của PSRAM — dữ liệu phải lấy mẫu tại cạnh xuống của clock và cần thêm một chu kỳ clock "đệm" — phần cứng SPI của RP2040 không thể hoạt động ổn định ở tốc độ cao. Tác giả đã xây dựng lại giao thức SPI bằng PIO (Programmable I/O) của RP2040, tối ưu riêng cho hành vi của các chip PSRAM.

✨ Điểm nổi bật

• PIO thay vì hardware SPI: Triển khai giao thức SPI tùy chỉnh qua PIO để đáp ứng yêu cầu sampling cạnh xuống và chu kỳ đệm mà hardware SPI không hỗ trợ được.
• DMA-driven: Sử dụng DMA để xử lý TX/RX FIFO, giải phóng CPU khỏi việc phục vụ từng byte.
• Tốc độ 140MHz hiệu quả: Đạt clock SPI 140MHz khi RP2040 chạy ở 280MHz — vượt xa khả năng của hardware SPI.
• Hàm tối ưu theo kích thước: Cung cấp hàm chuyên dụng cho ghi dữ liệu 8, 16, 32 bit với tốc độ tối đa.
• __force_inline trên mọi hàm: Đảm bảo tốc độ thực thi cao nhất bằng cách ép inline.
• Chip select qua PIO: CS được điều khiển trực tiếp bởi PIO, không phụ thuộc phần cứng SPI.
• Đã test trên nhiều chip: APS6404L, LY68L6400, IPS6404, ESP-PSRAM64H — tất cả đều ổn định ở 140MHz.

💡 Vì sao đáng chú ý

Phần cứng SPI trên RP2040 không thể đáp ứng yêu cầu timing đặc thù của PSRAM (cạnh xuống + chu kỳ đệm). Thay vì chấp nhận tốc độ thấp hơn, tác giả dùng PIO — một trong những tính năng mạnh nhất của RP2040 — để tự triển khai giao thức SPI đúng theo đặc tính chip nhớ. Kết quả là tốc độ gấp đôi so với hardware SPI, với DMA giúp CPU hoàn toàn rảnh rỗi.

Dự án cũng có ví dụ thực tế kiểm tra đọc/ghi 8MB dữ liệu với nhiều kích thước truy cập (8, 16, 32, 128 bit), và đã được sử dụng trong dự án PicoGUS để mô phỏng 1MB sample RAM của Gravis Ultrasound. Yêu cầu CS và SCK phải nằm trên hai GPIO liên tiếp là hạn chế cần lưu ý khi tích hợp.

#PSRAM #RP2040 #RaspberryPiPico #PIO #SPI #TiniX