Kontrol ng Bersyon para sa Open Source Hardware: 10 Mga Hakbang

2024 May -akda: John Day | [email protected]. Huling binago: 2024-01-30 13:14

Ang koponan sa Brainbow ay may maraming mga proyekto sa electronics sa ilalim ng aming sinturon, at nais naming ibahagi ang aming proseso para sa paggamit ng kontrol sa bersyon upang pamahalaan ang aming daloy ng trabaho sa disenyo ng electronics. Ang daloy ng trabaho na ito ay ginamit para sa mga proyekto na malaki at maliit, mula sa simpleng 2 layer board hanggang sa kumplikadong 10 layer behemoths, at batay sa mga tool na open-source. Inaasahan namin, ang iba ay maaaring magpatibay ng aming daloy ng trabaho para sa kanilang sarili, at makakuha ng mga benepisyo ng kontrol sa bersyon para sa kanilang sariling mga proyekto. Ngunit anong mga benepisyo ang maaring mag-alok ng kontrol sa bersyon ng isang proyekto sa electronics?

Hakbang 1: Bakit Kinokontrol ng Bersyon ang Iyong Elektronika?

Ang Control ng Bersyon (aka control sa aka o control ng rebisyon) ay isang maunawain at malawak na pinagtibay na konsepto sa software engineering. Ang ideya sa likod ng pagkontrol ng mapagkukunan ay sistematikong sumusubaybay sa mga pagbabago na ginawa sa source code ng isang programa o aplikasyon. Kung nasira ng mga pagbabago ang application, maaari mong ibalik ang mga file ng source code sa isang kilalang estado ng pagtatrabaho mula sa nakaraan. Sa pagsasagawa, pinapayagan ka ng mga system ng pagkontrol ng mapagkukunan na subaybayan ang kasaysayan ng isang koleksyon ng mga file (karaniwang mga file ng source code para sa isang computer program, website, atbp), at mailarawan at pamahalaan ang mga pagbabago sa mga file na iyon.

Ang pagsubaybay sa kasaysayan ng mga pagbabago sa isang proyekto ay tila kapaki-pakinabang para sa mga proyekto sa electronics; kung nakagawa ka ng pagkakamali sa circuit scheme, o gumamit ng maling bahagi ng yapak ng paa sa layout ng PCB, mainam na subaybayan kung anong mga pagkakamali ang nagawa at kung anong mga pag-aayos ang ipinatupad sa iba't ibang mga pagbabago ng isang proyekto. Magiging kapaki-pakinabang din para sa ibang mga gumagawa na makita ang kasaysayan na iyon, at maunawaan ang konteksto at mga pagganyak ng iba't ibang mga pagbabago.

Hakbang 2: Ang Mga Tool: KiCad at Git

Gumagamit kami ng dalawang pangunahing tool sa proyektong ito: ang bersyon control system (VCS) at ang electronics design automation program (EDA o ECAD).

Maraming mga sistema ng kontrol sa bersyon doon, ngunit ginagamit namin ang ipinamigay na VCS Git. Ginagamit namin ito para sa isang bilang ng mga kadahilanan, ngunit ang pangunahing ay ito ay open-source (suriin!), Madaling gamitin (suriin!), At ang de-facto standard VCS para sa open-source software (suriin!). Gagamitin namin ang Git bilang VCS upang subaybayan ang mga pagbabago sa mga file na ginagamit ng aming ECAD na programa. Ang Tagubilin na Ito ay hindi nangangailangan ng pamilyar sa Git, ngunit ipinapalagay ang pangkalahatang ginhawa sa paggamit ng linya ng utos. Susubukan kong mag-link sa mga kapaki-pakinabang na mapagkukunan para sa parehong paggamit ng Git at linya ng utos kung kinakailangan.

Karamihan sa mga mapagkukunan ng pagkontrol ng mapagkukunan ay gumagana nang partikular para sa mga file na nakabatay sa teksto, kaya't ang isang programa na ECAD na gumagamit ng mga file ng teksto ay magiging mahusay. Ipasok ang KiCad, ang open-source na "Cross Platform at Open Source Electronics Design Automation Suite" na sinusuportahan ng mga mananaliksik sa CERN. Ang KiCad ay bukas din na mapagkukunan (suriin!), Madaling gamitin (kahit na ang ilan ay hindi sumasang-ayon sa akin tungkol doon), at may kakayahang para sa advanced na gawaing disenyo ng electronics.

