Calculadora de ciclo de trabalho

Digite pulse_width e period na mesma unidade de tempo; a ferramenta devolve o ciclo de trabalho em percentual junto com a fração adimensional, o tempo desligado complementar e a frequência recíproca. O período deve ser estritamente positivo: um período nulo dividiria por zero, então a API devolve invalid_input em vez de Infinity. A largura de pulso não deve superar o período: um pulso largo demais fica fora de um único ciclo, e este endpoint falha em vez de informar em silêncio mais de cem por cento. O caminho é aritmética determinística pura — sem rede, sem sementes aleatórias, sem relógio de parede —, de modo que o executor gratuito do navegador e a API pré-paga coincidem após o arredondamento fixo sempre que você a chama. Chamadas API bem-sucedidas usam o preço-base publicado US$ 0,002; entrada inválida não é cobrada.

O que o ciclo de trabalho significa e como o percentual é definido

A largura de pulso deve ser não negativa e não superar o período: um pulso mais longo que um ciclo não pode ser expresso como trabalho dentro desse ciclo, e esta calculadora rejeita esse caso com invalid_input em vez de inventar um percentual acima de cem.

Como chamar a API e o que volta

A largura de pulso deve ser não negativa e não maior que o período; um pulso largo demais falha com uma mensagem de que a largura de pulso supera o período. Campos ausentes, strings vazias, tokens não numéricos, NaN e infinitos falham nomeando o campo. Envie um corpo JSON com dois números finitos obrigatórios: pulse_width (alias pw, t_pulse, width, ton, t_on, high_time e pulse) para o intervalo ativo, e period (alias T, t_period, cycle_time e t) para o comprimento completo do ciclo na mesma unidade de tempo. Os valores absolutos devem permanecer dentro do limite publicado de um trilhão para que razões intermediárias sigam finitas 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 pulse_width e period arredondados, define duty_cycle e duty_percent no mesmo valor percentual, duty_fraction na razão adimensional, off_time em period menos pulse_width, frequency em um sobre period, formula na string documentada de percentual, equation em uma linha de substituição legível, unit no sinal de por cento, message em um resumo breve em inglês da implementação, e steps em um arranjo ordenado de valores dados, fórmula, fração, percentual, tempo desligado, frequência e resumo. Validação falha devolve invalid_input e nunca é cobrada. O preço é um US$ 0,002 fixo por requisição bem-sucedida com unidade item. Prefira enviar números JSON 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. Emparelhe a resposta com o seu próprio gráfico se precisar de um esboço da onda quadrada; este endpoint calcula o trabalho escalar e não emite imagens de osciloscópio nem bitfields de registradores de timer.

Dicas práticas, limites e buscas relacionadas

Ao ensinar, emparelhe exemplos: largura de pulso dois e período dez dão vinte por cento; largura de pulso cinco e período oito dão sessenta e dois ponto cinco por cento; largura de pulso igual ao período dá cem por cento; largura de pulso zero com período positivo dá zero por cento; colocar o período em zero demonstra o caminho duro de invalid_input; e um pulso de doze com período dez demonstra a rejeição por excesso de largura que distingue esta página de auxiliares PWM que permitem trabalho acima de cem por cento. 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 o período em zero. Checagens de ida e volta são fáceis: recálcule a largura de pulso dividida pelo período vezes cem à mão e confirme que o duty_cycle publicado bate no mesmo arredondamento a doze casas, e confirme que escalar ambas as durações pelo mesmo fator positivo deixa o percentual inalterado como a fórmula prevê.