Ajout desc

PacoMouseCYD/Platformio/Arduino.old/play.ino

@@ -1,3 +1,71 @@
+
+/**
+ * @file play.ino
+ * @brief Station Run - Model Train Game for Kids for PacoMouseCYD throttle.
+ * @author F. Cañada
+ * @date 2025-2026
+ * @copyright https://usuaris.tinet.cat/fmco/
+ *
+ * This file contains functions for the Station Run game, including station time updates,
+ * level and target management, and game logic for the PacoMouseCYD throttle.
+ */
+
+////////////////////////////////////////////////////////////
+// API Documentation
+////////////////////////////////////////////////////////////
+/**
+ * @brief Updates the station time display.
+ * @param seconds The number of seconds to display.
+ */
+void updateStationTime(uint16_t seconds);
+
+/**
+ * @brief Updates the target number of stations for the current level.
+ */
+void updateStationTarget();
+
+/**
+ * @brief Initializes or resets station counters for the game.
+ * @param ini If true, initializes counters; otherwise, resets for new round.
+ */
+void newStationCounters(bool ini);
+
+/**
+ * @brief Generates a new station number, avoiding repetition of the last.
+ * @param last The last station number used.
+ * @return The new station number.
+ */
+uint8_t newStation(byte last);
+
+/**
+ * @brief Updates the display for the target number of stations.
+ */
+void updateTargetStations();
+
+/**
+ * @brief Updates the display for the current count of stations.
+ */
+void updateCountStations();
+
+/**
+ * @brief Updates the display for the current game level.
+ */
+void updateStationLevel();
+
+/**
+ * @brief Updates the display for the number of stars earned.
+ */
+void updateStationStars();
+
+/**
+ * @brief Sets a new target station and updates icon positions.
+ */
+void setNewTarget();
+
+////////////////////////////////////////////////////////////
+// End API Documentation
+////////////////////////////////////////////////////////////
+
 /*    PacoMouseCYD throttle -- F. Cañada 2025-2026 --  https://usuaris.tinet.cat/fmco/
 */