2. パルス幅変調¶

パルス幅変調(PWM)は、デジタルピンから人工的なアナログ出力を得るための方法です。これは、ピンをローからハイに素早く切り替えることで実現しますこれには２つのパラメータがあります。切り替えの周波数とデューティ比です。デューティ比は、1周期(ロー + ハイの時間)の長さに比べて、ピンがハイになっている時間の長さと定義されています。デューティ比の最大値は、ピンが常にハイである場合であり、最小値はピンが常にローである場合です。

16個のPWMチャンネルと8個のタイマーを使った、より包括的な例を示します:

from machine import Pin, PWM
try:
    f = 100  # Hz
    d = 1024 // 16  # 6.25%
    pins = (15, 2, 4, 16, 18, 19, 22, 23, 25, 26, 27, 14 , 12, 13, 32, 33)
    pwms = []
    for i, pin in enumerate(pins):
        pwms.append(PWM(Pin(pin), freq=f * (i // 2 + 1), duty= 1023 if i==15 else d * (i + 1)))
        print(pwms[i])
finally:
    for pwm in pwms:
        try:
            pwm.deinit()
        except:
            pass

以下のような出力が得られます:

PWM(Pin(15), freq=100, duty=64, resolution=10, mode=0, channel=0, timer=0)
PWM(Pin(2), freq=100, duty=128, resolution=10, mode=0, channel=1, timer=0)
PWM(Pin(4), freq=200, duty=192, resolution=10, mode=0, channel=2, timer=1)
PWM(Pin(16), freq=200, duty=256, resolution=10, mode=0, channel=3, timer=1)
PWM(Pin(18), freq=300, duty=320, resolution=10, mode=0, channel=4, timer=2)
PWM(Pin(19), freq=300, duty=384, resolution=10, mode=0, channel=5, timer=2)
PWM(Pin(22), freq=400, duty=448, resolution=10, mode=0, channel=6, timer=3)
PWM(Pin(23), freq=400, duty=512, resolution=10, mode=0, channel=7, timer=3)
PWM(Pin(25), freq=500, duty=576, resolution=10, mode=1, channel=0, timer=0)
PWM(Pin(26), freq=500, duty=640, resolution=10, mode=1, channel=1, timer=0)
PWM(Pin(27), freq=600, duty=704, resolution=10, mode=1, channel=2, timer=1)
PWM(Pin(14), freq=600, duty=768, resolution=10, mode=1, channel=3, timer=1)
PWM(Pin(12), freq=700, duty=832, resolution=10, mode=1, channel=4, timer=2)
PWM(Pin(13), freq=700, duty=896, resolution=10, mode=1, channel=5, timer=2)
PWM(Pin(32), freq=800, duty=960, resolution=10, mode=1, channel=6, timer=3)
PWM(Pin(33), freq=800, duty=1023, resolution=10, mode=1, channel=7, timer=3)

スムーズな周波数変更の例:

from utime import sleep
from machine import Pin, PWM

F_MIN = 500
F_MAX = 1000

f = F_MIN
delta_f = 1

p = PWM(Pin(5), f)
print(p)

while True:
    p.freq(f)

    sleep(10 / F_MIN)

    f += delta_f
    if f >= F_MAX or f <= F_MIN:
        delta_f = -delta_f

オシロスコープで Pin(5) の PWM 波形を見てみてください。

スムーズなデューティ変更の例:

from utime import sleep
from machine import Pin, PWM

DUTY_MAX = 2**16 - 1

duty_u16 = 0
delta_d = 16

p = PWM(Pin(5), 1000, duty_u16=duty_u16)
print(p)

while True:
    p.duty_u16(duty_u16)

    sleep(1 / 1000)

    duty_u16 += delta_d
    if duty_u16 >= DUTY_MAX:
        duty_u16 = DUTY_MAX
        delta_d = -delta_d
    elif duty_u16 <= 0:
        duty_u16 = 0
        delta_d = -delta_d

オシロスコープで Pin(5) の PWM 波形を見てみてください。

注記: Pin.OUT モードを指定する必要はありません。チャネルは、PWM コンストラクターに渡されるピンごとに1回、内部的に PWM モードに初期化されます。

次のコードは間違いです:

pwm = PWM(Pin(5, Pin.OUT), freq=1000, duty=512)  # ここで Pin(5) が PWM モードなるが...
pwm = PWM(Pin(5, Pin.OUT), freq=500, duty=256)  # ここで Pin(5) が OUT モードになり、PWM が無効になる

代わりに次のコードのようにしてください:

pwm = PWM(Pin(5), freq=1000, duty=512)
pwm.init(freq=500, duty=256)