Setup guide

Prepare your microcontroller, then connect from a Windows 10 or 11 PC.

Set up the microcontroller

  1. 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.

  2. 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.

  3. 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:

    1. Open ESP32StorageLibrary on GitHub, select Code → Download ZIP, and save the ZIP file.
    2. In Arduino IDE, choose Sketch → Include Library → Add .ZIP Library…. Select the downloaded ESP32StorageLibrary ZIP. Keep it zipped for this method.
    3. Open ESP32PcSession on GitHub and download its ZIP in the same way.
    4. Choose Sketch → Include Library → Add .ZIP Library… again and select the ESP32PcSession ZIP. Install both libraries: ESP32PcSession depends on ESP32StorageLibrary.
    5. 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.properties and the src folder. Copy that library folder into the libraries folder inside your Arduino sketchbook, then restart Arduino IDE. Check your configured sketchbook location in Arduino IDE preferences or settings. Repeat for the other library.

  4. 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

  1. Get the app

    Check Windows downloads for the current release. If you already have a compiled copy, open SerialFileManager.exe from its app folder. For a release ZIP, extract the entire ZIP first and follow the runtime requirements listed with that release.

  2. 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.

  3. 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.