Skip to main content

Servo sweep

Što ovaj primjer prikazuje​

Upravljanje hobi servomotorom pomoću kuta umjesto sirovih tikova te njegovo pomicanje amo-tamo kroz konfigurirani raspon. Ovo je glavna oglašavana namjena pločice.

Kôd primjera​

# 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)

Prije pokretanja priključite servomotor na CH1 header, a to je kanal 0 u kodu: njegovu signalnu žicu na OUT, žicu napajanja na V+ i žicu mase na GND. Zatim na V+ i GND vijčane stezaljke spojite napajanje prikladno za vaš servomotor, jer Qwiic kabel ne prenosi napajanje za servomotor. Detalji o hardveru prikazuju priključke napajanja servomotora.

Očekivani rezultat:

Nema ispisa na serijskom sučelju. Hobi servomotor spojen na kanal 0 giba se od 0 do 180 stupnjeva i natrag, pri čemu svaki smjer traje nešto manje od 3 sekunde, a zatim se ponavlja.

Korištene funkcije​

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

Konstruktor. Postavlja zadanu PWM frekvenciju od 50 Hz, koju hobi servomotori očekuju, raspon impulsa od 500 do 2500 us i raspon kuta od 0 do 180 stupnjeva. Ako ne proslijedite objekt i2c, provjerava naziv MicroPython porta (uname().sysname): na ESP32 i ESP8266 portovima otvara I2C sabirnicu 0 sa SCL na pinu 22 i SDA na pinu 21, a na pločicama koje prijave drugi naziv porta javlja pogrešku 'Board not recognized, enter I2C pins manually'. Pinovi 22 i 21 zadani su u modulu, a nisu 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

TipNazivOpis
I2Ci2cInicijalizirani objekt machine.I2C. Neobavezno; bez njega se koriste pinovi 22 (SCL) i 21 (SDA) na ESP32 i ESP8266 portovima.
intaddressI2C adresa pločice. Zadano je PCA9685_DEFAULT_ADDRESS (0x40).
setServoPulseRange(minPulseUs, maxPulseUs)returns None

Konfigurira širinu impulsa, u mikrosekundama, koju setServoAngle() pridružuje minimalnom i maksimalnom kutu. Uskladite je s tehničkim listom svog servomotora ako zadanom vrijednošću iz biblioteke ne postiže puni mehanički raspon.

ReturnsNišta.

Parametri

TipNazivOpis
intminPulseUsŠirina impulsa u mikrosekundama koja odgovara minimalnom kutu. Zadano u biblioteci: 500 us.
intmaxPulseUsŠirina impulsa u mikrosekundama koja odgovara maksimalnom kutu. Zadano u biblioteci: 2500 us.
setServoAngleRange(minAngle, maxAngle)returns None

Konfigurira raspon kuta, u stupnjevima, koji prihvaća setServoAngle().

ReturnsNišta.

Parametri

TipNazivOpis
floatminAngleKut u stupnjevima koji odgovara vrijednosti minPulseUs. Zadano u biblioteci: 0.
floatmaxAngleKut u stupnjevima koji odgovara vrijednosti maxPulseUs. Zadano u biblioteci: 180.
setServoAngle(channel, angle)returns bool

Postavlja hobi servomotor na zadanom kanalu na određeni kut, ograničen na konfigurirani raspon kuta. Interno pretvara kut u širinu impulsa i umjesto vas poziva setPWM(). Pretpostavlja zadanu frekvenciju od 50 Hz koju postavlja konstruktor.

ReturnsTrue ako uspije, False ako je channel izvan raspona.

Parametri

TipNazivOpis
intchannelBroj kanala, od 0 do 15.
floatangleKut u stupnjevima, ograničen na raspon postavljen funkcijom setServoAngleRange().

Sve zajedno​

setServoPulseRange() i setServoAngleRange() su jednokratni pozivi za postavljanje: pokrenite ih jednom, prije prvog setServoAngle(). Nakon toga setServoAngle() izračunava širinu impulsa iz kuta i poziva setPWM() umjesto vas, tako da broj tikova za servomotor nikada ne morate računati ručno.

Ovaj primjer koristi zadanu frekvenciju konstruktora od 50 Hz, a to je frekvencija koju hobi servomotori očekuju. PWM frekvencija zajednička je svih 16 kanala: setPWMFreq() ne prima kanal, pa poziv učinjen za LED diodu mijenja i svih 16 izlaza, uključujući signal servomotora. Dok pločica upravlja servomotorima, ostavite je na 50 Hz.