جدول المحتويات:

التحكم في الإصدار للأجهزة مفتوحة المصدر: 10 خطوات
التحكم في الإصدار للأجهزة مفتوحة المصدر: 10 خطوات

فيديو: التحكم في الإصدار للأجهزة مفتوحة المصدر: 10 خطوات

فيديو: التحكم في الإصدار للأجهزة مفتوحة المصدر: 10 خطوات
فيديو: أردوينو للمبتدئين - (11) التحكم في أجهزة الجهد العالي باستعمال الريليه 2024, شهر نوفمبر
Anonim
التحكم في الإصدار لأجهزة مفتوحة المصدر
التحكم في الإصدار لأجهزة مفتوحة المصدر

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

الخطوة 1: لماذا يتحكم الإصدار في إلكترونياتك؟

يعد التحكم في الإصدار (المعروف أيضًا باسم التحكم في المصدر أو التحكم في المراجعة) مفهومًا مفهومًا جيدًا ومعتمدًا على نطاق واسع في هندسة البرمجيات. الفكرة وراء التحكم بالمصادر هي تتبع التغييرات التي يتم إجراؤها على الكود المصدري لبرنامج أو تطبيق بشكل منهجي. إذا عطلت التغييرات التطبيق ، يمكنك إعادة ملفات التعليمات البرمجية المصدر إلى حالة عمل معروفة من الماضي. من الناحية العملية ، تسمح لك أنظمة التحكم بالمصادر بتتبع محفوظات مجموعة من الملفات (عادةً ما تكون ملفات التعليمات البرمجية المصدر لبرنامج كمبيوتر ، وموقع ويب ، وما إلى ذلك) ، وتصور التغييرات على هذه الملفات وإدارتها.

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

الخطوة 2: الأدوات: KiCad و Git

الأدوات: KiCad و Git
الأدوات: KiCad و Git

نستخدم أداتين رئيسيتين في هذا المشروع: نظام التحكم في الإصدار (VCS) وبرنامج أتمتة تصميم الإلكترونيات (EDA أو ECAD).

هناك العديد من أنظمة التحكم في الإصدار ، لكننا نستخدم VCS Git الموزع. نحن نستخدمه لعدد من الأسباب ، ولكن المفتاح هو أنه مفتوح المصدر (تحقق!) ، وسهل الاستخدام (تحقق!) ، و VCS القياسي الواقعي للبرامج مفتوحة المصدر (تحقق!). سنستخدم Git باعتباره VCS لتتبع التغييرات على الملفات التي يستخدمها برنامج ECAD الخاص بنا. لا يتطلب Instructable هذا الإلمام بـ Git ، ولكن يُفترض الراحة العامة باستخدام سطر الأوامر. سأحاول الربط بالموارد المفيدة لاستخدام كل من Git وسطر الأوامر حسب الضرورة.

تعمل معظم أنظمة التحكم بالمصادر بشكل جيد مع الملفات النصية ، لذا فإن برنامج ECAD الذي يستخدم الملفات النصية سيكون رائعًا. أدخل KiCad ، وهو برنامج مفتوح المصدر "Cross Platform و Open Source Electronics Design Automation Suite" بدعم من الباحثين في CERN. KiCad هو أيضًا مفتوح المصدر (تحقق!) ، سهل الاستخدام (على الرغم من أن البعض قد يختلف معي في ذلك) ، وقادر للغاية على أعمال تصميم الإلكترونيات المتقدمة.

الخطوة الثالثة: التثبيت

التركيب
التركيب
التركيب
التركيب

لتثبيت هذه البرامج ، اتبع الإرشادات من مواقع التنزيل المختلفة المرتبطة أدناه.

  • KiCad عبارة عن منصة مشتركة (ومذهلة للغاية ؛ تسرد صفحة التنزيل الخاصة بهم 13 نظام تشغيل مدعوم ، وتوفر تنزيلًا لشفرة المصدر إذا لم يناسبك أي منها). استخدم التثبيت الافتراضي الموحد kicad ، وليس بناء التطوير الليلي. راجع الخطوة 4 للحصول على تفاصيل اختيارية متقدمة حول تثبيت المكتبة.
  • Git هي أيضًا منصة مشتركة. إذا كنت تستخدم Windows ، فإنني أوصي بمشروع Git for Windows المثير للإعجاب للحصول على تجربة أكثر فائدة وكاملة الميزات.

