統合ライブラリ

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

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

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

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

• すべてのコンポーネント情報は、単一のポータブルファイルで利用可能です。すべてのモデルが統合ライブラリにパッケージされているため、プロジェクトに必要なファイルは1つだけであり、プロジェクトが移動されるときにもそのファイルさえあればよいのです。このポータビリティは、異なるワークステーション間で作業を分割する場合や、他の人と設計を共有したい場合には非常に貴重です。
• 統合ライブラリから設計図面にコンポーネントが配置される場合、Altium Designerはその統合ライブラリがどこから来たのかを単に特定できれば、正しいモデルを見つけることが保証されます（つまり、ライブラリとモデルファイルを別々に扱う際のジャグリングは不要で、モデルリンクが「壊れやすく」、ハードドライブ上のフォルダの名前を変更するなどの日常的な管理作業によって簡単に断絶されることがあります）。
• セキュリティの観点から、統合ライブラリは堅牢です。一度生成されると、変更することはできません。実際に、統合ライブラリを更新するということは、それを完全に置き換えることを意味します。元のライブラリパッケージを意図的に引き上げ、ソースドキュメントを更新し、再コンパイルする必要があります。
• これらのライブラリはコンパイル時に整合性もチェックされます。つまり、利用可能性だけでなく、正しいピンマッピングもチェックされるということです。離散ライブラリファイルを使用し続けたい場合でも、ソースコンポーネントがターゲットモデルに正しくマッピングされることを保証するために、回路図ライブラリを統合ライブラリパッケージでコンパイルすることをお勧めします。満足したら、作成した統合ライブラリを無視して、回路図ライブラリから直接配置を続けることができます。

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

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

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

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

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

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

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

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

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

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

• 最初から、File » New » Library » 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 コンポーネントモデルであり、2つの方法で作成できます：

• File » New » Library » PCB Libraryコマンドを使用して、新しい 2D フットプリントを作成し（そして任意の 3D ボディ情報を追加）、PCB ライブラリエディタを使用するか、他の開いている PCB ライブラリからコンポーネントをコピーします。

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

利用可能なファイルベースのライブラリダイアログを通じてモデルの利用可能性を定義します。

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

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

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

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

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

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

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

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

統合ライブラリパッケージのコンパイル時にコンパイラによってフラグが立てられた例示エラー。

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

コンパイル済み統合ライブラリが、利用可能なファイルベースのライブラリダイアログのインストール済みタブに追加されます。

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

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

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

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

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

    

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

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

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

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

1. Select target Serverリンクをクリックし、メニューからIntLib fileを選択します。

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リンクをクリックし、次に表示されるChoose Itemダイアログを使用して、それらのコンポーネントを選択します。

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

必要な統合ライブラリファイルを含むターゲットフォルダーにカートを配送します。

生成後、IntLibはインストール済みライブラリリストに追加されます - ソフトウェアで利用可能なライブラリの一部です。

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

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

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

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

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

統合ライブラリの変更

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

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

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パネルで表示されます。シミュレーションモデルとサブサーキットファイルは自動的にプロジェクトに追加されません。

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