تماشا در یوتیوب

پروژه ماتریس LED RGB ESP32-S3 3 - متن از تلفن همراه

پروژه ۳ - متن کنترل ماتریس از تلفن شما (متن HTTP)

در این پروژه ماتریس LED RGB ESP32-S3 یک صفحه وب کوچک را میزبانی می‌کند تا بتوانید متن متحرک، رنگ، جهت و سرعت را مستقیماً از تلفن یا کامپیوتر خود تغییر دهید. نیازی به یک برنامه جداگانه نیست - فقط یک مرورگر وب کافی است. این ویژگی ماجیول را به یک نمایشگر متنی کوچک Wi-Fi تبدیل می‌کند که می‌توانید آن را به‌صورت آنی به‌روزرسانی کنید.

تمام شش پروژه در این سری در یک ویدیوی یوتیوب توضیح داده شده و به نمایش درآمده‌اند. همان ویدیو در این صفحه گنجانده شده است، بنابراین می‌توانید دقیقاً ببینید که رابط وب چگونه به نظر می‌رسد و چگونه متن به‌طور آنی در ماتریس به‌روزرسانی می‌شود. شِفر (کود) منبع کامل این پروژه به‌طور خودکار در زیر مقاله بارگذاری شده و می‌توانید ماجیول ماتریس LED RGB ESP32-S3 را از فروشگاه‌های وابسته که در بخش شِفر (کود) ذکر شده خریداری کنید.

در این مقاله ما بر روی چگونگی عملکرد منطق شبکه (وای‌فای خانگی در مقابل نقطه دسترسی) و تنظیماتی که می‌توانید در شِفر (کود) تغییر دهید تا رفتار را شخصی‌سازی کنید، تمرکز می‌کنیم.

مرور کلی ماجیول ماتریس LED RGB ESP32-S3

سخت‌افزار همانند دیگر پروژه‌های این سری است: یک برد میکروکنترلر ESP32-S3 با یک ماتریس LED RGB 8×8 داخلی و یک حساس(حس کننده) حرکت QMI8658C در پشت. درگاه USB-C برای تأمین انرژی و برنامه‌ریزی استفاده می‌شود و پایه‌های اطراف لبه‌ها هنوز برای ورودی/خروجی‌های دیگر در دسترس هستند.:contentReference[oaicite:0]{index=0}

• ESP32-S3میکروکنترلر با قابلیت وای‌فای و بلوتوث.
• ماتریس RGB هشت در هشت- ۶۴ دیود نوری RGB قابل آدرس‌دهی برای متن و گرافیک.
• شتاب‌سنج QMI8658C- در پروژه‌های تیلت و بازی استفاده شده است.
• پورت USBبرد را تغذیه می‌کند و طرح‌ها را از Arduino IDE بارگذاری می‌کند.
• پایه‌های نمایاناگر لازم است، حسگرها یا عملگرهای اضافی را اجازه دهید.
• کلیدهای راه‌اندازی/بازنشانی- برای بارگذاری نرم‌افزار سیستم عامل و راه‌اندازی مجدد.

برای پروژه ۳، مهم‌ترین ویژگی Wi-Fi ESP32 است که به بُرد اجازه می‌دهد به‌عنوان یک سرور وب کوچک برای صفحه کنترل متن عمل کند.:contentReference[oaicite:1]{index=1}

پروژه‌های پوشش داده شده در ویدئو (زمان‌های تعیین شده)

این ویدیوی تک برای این مجموعه تمام شش پروژه را پوشش می‌دهد. برای ارجاع سریع:

• ۰۰:۰۰- مقدمه
• ۰۲:۰۱- نصب بردهای ESP32
• 03:32- نصب کتابخانه‌ها
• 05:32- پروژه ۱: نقطه متحرک
• ۱۱:۱۱- پروژه ۲: حرکت متن
• ۱۲:۵۹-پروژه ۳: متن HTTP (این پروژه)
• ۱۶:۴۱پروژه ۴: نقطه مایل
• ۱۸:۵۵پروژه ۵: فلش به بالا
• ۲۰:۰۲- پروژه 6: بازی هدف

شما تشویق می‌شوید که بخش متن HTTP را در ویدئو در حین کار با این مقاله تماشا کنید. ویدئو نشان می‌دهد که چگونه صفحه وب توسط ESP32 ایجاد می‌شود و چگونه تغییر متن، رنگ و سرعت بلافاصله بر روی ماتریس LED منعکس می‌شود.:contentReference[oaicite:2]{index=2}