ستكون وثائق التثبيت المتوفرة في كلا الموقعين أكثر اكتمالاً من أي وصف يمكنني تقديمه هنا. بمجرد تنزيل البرنامجين وتثبيتهما ، يمكنك استنساخ قالب مشروع Brainbow من مستودع Github الخاص بنا. يأخذ الأمر git clone البنية "git clone {src directory} {target directory}" ؛ بالنسبة لمشروعنا ، استخدم git clone https://github.com/builtbybrainbow/kicad-starter.git {target directory} `.

استنساخ git repo هو شكل خاص من أشكال النسخ ؛ عندما تقوم باستنساخ مشروع ، تحصل على نسخة من جميع الملفات المضمنة في الريبو بالإضافة إلى محفوظات المشروع التي تم تتبع Git بالكامل. من خلال استنساخ الريبو الخاص بنا ، تحصل على دليل مشروع منظم بالفعل مع توصياتنا لاستخدام Git مع KiCad. سنغطي المزيد حول هيكل المشروع في الخطوة 6 ، أو يمكنك التخطي إلى الخطوة 7 إذا كنت ترغب في العمل.

بعض مهام التدبير المنزلي السريعة - قم بتشغيل "git remote rm origin" لإزالة الارتباط إلى مشروع Github الذي نسخت منه. أيضًا ، قم بتشغيل `` git الالتزام - amend --author = "John Doe" ، مع استبدال معلمة المؤلف باسمك وبريدك الإلكتروني. هذا يعدل الالتزام الأخير (والذي في هذه الحالة هو أيضًا الالتزام الأول) ويغير المؤلف إليك ، بدلاً من Brainbow.

الخطوة 4: ملاحظة التثبيت: مكتبات KiCad

ملاحظة التثبيت: مكتبات KiCad
ملاحظة التثبيت: مكتبات KiCad

ملاحظة سريعة واحدة حول هيكل مكتبة KiCad. يوفر KiCad مجموعة من المكتبات التي يحتفظ بها فريق التطوير لمجموعة واسعة من المكونات الكهربائية. توجد ثلاث مكتبات رئيسية:

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

يتم تنزيل هذه المكتبات مع مجموعة برامج KiCad التي قمت بتثبيتها للتو. يمكنك استخدام KiCad دون بذل المزيد من الجهد. ومع ذلك ، بالنسبة إلى "المستخدمين المتميزين" ، يتم تخزين الملفات المصدر للمكتبات في مستودع git على Github ، مما يسمح للمستخدمين الذين يرغبون في البقاء على اطلاع بآخر التغييرات لاستنساخ مستودع المكتبة إلى أجهزتهم الخاصة. يحتوي تتبع المكتبات باستخدام git على عدد من المزايا - يمكنك اختيار الوقت الذي تريد فيه تحديث مكتباتك ، وتحتاج التحديثات فقط إلى دمج التغييرات في الملفات ، بدلاً من تنزيل مجموعة ملفات المكتبة بالكامل مرة أخرى. ومع ذلك ، فأنت مسؤول عن تحديث المكتبات ، وهو أمر يسهل نسيانه.

إذا كنت ترغب في استنساخ المكتبات ، فإن هذا الموقع يعرض تفاصيل Github repos KiCad المتنوعة. احصل على استنساخ المكتبات إلى جهاز الكمبيوتر الخاص بك (على سبيل المثال: `git clone https:// github.com / KiCad / kicad-symbols.git`) ، ثم افتح KiCad ، وحدد عنصر شريط القائمة" التفضيلات "، وانقر على" تكوين المسارات … ". يتيح لك هذا إخبار KiCad بمسار الدليل للبحث عن كل مكتبة فيه. متغيرات البيئة هذه افتراضيًا إلى المسار إلى المكتبات المثبتة مع تثبيت KiCad ؛ لقد لاحظت هذه القيم حتى أتمكن من العودة إلى المكتبات الافتراضية إذا لزم الأمر. يجب أن يشير مسار KICAD_SYMBOL_DIR إلى مكتبة رموز kicad المستنسخة ، و KISYSMOD إلى مكتبة kicad-footprints المستنسخة ، و KISYS3DMOD إلى مكتبة kicad -pack3d المستنسخة.

