JSON responses

List of RepRapFirmware JSON Responses

This document describes the four big JSON responses which are used to report status and configuration details. For a list of HTTP-related JSON responses, see HTTP requests.

In these responses the following conditions apply:

Booleans represented as 0 (false) or 1 (true)
Indices pointing to another resource might not be valid. This is due to possible limitations of the CAN expansion board management
ADC readings are reported on a scale of 0 to 1000
Lengths are reported in mm
Speeds are reported in mm/s
Times are reported in seconds
Temperatures are reported in Celsius

Standard Status Response (Type 1)

This status response contains various fields that are expected to change frequently. These values are also included in the type 2 and 3 status responses.

{
	"status": "O",
	"coords": {
		"axesHomed": [0, 0, 0],
		"wpl": 1,
		"xyz": [0.000, 0.000, 0.000],
		"machine": [0.000, 0.000, 0.000],
		"extr": []
	},
	"speeds": {
		"requested": 0.0,
		"top": 0.0
	},
	"currentTool": -1,
	"output": {
		"beepDuration": 1234,
		"beepFrequency": 4567,
		"message": "Test message",
		"msgBox": {
			"msg": "my message",
			"title": "optional title",
			"mode": 0,
			"seq": 5,
			"timeout": 10.0,
			"controls": 0
		}
	},
	"params": {
		"atxPower": -1,
		"fanPercent": [-100],
		"speedFactor": 100.0,
		"extrFactors": [],
		"babystep": 0.000,
		"seq": 1
	},
	"sensors": {
		"probeValue": 1000,
		"probeSecondary": 1000,
		"fanRPM": [-1]
	},
	"temps": {
		"bed": {
			"current": -273.1,
			"active": -273.1,
			"standby": -273.1,
			"state": 0,
			"heater": 0
		},
		"current": [-273.1],
		"state": [0],
		"tools": {
			"active": [],
			"standby": []
		},
		"extra": []
	},
	"time": 596.0,
	"scanner": {
		"status": "D",
		"progress": 0.0
	},
	"spindles": [],
	"laser": 0.0
}

Machine Status

The status field provides a single character for the machine status. It may have one of the following values:

Status character	Status
C	Reading configuration file
F	Flashing new firmware
H	Halted (after emergency stop)
O	Off (powered down, low input voltage)
D	Pausing print (decelerating)
R	Resuming print (after pause)
S	Print paused (stopped)
M	Simulating a (print) file
P	Printing
T	Changing tool
B	Busy (executing macro, moving)

Values higher in the table also have a higher priority. So, for example, tool changes are not reported while a print is in progress.

Coordinates

coords/wpl (optional): Selected workplace (see G10 and G54 to G59.3). May not be present if the board does not support workplaces
cords/xyz: User coordinates of the axes (i.e. with tool offsets applied)
coords/machine: Mchine coordinate of the axes (i.e. without tool offsets applied)
coords/extr Total amount of filament extruded per extruder drive (with extrusion factors applied). See also extrRaw in response type 3

Output

RepRapFirmware may request output via the client application. Only if this is the case, the output field is present.

Beeps

If no PanelDue is attached, beeps (see M300) are reported via the beepDuration and beepFrequency fields. These fields are not present if M300 was not used.

Output message

A user may want to output a generic message via M117. If this is the case, the message string is reported via the message field.

Message boxes

RepRapFirmware allows a user to use message boxes if required. These message boxes may be configured via M291/M292. The corresponding values can be found in the optional msgBox field. See the documentation of M291 for further details.

msgBox/controls is a bitmap of configured axis controls (X = 1, Y = 2, Z = 4 etc.)
msgBox/seq is incremented whenever M291 is used
msgBox/timeout is the time left for displaying this message box or 0.0 if it does not time out

Temperatures

Slow heaters like temps/bed, temps/chamber, and temps/cabinet (second chamber) have the following properties:

current: Current heater temperature
active: Target temperature when turned on (in active state)
standby: Target temperature when in standby mode
state: State of the heater. See below
heater: Index of the assigned heater

The fields temps/bed, temps/chamber, and temps/cabinet may not be present if no bed and/or chamber is configured.

temps/current: Array of heater temperatures
temps/state: Array of heater states
temps/tools/active: Array holding arrays of configured active heater temperatures. Tools may have multiple heaters assigned
temps/tools/standby: Array holding arrays of configured standby heater temperatures

Heater states

Heater state	Meaning	Description
0	off	Heater is turned off
1	standby	Heater is in standby mode
2	active	Heater is active
3	fault	Heater fault occurred
4	tuning	Heater is being tuned
5	offline	Remote heater from an expansion board is not available

Extra heaters

Extra heaters represent custom sensor and can be found in temps/tools/extra. Every extra heater is reported in the following format:

{
	"name": "MCU",
	"temp": 34.7
}

Scanner

RepRapFirmware may support an external interface for 3D scanners. This field is not be present if scanner support is not enabled in the firmware, hence this field may not be present either. There are two fields for this interface in the status response:

