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

group: sdcard
requires: SDSUPPORT

codes: [ M27 ]

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

parameters:

- tag: S
  optional: true
  requires: AUTO_REPORT_SD_STATUS
  description: Interval between auto-reports. `S0` to disable.
  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

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