AD5X

AD5X (Adventurer 5X)

The AD5X is a specialized model in the 5M series equipped with an Intelligent Filament Station (IFS) for multi-color and multi-material printing.

Overview

Feature	Status
HTTP API	Yes (port 8898)
TCP API	Yes (port 8899)
Material Station	Yes (4 slots)
Built-in Camera	No
Factory LEDs	No
Air Filtration	No

Firmware Coverage

Version	Endpoint Reference
1.1.7	endpoints_ad5x_1.1.7.yaml
1.2.1	endpoints_ad5x_1.2.1.yaml

Feature Comparison

Feature	5M	5M Pro	AD5X
Material Station	No	No	Yes (4 slots)
Built-in Camera	No	Yes	No
Factory LEDs	No	Yes	No
Air Filtration	No	Yes	No
TVOC Sensor	No	Yes	No
/gcodeThumb	Yes	Yes	Yes
/gcodeList	Basic	Basic	Extended

HTTP Endpoints

For complete endpoint documentation, see HTTP REST API.

Endpoint	Description
/detail	Printer status with IFS information
/control	Send commands to printer
/printGcode	Start print from local file
/uploadGcode	Upload and optionally print file
/gcodeList	List files with AD5X-extended tool data

AD5X-Specific Commands

AD5X extends the 5M command set with material station and manual control commands.

Material Station Commands

Command	Description	Details
msConfig_cmd	Configure slot material metadata	See IFS Material Station
ms_cmd	Load/unload/cancel by slot	See IFS Material Station

Manual Control Commands

Command	Description
moveCtrl_cmd	Manual axis movement (x/y/z)
extrudeCtrl_cmd	Manual extrusion/retraction
homingCtrl_cmd	Home all axes
errorCodeCtrl_cmd	Clear error states

moveCtrl_cmd

Jog axes manually during idle state.

{
  "cmd": "moveCtrl_cmd",
  "args": {
    "axis": "x",
    "delta": 10.0
  }
}

Argument	Values	Description
axis	"x", "y", "z"	Axis to move
delta	float	Distance in mm (positive or negative)

extrudeCtrl_cmd

Control the extruder manually.

{
  "cmd": "extrudeCtrl_cmd",
  "args": {
    "axis": "e",
    "delta": 10.0
  }
}

Argument	Values	Description
axis	string	Accepted but discarded; extrudeCtrl_cmd always drives the extruder (E) axis. Confirmed by tracing the firmware: the slot forwards only delta to Settings::moveEAxis(float).
delta	float	Filament length in mm (positive = extrude, negative = retract)

homingCtrl_cmd

Home all axes.

{
  "cmd": "homingCtrl_cmd"
}

errorCodeCtrl_cmd

Clears an active error. The firmware reads both action and errorCode. The error is only cleared when action is exactly "clearErrorCode" and errorCode matches the printer's currently-active error code (the errorCode field from /detail). On a match, the error dialog is closed and the error code is reset; otherwise the command is a no-op.

{
  "cmd": "errorCodeCtrl_cmd",
  "args": {
    "action": "clearErrorCode",
    "errorCode": "E0048"
  }
}

Argument	Type	Description
action	string	Must be exactly "clearErrorCode"; any other value is ignored
errorCode	string	Must match the printer's current active error code (read it from /detail errorCode). The error is only cleared on an exact match

printerCtl_cmd Behavior

When sending printerCtl_cmd, use partial updates. Do not send default values.

Sentinel Values

Fields omitted from the payload are set to sentinel values internally:

Field	Sentinel
speed	-200
zAxisCompensation	-200.0
chamberFan	-200
coolingFan	-200

Example - Change Only Speed:

{
  "cmd": "printerCtl_cmd",
  "args": {
    "speed": 120
  }
}

Do NOT include other fields with 0 values.

Mappings

Field	TCP Command	Range
speed	M220 S	50–500 (50–150 for 5M/Pro, up to 500 for AD5X)
zAxisCompensation	SET_GCODE_OFFSET Z= MOVE=1	-5.0 to +5.0

Intelligent Filament Station (IFS)

The AD5X features an Intelligent Filament Station (IFS) that enables multi-color and multi-material printing through a 4-slot material management system.

Quick Reference

Property	Value
Slots	4
Control Endpoint	/control
Status Endpoint	/detail

IFS Data in /detail Response

{
  "detail": {
    "hasMatlStation": true,
    "matlStationInfo": {
      "currentLoadSlot": 0,
      "currentSlot": 1,
      "slotCnt": 4,
      "stateAction": 0,
      "stateStep": 0,
      "slotInfos": [
        {
          "slotId": 0,
          "hasFilament": true,
          "materialName": "PLA",
          "materialColor": "#FFFFFF"
        }
      ]
    }
  }
}

Key Fields for AD5X Integration

Field	Description
hasMatlStation	Material station present flag
matlStationInfo	Station status and slot info
moveCtrl	Manual movement availability
extrudeCtrl	Manual extrusion availability

IFS Error Codes

IFS-specific error codes (E0100-E0114) indicate feeding, retracting, and homing failures. See Error Codes for complete error code documentation.

Complete IFS Documentation

For comprehensive IFS documentation including all commands, state monitoring, material and color support, error handling, and multi-material printing workflows, see IFS Material Station.