نصب بردهای ESP32 در Arduino IDE

اگر قبلاً پروژه‌های ۱ یا ۲ را کامل کرده‌اید، تنظیمات برد انجام شده و می‌توانید این بخش را بگذرانید. در غیر این صورت، مراحل زیر را در IDE آردوینو دنبال کنید:

1. باز کنFile > Preferencesو آدرس تخته‌ های ESP32 را به "آدرس‌های اضافی مدیریت تخته" اضافه کنید.
2. برو بهTools > Board > Boards Manager…جستجو برایESP32, و بسته نرم‌افزاری رسمی ESP32 را نصب کنید.
3. برد RGB Matrix صحیح ESP32-S3 را انتخاب کنید ازTools > Board.
4. ماجیول را از طریق USB متصل کرده و پورت سریال صحیح را انتخاب کنید زیرTools > Port.

بدون پشتیبانی مناسب از برد ESP32 و پورت صحیح، اسکیچ وب‌سرور بارگذاری نخواهد شد.

نصب NeoMatrix و کتابخانه‌های مورد نیاز

این پروژه از همان کتابخانه‌ها به عنوان پروژه اسکرول متن قبلی استفاده می‌کند:

• Adafruit NeoMatrix
• Adafruit NeoPixel
• Adafruit GFX Library

از طریق مدیر کتابخانه نصب کنید:

1. باز کنیدSketch > Include Library > Manage Libraries….
2. جستجو برایAdafruit NeoMatrixو کلیک کنیدنصب کنید.
3. پذیرش نصب وابستگی‌ها (Adafruit GFXوAdafruit NeoPixel).

پس از نصب، باید نمونه‌ طرح‌های NeoMatrix و NeoPixel را در زیر مشاهده کنید.File > Examples.

دو حالت Wi-Fi در پروژه ۳

مفهوم مهم‌ترین در این پروژه این است که ESP32 می‌تواند دردو حالت مختلف:

1. حالت ایستگاه (STA)- ESP32 به شبکه Wi-Fi خانگی موجود شما متصل می‌شود.
2. حالت نقطه دسترسی (AP)ESP32 در صورت عدم دسترسی به شبکه Wi-Fi خانگی، شبکه Wi-Fi مخصوص به خود را ایجاد می‌کند.

هر دو حالت از یک رابط وب مشابه استفاده می‌کنند: یک صفحه HTML که از خود ESP32 ارائه می‌شود، جایی که می‌توانید متن، رنگ، جهت و سرعت اسکرول را تغییر دهید.:contentReference[oaicite:3]{index=3}

حالت ۱ - اتصال به وای‌فای خانگی (حالت ایستگاه)

در حالت ایستگاه، ESP32 به شبکه Wi-Fi خانه یا دفتر شما متصل می‌شود. این حالت زمانی که روتر شما در دسترس است، حالت ترجیحی است زیرا:

• تلفن و کامپیوتر شما در حال حاضر به یک شبکه Wi-Fi مشابه متصل هستند.
• شما می‌توانید مرورگر خود را به آدرس IP ESP32 متصل کنید و متن را از هر دستگاهی در آن شبکه کنترل کنید.

در بخش تنظیمات طرح، SSID و رمز عبور Wi-Fi خود را ارائه می‌دهید:

// Home Wi-Fi credentials (Station mode)
const char* WIFI_SSID = "YourHomeWiFi";
const char* WIFI_PASS = "YourHomePassword";

پس از روشن شدن برد، سعی می‌کند به هم متصل شودWIFI_SSIDاگر موفق باشد، شِفر (کود) آدرس IP تخصیص داده شده را بر روی نمایشگر مسلسل چاپ می‌کند، به عنوان مثال:

Connected to WiFi
IP address: 192.168.1.16

برای کنترل متن:

1. اطمینان حاصل کنید که تلفن یا رایانه شما به همان شبکه Wi-Fi متصل است (برای مثال،YourHomeWiFi).
2. یک مرورگر باز کنید و آدرس IP چاپ شده را وارد کنید، مانندhttp://192.168.1.16/. :contentReference[oaicite:4]{index=4}
3. صفحه کنترل ظاهر خواهد شد و به شما این امکان را می‌دهد که متن را تایپ کنید، رنگ را انتخاب کنید، جهت را مشخص کنید و سرعت اسکرول را تنظیم کنید.

