基本功能已完成，还差功耗和架构优化

2026-08-24 18:03:39 +08:00
parent 81bd2f724d
commit 0e6a93c12d
25 changed files with 4847 additions and 33 deletions
@@ -0,0 +1,61 @@
+/******************************************************************************
+ * @file    app_mode.h
+ * @brief   6 种自动玩法：节拍含方向与 PWM 占空比（0=停，1~6=波形）
+ * @author  cyWu <1917507415@qq.com>
+ * @date    2026.08.24
+ * @version V1.2.0
+ * @history
+ * - V1.0.0, 2026.08.21, cyWu, 首次发布
+ * - V1.1.0, 2026.08.24, cyWu, 接入 H 桥往返节拍
+ * - V1.2.0, 2026.08.24, cyWu, 节拍带占空比；六档波形加花样
+ ******************************************************************************/
+
+#ifndef __APP_MODE_H__
+#define __APP_MODE_H__
+
+#include <stdint.h>
+
+typedef enum {
+    APP_MODE_OK = 0,
+    APP_MODE_ERR_PARAM,
+    APP_MODE_ERR_NOT_INIT
+} AppMode_Ret_t;
+
+/**
+ * @brief  初始化，电机停
+ * @return APP_MODE_OK=成功
+ */
+AppMode_Ret_t app_mode_init(void);
+
+/**
+ * @brief  启动自动模式 1~6，循环播放节拍
+ * @param  mode 玩法编号，范围 1~6
+ * @return APP_MODE_OK=成功，APP_MODE_ERR_NOT_INIT=未初始化，APP_MODE_ERR_PARAM=参数非法
+ */
+AppMode_Ret_t app_mode_start(uint8_t mode);
+
+/**
+ * @brief  停止玩法并刹车
+ * @return 无
+ */
+void          app_mode_stop(void);
+
+/**
+ * @brief  推进当前节拍（按真实毫秒，不依赖回调是否刚好 1ms）
+ * @return 无
+ */
+void          app_mode_run(void);
+
+/**
+ * @brief  读取当前自动模式
+ * @return 0=停转，1~6=对应玩法
+ */
+uint8_t       app_mode_get_active(void);
+
+/**
+ * @brief  查询是否已初始化
+ * @return APP_MODE_OK=已初始化，APP_MODE_ERR_NOT_INIT=未初始化
+ */
+AppMode_Ret_t app_mode_get_status(void);
+
+#endif /* __APP_MODE_H__ */