This is an automated email from the ASF dual-hosted git repository.
acassis pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/nuttx.git
commit 447c50cbee1c771173f9d5bc01d5e9911ef3b1e0
Author: Eren Terzioglu <eren.terzio...@espressif.com>
AuthorDate: Sat Jul 5 18:07:42 2025 +0200
Docs/games: Add match4 game docs
Add match4 game docs
Signed-off-by: Eren Terzioglu <eren.terzio...@espressif.com>
---
Documentation/applications/games/match4/index.rst | 31 +++++++++++++++++++++++
1 file changed, 31 insertions(+)
diff --git a/Documentation/applications/games/match4/index.rst
b/Documentation/applications/games/match4/index.rst
new file mode 100644
index 00000000000..703e66bd5bd
--- /dev/null
+++ b/Documentation/applications/games/match4/index.rst
@@ -0,0 +1,31 @@
+=========================
+``match4`` Match4
+=========================
+
+Match4 is a classic puzzle game inspired by Connect Four and match-based logic
games.
+The game is played on a matrix (e.g., 6x6, 8x8) where colored blocks fall into
columns
+and the goal is to align four identical blocks in a row—vertically,
horizontally, or diagonally.
+
+The objective is to match four blocks of the same color row—vertically,
horizontally, or diagonally.
+As the game progresses, blocks continue to fall, and the challenge is to
manage the board to avoid it filling up.
+
+The game ends if there are no available moves left (e.g., the board is full
and no matches are possible) or one player
+achieve to match 4 blocks.
+
+Basic Test
+----------
+
+To play game, you need to have a led matrix (e.g. ws2812) for output
+and three gpio pins to input.
+
+Alternatively, you can give inputs using serial console by changing settings.
+
+Then you can configure and compile the game to play in your board,
+i.e. for ESP32-Devkitc there is already an example::
+
+
+ $ ./tools/configure.sh esp32-devkitc:match4
+ $ make -j flash ESPTOOL_PORT=/dev/ttyUSB0
+ $ minicom
+ nsh> match
+
