Frequently Asked Questions

No. The supplied YAML deliberately enables many unrelated outputs and test functions so the board can be checked on a bench. Keep an untouched diagnostic copy, then create a machine-specific copy with the correct axes, steps/mm, direction, travel, homing, limits, spindle/laser and safety settings.

Use the official FluidNC Web Installer or the package supplied for your controller. Select the target that matches the processor on your exact board: do not select an ESP32-S3 target for a classic ESP32-WROOM module, and do not flash firmware intended for another PiBot model.

Usually no. USB may power the processor module, but the carrier board, 5 V buffers, optocouplers, motor-signal LEDs and power outputs require the board's specified main supply. Follow the power-on page for your model before testing I/O.

Confirm that the uploaded file is plain text, that indentation uses spaces rather than tabs, and that the filename selected by $Config/Filename exactly matches the uploaded file. Read the first error in the boot log; later errors are often consequences of the first one.

This answer comes from the original V4.96 FAQ: avoid starting diagnosis with an excessively large or high-speed card because the ESP32 SD library and card compatibility vary. PiBot's earlier validation used a Class 4 TF card. Use a known-good FAT32 card, check the exact board's CS/MISO/MOSI/SCK mapping, insert it with power off, and read the first SD-related boot-log error.

Use the Documentation chapter for the exact controller. For example, the original V4.96 FAQ links to its XYYZAB configuration example. Do not use that file on V4.7B, V5.77 or V5.88.

Wait at least 10 seconds after power-up, confirm the correct firmware was installed, and check the USB boot log. Disconnect optional pendants or expanders during diagnosis because a shared boot/UART signal held in the wrong state can prevent normal startup on some boards.

Join the controller's FluidNC access-point network, then open http://192.168.0.1 in Chrome or another modern browser. Do not add https:// for the controller's local AP address.

Click Cancel in the macOS captive-network window. Stay connected to the FluidNC Wi-Fi network, open Chrome manually, and enter http://192.168.0.1. The message only means the isolated controller network has no Internet access; it does not mean the FluidNC AP failed.

No. A reboot, configuration reload or Wi-Fi change temporarily closes the browser connection. Wait for the controller to finish starting, reconnect to its Wi-Fi if needed, and reload the page.

Yes. Current LightBurn documentation lists GRBL, FluidNC and grblHAL as supported GCode controller types. Select the appropriate device type and then verify laser mode, PWM pin, S-value range, dimensions, homing and interlocks on your actual machine.

The customer's documented V4.96 / FluidNC 3.8.3 comparison: changing only the stepping engine significantly reduced the direction-dependent offset on this machine.

All boards First save the LightBurn file and record speed, acceleration, line interval/DPI and power. Engrave the same small text or rectangle once with bidirectional scanning and once with bidirectional scanning disabled. If the one-way result is clean while alternate two-way lines shift, continue below.

1. Check X-axis belt tension, pulley set screws, carriage play, backlash and cable drag. Repeat at a lower speed and acceleration before applying compensation.
2. Follow LightBurn's Scanning Offset Adjustment guide for a repeatable speed-dependent offset.
3. I2SO FluidNC boards Back up the YAML. Change only stepping.engine from I2S_STREAM to I2S_STATIC, restart and repeat the identical job. Do not also change steps/mm, speed, acceleration or pulse width.
4. If the comparison does not help, restore the backup and continue mechanical/speed diagnosis.

This is a documented comparison, not proof that every offset is a FluidNC fault or that every machine must use I2S_STATIC. See the original V4.96 case record and the FluidNC I2SO discussion.

Those commands operate the pins assigned in the active YAML. PiBot test YAML files intentionally map them to convenient diagnostic outputs. Read the test page and YAML for your model instead of assuming that the command always belongs to a particular connector.

From the original V4.96 FAQ: yes, when the driver accepts the controller's EN, DIR, CLK/STEP and GND signals. In that basic connection the controller sends motion signals but does not automatically receive the driver's encoder feedback. Use a separate compatible alarm/feedback input if the driver and machine design require it.

V4.7B is a carrier board. The ESP32 module can appear alive from USB while the carrier's 5 V supply, I2S buffers, output LEDs and power circuits are not operating. Connect correctly polarized 12-24 V main power before following the I/O checklist.

