نظرة عامة مع أمثلة قيد التشغيل تجدها في صفحة اللوحة و نموذج ESP32-C6 (كل سجل).
ما هي
وحدة ESP32-C6-WROOM-1 على لوحة بأبعاد 52.5 في 25.4 mm، بصفّي رؤوس من خمسة عشر طرفًا يبعد كل منهما عن الآخر 0.9 inch، فتجلس فوق القناة الوسطى للوحة التجارب تاركة صفًا حرًا في كل جانب. الصفحة المرجعية هي نموذج ESP32-C6.
الرؤوس بترتيب دليل المستخدم الخاص بـ Espressif للوحة، مع الهوائي في الأعلى. J1 على اليسار نزولًا: 3V3، RST، 4، 5، 6، 7، 0، 1، 8، 10، 11، 2، 3، 5V، G. وJ3 على اليمين نزولًا: G، TX، RX، 15، 23، 22، 21، 20، 19، 18، 9، G، 13، 12، G. TX وRX هما GPIO 16 و17. في كل رأس ثقب سادس عشر غير موصول لا يرسمه Mokxi. لا يوجد GPIO 14 في أي من الرأسين. في المخطط تكون الأراضي GND وGNDb وGNDd وGNDc من الأعلى إلى الأسفل، لأن اسم كل طرف فريد.
المشروع المحفوظ قبل أن يرسم Mokxi الترتيب الحقيقي (أواخر أكتوبر 2026) له J3 بترتيب آخر (GPIO 9 و12 و13 وGPIO 14 قرب الأعلى) مع تبديل 5V وGND في أسفل J1. يُفتح بهذه الطريقة، مع إعداد header على early، فتبقى كل لوحة جالسة في لوحة التجارب بأطرافها في الثقوب نفسها. اضبط header على board للحصول على الترتيب الحقيقي: الأسلاك المتصلة بالأطراف تتبعها، وسلك متصل بـ 14 يُترك لأن اللوحة الحقيقية لا تملك هذا الطرف، واللوحة الجالسة في لوحة تجارب تصل حينها إلى ثقوب مختلفة.
النواة عالية الأداء هي التي يشغّلها Mokxi: RV32IMC عند 160 MHz، تعليمة واحدة لكل دورة، نفس hart الخاص بالـ C3.
كيف يختلف عن الـ C3
أربعة أمور، وليس منها مجموعة التعليمات.
- واحد وثلاثون GPIO بدلًا من اثنين وعشرين، مرقمة من 0 إلى 30. GPIO 24 وما فوق هي فلاش SPI وليست في أي من الرأسين.
- 512 KB من SRAM في نافذة واحدة. على الـ C3 تظهر ذاكرة RAM نفسها مرتين، مرة لكل ناقل؛ هنا يصل الناقلان إليها بالعناوين نفسها، ولهذا يصبح سكربت الوصلات أبسط ولا تحتاج
.dataإلى نسخ عند إعادة التشغيل. - LED RGB قابل للعنونة على GPIO 8، حيث تحتوي C3-DevKitM-1 على واحد أيضًا لكن LED العادي هو ما تقوده معظم الأكواد.
- مقبسا USB-C. أحدهما متصل بجسر USB-to-UART، وهو ما تتحدث إليه الشاشة التسلسلية؛ والآخر متصل بمنفذ USB الخاص بالشريحة نفسها، والذي لا ينمذجه Mokxi.
ملف ELF مبني للـ C3 لن يعمل هنا ولن يعرضه عليك المحرر: مجموعة التعليمات نفسها، لكن خريطة الذاكرة مختلفة.
The RGB LED
الطرف GPIO 8 هو WS2812 المدمج في اللوحة نفسها. يحتاج إلى أربع وعشرين بتة وليس إلى مستوى، لذلك لا تفسّره قطعة اللوحة: فـ WS2812 بروتوكول. وصّل قطعة WS2812 بالطرف GPIO 8 وستحصل على ألوان حقيقية.
برنامج Rainbow المدمج يفعل ذلك تمامًا، مولّدًا عرض النبضات بتًا بتًا من حلقة معدّادة. هذا ليس اختصارًا هنا: فالوحدة الطرفية RMT التي تقود ذلك عادةً غير مُحاكاة.
الأطراف التناظرية
الأطراف من GPIO 0 إلى GPIO 6 هي قنوات ADC1 من 0 إلى 6، وanalogRead() على أي منها يعطي قياسًا حقيقيًا للجهد على الطرف: اثنا عشر بتًا، من 0 إلى 4095، مقابل مدى كامل تحدده قيمة التوهين. القيمة الافتراضية هي 11 dB، أي نحو كامل خط 3.3 V، لذا فالمقاومة المتغيرة أو عصا التحكم الموصولة عبر مصدر التغذية تغطي المدى بأكمله؛ الدالة analogSetPinAttenuation() تقبل ADC_0db (1.1 V) أو ADC_2_5db (1.5 V) أو ADC_6db (2.2 V) أو ADC_11db، أما analogReadResolution() فتغيّر عدد بتات الناتج إذا أردت استعادة عشرة بتات كما في لوحة Uno.
تكلّف القراءة الواحدة نحو خمس ميكروثوانٍ من وقت المحاكاة، وهو ما يستغرقه المحوّل. الطرف غير الموصول يقرأ 0 بدل الضجيج. سبعة مداخل تناظرية لا أكثر: أي طرف آخر يقرأ 0 أيضًا.
PWM
تعمل الدالة analogWrite(pin, 0..255) على أي طرف GPIO. يأتي المخرج من LEDC، متحكم PWM الخاص بالـ LED في الشريحة، ويصل إلى الطرف عبر مصفوفة GPIO، لذا لا توجد مجموعة أطراف ~ ثابتة كما هو الحال في Uno.
الافتراضي هو ثمانية بتات عند 1 kHz. عندما تكون للتردد أهمية (محرك السيرفو يريد خمسين إطارًا في الثانية وعرض نبضة، لا نسبة واجب)، استخدم الصيغة الخاصة بـ ESP32:
ledcAttach(4, 50, 14); // fifty frames a second, 16384 counts each
ledcWrite(4, 1229); // 1.5 ms of a 20 ms frame: the middle
هناك ست قنوات وأربع مؤقتات. القنوات التي تطلب التردد والدقة نفسيهما تتشارك مؤقتًا واحدًا، فستة أطراف تخفت معًا تستهلك واحدًا من الأربعة؛ اطلب زوجًا خامسًا مختلفًا وستعيد ledcAttach القيمة false بدل إعادة ضبط مؤقت يعتمد عليه طرف آخر. pinMode() وdigitalWrite() تستعيدان الطرف من LEDC، فالطرف الذي كان يخفت ثم كُتب إليه يُكتب إليه فعلًا.
قيمة دورة 0 تعني مستوى منخفضًا ثابتًا وقيمة 255 تعني مستوى مرتفعًا ثابتًا، من العتاد مباشرة، دون أي حواف، ما يعني أيضًا أنه لا شيء يوقظ اللوحة في المحاكي.
WiFi, simulated
لا يوجد راديو. ولن يكون هناك أبدًا: فطبقة MAC الخاصة بمعيار 802.11 ليست شيئًا يمكن لهذا النموذج أن يعيد إنتاجه بأمانة.
ما يوجد بدلًا من ذلك هو شبكة محاكاة. كتلة تخص Mokxi نفسه لا الشريحة (صندوق بريد عند 0x6FFF_E000، حيث لا توجد في C6 الحقيقي أي عناوين معيّنة أصلًا) توفّر WiFi.h وHTTPClient.h وWebServer.h، لذا فالكود المكتوب بلغة Arduino الذي تعطيك إياه أي دروس يعمل هنا: تنضم اللوحة إلى نقطة وصول اسمها وكلمة مرورها خاصيتان من خصائص اللوحة، وWiFi.status() تمرّ بالحالات نفسها خلال ثانية إلى ثلاث ثوانٍ، ويمنحها DHCP العنوان 192.168.4.2، ويمكن للكود أن يجلب صفحة أو يقدّم واحدة.
ما يقف خلف ذلك هو برمجية، ولا شيء مخفي في هذا الأمر. لا يوجد 802.11، ولا قناة، ولا بحث عن الشبكات، ولا WPA2، ولا TCP، ولا TLS و لا إنترنت حقيقي: أربعة أسماء اخترعناها تحت .mokxi تُحلّ ولا غيرها، ولا شيء يفعله الكود يستطيع الوصول إلى الشبكة التي يعمل عليها متصفحك. WiFiClientSecure يترجم ثم يفشل، قائلًا إن TLS غير مُحاكى. لوحتا Web و Cloud على طول أسفل المحرر تُفتحان بهذه الجملة ولا تُمرّرها بعيدًا.
الاستثناء الوحيد هو إنترنت حقيقي، مفتاح في لوحة Cloud لأي شخص سجّل دخوله (المزيد منه مع Pro) يكون مغلقًا في كل مرة تُحمَّل فيها الصفحة. عند تشغيله، يخرج طلب اسم خارج .mokxi,
https:// مشمولًا، يخرج عبر بوابة Mokxi وتعود الإجابة إلى الكود. انظر إنترنت حقيقي.
تأتي مع هذه اللوحة ثلاثة أمثلة: WiFi: الانضمام إلى الشبكة و WiFi: جلب حالة الطقس و WiFi: مصباح على صفحة ويب.
WiFi، محاكى هو كيفية استخدامه؛ وWiFi المحاكى هو العقد، حدًّا بعد حد.
ما لا يملكه هذا النموذج
أكثر من المعتاد، والعقد يذكر ذلك صراحةً بدل اختراع إزاحات سجلات لا يمكنه ضمانها.
- لا راديو. لا 802.11، ولا راديو Bluetooth LE، ولا Thread أو Zigbee. الـ WiFi فوقه محاكى ويقول ذلك، وكذلك Bluetooth LE، عبر هاتف في لوحة البلوتوث بالمحرّر (البلوتوث، محاكى).
- لا نواة منخفضة الاستهلاك. نطاق LP في C6 هو نصف ما يجعل الشريحة مثيرة للاهتمام، ولا شيء منه موجود هنا.
- لا RMT، وهي ما كان يقود LED RGB عادةً، ولا شيء من SAR ADC إلا مسار القراءة الأحادية لـ ADC1، ولا شيء من LEDC خارج مؤقتاته وقنواته.
- خمسة من العناوين الأساسية للنموذج (GPIO وIO_MUX وSYSTIMER وLEDC وSAR ADC) هي أفضل تقدير له وليست شيئًا يستطيع ضمانه، وكذلك أرقام إشارات مصفوفة GPIO التي تستخدمها قنوات LEDC. إنها معرّفة في ملف ترويسة واحد، فالصورة التي ستُنقل إلى سيليكون حقيقي لديها قائمة قصيرة من
#defineللتحقق منها. القسم 7 من الصفحة المرجعية هو القائمة، والقسمان 3.6 و3.7 يميّزان أحدث كتلتين سجلًا سجلًا.
The firmware
تسعة برامج مدمجة: Blink وButton (زر BOOT على GPIO 9) والتسلسلي وFade وWiFi: join the network وWiFi: fetch the weather وWiFi: a lamp on a web page وعصا تحكم وRainbow.
برنامج Fade يجعل LED على GPIO 10 يتنفس باستخدام analogWrite، فيصدر الشكل الموجي من العتاد وينام الجوهر بين الخطوات. أما عصا تحكم فيقرأ KY-023 على قناتي ADC1 رقم 0 و1، ويطبع المحورين، ويضيء LED في الجهة التي تدفع نحوها بالقدر نفسه الذي تدفع به: كود واحد يستخدم الوحدتين الطرفيتين اللتين نشأت هذه اللوحة معهما.
Serial هو UART0 ويذهب إلى الشاشة التسلسلية. delay() توقف الجوهر على منبّه SYSTIMER بدل الدوران، لذا فالكود الخامل لا يكلّف المحاكي شيئًا تقريبًا.
مكتبات Arduino الرسمية
درس تعليمي يضم Servo.h وWire.h وSPI.h وEEPROM.h وLiquidCrystal_I2C.h وAdafruit_GFX.h مع Adafruit_SSD1306.h وAdafruit_NeoPixel.h وESP32Servo.h وDHT.h يُترجم هنا كما هو. كل واحد منها ملف ترويسة خاص بـ Mokxi بالاسم الأصلي، مكتوب فوق مشغّلات القطع في الصندوق، ولا شيء منه كود المكتبة الأصلية.
Wire.begin()تضع ناقل I2C على GPIO23(SDA) وGPIO22(SCL)؛ وWire.begin(sda, scl)تنقله.- تعمل المكتبة
EEPROM.h، لكن نموذج هذه اللوحة لا يحتوي EEPROM ولا فلاش قابلًا للكتابة، لذلك تُخزَّن البايتات في 4 KB من الذاكرة RAM: يمكن قراءتها مرة أخرى خلال التشغيل نفسه، لكنها تضيع عند إعادة الضبط.
يسرد محرر الكود والترجمة ما يغطيه كل منها وكيف يختلف عن المكتبة الأصلية.
MicroPython
اختر MicroPython (main.py) في لوحة البرنامج الثابت للوحة، وزر التشغيل يشغّل البرنامج الثابت الرسمي MicroPython v1.29.0 لـ ESP32-C6 مع main.py، على نموذج للشريحة كاملة يُقلع من ROM خاص بـ Espressif نفسها. machine.Pin, PWM,
ADC, I2C, SPI, UART(1) و neopixel العمل، و network.WLAN ينضم إلى الشبكة المحاكاة. انظر
MicroPython على ESP32.
أي لوحة هذه؟
إنها ESP32-C6-DevKitC-1. ليست C6-DevKitM-1، ولا وحدة مجردة على حاملة من صنعك، وليست نسخ C6 Mini. أرقام GPIO هي أرقام الشريحة نفسها وستكون متطابقة، لكن ترتيب الرؤوس لن يكون كذلك.
Related
- صفحة اللوحة: /boards/esp32-c6
- وثيقة العقد: ESP32-C6 model
- الشريحة نفسها بحجم مصغّر: XIAO ESP32-C6
- اللوحة التي نشأت منها: ESP32-C3
- مشاريع للبداية: ESP32-C6 fade وESP32-C6 rainbow