v1.1.0

Games and small tools for the Xteink X4 Pro, on top of
CrossPoint. Thirteen games --
Chess, Checkers, Connect Four, Yahtzee, Knucklebones, Minesweeper,
Battleship, Connections, Solitaire, D&Diagrams, Insider, Jaipur and
Murdle -- plus spaced-repetition flashcards, Hacker News and the
xkcd archive. Seven of them play over PLAY NEARBY: Chess,
Checkers, Connect Four, Yahtzee, Knucklebones, Battleship and
Jaipur. Two devices next to each other find one another with
nothing to type.

Which file to download

crossplay-<version>-x4pro-full.bin is the one to flash over
USB. It is the whole firmware -- bootloader, partition table and
application in one image -- so it installs on a device that has
never run CrossPoint.

firmware.bin is the application on its own, for a device that
is already running this. Settings -> Check for updates fetches it
over Wi-Fi, or you can copy it to the SD card and pick it there.
Keep that filename: the updater matches it exactly.

v1.0.0 and v1.0.1 published only the application image and told you
to write it to 0x0, which on an ESP32-S3 is where the bootloader
lives. Do not follow the install steps from those two releases.

Try the whole thing in a browser first, without owning one:
crossplay.ma-r-s.com runs this
same firmware compiled to WebAssembly.

Before you flash this

No one has run this build on a physical device. It is developed
against a simulator and a browser build of the same sources, and the
author does not have an X4 Pro. The host test suites pass and both
firmware targets compile, but "compiles and passes tests" is not
"known to boot". You are the hardware test. If it does not work,
please open an issue
and say what happened.

The X4 Pro only. The X4 and X3 are ESP32-C3; this is an S3.
Flashing it there is a cross-chip flash. Install
CrossPoint on those instead.

Flashing replaces the firmware, not the SD card. Your library,
your reading positions and your fonts are files on that card and are
left alone. Installing stock CrossPoint over the top puts the device
back where it was, which is what makes this cheap to try. If a flash
goes wrong,
docs/fix-bricked-xteink.md
is the way back.

Full install steps are in the
README. The short
version, once pip install esptool has run:

esptool.py --chip esp32s3 --baud 921600 write_flash 0x0 crossplay-<version>-x4pro-full.bin

v1.0.2

Games and small tools for the Xteink X4 Pro, on top of
CrossPoint. Thirteen games --
Chess, Checkers, Connect Four, Yahtzee, Knucklebones, Minesweeper,
Battleship, Connections, Solitaire, D&Diagrams, Insider, Jaipur and
Murdle -- plus spaced-repetition flashcards, Hacker News and the
xkcd archive. Seven of them play over PLAY NEARBY: Chess,
Checkers, Connect Four, Yahtzee, Knucklebones, Battleship and
Jaipur. Two devices next to each other find one another with
nothing to type.

Which file to download

crossplay-<version>-x4pro-full.bin is the one to flash over
USB. It is the whole firmware -- bootloader, partition table and
application in one image -- so it installs on a device that has
never run CrossPoint.

firmware.bin is the application on its own, for a device that
is already running this. Settings -> Check for updates fetches it
over Wi-Fi, or you can copy it to the SD card and pick it there.
Keep that filename: the updater matches it exactly.

v1.0.0 and v1.0.1 published only the application image and told you
to write it to 0x0, which on an ESP32-S3 is where the bootloader
lives. Do not follow the install steps from those two releases.

Try the whole thing in a browser first, without owning one:
crossplay.ma-r-s.com runs this
same firmware compiled to WebAssembly.

Before you flash this

No one has run this build on a physical device. It is developed
against a simulator and a browser build of the same sources, and the
author does not have an X4 Pro. The host test suites pass and both
firmware targets compile, but "compiles and passes tests" is not
"known to boot". You are the hardware test. If it does not work,
please open an issue
and say what happened.

The X4 Pro only. The X4 and X3 are ESP32-C3; this is an S3.
Flashing it there is a cross-chip flash. Install
CrossPoint on those instead.

Flashing replaces the firmware, not the SD card. Your library,
your reading positions and your fonts are files on that card and are
left alone. Installing stock CrossPoint over the top puts the device
back where it was, which is what makes this cheap to try. If a flash
goes wrong,
docs/fix-bricked-xteink.md
is the way back.

Full install steps are in the
README. The short
version, once pip install esptool has run:

esptool.py --chip esp32s3 --baud 921600 write_flash 0x0 crossplay-<version>-x4pro-full.bin