🌈 نمایشگر OLED و نئوپیکسل با میکروپایتون روی رزبری پای پیکو

✍️ تیم ووکوی فارسی · ۲۷ مهر ۱۴۰۵

یک LED چشمک‌زن خوب است، ولی پروژه‌ات وقتی جان می‌گیرد که بتواند متن نشان بدهد و رنگی شود. در این آموزش با میکروپایتون روی رزبری پای پیکو یک نمایشگر OLED کوچک و یک نوار هشت‌تایی نئوپیکسل را با هم راه می‌اندازیم. کد را می‌توانی بدون خرید قطعه در شبیه‌ساز آنلاین (همان کاری که کاربران wokwi انجام می‌دهند، این بار به فارسی) اجرا کنی.

چه چیزی می‌سازیم؟

یک «نوار پیشرفت» رنگی: هر نیم ثانیه یک LED دیگر از نوار نئوپیکسل روشن می‌شود و رنگ عوض می‌کند، و هم‌زمان روی OLED عدد مرحله و یک نوار پرشونده نمایش داده می‌شود.

قطعه‌ها

• رزبری پای پیکو
• نمایشگر OLED SSD1306 مدل ۱۲۸×۶۴ با رابط I2C
• نوار نئوپیکسل ۸تایی (WS2812)
• سیم جامپر

سیم‌کشی

کد کامل میکروپایتون

from machine import Pin, I2C
import ssd1306
import neopixel
import time

i2c = I2C(0, sda=Pin(4), scl=Pin(5), freq=400000)
oled = ssd1306.SSD1306_I2C(128, 64, i2c)

NUM = 8
np = neopixel.NeoPixel(Pin(16), NUM)

colors = [(255, 0, 0), (0, 255, 0), (0, 0, 255), (255, 160, 0)]
step = 0

while True:
    lit = step % NUM
    r, g, b = colors[(step // NUM) % len(colors)]
    for i in range(NUM):
        if i <= lit:
            np[i] = (r // 4, g // 4, b // 4)   # یک‌چهارم نور، برای چشم و باتری
        else:
            np[i] = (0, 0, 0)
    np.write()

    oled.fill(0)
    oled.text("Wokwi.ir + Pico", 0, 0)
    oled.text("Step: " + str(step), 0, 20)
    oled.rect(0, 44, 128, 12, 1)
    oled.fill_rect(0, 44, (lit + 1) * 16, 12, 1)
    oled.show()

    step += 1
    time.sleep(0.5)

توضیح بخش‌های مهم

بخش OLED

• I2C(0, sda=Pin(4), scl=Pin(5)): پیکو دو باس I2C دارد. GP4 و GP5 به باس شماره‌ی ۰ تعلق دارند. اگر پایه‌ها را با شماره‌ی باس جور نکنی، خطا می‌گیری.
• ssd1306.SSD1306_I2C(128, 64, i2c): درایور نمایشگر را با اندازه‌ی ۱۲۸ در ۶۴ پیکسل می‌سازد. آدرس پیش‌فرض 0x3C است.
• oled.fill(0) صفحه را پاک می‌کند، oled.text متن می‌نویسد (هر حرف ۸×۸ پیکسل)، rect و fill_rect مستطیل توخالی و توپر می‌کشند.
• oled.show(): تا این خط را صدا نزنی، هیچ چیزی روی صفحه نمی‌آید! همه‌چیز اول در حافظه کشیده می‌شود و بعد یک‌جا فرستاده می‌شود.

بخش نئوپیکسل

• neopixel.NeoPixel(Pin(16), NUM): نواری با ۸ LED روی GP16.
• np[i] = (r, g, b): رنگ هر LED یک سه‌تایی از ۰ تا ۲۵۵ است.
• np.write(): مثل show() در OLED؛ رنگ‌ها فقط با این خط به نوار فرستاده می‌شوند.

اجرا در شبیه‌ساز

پروژه‌ی آماده‌ی OLED و نئوپیکسل با MicroPython روی پیکو در تینکرکد فارسی همین دو قطعه را دارد. پیکو، OLED و نئوپیکسل هر سه جزو امکانات اشتراک پلاس هستند؛ مثال آماده برای خواندن رایگان باز می‌شود و برای اجرایش پلاس لازم است. صفحه‌ی قطعه‌ی نئوپیکسل هم توضیح کامل‌تری درباره‌ی این LEDهای هوشمند دارد.

اشکال‌های رایج

• ImportError: no module named 'ssd1306': روی برد واقعی، فایل ssd1306.py باید روی پیکو کپی شده باشد؛ این درایور جزو همه‌ی فرم‌ورها نیست.
• OSError: [Errno 5] EIO: پیکو نمایشگر را روی باس I2C پیدا نکرده. SDA و SCL را جابه‌جا نزده‌ای؟ برای پیدا کردن آدرس، print(i2c.scan()) را امتحان کن؛ باید عدد ۶۰ (همان 0x3C) را ببینی.
• صفحه سیاه می‌ماند: oled.show() را فراموش کرده‌ای.
• نئوپیکسل رنگ عجیب نشان می‌دهد یا فقط اولی روشن است: np.write() را جا انداخته‌ای یا تعداد LEDها را اشتباه داده‌ای.
• پیکو ری‌استارت می‌شود: نوارهای بلند با نور کامل جریان زیادی می‌کشند. نور را کم کن (همان تقسیم بر ۴ در کد) یا تغذیه‌ی جدا بگذار.

اگر با دکمه هم کار کرده‌ای، سعی کن با وقفه‌ی دکمه رنگ نوار را عوض کنی. همین پروژه را با آردوینو هم می‌شود ساخت: OLED با آردوینو. برای امکانات بیشتر برد، صفحه‌ی رزبری پای پیکو را ببین.

مقاله‌های مرتبط

همه‌ی آموزش‌های رزبری پای پیکو و میکروپایتون ← · همه‌ی مقاله‌ها