عندما تريد تحديث المكتبات ، يمكنك تشغيل أمر "git pull" بسيط في مكتبة الريبو والذي سيخبر Git بالتحقق من الاختلافات بين نسختك المحلية من ريبو المكتبة و Github "remote" repo ، وتحديثك تلقائيًا نسخة محلية لدمج التغييرات.

الخطوة 5: أساسيات Git

أساسيات Git
أساسيات Git

Git هو برنامج معقد ومتعدد الأوجه ، مع كتب كاملة مكرسة لإتقانه. ومع ذلك ، هناك بعض المفاهيم البسيطة التي ستساعدك على فهم كيفية استخدامنا لـ Git في سير عملنا.

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

هناك موضوعات أكثر تعقيدًا ، مثل التفرع وأجهزة التحكم عن بُعد ، لكننا لسنا بحاجة إلى استخدامها للحصول على مزايا التحكم في المصدر. كل ما نحتاجه هو تتبع التغييرات التي تطرأ على ملفات تصميم KiCad الخاصة بنا من خلال سلسلة من الالتزامات.

الخطوة 6: هيكل مشروع KiCad

هيكل مشروع كيكاد
هيكل مشروع كيكاد

دعنا نلقي نظرة فاحصة على هيكل مشروع KiCad-Starter الذي قمت باستنساخه مسبقًا. إنه مقسم إلى عدد من الأدلة الفرعية لتسهيل التنظيم:

  • الدائرة: يحتوي هذا المجلد على ملفات مشروع KiCad الفعلية (تخطيطي ، PCB ، إلخ). لا أقوم بإعادة تسمية هذا المجلد ، لكنني أقوم بإعادة تسمية جميع الملفات الموجودة بالداخل باسم المشروع (Circuit.pro => ArduinoMini.pro).

    • Circuit.pro: ملف مشروع KiCad
    • Circuit.sch: ملف KiCad التخطيطي.
    • Circuit.kicad_pcb: ملف تخطيط KiCad PCB.
  • التوثيق: هذا المجلد مخصص لتخزين الوثائق المتعلقة بالمشروع. لدينا خطط لتحسين هذه المساحة في المستقبل ، لكنها تحتوي حاليًا على ملف README بسيط. استخدمه لتخزين الملاحظات حول المشروع لتقوم بمراجعتها في المستقبل.
  • التصنيع: هذا المجلد هو المكان الذي ستخزن فيه ملفات جربر التي ستستخدمها معظم المنازل الجاهزة لتصنيع لوحة الدوائر الخاصة بك. نستخدمها أيضًا لتخزين ملفات BOM والمستندات الأخرى التي قد تكون ضرورية للتصنيع والتجميع.
  • المكتبات: هذا المجلد مخصص لتخزين ملفات المكتبة الخاصة بالمشروع (سنغطي هذا الأمر أكثر في بضع خطوات).

ربما لاحظت أيضًا بعض الملفات الأخرى (خاصةً إذا كنت "ls -a" الدليل). دليل.git هو المكان الذي يقوم فيه Git بعمل السحر ، حيث يقوم بتخزين محفوظات المستودع. يتم استخدام ملف.gitignore لإخبار Git بالملفات التي يجب تجاهلها وليس تخزينها في التحكم بالمصادر. هذه في الغالب ملفات نسخ احتياطي ينشئها KiCad ، أو بعض الملفات "المُنشأة" المختلفة ، مثل قوائم الشبكة ، والتي لا يجب تخزينها في التحكم بالمصادر لأنها تنشأ من المصدر الذي يمثل الملف التخطيطي.