حالت ۲ - نقطه دسترسی مستقل (حالت AP)

اگر ESP32 نتواند به Wi-Fi خانگی شما متصل شود (رمز عبور اشتباه، شبکه در دسترس نیست، یا شما ماجیول را در خارج از خانه استفاده می‌کنید)، شِفر (کود) به طور خودکار به حالت Access Point بازمی‌گردد. در حالت AP، خود ESP32 به یک نقطه داغ Wi-Fi با نام شبکه و رمز عبور خود تبدیل می‌شود.

در این پروژه، تنظیمات AP به صورت ثابت تعیین شده‌اند:

// Access Point (AP) credentials (fallback mode)
const char* AP_SSID = "ESP32";
const char* AP_PASS = "password";

وقتی حالت ایستگاه ناموفق است، ماجیول به حالت AP تغییر حالت می‌دهد و شروع به پخش یک شبکه Wi-Fi به نام می‌کند.ESP32برای کنترل ماتریس:

1. در تلفن یا کامپیوتر خود، تنظیمات Wi-Fi را باز کرده و به شبکه متصل شوید.ESP32.
2. رمز عبور را وارد کنیدگذرواژه(طبق تعریفی که در شِفر (کود) آمده است).
3. پس از اتصال، یک مرورگر را باز کنید و بهhttp://192.168.4.1/(آدرس IP پیش فرض برای حالت AP ESP32).
4. همان صفحه کنترل ظاهر می‌شود و به شما این امکان را می‌دهد که متن، رنگ، سرعت و جهت را تغییر دهید.

این رفتار پشتیبان باعث می‌شود پروژه در هر جایی مفید باشد: در خانه، در آزمایشگاه یا در یک محیط نمایش که هیچ روتر در دسترس نیست.

پروژه ۳ - تنظیمات اصلی در شِفر (کود)

نقشه کامل متن HTTP در زیر این مقاله توسط وب‌سایت بارگذاری شده است. در اینجا تنها گزینه‌های پیکربندی مهمی را که احتمالاً ویرایش خواهید کرد، مستند می‌کنیم.

تنظیمات Wi-Fi و نقطه دسترسی

در بالای طرح، بخش پیکربندی Wi-Fi را خواهید یافت. تنها مشخصات ایستگاه (Wi-Fi خانگی) را تغییر دهید؛ تنظیمات AP معمولاً به عنوان پیش‌فرض نگه‌داشته می‌شوند:

// ---------- Wi-Fi SETTINGS ----------

// Home Wi-Fi (Station mode)
const char* WIFI_SSID = "YourHomeWiFi";      // put your router SSID here
const char* WIFI_PASS = "YourHomePassword";  // put your router password here

// Fallback Access Point (AP mode)
const char* AP_SSID = "ESP32";               // fixed AP name
const char* AP_PASS = "password";            // fixed AP password

رفتار:

• اگرWIFI_SSIDوWIFI_PASSدرست هستند و شبکه موجود است → ESP32 به عنوان یک دستگاه Wi-Fi عادی (حالت ایستگاه) متصل می‌شود.
• اگر اتصال بعد از یک زمان انتظار ناموفق باشد → ESP32 نقطه دسترسی خود را با استفاده از آغاز می‌کندAP_SSIDوAP_PASS.

پایه ماتریس، اندازه و روشنایی

این تنظیمات مشابه پروژه‌های قبلی هستند:

// Matrix configuration
const int MATRIX_PIN    = 14;   // RGB matrix data pin
const int MATRIX_WIDTH  = 8;
const int MATRIX_HEIGHT = 8;

// Overall display brightness (0–255)
uint8_t matrixBrightness = 40;  // adjust for your environment

نگه‌داریدMATRIX_PINدر14برای این تخته. شما می‌توانید افزایش دهیدmatrixBrightnessاگر به نور بیشتری نیاز دارید، اما مقدارهای پایین‌تر برای تماشای نزدیک‌تر راحت‌تر هستند.

تنظیمات متنی پیش‌فرض و تنظیمات پیمایش

