Mục lục:

Kiểm soát phiên bản cho phần cứng nguồn mở: 10 bước
Kiểm soát phiên bản cho phần cứng nguồn mở: 10 bước

Video: Kiểm soát phiên bản cho phần cứng nguồn mở: 10 bước

Video: Kiểm soát phiên bản cho phần cứng nguồn mở: 10 bước
Video: Cách khôi phục Windows về trạng thái ban đầu #Shorts 2024, Tháng mười một
Anonim
Kiểm soát phiên bản cho phần cứng nguồn mở
Kiểm soát phiên bản cho phần cứng nguồn mở

Nhóm tại Brainbow có một số dự án điện tử đang được thực hiện và chúng tôi muốn chia sẻ quy trình sử dụng kiểm soát phiên bản để quản lý quy trình thiết kế thiết bị điện tử của chúng tôi. Quy trình làm việc này đã được sử dụng cho các dự án lớn và nhỏ, từ các bảng 2 lớp đơn giản đến các bảng khổng lồ 10 lớp phức tạp và dựa trên các công cụ mã nguồn mở. Hy vọng rằng những người khác có thể áp dụng quy trình làm việc của chúng tôi cho chính họ và đạt được lợi ích của việc kiểm soát phiên bản cho các dự án của riêng họ. Nhưng điều khiển phiên bản có thể mang lại những lợi ích gì cho một dự án điện tử?

Bước 1: Tại sao Phiên bản Kiểm soát Thiết bị Điện tử của Bạn?

Kiểm soát phiên bản (hay còn gọi là kiểm soát nguồn hoặc kiểm soát sửa đổi) là một khái niệm được hiểu rõ và áp dụng rộng rãi trong kỹ thuật phần mềm. Ý tưởng đằng sau kiểm soát nguồn là theo dõi một cách có hệ thống những thay đổi được thực hiện đối với mã nguồn của một chương trình hoặc ứng dụng. Nếu các thay đổi phá vỡ ứng dụng, bạn có thể hoàn nguyên các tệp mã nguồn về trạng thái hoạt động đã biết trước đây. Trên thực tế, hệ thống kiểm soát nguồn cho phép bạn theo dõi lịch sử của một tập hợp các tệp (thường là các tệp mã nguồn cho chương trình máy tính, trang web, v.v.), trực quan hóa và quản lý các thay đổi đối với các tệp đó.

Theo dõi lịch sử của các thay đổi đối với một dự án có vẻ hữu ích cho các dự án điện tử; nếu bạn mắc lỗi trong sơ đồ mạch hoặc sử dụng sai dấu chân thành phần trong bố cục PCB, sẽ rất tốt nếu bạn theo dõi những lỗi đã mắc phải và những bản sửa lỗi nào đã được thực hiện trong các bản sửa đổi khác nhau của một dự án. Nó cũng sẽ hữu ích cho các nhà sản xuất khác để xem lịch sử đó, và hiểu bối cảnh và động lực của những thay đổi khác nhau.

Bước 2: Công cụ: KiCad và Git

Công cụ: KiCad và Git
Công cụ: KiCad và Git

Chúng tôi sử dụng hai công cụ chính trong dự án này: hệ thống điều khiển phiên bản (VCS) và chương trình tự động hóa thiết kế điện tử (EDA hoặc ECAD).

Có NHIỀU hệ thống kiểm soát phiên bản trên mạng, nhưng chúng tôi sử dụng VCS Git phân tán. Chúng tôi sử dụng nó vì một số lý do, nhưng quan trọng là nó là mã nguồn mở (kiểm tra!), Dễ sử dụng (kiểm tra!) Và VCS tiêu chuẩn de-facto cho phần mềm nguồn mở (kiểm tra!). Chúng tôi sẽ sử dụng Git làm VCS để theo dõi các thay đổi đối với các tệp mà chương trình ECAD của chúng tôi sử dụng. Có thể hướng dẫn này không yêu cầu bạn phải quen thuộc với Git, nhưng bạn có thể sử dụng dòng lệnh này một cách thoải mái. Tôi sẽ cố gắng liên kết đến các tài nguyên hữu ích cho cả việc sử dụng Git và dòng lệnh khi cần thiết.

