> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# المخطط الكهربائي Schematic مع KiCad لأول لوحة لك
- URL: https://arabroot.io/articles/المخطط-الكهربائي-schematic-مع-kicad-لاول-لوحة-لك/
- Published: 2026-11-06T01:54:31.000Z
- Updated: 2026-11-11T07:53:22.000Z
- Description: نصمم في KiCad 10 من سطر الأوامر مخطط لوحة حرارة صغيرة فيها معالج ESP32-C3 مع منفذ USB-C، ثم نفحصه ونستخرج منه قائمة التوصيلات والقطع قبل رسم اللوحة.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, الإلكترونيات والطائرات المسيرة والطباعة ثلاثية الأبعاد, KiCad

لنفرض أنك في شركة ناشئة تراقب حرارة مستودعات الأدوية، وأول نموذج للجهاز كان لوحة تطوير ESP32 مشتراة من متجر إلكترونيات، وعليها حساس حرارة موصول بأسلاك قفز Jumper Wires، كلها داخل علبة بلاستيكية مثبتة بشريط لاصق. والنموذج يعمل، والعميل الأول راض، ثم جاء طلب بخمسين جهازاً، وبدأت المشاكل التي لم تظهر في جهاز واحد: سلك يخرج من مكانه أثناء الشحن، ولوحة التطوير أكبر من العلبة التي اختارها المصمم، وعليها قطع لا تحتاجها مثل شريحة تحويل USB إلى منفذ تسلسلي، وسعرها مضروباً في خمسين أصبح رقماً يلاحظه المدير المالي. وفي الاجتماع قال أحدهم الجملة التي يقولها كل فريق في هذه المرحلة: «نحتاج لوحتنا الخاصة». وأول خطوة في هذا الطريق ليست اللوحة نفسها، وإنما المخطط الكهربائي Schematic.

