庫遷移器的高級模式

前情提要

《庫遷移系列 - 簡單模式》——庫遷移器的簡單模式會根據(jù)其對源庫和連接的工作區(qū)的分析，軟件自己在后臺會經(jīng)過一系列的處理，預(yù)先自動選擇遷移過程的所有方面，然后庫遷移器的對話框會顯示遷移結(jié)構(gòu)的摘要，包括每種項(xiàng)目類型的總數(shù)。之后只需要點(diǎn)擊一下遷移命令即可，僅僅一個(gè)步驟就完事。非常簡單，用戶不需要做任何額外的操作。

庫遷移器的完整界面在高級模式下顯示，可對庫、元件類型和元件參數(shù)的管理進(jìn)行詳細(xì)控制。與屬性面板結(jié)合使用的時(shí)侯，還可以根據(jù)您的特定需求來配置，將元件庫遷移到云端工作區(qū)。

請注意，遷移器的設(shè)置可以通過導(dǎo)出/導(dǎo)入配置文件來保存和恢復(fù)。

當(dāng)通過File ? Library Migrator命令打庫遷移器時(shí)(在AD22.4版本后是File ? Library Importer命令)，或者當(dāng)在簡單模式下選擇按鈕時(shí)，可以進(jìn)入高級模式。通過將庫文件拖放到該區(qū)域，右鍵單擊然后從上下文菜單中選擇添加庫，或者選擇按鈕，來添加要遷移的庫。

遷移預(yù)覽部分列出了從源庫中標(biāo)識的元件類型組——作為元件類型() 或建議的文件夾結(jié)構(gòu)() 并包括這些元件 ( Components ) 的基于參數(shù)的網(wǎng)格視圖。網(wǎng)格中的參數(shù)值可以即時(shí)編輯，無需打開和編輯源庫。下方的詳細(xì)信息區(qū)域包括來自當(dāng)前選定元件的附加信息——零部件選擇、模型和數(shù)據(jù)表等。

無論界面中顯示的詳細(xì)選項(xiàng)和數(shù)據(jù)如何，遷移器的高級視圖都可以與簡單視圖相同的方式使用 - 只需單擊按鈕(AD22.4版本以后是按鈕)調(diào)用遷移過程，無需干預(yù)。與在簡單視圖過程中一樣，遷移器分析了庫，推斷出它包含的元件類型，并應(yīng)用了正確的元件模板。反過來，模板確定工作區(qū)目標(biāo)文件夾、應(yīng)用的命名方案和生命周期定義以及參數(shù)映射/解釋。

AD22.4版本后的界面如下：

使用按鈕(左上角)刷新庫遷移器。這將重新加載所有源庫和工作區(qū)數(shù)據(jù)，以獲取自遷移器打開以來發(fā)生的任何更改。

使用搜索字段(右上角)按匹配的參數(shù)值過濾元件條目。

集成庫

包含多種元件類型的源庫由遷移器進(jìn)行分析檢測，并將它們分離到子庫組中，在那里它們可以作為單獨(dú)的類型庫進(jìn)行處理。元件類型檢測基于源元件指示符(R?、C?等)以及其他主要元件參數(shù)(描述、ID 等)中包含的關(guān)鍵字(Resistor、Res等)。

在下面顯示的示例中，源庫 ( ProjectABC.IntLib) 已根據(jù)檢測到的元件類型(電容器、電阻器等)自動拆分，可以在文件夾結(jié)構(gòu)列(或元件類型列)中選擇以預(yù)覽其組成部分，即元件網(wǎng)格中的元件條目。

AD22.4版本后的界面如下：

請注意，元件列表的顯示可以通過多種方式更改：

單擊列標(biāo)題條目以按該參數(shù)列重新排序，然后再次單擊以反轉(zhuǎn)順序。

從標(biāo)題右鍵單擊上下文菜單：

選擇清除排序?qū)⒘斜眄樞蚧謴?fù)為其默認(rèn)設(shè)置。

選擇最適合以將特定列寬與其內(nèi)容匹配。

選擇Select Best Fit All Columns以匹配所有可用列與其內(nèi)容的寬度。

選擇Select Columns以訪問Select Columns 對話框，其中可以啟用、禁用參數(shù)列并重新排序它們的列表位置。

