thinkyhead

M20 - List SD Card

sdcard List the contents of the SD Card. SDSUPPORT

Description

List all printable files on the SD card back to the requesting serial port in compact DOS 8.3 format. Only files with .gcode, .gco, and .g extensions will be listed. Hidden files (beginning with .) will not be listed.

Hosts or serial controllers should send M20 to get a DOS 8.3 file listing of the active media device that includes file sizes.

The file size is included in the output since Marlin 1.1.0.

Usage

M20 [F] [L] [T]

Parameters

[F]
2.0.9.4
CUSTOM_FIRMWARE_UPLOAD

Only list BIN files. Used by host plugins to facilitate firmware upload.

    [L]
    2.0.9
    LONG_FILENAME_HOST_SUPPORT

    Include the long filename in the listing.

      [T]
      2.1.2
      M20_TIMESTAMP_SUPPORT

      Include the file timestamp in the listing.

        Examples

        List the contents of the SD card

        > M20
        Begin file list
        MYFILE.GCO 14129
        SUBDIR~1/MORETH\~1.GCO 68447
        End file list
        ok

        The firmware will send no other output between “Begin file list” and “End file list.”

        List files with long filename (for display)

        > M20 L
        Begin file list
        MYFILE.GCO 14129 MyFile.gcode
        SUBDIR~1/MORETH\~1.GCO 68447 Sub Directory/MoretHall.gcode
        End file list
        ok

        This format produces a prettier File Manager in OctoPrint, but the long name is not used in selecting the file to print, nor are folder long names included.

        List files with file modification timestamp (for display)

        > M20 T
        Begin file list
        MYFILE.GCO 14129 0x5515758F
        SUBDIR~1/MORETH\~1.GCO 68447 0x55195745
        End file list
        ok
        
        > M20 L T
        Begin file list
        MYFILE.GCO 14129 0x5515758F MyFile.gcode
        SUBDIR~1/MORETH\~1.GCO 68447 0x55195745 Sub Directory/MoretHall.gcode
        End file list
        ok

        OctoPrint 1.9+ uses the timestamp to display file upload times.