Vision Miner Wiki

Macros & Settings

Macros & Settings

The Vision Miner 22 IDEX V4 includes a set of built-in macros � pre-written scripts that automate common tasks like calibration, filament changes, network setup, and troubleshooting. This article is a complete reference of every macro available on the printer, organized by folder. Use it to understand what each macro does and when to run it.

Safety and Warnings

Danger: Attention: Macros in the Calibration folder move the toolheads and build plate automatically. Make sure the build area is clear � remove prints, tools, and loose objects before running any calibration macro. IMPORTANT: Do not run macros while a print is in progress unless the macro is specifically designed for it (e.g., Save Current Z - Offset). Running a calibration or filament macro mid-print will interrupt or ruin the job.

1. How to Access Macros

Open the Web Interface in your browser. In the left sidebar, click Macros. You will see the root-level macros and the System folder, which contains all advanced macros organized into subfolders.

2. Main Macros

These three macros sit at the root level of the Macros page. They are the most frequently used.

Auto Calibration

The master calibration routine. Runs all calibration procedures in the correct order:

  1. Heats both toolheads to user-specified temperatures.
  2. Prompts you to remove the build plate.
  3. Homes all axes.
  4. Runs Tool Height Calibration (Z-offset between T0 and T1).
  5. Runs Z-Offset Calibration (probe-to-nozzle offset).
  6. Runs Mesh Bed Calibration (if mesh mode is set to auto).
  7. Runs XY Auto Squaring (if enabled).
  8. Runs XY Offset Calibration (U and Y offset between tools).
  9. Displays a summary of all calibrated values.

Warning: IMPORTANT: Remove the build plate before starting. The macro will remind you, but running calibration with the plate installed will produce incorrect results or damage the probe.

Auto Cooldown & Sleep

Safely shuts down the printer after use. Asks for confirmation, then:

  • Homes all axes (if not already homed).
  • Lowers the build plate to the bottom (Z = 420 mm / � 16.5 in.).
  • Turns off all fans, heaters (nozzles, bed, chamber).
  • Releases XYU motors.
  • Puts the 24V power supply into standby.

Use this instead of the physical power button for a normal (non-emergency) shutdown.

Save Current Z - Offset

Saves the current babystepping value as a permanent Z-offset. During a print, you can adjust the Z babystep in real time to fine-tune the first layer. This macro writes that adjustment into the printer's configuration so it persists across reboots.

  • During a print: the save is deferred until the print finishes.
  • Outside a print: the offset is applied and saved immediately.

3. System Utilities

Located in System/ (top level, not inside any subfolder).

MacroWhat it does
Movement Without HomingToggles the ability to jog axes without homing first. Useful when you need to move a toolhead manually (e.g., for inspection or maintenance) but cannot home safely. Disabled by default � axes require homing before movement.
Reset Status LED ColorResets the printer's status LEDs to the default color. Use this if a macro or error left the LEDs in an unexpected state.
Reset Temp FaultClears all heater temperature fault flags. If a heater triggered a fault (e.g., temperature sensor disconnected, heater timeout), this macro resets the error so the heater can be used again. Diagnose the cause of the fault before resetting.

Danger: Attention: The Movement Without Homing macro allows moving axes without position verification. Careless movement can cause the toolheads to collide with the frame, the build plate, or each other, damaging the printer's mechanics. Only use it when you are certain the path is clear and the toolheads will not hit anything.

4. Filament Management

Located in System > Filament/.

Change Filament

Full filament change workflow. Walk-through:

  1. Select which tool to change (T0 / T1).
  2. Enter the temperature of the currently loaded filament.
  3. The macro heats, then unloads the old filament (using a cold pull if needed for high-temperature materials).
  4. Enter the temperature of the new filament.
  5. The macro heats and loads the new filament.

If the old and new materials have a large temperature gap (e.g., swapping PEEK for PLA), the macro uses an intermediate purge with cold pull to avoid cross-contamination.

Cold Pull