هيكل المشروع هذا هو مجرد نقطة انطلاق. يجب عليك تكييفه ليناسب احتياجاتك ، وإضافة أقسام حسب الضرورة. في بعض المشاريع ، قمنا بتضمين مجلد برنامج أو مجلد حاوية ، حيث قمنا بتخزين نماذج لمرفقات طباعة ثلاثية الأبعاد للمشروع.

الخطوة 7: استخدام Git لمشاريع KiCad

استخدام Git لمشاريع KiCad
استخدام Git لمشاريع KiCad
استخدام Git لمشاريع KiCad
استخدام Git لمشاريع KiCad
استخدام Git لمشاريع KiCad
استخدام Git لمشاريع KiCad

نحن مستعدون أخيرًا لمعرفة كيفية استخدام Git لتتبع مشاريعك. لا يُقصد من Instructable أن يعلمك كيفية استخدام KiCad (على الرغم من أنني قد أفعل واحدًا في المستقبل إذا كان هناك طلب عليه) ، لذلك سنعرض بعض الأمثلة التافهة لنوضح لك كيفية تشغيل سير العمل. يجب أن يكون من السهل فهم كيفية تكييف هذه الأفكار مع مشروع حقيقي.

افتح دليل kicad-starter ، ثم قم بتشغيل `git log` لعرض سجل التنفيذ. يجب أن يكون هناك التزام واحد هنا ، تهيئة الريبو بواسطة Brainbow. سيخبرك تشغيل "git status" بحالة الملفات في الريبو الخاص بك (غير متعقب ، معدل ، محذوف ، مرحلي).

في الوقت الحالي ، يجب ألا يكون لديك أي تغييرات في الريبو الخاص بك. لنقم بالتغيير. افتح مشروع KiCad وأضف المقاوم إلى التخطيطي ، ثم احفظه. الآن يجب أن يظهر تشغيل "git status" أنك قمت بتعديل الملف التخطيطي ، لكنك لم تقم بإجراء هذه التغييرات للالتزام حتى الآن. إذا كنت مهتمًا بما فعله KiCad بالضبط عند إضافة المقاوم ، فيمكنك تشغيل الأمر diff على الملف المعدل "git diff Circuit / Circuit.sch". سيؤدي هذا إلى إبراز التغييرات بين الإصدار الحالي للملف في دليل العمل وحالة الملف في آخر التزام.

الآن بعد أن أجرينا تغييرًا ، دعنا نحاول تنفيذ هذا التغيير في سجل مشروعنا. نحتاج إلى نقل التغييرات من دليل العمل الخاص بنا إلى منطقة التدريج. هذا لا يقوم في الواقع بنقل الملفات في نظام الملفات ، ولكنه من الناحية المفاهيمية طريقة لإعلام Git أنك أجريت جميع التغييرات المخطط لها لملف معين وأنك جاهز لتنفيذ هذه التغييرات. بشكل مفيد ، يوفر Git بعض التلميحات عند تشغيل "git status" للإجراء التالي. لاحظ الرسالة `(استخدم" git add… "لتحديث ما سيتم الالتزام به)" ضمن التغييرات التي لم يتم تنظيمها للالتزام: `. يخبرك Git بكيفية نقل التغييرات إلى منطقة التدريج. قم بتشغيل "git add Circuit / Circuit.sch" لإجراء التغييرات ، ثم "git status" لمعرفة ما حدث. الآن نرى الملف التخطيطي تحت التغييرات التي يجب الالتزام بها. إذا كنت لا ترغب في تنفيذ هذه التغييرات بعد ، يقدم Git نصيحة أخرى مفيدة: `(استخدم" git reset HEAD … "لإلغاء المرحلة)`. نريد تنفيذ هذه التغييرات ، لذلك نقوم بتشغيل "git الالتزام -m" تمت إضافة المقاوم إلى التخطيطي ". هذا يُلزم التغييرات بالرسالة المقدمة. سيؤدي تشغيل سجل git إلى إظهار هذا الالتزام في محفوظات الالتزام بالمشروع.

