統合ライブラリ

親ページ: ファイルベースのコンポーネントライブラリを扱う

統合ライブラリは、Altium Designerの統合コンポーネントモデルを反映しています。このモデルでは、上位レベルのコンポーネントが回路図ライブラリファイル内の回路図シンボル内でモデル化されます。他のモデルはシンボルからリンクされ、コンポーネントパラメータがシンボルに追加されます。すべてのソースライブラリー – シンボルとリンクされたモデル – は、統合ライブラリパッケージプロジェクト内で定義され、その後、単一のファイル – 統合ライブラリ、またはIntLibにコンパイルされます。

この文書では、統合ライブラリを作成するさまざまな方法、およびそのようなライブラリからの配置と修正について見ていきます。

統合ライブラリの利点

統合ライブラリにコンパイルする主な利点は以下の通りです:

• すべてのコンポーネント情報は、単一のポータブルファイルで利用可能です。すべてのモデルが統合ライブラリにパッケージされているため、プロジェクトに必要なのは1つのファイルだけであり、プロジェクトが移動されるときにも、そのファイルさえあればよいのです。このポータビリティは、異なるワークステーション間で作業を分割する場合や、他の人と設計を共有したい場合には非常に貴重です。

• 統合ライブラリから設計図面にコンポーネントが配置される場合、Altium Designerは、その統合ライブラリがどこから来たのかを単に特定できれば、正しいモデルを見つけることが保証されます（つまり、ライブラリとモデルファイルを別々に扱う際のジャグリングや、ハードドライブ上のフォルダ名を変更するなどの日常的な管理作業によってモデルリンクが非常に「壊れやすく」なりがちで、簡単に断絶されることがあります）。

• セキュリティの観点から見ると、統合ライブラリは堅牢です。一度生成されると、変更することはできません。実際には、統合ライブラリを更新するということは、それをまったく新しいものと置き換えることを意味します。元のライブラリパッケージを意図的に引き出し、ソースドキュメントを更新してから、再コンパイルする必要があります。

• これらのライブラリはコンパイル時にも整合性がチェックされます。つまり、可用性だけでなく、正しいピンマッピングもチェックされるということです。離散ライブラリファイルを使用し続けたい場合でも、ソースコンポーネントがターゲットモデルに正しくマッピングされることを保証するために、回路図ライブラリを統合ライブラリパッケージでコンパイルすることが推奨されます。満足したら、作成した統合ライブラリを無視して、回路図ライブラリから直接配置を続けることができます。

ライブラリパッケージを使用したIntLibの作成

統合ライブラリパッケージ（*.LibPkg）は、統合ライブラリを生成するために必要な設計文書のセットをまとめるために使用されるAltium Designerプロジェクトの一種です。回路図シンボルは、回路図ライブラリエディタで描画され、それぞれに対してモデル参照/リンクが定義され、任意のパラメトリック情報と共に保存されます。これらは、1つ以上の回路図ライブラリファイルにわたって保存されます。参照されるモデルには、PCB 2D/3Dコンポーネントモデル、回路シミュレーションモデル、および信号整合性モデルが含まれることがあります。

統合ライブラリパッケージに追加する必要がある唯一のドキュメントは、回路図ライブラリ（またはライブラリ）です。PCB 2D/3Dコンポーネントモデルおよびシミュレーションモデル/サブサーキットを含むファイルは、プロジェクト内の任意の有効な検索場所、インストールされたライブラリリスト内のファイル、またはパッケージに指定された検索パス内に位置することができます。

その後、ライブラリパッケージは単一の統合ライブラリファイル（*.IntLib）にコンパイルされます。

要約すると、統合ライブラリを作成するには基本的に4つのステップがあります：

1. ソースライブラリパッケージを作成する。
2. 必要なソース回路図ライブラリファイルを作成して追加する。
3. 必要なドメインモデルファイルを作成して追加する（または指定する）。
4. ライブラリパッケージをコンパイルして、統合ライブラリファイルを生成する。

ソースライブラリパッケージの作成

メインメニューからFile » New » Libraryコマンドを選択し、開いたNew LibraryダイアログのFile領域からIntegrated Libraryオプションを選択することで、新しい統合ライブラリパッケージを作成します。 Createをクリックすると、新しいシェルライブラリパッケージプロジェクトがProjectsパネルに追加され、初期状態ではドキュメントが含まれていません。

ソース回路図ライブラリの作成と追加