Hầu hết các hệ thống điều khiển nguồn hoạt động đặc biệt tốt đối với các tệp dựa trên văn bản, vì vậy một chương trình ECAD sử dụng tệp văn bản sẽ rất tuyệt vời. Nhập KiCad, "Bộ tự động hóa thiết kế điện tử đa nền tảng và nguồn mở" mã nguồn mở được hỗ trợ bởi các nhà nghiên cứu tại CERN. KiCad cũng là mã nguồn mở (kiểm tra!), Dễ sử dụng (mặc dù một số sẽ không đồng ý với tôi về điều đó) và có khả năng cao cho công việc thiết kế điện tử tiên tiến.

Bước 3: Cài đặt

Cài đặt
Cài đặt
Cài đặt
Cài đặt

Để cài đặt các chương trình này, hãy làm theo hướng dẫn từ các trang web tải xuống khác nhau được liên kết bên dưới.

  • KiCad là nền tảng đa nền tảng (và thật đáng ngạc nhiên; trang tải xuống của họ liệt kê 13 hệ điều hành được hỗ trợ và cung cấp tải xuống mã nguồn nếu không có hệ điều hành nào phù hợp với bạn). Sử dụng bản cài đặt mặc định được thống nhất bởi Statistics, không phải bản dựng phát triển hàng đêm. Xem Bước 4 để biết chi tiết tùy chọn nâng cao về cài đặt thư viện.
  • Git cũng đa nền tảng. Nếu sử dụng Windows, tôi sẽ giới thiệu dự án Git for Windows ấn tượng để có trải nghiệm hữu ích hơn, đầy đủ tính năng hơn.

Tài liệu cài đặt có sẵn tại cả hai trang web này sẽ đầy đủ hơn bất kỳ mô tả nào mà tôi có thể cung cấp ở đây. Sau khi cả hai chương trình được tải xuống và cài đặt, bạn có thể sao chép mẫu dự án của Brainbow từ kho lưu trữ Github của chúng tôi. Lệnh git clone nhận cấu trúc `git clone {src directory} {target directory}`; cho dự án của chúng tôi, hãy sử dụng `git clone https://github.com/builtbybrainbow/kicad-starter.git {target directory} '.

Sao chép git repo là một hình thức sao chép đặc biệt; khi bạn sao chép một dự án, bạn sẽ nhận được bản sao của tất cả các tệp có trong kho lưu trữ cũng như toàn bộ lịch sử được Git theo dõi của dự án. Bằng cách sao chép repo của chúng tôi, bạn sẽ nhận được một thư mục dự án đã được cấu trúc với các đề xuất của chúng tôi để sử dụng Git với KiCad. Chúng tôi sẽ trình bày thêm về cấu trúc dự án trong Bước 6, hoặc bạn có thể chuyển sang Bước 7 nếu bạn muốn bắt đầu làm việc.

Một vài tác vụ dọn dẹp nhà cửa nhanh chóng - chạy `git remote rm origin` để xóa liên kết đến dự án Github mà bạn đã nhân bản. Ngoài ra, hãy chạy `git commit --amend --author =" John Doe "`, thay thế tham số tác giả bằng tên và email của bạn. Điều này sửa đổi cam kết cuối cùng (trong trường hợp này cũng là cam kết đầu tiên) và thay đổi tác giả thành bạn, thay vì Brainbow.

Bước 4: Ghi chú cài đặt: Thư viện KiCad

Lưu ý cài đặt: Thư viện KiCad
Lưu ý cài đặt: Thư viện KiCad

Một lưu ý nhanh về cấu trúc thư viện của KiCad. KiCad cung cấp một bộ thư viện được duy trì bởi nhóm nhà phát triển cho một loạt các thành phần điện. Có ba thư viện chính:

  • Biểu tượng sơ đồ: Các ký hiệu được sử dụng để biểu diễn các thành phần điện tử trong một bản vẽ sơ đồ mạch.
  • Dấu chân PCB: Bản vẽ 2D thể hiện dấu chân thực tế (miếng đồng, văn bản trên màn hình lụa, v.v.) được sử dụng khi lắp đặt mạch trên PCB.
  • Mô hình 3D: Mô hình 3D của các thành phần điện tử.

Các thư viện này được tải xuống cùng với bộ chương trình KiCad mà bạn vừa cài đặt. Bạn có thể sử dụng KiCad mà không cần nỗ lực nữa. Tuy nhiên, đối với "người dùng thành thạo", các tệp nguồn của thư viện được lưu trữ trong kho lưu trữ git trên Github, cho phép người dùng muốn cập nhật những thay đổi mới nhất có thể sao chép kho thư viện vào máy của họ. Theo dõi thư viện bằng git có một số ưu điểm - bạn có thể chọn thời điểm bạn muốn cập nhật thư viện của mình và các bản cập nhật chỉ cần kết hợp các thay đổi đối với tệp, thay vì tải xuống lại toàn bộ tập hợp tệp thư viện. Tuy nhiên, bạn có trách nhiệm cập nhật các thư viện, điều này có thể dễ dàng bị quên.

Nếu bạn muốn sao chép các thư viện, trang web này trình bày chi tiết các cung cấp KiCad đại diện Github khác nhau. Git sao chép thư viện vào máy tính của bạn (ví dụ: `git clone https:// github.com / KiCad / Regiad-Symbol.git`), sau đó mở KiCad, chọn mục" Preferences "trên thanh menu và nhấp vào" Định cấu hình đường dẫn… ". Điều này cho phép bạn cho KiCad biết đường dẫn thư mục để tìm kiếm từng thư viện trong đó. Các biến môi trường này mặc định là đường dẫn đến các thư viện được cài đặt bằng bản cài đặt KiCad; Tôi đã lưu ý các giá trị này để có thể chuyển về thư viện mặc định nếu cần. Đường dẫn KICAD_SYMBOL_DIR phải trỏ đến thư viện biểu tượng Browsead được nhân bản của bạn, KISYSMOD tới thư viện phong cách chân đế được nhân bản và KISYS3DMOD tới thư viện truyền mã lệnh đa phương tiện nhân bản.

