new release

components/buzzer/include/buzzer.h

@@ -3,8 +3,7 @@
 
 #include <stdint.h>
 #include <stdbool.h>
-#include "esp_err.h"
-#include "buzzer_events.h"   // para buzzer_pattern_id_t
+#include "buzzer_events.h"   // buzzer_pattern_id_t
 
 #ifdef __cplusplus
 extern "C" {
@@ -33,7 +32,7 @@ void buzzer_stop(void);
 
 /**
  * @brief Ativa/Desativa globalmente o buzzer (mute).
- *        Quando desativado, não toca e garante nível/desligado.
+ *        Quando desativado, não toca e garante desligado.
  */
 void buzzer_set_enabled(bool enabled);
 
@@ -52,9 +51,10 @@ void buzzer_set_quiet_hours(bool enabled, uint16_t start_min, uint16_t end_min);
 
 /**
  * @brief Ajusta a frequência PWM (somente PASSIVE/LEDC; timer exclusivo recomendado).
- * @return ESP_OK em sucesso; erro se modo inválido ou argumento fora do range.
+ * @param hz Frequência desejada.
+ * @return Frequência efetiva configurada (Hz). 0 em erro (modo inválido ou argumento fora do range).
  */
-esp_err_t buzzer_set_frequency(uint32_t hz);
+uint32_t buzzer_set_frequency(uint32_t hz);
 
 /**
  * @brief Define o duty cycle em porcentagem (0..100) para PASSIVE/LEDC.
@@ -63,4 +63,4 @@ void buzzer_set_duty_percent(uint8_t pct);
 
 #ifdef __cplusplus
 }
-#endif
+#endif