データベースライブラリの作成と定義

データベースライブラリ機能の基盤はデータベースライブラリファイルです。これには、標準データベースライブラリを使用している場合と、バージョン管理されたデータベースライブラリを使用している場合とで、2つの形式があります:

  • 標準データベースライブラリ - データベースライブラリファイル。このファイルは、Altium DesignerのDatabaseLibエディタを使用して作成および管理されます。このエディタは、メインデザインウィンドウのアクティブドキュメントが*.DbLibファイルである場合に利用可能になります。

  • バージョン管理データベースライブラリ - SVNデータベースライブラリファイル。このファイルは、Altium DesignerのSVNDatabaseLibエディタを使用して作成および管理されます。このエディタは、メインデザインウィンドウのアクティブドキュメントが*.SVNDbLibファイルである場合に利用可能になります。

DatabaseLibエディタで開かれたDbLibファイルの例。画像にカーソルを合わせると、SVNDatabaseLibエディタで開かれたSVNDbLibファイルの例が表示されます。DatabaseLibエディタで開かれたDbLibファイルの例。画像にカーソルを合わせると、SVNDatabaseLibエディタで開かれたSVNDbLibファイルの例が表示されます。

これらのタイプの新しいファイルを作成するには、メインメニューからFile » New » Library コマンドを選択し、開かれたDatabase LibraryまたはSVN Database LibraryオプションをDatabase領域のNew Libraryダイアログから選択します。

外部データベースへの接続

テーブルとマッピングデータは、アクティブなデータベースライブラリ/SVNデータベースライブラリファイルが必要な外部データベースに正常に接続された後にのみ、エディタのメイン表示ウィンドウに表示されます。接続は、Source of Connection領域で提供されるコントロールを使用して定義されます。

DbLibファイルを通じて外部データベースへの接続を指定します。画像にカーソルを合わせると、SVNDbLibファイルを通じた接続が表示されます。DbLibファイルを通じて外部データベースへの接続を指定します。画像にカーソルを合わせると、SVNDbLibファイルを通じた接続が表示されます。

OLE DBサポートを提供する任意のデータベースに接続できます。この領域で提供されるオプションは、それぞれOLE DB接続文字列を使用して対象データベースに接続します。一部のデータベースではOLE DBサポートが提供されていない場合があります。しかし、現在使用されているほとんどすべてのデータベース管理システムは、Open Database Connectivity (ODBC)インターフェースを通じてアクセスできます。データベースリンク機能は、MicrosoftのODBCプロバイダを使用し、ADO (ActiveX Data Object)が任意のODBCデータソースに接続できるようにします。その結果、任意のODBCデータベースに接続できます。接続文字列の一部として指定されるODBCデータベースのOLE DBプロバイダです。

接続は、メインメニューからDatabase ConnectionダイアログのConnectionタブにアクセスするためにTools » Database Connectionコマンドを選択するか、またはAdvancedボタン(Connectボタンの右側、領域の下部にあります)をクリックすることでも定義できます。

アクセスとエクセルデータベースへの高速接続

Select Database Typeオプションは、ターゲットデータベースがMicrosoft AccessまたはMicrosoft Excelを使用して作成された場合に、接続文字列を作成するための迅速な方法を提供します。このオプションを使用して、データベースタイプを選択し、必要なデータベースファイルを参照して選択します。対応する接続文字列が自動的に構成され、Use Connection Stringオプションのフィールドに入力されます。

フルパスを指定することもできますし、データベースライブラリ/SVNデータベースライブラリファイルに対して相対パスを保存することも選択できます。

接続文字列の構築

会社のデータベースがAccessまたはExcelベースでない場合、接続文字列を明示的に構築したい場合は、Use Connection Stringオプションを有効にし、右側の関連するBuildボタンをクリックします。Data Link Propertiesダイアログが表示されます。

Building a connection string through the Data Link Properties dialog.

Data Link Propertiesダイアログを通じて接続文字列を構築する。

ダイアログはConnectionタブで開きます。OLE DBプロバイダーMicrosoft Office <Version> Access Database Engine OLE DB Providerは、ダイアログのProviderタブでデフォルトに設定されています。これは新しいデータベースライブラリ/SVNデータベースライブラリファイルのデフォルトプロバイダー設定であり、Accessデータベースファイル(*.mdb)に接続するためにも使用されます。必要に応じてプロバイダーを変更してください。

Connectionタブから、接続したいデータベースの名前(パスを含む)を入力してください。

データベースにログイン権限が必要な場合は、必要に応じてこれを入力し、ダイアログのAdvancedタブから利用可能な他の高度な設定も入力してください。Allタブでは、定義されたリンクオプションの概要リストと、選択したOLE DBプロバイダーに関連する拡張オプションが提供されます。このタブから必要に応じてオプションを変更できます。

リンクオプションが定義されると、 ConnectionタブのTest Connectionボタンをクリックすることで、接続が成功したかどうかを確認できます。接続が成功すると、その旨の確認ダイアログが表示されます。

データリンクプロパティダイアログはMicrosoftのダイアログであり、そのためF1を押すか、利用可能なHelpボタンを使用することでMicrosoft Data Link Helpファイルにアクセスできます。このファイルはAltium Designerのドキュメントセットの一部ではありません。

データリンクファイルを指定する