Cleans the inside of the nozzle by performing a controlled cold pull. The macro:

  1. Heats the nozzle and pushes filament through.
  2. Gradually cools the nozzle while applying pressure.
  3. At the calculated pull temperature, retracts the filament sharply � pulling out debris with it.

The pull temperature is calculated automatically based on the filament type. Works in two modes:

  • Interactive � prompts you for the temperature, lets you control the process.
  • Automated � called with parameters by other macros (e.g., during filament change).

Reset Selected Filament

Clears the filament assignment for Tool 0, Tool 1, or both. The Web Interface shows a filament name next to each tool � this macro removes that label. Use it when the displayed filament does not match what is actually loaded, or after manually swapping filament without using the Change Filament macro.

5. Calibration

Located in System > Calibration/. This is the largest section. Most of these macros are called automatically by the Auto Calibration master routine, but they can also be run individually.

Warning: IMPORTANT: For routine calibration, always use the main Auto Calibration macro � it runs all procedures in the correct order. Running individual calibration macros one by one manually is not recommended. Use individual macros only when troubleshooting a specific issue, to save time and avoid re-running the full calibration cycle.

Temperature Tuning

Located in System > Calibration > Temperature Tuning/.

MacroWhat it does
PID Tuning Bed HeaterRuns PID auto-tune on the bed heater. Default target: 150 �C. You can enter a custom target. If the target is above 140 �C, the macro pre-heats the chamber to 100 �C first to simulate real printing conditions. Results are saved to the printer's configuration automatically.
PID Tuning Left HeadRuns PID auto-tune on the left toolhead heater (T0). Enter a target temperature between 200 �C and 450 �C. Results are saved automatically.
PID Tuning Right HeadSame as PID Tuning Left Head, but for the right toolhead heater (T1).
Temp Sensor Tuning BedCalibrates the bed temperature sensor using a pyrometer (infrared thermometer). The macro heats the bed, waits for thermal stabilization, then asks you to measure the actual surface temperature. It iteratively adjusts the sensor's calibration coefficient until the sensor reading matches the measured value within �0.2 �C.
Temp Sensor Tuning ChamberCalibrates the chamber air temperature sensor. Supports automatic mode (uses the average nozzle temperature as a reference) or manual mode (IR thermometer measurement). Adjusts the sensor coefficient to match within �0.5 �C.

Info: IMPORTANT: PID tuning macros turn off all heaters at the start to avoid interference.

Live XY Offset Adjustment

Located in System > Calibration > Live XY Offset Adjustment/.

Four directional macros for manually fine-tuning the XY offset between Tool 0 and Tool 1 in real time. Each press adjusts the offset by 0.05 mm (� 0.002 in.) in the indicated direction. Use these while examining a dual-color test print to dial in alignment.

MacroDirectionWhat it adjusts
? Move T1 LeftLeftU-offset +0.05 mm
? Move T1 RightRightU-offset -0.05 mm
? Move T1 ForwardForwardY-offset -0.05 mm
? Move T1 BackwardBackwardY-offset +0.05 mm

Changes are saved immediately and persist across reboots.

Mesh Calibration

Located in System > Calibration > Mesh Calibration/.

These macros control the mesh bed compensation � a correction that accounts for slight differences in bed flatness across the X-axis.

MacroWhat it does
Toggle ModeSwitches mesh compensation between auto (measured by the probe during Auto Calibration) and manual (set by the user with the macros below). When switching to auto, optionally triggers a full Auto Calibration.
?_? RHS DownAdjusts manual mesh compensation: moves the right side of the build plate down by 0.04 mm (� 0.0016 in.). Forces manual mode.
?_? RHS UpAdjusts manual mesh compensation: moves the right side of the build plate up by 0.04 mm (� 0.0016 in.). Forces manual mode.
ResetResets all mesh compensation values to zero and switches to manual mode.

XY Squaring

Located in System > Calibration > XY Squaring/.

Controls the XY squareness correction � a compensation that adjusts for any slight angular misalignment between the X and Y axes.

