Zum Hauptinhalt springen

Servo-Sweep

Was dieses Beispiel zeigt​

Ansteuerung eines Hobby-Servos per Winkel statt mit rohen Ticks und Hin- und Herfahren über den konfigurierten Bereich. Das ist der Hauptanwendungsfall des Boards.

Der Beispielcode​

# FILE: pca9685-servoSweep.py
# AUTHOR: Fran Fodor @ Soldered
# BRIEF: Sweep a hobby servo on channel 0 back and forth using PCA9685
# LAST UPDATED: 2026-07-24

from pca9685 import PCA9685
from utime import sleep_ms

pwm = PCA9685() # sets 50Hz PWM frequency by default, suitable for hobby servos

# Adjust to match your servo's datasheet if it doesn't reach full range
pwm.setServoPulseRange(500, 2500) # microseconds
pwm.setServoAngleRange(0, 180) # degrees

while True:
for angle in range(0, 181):
pwm.setServoAngle(0, angle)
sleep_ms(15)

for angle in range(180, -1, -1):
pwm.setServoAngle(0, angle)
sleep_ms(15)

Stecken Sie den Servo vor dem Ausführen in den CH1-Header, der im Code Kanal 0 entspricht: das Signalkabel an OUT, das Stromkabel an V+ und das Massekabel an GND. Schließen Sie dann eine zu Ihrem Servo passende Spannungsversorgung an V+ und GND der Schraubklemme an, weil das Qwiic-Kabel keine Servo-Versorgung führt. Hardware- Details zeigt die Anschlüsse der Servo-Versorgung.

Erwartetes Ergebnis:

Keine serielle Ausgabe. Ein an Kanal 0 angeschlossener Hobby-Servo fährt von 0 bis 180 Grad und zurück, wobei jede Richtung knapp unter 3 Sekunden dauert, und wiederholt dies dann.

Verwendete Funktionen​

PCA9685(i2c=None, address=PCA9685_DEFAULT_ADDRESS)returns None

Konstruktor. Setzt die Standard-PWM-Frequenz von 50 Hz, die Hobby-Servos erwarten, den Pulsbereich von 500 bis 2500 us und den Winkelbereich von 0 bis 180 Grad. Wenn Sie kein i2c-Objekt übergeben, prüft er den MicroPython-Port-Namen (uname().sysname): Bei den ESP32- und ESP8266-Ports öffnet er I2C-Bus 0 mit SCL an Pin 22 und SDA an Pin 21, und bei Boards, die einen anderen Port-Namen melden, löst er 'Board not recognized, enter I2C pins manually' aus. Die Pins 22 und 21 sind der Standard des Moduls, keine Eigenschaft Ihres Boards: Wenn der Qwiic-Connector oder der I2C-Header Ihres Boards andere Pins verwendet, erstellen Sie ein machine.I2C-Objekt mit diesen Pins und übergeben Sie es.

ReturnsKonstruktor; kein Rückgabewert.

Parameter

TypNameBeschreibung
I2Ci2cInitialisiertes machine.I2C-Objekt. Optional; ohne dieses werden bei den ESP32- und ESP8266-Ports die Pins 22 (SCL) und 21 (SDA) verwendet.
intaddressI2C-Adresse des Boards. Standardwert ist PCA9685_DEFAULT_ADDRESS (0x40).
setServoPulseRange(minPulseUs, maxPulseUs)returns None

Konfiguriert die Pulsbreite in Mikrosekunden, die setServoAngle() dem minimalen und dem maximalen Winkel zuordnet. Passen Sie sie an das Datenblatt Ihres Servos an, wenn er mit dem Bibliotheksstandard seinen vollen mechanischen Bereich nicht erreicht.

ReturnsNichts.

Parameter

TypNameBeschreibung
intminPulseUsPulsbreite in Mikrosekunden, die dem minimalen Winkel zugeordnet wird. Bibliotheksstandard: 500 us.
intmaxPulseUsPulsbreite in Mikrosekunden, die dem maximalen Winkel zugeordnet wird. Bibliotheksstandard: 2500 us.
setServoAngleRange(minAngle, maxAngle)returns None

Konfiguriert den Winkelbereich in Grad, den setServoAngle() akzeptiert.

ReturnsNichts.

Parameter

TypNameBeschreibung
floatminAngleWinkel in Grad, der minPulseUs zugeordnet wird. Bibliotheksstandard: 0.
floatmaxAngleWinkel in Grad, der maxPulseUs zugeordnet wird. Bibliotheksstandard: 180.
setServoAngle(channel, angle)returns bool

Fährt einen Hobby-Servo am angegebenen Kanal auf einen Winkel, begrenzt auf den konfigurierten Winkelbereich. Rechnet den Winkel intern in eine Pulsbreite um und ruft setPWM() für Sie auf. Setzt die vom Konstruktor eingestellte Standardfrequenz von 50 Hz voraus.

ReturnsTrue bei Erfolg, False, wenn channel außerhalb des gültigen Bereichs liegt.

Parameter

TypNameBeschreibung
intchannelKanalnummer, 0 bis 15.
floatangleWinkel in Grad, begrenzt auf den mit setServoAngleRange() festgelegten Bereich.

Alles zusammen​

setServoPulseRange() und setServoAngleRange() sind einmalige Einrichtungsaufrufe: Führen Sie sie einmal aus, vor dem ersten setServoAngle(). Danach übernimmt setServoAngle() die Umrechnung von Winkel in Pulsbreite und ruft setPWM() für Sie auf, sodass Sie für einen Servo nie Tick-Werte von Hand berechnen müssen.

Dieses Beispiel nutzt die Standardfrequenz des Konstruktors von 50 Hz, die Hobby-Servos erwarten. Die PWM-Frequenz gilt gemeinsam für alle 16 Kanäle: setPWMFreq() nimmt keinen Kanal entgegen, daher ändert ein Aufruf für eine LED auch alle 16 Ausgänge, einschließlich des Servo-Signals. Lassen Sie das Board auf 50 Hz, solange es Servos ansteuert.