dclause/hermes-five

Add support for passive buzzers with note/melody playback

Aberta

#25 aberto em 15 de jun. de 2025

Ver no GitHub
 (0 comentário) (0 reação) (0 responsável)Rust (1 fork)auto 404
feature requestgood first issue

Métricas do repositório

Stars
 (37 estrelas)
Métricas de merge de PR
 (Métricas PR pendentes)

Description

Motivation: Passive buzzers are commonly used for generating tones, beeps, or simple melodies in embedded systems. Supporting them would allow users to easily play musical notes or sound alerts using standard GPIO/PWM outputs.

Proposal: Introduce a passive buzzer (named Buzzer or Tone ?) component capable of:

  • Playing individual notes with configurable frequency and duration
  • Playing melodies based on a standard format (e.g., Robson Couto’s melody format)

Format Consideration: Robson Couto’s format (e.g., "NOTE_E5,8, NOTE_D5,8, NOTE_C5,4") is simple and Arduino-compatible. Alternative formats (e.g., RTTTL or Music Macro Language) can be evaluated for future extensibility.

Scope:

  • Buzzer abstraction over GPIO or PWM
  • Basic melody parser/interpreter
  • Non-blocking (task) playback support

Impact: Adds a new component. No impact on existing APIs.

Future Extensions:

  • Support for RTTTL or external melody files ?
  • Dynamic tempo changes ?

Guia do colaborador

Direção de pesquisa
Estude a estrutura de componentes existentes no repositório, focando em como GPIO/PWM é abstraído. Procure por componentes semelhantes, como LEDs ou motores, para entender os padrões. Em seguida, projete um componente Buzzer que possa gerar tons via PWM e implemente um parser de melodias para o formato de Robson Couto. Garanta a reprodução não bloqueante usando async/await ou um loop de tarefas.
Pilha de tecnologia
rust
Domain
embedded iot
Tipo Issue
Funcionalidade
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
3
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-2 dias
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Recente
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
RustGPIO
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
35