Khi bạn muốn cập nhật các thư viện, bạn có thể chạy một lệnh đơn giản `git pull` trong kho thư viện, lệnh này sẽ cho Git biết để kiểm tra sự khác biệt giữa bản sao cục bộ của kho thư viện và repo" từ xa "của Github và tự động cập nhật bản sao cục bộ để kết hợp các thay đổi.

Bước 5: Nguyên tắc cơ bản về Git

Nguyên tắc cơ bản về Git
Nguyên tắc cơ bản về Git

Git là một chương trình phức tạp và nhiều khía cạnh, với toàn bộ cuốn sách dành để làm chủ nó. Tuy nhiên, có một vài khái niệm đơn giản sẽ giúp bạn hiểu cách chúng tôi đang sử dụng Git trong quy trình làm việc của mình.

Git theo dõi các thay đổi đối với tệp bằng một loạt các giai đoạn. Các thay đổi bình thường diễn ra trong thư mục làm việc. Khi bạn hài lòng với những thay đổi bạn đã thực hiện đối với một loạt tệp, bạn thêm các tệp bạn đã thay đổi vào vùng tổ chức. Khi bạn đã thực hiện tất cả các thay đổi mà bạn dự định và sắp xếp tất cả các tệp bạn muốn theo dõi trong Git, bạn cam kết những thay đổi đó vào kho lưu trữ. Cam kết về cơ bản là ảnh chụp nhanh trạng thái của tệp trong kho lưu trữ tại một thời điểm cụ thể. Vì Git theo dõi các thay đổi đối với tệp và lưu trữ những thay đổi này trong các cam kết, nên tại bất kỳ thời điểm nào bạn có thể hoàn nguyên dự án về trạng thái của nó ở bất kỳ cam kết nào trước đó.

Có những chủ đề phức tạp hơn, như phân nhánh và điều khiển từ xa, nhưng chúng ta không cần sử dụng những chủ đề này để đạt được lợi ích của việc kiểm soát nguồn. Tất cả những gì chúng ta cần là theo dõi các thay đổi đối với các tệp thiết kế KiCad của mình với một loạt các cam kết.

Bước 6: Cấu trúc dự án KiCad

Cấu trúc dự án KiCad
Cấu trúc dự án KiCad