接続したいデータソースがMicrosoft Data Linkファイル(*.udl)を使用して記述されている場合、接続オプションの3番目であるUse Data Link Fileを有効にし、関連するBrowseボタンをクリックして必要なファイルを見つけてください。データリンクファイルは、本質的に接続文字列の保存容器です。

接続を進める

外部データベースへの接続を定義した後、Connectボタンのテキストが太字になり、接続を進めることができることを示します。接続の詳細が正しければ、ターゲットデータベースのテーブルとマッピング情報がデータベースライブラリ/SVNデータベースライブラリファイルに読み込まれます。ConnectボタンのテキストはConnectedに変わり、ボタンはグレーアウトされます。

接続の詳細に問題がある場合、たとえば接続文字列が正しく構築されていない、またはパスが誤って入力されていると、接続は失敗し、この事実を警告するメッセージが表示されます。接続設定を確認し、再度Connectボタンをクリックしてください。

Examples of flagging connection failure in a database library.

データベースライブラリにおける接続失敗のフラグ付けの例。

データベースに接続している間に接続設定を変更すると、ライブ接続が失われ、ConnectボタンのテキストがReconnectに変わります。接続を再確立するにはクリックしてください。

初回接続が成功し、データベースライブラリ/SVNデータベースライブラリファイルが保存された後は、ターゲットデータベースの場所とファイル名が変更されない限り、ファイルが開かれるたびに接続が自動的に行われます。

バージョン管理リポジトリへのリンクを指定する(SVNDbLibのみ)

DbLibでは、シンボルとモデルのライブラリがハードディスクやその他のローカル/ネットワーク媒体に保存されます。SVNDbLibの場合、これらのライブラリはSubversionリポジトリ内のバージョン管理下に保存されることを覚えておいてください。SVNDbLibファイルの一部として、このリポジトリへのリンクを定義する必要があります。Database Library Optionsダイアログ(Tools » Options)のSVN Repositoryタブで、SVNリポジトリへの接続が定義されます。このダイアログは、ドキュメントビューのField Settings領域にあるOptionsボタンをクリックすることでアクセスすることもできます。

ファイルベースのSVNリポジトリへの接続例。ファイルベースのSVNリポジトリへの接続例。

データベーステーブルリスト

外部データベースへの接続に成功すると、テーブルとマッピングデータが読み込まれます。DbLib/SVNDbLibドキュメントの左側には、接続されたデータベースに存在するすべてのテーブルがリストされます。

Excelベースのデータベースの場合、テーブルは実際にはそのリンクされたスプレッドシート内のシートです。テーブル名には$の接尾辞が付きます。
ターゲットデータベースが複数のExcelスプレッドシートファイル(*.xls)を使用して作成された場合、ODBCドライバの制限により、接続できるシートの数には64の制限があります。

接続されたデータベースに存在するテーブル。接続されたデータベースに存在するテーブル。

各テーブルエントリの隣にあるEnableオプションを使用すると、そのテーブルが結果のデータベースライブラリの一部となるかどうかを制御できます。データベースライブラリがComponentsパネルの利用可能なファイルベースのライブラリリストに追加されると、各テーブルは別々のライブラリエンティティとして表示されます。したがって、実際には1つのデータベースライブラリのみが追加されているにもかかわらず、Componentsパネルの観点からは、複数の異なるライブラリを追加したように見えます。詳細については、ファイルベース&データベースライブラリでのコンポーネントの検索を参照してください。

リスト内のテーブルエントリをクリックすると、そのアイコンがDatabase table icon, inactive tableからDatabase table icon, active tableに変わり、現在アクティブなテーブルとして区別されます。テーブル(およびそのデータ)はドキュメントのTable Browserタブに表示されます。これはテーブルの編集可能なビューであり、外部データベース自体を起動することなく、その内容をすばやく参照し、必要に応じて編集できます。

接続されたデータベースのソーステーブルを閲覧。接続されたデータベースのソーステーブルを閲覧。

上の図に示されているように、テーブルブラウザの領域を拡大するには、ドキュメントビューの右上にあるCollapse icon - collapse a region of the database library documentコントロールをクリックして、上部の全領域(接続とフィールド設定)を折りたたみます。Expand icon - expand a region of the database library documentをクリックして展開します。テーブルは、グループ化、ソート、フィルタリングの機能もサポートしています。

マッチング基準の指定

外部データベースからコンポーネントが配置された後、配置されたコンポーネントとそれを作成するために使用されたデータベースレコードとの間のリンクを保持する方法が必要です。本質的に、これらの二つをマッチさせる必要があります。

コンポーネントが配置されると、そのパラメータ情報は、データベースレコードの対応するフィールドを使用してその場で作成されます。配置後のスキーマティックコンポーネントとデータベースレコードとのリンクは、これらのパラメータの1つ以上を使用して確立されます。Field Settings領域では、マッチング基準を定義できます。これは、単純な単一キー検索、またはWhere句を使用したより高度なマッチングのいずれかです。

マッチング基準はテーブルごとに指定されます。

配置後のマッチング基準の制御。配置後のマッチング基準の制御。

単一キー検索

Single key lookupオプションが有効になっている(デフォルト)場合、Database fieldPart parameterフィールドが利用可能になります。前者は、データベースのアクティブなテーブルのすべての利用可能なフィールド名(列ヘッダー)をリストします。スキーマティックコンポーネントのパラメータは配置されると追加されるため、Part parameterフィールドは選択されたデータベースフィールドを反映します。

