Belajar

Raspberry Pi GPIO dengan Python, tanpa Pi di mejamu

Pemula

Atau lihat semua pelajaran.

  • 526komponen di meja kerja
  • 46board sedang berjalan
  • 1.00xwaktu nyata, di semua board
Raspberry Pi 4: gpiozero mengedipkan LED di GPIO17live0.000 s 0.00x
Klik untuk membukanya di editor
Tekan Jalankan. gpiozero menyalakan dan mematikan GPIO17 sekali per detik, dan print() menampilkan setiap perubahannya.

Mokxi has the Raspberry Pi 4 Model B, the Raspberry Pi 5 and the Raspberry Pi Zero 2 W on its canvas. Put one down, write main.py with gpiozero or RPi.GPIO, the two libraries every Pi tutorial uses, and press Run. Your program drives the board’s 40-pin header, and the LEDs, buttons, servos and sensors wired to it behave as they would on the bench.

Tidak ada Linux di halaman ini. Python-mu berjalan di mesin Python kecil (MicroPython, yang dibuat untuk browser), dengan gpiozero 2.0.1 dan RPi.GPIO 0.7.1 yang ditulis agar berperilaku seperti library sungguhan: kelas dan argumen yang sama, peringatan yang sama, error yang sama. time.sleep(1) adalah satu detik tersimulasi, jadi yang diukur program di sini sama dengan yang diukur di Pi sungguhan.

Rangkaian di atas adalah program pertama di Pi mana pun: LED di GPIO17, pin header 11, lewat resistor 330 ohm. Tekan Jalankan dan ia menyala satu detik, mati satu detik, dan Serial Monitor menampilkan setiap perubahan. Diukur di pin, setiap setengah siklusnya adalah 1000 ms dengan toleransi 0,2 ms.

Tombol yang menyalakan dan mematikan LED

Button dari gpiozero memanggil fungsimu saat ditekan, dan signal.pause() membuat program menunggunya. Tombol di sini tersambung dari GPIO2 ke ground. GPIO2 punya pull-up 1,8 k bawaan board, jadi terbaca high sampai tombol ditekan.

Tombol sungguhan memantul: kontaknya membuka dan menutup selama beberapa milidetik sebelum stabil, dan yang tersimulasi juga begitu. Dengan bounce_time=0.05 gpiozero melaporkan perubahan hanya setelah pin mempertahankannya selama 50 ms, jadi setiap tekanan mengubah LED satu kali. Tanpa itu, satu tekanan bisa mengubahnya lebih dari satu kali, seperti di Pi sungguhan.

main.py: tombol mengubah LED
# A button toggles an LED, with gpiozero.
# The button is between GPIO2 (pin 3) and ground: GPIO2 has the board's own
# 1.8 k pull-up, and Button() turns the pad's pull-up on as well.
from gpiozero import Button, LED
from signal import pause

led = LED(17)
button = Button(2, bounce_time=0.05)   # ignore 50 ms of contact bounce

def toggle():
    led.toggle()
    print("LED is", "on" if led.is_lit else "off")

button.when_pressed = toggle
pause()   # wait for presses forever; Ctrl-C in the Serial Monitor stops it

Servo dengan PWM RPi.GPIO

Servo hobby butuh pulsa setiap 20 ms, 50 Hz, dan panjang pulsa menentukan sudutnya. GPIO.PWM(18, 50) membuat pulsa itu di GPIO18, dan ChangeDutyCycle() mengatur panjangnya sebagai persentase dari 20 ms. Servo ini membaca 0,544 ms sebagai 0 derajat dan 2,4 ms sebagai 180, jadi 0, 45, 90, 135, dan 180 derajat adalah duty 2,72%, 5,04%, 7,36%, 9,68%, dan 12,00%, dan servo di kanvas bergerak ke setiap sudut bergantian.