必要なコンポーネントを含むソース回路図ライブラリ(*.SchLib)を作成します。各コンポーネントに必要なモデルリンクとパラメトリック情報を追加します。ソース回路図ライブラリを作成する方法は2つあります：

• 最初から、メインメニューのFile » New » Library コマンドを使用し、File エリアの New Library ダイアログから Schematic Library オプションを選択してください。新しいコンポーネントは、回路図シンボルエディタを使用して作成するか、他の開いている回路図ライブラリからコンポーネントをコピーします。

• Projectsパネルでライブラリパッケージのエントリを右クリックし、コンテキストメニューからAdd New to Project » Schematic Library コマンドを選択します。

• プロジェクト内の回路図ドキュメントに既に配置されているコンポーネントを使用し、Design » Make Schematic Library コマンドを使用します。

ソース回路図ライブラリ（またはライブラリ）を準備したら、以下の方法のいずれかを使用してライブラリパッケージに追加します：

• Project » Add Existing to Projectコマンドを使用する。

• Projectsパネルでライブラリパッケージのエントリを右クリックし、コンテキストメニューからAdd Existing to Projectコマンドを選択する。

ライブラリパッケージに追加されたSchLibのソース。

ドメインモデルファイルの作成と追加

回路図のコンポーネントによって参照されるモデルを、それぞれのファイルに作成します：PCB 2D/3D コンポーネントモデルはPCBライブラリ(*.PcbLib)に、シミュレーションモデルとサブサーキットはモデル(*.Mdl)ファイルとサブサーキット(*.Ckt)ファイルに。もちろん、最も重要なモデルは、その回路図ライブラリの対応するように、PCB 2D/3D コンポーネントモデルで、これは二つの方法で作成できます：

• メインメニューからFile » New » Libraryコマンドを使用し、New LibraryダイアログのFile領域からPCB Libraryオプションを選択します。PCBフットプリントエディタを使用して新しい2Dフットプリントを作成し（3Dボディ情報を追加する）、または他の開いているPCBライブラリからコンポーネントをコピーします。

• Projectsパネル内のライブラリパッケージのエントリを右クリックし、コンテキストメニューからAdd New to Project » PCB Libraryコマンドを選択します。

• PCBドキュメント上に既に配置されているPCB 2D/3Dコンポーネントモデルを使用して、Design » Make PCB Libraryコマンドを使用します。

モデルをどこで見つけるか指定する

モデルファイルが定義されたら、ライブラリパッケージが必要とする際に簡単に見つけられるように、それらを利用可能にする必要があります。モデルは（またはリンクされている）回路図のコンポーネントによって参照されることを忘れないでください。Altium Designerには、統合ライブラリパッケージを構築しているか、回路図の設計に取り組んでいるかに関わらず、モデルを利用可能にするための標準システムがあります。モデルを利用可能にする方法は3つあります：

• プロジェクトにライブラリ/モデルを追加する。
• ライブラリ/モデルをインストール済みライブラリリストにインストールする。ここでは、すべての設計プロジェクトで利用可能になります。
• ライブラリ/モデルへの検索パスを定義する。

それぞれに利点がありますので、作業方法に最も適した方法を選択してください。異なるモデルも、異なるアプローチによってより適している場合があります。たとえば、ライブラリパッケージを開いたときに多数のシミュレーションモデルがProjectsパネルにリストされるのを見たくないかもしれませんが、PCB 2D/3Dコンポーネントモデルライブラリを見たいと思うかもしれません。この場合、シミュレーションモデルが保存されているフォルダへの検索パスを定義し、PCBライブラリをライブラリパッケージに追加してください。

これら3つのモデル利用方法を総称してAvailable File-based Libraries（プロジェクトで利用可能）と呼び、Available File-based Librariesダイアログで定義できます。これは、Componentsパネルの右上にあるをクリックしてFile-based Libraries Preferencesコマンドを選択することでアクセスします。

Altium NEXUSからこのコマンドにアクセスするには、従来のコンポーネント管理方法の使用を有効にする必要があります。これはAltium NEXUSではデフォルトで無効になっており、推奨されていません。この機能を復元するには、Advanced SettingsダイアログでLegacy.UnManagedLibrariesオプションを有効にします。詳細設定ダイアログは、Preferencesダイアログの System – GeneralページでAdvancedボタンをクリックすることでアクセスできます。この設定の変更が有効になるには、Altium NEXUSを再起動する必要があります。