هنگامی که تابلو شروع به کار می‌کند، یک پیام اولیه نمایش داده می‌شود تا زمانی که شما صفحه وب را باز کنید و متن جدیدی تایپ کنید. شما می‌توانید متن پیش‌فرض را در تنظیمات تغییر دهید:

// Default message shown at startup
String currentText = "Robojax";   // overwrite from web UI later

بقیه رفتار اسکرول توسط مجموعه‌ای از متغیرها کنترل می‌شود که توسط رابط وب به‌روزرسانی می‌شوند:

// Scroll delay in milliseconds (lower = faster)
int scrollDelayMs = 50;

// Scroll direction: 0=left, 1=right, 2=up, 3=down
int scrollDirection = 0;   // default: scroll left

صفحه وب بر اساس انتخاب‌های اسلایدر و دکمه مقادیر جدیدی ارسال می‌کند. از سمت آردوینو، فقط باید بدانید که:

• کاهشیscrollDelayMsمتن را سریع‌تر حرکت می‌دهد.
• افزایشscrollDelayMsاین باعث می‌شود که حرکت آن کندتر شود.
• تغییر دادنscrollDirectionبین حالت‌های پیمایش چپ، راست، بالا یا پایین جابه‌جا می‌شود.

رنگ متن (کنترل شده از صفحه وب)

رنگ متن توسط سه مقدار ۰-۲۵۵ (قرمز، سبز، آبی) کنترل می‌شود. این مقادیر هر بار که رنگ جدیدی را در وب‌سایت انتخاب کنید، به‌روز می‌شوند:

// Current text color (R, G, B)
uint8_t textRed   = 255;
uint8_t textGreen = 255;
uint8_t textBlue  = 255;

زمانی که شما یک رنگ را در مرورگر انتخاب کرده و روی "اعمال" کلیک می‌کنید، ESP32 مقادیر RGB را تجزیه کرده و این سه متغیر را به‌روز می‌کند؛ متن بلافاصله رنگش در ماتریس تغییر می‌کند. در ویدیو، این رفتار با تغییر رنگ‌های مختلف، از جمله مثال‌های قرمز، سبز و آبی نشان داده می‌شود.:contentReference[oaicite:5]{index=5}

خلاصه

پروژه ۳ ماتریس LED RGB ESP32-S3 شما را به یک نمایشگر متنی کاملاً بی‌سیم تبدیل می‌کند که می‌توانید با استفاده از هر دستگاهی که دارای مرورگر وب است آن را کنترل کنید. طرح به گونه‌ای طراحی شده است که انعطاف‌پذیر باشد:

• ابتدا سعی می‌کند به شبکه Wi-Fi خانگی شما متصل شود با استفاده از SSID و رمز عبوری که تنظیم کرده‌اید.
• اگر این کار نکرد، به‌طور خودکار به یک نقطه دسترسی با نام تبدیل می‌شودESP32و رمز عبورpassword.
• در هر دو حالت، باز کردن آدرس IP صحیح در یک مرورگر همان صفحه کنترل برای متن، رنگ، جهت و سرعت را نمایش می‌دهد.

شِفر (کود) کامل HTTP Text در زیر این مقاله موجود است (به طور خودکار در وب‌سایت بارگذاری می‌شود). برای مشاهده یک راهنمای دقیق مرحله به مرحله و یک نمایش زنده از نحوه به‌روزرسانی متن در زمان واقعی، حتماً بخش پروژه 3 از ویدیو را تماشا کنید. اگر می‌خواهید پروژه را خودتان بسازید، می‌توانید ماجیول ماتریس LED RGB ESP32-S3 را نیز با استفاده از واصل‌های وابسته‌ای که در زیر شِفر (کود) ذکر شده‌اند، خریداری کنید.

تصاویر

ESP32 S3 Matrix

ESP32 S3 Matrix pin out

ESP32-S3_RGB_8x8_matrix-3

ESP32 S3 Matrix displaying rainbow heart

ESP32-S3_RGB_8x8_matrix1

ESP32-S3_RGB_8x8_matrix-2

ESP32-S3 RGB Matrix- Mobile Phone Text

ESP32 S3 Matrix

ESP32 S3 Matrix pin out

ESP32-S3_RGB_8x8_matrix-3

ESP32 S3 Matrix displaying rainbow heart

ESP32-S3_RGB_8x8_matrix1

ESP32-S3_RGB_8x8_matrix-2

ESP32-S3 RGB Matrix- Mobile Phone Text