單擊過濾器圖標(biāo) () 在標(biāo)題條目中將列表限制為可用的參數(shù)列值、空白/非空白值或自定義過濾器設(shè)置。應(yīng)用的過濾器顯示在列表的底部，可以在其中啟用/禁用(使用其關(guān)聯(lián)的復(fù)選框)、在過濾器編輯器中修改或刪除。通過標(biāo)題過濾器圖標(biāo)選擇全部() 也將刪除應(yīng)用的過濾器。

AD22.4版本后的界面如下：

未分類的元件

如果出現(xiàn)了一個(gè)庫的子組條目Uncategorized(并且Uncategorized在Component Types或Folder Structure下列出)，這表明遷移器無法檢測到該組元件并為其分配類型 - Component Type 設(shè)置為None。在這種情況下，未檢測到的元件(逆變器邏輯 IC)使用無法識別的指示符前綴 ( U?)，并且它們的參數(shù)不包含檢測到的關(guān)鍵字，例如IC,logic等。

請注意：如果運(yùn)行遷移，元件將作為未分類類型遷移，無需解釋。但是，如果包含任何關(guān)鍵/標(biāo)準(zhǔn)參數(shù)(例如Resistance、Capacitance、Tolerance等)，遷移器將自動將它們設(shè)置為合適的參數(shù)單位類型(Ohm、Farad、Percent等)。

此問題可以通過手動將用于這些元件的指示符映射到庫拆分對話框中的所需元件類型來解決，該對話框可從按鈕進(jìn)入 – 選擇源庫 ( ProjectABC.IntLib) 時(shí)按鈕可用。庫拆分對話框提供了控件，可根據(jù)元件類型的指示符映射和基于參數(shù)的拆分，為未分類的元件設(shè)置自定義庫分組選項(xiàng)。

選擇對話框的自定義指示符映射選項(xiàng)后，單擊按鈕創(chuàng)建一個(gè)新的映射條目，從代號下拉列表中選擇適用于未分類元件的代號字符串選項(xiàng)(包括所有可用的代號)，然后從元件類型下拉菜單中選擇所需的元件類型選項(xiàng)。確認(rèn)完成的類型-代號映射(Logic元件類型映射到 代號U?)。然后點(diǎn)擊按鈕。

AD22.4版本后的界面如下：

通過應(yīng)用映射指定的元件類型，遷移器將使用匹配的元件模板 ( Logic) 來配置由模板設(shè)置(文件夾、命名等)定義的庫遷移。

如果在源庫中定義了指定的參數(shù)值(例如，來自一種類別或器件類型參數(shù))， 庫拆分對話框還包括將拆分元件分組的選項(xiàng)。為此，請選擇對話框的參數(shù)分組選項(xiàng)，然后從下拉菜單中選擇適當(dāng)?shù)膮?shù)CategoryComponent_Type。

或者，可以在“屬性”面板的“常規(guī)”部分中手動選擇庫的元件類型。

要更改元件列表中單個(gè)條目的元件類型，請單擊其Component Type單元格，然后從下拉菜單中選擇替代類型，或右鍵單擊元件類型，然后從上下文菜單中選擇更改元件類型。

請注意，由于庫遷移器設(shè)置的靈活性，一種新的(未分類的)元件庫可以與該庫類型未來遷移所需的整個(gè)基礎(chǔ)架構(gòu)一起遷移。通過選擇合適的遷移配置——新的元件類型、元件模板、目標(biāo)文件夾、參數(shù)映射和參數(shù)值單元類型——該庫類型的下一次遷移的唯一要求是選擇先前定義的元件類型。然后，選定的元件類型將確定遷移的所有其他方面。

從遷移中排除

您還可以從遷移中排除特定的元件類型。要排除元件類型，需在元件類型列表中，右鍵單擊要排除的元件類型，然后從上下文菜單中選擇從遷移中排除- 如果需要，將列列表從文件夾結(jié)構(gòu)更改為元件類型()。

AD22.4版本后的界面如下：

排除的元件類型將在元件類型列表中顯示為灰色。要查看網(wǎng)格中排除的元件，請單擊顯示排除元件 (n)，其中n表示排除元件的數(shù)量。

AD22.4版本后的界面如下：

包含到遷移列表

如果您已使用上述從遷移中排除命令從遷移中排除了元件類型，但是您又需要包含該元件類型，請右鍵單擊Component Types (或Folder Structure )中灰顯的元件類型列表，然后從上下文菜單中選擇包含到遷移。元件類型將再次顯示在元件類型列表中，表示它未被排除。