PCBライブラリ（および必要に応じて他のモデルファイル）は、Add Existing to Projectコマンドを使用して、直接ライブラリパッケージに追加することができます。このコマンドは、メインのProjectメニューや、ライブラリパッケージのエントリに関連付けられた右クリックメニューから利用可能です。

ソース PcbLibがライブラリパッケージに追加されました。

Search Path タブからモデルファイルへの検索パスを定義するには、Available File-based LibrariesダイアログからOptions for Integrated Libraryダイアログ（Project » Project Options）のSearch Pathsタブにアクセスします。必要に応じて一つ以上のパスを追加し、モデルはこれらのパスに沿って上から下へ順に検索されることを覚えておいてください。Refresh Listボタンをクリックして、必要なモデルファイルが実際に見つかるかを確認し、必要に応じてパスを調整してください。

ライブラリパッケージのコンパイルと検証

ソースライブラリをライブラリパッケージに追加し、必要に応じてモデルファイルへのパスを定義した後、パッケージはコンパイルされ、最終的に統合ライブラリが生成されます。他のプロジェクトと同様に、統合ライブラリパッケージのコンパイラは、見つからなかったモデルに関する警告など、警告および/またはエラーメッセージのリストを生成します。さらに、ピンマッピングエラーがチェックされ、実際のフットプリントにパッドAとKが含まれている場合に、パッド1と2へのマッピング指示が行われるなどのエラーが確認できます。

コンパイルを実行する前に、Options for Integrated LibraryダイアログのError Reportingタブを通じて、エラーレポーティング条件を適切に設定しておくことが賢明です。

ライブラリパッケージをコンパイルする前に、必要に応じてエラー報告オプションと重大度レベルを設定することをお勧めします。

コンパイルを進めるには、メインのProjectメニューまたはライブラリパッケージのエントリに関連付けられた右クリックメニューからCompile Integrated Libraryコマンドを使用します。Projectsパネルに記載されています。ソースライブラリとモデルファイルは、ソースライブラリパッケージの名前を持つ統合ライブラリ(<LibraryPackageName>.IntLib)にコンパイルされます。コンパイラは違反をチェックし、見つかったエラーや警告はメッセージパネルにリストされます。ソースライブラリの問題を修正してから、再コンパイルしてください。

統合ライブラリパッケージのコンパイル時にコンパイラによって指摘された例示エラー。

統合ライブラリは、統合ライブラリのオプションダイアログのOptionsタブで指定された出力フォルダに保存されます（デフォルトではプロジェクトの場所のサブフォルダ：\Project Outputs for <ProjectName>）。それは自動的にAvailable File-based LibrariesダイアログのInstalledタブと、PreferencesダイアログのData Management – File-based Librariesページに追加されます。

プロジェクトドキュメントからIntLibを作成する

統合ライブラリは、構成要素のプロジェクトドキュメント（ソースの回路図とPCBドキュメント）から直接作成することもできます。これは、動作するライブラリを作成して再利用したい場合や、完成した設計のアーカイブを作成したい場合に便利です。Make Integrated Libraryコマンドを使用します。これは、回路図エディタまたはPCBエディタのどちらかで、メインのDesignメニューから利用可能です。

プロセスは基本的に以下を含みます：

1. すべてのソース回路図ドキュメントを開き、回路図ライブラリを作成する。
2. PCBドキュメントからPCBライブラリを作成する。
3. これらのライブラリをコンパイルして、プロジェクト名を付けた統合ライブラリ（<プロジェクト名>.IntLib）にする。

IntLibはプロジェクトに追加され（Libraries\Compiled Librariesの下にあるProjectsパネル内）、インストールされたライブラリ（任意のプロジェクトで利用可能なAvailable File-based Librariesの一部として）に追加され、Componentsパネルを通じて利用可能になります。

アクティブな設計プロジェクトの回路図とPCBドキュメントから直接、統合ライブラリの作成を簡素化。

データベースライブラリからIntLibを作成する

関連ページ： データベースライブラリの操作

Altium Designerのデータベースライブラリは、Altium Designerのコンポーネントを会社のデータベースと密接に連携させたい場合に理想的な選択です。設計が会社のサイトを離れる必要がある場合、またはデザイナーにセキュアな統合ライブラリから作業してもらいたい場合、これを容易に実現できます。Altium Designerは、データベースライブラリから直接統合ライブラリをコンパイルする機能を提供します：標準のデータベースライブラリ（DbLib）またはバージョン管理されたSVNデータベースライブラリ（SVNDbLib）のいずれかです。この方法により、CADライブラリアンはデータベースライブラリを引き続き使用できる一方で、デザイナーは定期的に再生成される統合ライブラリを使用して、「オフライン」状態で作業できます。