Both functions share GPIO.25 and GPIO.27. The test YAML enables OLED and leaves UART2 commented. To test RJ12, disable the OLED section, enable the UART2 section, select the RJ12/expander hardware position, and restart.

RS485 uses GPIO.15 for TX and GPIO.14 for direction. The same signals also feed the 0-10 V Forward/Reverse interface. The supplied test YAML reserves them for RS485 and leaves Forward/Reverse as NO_PIN; the analog 0-10 V signal on GPIO.13 can still be tested.

They do not. These are carrier boards with Step/Dir/Enable outputs for external stepper drivers. V4.7B uses a classic 38-pin ESP32 DevKitC/WROOM-32 module; V5.77 uses its specified plug-in ESP32-S3 module.

The board has six dedicated motor groups. Extra I/O signals may be configured as one additional motor group on V5.88 or two on V5.77, or used as ordinary I/O. The same signals cannot serve both purposes simultaneously.

Yes, using an input that includes SW-VCC and setting that input supply to 24 V as shown in the V4.96 diagram overview. This answer is specific to V4.96's selectable SW-VCC input design; it must not be copied to V4.7B.

The original FAQ states that V4.1 added two voltage-divider resistors. Check the silkscreen on the back because the front silkscreen may be incorrect. When those ports are used as ordinary switches, the original instruction is to connect +5 V and signal; the divider presents about 3 V at the STM32 input, so configure high-level triggering.

Original V4.96 FAQ diagram retained rather than rewritten.

Yes. The original FAQ links to Customer Video 1 on YouTube.

This table preserves the original V4.96 FAQ mapping. Verify the exact pendant firmware and physical cable before power-on.

Original FAQ image: ESP3D UI option for enabling/disabling RX/TX pin swapping.

V5.77 is a carrier board. The specified ESP32-S3 module provides the processor, Wi-Fi, USB and firmware storage. Seat it in the silkscreened orientation only while power is off.

The original V5.77 test YAML uses GPIO 38 for the Z limit. Choose GPIO 38 when the module's RGB LED occupies GPIO 48. If another module revision uses GPIO 38 for its LED, move the jumper to GPIO 48 and change the YAML pin.

Not from the shared SW-VCC rail: its jumper selects one voltage for all ten headers. Use suitable external sensor power and safe common-ground/isolation practice for a mixed-voltage system.

In the original test YAML, M64/M65 P0-P5 control the six reserved I2SO outputs. The MOSFET channels use coolant commands: M7 for GPIO 4, M8 for GPIO 5 and M9 to turn both off.

Each onboard MOSFET channel is rated at 1.5 A maximum and is intended for light loads. For a heavier load, use the channel to control an external relay or suitable power driver. Connecting a heavy load directly can burn the MOSFET.

The analog speed signal and run contacts are separate. Check GPIO 7 Forward / GPIO 8 Reverse with Out Common, the VFD terminal mode, analog input type, common, minimum frequency and interlocks. For RS485, check address, baud, model commands and A/B polarity.

Not when the native secondary USB channel is unused. The original FAQ instructs users to send $USBCDC/Enable=OFF when that channel is not used, and to re-enable/configure it before the optional USB-host test.

Yes, on all six dedicated axes. Each channel provides a Pololu-format on-board socket and an external 5 V Step/Dir/Enable output, with per-axis SPI chip select for supported SPI driver arrangements.

The original FAQ lists SW-VCC Voltage Selection, Stepper Driver VDD Logic Voltage Selection and GPIO 3 Function Selection. Follow the V5.88 2.2 Check Jumpers and Power On page and re-check them whenever the driver type or Extra I/O use changes.

Yes. Match its orientation to the socket silkscreen before power-on. Never hot-plug drivers, motors, OLED or pendant equipment.

Each io.4/io.5 channel is rated at 500 mA maximum. Use an external relay or suitable power driver for heavier loads; connecting a heavy load directly can burn the MOSFET.

The original FAQ lists SSID fluidnc, password 12345678 and WebUI http://192.168.0.1. Wait about ten seconds after boot before searching for the network.

No when using the CP2102 USB path while the ESP32-S3 native USB channel is unused. The original FAQ recommends $USBCDC/Enable=OFF if the native channel is not required.