Di Pi sungguhan, PWM RPi.GPIO berbasis software, dan Linux yang sibuk membuat pulsanya goyah, sehingga servo bergetar. Di sini pulsanya tepat. AngularServo dari gpiozero menghitungnya untukmu; di Pi 5 ia mengatur duty dalam persen bulat, jadi pulsa 50 Hz bergerak dalam langkah 10 µs, seperti di sana.

main.py: gerakkan servo dengan RPi.GPIO
# Sweep a servo with RPi.GPIO's software PWM on a Raspberry Pi 4.
# Signal on GPIO18 (pin 12), power from 5V (pin 2), ground on pin 6.
import RPi.GPIO as GPIO
import time

SERVO = 18
GPIO.setmode(GPIO.BCM)
GPIO.setup(SERVO, GPIO.OUT)
pwm = GPIO.PWM(SERVO, 50)        # 50 Hz: one pulse every 20 ms

def angle_to_duty(angle):
    # This servo reads a 0.544 ms pulse as 0 degrees and 2.4 ms as 180.
    pulse_ms = 0.544 + angle / 180 * 1.856
    return pulse_ms / 20 * 100   # the pulse as a percentage of the 20 ms frame

pwm.start(angle_to_duty(90))
try:
    while True:
        for angle in (0, 45, 90, 135, 180):
            pwm.ChangeDutyCycle(angle_to_duty(angle))
            print(f"{angle} degrees: {angle_to_duty(angle):.2f}% duty")
            time.sleep(1)
except KeyboardInterrupt:
    pwm.stop()
    GPIO.cleanup()

Sensor jarak HC-SR04 di Pi 5

gpiozero’s DistanceSensor sends the HC-SR04 a trigger pulse and times the echo. The echo is a 5 V signal, more than a Pi’s 3.3 V pin can take, so it comes through a 1 k and 2 k divider: 5 V times 2/3 is 3.3 V. Leave the divider out and the Circuit Doctor says so.

Atur sensor ke 100 cm dan program mencetak 100,0 cm, dengan toleransi 0,5 cm; di 15 cm ia mencetak 15,0 cm dan LED di GPIO17 menyala, karena threshold_distance=0.2 membuat 20 cm jadi batas “dalam jangkauan”.

main.py: baca HC-SR04 dengan gpiozero
# An HC-SR04 with gpiozero on a Raspberry Pi 5.
# TRIG on GPIO23 (pin 16). ECHO is a 5 V signal, so it reaches GPIO24 (pin 18)
# through a 1 k and 2 k divider: 5 V x 2/3 is 3.3 V, all a Pi's pin can take.
from gpiozero import DistanceSensor, LED
from time import sleep

sensor = DistanceSensor(echo=24, trigger=23, max_distance=2, threshold_distance=0.2)
led = LED(17)

sensor.when_in_range = led.on       # closer than 20 cm: the LED lights
sensor.when_out_of_range = led.off

while True:
    print(f"{sensor.distance * 100:.1f} cm")
    sleep(0.5)

BCM atau BOARD: dua cara menomori pin

RPi.GPIO perlu diberi tahu cara berhitungmu. GPIO.setmode(GPIO.BCM) memakai nomor GPIO chip, yang selalu dipakai gpiozero: GPIO17. GPIO.setmode(GPIO.BOARD) memakai posisi pin di header, dihitung dari pin 1 di pojok: pin 11. Itu pin yang sama. Program di bawah menyalakan pin header 11 dan 13 bergantian, setengah detik masing-masing, dan keduanya adalah GPIO17 dan GPIO27.

Minta pin yang bukan GPIO dalam penomoran saat ini, misalnya pin 2 BOARD yang adalah 5V, dan RPi.GPIO berhenti dengan “The channel sent is invalid on a Raspberry Pi”, seperti di board sungguhan. Atur pin dua kali tanpa GPIO.cleanup() dan ia memperingatkan bahwa channel sudah dipakai, beserta barisnya.

main.py: RPi.GPIO dengan penomoran BOARD
# RPi.GPIO with BOARD numbering: pins by their place on the header.
# Header pin 11 is GPIO17 and pin 13 is GPIO27. With GPIO.setmode(GPIO.BCM)
# the same two LEDs would be 17 and 27.
import RPi.GPIO as GPIO
import time

GPIO.setmode(GPIO.BOARD)
LEDS = [11, 13]
GPIO.setup(LEDS, GPIO.OUT, initial=GPIO.LOW)

try:
    while True:
        for pin in LEDS:
            GPIO.output(pin, GPIO.HIGH)
            print("header pin", pin, "on")
            time.sleep(0.5)
            GPIO.output(pin, GPIO.LOW)
finally:
    GPIO.cleanup()

OLED di I2C dengan smbus2

Bus I2C header adalah /dev/i2c-1: SDA di GPIO2 (pin 3) dan SCL di GPIO3 (pin 5), seperti di Raspberry Pi OS dengan I2C dinyalakan di raspi-config. smbus2 dan smbus yang lebih lama mengaksesnya, dan komponen di busnya menjawab di alamatnya: OLED SSD1306 di 0x3C, BME280 di 0x76. Program di bawah menggambar teks dengan driver kecil di tabnya sendiri, mengirim gambar dalam blok 16 byte seperti cara tutorial Pi klasik.

Bus berjalan di 100 kHz default Raspberry Pi OS pada jam tersimulasi, jadi frame 1 KB memakan waktu seperti di meja kerja: program mencetak 100 sampai 125 ms per frame. Minta alamat yang tidak dijawab siapa pun dan smbus memunculkan OSError: [Errno 121] Remote I/O error, error yang muncul karena kabel longgar di Pi sungguhan.

main.py: teks di SSD1306 dengan smbus2
# An SSD1306 OLED on a Raspberry Pi 4, over smbus2.
# SDA to GPIO2 (pin 3), SCL to GPIO3 (pin 5), VCC to 3V3 (pin 1), GND (pin 9).
# ssd1306_smbus.py is a small driver in its own tab.
import time
from ssd1306_smbus import SSD1306

oled = SSD1306(bus=1, address=0x3C)   # /dev/i2c-1, the header's I2C bus
start = time.monotonic()

while True:
    seconds = int(time.monotonic() - start)
    oled.fill(0)
    oled.text("Hello, Pi!", 0, 0)
    oled.text("smbus2 on i2c-1", 0, 16)
    oled.text("up %d s" % seconds, 0, 40)
    t = time.monotonic()
    oled.show()                       # 1 KB at 100 kHz: about a tenth of a second
    print("frame", seconds, "took %.0f ms" % ((time.monotonic() - t) * 1000))
    time.sleep(1)

Potensiometer lewat MCP3008

Pi tidak punya input analog, jadi knob atau sensor cahaya melewati pengubah analog-ke-digital, dan MCP3008 adalah yang dipakai dokumentasi gpiozero. Ia berada di SPI0: CLK ke GPIO11, DOUT ke GPIO9, DIN ke GPIO10 dan CS ke GPIO8, yaitu /dev/spidev0.0. MCP3008(channel=0) membacanya lewat spidev, dan led.source = pot memberikan hasil bacaan ke PWMLED.

Kode chip adalah 1024 kali input dibagi referensinya, jadi knob yang diputar ke 800 dari 1023 pada 3,3 V terbaca 800, dan value gpiozero adalah 0,782, diskalakan seperti gpiozero 2.0.1 menskalakannya. spidev juga bisa dipakai sendiri: spi.xfer2([1, 0x80, 0]) adalah bacaan yang sama secara manual.

main.py: MCP3008 dengan gpiozero
# A potentiometer through an MCP3008 on a Raspberry Pi 5, with gpiozero.
# The Pi has no analog inputs, so the MCP3008 converts: CLK to GPIO11 (pin 23),
# DOUT to GPIO9 (pin 21), DIN to GPIO10 (pin 19), CS to GPIO8 (pin 24, CE0).
from gpiozero import MCP3008, PWMLED
from time import sleep