Chúng ta hãy xem xét kỹ hơn cấu trúc của dự án KiCad-Starter mà bạn đã nhân bản trước đó. Nó được chia thành một số thư mục con để dễ tổ chức:

  • Circuit: Thư mục này chứa các tệp dự án KiCad thực tế (sơ đồ, PCB, v.v.). Tôi không đổi tên thư mục này, nhưng tôi đổi tên tất cả các tệp bên trong bằng tên của dự án (Circuit.pro => ArduinoMini.pro).

    • Circuit.pro: tệp dự án KiCad
    • Circuit.sch: tệp sơ đồ KiCad.
    • Circuit.kicad_pcb: tệp bố cục KiCad PCB.
  • Tài liệu: Thư mục này dùng để lưu trữ tài liệu liên quan đến dự án. Chúng tôi có kế hoạch cải thiện không gian này trong tương lai, nhưng hiện tại nó chứa một tệp README đơn giản. Sử dụng nó để lưu trữ các ghi chú về dự án để bạn xem lại trong tương lai.
  • Chế tạo: Thư mục này là nơi bạn sẽ lưu trữ các tệp vi mạch mà hầu hết các nhà fab sẽ sử dụng để sản xuất bảng mạch của bạn. Chúng tôi cũng sử dụng nó để lưu trữ các tệp BOM và các tài liệu khác có thể cần cho quá trình sản xuất và lắp ráp.
  • Thư viện: Thư mục này dùng để lưu trữ các tệp thư viện dành riêng cho dự án (chúng tôi sẽ trình bày kỹ hơn về vấn đề này trong một vài bước).

Bạn cũng có thể nhận thấy một vài tệp khác (đặc biệt nếu bạn `ls -a` thư mục). Thư mục.git là nơi Git thực hiện điều kỳ diệu, lưu trữ lịch sử của kho. Tệp.gitignore được sử dụng để cho Git biết tệp nào nó nên bỏ qua và không lưu trữ trong điều khiển nguồn. Đây chủ yếu là các tệp sao lưu mà KiCad tạo hoặc một vài tệp "được tạo" khác, như danh sách mạng, không nên được lưu trữ trong kiểm soát nguồn vì chúng được tạo từ nguồn là tệp giản đồ.

Cấu trúc dự án này chỉ là một điểm khởi đầu. Bạn nên điều chỉnh nó để phù hợp với nhu cầu của mình và thêm các phần nếu cần. Trong một số dự án, chúng tôi đã bao gồm một thư mục phần mềm hoặc thư mục bao vây, nơi chúng tôi lưu trữ các mô hình cho vỏ máy in 3d cho dự án.

Bước 7: Sử dụng Git cho các dự án KiCad

Sử dụng Git cho các dự án KiCad
Sử dụng Git cho các dự án KiCad
Sử dụng Git cho các dự án KiCad
Sử dụng Git cho các dự án KiCad
Sử dụng Git cho các dự án KiCad
Sử dụng Git cho các dự án KiCad

Cuối cùng, chúng tôi đã sẵn sàng để xem cách sử dụng Git để theo dõi các dự án của bạn. Có thể giảng dạy này không nhằm mục đích dạy bạn cách sử dụng KiCad (mặc dù tôi có thể làm một điều đó trong tương lai nếu có nhu cầu về nó), vì vậy chúng tôi sẽ chạy qua một số ví dụ nhỏ để cho bạn biết quy trình làm việc chạy như thế nào. Sẽ rất dễ hiểu làm thế nào để điều chỉnh những ý tưởng này vào một dự án thực tế.

Mở thư mục Regiad-starter, sau đó chạy `git log` để hiển thị lịch sử cam kết. Nên có một cam kết ở đây, quá trình khởi tạo repo bằng Brainbow. Chạy `git status` sẽ cho bạn biết trạng thái của các tệp trong kho lưu trữ của bạn (chưa được theo dõi, sửa đổi, xóa, theo giai đoạn).