بعض النصائح الإضافية حول الالتزامات.

  1. لا تلتزم مع كل إنقاذ. التزم عندما تشعر أنك وصلت إلى نقطة حيث تم ترسيخ تغييراتك إلى حد ما. ألتزم بعد أن أنهي التخطيطي ، وليس بعد كل إضافة مكون. لا ترغب أيضًا في الالتزام بشكل غير منتظم ، لأن تذكر سياق إجراء التغييرات التي أجريتها بعد 3 أسابيع قد يكون أمرًا صعبًا. يعد اكتشاف وقت الالتزام نوعًا من الفن ، لكنك ستصبح أكثر راحة كلما استخدمت Git أكثر.
  2. مصدر المتجر فقط (في الغالب). يتضمن ذلك ملفات المشروع والتخطيط والتخطيط ، بالإضافة إلى المكتبات الخاصة بالمشروع. يمكن أن يتضمن هذا أيضًا ملفات التوثيق. كن حذرًا عند تخزين العناصر المشتقة لأنها يمكن أن تخرج عن المزامنة مع المصدر الأصلي بسهولة ، وهذا يسبب الصداع لاحقًا. يتم إلغاء مزامنة ملفات BOM و gerber بسهولة خاصة ، لذلك من الأفضل تجنبها (على الرغم من تغطية إرشادات أكثر تفصيلاً في الخطوة 9).
  3. تعتبر رسائل الالتزام مفيدة للغاية ، ولكن رسائل الالتزام جيدة التنظيم لا تقدر بثمن. توفر هذه المقالة الممتازة بعض الإرشادات لكتابة رسائل التزام واضحة وموجزة ومفيدة. قد يتطلب القيام بذلك استخدام محرر نصوص في سطر الأوامر ، والذي يمكن أن يكون معقدًا بالنسبة للمبتدئين ("git الالتزام" بدون الخيار -m message سيفتح محرر نصوص). بالنسبة لمعظم الناس ، أوصي باستخدام محرر Nano. يحتوي StackOverflow على شرح جيد لتغيير المحرر الخاص بك

الخطوة 8: متقدم: الإصدار الدلالي للإلكترونيات

متقدم: الإصدار الدلالي للإلكترونيات
متقدم: الإصدار الدلالي للإلكترونيات

بالنسبة للأرواح المغامرة ، فإن النصائح التالية عبارة عن أفكار متقدمة مستقاة من ساعات عديدة من تطوير KiCad. إنها ليست مفيدة بشكل خاص في المشاريع الصغيرة ، لكنها يمكن أن توفر لك وجع قلبك لأن مشروعاتك تزداد تعقيدًا.

في البرمجيات ، هناك مفهوم التعيين الدلالي (semver). يحدد Semver منهجية تسمية شائعة لتحديد إصدارات البرامج من خلال "رقم الإصدار" ، باتباع نمط "Major. Minor. Patch". لاقتباس مواصفات semver ، فأنت تقدم رقم الإصدار وفقًا لفئات التغيير التالية.

  1. الإصدار الرئيسي عند إجراء تغييرات غير متوافقة في واجهة برمجة التطبيقات ،
  2. إصدار MINOR عندما تضيف وظائف بطريقة متوافقة مع الإصدارات السابقة ،
  3. إصدار PATCH عند إجراء إصلاحات أخطاء متوافقة مع الإصدارات السابقة.

نحن في Brainbow نستخدم نسختنا الخاصة من semver التي تم تكييفها لتناسب احتياجات مشاريع الأجهزة. تتبع المواصفات الخاصة بنا نفس نمط "Major. Minor. Patch" ، على الرغم من أن تعريفاتنا للتغييرات التي تندرج تحتها أي فئة تختلف بشكل واضح.

  1. الإصدار الرئيسي: يستخدم لإجراء تغييرات كبيرة على الوظائف الأساسية للدائرة (على سبيل المثال: تبديل المعالج من ATmegaa إلى ESP8266).
  2. إصدار MINOR: يستخدم لمبادلات المكونات التي قد تؤثر على تشغيل الدائرة (على سبيل المثال: تبديل فلاش SPI مع جزء متوافق مع دبوس قد يكون له مجموعة أوامر مختلفة) أو إضافة بعض الميزات الإضافية الثانوية (على سبيل المثال: مستشعر درجة حرارة إضافية).
  3. إصدار التصحيح: يستخدم لإصلاح الأخطاء الطفيفة التي لن تغير من عملية الدائرة (على سبيل المثال: تعديل الشاشة الحريرية ، تعديل بسيط لتخطيط التتبع ، مقايضات المكونات البسيطة مثل 0603 مكثف إلى 0805).

