Setup guide
Prepare your microcontroller, then connect from a Windows 10 or 11 PC.
Set up the microcontroller
Prepare the hardware
Gather your board, a compatible SPI microSD breakout, a microSD card, and a USB data cable. Back up the card before formatting it as FAT32. Disconnect USB power before wiring.
Wire the microSD breakout
Follow the board and microSD breakout documentation for the pinout. Check the breakout’s power and signal ratings before wiring.
Insert the card, then reconnect USB.
Prepare Arduino IDE and install both libraries
Install the board package and select your board target. ESP32StorageLibrary and ESP32PcSession are not available in Arduino Library Manager yet, so install them manually from ZIP files:
- Open ESP32StorageLibrary on GitHub, select Code → Download ZIP, and save the ZIP file.
- In Arduino IDE, choose Sketch → Include Library → Add .ZIP Library…. Select the downloaded ESP32StorageLibrary ZIP. Keep it zipped for this method.
- Open ESP32PcSession on GitHub and download its ZIP in the same way.
- Choose Sketch → Include Library → Add .ZIP Library… again and select the ESP32PcSession ZIP. Install both libraries: ESP32PcSession depends on ESP32StorageLibrary.
- Open File → Examples → ESP32PcSession → SerialFileManager. If the example does not appear, close and reopen Arduino IDE.
You can also find both repositories on the Downloads page. See Arduino’s library installation guide for the ZIP and manual installation methods.
If Arduino says the ZIP is not a valid library
Extract the ZIP and find the folder containing
library.propertiesand thesrcfolder. Copy that library folder into thelibrariesfolder inside your Arduino sketchbook, then restart Arduino IDE. Check your configured sketchbook location in Arduino IDE preferences or settings. Repeat for the other library.Upload the firmware
In Arduino IDE, open the Serial File Manager example from the matching firmware package. Check that the sketch’s chip-select pin matches your wiring. Select the board’s COM port and upload. Close the Serial Monitor if it’s open.
Use the SerialFileManager example installed with ESP32PcSession above, together with ESP32StorageLibrary.
Set up the Windows app
Get the app
Check Windows downloads for the current release. If you already have a compiled copy, open
SerialFileManager.exefrom its app folder. For a release ZIP, extract the entire ZIP first and follow the runtime requirements listed with that release.Connect to the board
Plug your board into the PC with the USB data cable. Open Serial File Manager, select the same COM port you used in Arduino IDE, then select Connect. The app opens the microSD file list once the session starts.
Try a small transfer
Upload a small test file from your PC. Select it in the file list, download it to a different PC folder, then open the downloaded copy. When you’re done, select Disconnect and wait for the session to close before unplugging the board.
Troubleshooting
- No COM port appears
- Try a known USB data cable and another PC USB port. Check Device Manager under Ports (COM & LPT) and check whether your board’s USB-to-UART bridge needs a driver.
- The app can’t connect
- Close Arduino’s Serial Monitor and any other app using the port. Confirm the selected port belongs to your board and that the matching firmware was uploaded.
- The SD card can’t be read
- Check that the card is seated and uses FAT32. With power disconnected, check the SPI wiring and verify that CS matches the setting in the sketch.