Calculateur de rapport cyclique PWM

La période doit être strictement positive : une période nulle diviserait par zéro, donc l’API renvoie une erreur invalid_input claire au lieu d’inventer Infinity ou NaN. Le chemin est une arithmétique déterministe pure — pas de réseau, pas de graines aléatoires, pas de dépendance à l’horloge — de sorte que l’exécuteur gratuit du navigateur et l’API prépayée renvoient le même JSON après l’arrondi décimal fixe à chaque appel.

Ce que rapport cyclique et tension moyenne signifient pour une forme d’onde PWM

Les nombres de cours sont simples : ton = 2 et T = 10 avec V = 5 donnent D = 0.2, vingt pour cent de duty et un volt de moyenne ; ton = 5 et T = 10 avec les mêmes cinq volts donnent cinquante pour cent et deux virgule cinq volts. Enseignants et correcteurs automatiques soignent le rejet de période nulle autant que l’arithmétique : un étudiant qui met T = 0 a quitté le domaine de la formule, et un repli silencieux en valeur absolue masquerait cette erreur. Le chemin de contrôle recalcule ton/T et D·V avec le même arrondi fixe utilisé pour les champs publiés, de sorte qu’une réponse réussie livre toujours des étapes que vous pouvez affirmer dans des tests ou des feuilles sans ambiguïté flottante entre le Worker et le navigateur.

Comment appeler l’API et ce qui revient

Le temps haut doit être non négatif ; un intervalle haut négatif est rejeté pour ce modèle PWM numérique idéal. Préférez envoyer des nombres plutôt que des chaînes préformatées lorsque vous contrôlez le client ; les chaînes numériques ne sont acceptées que si elles correspondent à un motif numérique fini strict incluant une notation scientifique optionnelle. Envoyez un corps JSON avec trois nombres finis obligatoires : on_time (alias ton, t_on, high_time, pulse_width et pw) pour l’intervalle haut, period (alias T, t_period, cycle_time et pwm_period) pour la longueur complète du cycle dans la même unité de temps, et voltage (alias V, vcc, v_supply, amplitude et supply_voltage) pour l’amplitude de niveau haut en volts. Les valeurs absolues doivent rester dans la limite publiée d’un billion pour que rapports et produits intermédiaires restent finis en double précision IEEE sur le Worker et dans le navigateur. La période doit être strictement positive ; les valeurs dont la magnitude absolue est inférieure ou égale à 1e-15 sont traitées comme zéro et rejetées, et toute période strictement négative est aussi invalid_input. En cas de succès, la réponse renvoie on_time et ton arrondis, period et T, voltage et V, fixe duty, duty_cycle et duty_fraction à la même fraction adimensionnelle, duty_percent à cent fois D, average_voltage et Vavg à D·V en volts, off_time à period moins on_time, frequency à un sur period, formula aux chaînes documentées de D et Vavg, equation à une ligne de substitution lisible, libellés d’unité pour fraction, pourcent et volts, message à un court résumé, et steps à un tableau ordonné de valeurs données, formules, duty, pourcent, temps bas, fréquence, tension moyenne et résumé. Une validation échouée — champs manquants, chaînes non numériques, nombres non finis, valeurs hors limites absolues, période nulle ou négative, temps haut négatif ou rapport non fini — renvoie invalid_input et n’est jamais facturée. Le tarif est un $0.002 forfaitaire par requête réussie avec unité item et prix unitaire marginal zéro.

Conseils pratiques, limites et recherches associées

Gardez on-time, period et voltage dans la plage absolue publiée pour que le rapport et le produit restent finis sous le plafond de magnitude. En enseignement, couplez des exemples : ton = 2, T = 10, V = 5 donnent vingt pour cent et un volt de moyenne ; ton = 5, T = 10, V = 12 donnent cinquante pour cent et six volts ; ton = 0 avec T positif donne duty nul et moyenne nulle ; et mettre period à zéro démontre le chemin dur invalid_input. Les tâches échouées qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui maintient les scripts exploratoires bon marché lorsque les apprenants mettent volontairement period à zéro. Les contrôles aller-retour sont faciles : recalculez ton/T et multipliez par V à la main et confirmez que duty et average_voltage publiés correspondent dans le même arrondi à douze décimales, et confirmez que mettre ton et T à l’échelle par le même facteur positif laisse D et Vavg inchangés comme la formule le prédit.