This is an automated email from the ASF dual-hosted git repository. xiaoxiang pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/nuttx.git
commit 10e1540b5378b08078ba0b5650e38c29f3a1f68a Author: Alan Carvalho de Assis <[email protected]> AuthorDate: Mon Oct 23 12:52:08 2023 -0300 games: Add documentation This commit add support to Games documentation on NuttX. Signed-off-by: Alan Carvalho de Assis <[email protected]> --- Documentation/applications/games/brickmatch.rst | 40 +++++++++++++++++++++++++ Documentation/applications/games/index.rst | 15 +++++++++- 2 files changed, 54 insertions(+), 1 deletion(-) diff --git a/Documentation/applications/games/brickmatch.rst b/Documentation/applications/games/brickmatch.rst new file mode 100644 index 0000000000..4049054b74 --- /dev/null +++ b/Documentation/applications/games/brickmatch.rst @@ -0,0 +1,40 @@ +========== +Brickmatch +========== + +Brickmatch is a kind puzzle game like a mix between tetris and Candy +Crush. It is a 6x6 matrix with blocks (cells) with different colors. + +Your goal is to move the blocks of the board to unite three or +more with the same color. + +Everytime that three of more blocks with the same color match that block +will blink and it will be removed from the board, leaving more space +for movements. + +The game starts with only the border cells filled and you can move the +walls, floor and ceil in direction to the center of the board to make +the cells of same color to match. + +Basic Test +========== + +The best way to play brickmatch is using an APA102 RGB 16x16 matrix +and Gesture sensor APDS9960. There are some board examples already +done for this integration, all you need to do is connecting the APA102 +matrix to the right SPI pins (look your board configuration) and the +APDS9960 to the I2C port (also connect its INT pin). + +If you don't have an APA102 matrix you can also play it using an LCD +display and a digital joystick (DJOYSTICK) or the console input. + +Then you can configure and compile the game to play in your board, +i.e. for ESP32-Devkitc there is already an example using the APA102: + + + $ ./tools/configure.sh esp32-devkitc:brickmatch + $ make -j flash ESPTOOL_PORT=/dev/ttyUSB0 + $ minicom + nsh> brick + +That is it! Have fun! diff --git a/Documentation/applications/games/index.rst b/Documentation/applications/games/index.rst index 2f7545354e..54201e9d65 100644 --- a/Documentation/applications/games/index.rst +++ b/Documentation/applications/games/index.rst @@ -2,4 +2,17 @@ Games ===== -- shift - Shift Game +NuttX is not only an RTOS, it is a rich ecosystem with much fun. +And for many people fun is related to games! So let's play! + +Here you will find the list of games currently supported by NuttX. + +An interesting fact is that originally NuttX had the Traveler game. +It is a raycasting game that Greg Nutt developed from scratch, similar +to Doom in many ways. That game is not part of Apache NuttX. + +.. toctree:: + :maxdepth: 2 + :caption: Contents + + brichmatch.rst