في semver للأجهزة ، يتم تحديث رقم الإصدار فقط عند التصنيع (تمامًا كما هو الحال في البرنامج ، تتغير أرقام الإصدارات فقط مع الإصدارات ، وليس كل فرد يلتزم بمشروع ما). نتيجة لذلك ، العديد من المشاريع لديها أرقام إصدارات منخفضة. لا يزال لدينا مشروع يستخدم أكثر من 4 إصدارات رئيسية.

بصرف النظر عن فوائد الاتساق والشمولية التي تحصل عليها من التبديل إلى نظام تسمية محدد جيدًا ، فإنك تكتسب أيضًا فوائد في توافق البرامج الثابتة ورضا العملاء. يمكن كتابة البرامج الثابتة مع الأخذ في الاعتبار إصدار اللوحة التي تستهدفها ، وقد يكون من الأسهل تصحيح الأخطاء بسبب عدم عمل برنامج معين على لوحة معينة ("صحيح ، البرنامج الثابت 2.4.1 لا يعمل على 1.2 المجالس لأننا لا نملك…. "). استفاد العملاء أيضًا من semver للأجهزة لأن خدمة العملاء واستكشاف الأخطاء وإصلاحها أسهل بكثير مع معيار محدد.

الخطوة 9: متقدم: استخدام الإصدار الدلالي للأجهزة

متقدم: استخدام إصدارات الأجهزة الدلالية
متقدم: استخدام إصدارات الأجهزة الدلالية

لاستخدام semver للأجهزة في مشاريعك الخاصة ، نستخدم ميزة Git تسمى وضع العلامات. عندما تقوم بتصنيع لوحة لأول مرة ، فهذا هو الإصدار 1.0.0 من تلك اللوحة. تأكد من تنفيذ جميع التغييرات في مشروعك ، ثم قم بتشغيل "git tag -a v1.0.0". سيؤدي هذا إلى فتح محرر حتى تتمكن من كتابة رسالة تعليق لهذه العلامة (تشبه إلى حد بعيد رسالة الالتزام). أقوم بتضمين تفاصيل حول التصنيع (من صنع PCB ، ومن قام بتجميع اللوحة) ، والتي يمكن أن تكون معلومات مفيدة لاحقًا.

تتم إضافة علامة الإصدار إلى محفوظات الالتزام وتشير إلى حالة الملفات عند تصنيع 1.0.0. يمكن أن يكون هذا مفيدًا بشكل خاص لعدة مراجعات لاحقًا عندما تحتاج إلى الرجوع إلى هذه النقطة لاستكشاف الأخطاء وإصلاحها. بدون علامة إصدار محددة ، قد يكون من الصعب معرفة الالتزام الأحدث وقت التصنيع. تتيح لك العلامة 1.0.0 (و 1.1 و 1.1.1 وما إلى ذلك) تحديد أن ملفات المصدر المحددة هذه هي تلك المستخدمة في عملية تصنيع معينة.

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

الخطوة 10: الخطوات التالية

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

يعمل Brainbow على دليل أكثر تفصيلاً لبعض الميزات الأكثر تقدمًا لسير العمل لدينا. نأمل أن ننشره في وقت ما خلال الأشهر القليلة القادمة. تابعنا هنا على Instructables ، وسنحرص على إعلامك عندما يمكنك قراءتها.

شكرًا على القراءة ، ولا نطيق الانتظار لمعرفة ما تصنعه!

موصى به: