Raspberry Pi GPIO với Python, không cần Pi thật trên bàn
Cơ bản
Hoặc xem mọi bài học.
- 526linh kiện trên bàn làm mạch
- 46bo mạch đang chạy
- 1.00xthời gian thực, trên mọi bo mạch
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.
Không có Linux trong trang web. Python của bạn chạy trên một engine Python nhỏ (MicroPython, dựng cho trình duyệt), với gpiozero 2.0.1 và RPi.GPIO 0.7.1 được viết để hành xử như thư viện thật: cùng các class và tham số, cùng cảnh báo, cùng lỗi. time.sleep(1) là một giây mô phỏng, nên chương trình đo được ở đây chính là nó đo được trên Pi.
Mạch phía trên là chương trình đầu tiên trên mọi Pi: một LED trên GPIO17, chân 11 của header, qua điện trở 330 ohm. Nhấn Chạy và nó sáng một giây, tắt một giây, và Serial Monitor hiển thị từng thay đổi. Đo trên chân, mỗi nửa chu kỳ là 1000 ms với sai số trong 0.2 ms.
Nút nhấn bật tắt LED
Button của gpiozero gọi một hàm của bạn khi được nhấn, và signal.pause() giữ chương trình chờ đợi nó. Nút nhấn ở đây nối từ GPIO2 xuống mass. GPIO2 có điện trở pull-up 1.8 k riêng của bo mạch, nên nó đọc mức cao cho đến khi nút được nhấn.
Nút nhấn thật có rung tiếp điểm: các tiếp điểm đóng mở trong vài mili giây trước khi ổn định, và nút mô phỏng cũng vậy. Với bounce_time=0.05, gpiozero chỉ báo một thay đổi khi chân giữ trạng thái đó được 50 ms, nên mỗi lần nhấn chỉ bật tắt LED một lần. Bỏ tham số này đi thì một lần nhấn có thể bật tắt nhiều hơn một lần, như trên Pi thật.
# 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 trên PWM của RPi.GPIO
Servo hobby cần một xung mỗi 20 ms, tức 50 Hz, và độ dài xung quyết định góc quay. GPIO.PWM(18, 50) tạo xung đó trên GPIO18, và ChangeDutyCycle() đặt độ dài xung theo phần trăm của 20 ms. Servo này đọc 0.544 ms là 0 độ và 2.4 ms là 180 độ, nên 0, 45, 90, 135 và 180 độ lần lượt là duty 2.72%, 5.04%, 7.36%, 9.68% và 12.00%, và servo trên khung vẽ quay tới từng góc một.
Trên Pi thật, PWM của RPi.GPIO là PWM phần mềm, và Linux bận rộn làm xung bị jitter, nên servo bị giật. Ở đây các xung là chính xác. AngularServo của gpiozero làm phép tính giùm bạn; trên Pi 5 nó đặt duty theo phần trăm nguyên, nên xung 50 Hz dịch chuyển theo bước 10 µs, giống như trên đó.
# 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()
Cảm biến khoảng cách HC-SR04 trên 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.
Đặt cảm biến ở 100 cm thì chương trình in ra 100.0 cm, chính xác trong 0.5 cm; ở 15 cm nó in 15.0 cm và LED trên GPIO17 sáng, vì threshold_distance=0.2 đặt 20 cm làm ranh giới của "trong tầm đo".
# 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 hay BOARD: hai cách đánh số chân
RPi.GPIO cần được cho biết bạn đếm theo cách nào. GPIO.setmode(GPIO.BCM) dùng số GPIO của chip, cách gpiozero luôn dùng: GPIO17. GPIO.setmode(GPIO.BOARD) dùng vị trí chân trên header, đếm từ chân 1 ở góc: chân 11. Đó là cùng một chân. Chương trình dưới đây lần lượt sáng chân 11 và 13 của header, mỗi chân nửa giây, và chúng là GPIO17 và GPIO27.
Yêu cầu một chân không phải GPIO theo kiểu đánh số hiện tại, chẳng hạn chân BOARD 2 là 5V, thì RPi.GPIO dừng với "The channel sent is invalid on a Raspberry Pi", như trên Pi thật. Thiết lập một chân hai lần mà không có GPIO.cleanup() thì nó cảnh báo chân đã được dùng, kèm số dòng.
# 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()
Màn hình OLED trên I2C với smbus2
Bus I2C của header là /dev/i2c-1: SDA trên GPIO2 (chân 3) và SCL trên GPIO3 (chân 5), giống như trên Raspberry Pi OS khi bật I2C trong raspi-config. smbus2 và thư viện cũ hơn smbus giao tiếp với nó, và các linh kiện trên bus trả lời tại địa chỉ của mình: OLED SSD1306 ở 0x3C, BME280 ở 0x76. Chương trình dưới đây vẽ chữ với một driver nhỏ nằm trong tab riêng, gửi hình theo từng khối 16 byte như các hướng dẫn Pi kinh điển vẫn làm.
Bus chạy ở 100 kHz mặc định của Raspberry Pi OS trên đồng hồ mô phỏng, nên một khung hình 1 KB mất thời gian như trên bàn thật: chương trình in ra 100 đến 125 ms mỗi khung hình. Yêu cầu một địa chỉ không linh kiện nào trả lời thì smbus báo OSError: [Errno 121] Remote I/O error, đúng lỗi mà một dây lỏng gây ra trên Pi thật.
# 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)
Biến trở qua MCP3008
Pi không có chân analog, nên một núm xoay hay cảm biến ánh sáng phải đi qua bộ chuyển đổi analog sang số, và MCP3008 là bộ mà tài liệu gpiozero dùng. Nó nằm trên SPI0: CLK nối GPIO11, DOUT nối GPIO9, DIN nối GPIO10 và CS nối GPIO8, tức /dev/spidev0.0. MCP3008(channel=0) đọc nó qua spidev, và led.source = pot đưa giá trị đọc được cho một PWMLED.
Mã số của chip là 1024 lần điện áp vào chia cho điện áp tham chiếu, nên một núm xoay ở mức 800 trên 1023 với 3.3 V đọc được 800, và value của gpiozero là 0.782, quy đổi đúng như gpiozero 2.0.1 quy đổi. spidev cũng tự dùng được một mình: spi.xfer2([1, 0x80, 0]) là cùng kết quả đọc đó, làm thủ công.
# 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 trên Raspberry Pi 5
RPi.GPIO không chạy được trên Pi 5. Các chân của nó nằm trên chip mới là RP1, nơi RPi.GPIO không tìm thấy, và lệnh GPIO.setup() đầu tiên dừng với RuntimeError: Cannot determine SOC peripheral base address. Pi 5 của Mokxi cũng vậy, và trình soạn code khuyên dùng gpiozero, thư viện mà tài liệu Raspberry Pi dùng và chạy được trên cả ba bo mạch.
Điều gì được mô phỏng, và điều gì không
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.
Không được mô phỏng: bản thân Linux, nên không có desktop, không có terminal và không có sudo; pip và apt, nên chỉ có thể import các module kèm sẵn với bo mạch; mọi loại mạng; camera, màn hình và âm thanh; thread; cùng thiết lập tốc độ và clock stretching của bus I2C, nên I2C chạy ở 100 kHz mặc định. Engine là MicroPython, không phải CPython, nên một số thứ trong ngôn ngữ khác nhau: isinstance(True, int) là False, chẳng hạn. Chương trình điều khiển các chân thì chạy không cần sửa.
Mở mạch này trong trình soạn thảo. Raspberry Pi 4: gpiozero nhấp nháy LED trên GPIO17, nối như đang chạy ở đầu trang này. Đổi một linh kiện hay một giá trị rồi chạy lại.
Mở mạchCâu hỏi
Đây có phải là trình giả lập Raspberry Pi đầy đủ không?
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.
Có những bo mạch Raspberry Pi nào?
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.
I2C và SPI có hoạt động không?
Có. `/dev/i2c-1`, `/dev/spidev0.0` và `0.1` đều có, như trên Raspberry Pi OS khi bật cả hai giao tiếp, và smbus, smbus2, spidev cùng MCP3008 của gpiozero giao tiếp với các linh kiện I2C và SPI trên khung vẽ với tốc độ của bus.
Tôi có thể pip install một thư viện không?
Không. pip và apt không được mô phỏng. Hãy thêm tệp .py của thư viện thành một tab riêng và import nó từ main.py, cách này hoạt động với các thư viện viết bằng Python thuần.
Có cần tải gì xuống không?
Lần Chạy đầu tiên của một dự án Raspberry Pi sẽ tải xuống trình Python, khoảng 150 KB, và trình duyệt giữ lại nó cho mọi lần Chạy sau. Một dự án Arduino không bao giờ tải nó xuống.
Tiếp tục nào
Thông tin trên trang này lấy từ đâu
Lắp mạch này ngoài đời
Mở trình soạn thảo, đổi một giá trị và xem con số thay đổi theo. Không cần cài gì, không cần tài khoản.