status: Status of the external 3D scanner. See below
progress: Progress of the current operation (0.0 to 100.0)

Possible scanner states:

Status character	State
D	Disconnected
I	Idle
S	Scanning
P	Post processing
C	Calibrating
U	Uploading

Spindles

The spindles field may be only present if the machine is in CNC mode or if the advanced status respone (type 2) is queried.

It provides a list of configured spindles in the format

{
	"current": 0.0,
	"active": 0.0,
	"tool": 0
}

where current is the current RPM, active the target RPM, and tool the number of the assigned tool.

Other fields

speeds/requested: Requested feedrate of the current move
speeds/top: Top feedrate of the current move
currentTool: Selected tool number (not index) or -1 if none is selected
params/atxPower: ATX power state. This may be -1 if ATX power is not configured
params/fanPercent: Fan percent (0.0 to 100.0). If the fan is disabled, this may be negative (-1)
params/speedFactor: Speed factor override. 100% equals 100.0 and this is always greater than 0.0
params/extrFactors: Extrusion factor override values. Values of 100% equals 100.0 and they are always greater than 0.0
params/babystep: Z babystepping amount
sensors/probeValue: ADC reading of the Z probe
sensors/probeSecondary (optional): Seconday probe ADC reading if the probe is modulated. This field is not present if the probe is unmodulated
sensors/fanRPM: Array of fan RPMs, values may be negative if not configured
time: Time in seconds since the machine started. May be used to detect firmware resets
laser (optional): PWM value of the attached laser. This field is only present if the machine is in Laser mode

Advanced Status Response (Type 2)

This status response type provides fields that may change but not as frequently as those in the standard status response.

{
	"params": {
		"fanNames": [""],
	},
	"temps": {
		"names": [""}
	},
	...
	"coldExtrudeTemp": 160.0,
	"coldRetractTemp": 90.0,
	"compensation": "None",
	"controllableFans": 0,
	"tempLimit": 290.0,
	"endstops": 0,
	"firmwareName": "RepRapFirmware for Duet 3 v0.6",
	"firmwareVersion": "3.0beta12+1",
	"geometry": "cartesian",
	"axes": 3,
	"totalAxes": 3,
	"axisNames": "XYZ",
	"volumes": 1,
	"mountedVolumes": 0,
	"mode": "FFF",
	"name": "duet3",
	"probe": {
		"threshold": 500,
		"height": 0.70,
		"type": 0
	},
	"tools": [],
	"mcutemp": {
		"min": 24.0,
		"cur": 37.4,
		"max": 37.6
	},
	"vin": {
		"min": 0.2,
		"cur": 0.3,
		"max": 0.3
	},
	"v12": {
		"min": 0.2,
		"cur": 0.2,
		"max": 0.2
	}
}

Geometry

The current geometry is reported as part of the geometry field. The following geometries are supported:

Value	Geometry
cartesian	Cartesian
coreXY	CoreXY
coreXYU	CoreXYU
coreXYUV	CoreXYUV
coreXZ	CoreXZ
markForged	markForged
Hangprinter	Hangprinter
delta	Linear delta
Polar	Polar
Rotary delta	Rotary delta
Scara	Scara

If the geometry is unknown, unknown is reported.

Machine mode

It is possible to choose between FFF, CNC, and Laser mode. As a consequence, the following values are reported as part of the mode field:

Value	Mode
FFF	3D printing mode
CNC	CNC mode
Laser	Laser cutting/engraving mode

Probe

The probe field may not be present if no Z probe is configured. If it is, it provides the following fields:

probe/threshold: Threshold value for the Z probe to be triggered
probe/height: Z height of the Z probe when triggered
probe/type: Probe type. See below

Possible probe types are:

Probe type	Name
0	No probe
1	Simple analog probe
2	Dumb modulated probe
3	Alternate analog probe
4	E0 switch deprecated
5	Digital probe
6	E1 switch deprecated
7	Z switch deprecated
8	Unfiltered digital probe
9	BLTouch
10	Z motor stall detection

Tool mapping

In order to figure out the mapping between heaters and tools, the tool mapping is reported as part of the advanced status response. The tool mapping is reported as an array of items like

{
	"number": 0,
	"name": "",
	"heaters": [],
	"drives": [],
	"axisMap": [[0],[1]],
	"fans": 1,
	"filament": "PLA",
	"offsets": [0.00, 0.00, 0.00]
}

where

number: Tool number (Tn)
name: Optional tool name or "" if none is configured
heaters: List of assigned heater indices
drives: List of assigned drives
axisMap: XY axis mapping. Mapped X axes are reported in the first item and mapped Y axes in the second one
fans: Bitmap of the mapped tool fans (controllable by M106 without P parameter)
filament (optional): Name of the loaded filament
offsets: Tool offsets. The size of this array equals the number of visible axes

Other fields

