統合ライブラリ

親ページ: コンポーネントとライブラリについての詳細

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

統合ライブラリのメリット

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• 最初から、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ライブラリ(*.PcbLib)のPCB 2D/3Dコンポーネントモデル)、シミュレーションモデル、およびモデル(*.Mdl) とサブサーキット (*.Ckt) ファイル。もちろん、最も重要なモデルはPCB 2D/3Dコンポーネントモデルで、回路図ライブラリと同様に、次の2つの方法で作成できます：

• File » New » Library » 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を選択することでアクセスします。

Available File-based Librariesダイアログを通じてモデルの利用可能性を定義します。

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

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

必要なPcbLibモデルファイルを見つけるための定義された検索パスの例。

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

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

コンパイルを実行する前に、Options for Integrated LibraryダイアログのError Reportingタブで、適切にエラーレポーティング条件を確認して設定することを推奨します。

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

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

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

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

コンパイル済みの統合ライブラリが、Available File-based LibrariesダイアログのInstalledタブに追加されました。

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

統合ライブラリは、構成するプロジェクトドキュメント（ソースの回路図とPCBドキュメント）から直接作成することもできます。これには、回路図またはPCBエディタのいずれかでメインのDesignメニューから利用できるMake Integrated Libraryコマンドを使用します。

このプロセスには主に以下が含まれます：

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

IntLibはプロジェクトに追加され（Projectsパネル内のLibraries\Compiled Librariesの下に）、インストールされたライブラリ（任意のプロジェクトで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のインストール済みライブラリに追加されます。

    

現在インストールされているライブラリは、PreferencesダイアログのData Management – File-based Librariesページ、およびAvailable File-based LibrariesダイアログのInstalledタブから表示できます。このタブには、Componentsパネルの右上にあるボタンをクリックし、File-based Libraries Preferencesを選択することでアクセスできます。

変換プロセスの結果 - 構成要素のシンボルとフットプリントモデルドキュメントを含むライブラリパッケージプロジェクトと、インストールされたライブラリとしても追加されたコンパイルされたIntLibs。

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

関連ページ： コンテンツカートの使用

統合ライブラリには管理されたコンテンツサーバーからコンポーネントを取得する機能もあります。このような統合ライブラリからコンポーネントを配置すると、実際のリンクはそのサーバー内のコンポーネントに戻ります。これにより、オフラインの状態でも会社のコンポーネントを効果的に使用できるようになり、設計がソース内のそれらのコンポーネントと真の接続を維持することを保証します。また、これらのコンポーネントに定義されたサプライチェーン情報が、パーツ選択リストの使用を通じて引き続き使用されることも保証します。

1. Select target serverリンクをクリックし、メニューからIntLibファイルを選択します。

Content CartのターゲットをIntLibファイルに設定します。

2. 生成されるIntLibファイルの名前と場所を指定します。デフォルトでは、ファイル名はIntegrated_Library - <Date> - <Time>.IntLibの形式で、場所は\Users\Public\Documents\Altium\AD<Version>\Library\ExportCmpLibに生成されます。必要に応じて、ChangeリンクをクリックしてアクセスするSave Asダイアログを通じてこれを変更します。

デフォルトのターゲットフォルダを受け入れるか、必要に応じて変更してください。

3. 同じ IntLib に追加のコンポーネントを取得する必要がある場合は、Add More Itemsリンクをクリックし、Selectエントリを選択してChoose Itemダイアログ (Explorerパネルの「縮小」バージョン) にアクセスします。ここから、ソースワークスペースを参照して他のアイテムを探すことができます。または、Add manually エントリを選択して、Add new itemsダイアログにアクセスします。このダイアログでは、必要な項目の外部リスト (1 行に 1 つの項目) を貼り付け、選択した検索条件 (GUID、 Item ID、Name、または MPN) を使用してソース ワークスペース内で検索できます。

4. 準備ができたら、ボタンをクリックして、IntLibの生成を進めます。一時的な統合ライブラリパッケージ(*.LibPkg)が作成され、ソースSchLib（シンボル、パラメータ、モデルリンク付き）およびPcbLib（フットプリントモデル付き）ファイルが生成され追加されます。これがコンパイルされてIntLibファイルが生成され、指定されたフォルダに生成されます。情報ダイアログがファイルの生成が成功したことを確認します。

目的のフォルダにカートを配送します。これには必要な統合ライブラリファイルが含まれます。

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

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

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

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

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

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

統合ライブラリの変更

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

統合ライブラリを変更するには：

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

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

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

そのためには：

1. 修正が必要なソースライブラリを含む統合ライブラリを開きます。次のいずれかの方法で:

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

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

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

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

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