Voir la source de P2E-PWM-Output-FR

== Introduction ==
Le signal PWM est un signal particulier permettant de moduler la puissance de sortie en activant/désactivant régulièrement la broche de sorte que cela permet de moduler la puissance moyenne de sortie.

{{ambox|text=PWM est parfois abusivement appelé "''Sortie Analogique''" mais ne vous y trompez pas, PWM n'est pas une vraie sortie analogique (comme l'est un DAC).}}

Si les alternances allumé/éteint se produisent très rapidement alors ces alternances seront à peine notables (d'un point de vue humain). Il est courant d'utiliser '''une fréquence''' d'alternance de 50 Hertz à 500 Hertz ou plus. A 500 Hertz, le signal change 500 fois par secondes... ou disons qu'il se répète tous les 1/500ième de seconde (donc une période de 2 millisecondes).

Ensuite, l'utilisation d'un signal carré n'implique pas forcement un signal avec 50% d'état HAUT et 50% d'état BAS. Il est tout à fait possible d'envisager 10% d'état HAUT + 90% d'état BAS ou encore 70% d'état HAUT + 30% d'état BAS! Ce qui vient d'être décrit n'est rien d'autre que le '''cycle utile''' (''Duty Cycle'' en anglais) et c'est ce qui permet de moduler la puissance de sortie.

L'image ci-dessous présente un signal PWM avec cycle utile de 25% (1/4 de la période) ainsi que la tension moyenne ''Vavg'' correspondante.

[[Fichier:ENG-CANSAT-FEATHER-PICO-pwm-01.png]]

The average voltage (average power) of PWM signal depend on the duty cycle: Vavg = 3.3V * Th / T

[[Fichier:ENG-CANSAT-FEATHER-PICO-pwm-02.png|800px]]

Obviously, a 0% duty cyle is equivalent to a LOW signal whereas a 100% duty cycle is a HIGH signal. 

In the following example, we will use PWM to dim the light on the onbloard LED.

The onboard LED is tied to the GPIO 25 (and PWM will work there as with other GPIOs).

Thank to PWM we can effectively control the LED luminosity (very low duty cycle will dim the light while highest duty cycle will make it brightest).

== Cas pratique ==

La luminosité d'une LED dépend du courant qui la traverse. En modifiant la résistance, il est possible d'altérer sensiblement la luminosité de la LED mais impossible de contrôler la luminosité de 0 à 100%.

Par contre, en utilisant un signal PWM, il est possible d'altérer la luminosité d'une LED de 0 à 100% en modifiant le cycle utile de 0 à 100%. De la sorte, cette LED sera allumée d'une fraction du temps, plus ou moins longue, en fonction du pourcentage de cycle utile. La rémanence de l'oeil effectuera une sorte de moyenne du flux lumineux. En effet, avec une fréquence PWM de 500 Hz, l'oeil n'a absolument pas l'occasion de se rendre compte que, dans les faits, cette LED clignote!

L'exemple ci-dessous se propose de tester la génération d'un signal PWM pour contrôler la luminosité d'une LED.

=== Branchement simplifié ===

Dans cet exemple, nous allons brancher un potentiomètre sur l'entrée analogique A0 (GP26) pour contrôler la luminosité d'une LED branchée sur GP2 avec un signal PWM.

Si vous n'êtes pas encore familiarisé avec l'utilisation des entrées analogiques alors vous pouvez consulter [[P2E-Analog-Input-FR|le tutoriel sur les entrées analogiques]].

[[Fichier:P2E-PWM-LED.png|800px]]

=== Code ===

Le code ci-dessous peut être saisi dans une session REPL ou dans Thonny IDE.

Cet exemple est également disponible dans le dépôt [https://github.com/mchobby/pico-2-explorer/tree/main/pwm-led pwm-led.py] .

<syntaxhighlight lang="python" line highlight="1,8,9,12">
from machine import Pin, ADC, PWM
import time

# Désactive PowerSafe (lower ripple)
Pin( 23, Pin.OUT, value=True )

a0 = ADC( Pin( Pin.board.GP26 ) )
led = PWM( Pin( Pin.board.GP2 ) )
led.freq( 500 )
while True:
    val = a0.read_u16()
    led.duty_u16( val )
    print( 'adc=duty_u16= %5i' % (val) )
    time.sleep_ms( 100 )
</syntaxhighlight>

Il ne reste plus qu'à tourner le potentiomètre pour modifier la luminosité de la LED.

Voici quelques explications:
* '''Ligne 1''': import de la classe {{fname|PWM}} permettant de contrôler une broche en modulation de largeur d'impulsion.
* '''Ligne 8''': création de led, instance de la classe {{fname|PWM}} permettant de contrôler la broche GP2 avec un signal PWM.
* '''Ligne 9''': Fixer la fréquence du signal PWM à 500 Hz (comme Arduino). Le signal se répète donc 500 fois par seconde.
* '''Lignes 10 à 14''': boucle infinie faisant l'acquisition de la valeur sur le convertisseur ADC puis fixant le cycle utile du signal PWM.
* '''Ligne 11''': acquisition de la valeur du convertisseur. Retourne un entier 16 bits entre 0 et 65535.
* '''Ligne 12''': fixe le cycle utile à partir d'un entier 16 bits (0..65535 => pour cycle utile de de 0 à 100%).

=== Un problème? ===
ddd

== Le défi ==
xxx

== Encore plus ==
xxx

== Truc et astuce ==
zzz