params/fanNames: Array of custom fan names. Every fan name defaults to "" if no custom name has been configured
temps/names: Custom names of the heaters. This is "" for every heater that does not have a custom name
coldExtrudeTemp: Minimum temperature for extrusions
coldRetractTemp: Minimum temperature for retractions
compensation: Current type of bed compensation. May be either Mesh, n Point (where n is the number of probe points), or None
controllableFans: Bitmap of fans that are user-controllable. This excludes thermostatic fans
tempLimit: Maximum allowed heater temperature of the heater protection items. This is used for scaling the temperature chart on the web interface
endstops: Bitmap of currently triggered axis endstops
firmwareName: Name of the firmware deprecated - see config response
firmwareVersion: Version of the firmware deprecated - see config response
axes: Number of visible axes
totalAxes: Number of total axes
axisNames: Letters of the visible axes
volumes: Total number of supported volumes
mountedVolumes: Bitmap of mounted volumes (1 = drive 0, 2 = drive 2, ...)
name: Hostname of the machine
mcutemp (optional): Minimum, current, and maximum MCU temperatures
vin (optional): Minimum, current, and maximum input voltage
v12 (optional): Minimum, current, and maximum voltage on the 12V rail

Print Status Response (Type 3)

This status response type provides extra details about the file being processed. The format is

{
	...
	"currentLayer": 0,
	"currentLayerTime": 0.0,
	"extrRaw": [],
	"fractionPrinted": 0.0,
	"filePosition": 0,
	"firstLayerDuration": 0.0,
	"firstLayerHeight": 0.00,
	"printDuration": 0.0,
	"warmUpDuration": 0.0,
	"timesLeft": {
		"file": 0.0,
		"filament": 0.0,
		"layer": 0.0
	}
}

where the fields are:

currentLayer: Number of the current layer being printed
currentLayerTime: Time of the current layer
extrRaw: Total amount of extruded filament without extrusion multipliers applied. This is useful to estimate the print progress
fractionPrinted: Fraction of the file printed on a scale of 0.0 to 100.0. This equals filePosition / fileSize
filePosition: Byte position of the file being printed
firstLayerDuration: Duration of the first layer or 0.0 if unknown
firstLayerHeight: Height of the first layer
printDuration: Total print duration (excluding pause times)
warmUpDuration: Time needed to warm up the heaters
timesLeft/file: Estimation for the time left based on the file consumption
timesLeft/filament: Estimation for the time left based on the filament consumption
timesLeft/layer: Estimation for the time left based on the layer times

Configuration response

In addition to the responses above, the config response provides values that are not expected to change unless the machine is reconfigured. Note that a user may choose to reconfigure the machine at any time. The config response comes in the following format:

{
	"axisMins": [0.0, 0.0, 0.0],
	"axisMaxes": [220.0, 200.0, 180.0],
	"accelerations": [1000.0, 1000.0, 1000.0, 1000.0, 1000.0, 1000.0, 1000.0, 1000.0],
	"currents": [800.0, 1000.0, 800.0, 1000.0, 800.0, 800.0, 8000, 800.0],
	"firmwareElectronics": "Duet 3 MB6HC",
	"firmwareName": "RepRapFirmware",
	"boardName": "MB6HC",
	"firmwareVersion": "3.0beta12+1",
	"dwsVersion": "1.24",
	"firmwareDate": "2019-11-05b1",
	"idleCurrentFactor": 35.0,
	"idleTimeout": 30.0,
	"minFeedrates": [10.0, 10.0, 0.5, 0.33, 0.33, 0.33, 0.33, 0.33],
	"maxFeedrates": [250.0, 250.0, 3.0, 60.0, 60.0, 60.0, 60.0, 60.0]
}

The following fields are reported:

axisMins: Minima of the visible axes
axisMaxes: Maxima of the visible axes
accelerations: Accelerations of the drives
currents: Configured motor currents
firmwareElectronics: Name of the firmware electronics
firmwareName: Name of the firmware (usually RepRapFirmware)
boardName (optional): Short name of the board, only applicable for Duet 3. May be MB6HC for Duet v0.6 or MBP05 for the Duet v0.5 prototype
firmwareVersion: Version string of the firmware
dwsVersion (optional): Version of the DuetWiFiSocketServer (only Duet WiFi)
firmwareDate: Indicates when the firmware was built
idleCurrentFactor: Motor currents are reduced by this factor when the motors are idle
idleTimeout: Motor current reduction is performed after this time in seconds
minFeedrates: Minimum feedrates of the drives
maxFeedrates: Maximum feedrates of the drives

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

JSON responses

List of RepRapFirmware JSON Responses

Standard Status Response (Type 1)

Machine Status

Coordinates

Output

Beeps

Output message

Message boxes

Temperatures

Heater states

Extra heaters

Scanner

Spindles

Other fields

Advanced Status Response (Type 2)

Geometry

Machine mode

Probe

Tool mapping

Other fields

Print Status Response (Type 3)

Configuration response

Clone this wiki locally