変換はOffline Integrated Library Makerウィザードを使用して実行されます。このプロセスはデータベーステーブルごとに行われ、データベース内のどのテーブルを考慮するかを完全に制御できます。含まれる各テーブルに対して別々の統合ライブラリが生成されます。

データベースライブラリ（DbLibsまたはSVNDbLibs）をオフライン統合ライブラリに変換するには、Offline Integrated Library Makerを使用します。

プロセスには以下のステップが含まれます：

1. 変換したいデータベースライブラリファイル（*.DbLib）またはSVNデータベースライブラリファイル（*.SVNDbLib）をアクティブドキュメントとして開き、メインメニューからTools » Offline Integrated Library Makerコマンドを選択して、Offline Integrated Library Makerにアクセスします。

2. Library to Convertページを使用して、処理するDbLibまたはSVNDbLibを指定します。Offline Integrated Library Makerにアクセスした際のアクティブライブラリがデフォルトで変換するライブラリとして指定されます。必要に応じて、異なるデータベースライブラリを自由に探索し、選択することができます。

3. Optionsページを使用して、リンクされたデータベースのどのテーブルを変換に含めるかを指定します。デフォルトでは、すべてのデータベーステーブルが変換に含まれます。テーブルを除外するには、その関連するConvertオプションが無効になっていることを確認します。このOffline Integrated Library Makerのページでは、生成された統合ライブラリが保存される出力ディレクトリも指定できます。このベースディレクトリへのパスを直接入力するか、フィールドの右側にあるアイコンをクリックして、必要なディレクトリを探索し、選択するダイアログにアクセスします。各含まれるデータベーステーブルの生成された出力（統合ライブラリ）は、指定された出力ディレクトリ内のテーブル名を使用して名付けられた独自のサブフォルダに保存されます。

4. データベースライブラリを選択し、必要に応じて関連する変換オプションを設定した後、Nextをクリックして変換を進めます。進行状況バーが表示され、現在変換されているデータベーステーブルに関する情報が表示されます。変換プロセスは、変換することにした各データベーステーブルに対して実行されることを覚えておいてください。以下は、このプロセスの基本的な分解です：

   1. 統合ライブラリパッケージ（*.LibPkg）が作成され、Projectsパネルで開かれます。パッケージはテーブルの名前を使用して命名されます。例えば、テーブル名がCapacitor - Ceramicの場合、Capacitor - Ceramic.LibPkgとなります。
   2. 回路図ライブラリドキュメントが作成され、LibPkgに追加されます。回路図も再びテーブルの名前を使用して命名されます（例：Capacitor - Ceramic.SchLib）。
   3. テーブルの各レコードが考慮され、適切なAltium Designerコンポーネントが構築されます。これを行うために、参照された回路図シンボルが適切なソースライブラリから取得され、新しい回路図ライブラリドキュメントにコンポーネントとして追加されます。レコードで定義されたパラメータとモデルリンク情報がそのコンポーネントに追加されます。
   4. レコードの参照されたフットプリントモデルが取得され、PCBライブラリドキュメントに追加されます。このドキュメントも再びテーブルの名前を使用して命名されます（例：Capacitor - Ceramic.PcbLib）。その後、PCBライブラリドキュメントがLibPkgに追加されます。
   5. ソースライブラリがDbLibであり、データベースレコードにPCB3Dおよび/またはシミュレーションモデルリンクが定義されている場合、参照されたPCB3DライブラリとシミュレーションモデルファイルもLibPkgに追加されます。そのようなモデルの場所は変更されません。モデルの完全なパスは、対応するモデルリンクの一部として指定されます。
   6. LibPkgはコンパイルされ、統合ライブラリ（例：Capacitor - Ceramic.IntLib）が生成され、その後Altium Designerのインストール済みライブラリに追加されます。

    

コンポーネント取得を通じたIntLibの作成

関連ページ： コンテンツカートを使用したワークスペースデータの取得

ワークスペースからコンポーネントを取得し、統合ライブラリ（*.IntLib）に取り込む能力もあります。このような統合ライブラリからコンポーネントを配置すると、実際のリンクはワークスペース内のコンポーネントに戻ります。これにより、オフライン状態で会社のワークスペースコンポーネントを効果的に使用しながら、設計がソースワークスペースのコンポーネントとの真の接続を維持することを保証できます。