Hiện tại, bạn sẽ không có thay đổi nào trong repo của mình. Hãy thay đổi. Mở dự án KiCad và thêm một điện trở vào sơ đồ, sau đó lưu. Bây giờ chạy `git status` sẽ cho thấy rằng bạn đã sửa đổi tệp sơ đồ, nhưng chưa tổ chức các thay đổi đó cho cam kết. Nếu bạn tò mò về những gì chính xác KiCad đã làm khi bạn thêm điện trở, bạn có thể chạy lệnh diff trên tệp đã sửa đổi `git diff Circuit / Circuit.sch`. Điều này sẽ làm nổi bật những thay đổi giữa phiên bản hiện tại của tệp trong thư mục làm việc và trạng thái của tệp ở lần cam kết cuối cùng.

Bây giờ chúng tôi đã thực hiện một thay đổi, hãy thử cam kết thay đổi đó vào lịch sử dự án của chúng tôi. Chúng tôi cần chuyển các thay đổi từ thư mục làm việc của mình sang khu vực dàn dựng. Điều này không thực sự di chuyển các tệp trong hệ thống tệp, nhưng về mặt khái niệm là một cách để cho Git biết rằng bạn đã thực hiện tất cả các thay đổi theo kế hoạch của mình cho một tệp cụ thể và sẵn sàng thực hiện những thay đổi đó. Một cách hữu ích, Git cung cấp một số gợi ý khi bạn chạy `git status` cho hành động tiếp theo. Lưu ý thông báo `(sử dụng" git add… "để cập nhật những gì sẽ được cam kết)` trong `Các thay đổi không theo giai đoạn cho cam kết:`. Git đang cho bạn biết cách di chuyển các thay đổi đến khu vực tổ chức. Chạy `git add Circuit / Circuit.sch` để thực hiện các thay đổi, sau đó chạy` git status` để xem điều gì đã xảy ra. Bây giờ chúng ta thấy tệp sơ đồ dưới các thay đổi được cam kết. Nếu bạn chưa muốn thực hiện những thay đổi này, Git sẽ hữu ích đưa ra một mẹo khác: `(sử dụng" git reset HEAD… "để bỏ gắn)`. Chúng tôi muốn cam kết những thay đổi này, vì vậy chúng tôi chạy `git commit -m" Đã thêm điện trở vào sơ đồ "`. Điều này cam kết các thay đổi với thông báo đã cung cấp. Chạy nhật ký git sẽ hiển thị cam kết này trong lịch sử cam kết của dự án.

Một vài mẹo khác về cam kết.

  1. Đừng cam kết với mỗi lần tiết kiệm. Hãy cam kết khi bạn cảm thấy rằng bạn đã đạt đến điểm mà những thay đổi của bạn đã được củng cố phần nào. Tôi cam kết sau khi tôi hoàn thành một giản đồ, không phải sau mỗi lần bổ sung thành phần. Bạn cũng không muốn cam kết quá thường xuyên, bởi vì việc ghi nhớ bối cảnh lý do tại sao bạn thực hiện những thay đổi mà bạn đã thực hiện 3 tuần sau đó có thể khó khăn. Tìm ra thời điểm cam kết là một nghệ thuật, nhưng bạn sẽ cảm thấy thoải mái hơn khi sử dụng Git nhiều hơn.
  2. Chỉ lưu trữ nguồn (chủ yếu). Điều này bao gồm các tệp dự án, giản đồ và bố cục, cũng như các thư viện dành riêng cho dự án. Điều này cũng có thể bao gồm các tệp tài liệu. Hãy cẩn thận khi lưu trữ các đối tượng có nguồn gốc vì chúng có thể dễ dàng bị mất đồng bộ với nguồn gốc và điều đó gây ra đau đầu về sau. Các tệp BOM và gerber được khử đồng bộ đặc biệt dễ dàng, do đó, tốt hơn là nên tránh (mặc dù hướng dẫn chi tiết hơn được đề cập trong Bước 9).
  3. Thông điệp cam kết rất hữu ích, nhưng thông điệp cam kết có cấu trúc tốt là vô giá. Bài viết tuyệt vời này cung cấp một số hướng dẫn để viết các thông điệp cam kết rõ ràng, ngắn gọn, hữu ích. Làm như vậy có thể yêu cầu sử dụng trình soạn thảo văn bản dòng lệnh, điều này có thể phức tạp đối với người mới bắt đầu (`git commit` mà không có tùy chọn -m message sẽ mở trình soạn thảo văn bản). Đối với hầu hết mọi người, tôi khuyên bạn nên sử dụng trình soạn thảo Nano. StackOverflow có một lời giải thích tốt về việc thay đổi trình chỉnh sửa của bạn