pot = MCP3008(channel=0)    # spidev0.0: SPI0 with chip select CE0
led = PWMLED(18)

led.source = pot            # the knob sets the LED's brightness

while True:
    print("value %.3f  raw %4d  %.2f V" % (pot.value, pot.raw_value, pot.voltage))
    sleep(0.5)

RPi.GPIO di Raspberry Pi 5

RPi.GPIO tidak berfungsi di Pi 5. Pinnya ada di chip baru, RP1, tempat RPi.GPIO tidak bisa menemukannya, dan GPIO.setup() pertama berhenti dengan RuntimeError: Cannot determine SOC peripheral base address. Pi 5 di Mokxi melakukan hal yang sama, dan editor menyarankan gpiozero, yang dipakai dokumentasi Raspberry Pi dan berfungsi di ketiga board.

Apa yang disimulasi, dan apa yang tidak

Simulated: the 40-pin header of each board, with its 3.3 V and 5 V pins and its grounds, GPIO 0 to 27 as inputs with their pull-ups and pull-downs or as 3.3 V outputs, PWM, edge callbacks with their debounce, I2C and SPI through smbus, smbus2, spidev and gpiozero’s SPI devices, and Python’s time on the simulated clock. print() and input() use the Serial Monitor, and Ctrl-C stops the program with KeyboardInterrupt.

Tidak tersimulasi: Linux itu sendiri, jadi tidak ada desktop, terminal, dan sudo; pip dan apt, jadi hanya modul yang datang bersama board bisa diimpor; jaringan dalam bentuk apa pun; kamera, layar, dan audio; thread; serta pengaturan kecepatan bus I2C dan clock stretching, jadi I2C berjalan di 100 kHz default. Mesinnya MicroPython, bukan CPython, jadi beberapa hal di bahasanya berbeda: isinstance(True, int) bernilai False, misalnya. Program yang mengendalikan pin berjalan tanpa perubahan.

Buka rangkaian ini di editor. Raspberry Pi 4: gpiozero mengedipkan LED di GPIO17, dirangkai seperti yang berjalan di bagian atas halaman ini. Ubah komponen atau nilainya dan jalankan lagi.

Buka rangkaian ini

Pertanyaan

Apakah ini emulator Raspberry Pi lengkap?

No. There is no Linux and no Arm processor in the page. Your Python program runs in a Python engine in the browser, and its gpiozero and RPi.GPIO drive the board’s 40-pin header. Everything a circuit can see of a Pi is there; the desktop, the shell and the operating system are not.

Board Raspberry Pi apa saja yang tersedia?

The Raspberry Pi 4 Model B, the Raspberry Pi 5 and the Raspberry Pi Zero 2 W, each with the same 40-pin header. RPi.GPIO works on the Pi 4 and the Zero 2 W and fails on the Pi 5, as it does on the real one; gpiozero works on all three.

Apakah I2C dan SPI bekerja?

Ya. `/dev/i2c-1`, `/dev/spidev0.0`, dan `0.1` ada di sana, seperti pada Raspberry Pi OS dengan kedua antarmuka dinyalakan, dan smbus, smbus2, spidev, serta MCP3008 milik gpiozero berkomunikasi dengan komponen I2C dan SPI di kanvas pada kecepatan bus-nya.

Bisakah aku pip install sebuah library?

Tidak. pip dan apt tidak disimulasikan. Tambahkan file .py sebuah library sebagai tab tersendiri dan import dari main.py, ini bekerja untuk library yang ditulis dalam Python murni.

Apakah ini mengunduh sesuatu?

Run pertama sebuah proyek Raspberry Pi mengunduh engine Python, sekitar 150 KB, dan browser menyimpannya untuk setiap Run berikutnya. Proyek Arduino tidak pernah mengunduhnya.

Rakit versi nyatanya

Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.