Xtouch
No description available
Install / Use
/learn @xperiments-in/XtouchREADME
NEW 5 inch Screen

xtouch-pro NEW WEBSITE
2.8 - Table of Contents
- Introduction
- Features
- Installation
- Screens
- OTA Update Procedure
- Standard Firmware Update
- Troubleshooting
Introduction
The xtouch screen is a revolutionary addition to your BambuLab Printer, enhancing the user experience and providing advanced control and monitoring capabilities. This detailed README.md guide will walk you through the product's features, installation process, and the functionality of different screens.
Required Hardware

Currently, it has only been tested on the affordable 2.8-inch ESP32-2432S028R board, which is available for purchase here:
Optional Hardware
- DS18B20 Temperature Sensor: For printers that do not have an integrated chamber temperature sensor, you have the option to add an external DS18B20 temperature sensor. This sensor will provide accurate chamber temperature readings and enhance the functionality of your xtouch screen. Connector on the screen is 1.25 MZ JST 4P.
- DS18B20 P1P/P1S Chamber Temp Enclosure: Additionally, we have created a 3D model that allows you to easily integrate the DS18B20 Temperature Sensor inside your P1P/P1S printer.
You can buy the Temperature Sensor here:
You can find the 3D models
<img src="https://github.com/xperiments-in/xtouch/assets/417709/a8d14564-09e9-4d36-9ad9-10fd8f295c86" width="200"> <img src="https://github.com/xperiments-in/xtouch/assets/417709/22871bdf-ba37-44f0-a4b3-33c6352f7f86" width="300">Powering the xtouch Screen
The xtouch screen can be powered in two different ways: through a USB port or via a JST 1.25 4-pin connector. Below are the details on how to power the screen using each method:
Powering via USB
-
Connect a suitable USB cable to an available USB port on your computer or a USB power source.
-
At the opposite end of the USB cable, connect the USB connector to the xtouch screen.
-
Ensure that the xtouch screen is turned on and that power is being supplied properly through the USB cable. The screen should light up and display the startup information.
Powering via the JST 1.25 4-Pin Connector
The JST 1.25 4-pin connector is an alternative method for powering the xtouch screen. Here is a pinout diagram of this connector:
<img src="readme-assets/power-pinout.png" width="300" style="padding-bottom:16px">To power the screen using this connector, follow these steps:
-
Locate the JST 1.25 4-pin connector on the xtouch screen.
-
Align the pins of the JST 1.25 connector with the corresponding pins on the xtouch screen.
-
Connect the JST 1.25 connector to the xtouch screen, ensuring that the pins are properly aligned.
-
Provide the proper power through the JST 1.25 connector using a compatible power source. Make sure the polarity is correct to prevent damage to the screen.
-
Turn on the xtouch screen and verify that it is receiving power properly.
The choice between USB and the JST 1.25 4-pin connector depends on your preference and resource availability. Make sure the xtouch screen receives the necessary power for optimal operation.
Features
- Advanced Touch Screen: A touch screen interface for intuitive printer control.
- Status Indicators: Top bar indicating WiFi connectivity, camera status, timelapse recording, and AMS status.
- Temperature Monitoring: Real-time display of nozzle, bed, and chamber temperatures.
- Printing Control: Full control over your print job, including the ability to change print speed during printing.
- Precise Control: Control your printer's XYZ position with adjustable head movement steps (1mm and 10mm).
- Filament Handling: Load, unload, extrude, and retract filament (Note: Filament handling available only for printers without AMS initially).
- Switch Between Printers: With a single xtouch screen, you can seamlessly switch between different printers. The access code for linked printers is saved for future use, making it convenient to switch printer connections.
- Customizable Settings: Access a wide range of LCD and printer-related settings.
- OTA Updates: Enable over-the-air updates for firmware enhancements.
Installation
xtouch Screen Setup and Installation Guide
This guide will walk you through the steps required to initialize and configure your xtouch screen for use with your 3D printer.
Required Tools and Preparation
Before beginning, ensure you have the following:
-
Computer with Google Chrome Installed (only for downloading the config file)
-
USB Cable
-
Formatted FAT32 SD Card (≤ 32GB Recommended)
-
xtouch.json Configuration File
- Visit: https://xperiments.in/xtouch-bin/localOnly.html
- Fill in the required information (WiFi SSID, Password, and your BambuLab account details).
- Download the
xtouch.jsonfile and place it on the root of the SD card.
No Chrome extensions, token logins, or cloud provisioning are needed anymore!
Installation Process
Step 1: Open the Online Installer in Google Chrome
- Open Google Chrome on your computer.
Note: Other browsers are not supported for this process.
- Navigate to the installer page by entering the following URL:
https://xperiments.in/xtouch-bin
Step 2: Use the Online Installer
- On the web page, click the "Connect" button to establish a connection between your computer and the xtouch screen.
- From the list of available ports displayed, select the serial port assigned to your xtouch screen.
- Once connected, click the "Install xtouch" button to start the installation process.
Screens
Main Screen
-
Top Bar: Displays WiFi, camera, timelapse, and AMS status.
-
Light Control: Toggle the printer's light on/off.
-
Temperature Indicators: Real-time nozzle, bed, and chamber temperature indicators.
-
Status Area: The Status Area on the touch screen serves two main purposes:
- Idle State: When the printer is not in use, it displays a "Ready" message with the main logo.
- Printing State: During printing, it provides pause/stop buttons, a progress bar, layer info, and a print speed selector for real-time control and monitoring.
Temperature / Fan Screen
On this screen, you'll find four buttons, each representing the temperature or fan speed of a specific sensor. Tapping any of these buttons will direct you to a numeric keyboard screen where you can easily adjust the corresponding temperature or speed value. After making your changes, you can return to the initial screen with a simple tap.
Control Screen
This screen provides essential controls for managing your printer:
- Homing: Initiates printer homing procedure.
- XYZ Position Control: Enables precise control of the print head's XYZ position.
- Step Size: Allows you to toggle between 1mm and 10mm head movement increments for finer or quicker adjustments.
Filament Screen
- Filament Handling: Load, unload, extrude, and retract filament (Note: Filament handling available only for printers without AMS initially).
Settings Screen
LCD
- Change Backlight: In the "Change Backlight" settings, you can adjust the screen backlight to your preferred brightness level.
- Set Screen Sleep Time: Set Screen Sleep Time: Adjusts the screen's inactivity timer. When the screen is idle for the specified time (in minutes), it enters sleep mode to save power. Set to 0 to keep the screen always active. During an active print job, the screen stays on for real-time monitoring.
- Invert Screen Colors: Toggle to reverse screen colors. Useful for addressing compatibility issues with certain devices.
- Flip Screen: Flip the screen orientation.
XTOUCH
- AUX FAN: Enable the auxiliary fan for printers that initially lack it.
- CHAMBER Temp: Enable chamber temperature monitoring for printers without it.
- OTA Update: Enable OTA upgrades for firmware updates.
OTA Update Procedure
The xtouch screen supports Over-The-Air (OTA) firmware updates, making it easy to keep your device up to date with the latest features and improvements. To enable and utilize OTA updates, follow these steps:
-
Access the Settings Screen:
- Navigate to the Settings Screen on your xtouch screen.
-
Enable OTA Updates:
- In the Settings Screen, locate the OTA Update section. You will find an option to enable OTA updates. Toggle this option to "ON" to enable automatic firmware update checks.
-
Automatic Update Check on Boot:
- With OTA updates enabled, your touch screen will automatically ch

