第一次提交

2026-05-29 17:36:34 +08:00
commit 5b3333125d
1318 changed files with 722705 additions and 0 deletions
@@ -0,0 +1,93 @@
+#include "bsp_pwm.h"
+#include "buzzer.h"
+#include "bsp_dwt.h"
+#include "string.h"
+
+static PWMInstance *buzzer;
+// static uint8_t idx;
+static BuzzzerInstance *buzzer_list[BUZZER_DEVICE_CNT] = {0};
+
+/**
+ * @brief 蜂鸣器初始化
+ *
+ */
+void BuzzerInit()
+{
+    PWM_Init_Config_s buzzer_config = {
+        .htim = &htim12,
+        .channel = TIM_CHANNEL_2,
+        .dutyratio = 0,
+        .period = 0.001,
+    };
+    buzzer = PWMRegister(&buzzer_config);
+}
+
+BuzzzerInstance *BuzzerRegister(Buzzer_config_s *config)
+{
+    if (config->alarm_level > BUZZER_DEVICE_CNT) // 超过最大实例数,考虑增加或查看是否有内存泄漏
+        while (1)
+            ;
+    BuzzzerInstance *buzzer_temp = (BuzzzerInstance *)malloc(sizeof(BuzzzerInstance));
+    memset(buzzer_temp, 0, sizeof(BuzzzerInstance));
+
+    buzzer_temp->alarm_level = config->alarm_level;
+    buzzer_temp->loudness = config->loudness;
+    buzzer_temp->octave = config->octave;
+    buzzer_temp->alarm_state = ALARM_OFF;
+
+    buzzer_list[config->alarm_level] = buzzer_temp;
+    return buzzer_temp;
+}
+
+void AlarmSetStatus(BuzzzerInstance *buzzer, AlarmState_e state)
+{
+    buzzer->alarm_state = state;
+}
+
+void BuzzerTask()
+{
+    BuzzzerInstance *buzz;
+    for (size_t i = 0; i < BUZZER_DEVICE_CNT; ++i)
+    {
+        buzz = buzzer_list[i];
+        if (buzz->alarm_level > ALARM_LEVEL_LOW)
+        {
+            continue;
+        }
+        if (buzz->alarm_state == ALARM_OFF)
+        {
+            PWMSetDutyRatio(buzzer, 0);
+        }
+        else
+        {
+            PWMSetDutyRatio(buzzer, buzz->loudness);
+            switch (buzz->octave)
+            {
+            case OCTAVE_1:
+                PWMSetPeriod(buzzer, (float)1 / DoFreq);
+                break;
+            case OCTAVE_2:
+                PWMSetPeriod(buzzer, (float)1 / ReFreq);
+                break;
+            case OCTAVE_3:
+                PWMSetPeriod(buzzer, (float)1 / MiFreq);
+                break;
+            case OCTAVE_4:
+                PWMSetPeriod(buzzer, (float)1 / FaFreq);
+                break;
+            case OCTAVE_5:
+                PWMSetPeriod(buzzer, (float)1 / SoFreq);
+                break;
+            case OCTAVE_6:
+                PWMSetPeriod(buzzer, (float)1 / LaFreq);
+                break;
+            case OCTAVE_7:
+                PWMSetPeriod(buzzer, (float)1 / SiFreq);
+                break;
+            default:
+                break;
+            }
+            break;
+        }
+    }
+}
@@ -0,0 +1,60 @@
+#ifndef BUZZER_H
+#define BUZZER_H
+#include "bsp_pwm.h"
+#define BUZZER_DEVICE_CNT 5
+
+#define  DoFreq  523
+#define  ReFreq  587
+#define  MiFreq  659
+#define  FaFreq  698
+#define  SoFreq  784
+#define  LaFreq  880
+#define  SiFreq  988
+
+typedef enum
+{
+    OCTAVE_1 = 0,
+    OCTAVE_2,
+    OCTAVE_3,
+    OCTAVE_4,
+    OCTAVE_5,
+    OCTAVE_6,
+    OCTAVE_7,
+    OCTAVE_8,
+}octave_e;
+
+typedef enum
+{
+    ALARM_LEVEL_HIGH = 0,
+    ALARM_LEVEL_ABOVE_MEDIUM,
+    ALARM_LEVEL_MEDIUM,
+    ALARM_LEVEL_BELOW_MEDIUM,
+    ALARM_LEVEL_LOW,
+}AlarmLevel_e;
+
+typedef enum
+{
+    ALARM_OFF = 0,
+    ALARM_ON,
+}AlarmState_e;
+typedef struct
+{
+    AlarmLevel_e alarm_level;
+    octave_e octave;
+    float loudness;
+}Buzzer_config_s;
+
+typedef struct
+{
+    float loudness;
+    octave_e octave;
+    AlarmLevel_e alarm_level;
+    AlarmState_e alarm_state;
+}BuzzzerInstance;
+
+
+void BuzzerInit();
+void BuzzerTask();
+BuzzzerInstance *BuzzerRegister(Buzzer_config_s *config);
+void AlarmSetStatus(BuzzzerInstance *buzzer, AlarmState_e state);
+#endif // !BUZZER_H
@@ -0,0 +1,20 @@
+# buzzer
+
+用于拉响蜂鸣器警报
+
+## 使用范例
+
+```c
+Buzzer_config_s buzzer_config ={
+        .alarm_level = ALARM_LEVEL_HIGH, //设置警报等级 同一状态下 高等级的响应
+        .loudness=  0.4, //设置响度
+        .octave=  OCTAVE_1, // 设置音阶
+    };
+robocmd_alarm = BuzzerRegister(&buzzer_config);
+
+AlarmSetStatus(robocmd_alarm, ALARM_ON);
+AlarmSetStatus(robocmd_alarm, ALARM_OFF);
+
+```
+
+@todo: 将音阶改为可供选择的搭配 如 Do Re Mi Fa So La Si 自由组合 用户只需输入字符串"DoReMi"即可