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.

Notes

Requires SDSUPPORT

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.