issue description
If your xTool device is detected during Wi-Fi search in the "Devices list" but fails to connect, follow the steps below to resolve the issue.
Troubleshooting
STEP 1: Check network conditions
Assess your network connection quality:
- If the network is weak, switch to a network with a better signal.
- If the connection is stable, proceed to Step 2.
To evaluate your network conditions:
- For Windows:
- Connect your xTool laser device via USB.
- Go to Device settings > Basic info to check the previously configured IP address.

- Access "Command Prompt".

- Enter
ping [IP address]
to check the network connection.
- If the response time exceeds 150ms, this indicates a weak network connection.
- For macOS:
- Connect your xTool laser device via USB.
- Go to Device Settings > Basic Info to check the previously configured IP address.

- Access "Terminal".

- Enter
ping [IP address]
to check the network connection.
- If the response time exceeds 150ms, this indicates a weak network connection.
STEP 2: Verify Wi-Fi network consistency
- Check if your computer is connected to the same Wi-Fi network as the xTool device.
- If not, connect both the computer and device to the same Wi-Fi network.
- If they are on the same network, proceed to Step 2.
STEP 3: Check Wi-Fi frequency compatibility
The following xTool models only support 2.4 GHz Wi-Fi: F1 Ultra, F1, M1 Ultra, M1, D Series, S1, and P2 Series.
- Check if your router is set to 2.4GHz.
- If your router is set to 5 GHz, switch to 2.4 GHz.
- If already set to 2.4 GHz, proceed to Step 4.
- To verify your router's frequency:
- For macOS:
- Connect to your Wi-Fi network.
- Navigate to the Wi-Fi icon on the top right bar.
- Hold down the "⌥ Option key" and click on the "Wi-Fi icon".
- A window will pop up.
- Navigate to the "Channel" information where the text will display either 5 GHz or 2.4 GHz.
- For Windows:
- Connect to your Wi-Fi network.
- Navigate to the Wi-Fi icon on the bottom right side of the screen.
- Click on "Properties".
- The "Settings" window will pop up. Scroll down to the "Properties" section.
- The "Network band" will indicate whether the frequency is 5 GHz or 2.4 GHz.
STEP 4: Check for proxy settings
Ensure your computer is not using a proxy, as this can interfere with device detection.
- If a proxy is enabled, turn it off and try connecting again.
- On Windows, navigate to Settings > Network & internet > Proxy to check and adjust settings if needed.
- On macOS, navigate to Settings > Network > Wi-Fi > Details > Proxies to check and adjust settings if needed.
- If no proxy is enabled, continue to Step 5.
STEP 5: Check application permissions (for macOS 15.0 or above)
Verify if your macOS has settings that restrict xTool Creative Space from discovering local network devices.
- If restrictions exist, change the settings to allow xTool Creative Space to detect local devices.
- If no restrictions exist, proceed to Step 6.
To check your local network device settings:
- Go to Settings > Privacy & Security > Local Network.
- Ensure that xTool Creative Space has network access; otherwise, the machine cannot connect to the computer.
- If the local network access is disabled, toggle the switch to enable it, allowing the software to access your local network.
STEP 6: Update xTool Creative Space (XCS)
If this is a new laser device, ensure you’ve downloaded the latest version of xTool Creative Space (XCS).
- If not, download the latest version from the official xTool website at https://www.xtool.com/pages/software or through XCS.
- If none of these steps resolve your issue, please contact xTool Customer Service for further assistance.
Additional steps:
If none of the above steps resolve your issue:
- Try restarting both your laser device and xTool Creative Space (XCS).
- Alternatively, you may resort to a USB cable connection for operation.
If none of these steps resolve your issue, please contact xTool Customer Service at
support@xtool.com for further assistance.