Hakbang 3: Pag-install

Upang mai-install ang mga programang ito, sundin ang mga tagubilin mula sa kanilang iba't ibang mga site sa pag-download na naka-link sa ibaba.

• Ang KiCad ay cross-platform (at nahihilo-ly kaya; ang kanilang pahina sa pag-download ay naglilista ng 13 sinusuportahan na mga OS, at nag-aalok ng isang pag-download ng source code kung wala sa mga naaangkop sa iyo). Gamitin ang naka-default na pag-install ng kicad, hindi ang nightly development build. Tingnan ang Hakbang 4 para sa mga advanced na opsyonal na detalye sa pag-install ng library.
• Ang Git ay cross-platform din. Kung gumagamit ng Windows, inirerekumenda ko ang kahanga-hangang proyekto ng Git for Windows para sa isang mas kapaki-pakinabang, ganap na tampok na karanasan.

Ang dokumentasyon ng pag-install na magagamit sa parehong mga site na ito ay magiging mas kumpleto kaysa sa anumang paglalarawan na maalok ko rito. Kapag na-download at na-install ang parehong mga programa, maaari mong i-clone ang template ng proyekto ng Brainbow mula sa aming Github na imbakan. Kinukuha ng utos ng git clone ang istrakturang `git clone {src Directory} {target na direktoryo}`; para sa aming proyekto, gamitin ang `git clone https://github.com/builtbybrainbow/kicad-starter.git {target Directory}`.

Ang cloning ng isang git repo ay isang espesyal na anyo ng pagkopya; kapag na-clone mo ang isang proyekto, makakakuha ka ng isang kopya ng lahat ng mga file na kasama sa repo pati na rin ang buong kasaysayan na sinusubaybayan ng Git ng proyekto. Sa pamamagitan ng pag-clone ng aming repo, nakakakuha ka ng isang direktoryo ng proyekto na nakaayos na sa aming mga rekomendasyon para sa paggamit ng Git sa KiCad. Masasaklaw namin ang higit pa tungkol sa istraktura ng proyekto sa Hakbang 6, o maaari kang lumaktaw sa Hakbang 7 kung nangangati ka upang makapagtrabaho.

Ilang mabilis na gawain sa pag-aalaga ng bahay - patakbuhin ang `git remote rm origin` upang alisin ang link sa proyekto ng Github na iyong na-clone. Gayundin, patakbuhin ang `git commit --amend --author =" John Doe "`, na pinapalitan ang parameter ng may-akda ng iyong pangalan at email. Binabago nito ang huling pagtataguyod (na sa kasong ito ay ang unang gumawa din) at binabago ang may-akda sa iyo, kaysa sa Brainbow.

Hakbang 4: Tala ng Pag-install: KiCad Library

Isang mabilis na tala tungkol sa istraktura ng library ng KiCad. Nagbibigay ang KiCad ng isang hanay ng mga aklatan na pinapanatili ng pangkat ng developer para sa isang malawak na hanay ng mga de-koryenteng sangkap. Mayroong tatlong pangunahing mga aklatan:

• Mga Simbolo ng Skematika: Mga simbolo na ginamit para sa kumakatawan sa mga elektronikong sangkap sa isang guhit na eskematiko ng circuit.
• Mga Footprint ng PCB: 2D na mga guhit na kumakatawan sa aktwal na bakas ng paa (mga pad ng tanso, teksto ng silkscreen, atbp) na gagamitin kapag inilalagay ang circuit sa isang PCB.
• Mga Modelong 3D: Mga modelo ng 3D ng mga elektronikong sangkap.