في هذا المقال سوف نصمم مخطط لوحة صغيرة حقيقية اسمها TH-1: مدخل USB-C للطاقة والبيانات، ومنظم جهد 3.3 فولت، ووحدة ESP32-C3، وحساس حرارة رقمي على I2C، وزرا إعادة التشغيل والإقلاع، ومصباح ومنفذ تسلسلي للتصحيح. وسوف نستخدم KiCad 10 من سطر الأوامر داخل Docker، فنكتب المخطط ونفحصه بفحص القواعد الكهربائية ERC ونستخرج منه قائمة التوصيلات Netlist وقائمة القطع BOM وملف PDF، ونرتكب أخطاء حقيقية لنرى كيف يكتشفها KiCad وكيف لا يكتشفها. و[المقال التالي](https://arabroot.io/articles/%D8%AA%D8%B5%D9%85%D9%8A%D9%85-%D8%A7%D9%84%D9%84%D9%88%D8%AD%D8%A9-%D8%A7%D9%84%D9%85%D8%B7%D8%A8%D9%88%D8%B9%D8%A9-pcb-%D9%85%D8%B9-kicad-%D8%AB%D9%85-%D8%B7%D9%84%D8%A8-%D8%AA%D8%B5%D9%86%D9%8A%D8%B9%D9%87%D8%A7/) في هذه المرحلة يأخذ المخطط نفسه إلى اللوحة المطبوعة PCB وطلب تصنيعها.

وسوف نناقش في هذا المقال ما يلي:

- لماذا تنتقل الشركات من لوحة التطوير إلى لوحتها الخاصة، وماذا تكسب وماذا تخسر.
- برنامج KiCad: من يطوره، ورخصته، وأجزاؤه، وأداة سطر الأوامر kicad-cli.
- المخطط الكتلي Block Diagram قبل الرسم، واختيار القطع من أوراق البيانات Datasheets.
- الفرق بين الرمز Symbol والبصمة Footprint والشبكة Net.
- تجربة عملية: مخطط TH-1 جزءاً جزءاً، ثم فحص ERC بخطأين حقيقيين وإصلاحهما، ثم ماذا يحدث إذا أخطأت في كتابة اسم إشارة واحدة.
- تصدير Netlist وBOM وPDF، ووضع الفحص في خط CI.
- مراجعة المخطط Design Review: ما لا يكتشفه أي فحص آلي، والأخطاء الشائعة، وقائمة تحقق.

## من لوحة التطوير Dev Board إلى لوحتك الخاصة

لوحة التطوير مثل التي في الصورة صممت لتجرب عليها كل شيء: فيها وحدة المعالج، وشريحة تحويل USB إلى منفذ تسلسلي، ومنظم جهد، وأزرار، ومصابيح، وصفان من الأطراف لكل منافذ المعالج. وهذا ممتاز في المختبر، ولكنه في المنتج يعني قطعاً تدفع ثمنها ولا تستخدمها، وحجماً أكبر من حاجتك، وتوصيلات بأسلاك تتحرك مع الاهتزاز، ولوحة صممها شخص آخر لا تعرف كيف اختار قطعها ولا هل سوف تبقى متوفرة بعد سنة.

واللوحة الخاصة تحل هذا كله: تضع فقط ما تحتاجه، بالشكل الذي يناسب علبتك، وتوصيلات مطبوعة على النحاس لا تتحرك، وقائمة قطع تعرف كل سطر فيها ومصدره. والثمن الذي تدفعه هو أن التصميم أصبح مسؤوليتك: إذا نسيت مقاومة واحدة على طرف إقلاع فلن يعمل أي جهاز من الخمسين، وإذا اخترت قطعة توقف إنتاجها فسوف تعيد التصميم. ولهذا يبدأ المهندسون بالمخطط ويراجعونه بعناية قبل أي شيء آخر، لأن الخطأ في المخطط يكلف تعديلاً في ملف، والخطأ نفسه بعد التصنيع يكلف دفعة كاملة من اللوحات. وفي شركة ناشئة قد تعني الدفعة الخاطئة أسابيع من التأخير مع العميل، لأن الدفعة التالية تحتاج تصنيعاً وشحناً من جديد.

ومتى لا تصمم لوحتك؟ عندما تكون الكمية صغيرة جداً، عشرة أجهزة مثلاً، والعلبة تتسع للوحة تطوير، والجهاز لن يباع لعملاء بل يستخدم داخلياً، فغالب الظن أن لوحة التطوير مع لوحة صغيرة بسيطة تحمل الحساس والموصلات تكفيك، وتوفر عليك وقت التصميم والمراجعة وأخطاء الدفعة الأولى. أما عندما يصبح الجهاز منتجاً يباع، فالمطابقة وشهادات الأجهزة قبل البيع، وحجم العلبة، وكلفة القطعة الواحدة، كلها تدفعك إلى لوحتك الخاصة عاجلاً أو آجلاً.

![لوحة تطوير سوداء عليها وحدة ESP-C3-32S بغطاء معدني فضي في الأعلى، وتحتها مصباح RGB، ومنظم جهد AMS1117، وشريحة CH340C لتحويل USB، وزران صغيران، ومنفذ Micro USB في الأسفل، وصفان من الأطراف على الجانبين](https://arabroot.io/content/images/2026/11/kicad-schematic-11-devkit-photo-1.webp)

لوحة تطوير ESP32-C3: الوحدة في الأعلى، وتحتها منظم الجهد وشريحة تحويل USB والزران، وكل ما تحتاجه لوحة TH-1 موجود فيها مع قطع لا تحتاجها. الصورة: Popolon، رخصة CC BY-SA 4.0، [ويكيميديا كومنز](https://commons.wikimedia.org/wiki/File:ESP32-C3%5FRISC-V%5FNodeMCU%5Fboard.jpg?ref=arabroot.io)

## برنامج KiCad: أدوات التصميم المفتوحة

[KiCad](https://www.kicad.org/?ref=arabroot.io) مجموعة برامج لتصميم الدوائر الإلكترونية، تبدأ بمحرر المخطط Schematic Editor وتنتهي بمحرر اللوحة المطبوعة PCB Editor وعارض ثلاثي الأبعاد، وتقول [صفحة الرخص](https://www.kicad.org/about/licenses/?ref=arabroot.io) إن معظم الكود منشور برخصة GPL الإصدار 3 أو أحدث، وإن مكتبات الرموز والبصمات منشورة برخصة CC-BY-SA 4.0\. والإصدار الرئيسي الحالي هو العاشر، وأعلن المشروع [صدور 10.0.0](https://www.kicad.org/blog/2026/03/Version-10.0.0-Released/?ref=arabroot.io) في 20 مارس 2026 بحسب تاريخ النشر في الصفحة، ويقول الإعلان إن المشروع يصدر إصداراً رئيسياً كل سنة، ثم تأتي إصدارات الإصلاح، وآخرها وقت كتابة المقال 10.0.8 الذي [أعلن عن نسخته التجريبية](https://www.kicad.org/blog/2026/10/KiCad-Version-10.0.8-Release-Candidate-1-Available/?ref=arabroot.io) في أكتوبر 2026، ونشر Docker Image الرسمي له على [Docker Hub](https://hub.docker.com/r/kicad/kicad?ref=arabroot.io) في 30 أكتوبر 2026.

وقد يتساءل البعض: لماذا KiCad وليس برنامجاً تجارياً؟ والإجابة أن البرامج التجارية الكبيرة ممتازة ولها مكانها في الشركات التي تصمم لوحات معقدة بفرق كبيرة، ولكن KiCad يغطي ما تحتاجه شركة ناشئة ولوحات بطبقتين أو أربع، وملفاته نصية يمكن أن تضعها في Git وتراجع تغييراتها، ولا توجد رخصة تنتهي، ومصانع اللوحات تقبل مخرجاته مباشرة. والأهم لمقالنا أن فيه أداة سطر أوامر اسمها `kicad-cli` يشرحها [توثيقها الرسمي](https://docs.kicad.org/10.0/en/cli/cli.html?ref=arabroot.io)، تفحص المخطط واللوحة وتصدر منهما كل الملفات دون أن تفتح أي واجهة، وهذا ما يجعل KiCad يعمل في خط CI كما يعمل أي مشروع برمجي.

وعندما تثبت KiCad على جهازك سوف تجد مجموعة برامج تعمل معاً حول ملف المشروع `.kicad_pro`: محرر المخطط، ومحرر اللوحة، ومحرر الرموز Symbol Editor لترسم رمزاً غير موجود في المكتبة، ومحرر البصمات Footprint Editor، وعارض ملفات Gerber لتتأكد مما سوف يصل إلى المصنع، وآلة حاسبة للقيم الشائعة مثل عرض المسار المناسب لتيار معين. وفي محرر المخطط نفسه محاكي دوائر مبني على SPICE، ولهذا ترى في قائمة الفحوص المتجاهلة سطراً عن نماذج SPICE. وكل هذه البرامج تقرأ المكتبات نفسها، وهي في الـ Container داخل المجلدين `/usr/share/kicad/symbols` و`/usr/share/kicad/footprints`، وكل مكتبة ملف نصي بالصيغة نفسها التي سوف تراها في ملف المخطط. وهذا يعني أن الرمز الذي تحتاجه لقطعة جديدة يمكن أن تكتبه أو تراجعه كنص، كما تراجع أي كود، وأن الشركة تستطيع أن تحتفظ بمكتبة خاصة بها في مستودع Git مستقل، فيه فقط القطع التي اعتمدها مهندسوها، وهذا ما تفعله الفرق التي تصمم لوحات كثيرة حتى لا يختار كل مهندس مقاومة من مكان مختلف.

## قبل الرسم: المخطط الكتلي Block Diagram، ثم اختيار القطع

المهندس المبتدئ يفتح محرر المخطط ويبدأ يضع القطع، والمهندس الذي صمم لوحات من قبل يبدأ بورقة. والسبب أن المخطط الكهربائي يجيب عن سؤال «كيف أوصل هذه القطع؟»، بينما السؤال الأول هو «ما القطع التي أحتاجها ولماذا؟»، والمخطط الكتلي هو الجواب عن السؤال الأول. ولوحة TH-1 تحتاج هذه الكتل:

![مخطط كتلي: موصل J1 USB-C يرسل VBUS 5 V بسهم أحمر إلى منظم U2 AP2112K-3.3، ومنه +3V3 بسهم برتقالي إلى وحدة U1 ESP32-C3-WROOM-02، وسهم أزرق USB D+ / D- من الموصل إلى الوحدة، وسهمان أخضران SDA IO5 و SCL IO6 بين الوحدة والحساس U3 TMP1075 عند 0x48، وتحت الموصل مقاومتا R1 و R2 5.1k، ومربع ما حول المعالج: EN و IO9 و IO10](https://arabroot.io/content/images/2026/11/kicad-schematic-01-block-1.webp)

المخطط الكتلي للوحة TH-1: الطاقة من اليسار إلى اليمين، والبيانات بين الكتل، وما يحتاجه المعالج حوله

- **الطاقة والبيانات من USB-C:** موصل USB-C يعطي 5 فولت على خط VBUS، ولكن المصدر حسب مواصفة [USB Type-C](https://www.usb.org/usb-type-cr-cable-and-connector-specification?ref=arabroot.io) لا يعطي الجهد إلا إذا رأى على خطي التهيئة CC1 وCC2 مقاومة سحب إلى الأرضي Pull-down قيمتها 5.1 كيلو أوم، وهي الطريقة التي يقول بها الجهاز «أنا جهاز وليس مصدراً». ونسيان هاتين المقاومتين من أشهر الأخطاء في اللوحات الأولى: الجهاز يعمل مع شاحن قديم بموصل USB-A إلى C، ولا يعمل مع شاحن USB-C إلى C.
- **منظم الجهد LDO:** المعالج والحساس يعملان على 3.3 فولت، واخترنا المنظم الخطي AP2112K-3.3، وتقول [ورقة بياناته](https://www.diodes.com/assets/Datasheets/AP2112.pdf?ref=arabroot.io) إنه يعطي 600 ملي أمبير على الأقل، وإن انخفاض الجهد Dropout عند 3.3 فولت وتيار 600 ملي أمبير حوالي 250 ملي فولت، وإن الشركة توصي بمكثفات خزفية 1 ميكروفاراد من نوع X5R أو X7R على الدخل والخرج. والمنظم الخطي يحول الفرق بين 5 و3.3 فولت إلى حرارة، وهذا مقبول لجهاز يأخذ عشرات الملي أمبير معظم الوقت، أما جهاز يعمل ببطارية فقد يحتاج منظماً تبديلياً Switching Regulator أكثر كفاءة.
- **المعالج:** وحدة ESP32-C3-WROOM-02 من Espressif، وهي وحدة Module فيها المعالج والذاكرة والهوائي وشهادات الراديو جاهزة، وهذا قرار مهم: تصميم دائرة الراديو والهوائي بنفسك عمل اختصاصي، والوحدة الجاهزة تختصره، وأوراقها في [ورقة بيانات الوحدة](https://www.espressif.com/sites/default/files/documentation/esp32-c3-wroom-02%5Fdatasheet%5Fen.pdf?ref=arabroot.io) و[ورقة بيانات المعالج](https://www.espressif.com/sites/default/files/documentation/esp32-c3%5Fdatasheet%5Fen.pdf?ref=arabroot.io).
- **الحساس:** TMP1075 من Texas Instruments، وتقول [صفحته](https://www.ti.com/product/TMP1075?ref=arabroot.io) إن دقته النموذجية ±0.25 درجة من −55 إلى 125، وإن جهد تشغيله من 1.62 إلى 5.5 فولت، ويتصل عبر I2C، وفي غلاف SOIC بثمانية أطراف يسهل لحامه. وجدول العناوين في [ورقة بياناته](https://www.ti.com/lit/gpn/tmp1075?ref=arabroot.io) يعطي العنوان 1001000 أي 0x48 عندما تكون أطراف العنوان الثلاثة على الأرضي.

ولاحظ أننا لم نختر أي قطعة لأنها «الأفضل»، وإنما لأن كل واحدة تجيب عن متطلب واضح ومكتوب في ورقة بياناتها، وهذا ما يجب أن تفعله مع كل قطعة: افتح ورقة البيانات، واقرأ قسم التطبيق النموذجي Typical Application، فهناك سوف تجد المكثفات والمقاومات التي يحتاجها المصنع، وغالباً ما يكون مخططك نسخة من هذا القسم مع تعديلات قليلة.

## الرمز Symbol، والبصمة Footprint، والشبكة Net

هذه ثلاثة مفاهيم يخلط بينها كل من يبدأ، والفرق بينها هو مفتاح فهم KiCad كله:

- **الرمز Symbol:** الرسم الذي تضعه في المخطط، مستطيل بأطراف لها أسماء وأرقام وأنواع، مثل TMP1075 بأطرافه SDA وSCL وA0\. والرمز لا يعرف شكل القطعة الحقيقي ولا حجمها.
- **البصمة Footprint:** مواضع اللحام على النحاس بالمليمتر، مثل `SO-8_3.9x4.9mm_P1.27mm` أي ثمانية أطراف بمسافة 1.27 مليمتر. والبصمة لا تعرف أسماء الأطراف، وإنما أرقام الوسائد Pads فقط.
- **الشبكة Net:** مجموعة الأطراف المتصلة ببعضها، مثل شبكة SDA التي تربط الطرف 4 في المعالج بالطرف 1 في الحساس وبالطرف 2 في مقاومة الرفع. والشبكات هي الشيء الوحيد الذي ينتقل من المخطط إلى محرر اللوحة، في ملف اسمه قائمة التوصيلات Netlist.

![ثلاث بطاقات: Symbol فيها رمز بأطراف A0 و A1 و A2 و SDA و SCL واسم Sensor_Temperature:TMP1075D، ثم Footprint فيها ثماني وسائد ذهبية واسم Package_SO:SO-8_3.9x4.9mm_P1.27mm، ثم Netlist فيها /SDA R3.2 U1.4 U3.1 و /SCL R4.2 U1.5 U3.2 و GND و +3V3، وتحتها شريط يقول إن رقم الطرف هو الجسر بين الرمز والبصمة](https://arabroot.io/content/images/2026/11/kicad-schematic-02-symbol-footprint-1.webp)

الرمز للمخطط، والبصمة للوحة، وقائمة التوصيلات هي ما يربطهما، ورقم الطرف هو الجسر

والجسر بين الرمز والبصمة هو رقم الطرف: الطرف 1 في الرمز يجب أن يكون الوسادة 1 في البصمة. ومكتبات KiCad الرسمية متسقة في هذا، ولكن عندما ترسم رمزاً بنفسك أو تستخدم بصمة من مصدر آخر، فقد يكون الطرف 1 عند الشركة المصنعة هو الوسادة 3 عند من رسم البصمة، وعندها تخرج لوحة سليمة الشكل خاطئة التوصيل، ولا يوجد فحص في المخطط يكتشف ذلك، لأن المخطط نفسه صحيح. وهذا من أهم أسباب أن تعتمد على المكتبات الرسمية ما استطعت.

## التجربة العملية: مخطط TH-1 مع kicad-cli في Docker

نستخدم Docker Image الرسمي `kicad/kicad:10.0.8`، وحجمه المضغوط قرابة 812 ميجابايت وعلى القرص قرابة 3.5 جيجابايت، وفيه KiCad كاملاً مع مكتبات الرموز والبصمات، دون نماذج ثلاثية الأبعاد، فهذه في النسخة `10.0.8-full`:

```bash
docker pull kicad/kicad:10.0.8
docker run --rm kicad/kicad:10.0.8 sh -c 'kicad-cli version; ls /usr/share/kicad/symbols | wc -l; ls /usr/share/kicad/footprints | wc -l; id'
```

```text
10.0.8
224
155
uid=1000(kicad) gid=1000(kicad) groups=1000(kicad),27(sudo)
```

أي 224 مكتبة رموز و155 مكتبة بصمات، والأوامر تعمل بالمستخدم `kicad` وليس root.

### المخطط ملف نصي Schematic as Code: لماذا نكتبه بكود؟

ملف المخطط `.kicad_sch` نص بصيغة S-expression، أي أقواس متداخلة مثل Lisp، وفيه نسخة من كل رمز مستخدم، ثم كل قطعة بموضعها وخصائصها، ثم الأسلاك Wires والأسماء Labels. والمهندس عادة يرسم المخطط بالفأرة في الواجهة، ولكن في هذا المقال كتبنا سكربت Python صغيراً اسمه `make_sch.py` يولد الملف من جدول، لسببين: أن كل خطوة في المقال تصبح قابلة للتكرار حرفياً على جهازك، وأن الجدول نفسه يوضح المخطط أكثر من أي صورة. والملف الذي يخرج ملف KiCad عادي، تستطيع أن تفتحه في الواجهة وتكمل عليه بالفأرة. وهذا جزء من الجدول:

```python
PARTS = [
    ("J1", "Connector:USB_C_Receptacle_USB2.0_16P", "USB_C", "Connector_USB:USB_C_Receptacle_HRO_TYPE-C-31-M-12", (45.72, 96.52),
     {"A1": "GND", "A12": "GND", "B1": "GND", "B12": "GND", "SH": "GND", "A4": "VBUS", "A9": "VBUS", "B4": "VBUS", "B9": "VBUS",
      "A5": "CC1", "B5": "CC2", "A6": "USB_DP", "B6": "USB_DP", "A7": "USB_DN", "B7": "USB_DN", "A8": "NC", "B8": "NC"},
     {"MPN": "TYPE-C-31-M-12"}),
    ("R1", "Device:R", "5.1k", P, (78.74, 124.46), {"1": "CC1", "2": "GND"}, {}),
    ("R2", "Device:R", "5.1k", P, (91.44, 124.46), {"1": "CC2", "2": "GND"}, {}),
    ("U2", "Regulator_Linear:AP2112K-3.3", "AP2112K-3.3", "Package_TO_SOT_SMD:SOT-23-5", (116.84, 48.26),
     {"1": "VBUS", "3": "VBUS", "2": "GND", "5": "+3V3", "4": "NC"}, {"MPN": "AP2112K-3.3TRG1"}),
    ...
]
```

كل سطر قطعة: المرجع Reference، والرمز من المكتبة، والقيمة، والبصمة، والموضع على الورقة بالمليمتر، ثم قاموس يقول لكل رقم طرف أي شبكة يتصل بها، و`"NC"` تعني أن الطرف غير موصول عمداً No Connect. والسكربت يقرأ تعريف كل رمز من مكتبات KiCad داخل الـ Container، ويحسب موضع كل طرف، ويضع عنده سلكاً قصيراً ثم اسم الشبكة، أو رمز طاقة مثل GND و+3V3 وVBUS. وهذه طريقة رسم معروفة يستخدمها كثير من المصممين: بدل أن تمد أسلاكاً طويلة متشابكة عبر الورقة، تعطي كل إشارة اسماً، وكل طرفين لهما الاسم نفسه متصلان.

```bash
docker run --rm -v "$PWD:/lab" -w /lab kicad/kicad:10.0.8 python3 make_sch.py
```

```text
wrote th1/th1.kicad_sch: 24 parts, 37 power symbols, flags=True
```

### ماذا يوجد داخل الملف Inside .kicad\_sch؟

لأن الملف نص، فمن المفيد أن تعرف شكله مرة واحدة، فهذا ما سوف تراه في أي مراجعة Git لمخطط KiCad. وهذا تعريف المقاومة R3 كما كتبه السكربت في `th1.kicad_sch`، مختصراً على أهم أجزائه:

```text
(symbol
	(lib_id "Device:R")
	(at 228.60 106.68 0)
	(unit 1)
	(in_bom yes)
	(on_board yes)
	(dnp no)
	(uuid "144a92f8-c87f-53cc-8844-0c33d6ef76c0")
	(property "Reference" "R3" ...)
	(property "Value" "4.7k" ...)
	(property "Footprint" "Resistor_SMD:R_0603_1608Metric" (hide yes) ...)
	(pin "1" (uuid "24c6d7cf-7efe-521c-a512-813d4406f020"))
	(pin "2" (uuid "8fcbcd8f-cdce-5195-8a69-806392972e84"))
	(instances
		(project "th1"
			(path "/2a5992d9-8921-5aad-8d38-63d82b5666b2"
				(reference "R3")
				(unit 1)))))
```

وهذا اسم الشبكة SDA عند طرف المعالج:

```text
(label "SDA"
	(at 162.56 104.14 180)
	(effects (font (size 1.27 1.27)) (justify right bottom))
	(uuid "bf918310-be15-509e-84e2-8104aa0a849f"))
```

في الملف أعلاه لاحظ التالي:

- القطعة تشير إلى الرمز باسم المكتبة والرمز `Device:R`، ونسخة الرمز نفسه في قسم `lib_symbols` في أول الملف، وفي مخططنا 13 رمزاً مضمناً لـ 24 قطعة، لأن المقاومات كلها تستخدم رمزاً واحداً.
- الخيارات `in_bom` و`on_board` و`dnp` تقرر هل تظهر القطعة في قائمة القطع، وهل تنتقل إلى اللوحة، وهل تركب أم تترك مكانها فارغاً Do Not Populate، وهذا مفيد لقطعة اختيارية تضع مكانها في اللوحة ولا تركبها في كل نسخة.
- لكل شيء معرف فريد UUID، وقسم `instances` يربط القطعة بالمشروع والورقة، وهذا ما يسمح لـ KiCad أن يعرف أن R3 في المخطط هي R3 في اللوحة حتى لو غيرت اسمها لاحقاً. وفي السكربت ولدنا هذه المعرفات من أسماء ثابتة بالدالة `uuid5`، فإذا أعدت تشغيله لا يتغير الملف إلا حيث غيرت شيئاً، وهذا ما يجعل مراجعة الفروق في Git مقروءة.
- الإحداثيات بالمليمتر على الورقة، ونقاط الأطراف على شبكة 1.27 مليمتر، والسكربت يحسب طرف المقاومة من موضعها ومن تعريف الرمز: الطرف 1 في الرمز عند `(0, 3.81)`، والمحور الرأسي في الرمز يكبر إلى الأعلى بينما يكبر في الورقة إلى الأسفل، فيصبح الطرف عند `(228.60, 102.87)`.

### مشكلة حقيقية: رمز مشتق Derived Symbol بلا أطراف

بعض رموز المكتبة لا تعرف رسمها بنفسها، وإنما ترث من رمز آخر، فالرمز `AP2112K-3.3` في مكتبة `Regulator_Linear` مكتوب فيه `(extends "AP2204K-1.5")`، أي أنه يأخذ رسم المنظم AP2204K وأطرافه ويغير الاسم والقيمة فقط. وملف المخطط يجب أن يحمل نسخة مسطحة كاملة من الرمز، فإذا نسخت الرمز كما هو من المكتبة، كما فعلت أول نسخة من السكربت لو شغلناها بالخيار `--no-flatten`، فهذا ما يقوله الفحص:

```text
[power_pin_not_driven]: Input Power pin not driven by any Output Power pins
    ; error
    @(142.24 mm, 44.45 mm): Symbol #PWR08 Pin 1 [Power input, Line]
[lib_symbol_mismatch]: Symbol 'AP2112K-3.3' doesn't match copy in library 'Regulator_Linear'
    ; warning
    @(116.84 mm, 48.26 mm): Symbol U2 [AP2112K-3.3]
```

المنظم ظهر في المخطط بلا أطراف، فلم يعد هناك ما يغذي شبكة +3V3، ولاحظ الفحص أيضاً أن النسخة في المخطط تختلف عن المكتبة. والفحص `lib_symbol_mismatch` مفيد جداً حتى لمن يرسم بالفأرة: إذا حدث أحد المكتبة بعد أن وضعت الرمز، أو عدلت الرمز في المخطط يدوياً، فهذا الفحص يخبرك أن ما في المخطط ليس ما في المكتبة.

### جزء الطاقة Power: الموصل والمنظم

![جزء من المخطط: الموصل J1 USB_C وأطرافه VBUS و CC1 و CC2 و D- و D+ وأسماء الشبكات USB_DN و USB_DP، وطرفا SBU1 و SBU2 بعلامة X، وتحته مقاومتا R1 و R2 5.1k، وفي الأعلى المنظم U2 AP2112K-3.3 وطرفاه VIN و EN موصولان معاً إلى VBUS، والمكثفان C1 و C2 1u، وعلامتا PWR_FLAG](https://arabroot.io/content/images/2026/11/kicad-schematic-04-sch-power-1.webp)

جزء الطاقة: الموصل ومقاومتا CC، والمنظم بمكثفي الدخل والخرج، وعلامتا PWR\_FLAG

في هذا الجزء لاحظ التالي:

- الموصل له أربعة أطراف VBUS وأربعة GND، وطرفان لكل من D+ وD-، لأن موصل USB-C يدخل بالاتجاهين، فالطرف A6 والطرف B6 كلاهما D+، ونوصلهما معاً حتى يعمل الكابل في الاتجاهين. وفي الرمز تتراكب الأطراف المتشابهة في نقطة واحدة، والسكربت يوصل النقطة مرة واحدة.
- الطرفان SBU1 وSBU2 لا نحتاجهما في USB 2.0، فعليهما علامة X أي No Connect، وهي تقول للفحص «تركته عمداً» بدل أن يظن أنك نسيته.
- طرف التفعيل EN في المنظم موصول بالدخل نفسه، فيعمل المنظم دائماً عندما تصله الكهرباء، وورقة البيانات تسمح بذلك.
- لاحظ أن المنظم في صورة المخطط صغير جداً مقارنة بأهميته، وهذا طبيعي، فحجم الرمز في المخطط لا علاقة له بحجم القطعة ولا بأهميتها.

### حساب صغير قبل أن تثق بالمنظم Thermal Check

المخطط يقول إن المنظم موصول بشكل صحيح، ولكنه لا يقول هل سوف يحترق. والحساب بسيط، والأرقام كلها في ورقة البيانات: المنظم الخطي يمرر التيار نفسه من الدخل إلى الخرج، ويحول فرق الجهد إلى حرارة، أي أن القدرة الضائعة P تساوي فرق الجهد مضروباً في التيار. وفرق الجهد عندنا 5 ناقص 3.3 أي 1.7 فولت. وتعطي ورقة بيانات AP2112 للغلاف SOT-25، وهو نفسه SOT-23-5، مقاومة حرارية من الوصلة إلى الهواء θJA قيمتها 184 درجة لكل واط دون مشتت حرارة، وتقول إن الحماية الحرارية تفصل عند 160 درجة.

| تيار اللوحة   | القدرة الضائعة 1.7 × I | ارتفاع الحرارة × 184 | في مستودع حرارته 40 درجة |
| ------------- | ---------------------- | -------------------- | ------------------------ |
| 50 ملي أمبير  | 0.085 واط              | 16 درجة              | 56 درجة                  |
| 100 ملي أمبير | 0.17 واط               | 31 درجة              | 71 درجة                  |
| 300 ملي أمبير | 0.51 واط               | 94 درجة              | 134 درجة                 |

والأرقام هنا حساب على أمثلة للتيار وليست قياساً، وقراءتها كالتالي: إذا كان الجهاز يأخذ عشرات الملي أمبير معظم الوقت فالمنظم مرتاح، أما إذا بقي يأخذ 300 ملي أمبير بشكل متواصل فسوف يقترب من حد الحماية الحرارية، وقبل ذلك سوف يسخن حساس الحرارة الذي بجانبه ويقرأ حرارة اللوحة بدل حرارة المستودع. والقرار هنا ليس في المخطط وإنما في اللوحة: النحاس حول المنظم يعمل كمشتت حرارة ويخفض المقاومة الحرارية الفعلية، والحساس يجب أن يكون بعيداً عن المنظم وعن المعالج، وهذا ما سوف نهتم به في المقال التالي. ولاحظ أن الحساب نفسه يقول لك متى تحتاج منظماً تبديلياً: عندما يصبح التيار المتواصل كبيراً، أو عندما يكون الدخل 12 أو 24 فولت كما في الأجهزة الصناعية، لأن فرق الجهد عندها يصبح أكبر بكثير.

### المعالج MCU: أطراف الإقلاع Strapping Pins

![الوحدة U1 ESP32-C3-WROOM-02 وأطرافها: EN على اليسار في الأعلى، ثم IO0 و IO1 و IO3 و IO4 بعلامات X و IO2 على IO2_STRAP، ثم IO5 SDA و IO6 SCL و IO7 TMP_ALERT و IO8 IO8_STRAP و IO9 BOOT و IO10 LED و IO18 USB_DN و IO19 USB_DP، وعلى اليمين IO20/RXD و IO21/TXD، و 3V3 في الأعلى و GND في الأسفل](https://arabroot.io/content/images/2026/11/kicad-schematic-05-sch-mcu-1.webp)

الوحدة وأسماء الشبكات على أطرافها، والأطراف غير المستخدمة بعلامة X

المعالج ESP32-C3 يقرأ عند التشغيل حالة بعض أطرافه ليقرر كيف يقلع، وتسمى هذه أطراف الإقلاع Strapping Pins. وتقول [إرشادات تصميم العتاد من Espressif](https://docs.espressif.com/projects/esp-hardware-design-guidelines/en/latest/esp32c3/index.html?ref=arabroot.io) إن الإقلاع العادي من الذاكرة SPI Boot يحتاج GPIO2 وGPIO9 على 1، وإن وضع التحميل Download Boot الذي نرفع به البرنامج يحتاج GPIO8 على 1 وGPIO9 على 0، وتوصي بمقاومة رفع على GPIO9 وعدم وضع مكثفات كبيرة عليه، وتوصي على طرف التفعيل CHIP\_EN بتأخير من مقاومة 10 كيلو أوم ومكثف 1 ميكروفاراد حتى لا يبدأ المعالج قبل أن يستقر الجهد. وهذا ما ترجمناه في المخطط:

- **EN:** المقاومة R5 10k إلى 3.3 فولت والمكثف C6 1u إلى الأرضي، وزر RESET بين EN والأرضي.
- **IO9:** زر BOOT إلى الأرضي، والمقاومة R9 10k إلى 3.3 فولت. فإذا ضغطت BOOT ثم RESET دخل المعالج وضع التحميل.
- **IO8:** المقاومة R7 10k إلى 3.3 فولت حتى يكون 1 في وضع التحميل.
- **IO18 وIO19:** بحسب الإرشادات نفسها هما D- وD+ لمنفذ USB المدمج في المعالج، فلا نحتاج شريحة تحويل USB مثل التي في لوحة التطوير، وهذا توفير قطعة كاملة.
- **IO20 وIO21:** المنفذ التسلسلي على موصل J2 بثلاثة أطراف مع الأرضي، للتصحيح إذا لم يعمل USB لأي سبب.
- **IO2:** من أطراف الإقلاع أيضاً، والإرشادات تطلب أن يكون 1 للإقلاع العادي، فوضعنا عليه المقاومة R10 10k إلى 3.3 فولت بدل أن نعتمد على حالة غير مكتوبة. وكانت أول نسخة من المخطط تضع على IO2 علامة X مثل بقية الأطراف غير المستخدمة، وهذا مثال على خطأ لا يكتشفه أي فحص، لأن الطرف غير الموصول بعلامة X صحيح تماماً في نظر ERC، والذي اكتشفه هو قراءة جدول أطراف الإقلاع في الإرشادات سطراً سطراً.
- **IO0 وIO1 وIO3 وIO4:** لا نستخدمها، فعليها علامة X.

وبجانب طرف 3V3 في الوحدة وضعنا مكثفين C3 10u وC4 100n، لأن الإرشادات تطلب مكثف 10 ميكروفاراد على خط الطاقة مع مكثفات 0.1 ميكروفاراد قرب الأطراف. والمكثف الكبير يخزن طاقة لحظات الاستهلاك العالي عندما يرسل الراديو، والصغير يمتص التشويش السريع، ومكانهما الحقيقي سوف نهتم به في اللوحة، لأن المكثف البعيد عن الطرف لا يفيد كثيراً مهما كانت قيمته.

### الحساس Sensor: ناقل I2C مع مقاومات الرفع

![الحساس U3 TMP1075D وأطرافه A0 و A1 و A2 موصولة معاً بخط واحد إلى GND، و SDA و SCL و ALERT بأسماء الشبكات، و V+ إلى +3V3، والمكثف C5 100n، وتحته ثلاث مقاومات R3 و R4 4.7k و R8 10k من +3V3 إلى SDA و SCL و TMP_ALERT](https://arabroot.io/content/images/2026/11/kicad-schematic-06-sch-sensor-1.webp)

الحساس: أطراف العنوان الثلاثة على الأرضي، ومقاومتا رفع لخطي I2C، ومقاومة لخط الإنذار

ناقل I2C خطان فقط، البيانات SDA والساعة SCL، وكل الأجهزة عليه تسحب الخط إلى الأرضي ولا ترفعه أبداً، أي أن مخارجها من نوع Open Drain، ولهذا يحتاج كل خط مقاومة رفع Pull-up إلى الجهد، وإلا بقي الخط في الهواء ولم يعمل الناقل. واخترنا 4.7 كيلو أوم، وهي قيمة شائعة لسرعة 100 أو 400 كيلوهرتز مع خطوط قصيرة على لوحة واحدة، والقيمة الأصغر تجعل الحواف أسرع وتستهلك تياراً أكبر، والأكبر تبطئ الحواف. وخط الإنذار ALERT من نوع Open Collector أيضاً كما يظهر في نوع الطرف في الرمز `open_collector`، فوضعنا عليه R8 10k. وأطراف العنوان الثلاثة على الأرضي فالعنوان 0x48، وإذا احتجت حساسين على اللوحة نفسها غيرت أطراف أحدهما بحسب الجدول.

وإذا كان I2C نفسه جديداً عليك، فسوف تجد شرحه بالإشارات على راسم الإشارة في مقالات مرحلة المتحكمات الدقيقة في هذا المسار.

### الإعادة والإقلاع Reset and Boot، ثم المخطط كاملاً

![جزء من المخطط فيه ملاحظة Reset and boot: EN RC delay، والمقاومة R5 10k من +3V3 إلى EN، والمكثف C6 1u من EN إلى GND، والزر SW2 RESET بين EN و GND، والزر SW1 BOOT بين BOOT و GND، والمقاومات R7 و R9 و R10 10k من +3V3 إلى IO8_STRAP و BOOT و IO2_STRAP](https://arabroot.io/content/images/2026/11/kicad-schematic-07-sch-reset-1.webp)

كتلة الإعادة والإقلاع: تأخير EN، والزران، ومقاومات الرفع لأطراف الإقلاع الثلاثة

والصورة التالية المخطط كاملاً على ورقة A4 كما صدره KiCad، مع جدول العنوان Title Block في الأسفل، وفيه اسم اللوحة والمراجعة Rev A والتاريخ. ورقم المراجعة ليس شكلاً، فعندما تصلك لوحات من المصنع وتكتشف خطأ، سوف يكون السؤال الأول «هذه اللوحة من أي مراجعة؟»، والجواب يجب أن يكون مطبوعاً على المخطط وعلى اللوحة نفسها.

![ورقة A4 كاملة من KiCad فيها الموصل USB-C والمقاومتان على اليسار، والمنظم والمكثفات في الأعلى، والوحدة ESP32-C3 في الوسط، والحساس ومقاوماته على اليمين، والمصباح والموصل J2 في الأسفل يميناً، وكتلة الإعادة والإقلاع في الأسفل يساراً، وجدول العنوان TH-1 temperature node Rev A في الزاوية السفلية اليمنى](https://arabroot.io/content/images/2026/11/kicad-schematic-03-schematic-full-1.webp)

مخطط TH-1 كاملاً كما صدره kicad-cli بصيغة SVG، والنسخة PDF في مجلد المختبر

### فحص القواعد الكهربائية ERC: أول تشغيل

فحص القواعد الكهربائية Electrical Rules Check يقرأ نوع كل طرف في الرموز، مثل دخل Input وخرج Output ودخل طاقة power\_in وخرج طاقة power\_out وسلبي Passive، ويتحقق أن التوصيلات منطقية: لا يوجد مخرجان متصلان ببعضهما، ولا يوجد طرف غير موصول دون علامة X، وكل دخل طاقة يغذيه خرج طاقة. ويشرح [دليل محرر المخطط](https://docs.kicad.org/10.0/en/eeschema/eeschema.html?ref=arabroot.io) هذه القواعد ومصفوفتها. وأول تشغيل كان على النسخة الأولى من المخطط، قبل أن نضيف شيئاً سوف نشرحه بعد قليل:

```bash
docker run --rm -v "$PWD:/lab" -w /lab kicad/kicad:10.0.8 \
  kicad-cli sch erc --format report --severity-all -o first/erc.rpt first/th1.kicad_sch
```

```text
Found 2 violations
Saved ERC Report to first/erc.rpt
```

```text
***** Sheet /
[power_pin_not_driven]: Input Power pin not driven by any Output Power pins
    ; error
    @(45.72 mm, 121.92 mm): Symbol #PWR01 Pin 1 [Power input, Line]
[power_pin_not_driven]: Input Power pin not driven by any Output Power pins
    ; error
    @(63.50 mm, 78.74 mm): Symbol #PWR03 Pin 1 [Power input, Line]

 ** ERC messages: 2  Errors 2  Warnings 0
```

في المخرج أعلاه لاحظ التالي:

- الخطأ نفسه مرتين، في موضعين محددين بالمليمتر على الورقة: النقطة الأولى رمز GND تحت الموصل، والثانية رمز VBUS بجانبه، أي أن الشبكتين GND وVBUS كلتيهما بلا مصدر معلن.
- والسبب أن رموز الطاقة مثل GND وVBUS أطرافها من نوع power\_in، والموصل J1 أطرافه من نوع passive، لأن KiCad لا يعرف أن الكابل الذي سوف يدخل هذا الموصل يحمل كهرباء. أما شبكة +3V3 فلم يشتك منها، لأن طرف VOUT في المنظم من نوع power\_out، فالفحص يعرف أن لها مصدراً.
- وقد يتساءل البعض: هل هذا خطأ حقيقي في الدائرة؟ والإجابة لا، فالدائرة صحيحة، والفحص لا يعرف إلا ما تخبره به، ولكن هذا لا يعني أن تتجاهله، لأن الخطأ نفسه يظهر عندما تنسى فعلاً توصيل منظم بشبكة.

![نصفان: الأيسر أحمر بعنوان قبل لا يوجد مصدر معلن لشبكة VBUS، فيه موصل J1 VBUS passive وشريحة U2 VIN power_in بينهما خط أحمر وعلامة X وشريط power_pin_not_driven × 2، والأيمن أخضر بعنوان بعد علامة PWR_FLAG فيه الموصل والشريحة وخط أخضر يتفرع منه PWR_FLAG power_out وشريط ERC messages: 0 Errors 0 Warnings 0](https://arabroot.io/content/images/2026/11/kicad-schematic-08-pwr-flag-1.webp)

لماذا اشتكى الفحص: الموصل عنصر سلبي، والعلامة PWR\_FLAG تخبر الفحص أن الشبكة لها مصدر

والحل المعتاد في KiCad هو علامة `PWR_FLAG`، وهي رمز من مكتبة `power` لا يضيف أي قطعة إلى اللوحة ولا إلى قائمة القطع، وطرفه من نوع power\_out، فتقول للفحص «هذه الشبكة لها مصدر من خارج المخطط». ووضعنا علامة على VBUS وأخرى على GND، ثم أعدنا الفحص بالخيار `--exit-code-violations` الذي يجعل الأمر يفشل إذا وجد أي مخالفة:

```bash
docker run --rm -v "$PWD:/lab" -w /lab kicad/kicad:10.0.8 \
  kicad-cli sch erc --format report --severity-all --exit-code-violations -o th1/erc.rpt th1/th1.kicad_sch
```

```text
Found 0 violations
Saved ERC Report to th1/erc.rpt
...
 ** ERC messages: 0  Errors 0  Warnings 0

 ** Ignored checks:
    - Global label only appears once in the schematic
    - Four connection points are joined together
    - SPICE model issue
    - Assigned footprint doesn't match footprint filters
```

ولاحظ القائمة الأخيرة، الفحوص المتجاهلة افتراضياً، ومنها أن البصمة المختارة لا تطابق المرشح Footprint Filter في الرمز. وهذا فحص يستحق أن تفعله في مشروعك، لأنه يلتقط البصمة الخطأ في مرحلة المخطط بدل مرحلة اللوحة.

### ماذا يحدث إذا أخطأت في اسم إشارة Label Typo؟

هذا هو الخطأ الذي يصنعه أسلوب الأسماء بدل الأسلاك: كتبنا اسم الشبكة على طرف SDA في الحساس `SDa` بدل `SDA`، حرف واحد صغير، وهو نوع الخطأ الذي يحدث عندما تنسخ اسماً وتعدله على عجل. وفي المخطط المطبوع يكاد لا يرى:

![الحساس U3 TMP1075D والطرف 1 SDA عليه اسم الشبكة SDa بحرف a صغير، والطرف SCL عليه SCL والطرف ALERT عليه TMP_ALERT](https://arabroot.io/content/images/2026/11/kicad-schematic-09-erc-typo-1.webp)

حرف واحد صغير: الطرف SDA في الحساس على شبكة اسمها SDa، أي شبكة مختلفة تماماً

```text
[similar_labels]: Labels are similar (lower/upper case difference only)
    ; warning
    @(228.60 mm, 113.03 mm): Label 'SDA'
    @(266.70 mm, 76.20 mm): Label 'SDa'
[isolated_pin_label]: Label connected to only one pin
    ; warning
    @(266.70 mm, 76.20 mm): Label 'SDa'
[similar_labels]: Labels are similar (lower/upper case difference only)
    ; warning
    @(266.70 mm, 76.20 mm): Label 'SDa'
    @(162.56 mm, 104.14 mm): Label 'SDA'

 ** ERC messages: 3  Errors 0  Warnings 3
```

الفحص التقط الخطأ بطريقتين: لاحظ أن هناك أسماء لا تختلف إلا في حالة الحروف، ولاحظ أن الاسم `SDa` متصل بطرف واحد فقط، أي أنه شبكة لا تذهب إلى أي مكان. ولكن انتبه: هذه كلها تحذيرات Warnings وليست أخطاء Errors، والفرق يظهر بوضوح عندما تضع الفحص في خط آلي:

```bash
kicad-cli sch erc --severity-error --exit-code-violations -o typo/erc-err.rpt typo/th1.kicad_sch; echo "exit=$?"
kicad-cli sch erc --severity-all --exit-code-violations -o typo/erc-all.rpt typo/th1.kicad_sch; echo "exit=$?"
```

```text
Found 0 violations
Saved ERC Report to typo/erc-err.rpt
exit=0
Found 3 violations
Saved ERC Report to typo/erc-all.rpt
exit=5
```

لو كان خط CI يفحص الأخطاء فقط لمرت هذه اللوحة، ولخرجت من المصنع وحساسها غير موصول بالمعالج، ولقضى أحدهم يوماً كاملاً يبحث في البرنامج عن سبب أن الحساس لا يرد على العنوان 0x48\. لذلك القاعدة: افحص كل المستويات، واجعل أي تحذير يوقف الخط، وإذا كان هناك تحذير تقبله عن قصد فاستثنه بعينه في إعدادات المشروع Exclusion مع سبب مكتوب، ولا تخفض مستوى الفحص كله.

### قائمة التوصيلات Netlist

```bash
kicad-cli sch export netlist --format kicadsexpr -o th1/th1.net th1/th1.kicad_sch
```

والملف الناتج بصيغة S-expression أيضاً، وفيه قائمة القطع ثم قائمة الشبكات، وطبعنا الشبكات منه بسكربت صغير فكانت كما يلي:

```text
+3V3                   14  C2.1 C3.1 C4.1 C5.1 R10.1 R3.1 R4.1 R5.1 R7.1 R8.1 R9.1 U1.1 U2.5 U3.8
/BOOT                   3  R9.2 SW1.1 U1.8
/CC1                    2  J1.A5 R1.1
/CC2                    2  J1.B5 R2.1
/EN                     4  C6.1 R5.2 SW2.1 U1.2
/IO2_STRAP              2  R10.2 U1.16
/IO8_STRAP              2  R7.2 U1.7
/SCL                    3  R4.2 U1.5 U3.2
/SDA                    3  R3.2 U1.4 U3.1
/TMP_ALERT              3  R8.2 U1.6 U3.3
/USB_DN                 3  J1.A7 J1.B7 U1.13
/USB_DP                 3  J1.A6 J1.B6 U1.14
GND                    24  C1.2 C2.2 C3.2 C4.2 C5.2 C6.2 D1.1 J1.A1 J1.A12 J1.B1 J1.B12 J1.SH J2.3 R1.2 R2.2 SW1.2 SW2.2 U1.19 U1.9 U2.2 U3.4 U3.5 U3.6 U3.7
VBUS                    7  C1.1 J1.A4 J1.A9 J1.B4 J1.B9 U2.1 U2.3
unconnected-(J1-SBU1-PadA8)  1  J1.A8
unconnected-(J1-SBU2-PadB8)  1  J1.B8
unconnected-(U1-IO0-Pad18)  1  U1.18
...
```

في المخرج أعلاه لاحظ التالي:

- الشبكات التي سميناها بأسماء محلية تبدأ بالشرطة المائلة `/`، أي أنها خاصة بالورقة الرئيسية، أما شبكات الطاقة فأسماؤها عامة لأنها جاءت من رموز الطاقة.
- هذه القائمة هي أفضل طريقة لمراجعة المخطط مراجعة آلية: سطر SDA فيه ثلاثة أطراف، المعالج والحساس والمقاومة، ولو كان فيه طرفان لعرفت أن هناك خطأ. وفي النسخة التي فيها `SDa` كان سطر SDA فيه طرفان فقط.
- الأطراف غير الموصولة عمداً تظهر كشبكات بطرف واحد اسمها يبدأ بـ `unconnected`، فإذا وجدت فيها طرفاً تحتاجه فقد وضعت علامة X في المكان الخطأ.

### قائمة القطع BOM

```bash
kicad-cli sch export bom -o th1/bom.csv --fields 'Reference,Value,Footprint,MPN,${QUANTITY}' \
  --group-by Value,Footprint --labels 'Refs,Value,Footprint,MPN,Qty' th1/th1.kicad_sch
```

```text
"Refs","Value","Footprint","MPN","Qty"
"C1,C2,C6","1u","Capacitor_SMD:C_0603_1608Metric","","3"
"C3","10u","Capacitor_SMD:C_0805_2012Metric","","1"
"C4,C5","100n","Capacitor_SMD:C_0603_1608Metric","","2"
"D1","green","LED_SMD:LED_0603_1608Metric","","1"
"J1","USB_C","Connector_USB:USB_C_Receptacle_HRO_TYPE-C-31-M-12","TYPE-C-31-M-12","1"
"J2","UART","Connector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_Vertical","","1"
"R1,R2","5.1k","Resistor_SMD:R_0603_1608Metric","","2"
"R3,R4","4.7k","Resistor_SMD:R_0603_1608Metric","","2"
"R5,R7-R10","10k","Resistor_SMD:R_0603_1608Metric","","5"
"R6","1k","Resistor_SMD:R_0603_1608Metric","","1"
"SW1","BOOT","Button_Switch_SMD:SW_Push_1P1T_NO_CK_KMR2","","1"
"SW2","RESET","Button_Switch_SMD:SW_Push_1P1T_NO_CK_KMR2","","1"
"U1","ESP32-C3-WROOM-02","RF_Module:ESP32-C3-WROOM-02","ESP32-C3-WROOM-02-N4","1"
"U2","AP2112K-3.3","Package_TO_SOT_SMD:SOT-23-5","AP2112K-3.3TRG1","1"
"U3","TMP1075D","Package_SO:SO-8_3.9x4.9mm_P1.27mm","TMP1075DR","1"
```

جمعنا القطع بالقيمة والبصمة، فأصبحت 24 قطعة في 15 سطراً، وهذا ما تحتاجه المشتريات. ولكن لاحظ عمود MPN، رقم القطعة عند الشركة المصنعة Manufacturer Part Number: موجود للقطع الكبيرة وفارغ للمقاومات والمكثفات. وهذا مقبول في المراجعة الأولى، ولكن قبل الطلب يجب أن يكون لكل سطر رقم قطعة محدد، لأن «مكثف 10u» وحدها لا تكفي: المكثف 10 ميكروفاراد بجهد 6.3 فولت ونوع Y5V يفقد معظم سعته عند جهد التشغيل، بينما المكثف نفسه بنوع X5R وجهد 10 فولت يحتفظ بأغلبها، ولهذا أوصت ورقة بيانات المنظم بالنوع. والمصنع الذي يركب القطع سوف يطلب منك هذا العمود بالضبط.

### ملف PDF للمراجعة، وملف SVG للتوثيق

```bash
kicad-cli sch export pdf -o th1/th1.pdf th1/th1.kicad_sch
kicad-cli sch export svg -o th1/svg th1/th1.kicad_sch
```

```text
Plotted to 'th1/th1.pdf'.
Done.
Plotted to '/lab/th1/svg/th1.svg'.
Done.
```

ملف PDF هو ما ترسله للمراجع، ولمن يكتب البرنامج، وللمصنع إذا احتاج أن يفهم اللوحة، والصور في هذا المقال كلها مقتطعة من ملف SVG الذي صدره KiCad، دون أي تعديل في محتواها. ولاحظ أن ملف المخطط نفسه حجمه قرابة 128 كيلوبايت، وأغلبه نسخ الرموز المضمنة، وهذا ما يجعله يفتح على أي جهاز حتى لو لم تكن عليه المكتبات نفسها.

### المخطط في خط CI Pipeline

بما أن كل خطوة سبقت أمر في سطر الأوامر، فيمكن أن تجمعها في ملف واحد وتشغلها مع كل Push، كما يفعل أي فريق برمجيات بالاختبارات، كما شرحنا في [مقال مفهوم CI/CD](https://arabroot.io/articles/%D9%85%D9%81%D9%87%D9%88%D9%85-ci-cd-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86-%D9%85%D9%86-%D9%83%D9%84-push-%D8%A7%D9%84%D9%89-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1-%D9%8A%D8%B9%D9%85%D9%84/). وهذا هو الملف `regen.sh` الذي شغلنا به المختبر كله:

```bash
#!/bin/sh
set -e
python3 make_sch.py
kicad-cli sch erc --format report --severity-all --exit-code-violations -o th1/erc.rpt th1/th1.kicad_sch
kicad-cli sch export netlist --format kicadsexpr -o th1/th1.net th1/th1.kicad_sch
kicad-cli sch export bom -o th1/bom.csv --fields 'Reference,Value,Footprint,MPN,${QUANTITY}' \
  --group-by Value,Footprint --labels 'Refs,Value,Footprint,MPN,Qty' th1/th1.kicad_sch
kicad-cli sch export pdf -o th1/th1.pdf th1/th1.kicad_sch
```

والسطر `set -e` مع `--exit-code-violations` يعني أن أي مخالفة في الفحص توقف الملف كله برمز خطأ، فلا تصدر قائمة قطع ولا PDF لمخطط فيه مشكلة. وفي خط CI حقيقي تشغل هذا الملف داخل `kicad/kicad:10.0.8` نفسه، وتحفظ ملفي PDF وBOM كمخرجات Artifacts لكل Commit، فيرى المراجع ما تغير دون أن يثبت KiCad.

![سلسلة من اليسار: حاسب فيه th1.kicad_sch و git push، ثم أربعة صناديق sch erc بخياري --severity-all و --exit-code-violations، ثم sch export netlist إلى th1.net، ثم sch export bom إلى bom.csv، ثم sch export pdf إلى th1.pdf، وتحتها مربع أحمر --severity-error exit 0 و --severity-all exit 5، ومربع أخضر kicad/kicad:10.0.8 في Docker](https://arabroot.io/content/images/2026/11/kicad-schematic-10-ci-1.webp)

الفحص والتصدير في خط CI: مستوى الفحص هو الفرق بين لوحة تمر بخطئها ولوحة تتوقف

### تنظيف المختبر Cleanup

لم ننشئ أي Container دائم، فكل أمر شغلناه بالخيار `--rm`. ويبقى Docker Image الخاص بـ KiCad، فاحتفظ به إذا كنت ستكمل مع مقال اللوحة المطبوعة، أو احذفه:

```bash
docker image rm kicad/kicad:10.0.8
```

## أسماء القطع والأوراق Annotation and Hierarchy

كل قطعة في المخطط لها مرجع Reference Designator من حرف ورقم، والحرف معروف في الصناعة: R للمقاومة، وC للمكثف، وD للدايود والمصباح، وU للدائرة المتكاملة، وJ للموصل، وSW للمفتاح، وFB لحلقة الفرايت، وTP لنقطة الاختبار. وهذا الترقيم يطبع على اللوحة بجانب كل قطعة في طبقة الكتابة Silkscreen، ويظهر في قائمة القطع، ويستخدمه الفني عندما يقول «المكثف C6 منتفخ»، لذلك لا تغيره بعد أن ترسل اللوحة للتصنيع، لأن كل الوثائق سوف تشير إلى الأسماء القديمة. ومحرر المخطط فيه أداة ترقيم تلقائي Annotation تعطي القطع أرقامها، وفي مخططنا وضعنا الأرقام بأنفسنا لأن الجدول في السكربت هو المصدر.

ومخطط TH-1 ورقة واحدة لأنه صغير، أما اللوحة التي فيها مئة قطعة فتقسم إلى أوراق هرمية Hierarchical Sheets: ورقة للطاقة، وورقة للمعالج، وورقة لكل واجهة، وورقة رئيسية تربطها بأسماء عامة أو منافذ هرمية. والتقسيم الجيد يتبع المخطط الكتلي نفسه، فكل كتلة ورقة، ويسمح بإعادة استخدام ورقة مثل منظم الجهد في أكثر من مشروع، وبأن يعمل مهندسان على مخطط واحد دون تعارض كبير في Git. والقاعدة العملية: إذا لم تعد الورقة مقروءة عند طباعتها على A4، فقد حان وقت التقسيم.

وهناك أيضاً قيم القطع نفسها: مقاومة 4.7k في المخطط هي في الحقيقة مقاومة لها نسبة خطأ Tolerance، مثل 1% أو 5%، وقدرة تحمل بالواط، ومكثف 1u له جهد أقصى ونوع خزف، وكل هذا لا يظهر في الرمز إلا إذا كتبته في خصائص القطعة أو في رقم MPN. وفي لوحة مثل TH-1 لا تهم نسبة الخطأ في مقاومات الرفع كثيراً، ولكنها تهم جداً في مقسم جهد Voltage Divider يقرأ جهد بطارية، أو في مقاومة تضبط تيار شحن، ولهذا تكتب الشركات في المخطط القيمة والنسبة معاً في هذه الأماكن، مثل `10k 1%`.

## مراجعة المخطط Design Review: ما لا يكتشفه أي فحص

الفحص ERC يعرف أنواع الأطراف وأسماء الشبكات فقط، ولا يعرف شيئاً عن القيم ولا عن الفيزياء، لذلك في كل شركة تصنع لوحات توجد مراجعة يقوم بها مهندس غير الذي صمم، ومعه ورقة البيانات لكل قطعة. وهذه الأسئلة التي يسألها في مخطط مثل TH-1:

- **القيم:** هل مقاومتا CC قيمتهما 5.1k فعلاً، أم كتب أحدهم 51k؟ هل مكثفات المنظم بالنوع والجهد الذي توصي به ورقة البيانات؟
- **الجهد والتيار:** هل يتحمل المنظم أعلى تيار يأخذه المعالج عند إرسال الراديو؟ وكم الحرارة التي سوف تخرج منه بفرق 1.7 فولت؟
- **أطراف الإقلاع:** هل كل طرف إقلاع في الحالة الصحيحة عند التشغيل؟ وهل هناك شيء متصل بأحدها قد يسحبه للحالة الخطأ، مثل مصباح أو حساس؟
- **ما بعد التصنيع:** هل يوجد طريق لرفع البرنامج إذا لم يعمل USB، مثل موصل J2؟ وهل هناك نقاط اختبار Test Points للطاقة؟
- **توفر القطع:** هل كل قطعة ما زالت في الإنتاج Active ومتوفرة عند الموزعين بالكمية؟ وما البديل إذا نفدت؟
- **البصمات:** هل البصمة المختارة هي غلاف القطعة التي سوف تشتريها؟ فالحساس نفسه له أربعة أغلفة بحسب صفحته، والخطأ هنا يظهر فقط عندما تصل القطع ولا تركب على اللوحة.

## أخطاء شائعة Common Mistakes

- **نسيان مقاومتي CC في USB-C:** الجهاز لا يعمل مع شواحن USB-C الحديثة، ويعمل مع الكابلات القديمة، فيظهر الخطأ عند العملاء وليس في المختبر.
- **إسكات الفحص بدل فهمه:** وضع PWR\_FLAG على كل شبكة حتى يختفي الخطأ، بما فيها شبكة نسيت فعلاً توصيل منظمها.
- **فحص الأخطاء فقط في CI:** رأينا أن خطأ اسم الإشارة كان تحذيراً.
- **أطراف غير مستخدمة بلا علامة X:** تملأ التقرير بتحذيرات حتى يتعود الفريق على تجاهله.
- **قائمة قطع بلا أرقام MPN:** المصنع يختار عنك، وقد يختار مكثفاً يفقد سعته عند الجهد.
- **رموز وبصمات من مصادر مجهولة:** ترقيم أطراف لا يطابق القطعة، ولا يكتشفه إلا اللحام.
- **مخطط بلا رقم مراجعة:** بعد ثلاث دفعات لا يعرف أحد أي لوحة يحملها في يده.

## قائمة تحقق قبل الانتقال إلى اللوحة Schematic Checklist

| البند                        | كيف تتحقق                                                        |
| ---------------------------- | ---------------------------------------------------------------- |
| الفحص نظيف                   | sch erc --severity-all --exit-code-violations يخرج بصفر          |
| كل شبكة لها الأطراف المتوقعة | راجع قائمة الشبكات سطراً سطراً، وخاصة الشبكات بطرفين أو طرف واحد |
| التطبيق النموذجي لكل قطعة    | قارن كل قطعة بقسم Typical Application في ورقة بياناتها           |
| أطراف الإقلاع                | حالة كل طرف عند التشغيل مكتوبة في ملاحظة على المخطط              |
| الطاقة                       | أعلى تيار، والحرارة في المنظم، ومكثفات بالنوع والجهد             |
| البصمات                      | تطابق الغلاف الذي في رقم القطعة، والمرشح Footprint Filter مفعل   |
| قائمة القطع                  | لكل سطر MPN متوفر الآن، وبديل للقطع الحرجة                       |
| طريق للتصحيح                 | منفذ تسلسلي أو نقاط اختبار، وزر إقلاع                            |
| المراجعة                     | مهندس آخر راجع PDF، ورقم المراجعة في جدول العنوان                |

## تدريب عملي Practice

1. احذف علامة X عن الطرف IO3 في السكربت بتغيير `"15": "NC"` إلى غياب السطر، وشغل الفحص، واقرأ نوع الرسالة التي تظهر، ثم أعده.
2. أضف حساساً ثانياً TMP1075 على الناقل نفسه بعنوان مختلف من جدول ورقة البيانات، وتحقق من قائمة الشبكات أن خط SDA أصبح فيه أربعة أطراف.

## الخلاصة Summary

- اللوحة الخاصة تعطيك حجماً وكلفة وموثوقية لا تعطيها لوحة التطوير، ولكن كل قرار فيها أصبح مسؤوليتك، والمخطط هو أرخص مكان لاكتشاف الأخطاء.
- ابدأ بمخطط كتلي واختر كل قطعة من ورقة بياناتها، وانسخ التطبيق النموذجي بدل أن تخترع.
- الرمز للمخطط والبصمة للوحة، ورقم الطرف هو الجسر بينهما، وقائمة التوصيلات هي ما ينتقل إلى اللوحة.
- KiCad 10 يعمل كاملاً من سطر الأوامر في Docker، فيفحص ويصدر قائمة التوصيلات والقطع وPDF في خط CI.
- أول فحص أعطى خطأين لأن الموصل لا يعلن أنه مصدر طاقة، والحل علامة PWR\_FLAG بفهم وليس لإسكات الفحص.
- خطأ حرف واحد في اسم إشارة كان تحذيراً، ولو فحص الخط الأخطاء فقط لخرجت اللوحة وحساسها غير موصول.
- ما لا يكتشفه الفحص يكتشفه المراجع: أطراف الإقلاع والقيم والحرارة والبصمات وتوفر القطع، لذلك اكتب كل قرار من هذا النوع في ملاحظة على المخطط نفسه، حتى يجده من يراجع اللوحة بعدك دون أن يسألك.

وفي [المقال التالي](https://arabroot.io/articles/%D8%AA%D8%B5%D9%85%D9%8A%D9%85-%D8%A7%D9%84%D9%84%D9%88%D8%AD%D8%A9-%D8%A7%D9%84%D9%85%D8%B7%D8%A8%D9%88%D8%B9%D8%A9-pcb-%D9%85%D8%B9-kicad-%D8%AB%D9%85-%D8%B7%D9%84%D8%A8-%D8%AA%D8%B5%D9%86%D9%8A%D8%B9%D9%87%D8%A7/) من هذه المرحلة نأخذ المخطط نفسه إلى اللوحة المطبوعة: البصمات على النحاس، والطبقات، وقواعد التصميم، والتوجيه، وفحص DRC بخطأ حقيقي، ثم ملفات Gerber وطلب التصنيع.

[![](https://arabroot.io/content/images/2026/11/kicad-pcb-cover-cover-1.webp)دليلتصميم اللوحة المطبوعة PCB مع KiCad، ثم طلب تصنيعهانحول مخطط لوحة الحرارة TH-1 إلى لوحة بطبقتين في KiCad 10 من سطر الأوامر، ونضبط قواعد التصميم من صفحة المصنع، ونصلح أخطاء DRC حقيقية، ثم نصدر ملفات Gerber لنطلب التصنيع.](https://arabroot.io/articles/%D8%AA%D8%B5%D9%85%D9%8A%D9%85-%D8%A7%D9%84%D9%84%D9%88%D8%AD%D8%A9-%D8%A7%D9%84%D9%85%D8%B7%D8%A8%D9%88%D8%B9%D8%A9-pcb-%D9%85%D8%B9-kicad-%D8%AB%D9%85-%D8%B7%D9%84%D8%A8-%D8%AA%D8%B5%D9%86%D9%8A%D8%B9%D9%87%D8%A7/)[![](https://arabroot.io/content/images/2026/11/ci-cd-basics-cover-cover.webp)دليلمفهوم CI/CD للمبتدئين: من كل Push إلى سيرفر يعملما الذي يعنيه التكامل المستمر والتسليم المستمر فعلاً، وكيف تبني خطاً صغيراً يختبر كل Push وينشر إلى staging ويتحقق منه، مع الأخطاء الحقيقية التي يكشفها وتلك التي لا يكشفها.](https://arabroot.io/articles/%D9%85%D9%81%D9%87%D9%88%D9%85-ci-cd-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86-%D9%85%D9%86-%D9%83%D9%84-push-%D8%A7%D9%84%D9%89-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1-%D9%8A%D8%B9%D9%85%D9%84/)[![](https://arabroot.io/content/images/2026/11/git-basics-cover-cover.webp)دليلإدارة النسخ مع Git للمبتدئين: لماذا نحتاجها وكيف تعمللماذا تضيع الملفات بأسماء final\_v2 ويمسح الزملاء عمل بعضهم، وكيف يحل Git ذلك على مشروع حقيقي من أول commit.](https://arabroot.io/articles/%D8%A7%D8%AF%D8%A7%D8%B1%D8%A9-%D8%A7%D9%84%D9%86%D8%B3%D8%AE-%D9%88-git-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/)[![](https://arabroot.io/content/images/2026/10/computer-components-cover-cover.webp)دليلمكونات الحاسب Computer Components: كيف تعمل معاً؟نفتح جهازاً حقيقياً ونتابع المعالج والذاكرة والأقراص واللوحة الأم وهي تعمل معاً، ثم نقيس كم ينتظر برنامجك ليحصل على البيانات من كل جزء.](https://arabroot.io/articles/%D9%85%D9%83%D9%88%D9%86%D8%A7%D8%AA-%D8%A7%D9%84%D8%AD%D8%A7%D8%B3%D8%A8-%D9%88%D9%83%D9%8A%D9%81-%D8%AA%D8%B9%D9%85%D9%84-%D9%85%D8%B9%D8%A7/)

## سجل التحديثات Changelog

- نوفمبر 2026: كتابة المقال، والتجربة على KiCad 10.0.8 بـ Docker Image الرسمي kicad/kicad:10.0.8 (kicad-cli مع مكتبات الرموز والبصمات الرسمية)، والمخطط مولد بسكربت Python من مكتبات KiCad نفسها، والمعلومات من موقع KiCad وتوثيقه وأوراق بيانات Espressif وDiodes وTexas Instruments كما قرأناها في 6 نوفمبر 2026.