AD22.4版本后的界面如下：

驗(yàn)證錯(cuò)誤和警告

運(yùn)行庫遷移器時(shí)，高級 UI 中的警告或錯(cuò)誤標(biāo)記會指示無法正確遷移到工作區(qū)或根本不會遷移到工作區(qū)的元件(，AD22.4版本后是命令)，或執(zhí)行遷移驗(yàn)證 ()時(shí)致命錯(cuò)誤將阻止遷移。

請注意， “屬性”面板中的“遷移檢查”部分顯示了檢測到的問題(違規(guī)類型)以及它們的指示方式(報(bào)告模式)——使用報(bào)告模式下拉菜單為相關(guān)的違規(guī)類型選擇不同的報(bào)告級別。

嘗試執(zhí)行遷移時(shí)，“消息”面板會顯示檢測到的違規(guī)問題，并且對話框?qū)⑻峁┓艞壔蚶^續(xù)當(dāng)前遷移配置的選擇。在后一種情況下，無效元件不會被遷移，否則遷移過程將失敗。

AD22.4版本后界面如下：

在取消遷移或運(yùn)行手動驗(yàn)證的情況下，任何未通過遷移檢查的元件都會與錯(cuò)誤/警告圖標(biāo)以及下方詳細(xì)信息區(qū)域中的更多信息相關(guān)聯(lián)。預(yù)覽狀態(tài)欄中的圖標(biāo)指示違反遷移規(guī)則檢查的特定元件條目。

AD22.4版本后界面如下：

解決錯(cuò)誤和警告

類型一：參數(shù)錯(cuò)誤。例如下圖顯示的示例中的元件Forward Voltage值無法解釋為有效電壓。可以通過以下方式解決：

從遷移過程中刪除元件 - 右鍵單擊其條目并選擇從遷移中排除選項(xiàng)。

編輯有問題的參數(shù)值 - 找到并將其單元格編輯為兼容的格式。

將映射的參數(shù)單元類型(由應(yīng)用的元件模板確定)從Voltage更改為Text- 在遷移器 UI 中選擇源庫，然后在屬性面板參數(shù)映射列表中更改Forward Voltage 類型(在常規(guī)選項(xiàng)卡下)。

AD22.4版本后界面如下：

類型二：丟失文件錯(cuò)誤。例如此處顯示的無法定位的數(shù)據(jù)表文件，則可以通過以下方式解決：

將丟失的文件定位并恢復(fù)到預(yù)期位置。

從庫遷移過程中排除元件 - 如上所述。

禁用數(shù)據(jù)表文件的遷移 - 更改屬性面板數(shù)據(jù)表部分(在高級選項(xiàng)卡下)中的遷移選項(xiàng)。

AD22.4版本后界面如下：

如果您希望查找特定的元件條目，請使用搜索字段(右上角)。搜索通過與當(dāng)前所選元件類型的匹配參數(shù)值過濾項(xiàng)目列表 - 在元件類型(文件夾結(jié)構(gòu))下選擇全部，以將搜索應(yīng)用于可用源庫中的所有元件。

類型三：找不到模型的錯(cuò)誤。如果您在嘗試遷移原理圖庫時(shí)遇到“找不到模型”錯(cuò)誤(例如Footprint not found in available libraries)，這意味著庫遷移器無法找到鏈接到 SCHLIB 中元件的模型。

在簡單模式下，此類錯(cuò)誤將顯示在基于 HTML 的遷移報(bào)告中，可從運(yùn)行遷移時(shí)可用的按鈕。在高級模式下，錯(cuò)誤由主界面中的狀態(tài)圖標(biāo)指示() 并作為“消息”面板中的條目– 這發(fā)生在執(zhí)行驗(yàn)證檢查 () 或嘗試遷移庫時(shí) (，AD22.4版本后是按鈕)。

驗(yàn)證過程正確檢測到丟失的封裝，該過程還在其錯(cuò)誤報(bào)告中提供了選擇庫選項(xiàng)(在詳細(xì)信息下拉列表下)。如果檢測到多個(gè)元件封裝缺失，則應(yīng)用 PcbLib 選擇對話框提供選項(xiàng)，以將指定的 PcbLib 用于此實(shí)例或所有缺失封裝的元件。