通常、ルックアップキーフィールドには、外部データベースの各コンポーネントを一意に識別するもの、例えばパーツ番号が使用されます。選択されたルックアップフィールドは、ドキュメントのField MappingsタブにDesign Parameterエントリとして灰色で表示されます。

パーツ番号による単一キーマッピングパーツ番号による単一キーマッピング

配置後のある段階でUpdate Parameters From Database機能を使用する際、配置された回路図コンポーネントの選択したキー パラメータから情報が読み取られ、その後、すべての有効なテーブルにわたってデータベースの選択した (キー) フィールドで検索されます。一致するものがある場合、親テーブルのそのレコードの他のセルからの情報を回路図コンポーネントのマッピングされたパラメータに戻すことができます。

高度なマッチング - WHERE句

Single key lookupオプションは、一意の部品番号/IDで一致させる場合にはうまく機能しますが、静電容量や抵抗のような一意でないパラメータで一致させる場合にはそれほど効果的ではありません。この場合、より高度なWHERE句を使用する必要があり、回路図コンポーネントをそのソースデータベースレコードにリンクさせるために複数のキー一致を指定できるようになります。

最も単純な形でのWhere句(SQL構文を使用して記述)は、単一のキー検索を定義する選択されたエントリを反映します。たとえば、Database fieldがデフォルトのPart Numberに選択された場合、Part parameterフィールドも自動的にPart Numberに設定され、Where句のエントリは次のようになります:

[Part Number] = '{Part Number}'

データベースフィールド(テーブル列)を囲む角括弧は、Database ConnectionダイアログAdvancedタブで指定された引用文字です。このダイアログには、ドキュメントのSource of Connection領域にあるAdvancedボタンをクリックするか、メインToolsメニューからアクセスできます。

Mapping between the component parameters and the database, using a Where clause

Database ConnectionダイアログのAdvancedタブでは、構築されたWhere句でテーブルを引用したり、テーブルスキーマ名を使用したりするための追加のSQLオプションが提供されます。

