Calculadora de ciclo de trabalho PWM

O período deve ser estritamente positivo: um período nulo dividiria por zero, então a API devolve um erro invalid_input claro em vez de inventar Infinity ou NaN. O caminho é aritmética determinística pura —sem rede, sem sementes aleatórias, sem dependência do relógio— de modo que o executor gratuito do navegador e a API pré-paga devolvem o mesmo JSON após o arredondamento decimal fixo sempre que você a chama.

O que ciclo de trabalho e tensão média significam para uma forma de onda PWM

Números de sala são fáceis: ton = 2 e T = 10 com V = 5 dão D = 0.2, vinte por cento de trabalho e um volt de média; ton = 5 e T = 10 com os mesmos cinco volts dão cinquenta por cento e dois ponto cinco volts. Professores e corretores automáticos cuidam da rejeição de período nulo tanto quanto da aritmética: um estudante que coloca T = 0 saiu do domínio da fórmula, e um fallback silencioso de valor absoluto esconderia esse erro. O caminho de checagem recalcula ton/T e D·V com o mesmo arredondamento fixo usado nos campos publicados, de modo que uma resposta bem-sucedida sempre traz passos que você pode afirmar em testes ou planilhas sem ambiguidade de ponto flutuante entre o Worker e o navegador.

Como chamar a API e o que volta

O tempo ligado deve ser não negativo; um intervalo alto negativo é rejeitado neste modelo PWM digital ideal. Prefira enviar números em vez de strings pré-formatadas quando controlar o cliente; strings numéricas só são aceitas quando batem com um padrão numérico finito estrito incluindo notação científica opcional. Envie um corpo JSON com três números finitos obrigatórios: on_time (alias ton, t_on, high_time, pulse_width e pw) para o intervalo alto, period (alias T, t_period, cycle_time e pwm_period) para o comprimento completo do ciclo na mesma unidade de tempo, e voltage (alias V, vcc, v_supply, amplitude e supply_voltage) para a amplitude de nível alto em volts. Os valores absolutos devem permanecer dentro do limite publicado de um trilhão para que quocientes e produtos intermediários sigam finitos em precisão dupla IEEE no Worker e no navegador. O período deve ser estritamente positivo; valores cuja magnitude absoluta é menor ou igual a 1e-15 são tratados como zero e rejeitados, e qualquer período estritamente negativo também é invalid_input. Em sucesso, a resposta ecoa on_time e ton arredondados, period e T, voltage e V, define duty, duty_cycle e duty_fraction na mesma fração adimensional, duty_percent em cem vezes D, average_voltage e Vavg em D·V em volts, off_time em period menos on_time, frequency em um sobre period, formula nas strings documentadas de D e Vavg, equation em uma linha de substituição legível, rótulos de unidade para fração, percentual e volts, message em um resumo breve, e steps em um arranjo ordenado de valores dados, fórmulas, trabalho, percentual, tempo desligado, frequência, tensão média e resumo. Validação falha —campos ausentes, strings não numéricas, números não finitos, valores fora de limites absolutos, período nulo ou negativo, tempo ligado negativo ou quociente não finito— devolve invalid_input e nunca é cobrada. O preço é um US$ 0,002 fixo por requisição bem-sucedida com unidade item e preço unitário marginal zero.

Dicas práticas, limites e buscas relacionadas

Mantenha on-time, period e voltage dentro da faixa absoluta publicada para que o quociente e o produto sigam finitos sob o teto de magnitude. Ao ensinar, emparelhe exemplos: ton = 2, T = 10, V = 5 dão vinte por cento e um volt de média; ton = 5, T = 10, V = 12 dão cinquenta por cento e seis volts; ton = 0 com T positivo dá trabalho nulo e média nula; e colocar period em zero demonstra o caminho duro de invalid_input. Tarefas falhas que devolvem invalid_input não consomem saldo pré-pago, o que mantém baratos scripts exploratórios quando aprendizes colocam de propósito period em zero. Checagens de ida e volta são fáceis: recalcule ton/T e multiplique por V à mão e confirme que duty e average_voltage publicados batem no mesmo arredondamento a doze casas, e confirme que escalar ton e T pelo mesmo fator positivo deixa D e Vavg inalterados como a fórmula prevê.