ky 040 Monitor Serial

O KY-040 Serial Monitor analisa a atividade do codificador convertendo transições quadratura A/B em passos discretos e movimento direcional. É voltado para desenvolvedores de eletrônica, engenheiros de firmware e entusiastas que integram encoders KY-040 com microcontroladores (Arduino, ESP32) e precisam de dados verificados de contagem de pulsos e timing.
Modela o codificador como uma máquina de estados de quadratura. Funcionalidades obrigatórias incluem aceitar logs de transições A/B ou contagens de bordas, calcular total_steps, direção e velocidade, e suportar pulses_per_rev configuráveis. Funcionalidades opcionais incluem entrada via streaming temporal, limiares de debounce ajustáveis e uma métrica de erro (error_count).
As entradas incluem sequências de transições A/B ou contagens de bordas, tempo decorrido em ms e pulses_per_rev (padrão 1). As saídas fornecem total_steps (inteiro), direção (1/-1), velocidade (passos/segundo), rpm (se o tempo for fornecido) e error_count. Todos os valores validam entradas numéricas não negativas e tempos finitos; as saídas seguem formatação numérica padrão.
Usa uma máquina de estados de quadratura com transições 00→01→11→10→00 para derivar a direção. Passos são acumulados em transições válidas; velocidade = total_steps / (tempo decorrido em segundos). rpm = velocidade × 60 / pulses_per_rev. Debounce reduz glitches; transições inválidas aumentam error_count mas não alteram o contador de passos.
Se entradas estiverem ausentes, aplicam-se valores padrão (contagens zero). Tempos muito curtos produzem velocidade alta e possivelmente ruidosa; se o tempo for zero ou negativo, os resultados são zero e o erro aumenta. Lacunas de dados geram NaN, a menos que limitadas; fontes externas podem exigir normalização.
Unidades SI (ms/s) com contagens por revolução; sem restrições de moeda ou região; adequado para contextos de hardware internacionais.
Assume sinais de um encoder KY-040 compatível; exclui instruções de cabeamento, geração de código de firmware e considerações de UI; não destinado a encoders analógicos ou sensores não quadratura.