テーブルを引用する際に使用される特定の引用文字は、使用しているデータベースによって異なります。たとえば、角括弧[ ]は、AccessやADO経由のExcel、またはMSSQL(後のバージョン)などのMicrosoftデータベースでのみ使用可能です。MYSQLでは、引用のために`(バックティック)文字を使用します。実際、列名にスペースが含まれているか、そのデータベースの予約語である場合にのみ、どのデータベースでも引用する必要があります。使用しているデータベースソフトウェアのドキュメントを確認して、どの引用文字が使用されているか(ある場合)を確認してください。

波括弧(ブレース)は、参照されているエントリが設計パラメータであることを指定します。シングルクォートは、設計パラメータを数値(クォートなし)ではなく文字列として扱うことを指定するために使用されます。型の一致は非常に重要であり、SQLは型に敏感です。設計パラメータは、データベース内の列と同じ型にする必要があります。

標準SQL構文を使用して、Where句は複数のDatabase field/Part parameterエントリを使用して一致させるように拡張できます。例えば:

[Capacitance] = '{Capacitance}' AND [Tolerance] = {Tolerance} AND [Manufacturer] = '{Manufacturer}'

この場合、データベースの関連テーブルの単一のレコードが、3つの異なる設計パラメータを使用してリンクされます。Tolerance設計パラメータのエントリが引用されていないことに注意してください。これは、データベースの関連テーブルの列の型がNumberであり、Stringではないことを意味します。

標準SQL構文を使用すると、WHERE句を好きなようにシンプルにも複雑にもすることができます。

データベースフィールドを設計パラメータにマッピングする

データベースライブラリから配置されたコンポーネントの設計パラメータは、配置時に作成または追加されます。実際に作成されるパラメータと、配置後にその情報を更新するために使用されるオプション(Tools » Update Parameters From Databaseコマンドを使用)は、データベースライブラリ/SVNデータベースライブラリファイルに指定されたマッピングおよび更新情報によって決まります。これらの設定は、メインドキュメントビューのField Mappingsタブで行われます。

マッピングと更新オプションは、テーブルごとに指定されます。

Specify parameter mapping and update options on the Field Mappings tab of the DbLib/SVNDbLib document.

DbLib/SVNDbLibドキュメントのField Mappingsタブでパラメータマッピングと更新オプションを指定します。

モデルとパラメータのマッピング

Field Mappingsタブの左から2つの列は、データベースからどの情報をコンポーネントの属性、モデル、パラメータにマッピングするかを制御するために使用されます。

  • Database Field Name - この列は、データベースの現在アクティブなテーブル内のすべてのフィールド(列)名を一覧表示します。

  • Design Parameter - この列は、データベース内の各対応するフィールドがどのように使用されるかを定義します。これは、コンポーネントのシンボルやフットプリントモデルをソースするためのものである可能性があり(角括弧で囲まれます)、またはコンポーネントパラメータとして含めるためのものである可能性があります(これらは括弧で囲まれていません)。

データベースに接続されたDbLib/SVNDbLibドキュメントを開くと、一部のデザインパラメータには角括弧が含まれているものと含まれていないものがあることに気づくでしょう。角括弧は予約名を示しており、例えば[Library Ref]のようなデータは、コンポーネントの属性とモデルを埋めるために使用されます。角括弧を含まないデザインパラメータは、コンポーネントパラメータになります。

データベースへの接続時には、すべてのデータベースフィールドが自動的にマッピングされます。

自動マッピングは、データベースフィールド名がAltium Designerで使用される予約名と一致することを前提としています。一致しない場合は、マッピングを手動で設定する必要があります。

属性 & モデル

データベースフィールド名が以下の予約名のいずれかである場合、対応する属性/モデルマッピングエントリはDesign Parameterフィールドで自動的に設定されます:

  • Description → [Description]

  • Footprint Ref → [Footprint Ref]

  • Footprint Path → [Footprint Path]

  • Footprint Ref n → [Footprint Ref n]

  • Footprint Path n → [Footprint Path n]

データベーステーブルには無制限のフットプリントモデル参照(およびパス)を指定し、DbLib/SVNDbLibファイルでマッピングできます。予約名では、n2から始まる正の整数を表します。

  • Library Ref → [Library Ref]

  • Library Path → [Library Path]

  • Orcad Footprint → [Orcad Footprint]

  • Orcad Library → [Orcad Library]

これらの参照は、OrCAD CIS設定ファイルとライブラリをインポートし、標準のデータベースライブラリ(DbLib)を生成する際に使用されます。

 

  • PCB3D Ref → [PCB3D Ref]

  • PCB3D Path → [PCB3D Path]

    • PCB3Dへの参照は、レガシー3Dビューアに関連しており、新しいデザインには使用すべきではありません。PCBエディタのネイティブ3Dエンジンは、コンポーネントのボディとコンポーネントのフットプリントに関連付けられたインポートされた3Dモデルファイルをレンダリングできます。

    • PCB3DモデルマッピングはSVNDbLibファイルで定義できますが、SubversionリポジトリにPCB3Dモデルライブラリを格納することはサポートされていません。

  • Sim Description → [Sim Description]

  • Sim Excluded Parts → [Sim Excluded Parts]

  • Sim File → [Sim File]

  • Sim Kind → [Sim Kind]

  • Sim Model Name → [Sim Model Name]

  • Sim Netlist → [Sim Netlist]

  • Sim Parameters → [Sim Parameters]

  • Sim Port Map → [Sim Port Map]

  • Sim Spice Prefix → [Sim Spice Prefix]

  • Sim SubKind → [Sim SubKind]

    より詳細なシミュレーションモデル関連フィールドについては、以下のシミュレーションモデルマッピングを参照してください。

    外部データベースのコンポーネントには、一つのシミュレーションモデルリンクのみを定義できます。通常、コンポーネントにリンクされるシミュレーションモデルは一つだけです。複数のシミュレーションモデルリンクを設定したい場合は、他のリンクをソースの回路図ライブラリファイル内で定義して格納する必要があります。
    バージョン管理されたデータベースライブラリ(SVNDbLib)では、リンクされたシミュレーションモデルがサポートされていますが、Subversionリポジトリにシミュレーションモデルファイルを格納することはサポートされていません。

これらのマッピングは、コンポーネントの属性とモデル情報を定義します。コンポーネントが配置されると、対応するデータベースレコードの[Library Ref]フィールドによって指定された回路図シンボルが指定された回路図ライブラリから抽出されます。同様に、レコードに格納されたPCBフットプリントおよびシミュレーションモデル情報が、それぞれリンクされたフットプリントおよびシミュレーションモデルとしてコンポーネントに追加されます。

[Library Ref]エントリは、設計パラメータ列に存在し、回路図シンボルを指定するDatabase Field Nameにマッピングされている必要があります。これにより、データベースライブラリ/SVNデータベースライブラリから回路図にコンポーネントを配置できるようになります。データベーステーブルに異なるDatabase Field Name、例えばSCH Symbolの下にシンボル参照が含まれている場合は、そのフィールドの関連するDesign Parameterエントリを[Library Ref]に手動で設定する必要があります。そのセルの利用可能なドロップダウンリストを使用してください。

同様に、異なるフィールド名を使用してモデル参照情報がデータベースに入力される場合、各フィールドごとにドロップダウンリストから適切なDesign Parameterエントリ([Footprint Ref][Footprint Ref n][PCB3D Ref][Sim Model Name]など)を選択して手動でマッピングする必要があります。

Mapping the symbol and footprint models from the database to the design component

コンポーネントの配置時にシンボルとモデル情報を定義するためには、データベース内のシンボルおよびモデル参照フィールドが重要なマッピングエンティティです。定義されたマッピングの一部として、シンボルと少なくとも1つのPCBフットプリント参照が存在することを確認してください。

前述のように、複数のPCBモデルをマッピングできます。Design Parameter[Footprint Ref]にマッピングされたDatabase Field Nameは、コンポーネントが回路図に配置されたときのデフォルトのフットプリントになります。このフットプリントが、設計がPCBドメインに転送されるときに配置されます。

DbLib/SVNDbLibファイルのシンボルとモデルをマッピングする際、外部データベースのパス情報はオプションです。詳細については、シンボルとモデルライブラリの場所の指定を参照してください。

シミュレーションモデルマッピング

このセクションでは、コンポーネント配置時に作成されるシミュレーションモデルリンクを定義するために、外部データベーステーブルに追加できる各データベースフィールドについて説明します。

  • Sim Model Name – 使用したいモデルの名前。コンポーネントが配置されると、この情報はSim ModelダイアログのModel Nameフィールドに表示されます。

    データベースフィールドをDBLibファイルの設計パラメータにマッピングする際、シムモデル名フィールドはフットプリント参照、ライブラリ参照などのフィールドに類似しています。

  • Sim Description – リンクされたモデルの説明。この情報は任意であり、シミュレーションモデルリンクの動作には影響しません。

  • Sim File – Sim Model Nameフィールドで指定されたシミュレーションモデルを見つけるための特定のモデルファイル。このフィールドの使用方法はいくつかあります:

    • モデルファイルへの絶対パスを入力できます(例:C:\DbLibs\Switching Diodes\Libraries\JAS33.mdl)。Sim Model Nameフィールドで指定されたモデルは、このファイル内で検索され、見つかった場合は使用されます。

    • モデルファイルへの相対パス(DbLibファイルに対して相対)を入力できます(例:Libraries\JAS33.mdl)。Sim Model Nameフィールドで指定されたモデルは、このファイル内で検索され、見つかった場合は使用されます。

    • モデルファイル名のみを入力できます(例:JAS33.mdl)。DbLibファイルの一部として定義された検索パスが、指定された名前と一致し、Sim Model Nameフィールドに指定されたモデルと一致する最初のモデルファイルを見つけるために使用されます。

    • フィールドを空白のままにしておくことができます。DbLibファイルの一部として定義された検索パスが、Sim Model Nameフィールドに指定されたモデルに一致する最初のモデルファイルを見つけるために使用されます。

    検索パスは、Database Library Optionsダイアログ(Tools » Options)のSymbol & Model Search PathsタブからDbLibファイルのために定義されます。

  • Sim Kind – リンクされているモデルの親カテゴリ。

  • Sim SubKind – リンクされているモデルのタイプ。

  • Sim Netlist – リンクされているモデルのタイプに応じたネットリストテンプレート情報。このフィールドは、独自のネットリストテンプレートを指定し、Sim SubKindフィールドをGeneric Editorに設定した場合、ネットリストに配置される情報をより制御できるため、特に重要になります。

    このフィールドは定義されている必要があり、空白のままにしてはいけません。そうしないと、シミュレーションネットリストにモデルのエントリが作成されず、データベースライブラリから配置されたときに部品はシミュレーションされません。

  • Sim Spice Prefix – リンクしているモデルタイプのためのSPICEプレフィックス。

  • Sim Port Map – 回路図コンポーネントからリンクされたモデルのピンへのピンのマッピング。コンポーネントが配置されると、この情報はSim ModelダイアログのPin Mapping領域に表示されます。

    各ピンのペアリングは、次の形式で入力する必要があります:

    (SchematicPinNumber:ModelPinNumber),

    各マッピングされたペアはカンマで区切られています。

    例えば、ダイオードシミュレーションモデルをマッピングする際に、回路図のピン1(アノード)をモデルのピン1(アノード)にマッピングし、回路図のピン3(カソード)をモデルのピン2(カソード)にマッピングする必要がある場合、これはデータベースフィールドに次のように入力されます:

    (1:1),(3:2)

  • Sim Excluded Parts – 特定のマルチパートコンポーネントの一部をシミュレーションから除外したい場合は、データベースにこのフィールドを作成してください。この情報は、Sim ModelダイアログのPin Mapping領域にあるExclude part from simulationオプションに対応しています。

    デフォルトでは、マルチパートコンポーネントのすべての部分がシミュレーションに含まれるため、除外したい部分を番号で指定するだけで済みます。除外リスト内の複数の部分はカンマで区切ります。たとえば、コンポーネントに4つの部分があり、部分2と4をシミュレーションに含めたくない場合は、次のようにデータベースフィールドに入力します。

    2,4

  • Sim Parameters – モデルのシミュレーションパラメータに値を割り当てたい場合は、データベースにこのフィールドを作成してください。これらはコンポーネントレベルで定義できるパラメータであり、モデルファイルに含めることができるより高度なパラメータとは対照的です。

    パラメータは次の形式で入力する必要があります:

    ParameterName=Value,

    複数のパラメータはパイプ文字(|)で区切る必要があります。

    コンポーネントレベルのシミュレーションパラメータは、関連するComponent PropertiesダイアログのParameters領域に表示され、回路図シートに表示できるコンポーネントパラメータとして設定することもできることを覚えているかもしれません。デフォルトでは、Sim Parametersフィールドのパラメータエントリは自動的にコンポーネントパラメータとして追加されます。シミュレーションパラメータをコンポーネントパラメータとして追加したくない場合は、単にパラメータ名の前に感嘆符を追加してください(例:!Initial Voltage=100mV)。

    次の4つのコンポーネントレベルのパラメータを持つダイオードモデルを考えてみてください:

    • 面積係数

    • 開始条件

    • 初期電圧

    • 温度

データベースに面積係数(例えば2)と温度(例えば22°C)の値を追加することを考えてみましょう。また、これらはコンポーネントパラメータとして追加されるべきではありません。Sim Parametersフィールドへの入力は以下のようになります:

!Area Factor=2|!Temperature=22

データベースライブラリからコンポーネントを配置した後、シミュレーションリンクに定義された情報が必要なものであることを確認できます。配置されたコンポーネントが設計空間で選択された場合、Parameters領域のPropertiesパネルでシミュレーションモデルエントリを選択し、ボタンをクリックしてSim Modelダイアログにアクセスし、以下を確認できます:

  • モデルファイルが予想通りに見つかりました。見つかった場合、ダイアログのModel Fileタブにファイルの内容が表示されます。
  • データベースからの残りのシミュレーション情報が予想通りにダイアログに追加されました。

データベースフィールドに保存された値は、データベースライブラリから配置されたコンポーネントに対してシミュレーションを実行する際に使用されます。ただし、データベースライブラリから配置されたコンポーネントのシミュレーションモデルのSim Modelダイアログにアクセスし、OKをクリックした場合、選択されたモデルテキストに基づいてそのコンポーネントのSim NetlistおよびSim Spice Prefixフィールドが自動的に設定されます。

パラメータ

データベースの他のすべてのフィールド名は、同じ名前を使用して設計パラメータに自動的にマッピングされます。例えば、データベースのフィールドがToleranceと呼ばれている場合、その名前の設計パラメータがそれにマッピングされます。設計パラメータの名前を変更するには、そのセル内をクリックして新しい名前を直接入力します。これらの設計パラメータ名が、回路図シートに配置された後のコンポーネントの関連プロパティダイアログのParameters 領域に表示されます。

データベースに関連付けられたコンポーネントのデータフィールドが多数ある場合がありますが、回路図シートに配置されたコンポーネントに設計パラメータとして追加したい、または必要とするものはすべてではありません。この情報の多くは、材料表を生成する際にのみ必要とされる場合があります。Report Managerダイアログを使用すると、リンクされたデータベースから直接BOMにパラメータ情報を追加でき、回路図ソースドキュメントに「持ち込まれる」情報の量を減らすことができます。詳細については、レポートマネージャーでBOMを準備するセクションを参照してください。

データベースからマッピングされたくないフィールドについては、Design Parameterエントリを[None]に設定します。マッピングされていないデータベースフィールドは、赤い十字アイコン(Cross icon, indicating that a database field is not mapped to a component parameter)を使用してタブ上で区別されます。マッピングされたデータベースフィールドは、緑のチェックアイコン(Tick icon, indicating that a database field is mapped to a component parameter)によって区別されます。

Example of how to un-map a database field from a component parameter必要に応じてパラメータマッピングを設定します。データベースのパラメータが配置されたコンポーネントにマッピングされないようにするには、[None]に設定します。
必要に応じて、マッピングされていないパラメータをBOMに直接含めることができます。

マッピングされていないフィールドをすばやく再マッピングするには、そのフィールドの行内をクリックし、Ctrl+Dキーボードショートカットを使用します。モデルマッピングの場合は、関連するDesign Parameterドロップダウンから手動で選択する必要があります。

パラメーター更新オプション

データベースライブラリからコンポーネントを初めて配置する際、またはTools » Update Parameters From Databaseコマンドを使用して配置された後にコンポーネントを更新する際に、パラメータに対して行われるアクションを指定するField Mappingsタブの残りの列です。

四つの列は以下の通りです:

  • Update Values - この列のセルは、スキーマティックシートとデータベースの両方にパラメータが存在するが、現在の値が異なる場合に取るべきアクションを決定するために使用されます。データベースに保存されている値で配置されたコンポーネントのパラメータを更新する(Update)か、まったく更新しない(Do not update)かを選択できます。このオプションは、コンポーネントが配置された後にUpdate Parameters From Databaseコマンドを使用する際に遵守されます。

  • Add To Design - この列のセルは、パラメータがデータベースに見つかるが、配置されたコンポーネントには存在しない場合に取るべきアクションを決定するために使用されます。パラメータを追加する(Add)、パラメータを追加しない(Do not add)、またはデータベースに値が割り当てられている場合のみパラメータを追加する(Add only if not blank in database)を選択できます。このオプションは、データベースライブラリからコンポーネントを最初に配置する際や、コンポーネントが配置された後にUpdate Parameters From Databaseコマンドを使用する際にも遵守されます。

  • Visible On Add - この列のチェックボックスは、初期配置または配置後の更新から生じた新しく追加されたパラメータが、回路図シート上のコンポーネントに対して表示されるか(有効)どうか(無効)を判断するために使用されます。

  • Remove From Design - この列のセルは、パラメータが配置されたコンポーネントに存在することが確認された場合に取るべきアクションを決定するために使用されますが、データベースに存在しないか、存在するが値がない場合です。パラメータをまったく削除しないこと(Do not remove)を選択するか、データベースに値が割り当てられていない場合にのみ削除すること(Remove only if blank in database)を選択できます。このオプションは、コンポーネントが配置された後にデータベースからパラメータを更新するコマンドを使用する際に遵守されます。

 

Parameter update options can be manually overridden, if required.

必要に応じて、パラメーター更新オプションは手動で上書きできます。

画像を見て、更新オプションに関して重要なポイントが4つあります:

  1. マッピングされていないデータベースフィールドには、関連する更新オプションがありません。

  2. 属性およびモデルベースのマッピング(Design Parameter列の角括弧内のエントリ)には、これらがデザインパラメータではないため、関連する更新オプションはありません。

  3. キー フィールド (画像のPart Numberなど) には関連する更新オプションはありません。このフィールドはパラメータの一致目的のみに使用されます。

  4. Defaultの設定は、Database Library OptionsダイアログのDefault Actionsタブに指定された対応するデフォルト定義に従う更新オプションを引き起こします(メインメニューのTools » OptionsまたはTable Browserタブの右クリックメニューのOptions)。このダイアログは、ドキュメントビューのField Settings領域にあるOptionsボタンをクリックすることでもアクセスできます。

Define default parameter update options in a central location for a DbLib. Hover over the image to see the equivalent for an SVNDbLib.

DbLibのデフォルトパラメータ更新オプションを中央の場所で定義します。画像にカーソルを合わせると、SVNDbLibの同等のものが表示されます。

第四のポイントは、中央の場所から更新オプションを指定できるため有益であり、各マッピングされたフィールドの更新オプションを定義する際にその場所を指し示すことができます。これが、データベースフィールドを設計パラメータにマッピングする際に、関連する更新フィールドに自動的にDefaultエントリが読み込まれる理由です。

更新オプションのデフォルト設定を上書きしたい場合は、Field Mappingsタブの関連する更新フィールド内をクリックし、再度クリックして適用可能な更新選択肢を提供するドロップダウンにアクセスします。Parameter update options can be manually overridden, if required.必要に応じて、パラメーター更新オプションは手動で上書きできます。

このようにして、デザインのパラメータがどのように更新されるかを完全に制御できます。すべてのフィールドをDefaultに設定し、Database Library Optionsダイアログから必要な更新の決定を行うことも、各更新フィールドを個別に設定することも、両方の混合を持つこともできます - 決定は完全にあなたの判断に委ねられています。配置されたコンポーネントについては、更新が行われるとき、Engineering Change Orderダイアログを通じて実行されます。この段階で、行いたくない更新がある場合は、それらの特定の変更を含めないことを選択できます - どのデザインパラメータが更新されるかについて、最終的かつ究極の決定権を持つことができます。

シンボルおよびモデルライブラリの場所を指定する

データベースライブラリからコンポーネントを配置すると、そのシンボル([Library Ref]マッピングにより指定)は指定された回路図ライブラリ(*.SchLib)から抽出されます。同様に、データベースで指定されたモデル参照(フットプリント、PCB3D、シミュレーション)は、基盤となるPCBライブラリ(*.PcbLib)、PCB3Dライブラリ(*.PCB3DLib)、およびシミュレーションモデル(*.mdl*.ckt)ファイルに存在します。これらのファイルへのパスは、データベース内で明示的に指定できます:

  • ファイルへの絶対パスを入力します。

  • ファイルへの相対パスを入力します。

データベースにパス情報のためのフィールドが定義されている場合、これらのフィールドは適切な設計パラメータにマッピングする必要があります - [Library Path][Footprint Path][PCB3D Path][Sim File]など(モデルとパラメータのマッピングを参照)。

データベーステーブルにパスを入力することは、相対的であっても少し制約がある場合があります。ライブラリやモデルファイルの場所を移動すると、データベーステーブルをそれに応じて更新する必要があります。より自由度を高めるために、DbLib/SVNDbLibファイル内でライブラリ検索情報を指定することができます。これにより、データベース内でソースライブラリやモデルファイルの名前を指定することができるか、まったく定義しないことも可能です。

Using Search Paths with a large number of symbol/model files -  検索パスはシンボルやモデルの配置方法を設定する際に柔軟性と簡便さを提供しますが、検索場所に多数のシンボルまたはモデルファイルが存在する場合、このアプローチは推奨されません。使用されるファイル命名スキームによっては、検索パスに存在するすべてのライブラリ/モデルファイルが、シンボル/モデルが必要なたびに検索される必要がある場合があります。たとえば、コンポーネントをブラウズしたり、回路図からPCBに設計を転送したりする際です。

データベースライブラリ

DbLibの場合、ライブラリ検索パスはDatabase Library OptionsダイアログのSymbol and Model Search Pathsタブで定義されています(Tools » Options)。このダイアログは、ドキュメントビューのField Settings 領域にあるOptionsボタンをクリックすることでもアクセスできます。

Specifying search paths for symbol and model libraries.

シンボルおよびモデルライブラリの検索パスを指定します。

リストにパスを追加するには:

  1. ライブラリ検索パスの領域の下にあるフィールドにパスを直接入力するか、Browse for a folder buttonボタンをクリックしてフォルダーを参照するダイアログにアクセスし、必要なライブラリ/モデルファイルが存在するディレクトリを見つけることができます。

  2. フルパスまたは相対パス(DbLibファイルの場所に対して相対的)として追加できます。これをAdd/Update As Relative Pathオプションを使用して制御します。

  3. 必要なパスを指定した後、Addボタンをクリックして検索パスリストに追加します。

  4. 必要に応じて追加の検索パスを追加し続けてください。

直接入力の場合、間違ったパス(存在しないフォルダーへのパスなど)を指定すると、エントリは追加されますが、リストには無効な検索パスであることを示すためにグレーアウトして表示されます。誤ってパスを入力したことに気付いた場合は、リストからそれを選択し、Removeボタンをクリックするか、パス定義を修正してUpdateボタンをクリックできます。

ライブラリ検索パスは、データベースライブラリからフォームを配置する際や、配置後にモデルを検索する際にライブラリおよびモデルファイルが見つかる場所を決定します。使用される特定のモデルは、ライブラリ検索パスの設定や、データベースに特定のライブラリ情報を追加したかどうかによって異なります。検索は以下の順序で進行します:

  1. シンボルまたはモデルのマッピングされたパスフィールドに完全なパスが存在する場合は、そのライブラリ/モデルファイルを使用し、該当する参照フィールドに指定されたシンボルまたはモデルを抽出します。

  2. シンボルまたはモデルのマッピングパスフィールドに相対パスが存在する場合は、そのライブラリ/モデルファイルを使用し、該当する参照フィールドに指定されたシンボルまたはモデルを抽出します。

  3. シンボルまたはモデルのマッピングされたパスフィールドにライブラリ/モデルファイル名のみが存在する場合は、検索パスを使用して指定された名前と一致し、該当する参照フィールドに指定されたシンボルまたはモデルと一致する最初のライブラリ/モデルファイルを特定します。

  4. シンボルまたはモデルのマッピングされたパスフィールドにライブラリ/モデルファイル名のみが存在する場合は、検索パスを使用して指定された名前と一致し、該当する参照フィールドに指定されたシンボルまたはモデルと一致する最初のライブラリ/モデルファイルを特定します。

SVNデータベースライブラリ

SVNDbLibの場合、シンボルとフットプリントモデルが存在するSubversionリポジトリ内の基本ディレクトリは、Database Library OptionsダイアログのSVN Repositoryタブに指定されています(Tools » Options)。このダイアログは、ドキュメントビューのField Settings領域にあるOptionsボタンをクリックすることでもアクセスできます。

Specifying base repository directories for symbols and footprints.

シンボルとフットプリントのためのベースリポジトリディレクトリを指定します。

Models Location領域にある利用可能なフィールドを使用して、シンボルとフットプリントのベースディレクトリを指定します。フィールドの右側にあるClick the ellipsis button to select the repository folder for the symbols and footprintsボタンをクリックして、リンクされたリポジトリへのウィンドウであるBrowse for directoryダイアログにアクセスします。このダイアログを使用して、必要なフォルダを選択します。

Browsing for the relevant directory in the linked SVN repository.

リンクされたSVNリポジトリ内の関連ディレクトリをブラウジングしています。

シンボルとフットプリントは指定されたベースリポジトリディレクトリ内に存在する必要があることを強調することが重要です。もちろん、それらのディレクトリのサブフォルダに存在することもでき、シンボルとフットプリントの両方に指定されたパスはリポジトリ内の同じディレクトリを指すことができます。

モデルの場所は、バージョン管理されたデータベースライブラリからフォームを配置する際や、配置後にモデルを検索する際にライブラリおよびモデルファイルが見つかる場所を決定します。使用される特定の回路記号とフットプリントモデルは、これらの場所をどのように設定したか、またはデータベースに特定のライブラリ情報を追加したかによって異なります。検索は次の順序で進行します。

  1. シンボルまたはフットプリントモデルのマッピングパスフィールドに完全なパスが存在する場合(例: http://MyServer/svn/MyCompany/ParentDirectory/SchematicSymbols/Capacitor_NonPolarized.SchLib)、そのライブラリファイルを使用し、該当する参照フィールドに指定されたシンボルまたはフットプリントを抽出します。

  2. シンボルまたはフットプリントモデルのマッピングパスフィールドにリポジトリのルートに対する相対パス(例:/ParentDirectory/SchematicSymbols/Capacitor_NonPolarized.SchLib)が存在する場合、そのライブラリファイルを使用し、該当する参照フィールドに指定されたシンボルまたはフットプリントを抽出します。ダイアログのリポジトリサーバー接続領域で指定されたリポジトリのURLは、入力したパスの前に付加され、絶対アドレスが得られます。

  3. シンボルまたはフットプリントモデルのマッピングされたパスフィールドにライブラリファイル名のみが存在する場合(例:Capacitor_NonPolarized.SchLib)、リポジトリ内の指定されたモデルの場所を使用して、指定された名前と一致する最初のライブラリファイルを特定し、該当する参照フィールドに指定されたシンボルまたはフットプリントモデルと一致するものを含むファイルを見つけます。

シンボル/モデルの一致を検索する際、ベースシンボルまたはフットプリントディレクトリ内のフラットなフォルダパスはアルファベット順にソートされ、検索されます。Library Splitter Wizardが使用される場合、実際のシンボル/フットプリントの名前を持つ対応するライブラリが常に存在します。

  1. データベースにライブラリファイル情報が存在しない場合は、指定されたモデルの場所を使用して、該当する参照フィールドに指定されたシンボルまたはフットプリントモデルに一致する最初のライブラリファイルを特定します。

シンボル/フットプリントを特定する際、システムは最初にシンボルまたはフットプリント自体に似た名前の最初のライブラリを探します。たとえば、データベース内の論理シンボル名([Library Ref]マッピングで指定された)はCapacitor_NonPolarizedである場合、システムは最初にCapacitor_NonPolarized.SchLibという名前のファイルを探し、このファイル内でシンボルを探します。この方法でシンボル/フットプリントが見つからない場合、システムはすべてのライブラリで一致を探します。

AI-LocalizedAI-localized
If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
機能の可用性

利用できる機能は、所有する Altium ソリューション (Altium DevelopAltium Agile のエディション (Agile Teams、または Agile Enterprise)、または Altium Designer (有効な期間)) によって異なります。

説明されている機能がお使いのソフトウェアに表示されない場合、Altium の営業担当者にお問い合わせください

従来のドキュメント

Altium Designer のドキュメントは、バージョンごとに掲載されなくなりました。Altium Designer の旧バージョンのドキュメントは、Other Installers ページの Legacy Documentation の項目をご覧ください。

Content