Welcome to the unofficial FlashForge API documentation wiki. This repository serves as a comprehensive, technically focused resource for interfacing with FlashForge 3D printers over the network.

The documentation covers the internal networking protocols, HTTP REST APIs, TCP fallback mechanisms, M-Code extensions, and hardware states used by modern FlashForge printers, with a particular focus on the Adventurer 5M series and AD5X models.

• Discovery & Identification: How to detect FlashForge printers on the local network via UDP broadcasts.
• Authentication: The JSON-based authentication mechanism required to interact with the HTTP API.
• HTTP REST API: The primary mechanism for monitoring printer status, controlling operations, and managing files (Port 8898).
• TCP Protocol: The lower-level socket protocol (Port 8899) used for direct motion control, homing sequences, and legacy support.

• Adventurer 5M Series: Architectural overview and HTTP/TCP API implementation details specific to the AD5M hardware.
• Adventurer 5M Pro Features: Additional commands and state fields unique to the Pro model (e.g., camera control, air filtration, TVOC sensors).
• AD5X Integration: Details regarding the Adventurer 5X model and its extended API commands.
• AD5X IFS Material Station: Complete integration guide for the Intelligent Filament Station, outlining multi-material command structures and state monitoring.
• Creator 5 Series: The 4-head CoreXY tool-changer (Creator 5 / 5 Pro). HTTP-only (no TCP), per-tool temperatures, material station, and a distinct command surface.
  • Creator 5 Filament Palette: The Creator 5's own 24-color palette and 21-material list (distinct from the AD5X).
• Adventurer 3 Series: Legacy TCP-only protocol and communication references.
• Adventurer 4 Series: TCP-only protocol reference for the A4 Pro and A4 Lite.

• M-Code Reference: FlashForge-specific M-Code extensions used within TCP payloads and G-code files.
• G-Code Reference: Information on standard and extended G-code commands supported by the firmware.

• State Machines: Detailed breakdowns of the internal state machine (Printer Status, Print Status, Error Status) indicating how the printer transitions between operations.
• Capability Matrix: Feature and command support matrix across all printer families.
• Error Codes: Exhaustive lists of HTTP API errors, TCP communication errors, and IFS failure states, coupled with standard software recovery strategies.

• AD5X Root Access: Root SSH and ADB access via USB firmware update mechanism.
• AD5X Maintenance Console: Hidden touchscreen maintenance UI with debug, calibration, and test functions.
• 5M Maintenance Console: Hidden maintenance UI for 5M/5M Pro series.
• AD5X IFS Serial Protocol: Raw UART protocol for the Intelligent Filament Station.
• AD5X Platform Notes: Hardware, SoC, kernel modules, and filesystem analysis.

If you are developing integrations or custom control software, the typical entry point is the Discovery Protocol to locate devices, followed by Authentication to establish a secure session with the HTTP REST API.

For direct control of physical hardware (such as custom homing or manual extrusion), refer to the TCP Protocol after ensuring no active print job is running.

Note: This documentation focuses strictly on API, protocol, and command-level interactions. End-user troubleshooting or physical maintenance is outside the scope of this wiki.