Issue description

If you have already configured the Wi-Fi network for your xTool laser device but it still doesn’t appear in the device list (with a message: “Can't find device connected through Wi-Fi”), please follow the steps below to troubleshoot this issue.

Note: If your xTool device is not being detected during Wi-Fi configuration, please ensure that Wi-Fi has been configured properly. For more details, refer to Wi-Fi Connection.

Troubleshooting

STEP 1: Verify Wi-Fi network consistency

• 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 2: Check Wi-Fi Name and PWD

• Make sure the Wi-Fi name and passwords consist of only pure letters and numbers, which do not contain special characters such as ', ", !, or \.
• Verify if the Wi-Fi password for the configured network has been changed. If yes, reconnect the device using a USB cable to reconfigure Wi-Fi.
• Ensure the Wi-Fi password does not exceed 32 characters. If it exceeds this limit, shorten the password.

STEP 3: Check Wi-Fi frequency compatibility

• 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.

• 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:

Follow the instructions below to check if the Wi-Fi network is 5GHz frequency.

Note: The instructions provided below demonstrate the process on the Win11 system. For Windows systems versions prior to 11, the procedures are similar.

  a. Click the "Search" icon and enter "Settings"; then click "Open".

  b. On the left panel, select "Network & internet".

  c. Click “Wi-Fi”.

  d. Click "Hardware properties".

  e. Check the Wi-Fi network band to see if it's 5GHz.

Note: As the Wi-Fi setup interfaces of different routers may vary, the image below is for reference purposes only.

STEP 4: Check network conditions

• If the network is weak, switch to a network with a better signal.
• If the connection is stable, proceed to Step 5.

• 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 5: Check for proxy settings

• 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 6.

STEP 6: Disable the VPN and Firewall

STEP 7: Check application permissions (for macOS 15.0 or above)

• If the "Don’t Allow" is selected, XCS will be denied access to the device. 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.

• Go to Settings > Privacy & Security > Local Network.
• If the local network access is disabled, toggle the switch to enable it, allowing the software to access your local network.

• If no restrictions exist, proceed to Step 8.

STEP 9: Check if the device is hidden

1. Connect the device to your computer with the USB cable.
2. Open your browser and select the link that corresponds to your operating system.

• For Windows: http://201.234.3.1:8080/net?action=getssid
• For Mac: http://201.234.4.1:8080/net?action=getssid

3. Input the link in the address bar and press enter.
4. This will give you the name of the Wi-Fi connected last time.

• If the webpage displays {"result":"failed"} or other Wi-Fi names, it suggests that the device isn't connected to the current Wi-Fi. The Wi-Fi you're currently using needs reconfiguration in XCS software.
• If it shows the Wi-Fi you are using, proceed to the next step to establish an IP connection.

1. Input the link in the address bar and press enter:

• For Windows: http://201.234.3.1:8080/net?action=ifconfig
• For Mac: http://201.234.4.1:8080/net?action=ifconfig

2. This will give you the IP address needed for the connection.
3. Copy the text between the quotation marks after “wlan0-ip”, as shown below.

1. Launch XCS and go to the IP tab under the Connect device window.
2. Paste the IP address and click "connect".
3. Check if the issue is resolved.

STEP 10: Update xTool Creative Space (XCS)

• Ensure you have downloaded the latest version of XCS.
• If you are using version 1.78 or below, the device may not be found or recognized.
• Download the latest version of XCS: https://www.xtool.com/pages/software

STEP 11: Upgrade the Firmware

Note: Only the xTool D Series and S1 need to have their firmware updated.

STEP 12: Check the Wi-Fi antenna cable

• Check if the Wi-Fi antenna cable (refer to the image below) is disconnected. If so, reconnect the cable properly. For the disassembly of corresponding models and the positions of cables, please refer to Remove the Casing of Your Device.

1. Remove the rear interface board of the device.
2. Check if the antenna wire on the main control board is connected properly.
3. Unplug and replug the antenna wire to make sure of a firm connection.

Additional steps

• Try restarting both your laser device and xTool Creative Space (XCS).
• Alternatively, you may resort to a USB cable connection for operation.