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 NoneKonstruktor. 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
| Typ | Name | Beschreibung |
|---|---|---|
I2C | i2c | Initialisiertes machine.I2C-Objekt. Optional; ohne dieses werden bei den ESP32- und ESP8266-Ports die Pins 22 (SCL) und 21 (SDA) verwendet. |
int | address | I2C-Adresse des Boards. Standardwert ist PCA9685_DEFAULT_ADDRESS (0x40). |
setServoPulseRange(minPulseUs, maxPulseUs)returns NoneKonfiguriert 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
| Typ | Name | Beschreibung |
|---|---|---|
int | minPulseUs | Pulsbreite in Mikrosekunden, die dem minimalen Winkel zugeordnet wird. Bibliotheksstandard: 500 us. |
int | maxPulseUs | Pulsbreite in Mikrosekunden, die dem maximalen Winkel zugeordnet wird. Bibliotheksstandard: 2500 us. |
setServoAngleRange(minAngle, maxAngle)returns NoneKonfiguriert den Winkelbereich in Grad, den setServoAngle() akzeptiert.
ReturnsNichts.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
float | minAngle | Winkel in Grad, der minPulseUs zugeordnet wird. Bibliotheksstandard: 0. |
float | maxAngle | Winkel in Grad, der maxPulseUs zugeordnet wird. Bibliotheksstandard: 180. |
setServoAngle(channel, angle)returns boolFä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
| Typ | Name | Beschreibung |
|---|---|---|
int | channel | Kanalnummer, 0 bis 15. |
float | angle | Winkel 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.