ميثاق مجتمع العتاد المفتوح المصدر المصري
الإصدار 1.0 - Egypt OSHW Community
يقسم هذا الميثاق إلى 6 أقسام توضع تحت عنوان أو فئة "📚 The OSHW-EG Charter" وهي جاهزة لنقلها إلى المجتمع في الديسكورد في حال الموافقة عليه، كل قسم يمثل قناة منفردة للقراءة فقط.
🧭 القسم الأول: OSHW-global-definition (التعريف والمبادئ العالمية)
مقدمة ومبادئ الأجهزة مفتوحة المصدر (OSHW Statement of Principles 1.0):
يتبنى مجتمع (Egypt OSHW Community) بشكل كامل ومطابق التعريف والمبادئ الصادرة عن جمعية الأجهزة مفتوحة المصدر العالمية (OSHWA).
ما هي الأجهزة مفتوحة المصدر؟ هي أجهزة ملموسة (آلات، أجهزة، أو أي أشياء مادية) يُتاح تصميمها للجمهور بحيث يمكن لأي شخص دراستها، تعديلها، توزيعها، وتصنيعها، وبيع التصميم أو الأجهزة المبنية عليه. المصدر الخاص بالجهاز (التصميم الذي صُنع منه) يجب أن يكون متاحاً بالصيغة المفضلة لإجراء التعديلات عليه.
من الناحية المثالية، تستخدم الأجهزة مفتوحة المصدر مكونات ومواد متوفرة بسهولة، عمليات تصنيع قياسية، بنية تحتية مفتوحة، محتوى غير مقيد، وأدوات تصميم مفتوحة المصدر لتعظيم قدرة الأفراد على تصنيع واستخدام الأجهزة. هذا النهج يمنح الأفراد حرية التحكم في التكنولوجيا الخاصة بهم، مع مشاركة المعرفة وتشجيع التجارة من خلال التبادل المفتوح للتصاميم.
شروط توزيع الأجهزة مفتوحة المصدر (OSHW Definition 1.0):
نظراً لأن تصنيع الهاردوير يتطلب موارد مادية، فإن أي شخص أو شركة تنتج عناصر تحت ترخيص OSHW ملزمة بتوضيح أن هذه المنتجات غير مُصنعة، أو مُباعة، أو مكفولة بضمان، أو معتمدة من قبل المصمم الأصلي، ولا يحق لها استخدام أي علامات تجارية يملكها المصمم الأصلي. يجب أن تتوافق شروط التوزيع مع المعايير الـ 12 التالية:
- التوثيق (Documentation): يجب إصدار الأجهزة مع وثائق تشمل ملفات التصميم، ويجب السماح بتعديل وتوزيع هذه الملفات. إذا لم تُرفق الوثائق مع المنتج المادي، يجب توفير وسيلة معلنة للحصول عليها بتكلفة لا تتجاوز تكلفة النسخ، ويُفضل إتاحتها للتحميل المجاني عبر الإنترنت. يجب أن تكون ملفات التصميم بالصيغة الأصلية لبرنامج التصميم (CAD). يُحظر تعمد إخفاء أو تعقيد ملفات التصميم (Obfuscated design files). كما لا يُسمح باستخدام الصيغ الوسيطة الجاهزة للطباعة (مثل Copper artwork) كبديل لملفات التصميم الأصلية.
- النطاق (Scope): يجب أن تحدد الوثائق بوضوح أي جزء من التصميم (إن لم يكن كله) يتم إصداره تحت هذا الترخيص.
- البرمجيات الضرورية (Necessary Software): إذا كان التصميم يتطلب برمجيات (Embedded أو غيرها) ليعمل بشكل صحيح، يجب أن يستوفي الترخيص أحد الشرطين:
- أ) أن تكون الواجهات (Interfaces) موثقة جيداً بحيث يسهل كتابة كود مفتوح المصدر لتشغيل الجهاز (مثال: توفير مخططات تزامن الإشارات Signal timing diagrams أو كود زائف Pseudocode).
- ب) أو أن يتم إصدار البرمجيات الضرورية تحت ترخيص مفتوح المصدر معتمد من مبادرة (OSI).
- الأعمال المشتقة (Derived Works): يجب أن يسمح الترخيص بإجراء تعديلات وبناء أعمال مشتقة، وتوزيعها تحت نفس شروط الترخيص الأصلي. ويجب أن يسمح بتصنيع وبيع وتوزيع المنتجات الناشئة عن ملفات التصميم.
- حرية إعادة التوزيع (Free Redistribution): يجب ألا يمنع الترخيص أي طرف من بيع أو التبرع بوثائق المشروع، ولا يحق له فرض رسوم ملكية (Royalties) على هذا البيع أو على بيع الأعمال المشتقة.
- الإشارة للمصدر (Attribution): يحق للترخيص أن يشترط الإشارة للمصمم الأصلي عند توزيع ملفات التصميم أو المنتجات المشتقة، على أن تكون هذه المعلومات مرئية للمستخدم النهائي دون فرض تنسيق محدد لعرضها.
- عدم التمييز ضد الأشخاص (No Discrimination): يجب ألا يُميز الترخيص ضد أي شخص أو مجموعة.
- عدم التمييز ضد مجالات العمل (No Discrimination Against Fields of Endeavor): يجب ألا يمنع الترخيص استخدام العمل في مجال معين (مثال: لا يجوز منع استخدامه في أغراض تجارية أو أبحاث نووية).
- توزيع الترخيص (Distribution of License): الحقوق الممنوحة يجب أن تنطبق على كل من يُعاد توزيع العمل إليه دون الحاجة لتوقيع ترخيص إضافي.
- عدم تخصيص الترخيص لمنتج (License Must Not Be Specific to a Product): الحقوق الممنوحة لا تعتمد على كون العمل جزءاً من منتج معين. إذا تم اقتطاع جزء من التصميم واستخدامه، يحصل المستخدم على نفس الحقوق الأصلية.
- عدم تقييد أجهزة/برمجيات أخرى: يجب ألا يفرض الترخيص قيوداً على العناصر الأخرى المدمجة مع العمل (مثال: لا يجوز اشتراط أن تكون كل الأجهزة المرفقة مفتوحة المصدر).
- الحياد التكنولوجي (Technology-Neutral): يجب ألا يعتمد الترخيص على تقنية فردية أو مكون محدد أو واجهة معينة.
🌍 القسم الثاني: vision-and-value (الرؤية والقيم)
مرحباً بك في المجتمع المصري للعتاد المفتوح المصدر (Egypt OSHW Community)
رؤيتنا:
نحن مظلة تطمح بأن تجمع المهندسين، والباحثين الأكاديميين، والمُصنّعين (Makers) في مصر لتعزيز ثقافة "المصادر المفتوحة" في مجال الهاردوير. نهدف إلى ربط العقول الهندسية بالمبادرات الحكومية (مثل مبادرة مصر تصنع الإلكترونيات EME) والمؤسسات الأكاديمية لبناء بيئة تطوير (Ecosystem) متكاملة.
لماذا تتواجد هنا؟ (العائد على الأعضاء):
- Networking شبكة العلاقات: تواصل مباشر مع نخبة من مهندسي الإلكترونيات والأنظمة المدمجة في السوق المصري، وبناء فرق عمل لمشاريعك.
- Rapid Prototyping النماذج الأولية السريعة: الوصول إلى مكتبات وتصاميم مرجعية (Reference Designs) تم اختبارها محلياً، مما يقلل وقت وتكلفة البحث والتطوير (R&D).
- Social-Impact تطوير مشاريع ذات أثر مجتمعي: المساهمة في تصميم حلول تكنولوجية فعلية تخدم قطاعات حيوية (كالزراعة، والصحة، والصناعة) بتكلفة اقتصادية.
- Sponsorship الوصول للدعم المؤسسي: المشاريع المتميزة والموثقة قد تحظى بفرص دعم، توجيه، أو رعاية لتصنيع النماذج الأولية عبر شركاء المجتمع في حال تواجد هذه الفرص.
🏅 القسم الثالث: the-eg-oshw-badge (بادج الاعتماد)
ما هو بادج الاعتماد (OSHW-EG Certified Badge)
هو ختم جودة هندسي يُمنح للمشاريع التي يتم تطويرها داخل المجتمع وتستوفي معايير التوثيق والمراجعة التقنية. الحصول على البادج يعني أن مشروعك ليس مجرد "فكرة"، بل منتج هندسي قابل للتصنيع في مصر.
العائد من الحصول على البادج:
| الميزة | التفاصيل والفائدة |
|---|---|
| الموثوقية التقنية (Technical Credibility) |
المشروع الحاصل على البادج تمت مراجعته (Design Review) من قبل مهندسين خبراء، مما يؤكد سلامة التصميم الهندسي للمسارات (Routing) والمكونات (BOM). |
| أولوية الدعم (Sponsorship Priority) |
المشاريع المعتمدة تمتلك الأولوية في الحصول على أي دعم لوجستي أو مادي متاح من الجهات الراعية (مثل تحمل تكاليف تصنيع أول دفعة من الـ PCBs). |
| الاعتماد في السيرة الذاتية | وجود البادج على مستودع GitHub الخاص بك يُعد إثباتاً عملياً لمهاراتك الهندسية. |
كيف تحصل على البادج؟
- طرح الفكرة في قناة
#active-projects. - توثيق المشروع ورفع ملفات التصميم (EDA Files) والكود المصدري على مستودع عام (Public Repository) برخصة مفتوحة المصدر.
- طلب مراجعة تقنية
[Design Review]. - اجتياز المراجعة والحصول على "الكود التعريفي الفريد" (UID) والبادج النهائي ليُطبع على اللوحة الإلكترونية (Silkscreen).
⚖️ القسم الرابع: code-of-conduct (ميثاق الشرف والقواعد)
ميثاق العمل والتعامل المجتمعي:
- الاحترافية الهندسية: نحن نقدر النقاشات العميقة والمبنية على أسس علمية. النقد يجب أن يكون موضوعياً وموجهاً للتصميم الهندسي أو البرمجي، مع تقديم اقتراحات وحلول بديلة. أي هجوم شخصي، تنمر، أو تقليل من مستوى خبرة الأعضاء سيؤدي إلى الإبعاد الفوري.
- احترام الملكية الفكرية (IP Respect): المجتمع يدعم المصادر المفتوحة، لكنه يحترم حقوق الملكية بشدة. يُمنع التعدي على حقوق الأفراد أو الشركات (Reverse Engineering لمنتجات تجارية بغرض القرصنة). عند استخدام كود أو تصميم لجهة أخرى، يجب الإشارة للمصدر والالتزام بنوع الترخيص (License).
- الكفاءة ومنع الضوضاء (Signal-to-Noise Ratio): وقت المهندسين ثمين. يُمنع إرسال رسائل ترويجية (Spam)، أو إعلانات لمنتجات تجارية غير متعلقة بتطوير المجتمع. استخدم القنوات المخصصة لكل موضوع بدقة.
الهوية اللغوية وتوطين المعرفة (Language & Localization):
إثراء المحتوى الهندسي العربي ليس خياراً ثانوياً في هذا المجتمع، بل هو شرط أساسي لتوثيق أي مشروع واعتماده. لغة الضاد هي أداتنا لنقل المعرفة وتوسيع دائرة الاستفادة في الوطن العربي.
- الوثائق الأساسية: يجب أن تُصاغ كافة الوثائق الهندسية وملفات الشرح القياسية (README) بلغة عربية واضحة، سليمة المنطق، ومهنية التركيب كشرط أساسي لقبول المشروع ضمن مسار الدعم.
- الانتشار العالمي (Global Reach): لضمان امتداد أثر مشاريعنا إلى الساحة العالمية وتسهيل تبنيها من قبل المجتمعات الهندسية الدولية، يُشجع وبقوة إرفاق نسخة باللغة الإنجليزية للوثائق (أو ملخص هندسي وافٍ) جنباً إلى جنب مع الوثائق العربية.
- المصطلحات التقنية والتعريب: للحفاظ على الدقة العلمية، في حال عدم وجود مصطلح هندسي عربي دقيق ومتعارف عليه، يُفضل استخدام المصطلح التقني الأجنبي (مثل: Routing, Firmware, I2C, Schematics) كما هو داخل السياق العربي. هذا الإجراء مؤقت لحين قيام خبراء المجتمع بدراسة المصطلح، ووضع تعريب علمي دقيق له، ومن ثم نشره وتعميمه كمعيار لغوي معتمد داخل مجتمعنا.
🛠️ القسم الخامس: sop-and-coding (نظام التشغيل القياسي للمشاريع)
نظام التشغيل القياسي للمشاريع (Standard Operating Procedure - SOP):
لضمان الجودة، يمر أي مشروع بدورة حياة معيارية (Stage-Gates):
- الطرح المبدئي (Initiation): فتح نقاش علني للمشروع في قناة
#active-projectsوتحديد المشكلة ونطاق العمل. - التطوير والتوثيق (Development & Documentation): إنشاء مستودع (Repository) على GitHub، والالتزام بكتابة وثيقة المشروع (README) باللغة العربية كشرط أساسي.
- التجميد والمراجعة (Design Freeze & Review): طلب مراجعة تقنية
[Design Review]من المشرفين لفحص الـ PCB، الـ Firmware، وقائمة الـ BOM. - الاعتماد (Certification & Badging): منح المشروع الكود النهائي والبادج ليتم إدراجه في الأرشيف الرسمي.
نظام التكويد الهندسي لإدارة دورة حياة المنتج (Hybrid PLM/SemVer Coding System):
لضمان التتبع الدقيق والاحترافية الصناعية، يعتمد المجتمع نظام تكويد هجين يُطبق على ملفات المشروع ومستودعاته بناءً على الصيغة التالية:
[ORG] - [DOM][ID] - [ITEM] - [REV]
- 1. الكود الجذري للمشروع (Root Project ID): يُعبر عن المشروع ككل.
ORG: المنظمة (OE لاختصار OSHW-Egypt).DOM: المجال (EM أنظمة مدمجة، RO روبوتات، AG زراعة، MD طبي).ID: رقم تسلسلي للمشروع (001, 002). (مثال:OE-EM012لمشروع نظام مدمج رقم 12).
- 2. كود العنصر الهندسي (Item Type Code): لتصنيف الملفات داخل المشروع:
PCB: الدائرة المطبوعة (Bare Board).MEC: التصميم الميكانيكي (3D Print / Enclosure).FW: الكود البرمجي (Firmware).BOM: قائمة المكونات (Bill of Materials).
- 3. نظام التحديثات والإصدارات (Revision Control):
- للهاردوير والميكانيكا (PCB, MEC, BOM): يُستخدم نظام الحروف الأبجدية وفقاً للمعايير الصناعية (مثال: RevA للنموذج الأول، RevB للتعديل الثاني).
- للبرمجيات (FW): يُستخدم معيار الترقيم الدلالي (Semantic Versioning) المكون من 3 أرقام (مثال: v1.0.0 للإصدار المستقر، v1.1.0 لإضافة ميزة).
مثال تطبيقي كامل داخل مستودع مشروع (OE-EM012):
• ملفات تصنيع اللوحة المطبوعة:OE-EM012-PCB-RevA
• الكود البرمجي للمتحكم:OE-EM012-FW-v1.0.2
• ملف التصميم الميكانيكي:OE-EM012-MEC-RevA
📜 القسم السادس: legal-disclaimer (اخلاء المسؤولية القانونية AS IS)
إخلاء المسؤولية القانونية (Legal Disclaimer - AS IS):
بانضمامك واستخدامك لموارد وتصاميم مجتمع (Egypt OSHW Community)، فإنك توافق صراحةً على البنود التالية:
- توفير المعلومات "كما هي" (AS IS): جميع المخططات الإلكترونية (Schematics)، ملفات التصنيع (Gerbers)، الأكواد البرمجية (Firmware)، والوثائق المنشورة تُقدم "كما هي" دون أي ضمانات صريحة أو ضمنية بكفاءتها، أو أمانها، أو صلاحيتها لغرض معين.
- حدود المسؤولية (Limitation of Liability): لا يتحمل مؤسسو المجتمع، أو مشرفوه، أو الجهات الداعمة، أو مصممو المشاريع، أي مسؤولية قانونية، جنائية، أو مدنية عن أي أضرار (بما في ذلك الأضرار الجسدية، أو الحرائق، أو تلف الممتلكات) تنتج عن تصنيع، أو تجميع، أو استخدام أي أجهزة أو برمجيات تم تطويرها داخل المجتمع.
- الامتثال للقوانين المحلية (Compliance with Local Laws): المُصنّع أو المستخدم النهائي للمشروع هو المسؤول الوحيد عن ضمان توافق الأجهزة مع القوانين واللوائح المصرية، بما في ذلك لوائح "الجهاز القومي لتنظيم الاتصالات" (NTRA) فيما يخص الترددات الراديوية، ومعايير السلامة الكهربائية.
- الطبيعة التطوعية: هذا المجتمع مبادرة تطوعية، والآراء والتصاميم المطروحة تعبر عن أصحابها ولا تمثل بالضرورة الرأي الرسمي للجهات الحكومية أو الأكاديمية الداعمة.
⚙️ نظام العمليات المقترح الاصدار الاول 1.0
1. الإدارة العليا والتوجيه (Leadership & Admin)
هذه الأدوار تمتلك صلاحيات خطيرة ويجب أن تقتصر على مؤسسي المبادرة وممثلي الجهات الرسمية.
- 👑 OSHW Board (أو الإدارة):
- الصلاحية في ديسكورد: Administrator (تحكم كامل).
- الاستخدام الحقيقي: لك وللفريق الأساسي المؤسس للمجتمع. يسمح بإنشاء الفئات، ضبط البوتات، وربط السيرفر بـ GitHub Webhooks.
- 🏛️ ITIDA / EME Rep (ممثل هيئة/مبادرة):
- الصلاحية في ديسكورد: Manage Events و Mention @everyone.
- الاستخدام الحقيقي: مخصص لمسؤولي المبادرات الحكومية أو الداعمين لإنشاء فعاليات (Events) رسمية وإرسال الإعلانات في قناة
#announcementsدون التدخل في الجانب التقني العميق.
2. الإدارة التقنية للمشاريع (Technical Leadership)
هذا هو عصب مجتمع المصادر المفتوحة. هؤلاء هم من يراجعون التصاميم ويقودون التطوير.
- 🛠️ Core Maintainer (المشرف التقني):
- الصلاحية في ديسكورد: Manage Threads, Manage Messages, Pin Messages.
- الاستخدام الحقيقي: مهندسو البحث والتطوير الموثوقون. يمكنهم إغلاق النقاشات في قناة
#active-projectsإذا اكتمل المشروع (Mark as Solved)، تثبيت الرسائل المهمة التي تحتوي على روابط المستودعات (Repositories)، وتعديل الـ Tags للمشاريع.
- 🛡️ Moderator (مشرف المجتمع):
- الصلاحية في ديسكورد: Timeout Members, Kick/Ban, Manage Messages.
- الاستخدام الحقيقي: لحفظ النظام، مساعدة الطلاب الجدد في التوجيه للقنوات الصحيحة، ومسح الرسائل المزعجة (Spam).
3. التخصصات التقنية (Technical Tags)
هذه الأدوار لا تعطي صلاحيات إدارية، بل وظيفتها الأساسية هي التصنيف (Tagging). بدلاً من إزعاج كل السيرفر بـ @everyone، نستخدم هذه الأدوار لطلب المساعدة المخصصة.
- ⚡ Embedded Engineer
- 📐 Hardware Designer
- 🖨️ Maker / 3D Print
- 💻 Software Dev
الاستخدام الحقيقي: مهندس يكتب منشوراً في فورم المشاريع ويحتاج مراجعة لتصميم PCB، فيكتب في المنشور: "مطلوب مراجعة للمسارات من فضلكم يا @Hardware Designer". هكذا يصل الإشعار للمختصين فقط.
4. طبيعة العضوية (Affiliation)
تساعد في فهم تركيبة المجتمع لتوجيه النقاشات والفرص بشكل أفضل.
- 🎓 Student / Learner: طلاب الجامعات والفرق الطلابية (مثل فرق الروبوتات).
- 💼 Industry Professional: المهندسون العاملون في الشركات والمصانع.
- 🔬 Researcher / Academic: الباحثون الأكاديميون وأعضاء هيئة التدريس.
5. دور العزل (The Quarantine Role)
- 🔇 Restricted أو Read-Only:
- الصلاحية في ديسكورد: إزالة Send Messages و Create Posts.
- الاستخدام الحقيقي: إذا قام عضو بمخالفة قوانين الملكية الفكرية أو إثارة الشغب، يتم إعطاؤه هذا الدور مؤقتاً كعقاب، فيتمكن من قراءة المحتوى الهندسي دون القدرة على المشاركة أو التخريب.
📄 قالب مستودع الأكواد (GitHub README Template) المعياري
يحتوي هذا القسم على قوالب Markdown. تم تطوير المحرك (GitHub Style) مع دعم كامل لتلوين الأكواد (Syntax Highlighting) لترى النتيجة تماماً كما ستظهر على GitHub.
النسخة العربية (Arabic Version)
# [اسم المشروع بالعربية] | [Project Name in English] **Project UID (كود المشروع):** `OE-[DOM][ID]-[STATUS]` *(e.g., OE-EM001-WIP)* [](#) [](https://ohwr.org/cernohl) --- ## 📌 نبذة عن المشروع | Project Overview **عربي:** [اكتب هنا وصفاً دقيقاً للمشروع، المشكلة التي يحلها، والهدف منه. ركز على الجانب الهندسي والأثر المجتمعي إن وجد]. **English:** [Write a precise description of the project, the problem it solves, and its goal. Focus on the engineering aspect and social impact if any]. --- ## ⚙️ المواصفات التقنية | Technical Specifications | الميزة | المواصفات | Feature | Specification | | :--- | :--- | :--- | :--- | | **المتحكم الأساسي** | [مثال: ESP32-S3] | **MCU / SoC** | [e.g., ESP32-S3] | | **جهد التشغيل** | [مثال: 3.3V / 5V] | **Operating Voltage** | [e.g., 3.3V / 5V] | | **بروتوكولات الاتصال** | [مثال: I2C, SPI] | **Communication** | [e.g., I2C, SPI] | | **الأبعاد** | [مثال: 50x50 مم] | **Dimensions** | [e.g., 50x50 mm] | --- ## 📂 الهيكل البنيوي للمستودع | Repository Structure يتبع هذا المشروع نظام التكويد القياسي لمجتمع الأجهزة مفتوحة المصدر بمصر (OSHW-EG) لإدارة دورة حياة المنتج (PLM). This project follows the OSHW-EG standard Hybrid PLM coding system. ```text ├── Hardware/ (OE-EM001-PCB-RevA) # PCB Design files (Schematics, Routing, Gerbers) ├── Firmware/ (OE-EM001-FW-v1.0.0) # Source code for the microcontroller ├── Mechanical/ (OE-EM001-MEC-RevA) # 3D Printing files (STL/STEP) for the enclosure ├── BOM/ (OE-EM001-BOM-RevA) # Bill of Materials (CSV/Excel) └── Docs/ # Documentation, diagrams, and assembly images ``` --- ## 🛠️ تصميم الهاردوير | Hardware Design **عربي:** تم تصميم الدوائر المطبوعة (PCB) والمخططات (Schematics) باستخدام برنامج **[اسم البرنامج: KiCad / Altium]**. للوصول إلى ملفات التصنيع الجاهزة للطباعة (Gerbers) أو ملفات المصدر، يرجى مراجعة مجلد `Hardware`. > **ملاحظة:** تم مراعاة استخدام مكونات متوفرة في السوق المحلي المصري لضمان قابلية التصنيع. **English:** The PCB and Schematics were designed using **[Software Name: KiCad / Altium]**. To access the manufacturing files (Gerbers) or source files, please check the `Hardware` directory. > **Note:** The design utilizes components readily available in the local Egyptian market to ensure manufacturability. --- ## 💻 الكود البرمجي | Firmware **عربي:** يحتوي مجلد `Firmware` على الكود المصدري. * **بيئة التطوير (IDE):** [مثال: PlatformIO / ESP-IDF] * **خطوات رفع الكود (Flashing):** 1. [الخطوة الأولى] 2. [الخطوة الثانية] **English:** The `Firmware` directory contains the source code. * **Development Environment (IDE):** [e.g., PlatformIO / ESP-IDF] * **Flashing Steps:** 1. [Step 1] 2. [Step 2] --- ## 📦 قائمة المكونات | Bill of Materials (BOM) **عربي:** قائمة المكونات (BOM) مفصلة ومرفقة في مجلد `BOM`. تشمل القائمة المراجع (Designators)، القيم، وأرقام القطع (Part Numbers) لتسهيل عملية التجميع. **English:** A detailed Bill of Materials (BOM) is attached in the `BOM` directory. It includes Designators, Values, and Part Numbers to facilitate assembly. --- ## 🤝 المساهمة والمراجعة | Contribution & Design Review **عربي:** هذا المشروع مفتوح المصدر ومطابق لتعريف (OSHWA). نرحب بالمساهمات! لطلب مراجعة هندسية للمسارات (Routing) أو الكود، يرجى فتح منشور في قناة `#active-projects` على سيرفر ديسكورد واستخدام علامة `[Design Review]`. **English:** This is an open-source hardware project compliant with the OSHWA definition. Contributions are welcome! To request an engineering review for the routing or code, please open a post in the `#active-projects` channel on our Discord server and use the `[Design Review]` tag. 🔗 **[Join OSHW-EG Discord Server | انضم لسيرفر ديسكورد المجتمع](#)** --- ## ⚖️ الترخيص وإخلاء المسؤولية | License & Disclaimer **الترخيص | License:** * **Hardware:** Licensed under [CERN-OHL-W v2 / TAPR / etc.]. * **Software/Firmware:** Licensed under [MIT / GPLv3 / etc.]. * **Documentation:** Licensed under [CC-BY-SA 4.0]. **إخلاء مسؤولية | Legal Disclaimer (AS IS):** **عربي:** يتم توفير جميع الملفات والتصاميم "كما هي" دون أي ضمانات. المُصنّع أو المستخدم النهائي هو المسؤول الوحيد عن تجميع واختبار الأجهزة، والتأكد من مطابقتها لمعايير السلامة والقوانين المحلية. **English:** All files and designs are provided "AS IS" without any warranties. The manufacturer or end-user is solely responsible for assembling, testing, and ensuring the devices comply with safety standards and local laws.
النسخة الإنجليزية (English Version)
# [Project Name in English] **Project UID:** `OE-[DOM][ID]-[STATUS]` *(e.g., OE-EM001-WIP)* [](#) [](https://ohwr.org/cernohl) --- ## 📌 Project Overview [Write a precise description of the project, the problem it solves, and its goal. Focus on the engineering aspect and social impact if any]. --- ## ⚙️ Technical Specifications | Feature | Specification | | :--- | :--- | | **MCU / SoC** | [e.g., ESP32-S3] | | **Operating Voltage** | [e.g., 3.3V / 5V] | | **Communication** | [e.g., I2C, SPI] | | **Dimensions** | [e.g., 50x50 mm] | --- ## 📂 Repository Structure This project follows the OSHW-EG standard Hybrid PLM coding system. ```text ├── Hardware/ (OE-EM001-PCB-RevA) # PCB Design files (Schematics, Routing, Gerbers) ├── Firmware/ (OE-EM001-FW-v1.0.0) # Source code for the microcontroller ├── Mechanical/ (OE-EM001-MEC-RevA) # 3D Printing files (STL/STEP) for the enclosure ├── BOM/ (OE-EM001-BOM-RevA) # Bill of Materials (CSV/Excel) └── Docs/ # Documentation, diagrams, and assembly images ``` --- ## 🛠️ Hardware Design The PCB and Schematics were designed using **[Software Name: KiCad / Altium]**. To access the manufacturing files (Gerbers) or source files, please check the `Hardware` directory. > **Note:** The design utilizes components readily available in the local Egyptian market to ensure manufacturability. --- ## 💻 Firmware The `Firmware` directory contains the source code. * **Development Environment (IDE):** [e.g., PlatformIO / ESP-IDF] * **Flashing Steps:** 1. [Step 1] 2. [Step 2] --- ## 📦 Bill of Materials (BOM) A detailed Bill of Materials (BOM) is attached in the `BOM` directory. It includes Designators, Values, and Part Numbers to facilitate assembly. --- ## 🤝 Contribution & Design Review This is an open-source hardware project compliant with the OSHWA definition. Contributions are welcome! To request an engineering review for the routing or code, please open a post in the `#active-projects` channel on our Discord server and use the `[Design Review]` tag. 🔗 **[Join OSHW-EG Discord Server](#)** --- ## ⚖️ License & Disclaimer **License:** * **Hardware:** Licensed under [CERN-OHL-W v2 / TAPR / etc.]. * **Software/Firmware:** Licensed under [MIT / GPLv3 / etc.]. * **Documentation:** Licensed under [CC-BY-SA 4.0]. **Legal Disclaimer (AS IS):** All files and designs are provided "AS IS" without any warranties. The manufacturer or end-user is solely responsible for assembling, testing, and ensuring the devices comply with safety standards and local laws.