Ang mga library na ito ay na-download kasama ang KiCad program suite na na-install mo lang. Maaari mong gamitin ang KiCad nang walang anumang pagsisikap. Gayunpaman, para sa "mga gumagamit ng kuryente", ang mga mapagkukunang file para sa mga aklatan ay nakaimbak sa isang git repository sa Github, na pinapayagan ang mga gumagamit na nais na manatiling napapanahon sa mga pinakabagong pagbabago upang ma-clone ang mga repo ng library sa kanilang sariling makina. Ang pagsubaybay sa mga aklatan gamit ang git ay may isang bilang ng mga kalamangan - maaari kang pumili kung nais mong i-update ang iyong mga aklatan, at kailangan lamang isama ng mga pag-update ang mga pagbabago sa mga file, sa halip na i-download muli ang buong hanay ng mga file ng library. Gayunpaman, responsable ka sa pag-update ng mga aklatan, na maaaring madaling kalimutan.

Kung nais mong i-clone ang mga aklatan, ang site na ito ay nagdedetalye ng iba't ibang mga Github repos na inaalok ng KiCad. I-clone ng Git ang mga aklatan sa iyong computer (hal: `git clone https:// github.com / KiCad / kicad-simbolo.git`), pagkatapos buksan ang KiCad, piliin ang menu bar na" Mga Kagustuhan "na item, at i-click ang" I-configure ang Mga Path … ". Hinahayaan ka nitong sabihin sa KiCad ang path ng direktoryo upang maghanap para sa bawat aklatan. Ang mga variable ng kapaligiran na ito ay default sa path sa mga aklatan na naka-install sa pag-install ng KiCad; Naitala ko ang mga halagang ito upang makabalik ako sa mga default na aklatan kung kinakailangan. Ang landas ng KICAD_SYMBOL_DIR ay dapat magturo sa iyong na-clone na library ng mga simbolo ng kicad, KISYSMOD sa na-clone na library ng kicad-footprints, at KISYS3DMOD sa na-clone na kicad-packages3d library.

Kung nais mong i-update ang mga aklatan, maaari kang magpatakbo ng isang simpleng 'git pull` na utos sa repo ng library na sasabihin kay Git na suriin ang mga pagkakaiba sa pagitan ng iyong lokal na kopya ng repo ng library at ang "remote" na repo ng Github, at awtomatikong i-update ang iyong lokal na kopya upang isama ang mga pagbabago.

Hakbang 5: Mga Batayan ng Git

Ang Git ay isang kumplikado at maraming-facade na programa, na may buong aklat na nakatuon sa mastering ito. Gayunpaman, mayroong ilang simpleng mga konsepto na makakatulong sa iyo na maunawaan kung paano namin ginagamit ang Git sa aming daloy ng trabaho.

Sinusubaybayan ni Git ang mga pagbabago sa mga file gamit ang isang serye ng mga yugto. Ang mga normal na pagbabago ay nagaganap sa gumaganang direktoryo. Kapag nasiyahan ka sa mga pagbabagong nagawa mo sa isang serye ng mga file, idaragdag mo ang mga file na iyong binago sa lugar ng pagtatanghal. Kapag nagawa mo na ang lahat ng mga pagbabagong plano mo at itanghal ang lahat ng mga file na nais mong subaybayan sa Git, isinasagawa mo ang mga pagbabagong iyon sa lalagyan. Ang mga pangako ay mahalagang snapshot ng estado ng mga file sa isang repo sa isang tukoy na oras. Dahil sinusubaybayan ng Git ang mga pagbabago sa mga file at iniimbak ang mga pagbabagong ito sa mga komit, sa anumang punto maaari mong ibalik ang isang proyekto pabalik sa estado na ito ay nasa anumang paunang naisagawa.

Mayroong mas kumplikadong mga paksa, tulad ng pagsasanga at mga remote, ngunit hindi namin kailangang gamitin ang mga ito upang makakuha ng mga benepisyo ng pagkontrol sa mapagkukunan. Ang kailangan lang namin ay subaybayan ang mga pagbabago sa aming mga file ng disenyo ng KiCad na may isang serye ng mga komit.

Hakbang 6: Istraktura ng KiCad Project

Tingnan natin nang mabuti ang istraktura ng proyekto ng KiCad-Starter na na-clone mo kanina. Nahahati ito sa isang bilang ng mga subdirectory para sa madaling pag-aayos:

• Circuit: Naglalaman ang folder na ito ng aktwal na mga file ng proyekto ng KiCad (eskematiko, PCB, atbp.). Hindi ko pinangalanan ang folder na ito, ngunit pinalitan ko ng pangalan ang lahat ng mga file sa loob ng pangalan ng proyekto (Circuit.pro => ArduinoMini.pro).

  • Circuit.pro: ang file ng proyekto ng KiCad
  • Circuit.sch: ang KiCad na eskematiko na file.
  • Circuit.kicad_pcb: ang file ng layout ng KiCad PCB.
• Dokumentasyon: Ang folder na ito ay para sa pagtatago ng dokumentasyon tungkol sa proyekto. Mayroon kaming mga plano para sa pagpapabuti ng puwang na ito sa hinaharap, ngunit sa ngayon naglalaman ito ng isang simpleng file na README. Gamitin ito upang mag-imbak ng mga tala sa proyekto para sa susuriin mo sa hinaharap.
• Katha: Ang folder na ito ay kung saan mo iimbak ang mga gerber file na ang karamihan sa mga bahay ng fab ay gagamitin para sa pagmamanupaktura ng iyong circuit board. Ginagamit din namin ito upang mag-imbak ng mga file ng BOM at iba pang mga dokumento na maaaring kailanganin para sa pagmamanupaktura at pagpupulong.
• Mga Aklatan: Ang folder na ito ay para sa pagtatago ng mga file ng library na tukoy sa proyekto (tatalakayin namin ito sa ilang mga hakbang).

Maaaring napansin mo rin ang ilang iba pang mga file (lalo na kung "ls -a` mo ang direktoryo). Ang direktoryo ng.git ay kung saan ginagawa ito ni Git, ito ay nag-iimbak ng kasaysayan ng imbakan. Ginamit ang.gitignore file upang sabihin sa Git kung aling mga file ang dapat nitong balewalain at hindi itabi sa pagkontrol ng mapagkukunan. Karamihan sa mga ito ay mga backup na file na nabubuo ng KiCad, o ilang magkakaibang "nabuong" mga file, tulad ng mga netlist, na hindi dapat itago sa pagkontrol ng mapagkukunan dahil nabuo ang mga ito mula sa pinagmulan na ang eskematiko na file.

Ang istraktura ng proyekto na ito ay isang panimulang punto lamang. Dapat mong iakma ito upang umangkop sa iyong mga pangangailangan, at magdagdag ng mga seksyon kung kinakailangan. Sa ilang mga proyekto nagsama kami ng isang folder ng software o folder ng enclosure, kung saan nag-iimbak kami ng mga modelo para sa mga 3d na enclosure sa pag-print para sa proyekto.

Hakbang 7: Paggamit ng Git para sa Mga Proyekto sa KiCad

Sa wakas handa na kaming makita kung paano gamitin ang Git para sa pagsubaybay sa iyong mga proyekto. Ang Instructable na ito ay hindi inilaan upang turuan ka kung paano gamitin ang KiCad (kahit na maaari kong gawin ang isa sa hinaharap kung may pangangailangan para dito), kaya tatakbo kami sa ilang mga walang kuwentang halimbawa upang maipakita sa iyo kung paano tumatakbo ang daloy ng trabaho. Dapat ay madaling maunawaan kung paano iakma ang mga ideyang ito sa isang tunay na proyekto.

Buksan ang direktoryo ng kicad-starter, pagkatapos ay patakbuhin ang `git log` upang maipakita ang kasaysayan ng gumawa. Dapat mayroong isang komit dito, ang pagsisimula ng repo ng Brainbow. Ang pagpapatakbo ng `git status` ay magsasabi sa iyo ng katayuan ng mga file sa iyong repo (hindi naka-track, binago, tinanggal, itinanghal).

Sa ngayon, dapat kang walang mga pagbabago sa iyong repo. Gumawa tayo ng pagbabago. Buksan ang proyekto ng KiCad at magdagdag ng isang risistor sa eskematiko, pagkatapos ay i-save. Ang pagpapatakbo ng `git status` ngayon ay dapat ipakita na binago mo ang file na eskematiko, ngunit hindi pa itinanghal ang mga pagbabagong iyon para sa pag-commit. Kung nag-usisa ka tungkol sa kung ano mismo ang ginawa ng KiCad nang idinagdag mo ang risistor, maaari mong patakbuhin ang diff command sa binagong file na `git diff Circuit / Circuit.sch`. Itatampok nito ang mga pagbabago sa pagitan ng kasalukuyang bersyon ng file sa gumaganang direktoryo at ng estado ng file sa huling pagkakagawa.

Ngayong nakagawa kami ng pagbabago, subukang gawin ang pagbabagong iyon sa aming kasaysayan ng proyekto. Kailangan naming ilipat ang mga pagbabago mula sa aming gumaganang direktoryo sa lugar ng pagtatanghal. Hindi nito aktwal na inililipat ang mga file sa file system, ngunit ayon sa konsepto ay isang paraan ng pagpapaalam sa Git na nagawa mo na ang lahat ng iyong mga nakaplanong pagbabago para sa isang partikular na file at handa nang gawin ang mga pagbabagong iyon. Sa kapaki-pakinabang, nagbibigay si Git ng ilang mga pahiwatig kapag pinatakbo mo ang `git status` para sa susunod na pagkilos. Pansinin ang mensahe `(gamitin ang" git add… "upang i-update kung ano ang gagawin) sa ilalim ng` Mga pagbabagong hindi itinanghal para sa mangako: `. Sinasabi sa iyo ni Git kung paano ilipat ang mga pagbabago sa lugar ng pagtatanghal ng dula. Patakbuhin ang `git idagdag ang Circuit / Circuit.sch` upang i-entablado ang mga pagbabago, pagkatapos ay` git status` upang makita kung ano ang nangyari. Ngayon nakikita namin ang eskematiko na file sa ilalim ng mga pagbabago na naisagawa. Kung hindi mo pa nais na gawin ang mga pagbabagong ito, tumutulong si Git na mag-alok ng isa pang tip: `(gamitin ang" git reset HEAD … "sa unstage)`. Nais naming gawin ang mga pagbabagong ito, kaya nagpapatakbo kami ng `git commit -m" Nagdagdag ng risistor sa eskematiko "`. Ginagawa nito ang mga pagbabago sa ibinigay na mensahe. Ang pagpapatakbo ng git log ay ipapakita ang paggawa na ito sa kasaysayan ng proyekto na gumawa.

Ang ilan pang mga tip tungkol sa mga pangako.

1. Huwag mangako sa bawat pag-save. Mangako kung naramdaman mo na umabot ka sa isang punto kung saan medyo nagpatatag ang iyong mga pagbabago. Nakatuon ako pagkatapos kong matapos ang isang eskematiko, hindi pagkatapos ng bawat karagdagan ng sangkap. Hindi mo rin nais na gumawa ng masyadong madalang, dahil ang pag-alala sa konteksto kung bakit mo ginawa ang mga pagbabago na ginawa mo 3 linggo sa paglaon ay maaaring maging mahirap. Ang pag-alam kung kailan dapat mangako ay isang sining, ngunit mas magiging komportable ka habang ginagamit mo ang Git nang higit pa.
2. Pinagmulan lamang ng tindahan (karamihan). Kasama rito ang mga file ng proyekto, eskematiko, at layout, pati na rin mga aklatan na tukoy sa proyekto. Maaari rin itong magsama ng mga file ng dokumentasyon. Mag-ingat sa pag-iimbak ng mga nakuha na bagay sapagkat maaari silang madaling mai-sync sa orihinal na mapagkukunan nang madali, at na sanhi ng pananakit ng ulo sa paglaon. Ang mga file ng BOM at gerber ay nakakakuha ng de-synchronize na partikular na madali, kaya mas mahusay na maiwasan (kahit na mas detalyadong patnubay ang sakop sa Hakbang 9).
3. Napaka kapaki-pakinabang ng mga mensahe ng pangako, ngunit ang mahusay na nakabalangkas na mga mensahe ng pangako ay napakahalaga. Ang mahusay na artikulong ito ay nagbibigay ng ilang mga alituntunin para sa pagsulat ng malinaw, maigsi, kapaki-pakinabang na mga mensahe ng pangako. Ang paggawa nito ay maaaring mangailangan ng paggamit ng isang editor ng teksto ng linya ng utos, na maaaring kumplikado sa akin para sa mga nagsisimula (`git commit` nang walang pagpipiliang -m na mensahe ay magbubukas ng isang text editor). Para sa karamihan ng mga tao, inirerekumenda ko ang Nano editor. Ang StackOverflow ay may magandang paliwanag sa pagbabago ng iyong editor

Hakbang 8: Advanced: Semantic Versioning para sa Electronics

Para sa mga mapangahas na kaluluwa, ang mga sumusunod na tip ay mga advanced na ideya, na nakuha mula sa maraming oras ng pag-unlad ng KiCad. Hindi sila partikular na kapaki-pakinabang sa mas maliit na mga proyekto, ngunit maaari ka talagang makatipid sa iyo ng sakit ng puso habang lumalaki sa kumplikado ang iyong mga proyekto.

Sa software, mayroong isang konsepto ng Semantic Versioning (semver). Tinukoy ng Semver ang isang karaniwang pamamaraan ng pagbibigay ng pangalan upang makilala ang paglabas ng software sa pamamagitan ng "numero ng bersyon", na sumusunod sa isang pattern ng "Major. Minor. Patch". Upang mai-quote ang spec ng semver, isulong mo ang numero ng bersyon alinsunod sa mga sumusunod na kategorya ng pagbabago.

1. MAJOR na bersyon kapag gumawa ka ng hindi tugma na mga pagbabago sa API,
2. MINOR na bersyon kapag nagdagdag ka ng pag-andar sa isang paatras na katugmang paraan,
3. Bersyon ng PATCH kapag gumawa ka ng mga pag-aayos ng bug na paatras.

Kami sa Brainbow ay gumagamit ng aming sariling bersyon ng semver na inangkop upang magkasya sa mga pangangailangan ng mga proyekto sa hardware. Ang aming spec ay sumusunod sa parehong pattern na "Major. Minor. Patch", bagaman ang aming mga kahulugan ng kung anong mga pagbabago ang nahuhulog sa ilalim ng aling kategorya ang malinaw na magkakaiba.

1. MAJOR na bersyon: ginamit para sa mga makabuluhang pagbabago sa pangunahing pagpapaandar ng circuit (hal: paglipat ng processor mula sa ATmegaa hanggang sa ESP8266).
2. MINOR na bersyon: ginamit para sa mga swap ng bahagi na maaaring makaapekto sa operasyon ng circuit (hal: SPI flash swap na may pin-compatible na bahagi na maaaring magkaroon ng ibang hanay ng utos) o pagdaragdag ng ilang menor de edad na karagdagang tampok (hal: nagdagdag ng karagdagang sensor ng temperatura).
3. Bersyon ng PATCH: ginamit para sa mga menor de edad na pag-aayos na hindi magbabago sa operasyon ng circuit (hal: pagsasaayos ng silkscreen, pag-aayos ng menor de edad na layout, simpleng mga swap ng sangkap tulad ng 0603 capacitor sa 0805).

Sa hardware semver, ang numero ng bersyon ay na-update lamang sa paggawa (tulad din sa software, ang mga numero ng bersyon ay nagbabago lamang sa mga paglabas, hindi bawat indibidwal na nangangako sa isang proyekto). Bilang isang resulta, maraming mga proyekto ang may mababang mga numero ng bersyon. Mayroon pa kaming isang proyekto na gumagamit ng higit sa 4 pangunahing mga bersyon.

Bukod sa mga benepisyo sa pagkakapare-pareho at pagkaunawa na nakukuha mo mula sa paglipat sa isang maayos na tinukoy na sistema, nakakakuha ka rin ng mga benepisyo sa pagiging tugma ng firmware at kasiyahan ng customer. Ang firmware ay maaaring nakasulat habang isinasaalang-alang ang bersyon ng board na tina-target nito, at maaaring mas madaling i-debug kung bakit ang isang partikular na programa ay hindi gumagana sa isang partikular na board ("tama, ang 2.4.1 firmware ay hindi tatakbo sa 1.2 board dahil wala kaming ….. "). Nakinabang din ang mga customer mula sa aming hardware semver dahil ang serbisyo sa customer at pag-troubleshoot ay mas madali sa isang tinukoy na pamantayan.

Hakbang 9: Advanced: Paggamit ng Hardware Semantic Versioning

Upang magamit ang hardware semver sa iyong sariling mga proyekto, gumagamit kami ng tampok na Git na tinatawag na pag-tag. Noong una mong paggawa ng isang board, iyon ang 1.0.0 na bersyon ng board na iyon. Tiyaking nagawa mo ang lahat ng mga pagbabago sa iyong proyekto, pagkatapos ay patakbuhin ang `git tag -a v1.0.0`. Magbubukas ito ng isang editor upang maaari kang magsulat ng isang mensahe ng anotasyon para sa tag na ito (halos kapareho ng isang mensahe na gumawa). Nagsasama ako ng mga detalye tungkol sa pagmamanupaktura (na gumawa ng PCB, na nagtipon ng lupon), na maaaring maging kapaki-pakinabang na impormasyon sa paglaon.

Ang tag ng paglabas ay idinagdag sa kasaysayan ng gumawa at ipinapahiwatig ang estado ng mga file sa paggawa ng 1.0.0. Ito ay maaaring maging partikular na kapaki-pakinabang ng maraming mga pagbabago sa paglaon kapag kailangan mong sumangguni sa puntong ito para sa pag-troubleshoot. Nang walang tinukoy na tag ng paglabas, maaaring mahirap malaman kung aling ang gumawa ang pinakahuli sa oras ng paggawa. Hinahayaan ka ng isang tag na 1.0.0 (at 1.1, 1.1.1, atbp) na tukuyin na ang mga tukoy na mga file ng mapagkukunan na ito ay ginamit sa isang partikular na pagpapatakbo ng pagmamanupaktura.

Isang tala sa Gerbers. Ang ilang mga bahay na fab ay nangangailangan ng mga gerber file upang gawin ang iyong board, at maaari mo silang mabuo sa KiCad. Ang mga ito ay nagmula sa mga bagay, na nabuo mula sa pinagmulan.kicad_pcb file, at hindi namin normal na kontrolin ang bersyon na nagmula sa mga file. Kami sa Brainbow ay hindi nag-iimbak ng mga gerber sa kontrol ng bersyon Maliban sa kapag nag-tag kami ng isang paglabas. Kapag handa na kaming bumuo, bumubuo kami ng mga gerber file, iimbak ang mga ito sa Fabrication folder, at gumawa at i-tag. Pagkatapos ay tinatanggal namin ang mga gerbers at ginawang pagtanggal. Ito ay maaaring tila isang maliit na nakalilito sa una, ngunit tinitiyak nito na ang normal na paggawa ay nag-iimbak lamang ng mga file ng mapagkukunan, at ang mga naka-tag na paglabas ay nag-iimbak din ng eksaktong mga file na ginamit sa paggawa ng mga board. Ito ay napatunayang kapaki-pakinabang sa pagsubaybay sa mga error sa pagmamanupaktura pagkalipas ng ilang linggo.

Hakbang 10: Susunod na Mga Hakbang

Inaasahan namin na ang panimula na ito ay nagturo sa iyo ng sapat upang magsimulang gumamit ng kontrol sa bersyon sa iyong sariling mga proyekto sa electronics. Hindi kami nakarating sa ilan sa mga mas advanced na paksa, tulad ng kontrol sa bersyon para sa mga library na ibinahagi sa pagitan ng mga proyekto o tampok na sangay. Gayunpaman, ang kontrol sa bersyon ay tulad ng pagkain ng iyong mga gulay: maaaring hindi mo makuha kung ano ang iniisip mong dapat, ngunit bawat halaga ay nabibilang ka.

Gumagawa ang Brainbow ng isang mas detalyadong gabay sa ilan sa mga mas advanced na tampok ng aming daloy ng trabaho. Inaasahan namin na mai-publish ito minsan sa mga susunod na buwan. Sundin kami dito sa Mga Tagubilin, at siguraduhin naming ipaalam sa iyo kung mabasa mo ito.

Salamat sa pagbabasa, at hindi kami makapaghintay upang makita kung ano ang iyong ginawa!