Bước 8: Nâng cao: Phiên bản ngữ nghĩa cho Điện tử

Nâng cao: Phiên bản ngữ nghĩa cho Điện tử
Nâng cao: Phiên bản ngữ nghĩa cho Điện tử

Đối với những người thích phiêu lưu, những lời khuyên sau đây là những ý tưởng tiên tiến, được đúc kết từ nhiều giờ phát triển KiCad. Chúng không đặc biệt hữu ích cho các dự án nhỏ hơn, nhưng chúng thực sự có thể giúp bạn đỡ đau lòng khi các dự án của bạn ngày càng phức tạp.

Trong phần mềm, có khái niệm Phiên bản ngữ nghĩa (semver). Semver định nghĩa một phương pháp đặt tên phổ biến để xác định các bản phát hành phần mềm theo "số phiên bản", theo mẫu "Major. Minor. Patch". Để trích dẫn thông số kỹ thuật của semver, bạn đặt trước số phiên bản theo các danh mục thay đổi sau.

  1. Phiên bản CHÍNH khi bạn thực hiện các thay đổi API không tương thích,
  2. Phiên bản MINOR khi bạn thêm chức năng theo cách tương thích ngược,
  3. PATCH phiên bản khi bạn thực hiện các bản sửa lỗi tương thích ngược.

Chúng tôi tại Brainbow sử dụng phiên bản semver của riêng mình được điều chỉnh để phù hợp với nhu cầu của các dự án phần cứng. Thông số kỹ thuật của chúng tôi tuân theo cùng một mẫu "Major. Minor. Patch", mặc dù định nghĩa của chúng tôi về những thay đổi thuộc danh mục nào rõ ràng là khác nhau.

  1. Phiên bản CHÍNH: được sử dụng cho những thay đổi đáng kể đối với chức năng cốt lõi của mạch (ví dụ: chuyển bộ xử lý từ ATmegaa sang ESP8266).
  2. Phiên bản MINOR: được sử dụng cho các hoán đổi linh kiện có thể ảnh hưởng đến hoạt động của mạch (ví dụ: hoán đổi flash SPI với bộ phận tương thích với chân cắm có thể có bộ lệnh khác) hoặc bổ sung một số tính năng bổ sung nhỏ (ví dụ: thêm cảm biến nhiệt độ bổ sung).
  3. Phiên bản PATCH: được sử dụng cho các bản sửa lỗi nhỏ sẽ không thay đổi hoạt động của mạch (ví dụ: điều chỉnh màn hình lụa, điều chỉnh bố cục dấu vết nhỏ, hoán đổi thành phần đơn giản như tụ điện 0603 thành 0805).

Trong học kỳ phần cứng, số phiên bản chỉ được cập nhật khi sản xuất (cũng giống như trong phần mềm, số phiên bản chỉ thay đổi theo các bản phát hành, không phải mọi cá nhân cam kết với một dự án). Do đó, nhiều dự án có số phiên bản thấp. Chúng tôi vẫn chưa có một dự án nào sử dụng nhiều hơn 4 phiên bản chính.

Bên cạnh những lợi ích về tính nhất quán và dễ hiểu mà bạn nhận được khi chuyển sang một hệ thống đặt tên được xác định rõ, bạn cũng có được lợi ích về khả năng tương thích với phần sụn và sự hài lòng của khách hàng. Phần mềm cơ sở có thể được viết trong khi tính đến phiên bản của bo mạch mà nó đang nhắm mục tiêu và có thể dễ dàng hơn để gỡ lỗi tại sao một chương trình cụ thể không hoạt động trên một bo mạch cụ thể ( đúng rồi, chương trình cơ sở 2.4.1 không chạy trên 1.2 bảng vì chúng tôi không có….”). Khách hàng cũng đã được hưởng lợi từ học kỳ phần cứng của chúng tôi vì dịch vụ khách hàng và khắc phục sự cố dễ dàng hơn nhiều với một tiêu chuẩn xác định.