MacroWhat it does
Toggle ModeSwitches between auto (measured by the probe during Auto Calibration) and manual mode. Shows the currently active offset value.
Adjust ?? CWManually adjusts the squaring offset clockwise by +0.1 mm (� 0.004 in.). Maximum �2 mm. Forces manual mode.
Adjust ?? CCWManually adjusts the squaring offset counterclockwise by -0.1 mm (� 0.004 in.). Maximum �2 mm. Forces manual mode.
Reset OffsetsResets all squaring offsets (auto, manual, mode) to zero.

Z Probe

Located in System > Calibration > Z Probe/.

Macros for managing the automated Z-probe � the sensor that the printer picks up from a holder and uses to measure bed height and tool offsets.

MacroWhat it does
Enable ProbeTurns on the Z-probe relay (powers the probe).
Disable ProbeTurns off the Z-probe relay.
Pick the ProbeHomes XYU axes if needed, then picks up the probe from its holder.
Place the ProbeHomes XYU axes if needed, then returns the probe to its holder.
Probe CalibrationFull probe calibration wizard. Guides you through adjusting the probe servo height, fine-tuning the pickup angle, saving the probe X/Y pickup positions, and running 3 test pick/place cycles to verify reliability.
Adjust pickup angle CWIncreases the probe servo pickup angle by 1� (max 180�).
Adjust pickup angle CCWDecreases the probe servo pickup angle by 1� (min 155�).
Rotate holder to 0 degreeRotates the probe holder servo to 0�.
Rotate holder to a set degreeRotates the probe holder servo to the configured pickup angle.

Reset Bed Level

Located in System > Calibration/.

Interactive procedure for resetting the mechanical bed level. Disables the homing requirement, guides you through lowering all three Z-axis leadscrews to the physical bottom, then moves the bed back up. If the motors stall during the process, the macro increases motor current and retries. Optionally re-homes all axes after completion.

Danger: Attention: This macro intentionally grounds out the Z motors to find the mechanical bottom. You will hear grinding � that is expected and does not damage the machine.

Steps per mm Mode

Located in System > Calibration/.

Toggles automatic steps-per-mm calibration on or off. When enabled, the Auto Calibration macro measures the actual axis travel distances by probing reference holes and calculates corrected steps/mm values for X and Y. When disabled, the firmware uses the default factory values (80 steps/mm for X, Y, and U).

Beta Macros

Located in System > Calibration > Beta/.

Danger: Attention: Beta macros are experimental features under development. They may change or be removed in future firmware updates. Do not use them on your own � only run beta macros after discussing it with Vision Miner support.

MacroWhat it does
Bed DanceDemo/test macro. Remaps the three Z motors and runs a synchronized circular movement pattern. Not used in normal operation.
Rear ? UpAdjusts Y-axis bed compensation (rear of build plate) upward by 0.05 mm (� 0.002 in.).
Rear ? DownAdjusts Y-axis bed compensation (rear of build plate) downward by 0.05 mm (� 0.002 in.).

6. Settings

Located in System > Settings/. These macros configure how the printer behaves in various situations � fault handling, post-print behavior, network, and print-specific settings.

Fault Handling

Located in System > Settings > Faults/.

MacroWhat it does
Action After Heater FaultConfigures what happens when a heater fault is detected. Options: disable auto-shutdown, immediate shutdown, or delayed shutdown (30 / 60 / 120 seconds, or a custom value).
Bed Fault DetectionEnables or disables bed heater fault detection. When enabled, the firmware monitors the bed heater for temperature drift and triggers a fault if the heater cannot maintain the target within the specified timeouts.
Chamber Fault DetectionSame as Bed Fault Detection, but for the chamber heater.

Danger: Attention: Disabling fault detection removes a safety mechanism. Only disable it for specific troubleshooting scenarios and re-enable it as soon as you are done.

Filament Runout Sensors

Located in System > Settings > Filament Runout/.

