Raw-PWM-Steuerung
Was dieses Beispiel zeigt
Es setzt die rohen Ein- und Aus-Tick-Zahlen eines Kanals und verändert sie schrittweise über die Zeit. Das ist der grundlegende Baustein des Boards: Die Servo-Winkel-Hilfsfunktion auf der nächsten Seite berechnet die Tick-Zahlen für einen Winkel und ruft dann setPWM() auf.
Der Beispielcode
# 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)
Erwartetes Ergebnis:
Keine serielle Ausgabe. Das Tastverhältnis von Kanal 0 steigt in Schritten von 32 von 0 auf 4064, wobei jeder Durchlauf etwas mehr als 2,5 Sekunden dauert, und beginnt dann von vorn.
Verwendete Funktionen
PCA9685(i2c=None, address=PCA9685_DEFAULT_ADDRESS)returns NoneKonstruktor. Setzt die PWM-Standardfrequenz von 50 Hz, den Servo-Impulsbereich von 500 bis 2500 us und den Winkelbereich von 0 bis 180 Grad und lässt die LED-All-Call-Adresse aktiviert. Wenn Sie kein i2c-Objekt übergeben, prüft er den Namen des MicroPython-Ports (uname().sysname): Bei den Ports für ESP32 und ESP8266 öffnet er den I2C-Bus 0 mit SCL auf Pin 22 und SDA auf Pin 21, und bei Boards, die einen anderen Portnamen melden, löst er 'Board not recognized, enter I2C pins manually' aus. Die Pins 22 und 21 sind die Standardwerte des Moduls, keine Eigenschaft Ihres Boards: Wenn der Qwiic-Connector oder die I2C-Stiftleiste Ihres Boards andere Pins verwendet, erstellen Sie ein machine.I2C-Objekt mit diesen Pins und übergeben Sie es.
ReturnsKonstruktor; kein Rückgabewert.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
I2C | i2c | Initialisiertes machine.I2C-Objekt. Optional; ohne dieses werden bei den Ports für ESP32 und ESP8266 die Pins 22 (SCL) und 21 (SDA) verwendet. |
int | address | I2C-Adresse des Boards. Standardwert ist PCA9685_DEFAULT_ADDRESS (0x40). |
setPWMFreq(freq)returns boolSetzt die PWM-Frequenz, die für alle 16 Kanäle gilt. Wird auf den Bereich des Chips von 24-1526 Hz begrenzt.
ReturnsTrue bei Erfolg.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
float | freq | Gewünschte Frequenz in Hz, begrenzt auf 24-1526 Hz. |
setPWM(channel, on, off)returns boolSetzt die rohen Tick-Zahlen, bei denen der Ausgang eines Kanals innerhalb einer PWM-Periode (4096 Ticks) ein- und ausschaltet. Wird direkt für LEDs und allgemeine PWM verwendet; setServoAngle() auf der nächsten Seite ist eine Komfortfunktion um genau diesen Aufruf.
ReturnsTrue bei Erfolg, False, wenn channel außerhalb des gültigen Bereichs liegt.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
int | channel | Kanalnummer, 0 bis 15. |
int | on | Tick-Zahl (0-4095), bei der der Ausgang einschaltet. |
int | off | Tick-Zahl (0-4095), bei der der Ausgang ausschaltet. |
Zusammenfassung
Der Konstruktor setzt standardmäßig 50 Hz, doch dieses Beispiel erhöht den Wert sofort mit setPWMFreq() auf 1000 Hz. Das eignet sich für eine LED oder eine allgemeine PWM-Last besser als die 50 Hz, die Hobby-Servos erwarten. setPWM() legt dann beide Flanken des Impulses fest: Mit on fest auf 0 steuert allein off das Tastverhältnis. Wird off von 0 auf 4064 erhöht, geht der Ausgang also von vollständig aus bis fast vollständig an.
Um einen Kanal konstant zu halten, statt ihn schrittweise zu verändern, rufen Sie setPWM() einmal mit den gewünschten Tick-Werten auf und rufen es danach nicht mehr auf. Der PCA9685 erzeugt dieses Signal selbstständig weiter, bis Sie es ändern.