解決(或避免)此問題的另一種方法是確保在 Altium Designer 中提供所需的模型庫文件。庫可以通過Preferences 對話框的Data Management – File-based Libraries 頁面安裝。

或者，如果您不想安裝多個(gè)模型庫，則需要在軟件的默認(rèn)庫路徑中找到它們(或編輯路徑)，并檢查是否為 Schematic Library 元件指定了模型源庫：

在軟件的默認(rèn)搜索路徑位置中包含模型庫。將模型庫，例如對應(yīng)的PCB Library，添加到系統(tǒng)默認(rèn)庫路徑指定的位置。要檢查此位置，請參閱首選項(xiàng)對話框的系統(tǒng) - 默認(rèn)位置頁面上的庫路徑條目。如果已將庫文件添加/復(fù)制到該路徑位置，您可能需要重新啟動 Altium Designer 以注冊更改。

為 Schematic Library 零部件指定目標(biāo)模型庫名稱。為了使原理圖庫元件鏈接到的模型庫為庫遷移器所知，請?jiān)趲霵CB 模型對話框中指定其名稱。

類型四：重復(fù)檢測。庫遷移器還包括避免在目標(biāo)工作區(qū)中創(chuàng)建重復(fù)元件的機(jī)制。這是在驗(yàn)證期間通過將源庫的元件標(biāo)識符參數(shù)和部件選擇與目標(biāo)工作區(qū)中的元件進(jìn)行比較來實(shí)現(xiàn)的。使用遷移器的默認(rèn)設(shè)置，驗(yàn)證步驟 () 將在目標(biāo)工作區(qū)中檢測到相同的元件或條目(指示潛在的元件重復(fù))時(shí)標(biāo)記警告消息。顯示的警告/錯(cuò)誤消息包括重復(fù)違規(guī)的類型(參數(shù)或零件選擇)、違規(guī)庫元件名稱和與之違規(guī)的工作區(qū)元件(按 ID)。NamePart Choices

驗(yàn)證過程檢測到的兩個(gè)潛在重復(fù)項(xiàng)，其中元件的Name(頂部圖像)或其Part Choice(下部圖像)已存在于工作區(qū)元件中。

AD22.4版本后界面如下：

用于檢測重復(fù)違規(guī)的參數(shù)名稱-值對在“高級”選項(xiàng)卡下“屬性”面板的“重復(fù)檢測”區(qū)域中指定。使用唯一字段下拉菜單(默認(rèn)設(shè)置為)從源庫中可用的參數(shù)中進(jìn)行選擇。此選擇對于使用與更廣泛的企業(yè)系統(tǒng)相關(guān)聯(lián)的專有標(biāo)識符字段的公司庫配置特別有用。

ERP-REF在本地庫元件和工作區(qū)元件的指定參數(shù)的值相同的情況下檢測到重復(fù)違規(guī)。如下圖：

通過在“屬性”面板的“常規(guī)”選項(xiàng)卡下的“遷移檢查”區(qū)域中選擇替代報(bào)告模式，可以為重復(fù)違規(guī)設(shè)置不同類型的狀態(tài)標(biāo)志。

單一模型庫

自動重復(fù)檢測還用于處理對所有元件使用通用符號模型的源庫。此類庫往往由具有不同樣式和值的單個(gè)元件類型組成，例如特定封裝格式的電阻器，其中每個(gè)符號都是標(biāo)準(zhǔn)模型圖形。

庫遷移器檢測到這種單一的通用模型條件，然后將遷移配置為傳輸一個(gè)適用于所有遷移元件的符號模型，而不是為每個(gè)元件單獨(dú)命名的相應(yīng)符號。待遷移符號采用通用Symbol名稱，所有元件參數(shù)保持不變。

AD22.4版本后界面如下：

Symbol可以編輯遷移的庫符號(具有名稱和空白描述字段)以滿足您的需要。使用右鍵單擊Edit選項(xiàng)來編輯。在此過程中，在Create Revisions for Item 對話框中選擇Update items related to 選項(xiàng)，以確保遷移的元件使用新的符號版本。

庫遷移的高級模式涵蓋了如上所述各種情況和參數(shù)設(shè)置，以保證按照設(shè)計(jì)師的意圖準(zhǔn)確地進(jìn)行本地庫向云端服務(wù)器的移植。

審核編輯：湯梓紅