MacroWhat it does
Sensor Mode Tool 0Enables or disables the filament runout sensor for Tool 0 (left toolhead). When enabled, the printer pauses the print if filament runs out or breaks.
Sensor Mode Tool 1Enables or disables the filament runout sensor for Tool 1 (right toolhead).
2nd Tool Backup(Under development) When enabled, Tool 1 automatically takes over if Tool 0 runs out of filament. Both tools must be loaded with the same filament.

Firmware

Located in System > Settings > Firmware/.

MacroWhat it does
Check FirmwareDisplays the currently installed firmware version and provides a link to the GitHub releases page where you can download updates.
Delete Old FilesPlaceholder � not yet implemented.

Job End Behavior

Located in System > Settings > Job End/.

These macros configure what the printer does automatically after a print finishes.

MacroOptions
Bed PositionMove bed to a custom Z height, lower to the bottom (Z = 420), or move up 50 mm (� 2 in.).
Bed TemperatureSet bed to 0 �C (off), hold at 110 �C, hold at 150 �C, or maintain the current temperature.
Chamber TemperatureKeep the current chamber temperature or turn off the chamber heater.
PowerPut the printer to sleep (auto shutdown) or stay idle. If sleep is selected, you can also configure the bed position.
Tools UnloadAlways retract filament 150 mm (� 6 in.) at reduced temperature, keep filament loaded (minimal retraction), or retract once then auto-disable the feature.

Network

Located in System > Settings > Network/.

MacroWhat it does
Connect to new WiFi networkWiFi setup wizard. Prompts for SSID and password, tests the connection, and saves if successful. The printer's WiFi module only supports 2.4 GHz networks.
Enable WiFi - Client ModeSwitches to WiFi client mode (connects to an existing WiFi network). Uses the last configured network credentials.
Enable WiFi - Access Point ModeSwitches to WiFi access point mode. The printer creates its own WiFi network that you connect to directly. Default password: 1234567890, default IP: 192.168.0.1.
Enable Ethernet ModeSwitches to Ethernet with three sub-modes: DHCP (automatic IP), static IP (you specify the address), or direct Ethernet-to-PC connection (default IP: 192.168.1.50).
Assign Static IPAssigns a static IP address to the current network connection. Auto-detects whether the printer is on Ethernet or WiFi. Offers a test-before-save option.
Change Machine's NameSets a custom hostname for the printer (used for <name>.local mDNS access). Optionally updates the WiFi access point name to match. Requires a restart to take effect.
Reset Network SettingsFactory-resets all network settings. Erases all saved WiFi networks, clears subnet/gateway configuration, and reverts to WiFi access point mode with default settings.

Warning: IMPORTANT: After changing network settings, the Web Interface connection will drop. You will need to reconnect to the printer using the new IP address or network. Write down the new address before confirming the change.

Printing

Located in System > Settings > Printing/.

MacroWhat it does
Wait for Chamber TempEnables or disables waiting for the chamber to reach the target temperature before starting a print. When enabled, the printer also runs a 5-minute heat soak after the target is reached.
Wiping during the printConfigures periodic nozzle wiping during active prints. Options: every layer, every 2nd layer, every 5th layer, or custom interval. Useful for oozy materials like ULTEM, PEI (9085/1010), or PPSU.
Tool Change RetractionConfigures custom retraction and extrusion distances for tool changes on T0 and T1 separately.
Hepa Fan AdjustmentSets the HEPA filter fan speed (0�100%, default 60%). The fan activates automatically when the chamber temperature exceeds 50 �C.
Event LoggingEnables or disables logging of printer events to the event log file.
Adjust Brush PositionAdjusts the Y-center position of the nozzle cleaning brush (range: -100 to -50 mm / � -3.9 to -2.0 in., default: -62 mm / � -2.4 in.).
Adjust XU PositionAdjusts the homing Y-position for the X and U axes (range: 160�180 mm / � 6.3�7.1 in., default: 172 mm / � 6.8 in.).

7. Troubleshooting Macros

Located in System > Troubleshooting/. These macros run diagnostic tests to help identify hardware problems.

