---
tag: m0027
title: Report SD print status
brief: Print SD progress to serial
author: thinkyhead, TheSFReader

requires: SDSUPPORT
group: sdcard

codes: [ M27 ]

notes:
  - Requires [`SDSUPPORT`](/docs/configuration/configuration.html#sd-card)

parameters:
  -
    tag: S
    optional: true
    description: Interval between auto-reports. `S0` to disable  (requires `AUTO_REPORT_SD_STATUS`)
    values:
      -
        tag: seconds
        type: int
  -
    tag: C
    optional: true
    description: Report the filename and long filename of the current file


examples:
  -
    pre: Report current SD status
    code: M27 S4
  -
    pre: Report SD status every 4 seconds
    code: M27 S4
  -
    pre: Stop reporting SD status
    code: M27 S0
  -
    pre: Report currently open filename
    code: M27 C

---

With no parameter, report the current SD read position in the form "`SD printing byte 123/12345`." If no file is open the response is "`Not SD printing`."

With `S<seconds>`, set the SD status auto-report interval. (Requires `AUTO_REPORT_SD_STATUS`)

With `C`, get the currently open file's name (and long filename if possible). Print "`(no file)`" if no file is open.