Altium NEXUSでこの機能を使用するためには、レガシーコンポーネント管理方法の使用を有効にする必要があります。これはAltium NEXUSではデフォルトで無効になっており、推奨されていません。この機能を復元するには、Advanced SettingsダイアログでLegacy.UnManagedLibrariesオプションを有効にします。詳細設定ダイアログは、PreferencesダイアログのSystem – GeneralページのでAdvancedボタンをクリックしてアクセスします。Altium NEXUSを再起動する必要があります。この設定の変更が有効になります。

Content Cartダイアログから、IntLibを取得するプロセスは以下の通りです：

生成後、IntLibはインストール済みライブラリリストに追加されます。これはソフトウェアのAvailable File-based Librariesの一部です。

統合ライブラリからのコンポーネント配置

統合ライブラリからのコンポーネントの配置は、Componentsパネルから実行されます。配置は、アクティブな回路図ドキュメントまたはアクティブなPCBドキュメントから行うことができます。配置は以下の方法で実行できます：

• コンポーネントパネルのドロップダウンから望ましい*.IntLibファイルを選択し、配置するコンポーネントを右クリックして、コンテキストメニューからPlace <ComponentName>を選択します。回路図ドキュメント上にコンポーネントを位置づけ、クリックして配置します。

• 必要なコンポーネントをクリックしてドラッグアンドドロップして、設計スペースに配置します。

統合ライブラリにアクセスするには、レガシーなコンポーネント管理方法の使用を有効にする必要があります。これは、Altium NEXUSではデフォルトで無効になっており、推奨されていません。この機能を復元するには、Advanced SettingsダイアログでLegacy.UnManagedLibrariesオプションを有効にします。詳細設定ダイアログには、PreferencesダイアログのSystem – GeneralページからAdvancedボタンをクリックしてアクセスします。この設定の変更が有効になるには、Altium NEXUSを再起動する必要があります。

回路図ライブラリと統合ライブラリは同じコンポーネント（全ての同じモデルリンクを含む）を含んでいる場合がありますが、それぞれのライブラリから配置されたコンポーネントがモデル情報を取得する際の振る舞いは異なります。統合ライブラリから配置されたコンポーネントは、そのモデルを取得するために元の統合ライブラリを探しますが、回路図ライブラリから配置されたコンポーネントは統合ライブラリに保存されているモデルにアクセスできません。

統合ライブラリの修正

統合ライブラリはコンポーネントを配置するために使用され、直接編集することはできません。統合ライブラリを変更するには、まずソースライブラリで変更を行い、その後ライブラリパッケージを再コンパイルして、それらの変更を含む新しい統合ライブラリを生成します。

統合ライブラリを修正するには：

1. 必要な統合ライブラリのソースライブラリパッケージプロジェクトを開きます。
2. 変更を加えるソースの回路図またはモデルライブラリを開きます。
3. 必要に応じて変更を加え、修正されたライブラリを保存してから閉じます。
4. ライブラリパッケージを再コンパイルします。新しく生成された統合ライブラリが、古い既存のバージョンと置き換わります。

統合ライブラリのデコンパイル

統合ライブラリ内のソースライブラリにアクセスして変更を加える必要があるが、何らかの理由で元のソースライブラリパッケージプロジェクトにアクセスできない場合があります。ここで、単一のポータブルな統合ライブラリファイルの別の側面が役立ちます。統合ライブラリは直接編集できませんが、それらを構成するソースシンボルおよびモデルライブラリにデコンパイルすることができます。

これを行うには：

1. 変更する必要があるソースライブラリを含む統合ライブラリを開きます。次のいずれか:

   1. File » Openコマンドを選択し、開くドキュメントを選択 ダイアログで統合ライブラリを参照してからOpenをクリックします。

   2. WindowsファイルエクスプローラーからIntLibファイルをAltium Designerウィンドウにドラッグアンドドロップします。

    

2. 表示されるOpen Integrated Libraryダイアログで、Extractボタンをクリックします。

ソースの回路図とモデルライブラリは抽出され、元の統合ライブラリが存在するフォルダ内の統合ライブラリのファイル名で名付けられた新しいフォルダに保存されます。次に、ライブラリパッケージ（<IntegratedLibraryFileName>.LibPkg）が作成され、ソースの回路図とPCBライブラリがプロジェクトに追加され、Projectsパネルで表示されます。シミュレーションモデルとサブ回路ファイルは自動的にプロジェクトに追加されません。

統合ライブラリからソースライブラリを抽出し、ライブラリパッケージプロジェクトを生成するための逆コンパイル。