Browser-based installer

Flash CrossPet Firmware

Install CrossPet firmware on your Xteink X4 in minutes. No drivers, no command line required. Works on Chrome and Edge on desktop.

Before you flash

Back up your settings (optional)

This is an OTA update — only the firmware partition is overwritten. Bootloader, partition table, and SD card are untouched. Device settings (NVS) are preserved. Back up .crosspoint/ on SD if you want extra safety.

Connect your Xteink X4 via USB-C

Use a data-capable USB-C cable (not charge-only). The device should appear as a serial port. If it doesn't, wake the device first and try again.

Wake and unlock the device

Press the power button to wake from deep sleep. The USB serial interface is only active while the device is awake. You do not need to put it into bootloader mode — the installer handles that automatically.

Click "Flash CrossPet Firmware" below

Your browser will ask you to select the serial port. Choose the one labelled "USB JTAG/serial debug unit" or similar ESP32-C3 entry. The installer will download the firmware and flash all partitions automatically.

Your browser does not support Web Serial. Please use Chrome or Edge. Firefox and Safari do not support Web Serial. Please open this page in Chrome or Edge on a desktop computer, or use the community flasher at xteink.dve.al.

Connecting...

OTA flash only — preserves bootloader and partition table. Your SD card data is not affected.

Or use the community flasher at xteink.dve.al

Manual Installation (PlatformIO)

For developers who want to build and flash from source.

Prerequisites

Python 3.8+ and PlatformIO CLI
USB-C data cable
Git

Steps

# Clone the repository
git clone https://github.com/trilwu/crosspet.git
cd crosspoint-reader

# Create local config (set your serial port)
cat > platformio.local.ini <<'EOF'
[env:default]
upload_port = /dev/ttyUSB0   # Linux: /dev/ttyUSB0, macOS: /dev/cu.usbmodem*, Windows: COM3
monitor_port = /dev/ttyUSB0
EOF

# Build and flash (wake your device first)
pio run -t upload

# Optional: open serial monitor
pio device monitor

Build Environments

# Development build (full logging)
pio run

# Production build (logging stripped)
pio run -e gh_release

# Release candidate (minimal logging)
pio run -e gh_release_rc

Reverting to Official Firmware

CrossPet does not modify the bootloader or partition table, so reverting is straightforward.

Download the official Xteink X4 firmware from xteink.dve.al
Connect your device via USB-C and wake it
Use the official flasher tool or esptool.py to write the original firmware image
Your SD card books are unaffected — only device settings reset

If the device fails to boot after flashing, hold the Up side button while connecting USB to enter bootloader mode, then re-flash.