MacroWhat it does
Build Plate & Chamber Heating TestComprehensive heating performance test. Choose to test both heaters, bed only, or chamber only. The macro logs all temperatures (bed, chamber, nozzles) to a CSV file every 10 seconds for up to 90 minutes. LED color indicates status: blue = heating, green = pass, red = fail. Cancel at any time using the endstop button.
Chamber Heating TestShortcut that launches the chamber-only portion of the heating test.
Endstops TestRuns the endstop detection test 10 times in a row to check for intermittent endstop issues.
Voltage TestReads and displays the mainboard input voltage. Use this to verify the 24V power supply is delivering the correct voltage.
Z - Binding TestTests Z-axis movement for mechanical binding or excessive friction. Each leadscrew is tested individually.
Z - Homing TestRuns Z-homing a specified number of times (default 10, max 1000) to test repeatability. Logs each attempt to the event log.
Z - Probe TestTests the Z-probe pick, measure, and place cycle to verify probe reliability.

8. Quality Control (QC) Macros

Located in System > Calibration > QC/.

Info: IMPORTANT: QC macros are designed for factory testing during printer assembly. They run extended automated test sequences. You should not need these during normal use � the Troubleshooting macros above provide the same individual tests in a user-friendly format.

MacroWhat it does
Test 1Factory acceptance test suite 1: voltage check, LED test, heater test, fan test, motor direction test, Z-screw check, Z-binding test, endstop test (�10), homing test, probe test, and probe calibration.
Test 2Factory acceptance test suite 2: Y-axis endstop alignment, nozzle tightening and purge bucket adjustment, true bed leveling, Z-homing iteration test, and XY movement test.
Enable Probe / Disable ProbeQuick toggles for the Z-probe relay (same as the Z Probe folder versions).
Rotate Z - Probe to Default 0 PositionRotates the probe servo to its default 170� position.

The QC > AutoCal/ subfolder contains the individual calibration routines that the Auto Calibration master macro calls:

MacroWhat it does
Tool Height Auto CalibrationMeasures and corrects the Z-height difference between Tool 0 and Tool 1. Uses three-point bed leveling, then probes nozzle touchdown positions for both tools. If the deviation exceeds tolerance, guides you through a physical heat break adjustment.
Z - Offset CalibrationCalibrates the Z-probe offset by comparing nozzle contact height to probe trigger height at the same point. Takes 3 probe measurements and averages them.
Mesh Bed calibrationProbes the left and right sides of the bed with both the Z-probe and nozzle contact, calculates the difference, and derives an X-axis mesh compensation value.
XY - Offset CalibrationMeasures the XY offset between T0 and T1 by probing a reference hole from 4 directions with each tool nozzle. Two passes per direction for accuracy.
XY Auto SquaringProbes 3 reference holes to measure axis scaling (steps/mm) and squareness angle. Calculates mechanical corrections with safety factor and deadband. Optionally writes corrected steps/mm values.

9. User Configuration Files (0:/user/)

The 0:/user/ directory stores all user-specific settings and calibration results. Every time you change a setting through a macro � whether it is a PID tune, a network switch, a calibration, or a job-end preference � the macro writes the result to a small .g file inside this folder. On startup, the firmware reads these files and applies them automatically.

Warning: IMPORTANT: The 0:/user/ folder is not overwritten by firmware updates. This is what preserves your calibration data, network credentials, and custom settings across updates. Do not delete or rename files in this folder unless instructed by support.

The table below lists every file in the folder, grouped by function. The Default value column shows the factory setting that ships with a new printer.

Network & Identity

FileWhat it storesDefault value
APname.gThe printer's hostname and WiFi access point name (used for <name>.local mDNS access and the AP SSID).22 IDEX
WiFiPass.gThe saved WiFi network credentials (SSID and password) used in WiFi client mode. Written by the Connect to new WiFi network macro.(empty � no network saved)
networkmode.gThe active network mode: WiFi access point (M552 S2), WiFi client (M552 S1), or Ethernet (M552 S-1).WiFi AP mode

Calibration � Z Probe

