Neobrađeno PWM upravljanje
Što prikazuje ovaj primjer
Postavljanje neobrađenih brojeva otkucaja za uključenje i isključenje kanala te njihovo postupno mijenjanje tijekom vremena. Ovo je osnovni građevni blok pločice: pomoćna funkcija za kut servomotora na sljedećoj stranici izračunava brojeve otkucaja za zadani kut, a zatim poziva setPWM().
Primjer koda
# FILE: pca9685-basicPWM.py
# AUTHOR: Fran Fodor @ Soldered
# BRIEF: Ramp raw PWM duty cycle on channel 0 of the PCA9685
# LAST UPDATED: 2026-07-24
from pca9685 import PCA9685
from utime import sleep_ms
pwm = PCA9685()
pwm.setPWMFreq(1000) # fast PWM for LEDs/general outputs, not servos
while True:
for duty in range(0, 4096, 32):
pwm.setPWM(0, 0, duty)
sleep_ms(20)
Očekivani rezultat:
Nema izlaza na serijskom ispisu. Faktor vođenja kanala 0 raste od 0 do 4064 u koracima od 32, pri čemu jedan prolaz traje nešto više od 2,5 sekunde, a zatim se ponavlja.
Korištene funkcije
PCA9685(i2c=None, address=PCA9685_DEFAULT_ADDRESS)returns NoneKonstruktor. Postavlja zadanu PWM frekvenciju od 50 Hz, raspon impulsa servomotora od 500 do 2500 us i raspon kuta od 0 do 180 stupnjeva te ostavlja uključenom adresu LED All Call. Ako ne proslijedite objekt i2c, provjerava naziv MicroPython porta (uname().sysname): na ESP32 i ESP8266 portovima otvara I2C sabirnicu 0 s SCL na pinu 22 i SDA na pinu 21, a na pločicama koje javljaju drugi naziv porta baca grešku 'Board not recognized, enter I2C pins manually'. Pinovi 22 i 21 zadani su u modulu, a ne svojstvo vaše pločice: ako Qwiic konektor ili I2C header vaše pločice koristi druge pinove, stvorite objekt machine.I2C na tim pinovima i proslijedite ga.
ReturnsKonstruktor; nema povratne vrijednosti.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
I2C | i2c | Inicijalizirani objekt machine.I2C. Neobavezan; ako se izostavi, koriste se pinovi 22 (SCL) i 21 (SDA) na ESP32 i ESP8266 portovima. |
int | address | I2C adresa pločice. Zadano je PCA9685_DEFAULT_ADDRESS (0x40). |
setPWMFreq(freq)returns boolPostavlja PWM frekvenciju zajedničku za svih 16 kanala. Ograničena je na raspon čipa od 24-1526 Hz.
ReturnsTrue ako je uspjelo.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
float | freq | Željena frekvencija u Hz, ograničena na raspon 24-1526 Hz. |
setPWM(channel, on, off)returns boolPostavlja neobrađene brojeve otkucaja pri kojima se izlaz kanala uključuje i isključuje unutar jednog PWM razdoblja (4096 otkucaja). Koristi se izravno za LED diode i opći PWM; setServoAngle() na sljedećoj stranici prikladan je omotač oko istog poziva.
ReturnsTrue ako je uspjelo, False ako je channel izvan raspona.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
int | channel | Broj kanala, od 0 do 15. |
int | on | Broj otkucaja (0-4095) pri kojem se izlaz uključuje. |
int | off | Broj otkucaja (0-4095) pri kojem se izlaz isključuje. |
Sve zajedno
Konstruktor postavlja zadanu frekvenciju od 50 Hz, ali ovaj primjer je odmah podiže na 1000 Hz pomoću setPWMFreq(), što bolje odgovara LED diodi ili općem PWM opterećenju nego 50 Hz koje očekuju hobi servomotori. setPWM() zatim određuje oba brida impulsa:
s on fiksiranim na 0 faktor vođenja određuje samo off, pa povećavanje
off od 0 do 4064 povećava izlaz od potpuno isključenog do gotovo potpuno uključenog.
Da biste kanal držali stalnim umjesto da ga mijenjate, jednom pozovite setPWM() s
željenim vrijednostima otkucaja i više ga ne pozivajte; PCA9685 sam nastavlja generirati
taj signal dok ga ne promijenite.