庫(kù)遷移系列 - 高級(jí)模式

前情提要

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

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

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

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

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

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

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

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

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

集成庫(kù)

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

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

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

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

單擊列標(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 對(duì)話框，其中可以啟用、禁用參數(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è)庫(kù)的子組條目Uncategorized（并且Uncategorized在Component Types或Folder Structure下列出），這表明遷移器無(wú)法檢測(cè)到該組元件并為其分配類型 - Component Type 設(shè)置為None。在這種情況下，未檢測(cè)到的元件（逆變器邏輯 IC）使用無(wú)法識(shí)別的指示符前綴 ( U?)，并且它們的參數(shù)不包含檢測(cè)到的關(guān)鍵字，例如IC,logic等。

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

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

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

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

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

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

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

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

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

從遷移中排除

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

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

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

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

包含到遷移列表

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

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

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

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

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

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

AD22.4版本后界面如下：

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

AD22.4版本后界面如下：

解決錯(cuò)誤和警告

類型一：參數(shù)錯(cuò)誤。例如下圖顯示的示例中的元件Forward Voltage值無(wú)法解釋為有效電壓?？梢酝ㄟ^以下方式解決：

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

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

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

AD22.4版本后界面如下：

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

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

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

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

AD22.4版本后界面如下：

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

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

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

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

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

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

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

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

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

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

AD22.4版本后界面如下：

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

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

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

單一模型庫(kù)

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

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

AD22.4版本后界面如下：

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