FileWhat it storesDefault value
ProbeOffset.gZ-probe trigger threshold, X/Y offset from nozzle, and trigger height (G31 command). Written by Z - Offset Calibration.G31 P500 X0 Y28.50 Z... (Z varies per machine)
pickupangle.gThe servo angle used when picking up the Z-probe from its holder. Written by Probe Calibration.170�
pickupposition.gThe X-axis position of the probe holder. Written by Probe Calibration.96.700 mm
zoffset.gThe master Z-offset � the distance between the probe trigger point and the nozzle tip. Written by Z - Offset Calibration and Save Current Z - Offset.(set during calibration)
rtzoffset.gRelative tool Z-offset � the height difference between Tool 0 and Tool 1 nozzles. Written by Tool Height Auto Calibration.0
resetzbabystep.gStores any pending babystep correction that should be applied on next startup. Written by Save Current Z - Offset.(no action)

Calibration � XY Offsets

FileWhat it storesDefault value
tooloffset.gThe combined T1 tool offset in U and Y axes (G10 P1 U... Y...). Written by XY - Offset Calibration and the Live XY Offset Adjustment macros.(set during calibration)
uoffset.gThe U-axis component of the T1 offset (stored as a global variable for display and manual adjustment).(set during calibration)
yoffset.gThe Y-axis component of the T1 offset (stored as a global variable for display and manual adjustment).(set during calibration)

Calibration � Mesh Bed Compensation

FileWhat it storesDefault value
xcomp_mode.gMesh compensation mode: "auto" (measured by the probe) or "manual" (set by the user).manual
xcomp_auto.gThe mesh compensation value measured automatically during Auto Calibration.0
xcomp_manual.gThe mesh compensation value set manually via the Mesh Calibration macros.0

Calibration � XY Squaring

FileWhat it storesDefault value
xy_square_mode.gXY squaring mode: "auto" (measured by the probe) or "manual" (set by the user).manual
xy_square_auto.gThe squaring offset measured automatically during Auto Calibration.0.0
xy_square_manual.gThe squaring offset set manually via the XY Squaring macros.0.0

Calibration � Steps per mm

FileWhat it storesDefault value
stepscal.gWhether automatic steps/mm calibration is enabled (true/false) and the M92 command with the current steps/mm values for all axes.Disabled; 80 steps/mm for X, Y, U; 400 for Z and E

PID Tuning Results

FileWhat it storesDefault value
PIDBedHead.gPID parameters for the bed heater (M307 H2). Written by PID Tuning Bed Heater.(factory-tuned)
PIDLeftHead.gPID parameters for the left toolhead heater � T0 (M307 H0). Written by PID Tuning Left Head.(factory-tuned)
PIDRightHead.gPID parameters for the right toolhead heater � T1 (M307 H1). Written by PID Tuning Right Head.(factory-tuned)

Temperature Sensor Calibration

FileWhat it storesDefault value
BedTempCalibration.gBed temperature sensor configuration (M308 S2) including thermistor type, beta value, and calibration coefficient. Written by Temp Sensor Tuning Bed.(factory-calibrated)
ChamberTempSensor.gChamber air temperature sensor configuration (M308 S3) including thermistor type, beta value, and calibration coefficient. Written by Temp Sensor Tuning Chamber.(factory-calibrated)

Fault Detection

FileWhat it storesDefault value
bedfaultdetection.gBed heater fault detection parameters (M570 H2): monitoring period, temperature tolerance, and allowed deviation. Written by Bed Fault Detection.Enabled (60 s period, 50 �C tolerance)
chamberfaultdetection.gChamber heater fault detection parameters (M570 H3). Written by Chamber Fault Detection.Enabled (600 s period, 70 �C tolerance)
heaterfault_timer.gWhat happens after a heater fault is detected: auto-shutdown disabled, immediate shutdown, or delayed shutdown with a custom timer. Written by Action After Heater Fault.Auto-shutdown disabled

Filament Sensors