Bước 9: Nâng cao: Sử dụng Phiên bản ngữ nghĩa phần cứng

Nâng cao: Sử dụng Phiên bản ngữ nghĩa phần cứng
Nâng cao: Sử dụng Phiên bản ngữ nghĩa phần cứng

Để sử dụng semver phần cứng trong các dự án của riêng bạn, chúng tôi sử dụng một tính năng Git được gọi là gắn thẻ. Khi bạn lần đầu tiên sản xuất một bảng, đó là phiên bản 1.0.0 của bảng đó. Đảm bảo rằng bạn đã cam kết tất cả các thay đổi trong dự án của mình, sau đó chạy `git tag -a v1.0.0`. Thao tác này sẽ mở một trình chỉnh sửa để bạn có thể viết thông báo chú thích cho thẻ này (rất giống với thông báo cam kết). Tôi bao gồm thông tin chi tiết về quá trình sản xuất (người sản xuất PCB, người lắp ráp bo mạch), đây có thể là thông tin hữu ích sau này.

Thẻ phát hành được thêm vào lịch sử cam kết và cho biết trạng thái của các tệp ở phiên bản 1.0.0. Điều này có thể đặc biệt hữu ích cho một số bản sửa đổi sau này khi bạn cần tham khảo lại điểm này để khắc phục sự cố. Nếu không có thẻ phát hành cụ thể, rất khó để tìm ra cam kết nào là gần đây nhất tại thời điểm sản xuất. Thẻ 1.0.0 (và 1.1, 1.1.1, v.v.) cho phép bạn chỉ định rằng các tệp nguồn cụ thể này là những tệp được sử dụng trong một quá trình sản xuất cụ thể.

Một lưu ý trên Gerbers. Một số nhà fab yêu cầu các tập tin gerber để tạo bảng của bạn và bạn có thể tạo chúng bằng KiCad. Đây là các đối tượng có nguồn gốc, được tạo từ tệp.kicad_pcb nguồn và chúng tôi thường không kiểm soát phiên bản các tệp dẫn xuất. Tại Brainbow, chúng tôi không lưu trữ chuột nhảy trong kiểm soát phiên bản NGOẠI TRỪ khi chúng tôi gắn thẻ một bản phát hành. Khi chúng tôi đã sẵn sàng xây dựng, chúng tôi tạo các tệp gerber, lưu trữ chúng trong thư mục Chế tạo và cam kết và gắn thẻ. Sau đó, chúng tôi loại bỏ các mầm và cam kết xóa. Điều này thoạt nghe có vẻ hơi khó hiểu, nhưng nó đảm bảo rằng các cam kết bình thường chỉ lưu trữ các tệp nguồn và các bản phát hành được gắn thẻ cũng lưu trữ các tệp chính xác được sử dụng để sản xuất bảng. Điều này đã được chứng minh là hữu ích đáng kể trong việc theo dõi các lỗi sản xuất vài tuần sau đó.

Bước 10: Các bước tiếp theo

Hy vọng rằng phần giới thiệu này đã dạy bạn đủ để bắt đầu sử dụng kiểm soát phiên bản trên các dự án điện tử của riêng bạn. Chúng tôi đã không đi đến một số chủ đề nâng cao hơn, như kiểm soát phiên bản cho các thư viện được chia sẻ giữa các dự án hoặc các nhánh tính năng. Tuy nhiên, kiểm soát phiên bản giống như ăn rau của bạn: bạn có thể không nhận được những gì bạn nghĩ bạn nên làm, nhưng mỗi bit bạn đều có giá trị.

Brainbow đang nghiên cứu hướng dẫn chi tiết hơn về một số tính năng nâng cao hơn trong quy trình làm việc của chúng tôi. Chúng tôi hy vọng sẽ xuất bản nó trong vài tháng tới. Hãy theo dõi chúng tôi tại đây trên Bảng hướng dẫn và chúng tôi chắc chắn sẽ thông báo cho bạn khi bạn có thể đọc nó.

Cảm ơn bạn đã đọc và chúng tôi không thể chờ đợi để xem những gì bạn tạo ra!

Đề xuất: