如何將器件庫遷移至DigiPCBA

對于準(zhǔn)備將設(shè)計(jì)流程完全遷移至DigiPCBA平臺上的用戶來說，可能遇到的第一個(gè)挑戰(zhàn)就是如何將手上現(xiàn)有的元器件遷移至云端。這篇教程將會展示如何使用Altium Designer軟件提供的Library Migrator工具，完成一個(gè)新建Workspace的初始設(shè)置，隨后將本地元件庫遷移至其上。

Library Migrator支持所有的元件庫類型。需要遷移的源數(shù)據(jù)可以是集成庫，DB Library，也可以是獨(dú)立的原理圖符號庫。無論來源庫的類型如何，操作都大同小異。下面的介紹會以較有代表性的DB Library為示例。示例用的元件庫可以在Gitee上找到 library-migrator-user-guide

創(chuàng)建文件結(jié)構(gòu)

Workspace創(chuàng)建時(shí)默認(rèn)設(shè)置的文件夾結(jié)構(gòu)比較簡單，對于大型的元件庫來說很多時(shí)候都不能滿足需求。我們可以從界面右下角的Panels中選擇Explorer打開游覽器來游覽和修改Workspace中內(nèi)容。

以Capacitor文件夾為例，可以看見默認(rèn)創(chuàng)建的Capacitor文件夾只有一個(gè)，而電容往往數(shù)量龐大。一個(gè)大型的元件庫可能有幾千到幾萬條關(guān)于電容的記錄。如果所有的電容都遷移至這個(gè)文件夾內(nèi)，那么后期無論是游覽或者維護(hù)其中內(nèi)容的效率都會被大大拖慢。

類似的晶體管相關(guān)的文件夾也只有Transistor一個(gè)。而我們準(zhǔn)備遷移的元件庫中包含了四種類型的MOSFET，并且希望每種MOSFET都被遷移到對應(yīng)的文件夾。所以我們需要自己豐富預(yù)設(shè)的文件夾結(jié)構(gòu)。右擊Transistor文件夾，選擇Add Subfolder。由于Transistor的文件夾類型是Component，所以默認(rèn)創(chuàng)建的子文件夾類型也與其保持一致。如果需要不同類型的文件夾類型，可以在Folder Type中進(jìn)行修改。

我們在Transistor下面新建MOSFET，P-Channel, N-Channel, Multi-Channel和SCR四個(gè)子文件夾，結(jié)構(gòu)如下圖所示

設(shè)置器件類型

調(diào)用云端的器件可以通過在Explorer中右鍵器件然后選擇Place放置。不過更方便的方式是通過界面右側(cè)的Components面板進(jìn)行搜索和調(diào)用。點(diǎn)擊面板頂部的All，展開器件類型結(jié)構(gòu)可以看見默認(rèn)創(chuàng)建的器件類型定義。

值得注意的是這里顯示的樹狀結(jié)構(gòu)和Explorer中看見的文件夾結(jié)構(gòu)并無關(guān)聯(lián)。我們剛才創(chuàng)建的MOSFET相關(guān)的目錄結(jié)構(gòu)并沒有出現(xiàn)。實(shí)際上這里顯示的結(jié)構(gòu)完全取決于器件類型的定義。

并且與默認(rèn)創(chuàng)建的文件夾結(jié)構(gòu)類似，默認(rèn)創(chuàng)建的器件類型比較簡單，難以滿足大型元件庫的需求。為了能在Component面板中顯示與Explorer中類似的目錄結(jié)構(gòu)我們需要自己創(chuàng)建一些新的分類。點(diǎn)擊右上角的齒輪圖標(biāo)，打開Preference對話框，在Data Management下面找到Component Types。在這里我們可以觀察到器件類型之間的關(guān)聯(lián)決定了Components面板上顯示的層次結(jié)構(gòu)。

我們右擊Transistor為其添加一系列子類型。

創(chuàng)建模板

在定義器件類型時(shí)，我們看見在Name邊上還有兩列數(shù)據(jù)，Template和Default Folder。Default Folder定義了該類型器件的默認(rèn)上傳路徑。這個(gè)參數(shù)無法直接設(shè)置，但是我們可以通過將器件類型和模板綁定來間接的定義發(fā)布路徑。

如果要為某個(gè)器件類型綁定一個(gè)創(chuàng)建好的模板，可以通過Component Types左下方的Templates進(jìn)行指定。

而要創(chuàng)建一個(gè)新的模板，則需要回到Explorer中進(jìn)行。依次點(diǎn)開Managed Content>>Templates>>Component Templates。點(diǎn)擊右上角Add Template來創(chuàng)建一個(gè)新模板。

模板里有許多關(guān)于云端器件的預(yù)定義設(shè)置，我們先來看看這次要用到的兩項(xiàng)。在Default Folder一項(xiàng)中可以設(shè)置默認(rèn)的器件上傳路徑，這也是此前我們在Component Types中看見的Defautl Folder的內(nèi)容來源。而Parameters中的ComponentType可以綁定已經(jīng)創(chuàng)建的器件類型。

對于剛才創(chuàng)建的器件類型，我們分別為每個(gè)類型都創(chuàng)建一個(gè)模板。

完成編輯之后，點(diǎn)擊Save將模板文件保存至云端。然后我們回到Component Types頁面，會發(fā)現(xiàn)器件類型和模板已經(jīng)一一對應(yīng)。

至此我們已經(jīng)完成兩項(xiàng)重要的準(zhǔn)備工作，可以進(jìn)入遷移流程。

簡單模式

打開準(zhǔn)備遷移的DB Library文件(mosfet_db.DbLib)。從菜單欄File>>Migrate Library啟動migrator, 通過此種方式啟動的Migrator默認(rèn)進(jìn)入Simple Mode。在此模式下，我們只需要點(diǎn)擊右下角的Migrate按鈕就可以輕松的將器件發(fā)布至云端，無需擔(dān)心任何參數(shù)配置問題。

但是在很多情況下，默認(rèn)發(fā)布配置并不能滿足我們的需求。用戶需要更精準(zhǔn)的器件分類，更復(fù)雜的Lifecycle設(shè)置，結(jié)構(gòu)層次更多的文件路徑。此時(shí)我們可以通過點(diǎn)擊頁面上的settings或者左下角的Advanced按鈕來打開Properties對話框來進(jìn)行詳細(xì)的配置。

高級模式

在進(jìn)入Advance模式之后，可以看見Library Migrator嘗試對元件庫中的器件進(jìn)行了自動分類，示例中的MOSFET沒有正確的被Migrator識別，因此類別顯示為Uncategorized。通過點(diǎn)擊準(zhǔn)備遷移的器件，可以在下方的Details區(qū)域中查看到將和這個(gè)器件一起被遷移的關(guān)聯(lián)數(shù)據(jù)，包括Models，Datasheets和供應(yīng)鏈信息。

云端相關(guān)參數(shù)配置

接下來打開Properties對話框（快捷鍵 F11），點(diǎn)擊Advanced標(biāo)簽。在這里我們可以定義遷移器件的目的地，命名格式，Lifecycle等一系列和Workspace相關(guān)的參數(shù)。其中Naming Scheme，Revsion Naming Schema和Lifecycle這幾個(gè)參數(shù)一般保持默認(rèn)設(shè)置即可。

Library Migrator在執(zhí)行遷移之前會檢查器件中是否有重復(fù)，其檢查的對象可以在Unique Field中設(shè)置。這里我們保持和DB Library相同的設(shè)置，使用Name作為索引，或者也可以指定參數(shù)Partnubmer作為索引。

正如我們看見的，器件的遷移目的地可以通過Component相關(guān)的參數(shù)配置。但是我們暫時(shí)不做修改，只將Symbol和Footprint的目標(biāo)遷移地址修改為我們需要的文件夾。原因在下面的教程中會有解釋。

器件類型與遷移路徑

這兩項(xiàng)在遷移元件庫時(shí)都是重要的參數(shù)，兩者可以分別在Properties的General和Advanced標(biāo)簽下設(shè)置。值得注意的是在Properties中配置的參數(shù)的作用域是正在遷移的整個(gè)庫文件，不能指定對元件庫中的一部分器件生效。這導(dǎo)致了一個(gè)問題，也就是我們可以將元件庫中的所有器件一起遷移到某個(gè)路徑下，但是在一次遷移操作中，無法將器件按照其類型分別遷移到相應(yīng)的路徑下。而這恰恰是在遷移元件庫時(shí)是非常常見的需求。

這時(shí)候我們在開始階段定義的器件模板就能發(fā)揮作用了。在定義模板時(shí)我們對器件路徑做出了預(yù)定義，接著將器件分類和模板進(jìn)行綁定。這樣我們就能通過為某個(gè)器件指定一種類型來間接的確定他應(yīng)該被遷移到哪個(gè)路徑下。

關(guān)閉Properties對話框回到Library Migrator，我們按住Shift一次選中多行器件。右擊選中內(nèi)容執(zhí)行Change Component Type，為器件選擇正確的分類。然后我們可以看到Folder一列已經(jīng)更改為我們想要的遷移路徑了。我們依次為所有的器件都指定好分類。

另一種對器件分類的方法

我們在前面看到，每次向Library Migrator中添加元件庫的時(shí)候，Migrator都會嘗試對器件分類。這個(gè)分類是通過對器件的Designator，描述以及參數(shù)中的一些關(guān)鍵字進(jìn)行分析來實(shí)現(xiàn)的。得到的分類僅限于預(yù)設(shè)的目錄而且往往不太準(zhǔn)確。所以通常我們需要對分類結(jié)果作出調(diào)整。當(dāng)需要遷移的元件庫比較少，而且?guī)熘械钠骷诸惐容^合理的時(shí)候這項(xiàng)工作還比較輕松。但是當(dāng)需要遷移的元件庫數(shù)量龐大，每個(gè)元件庫又包括多種類型的器件時(shí)，為每個(gè)器件指定分類就變成一項(xiàng)痛苦的工作了。

想要在遷移時(shí)快速完成器件分類，我們可以在元件庫中添加一個(gè)分類參數(shù)然后通過Library Splitting完成。打開示例文件中multi-channel_mosfet_and_scr_db.xlsx, 我們向其中添加新的一列名稱叫Component Type，值為器件對應(yīng)分類。注意這里的分類名稱需要和Workplace中定義的名稱嚴(yán)格一致。

保存文件回到Library Migrator，點(diǎn)擊Add Library將multi-channel_mosfet_and_scr_db.DbLib添加進(jìn)來。選中剛才添加進(jìn)來的DB Library點(diǎn)擊Library Splitting。在彈出的Splitting對話框中勾上Parameter Grouping，從下拉列表里選中我們剛才添加的Component Type參數(shù)，最后執(zhí)行Update。等待一會兒后我們就可以看見器件都被重新分類了而且遷移路徑也被正確定義了。

數(shù)據(jù)驗(yàn)證

至此我們已經(jīng)完成了所有的配置工作，元件庫已經(jīng)準(zhǔn)備好遷移了。在執(zhí)行遷移之前不妨點(diǎn)擊右上角的Validate對將要上傳的數(shù)據(jù)進(jìn)行驗(yàn)證。

報(bào)告提示我們準(zhǔn)備遷移的元件庫中存在重復(fù)的器件。將重復(fù)的器件遷移至Workspace上往往會對后期的內(nèi)容維護(hù)產(chǎn)生巨大麻煩。在仔細(xì)的游覽過重復(fù)數(shù)據(jù)之后，我們通過右擊冗余器件，選擇Exclude From Migration把重復(fù)的器件排除在外。

剛才在執(zhí)行Validate時(shí)，Duplicated Component的報(bào)告等級是Warning。這一等級的提示并不會阻止遷移指令的執(zhí)行。但是我們決定不讓任何重復(fù)的器件進(jìn)入Workspace。希望在校驗(yàn)過程中如果發(fā)現(xiàn)重復(fù)內(nèi)容，那本次遷移不會被執(zhí)行。為此我們重新打開Properties，在General標(biāo)簽底下找到Migration Checks。其中有一項(xiàng)Component is duplicated by parameter,我們將他的Report Mode從Warning調(diào)整為Error。重新執(zhí)行Validate，這次Migrator沒有再給出任何錯誤報(bào)告。

遷移

相對于前面漫長的準(zhǔn)備工作，最后這個(gè)步驟就非常簡單了。我們只需要點(diǎn)擊Migrate按鈕，等待一會兒，就可以在Component面板中看見我們遷移的內(nèi)容了。也可以打開Explorer在相應(yīng)的文件夾下面找到這些器件。

審核編輯：湯梓紅