FileWhat it storesDefault value
filamentsensor0.gFilament runout sensor configuration for Tool 0 (M591). Written by Sensor Mode Tool 0.Enabled
filamentsensor1.gFilament runout sensor configuration for Tool 1 (M591). Written by Sensor Mode Tool 1.Enabled
filamentbackup.gWhether the 2nd-tool backup feature is enabled (Tool 1 takes over when Tool 0 runs out). Written by 2nd Tool Backup.Disabled (false)

Job End Behavior

FileWhat it storesDefault value
bedfinishbehavior.gThe bed temperature command (M140) to run after a print finishes. Written by Bed Temperature (Job End).M140 S0 (bed off)
chamberfinishbehavior.gThe chamber temperature command (M141) to run after a print finishes. Written by Chamber Temperature (Job End).M141 S0 (chamber off)
lowerbed.gThe bed movement command to run after a print finishes. Written by Bed Position (Job End).Move to Z = 420 mm (bottom)
powerendbehavior.gPost-print power behavior: stay idle or auto-sleep. Written by Power (Job End).Stay idle
retractfinishbehavior.gFilament retraction mode after a print finishes: extended retract, no retract, or one-time retract. Written by Tools Unload (Job End).Skip extended retract

Printing Settings

FileWhat it storesDefault value
chamberwait.gWhether the printer waits for the chamber to reach the target temperature before starting a print (M116 H2). Written by Wait for Chamber Temp.Disabled (do not wait)
periodic_wiping.gPeriodic nozzle wiping interval during printing. Written by Wiping during the print.Disabled
hepafan.gHEPA filter fan speed (0�255 internal scale, where 255 = 100%). Written by Hepa Fan Adjustment.191 (� 75%)
eventlogging.gWhether event logging is enabled (M929). Written by Event Logging.Enabled

Tool Change Retraction

FileWhat it storesDefault value
tool0retract.gCustom retraction distance and speed for Tool 0 during tool changes. Written by Tool Change Retraction.Default: -5 mm at F3000
tool0extrude.gCustom extrusion (prime) distance and speed for Tool 0 after a tool change. Written by Tool Change Retraction.Default: 10 mm at F9000
tool1retract.gCustom retraction distance and speed for Tool 1 during tool changes. Written by Tool Change Retraction.Default: -5 mm at F3000
tool1extrude.gCustom extrusion (prime) distance and speed for Tool 1 after a tool change. Written by Tool Change Retraction.Default: 10 mm at F9000

Info: TIP: If the printer starts behaving unexpectedly after many setting changes, you can ask Vision Miner support for a fresh set of default 0:/user/ files to restore factory settings without a full firmware reinstall.

FAQ

Where are macros stored on the printer?

Macros are stored on the printer's SD card in the 0:/macros/ directory. The Web Interface reads and displays them from there. You can also access them via FTP or by removing the SD card.

Can I edit macros?

Technically yes � macro files can be edited through the Web Interface (System tab ? file browser) or directly on the SD card. However, only do this if you clearly understand what you are changing and why � for example, during troubleshooting under guidance from support. Editing macros on your own without understanding their logic can cause the printer to malfunction or stop working entirely. Firmware updates overwrite macro files, so always keep a backup before making changes.

A macro shows an error and stops � what do I do?

Read the error message in the Web Interface console. Common causes:

  • The printer is not homed (run Home All first).
  • A heater has a fault (run Reset Temp Fault, then diagnose the cause).
  • The Z-probe is not responding (check probe wiring, run Z - Probe Test).

If the error is unclear, copy the full message and contact support.

Can I run macros from the touchscreen?

The touchscreen (PanelDue) has limited macro support. For the full macro list and all interactive prompts, use the Web Interface.

Will a firmware update change my macro settings?

Firmware updates replace the macro files on the SD card. Settings that macros save to user configuration files (e.g., network settings, job end behavior, PID values) are preserved in the 0:/user/ directory and will survive updates. Custom modifications to macro files themselves will be overwritten.

Support

Vision Miner Support

On this page

Your feedback makes it better for everyone.