統合ライブラリ
統合ライブラリはAltium Designerの統合コンポーネントモデルを反映しています。このモデルでは、上位レベルのコンポーネントが回路図ライブラリファイル(*.SchLib
)内の回路図シンボル内にモデル化されます。他のモデルはシンボルからリンクされ、コンポーネントパラメータがシンボルに追加されます。すべてのソースライブラリ(シンボルとリンクされたモデル)は統合ライブラリパッケージプロジェクト内で定義され、その後、単一のファイル – 統合ライブラリまたはIntLibにコンパイルされます。
この文書では、統合ライブラリが作成されるさまざまな方法と、そのようなライブラリからの配置および変更について説明します。
統合ライブラリのメリット
統合ライブラリにコンパイルする主な利点は以下の通りです:
- すべてのコンポーネント情報は、単一のファイルで利用可能です。すべてのモデルが統合ライブラリにパッケージされているため、プロジェクトに必要なファイルは1つだけであり、プロジェクトが移動されるときにもそのファイルさえあればよいのです。このポータビリティは、異なるワークステーション間で作業を分割する場合や、他の人と設計を共有したい場合には役立ちます。
- 統合ライブラリから設計図にコンポーネントが配置される場合、Altium Designerは、そのコンポーネントがある統合ライブラリがあれば、正しいモデルを見つけることが保証されます(つまり、別々のライブラリとモデルファイルは不要で、モデルリンクの場合は「脆弱」で、ハードドライブ上のフォルダの名前を変更するなどの日常的な管理作業によって簡単に破損することがあります)。
- セキュリティの観点から、統合ライブラリは堅牢です。一度生成されると、変更することはできません。実際に、統合ライブラリを更新するということは、それを完全に置き換えることを意味します。元のライブラリパッケージを意図的に引き出し、ソースドキュメントを更新してから、再コンパイルする必要があります。
- これらのライブラリはコンパイル時に整合性がチェックされます。つまり、利用できるかだけでなく、正しいピンマッピングもチェックされるということです。離散ライブラリファイルを使用し続けたい場合でも、ソースコンポーネントがターゲットモデルに正しくマッピングされることを確認するためだけに、回路図ライブラリを統合ライブラリパッケージにコンパイルすることをお勧めします。満足したら、作成した統合ライブラリを無視して、回路図ライブラリから直接配置を続けることができます。
ライブラリパッケージを使用したIntLibの作成
統合ライブラリパッケージ(*.LibPkg
)は、統合ライブラリを生成するために必要な設計文書のセットをまとめるために使用されるAltium Designerプロジェクトの一種です。回路図シンボルは、回路図ライブラリエディタで描かれ、それぞれに対してモデル参照/リンクが定義され、任意のパラメトリック情報と共に保存されます。これらは、1つ以上の回路図ライブラリファイルにわたって保存されます。参照されるモデルには、PCBフットプリント、回路シミュレーションモデル、信号整合性モデルが含まれることがあります。
統合ライブラリパッケージに追加する必要がある唯一の文書は、回路図ライブラリ(またはライブラリ群)です。PCB 2D/3Dコンポーネントモデルやシミュレーションモデル/サブサーキットを含むファイルは、プロジェクト内の任意の有効な検索場所、インストールされたライブラリリスト内のファイル、またはパッケージに指定された検索パス内に位置している可能性があります。
その後、ライブラリパッケージは単一の統合ライブラリファイル(*.IntLib
)にコンパイルされます。
要約すると、統合ライブラリを作成するには、基本的に4つのステップがあります:
- ソースライブラリパッケージを作成する。
- 必要なソース回路図ライブラリファイルを作成し、追加する。
- 必要なドメインモデルファイルを作成し、追加する(または指す)。
- ライブラリパッケージをコンパイルして、統合ライブラリファイルを生成する。
ソースライブラリパッケージの作成
メインメニューからFile » New » Libraryコマンドを選択し、開いたNew Libraryダイアログのファイル領域から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パネルでライブラリパッケージのエントリを右クリックし、コンテキストメニューからプロジェクトに既存を追加コマンドを選択する。
ライブラリパッケージに追加されたソースSchLib。
ドメインモデルファイルの作成と追加
回路図のコンポーネントに参照されるモデルを、それぞれの対応するファイルに作成します:PCB 2D/3D コンポーネントモデルは PCB ライブラリ (*.PcbLib
) に、シミュレーションモデルとサブサーキットはモデル (*.Mdl
) とサブサーキット (*.Ckt
) ファイルにあります。もちろん、最も重要なモデルは PCB 2D/3D コンポーネントモデルであり、その回路図ライブラリの対応物と同様に、2つの方法で作成できます:
- メインメニューからFile » New » Libraryコマンドを使用し、新規ライブラリダイアログのファイル領域からPCB Libraryオプションを選択します。PCBフットプリントエディタを使用して新しい2Dフットプリントを作成し(3Dボディ情報を追加)、または他の開いているPCBライブラリからコンポーネントをコピーします。
- PCB Libraryパネル内のライブラリパッケージのエントリを右クリックし、コンテキストメニューからプロジェクトに新規追加 » PCBライブラリコマンドを選択します。
- PCBドキュメント上に既に配置されているPCB 2D/3Dコンポーネントモデルを使用して、Design » Make PCB Libraryコマンドを使用します。
モデルをどこで見つけるか指定する
モデルファイルが定義されたら、ライブラリパッケージが必要なときに簡単に見つけられるように、それらを利用可能にする必要があります。モデルは回路図のコンポーネントによって参照される(またはリンクされる)ことを覚えておいてください。Altium Designerには、統合ライブラリパッケージを構築している場合でも、回路図の設計に取り組んでいる場合でも、モデルを利用可能にするための標準システムがあります。モデルを利用可能にする方法は3つあります:
- プロジェクトにライブラリ/モデルを追加する。
- ライブラリ/モデルをインストール済みライブラリリストにインストールする。ここでは、すべての設計プロジェクトで利用可能になります。
- ライブラリ/モデルへの検索パスを定義する。
それぞれに利点がありますので、作業方法に最も適した方法を選択してください。異なるモデルも、異なるアプローチによってより適している場合があります。たとえば、ライブラリパッケージを開いたときに多数のシミュレーションモデルがプロジェクトパネルにリストされるのを見たくないかもしれませんが、PCB 2D/3Dコンポーネントモデルライブラリを見たいと思うかもしれません。この場合、シミュレーションモデルが保存されているフォルダへの検索パスを定義し、ライブラリパッケージにPCBライブラリを追加してください。
これら3つのモデル利用可能性の方法は、プロジェクトで利用可能な利用可能なファイルベースのライブラリを形成し、利用可能なファイルベースのライブラリダイアログで定義できます。これは、コンポーネントパネルの右上にあるをクリックしてからファイルベースのライブラリ設定コマンドを選択することでアクセスします。
Altium NEXUSからこのコマンドにアクセスするには、レガシーなコンポーネント管理方法の使用を有効にする必要があります。これはAltium NEXUSではデフォルトで無効になっており、推奨されていません。この機能を復元するには、詳細設定ダイアログでLegacy.UnManagedLibraries
オプションを有効にします。詳細設定ダイアログは、設定ダイアログのシステム - 一般ページで詳細ボタンをクリックすることでアクセスできます。この設定の変更が有効になるには、Altium NEXUSを再起動する必要があります。
PCBライブラリ(および必要に応じて他のモデルファイル)は、プロジェクトメニューのメインから、またはライブラリパッケージのエントリに関連付けられた右クリックメニューから利用可能な既存をプロジェクトに追加コマンドを使用して、直接ライブラリパッケージに追加することもできます。
ソース PcbLibがライブラリパッケージに追加されました。
Search Pathタブからモデルファイルへの検索パスを定義するには、Available File-based Librariesダイアログから検索パスタブにアクセスします(Project » Project Options)。必要に応じて、1つ以上のパスを追加します。モデルはこれらのパスに沿って上から下へと順に検索されることを覚えておいてください。必要なモデルファイルが実際に見つかるかを確認し、必要に応じてパスを調整するために、リストを更新ボタンをクリックします。
ライブラリパッケージのコンパイルと検証
ライブラリパッケージにソースライブラリが追加され、必要に応じてモデルファイルへのパスが定義されたら、最終的に統合ライブラリを生成するためにパッケージをコンパイルすることができます。他のプロジェクトと同様に、統合ライブラリパッケージのコンパイラは、見つからなかったモデルに関する警告など、警告および/またはエラーメッセージのリストを生成します。さらに、ピンマッピングエラーをチェックすることができます。例えば、実際のフットプリントにパッドAとKが含まれている場合に、パッド1と2へのマッピング指示がある場合です。
コンパイルを実行する前に、Options for Integrated Libraryダイアログのエラーレポートタブを通じて、適切にエラーレポート条件を設定しておくことが賢明です。
ライブラリパッケージをコンパイルする前に、必要に応じてエラー報告オプションと重大度レベルを設定することをお勧めします。
コンパイルを進めるには、メインのプロジェクトメニューから、またはProjectsパネルのライブラリパッケージエントリを右クリックし、統合ライブラリのコンパイルコマンドを使用します。ソースライブラリとモデルファイルは、ソースライブラリパッケージにちなんで名付けられた統合ライブラリ(<LibraryPackageName>.IntLib
)にコンパイルされます。コンパイラは違反をチェックし、見つかったエラーや警告はメッセージパネルにリストされます。ソースライブラリの問題を修正してから、再コンパイルしてください。
統合ライブラリパッケージのコンパイル時にコンパイラによって指摘された例示的なエラー。
統合ライブラリは、統合ライブラリのオプションダイアログのオプションタブで指定された出力フォルダに保存されます(デフォルトではプロジェクトの場所のサブフォルダ:\Project Outputs for <ProjectName>
)。これは自動的に、利用可能なファイルベースのライブラリダイアログのインストール済みタブと、設定ダイアログのデータ管理 - ファイルベースのライブラリページに追加されます。 コンパイルされた統合ライブラリが、利用可能なファイルベースのライブラリダイアログのインストール済みタブに追加され、インストール済みタブの利用可能なファイルベースのライブラリダイアログに追加されました。
プロジェクトドキュメントからIntLibを作成する
統合ライブラリは、構成要素のプロジェクトドキュメント(ソースの回路図とPCBドキュメント)から直接作成することもできます。これは、動作するライブラリを作成して再利用したい場合や、完成した設計のアーカイブを作成したい場合に便利です。統合ライブラリを作成コマンドを使用します。これは、回路図エディタまたはPCBエディタのいずれかで、メインのデザインメニューから利用できます。
プロセスは基本的に以下を含みます:
- すべてのソース回路図ドキュメントを開き、回路図ライブラリを作成する。
- PCBドキュメントからPCBライブラリを作成する。
- これらのライブラリをコンパイルして、プロジェクト名を付けた統合ライブラリ(
<ProjectName>.IntLib
)にする。
IntLibは ProjectsパネルのLibraries\Compiled Libraries
の下に追加されます。インストールされたライブラリ(任意のプロジェクトで利用可能なファイルベースのライブラリの一部として)に追加され、コンポーネントパネルを通じて利用可能になります。
アクティブな設計プロジェクトの回路図とPCBドキュメントから直接、統合ライブラリの作成を効率化。
データベースライブラリからIntLibを作成する
関連ページ: データベースライブラリ
Altium Designerのデータベースライブラリは、Altium Designerのコンポーネントを会社のデータベースと連携させたい場合に理想的な選択です。設計が会社のサイトを離れる必要がある場合、またはデザイナーにセキュアな統合ライブラリから作業してもらいたい場合、これを容易に実現できます。Altium Designerは、データベースライブラリから直接統合ライブラリをコンパイルする機能を提供します:標準のデータベースライブラリ(DbLib)またはバージョン管理されたSVNデータベースライブラリ(SVNDbLib)のいずれかです。この方法で、CADライブラリアンはデータベースライブラリを引き続き使用でき、デザイナーは定期的に再生成される統合ライブラリを使用して、「オフライン」のように作業できます。
変換はOffline Integrated Library Maker wizardを使用して実行されます。このプロセスはデータベーステーブルごとに行われ、データベース内のどのテーブルを考慮するかを完全に制御できます。含まれる各テーブルに対して別々の統合ライブラリが生成されます。
データベースライブラリ(DbLibsまたはSVNDbLibs)を「オフライン」統合ライブラリに変換するには、オフライン統合ライブラリメーカーを使用します。
プロセスには以下のステップが含まれます:
- 変換したいデータベースライブラリファイル(
*.DbLib
)またはSVNデータベースライブラリファイル(*.SVNDbLib
)をアクティブドキュメントとして開いた状態で、メインメニューからツール » オフライン統合ライブラリメーカーコマンドを選択し、オフライン統合ライブラリメーカーにアクセスします。 - 変換するライブラリページを使用して、処理するDbLibまたはSVNDbLibを指定します。オフライン統合ライブラリメーカーにアクセスした際のアクティブライブラリがデフォルトで変換するライブラリとして指定されます。必要に応じて、異なるデータベースライブラリを自由に探索して選択することができます。
- オプションページを使用して、リンクされたデータベースのどのテーブルを変換に含めるかを指定します。デフォルトでは、すべてのデータベーステーブルが変換に含まれます。テーブルを除外するには、その関連する変換オプションが無効になっていることを確認します。このオフライン統合ライブラリメーカーのページでは、生成された統合ライブラリが保存される出力ディレクトリも指定できます。このベースディレクトリへのパスを直接入力するか、フィールドの右側にあるアイコンをクリックして、必要なディレクトリを探索して選択できるダイアログにアクセスします。それぞれ含まれるデータベーステーブルの生成された出力(統合ライブラリ)は、指定された出力ディレクトリ内のテーブル名を使用して名付けられた独自のサブフォルダに保存されます。
- データベースライブラリを選択し、必要に応じて関連する変換オプションを設定した後、次へをクリックして変換を進めます。進行状況バーが表示され、現在変換されているデータベーステーブルに関する情報が表示されます。変換プロセスは、変換することにした各データベーステーブルに対して実行されることを覚えておいてください。以下は、このプロセスの基本的な分解です:
- 統合ライブラリパッケージ(
*.LibPkg
)が作成され、Projectsパネルで開かれます。パッケージはテーブルの名前を使用して命名されます。例えば、テーブル名がCapacitor - Ceramic
の場合、Capacitor - Ceramic.LibPkg
となります。 - 回路図ライブラリドキュメントが作成され、LibPkgに追加されます。回路図も再びテーブルの名前を使用して命名されます(例:
Capacitor - Ceramic.SchLib
)。 - テーブルの各レコードが考慮され、適切なAltium Designerコンポーネントが構築されます。これを行うために、参照された回路図シンボルが適切なソースライブラリから取得され、新しい回路図ライブラリドキュメントにコンポーネントとして追加されます。レコードで定義されたパラメータとモデルリンク情報がそのコンポーネントに追加されます。
- レコードの参照されたフットプリントモデルが取得され、PCBライブラリドキュメントに追加されます。このドキュメントも再びテーブルの名前を使用して命名されます(例:
Capacitor - Ceramic.PcbLib
)。その後、PCBライブラリドキュメントがLibPkgに追加されます。 - ソースライブラリがDbLibであり、データベースレコードにPCB3Dおよび/またはシミュレーションモデルリンクが定義されている場合、参照されたPCB3DライブラリとシミュレーションモデルファイルもLibPkgに追加されます。そのようなモデルの場所は変更されません。モデルの完全なパスは、対応するモデルリンクの一部として指定されます。
- LibPkgがコンパイルされ、統合ライブラリ(例:
Capacitor - Ceramic.IntLib
)が生成され、その後Altium Designerのインストール済みライブラリに追加されます。
- 統合ライブラリパッケージ(
コンポーネント取得を通じたIntLibの作成
関連ページ: コンテンツカートを使用してワークスペースデータを取得する
また、ワークスペースからコンポーネントを統合ライブラリ(*.IntLib
)に取り込むことができます。このような統合ライブラリからコンポーネントを配置すると、実際のリンクはワークスペース内のコンポーネントに戻ります。これにより、オフライン状態で会社のワークスペースコンポーネントを効果的に使用しながら、設計がソースワークスペース内のそれらのコンポーネントと真の接続を維持することを保証できます。
この機能をAltium NEXUSで使用するためには、レガシーコンポーネント管理方法の使用を有効にする必要があります。これは、Altium NEXUSではデフォルトで無効になっており、推奨されていません。この機能を復元するには、詳細設定ダイアログでLegacy.UnManagedLibraries
オプションを有効にします。これは、システム - 一般ページの設定ダイアログで、詳細ボタンをクリックすることでアクセスできます。Altium NEXUSを再起動する必要があります。この設定の変更が有効になります。
コンテンツカートダイアログから、IntLibを取得するプロセスは以下の通りです:
-
対象サーバーを選択リンクをクリックし、メニューからIntLibファイルを選択します。
-
生成されるIntLibファイルの名前と場所を指定します。デフォルトでは、ファイルは
Integrated_Library - <Date> - <Time>.IntLib
の形式で命名され、\Users\Public\Documents\Altium\AD<Version>\Library\ExportCmpLib
の場所に生成されます。必要に応じて変更リンクをクリックして名前を付けて保存ダイアログからこれを変更します。 - 同じIntLibに追加のコンポーネントを取得する必要がある場合は、さらにアイテムを追加リンクをクリックし、選択エントリを選択してアイテムを選択ダイアログ(エクスプローラーパネルの「簡易版」)にアクセスします。ここから、ソースワークスペースでさらにアイテムをブラウズできます。または、手動で追加エントリを選択して新しいアイテムを追加ダイアログにアクセスします。このダイアログでは、必要な外部アイテムリストを貼り付けることができます(1行に1アイテム)、そして選択した検索基準(GUID、アイテムID、名前、またはMPN)を使用して、ソースワークスペース内で検索できます。
-
準備ができたら、 ボタンをクリックしてIntLibの生成を進めます。一時的な統合ライブラリパッケージ(
*.LibPkg
)が作成され、ソースSchLib(シンボル、パラメータ、およびモデルリンクを含む)およびPcbLib(フットプリントモデルを含む)ファイルが生成され追加されます。これがコンパイルされてIntLibファイルが生成され、指定されたフォルダに生成されます。情報ダイアログがファイルの成功した生成を確認します。
-
ターゲットサーバーを選択リンクをクリックし、メニューからIntLibファイルを選択します。
-
生成されるIntLibファイルの名前と場所を指定します。デフォルトでは、ファイルは
Integrated_Library - <Date> - <Time>.IntLib
の形式で命名され、\Users\Public\Documents\Altium\NEXUS<Version>\Library\ExportCmpLib
の場所に生成されます。必要に応じて、名前を付けて保存ダイアログを通じてこれを変更します。これは、変更リンクをクリックすることでアクセスできます。 - 同じIntLibに追加のコンポーネントを取得する必要がある場合は、アイテムを追加リンクをクリックし、選択エントリを選択してアイテムを選択ダイアログ(エクスプローラーパネルの「簡易版」)にアクセスします。ここから、ソースワークスペースでさらにアイテムをブラウズできます。または、手動で追加エントリを選択して新しいアイテムを追加ダイアログにアクセスします。このダイアログでは、必要な外部アイテムリストを貼り付けることができます(1行に1アイテム)、そして選択した検索基準(GUID、アイテムID、名前、またはMPN)を使用して、ソースワークスペース内で検索できます。
-
準備ができたら、 ボタンをクリックしてIntLibの生成を進めます。統合ライブラリパッケージ(
*.LibPkg
)が作成され、ソースSchLib(シンボル、パラメータ、およびモデルリンクを含む)およびPcbLib(フットプリントモデルを含む)ファイルが生成されて追加されます。コンパイルされたIntLibファイルが、指定されたフォルダに生成されます。情報ダイアログにファイルの生成が成功したことが表示されます。
生成後、IntLibはインストール済みライブラリリストに追加されます。これはソフトウェアの利用可能なファイルベースのライブラリの一部です。
統合ライブラリからのコンポーネント配置
統合ライブラリからのコンポーネントの配置は、コンポーネントパネルから実行されます。配置は、アクティブな回路図ドキュメントまたはアクティブなPCBドキュメントから行うことができます。配置は以下の方法で実行できます:
- コンポーネントパネルのドロップダウンから望ましい
*.IntLib
ファイルを選択し、配置するコンポーネントを右クリックして、コンテキストメニューから配置<コンポーネント名>を選択します。回路図ドキュメント上にコンポーネントを位置づけ、クリックして配置します。 - 必要なコンポーネントをクリックしてドラッグ&ドロップで設計スペースに配置します。
Altium NEXUSで統合ライブラリにアクセスするには、従来のコンポーネント管理方法の使用を有効にする必要があります。これはデフォルトでは無効になっており、推奨されていません。この機能を復元するには、詳細設定ダイアログ(システム - 一般ページの設定ダイアログで詳細ボタンをクリックしてアクセス)でLegacy.UnManagedLibraries
オプションを有効にします。この設定の変更を有効にするには、Altium NEXUSを再起動する必要があります。
回路図ライブラリと統合ライブラリは同じコンポーネント(すべて同じモデルリンクを含む)を含むことがありますが、それらのモデル情報が取得されるとき、それぞれのライブラリから配置されたコンポーネントの動作は異なります。統合ライブラリから配置されたコンポーネントは、そのモデルを取得するために元の統合ライブラリを探しますが、回路図ライブラリから配置されたコンポーネントは、統合ライブラリに格納されているモデルにアクセスできません。
統合ライブラリの変更
統合ライブラリはコンポーネントを配置するために使用され、直接編集することはできません。統合ライブラリを変更するには、まずソースライブラリで変更を行い、その後、ライブラリパッケージを再コンパイルして、それらの変更を含む新しい統合ライブラリを生成します。
統合ライブラリを変更するには:
- 必要な統合ライブラリのソースライブラリパッケージプロジェクトを開きます。
- 変更を加えるソースの回路図またはモデルライブラリを開きます。
- 必要に応じて変更を加え、変更されたライブラリを保存してから閉じます。
- ライブラリパッケージを再コンパイルします。新しく生成された統合ライブラリが、古い既存のバージョンに置き換わります。
統合ライブラリのデコンパイル
統合ライブラリ内のソースライブラリに変更を加える必要があるが、何らかの理由で元のソースライブラリパッケージプロジェクトにアクセスできない場合があります。ここで、単一の統合ライブラリファイルの別の機能が役立ちます。統合ライブラリは直接編集できませんが、それらを構成するソースシンボルおよびモデルライブラリにデコンパイルすることができます。
これを行うには:
- 変更する必要があるソースライブラリを含む統合ライブラリを開きます。次のいずれかの方法で:
- File » Openコマンドを選択し、開くドキュメントを選択 ダイアログで統合ライブラリを探して、開くをクリックします。
- WindowsファイルエクスプローラーからIntLibファイルをAltium Designerウィンドウにドラッグアンドドロップします。
-
表示される統合ライブラリを開くダイアログで、抽出ボタンをクリックします。
ソースの回路図とモデルライブラリは抽出され、元の統合ライブラリが存在するフォルダ内に統合ライブラリのファイル名にちなんで名付けられた新しいフォルダに保存されます。ライブラリパッケージ(<IntegratedLibraryFileName>.LibPkg
)が作成され、ソースの回路図とPCBライブラリがプロジェクトに追加され、Projectsパネルで表示されます。シミュレーションモデルとサブ回路ファイルは自動的にプロジェクトに追加されません。
統合ライブラリからソースライブラリを抽出し、ライブラリパッケージプロジェクトを生成するためのデコンパイル。