データベースライブラリの作成と定義
データベースライブラリ機能の基盤はデータベースライブラリファイルです。これには、標準データベースライブラリを使用している場合と、バージョン管理されたデータベースライブラリを使用している場合とで、2つの形式があります:
-
標準データベースライブラリ - データベースライブラリファイル。このファイルは、Altium DesignerのDatabaseLibエディタを使用して作成および管理されます。このエディタは、メインデザインウィンドウのアクティブドキュメントが*.DbLibファイルである場合に利用可能になります。
-
バージョン管理データベースライブラリ - SVNデータベースライブラリファイル。このファイルは、Altium DesignerのSVNDatabaseLibエディタを使用して作成および管理されます。このエディタは、メインデザインウィンドウのアクティブドキュメントが*.SVNDbLibファイルである場合に利用可能になります。
DatabaseLibエディタで開かれたDbLibファイルの例。画像にカーソルを合わせると、SVNDatabaseLibエディタで開かれたSVNDbLibファイルの例が表示されます。
これらのタイプの新しいファイルを作成するには、メインメニューからFile » New » Library コマンドを選択し、開かれたDatabase LibraryまたはSVN Database LibraryオプションをDatabase領域のNew Libraryダイアログから選択します。
外部データベースへの接続
テーブルとマッピングデータは、アクティブなデータベースライブラリ/SVNデータベースライブラリファイルが必要な外部データベースに正常に接続された後にのみ、エディタのメイン表示ウィンドウに表示されます。接続は、Source of Connection領域で提供されるコントロールを使用して定義されます。
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ボタンの右側、領域の下部にあります)をクリックすることでも定義できます。
データベース接続ダイアログのオプションとコントロール
Connectionタブ
-
Source of Connection
-
Use Data Link File - 接続文字列は、データベースへの接続情報の文字列バージョンであり、.udl拡張子を持つ別のファイルとして保存できます。これはMicrosoft Data Linkファイルと呼ばれます。データベースへの接続元としてデータリンクファイルを使用したい場合は、このオプションを選択してからBrowseをクリックしてSelect Data Link Fileダイアログを開くか、ドロップダウンを使用して所望の.udlファイルを検索します。
-
Use Connection String - このオプションを選択してからBuildをクリックすると、Data Link Propertiesダイアログが開き、コンポーネントのパラメータのマッピングのためにデータベースへの接続文字列を再構築できます。接続文字列に指定される情報は、指定されたOLE DBプロバイダによって異なる場合があります。
-
Advancedタブ
-
SQL Options
-
Quote Tables - テーブルを引用するための特定の引用符を使用するために有効にします。
-
Left Quote Character - 左引用符を指定します。デフォルトは"["です。
-
Right Quote Character - 右引用符を指定します。デフォルトは"]"です。
-
-
-
Include Table Schema Names - このオプションを有効にすると、テーブルスキーマ名を含むテーブルが含まれます。デフォルトでは、このオプションはオフになっており、通常のテーブル名のみが使用されます。
-
Field Data Type - 新しいフィールドのデータ型を指定します。たとえば、MS AccessやMySQLデータベースにはTEXT(N)または
VARCHAR(N)を使用でき、OracleデータベースにはVARCHAR2(N)を使用できます。
アクセスとエクセルデータベースへの高速接続
Select Database Typeオプションは、ターゲットデータベースがMicrosoft AccessまたはMicrosoft Excelを使用して作成された場合に、接続文字列を作成するための迅速な方法を提供します。このオプションを使用して、データベースタイプを選択し、必要なデータベースファイルを参照して選択します。対応する接続文字列が自動的に構成され、Use Connection Stringオプションのフィールドに入力されます。
接続文字列の構築
会社のデータベースがAccessまたはExcelベースでない場合、接続文字列を明示的に構築したい場合は、Use Connection Stringオプションを有効にし、右側の関連するBuildボタンをクリックします。Data Link Propertiesダイアログが表示されます。
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 Data Linkファイル(*.udl)を使用して記述されている場合、接続オプションの3番目であるUse Data Link Fileを有効にし、関連するBrowseボタンをクリックして必要なファイルを見つけてください。データリンクファイルは、本質的に接続文字列の保存容器です。
接続を進める
外部データベースへの接続を定義した後、Connectボタンのテキストが太字になり、接続を進めることができることを示します。接続の詳細が正しければ、ターゲットデータベースのテーブルとマッピング情報がデータベースライブラリ/SVNデータベースライブラリファイルに読み込まれます。ConnectボタンのテキストはConnectedに変わり、ボタンはグレーアウトされます。
接続の詳細に問題がある場合、たとえば接続文字列が正しく構築されていない、またはパスが誤って入力されていると、接続は失敗し、この事実を警告するメッセージが表示されます。接続設定を確認し、再度Connectボタンをクリックしてください。
データベースライブラリにおける接続失敗のフラグ付けの例。
初回接続が成功し、データベースライブラリ/SVNデータベースライブラリファイルが保存された後は、ターゲットデータベースの場所とファイル名が変更されない限り、ファイルが開かれるたびに接続が自動的に行われます。
バージョン管理リポジトリへのリンクを指定する(SVNDbLibのみ)
DbLibでは、シンボルとモデルのライブラリがハードディスクやその他のローカル/ネットワーク媒体に保存されます。SVNDbLibの場合、これらのライブラリはSubversionリポジトリ内のバージョン管理下に保存されることを覚えておいてください。SVNDbLibファイルの一部として、このリポジトリへのリンクを定義する必要があります。Database Library Optionsダイアログ(Tools » Options)のSVN Repositoryタブで、SVNリポジトリへの接続が定義されます。このダイアログは、ドキュメントビューのField Settings領域にあるOptionsボタンをクリックすることでアクセスすることもできます。
ファイルベースのSVNリポジトリへの接続例。
データベーステーブルリスト
外部データベースへの接続に成功すると、テーブルとマッピングデータが読み込まれます。DbLib/SVNDbLibドキュメントの左側には、接続されたデータベースに存在するすべてのテーブルがリストされます。
接続されたデータベースに存在するテーブル。
各テーブルエントリの隣にあるEnableオプションを使用すると、そのテーブルが結果のデータベースライブラリの一部となるかどうかを制御できます。データベースライブラリがComponentsパネルの利用可能なファイルベースのライブラリリストに追加されると、各テーブルは別々のライブラリエンティティとして表示されます。したがって、実際には1つのデータベースライブラリのみが追加されているにもかかわらず、Componentsパネルの観点からは、複数の異なるライブラリを追加したように見えます。詳細については、ファイルベース&データベースライブラリでのコンポーネントの検索を参照してください。
リスト内のテーブルエントリをクリックすると、そのアイコンが
から
に変わり、現在アクティブなテーブルとして区別されます。テーブル(およびそのデータ)はドキュメントのTable Browserタブに表示されます。これはテーブルの編集可能なビューであり、外部データベース自体を起動することなく、その内容をすばやく参照し、必要に応じて編集できます。
接続されたデータベースのソーステーブルを閲覧。
マッチング基準の指定
外部データベースからコンポーネントが配置された後、配置されたコンポーネントとそれを作成するために使用されたデータベースレコードとの間のリンクを保持する方法が必要です。本質的に、これらの二つをマッチさせる必要があります。
コンポーネントが配置されると、そのパラメータ情報は、データベースレコードの対応するフィールドを使用してその場で作成されます。配置後のスキーマティックコンポーネントとデータベースレコードとのリンクは、これらのパラメータの1つ以上を使用して確立されます。Field Settings領域では、マッチング基準を定義できます。これは、単純な単一キー検索、またはWhere句を使用したより高度なマッチングのいずれかです。
配置後のマッチング基準の制御。
単一キー検索
Single key lookupオプションが有効になっている(デフォルト)場合、Database fieldとPart 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メニューからアクセスできます。
Database ConnectionダイアログのAdvancedタブでは、構築されたWhere句でテーブルを引用したり、テーブルスキーマ名を使用したりするための追加のSQLオプションが提供されます。
波括弧(ブレース)は、参照されているエントリが設計パラメータであることを指定します。シングルクォートは、設計パラメータを数値(クォートなし)ではなく文字列として扱うことを指定するために使用されます。型の一致は非常に重要であり、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タブで行われます。
DbLib/SVNDbLibドキュメントのField Mappingsタブでパラメータマッピングと更新オプションを指定します。
モデルとパラメータのマッピング
Field Mappingsタブの左から2つの列は、データベースからどの情報をコンポーネントの属性、モデル、パラメータにマッピングするかを制御するために使用されます。
-
Database Field Name - この列は、データベースの現在アクティブなテーブル内のすべてのフィールド(列)名を一覧表示します。
-
Design Parameter - この列は、データベース内の各対応するフィールドがどのように使用されるかを定義します。これは、コンポーネントのシンボルやフットプリントモデルをソースするためのものである可能性があり(角括弧で囲まれます)、またはコンポーネントパラメータとして含めるためのものである可能性があります(これらは括弧で囲まれていません)。
データベースへの接続時には、すべてのデータベースフィールドが自動的にマッピングされます。
属性 & モデル
データベースフィールド名が以下の予約名のいずれかである場合、対応する属性/モデルマッピングエントリはDesign Parameterフィールドで自動的に設定されます:
-
Description → [Description]
-
Footprint Ref → [Footprint Ref]
-
Footprint Path → [Footprint Path]
-
Footprint Ref n → [Footprint Ref n]
-
Footprint Path n → [Footprint Path n]
-
Library Ref → [Library Ref]
-
Library Path → [Library Path]
-
Orcad Footprint → [Orcad Footprint]
-
Orcad Library → [Orcad Library]
-
PCB3D Ref → [PCB3D Ref]
-
PCB3D Path → [PCB3D Path]
-
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]
これらのマッピングは、コンポーネントの属性とモデル情報を定義します。コンポーネントが配置されると、対応するデータベースレコードの[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]など)を選択して手動でマッピングする必要があります。
コンポーネントの配置時にシンボルとモデル情報を定義するためには、データベース内のシンボルおよびモデル参照フィールドが重要なマッピングエンティティです。定義されたマッピングの一部として、シンボルと少なくとも1つのPCBフットプリント参照が存在することを確認してください。
シミュレーションモデルマッピング
このセクションでは、コンポーネント配置時に作成されるシミュレーションモデルリンクを定義するために、外部データベーステーブルに追加できる各データベースフィールドについて説明します。
-
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フィールドに指定されたモデルに一致する最初のモデルファイルを見つけるために使用されます。
-
-
Sim Kind – リンクされているモデルの親カテゴリ。
-
Sim SubKind – リンクされているモデルのタイプ。
-
Sim Netlist – リンクされているモデルのタイプに応じたネットリストテンプレート情報。このフィールドは、独自のネットリストテンプレートを指定し、Sim SubKindフィールドを
Generic Editorに設定した場合、ネットリストに配置される情報をより制御できるため、特に重要になります。
ネットリストテンプレート構文
ネットリストテンプレートを定義する際に入力される情報は、SPICEの要件および以下に記載された構文ルールに従っている必要があります。
テンプレートに入力された文字は、以下の特殊文字を除いて、SPICEネットリストにそのまま書き込まれます:
| % | パーセント記号 |
| @ | コマーシャルアット |
| & | アンパサンド |
| ? | クエスチョンマーク |
| ~ | チルド |
| # | 数字記号 |
これらの文字は、次の表に示すように、ネットリストの作成時に変換されます:
| ネットリストテンプレートの構文... | ネットリスターが置き換えるもの... |
|---|---|
| @<param> | <param>の値。 この名前のパラメータが存在しないか、値が割り当てられていない場合はエラーが発生します。 |
| &<param> | <param>の値。 パラメータが未定義の場合でもエラーは発生しません。 |
| ?<param>s...s | <param>が定義されている場合はs...sセパレータ間のテキスト。 |
| ?<param>s...ss...s | <param>が定義されている場合は最初のs...sセパレータ間のテキスト、そうでなければ2番目のs...sセパレータ間。 |
| ~<param>s...s | <param>が未定義の場合はs...sセパレータ間のテキスト。 |
| ~<param>s...ss...s | <param>が未定義の場合は最初のs...sセパレータ間のテキスト、そうでなければ2番目のs...sセパレータ間。 |
| #<param>s...s | <param>が定義されているが、<param>が未定義の場合はテンプレートの残りを無視してs...sセパレータ間のテキスト。 |
| #s...s | ネットリストテンプレートの後続エントリからXSpiceネットリストに入力されるテキストがある場合はs...sセパレータ間のテキスト。 |
| %<pin id> | <pin id>にマップされたスキーマティックピンが接続するネットのネット名。 |
| %% | パーセント記号そのもの。 |
上記の表では、
- sはセパレータ文字(, . ; / |)を表します。
- <param>はパラメータの名前を指します。
パラメータ名に英数字以外の文字が含まれる場合は、二重引用符で囲む必要があります。例えば:
@"DC Magnitude" - 名前にスペースが含まれるため、二重引用符が使用されています。
&"Init_Cond" - 名前にアンダースコアが含まれるため、二重引用符が使用されています。
パラメータ名に英数字のプレフィックスを追加したい場合も、二重引用符を使用する必要があります。例えば:
@"DESIGNATOR"A - 二重引用符の使用により、Aがコンポーネント指定子に追加されることを保証します。
前の表の特殊文字構文エントリの例を以下に示します。各ケースについて、ネットリスターによって構文エントリがどのように翻訳されるかについての情報が与えられています。
@"AC Phase"
パラメータ名AC Phaseはスペースのために中括弧で囲まれます。これはネットリストでAC Phaseパラメータの値に置き換えられます。この名前のパラメータがない場合、またはその値が空白の場合はエラーが出ます。
&Area
Areaという名前のパラメータが存在し、値がある場合、その値がネットリストに入力されます。パラメータが未定義の場合(つまり、存在しないか値が割り当てられていない場合)、ネットリストには何も書き込まれませんが、エラーは発生しません。これはオプショナルなパラメータに使用できます。
?IC|IC=@IC|
ICという名前のパラメータが定義されている場合、||セパレータ内のテキストがネットリストに挿入されます。例えば、パラメータICの値が0.5の場合、このエントリの代わりにネットリストにIC=0.5が挿入されます。パラメータが未定義の場合、ネットリストには何も挿入されません。
?IC/IC=@IC//IC=0/
これは前の例と同じですが、パラメータICが未定義の場合はIC=0がネットリストに挿入されます。また、異なるセパレータ文字が使用されていることにも注意してください。
~VALUE/1k/
VALUEという名前のパラメータが未定義の場合、テキスト1kがネットリストに挿入されます。
~VALUE/1k//@VALUE/
これは前の例と同じですが、パラメータVALUEが定義されている場合はそのテキスト値がネットリストに挿入されます。
#"AC Magnitude"|AC@"AC Magnitude"|@"AC Phase"
この例は正弦波電圧源のための事前定義されたネットリストテンプレートで見ることができます。
AC Magnitudeパラメータが定義されている場合、セパレータの内容が評価され、ネットリストに挿入されます。ネットリストの後続エントリも評価され、ネットリストに入力されます(この場合は@"AC Phase")。
例えば、AC Magnitude=1およびAC Phase=0の場合、ネットリストにはAC 1 0が挿入されます。しかし、AC Phaseが未定義の場合、エラーが発生します。
パラメータAC Magnitudeが未定義の場合、ネットリストテンプレートの#"AC Magnitude"エントリに続くものはネットリストに入力されません。
#|PARAMS:|?Resistance|Resistance=Resistance|?Current|Current=@Current|
この例はパラメータ化されたサブサーキットのための事前定義されたネットリストテンプレートで見ることができます(Fuse.PrjPcbのF1を参照)。
抵抗と電流のパラメータが両方とも未定義の場合、|PARAMS:|エントリの後にネットリストに挿入されるテキストはないため、区切りのテキストも省略されます。
例えば、パラメータの値が抵抗=1kおよび電流=5mAの場合、これは|PARAMS:|エントリに続くテキストを生成し、PARAMS: 抵抗=1k 電流=5mAがネットリストに作成されるエントリになります。
@DESIGNATOR%1%2@VALUE
この例は、%文字の使用を示すためのものです。
例えば、パラメータに値DESIGNATOR=R1およびVALUE=1kが設定されている場合、ピンは次の表に従ってSim ModelダイアログのPin Mapping領域にマッピングされます:
| 回路図ピン | モデルピン | 接続される回路図ピンのネット名 |
|---|---|---|
| 1 (N+) | 1 (1) | GND |
| 2 (N-) | 2 (2) | OUT |
次に、テキストR1 GND OUT 1kがこのコンポーネントのSPICEネットリストに配置されます。
-
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
パラメータ
データベースの他のすべてのフィールド名は、同じ名前を使用して設計パラメータに自動的にマッピングされます。例えば、データベースのフィールドがToleranceと呼ばれている場合、その名前の設計パラメータがそれにマッピングされます。設計パラメータの名前を変更するには、そのセル内をクリックして新しい名前を直接入力します。これらの設計パラメータ名が、回路図シートに配置された後のコンポーネントの関連プロパティダイアログのParameters 領域に表示されます。
データベースに関連付けられたコンポーネントのデータフィールドが多数ある場合がありますが、回路図シートに配置されたコンポーネントに設計パラメータとして追加したい、または必要とするものはすべてではありません。この情報の多くは、材料表を生成する際にのみ必要とされる場合があります。Report Managerダイアログを使用すると、リンクされたデータベースから直接BOMにパラメータ情報を追加でき、回路図ソースドキュメントに「持ち込まれる」情報の量を減らすことができます。詳細については、レポートマネージャーでBOMを準備するセクションを参照してください。
データベースからマッピングされたくないフィールドについては、Design Parameterエントリを[None]に設定します。マッピングされていないデータベースフィールドは、赤い十字アイコンを使用してタブ上で区別されます。マッピングされたデータベースフィールドは、緑のチェックアイコンによって区別されます。
必要に応じてパラメータマッピングを設定します。データベースのパラメータが配置されたコンポーネントにマッピングされないようにするには、[None]に設定します。
必要に応じて、マッピングされていないパラメータをBOMに直接含めることができます。
パラメーター更新オプション
データベースライブラリからコンポーネントを初めて配置する際、または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)を選択できます。このオプションは、コンポーネントが配置された後にデータベースからパラメータを更新するコマンドを使用する際に遵守されます。
必要に応じて、パラメーター更新オプションは手動で上書きできます。
画像を見て、更新オプションに関して重要なポイントが4つあります:
-
マッピングされていないデータベースフィールドには、関連する更新オプションがありません。
-
属性およびモデルベースのマッピング(Design Parameter列の角括弧内のエントリ)には、これらがデザインパラメータではないため、関連する更新オプションはありません。
-
キー フィールド (画像のPart Numberなど) には関連する更新オプションはありません。このフィールドはパラメータの一致目的のみに使用されます。
-
Defaultの設定は、Database Library OptionsダイアログのDefault Actionsタブに指定された対応するデフォルト定義に従う更新オプションを引き起こします(メインメニューのTools » OptionsまたはTable Browserタブの右クリックメニューのOptions)。このダイアログは、ドキュメントビューのField Settings領域にあるOptionsボタンをクリックすることでもアクセスできます。
DbLibのデフォルトパラメータ更新オプションを中央の場所で定義します。画像にカーソルを合わせると、SVNDbLibの同等のものが表示されます。
第四のポイントは、中央の場所から更新オプションを指定できるため有益であり、各マッピングされたフィールドの更新オプションを定義する際にその場所を指し示すことができます。これが、データベースフィールドを設計パラメータにマッピングする際に、関連する更新フィールドに自動的にDefaultエントリが読み込まれる理由です。
更新オプションのデフォルト設定を上書きしたい場合は、Field Mappingsタブの関連する更新フィールド内をクリックし、再度クリックして適用可能な更新選択肢を提供するドロップダウンにアクセスします。
必要に応じて、パラメーター更新オプションは手動で上書きできます。
このようにして、デザインのパラメータがどのように更新されるかを完全に制御できます。すべてのフィールドを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ファイル内でライブラリ検索情報を指定することができます。これにより、データベース内でソースライブラリやモデルファイルの名前を指定することができるか、まったく定義しないことも可能です。
データベースライブラリ
DbLibの場合、ライブラリ検索パスはDatabase Library OptionsダイアログのSymbol and Model Search Pathsタブで定義されています(Tools » Options)。このダイアログは、ドキュメントビューのField Settings 領域にあるOptionsボタンをクリックすることでもアクセスできます。
シンボルおよびモデルライブラリの検索パスを指定します。
リストにパスを追加するには:
-
ライブラリ検索パスの領域の下にあるフィールドにパスを直接入力するか、
ボタンをクリックしてフォルダーを参照するダイアログにアクセスし、必要なライブラリ/モデルファイルが存在するディレクトリを見つけることができます。
-
フルパスまたは相対パス(DbLibファイルの場所に対して相対的)として追加できます。これをAdd/Update As Relative Pathオプションを使用して制御します。
-
必要なパスを指定した後、Addボタンをクリックして検索パスリストに追加します。
-
必要に応じて追加の検索パスを追加し続けてください。
ライブラリ検索パスは、データベースライブラリからフォームを配置する際や、配置後にモデルを検索する際にライブラリおよびモデルファイルが見つかる場所を決定します。使用される特定のモデルは、ライブラリ検索パスの設定や、データベースに特定のライブラリ情報を追加したかどうかによって異なります。検索は以下の順序で進行します:
-
シンボルまたはモデルのマッピングされたパスフィールドに完全なパスが存在する場合は、そのライブラリ/モデルファイルを使用し、該当する参照フィールドに指定されたシンボルまたはモデルを抽出します。
-
シンボルまたはモデルのマッピングパスフィールドに相対パスが存在する場合は、そのライブラリ/モデルファイルを使用し、該当する参照フィールドに指定されたシンボルまたはモデルを抽出します。
-
シンボルまたはモデルのマッピングされたパスフィールドにライブラリ/モデルファイル名のみが存在する場合は、検索パスを使用して指定された名前と一致し、該当する参照フィールドに指定されたシンボルまたはモデルと一致する最初のライブラリ/モデルファイルを特定します。
-
シンボルまたはモデルのマッピングされたパスフィールドにライブラリ/モデルファイル名のみが存在する場合は、検索パスを使用して指定された名前と一致し、該当する参照フィールドに指定されたシンボルまたはモデルと一致する最初のライブラリ/モデルファイルを特定します。
SVNデータベースライブラリ
SVNDbLibの場合、シンボルとフットプリントモデルが存在するSubversionリポジトリ内の基本ディレクトリは、Database Library OptionsダイアログのSVN Repositoryタブに指定されています(Tools » Options)。このダイアログは、ドキュメントビューのField Settings領域にあるOptionsボタンをクリックすることでもアクセスできます。
シンボルとフットプリントのためのベースリポジトリディレクトリを指定します。
Models Location領域にある利用可能なフィールドを使用して、シンボルとフットプリントのベースディレクトリを指定します。フィールドの右側にある
ボタンをクリックして、リンクされたリポジトリへのウィンドウであるBrowse for directoryダイアログにアクセスします。このダイアログを使用して、必要なフォルダを選択します。
リンクされたSVNリポジトリ内の関連ディレクトリをブラウジングしています。
モデルの場所は、バージョン管理されたデータベースライブラリからフォームを配置する際や、配置後にモデルを検索する際にライブラリおよびモデルファイルが見つかる場所を決定します。使用される特定の回路記号とフットプリントモデルは、これらの場所をどのように設定したか、またはデータベースに特定のライブラリ情報を追加したかによって異なります。検索は次の順序で進行します。
-
シンボルまたはフットプリントモデルのマッピングパスフィールドに完全なパスが存在する場合(例: http://MyServer/svn/MyCompany/ParentDirectory/SchematicSymbols/Capacitor_NonPolarized.SchLib)、そのライブラリファイルを使用し、該当する参照フィールドに指定されたシンボルまたはフットプリントを抽出します。
-
シンボルまたはフットプリントモデルのマッピングパスフィールドにリポジトリのルートに対する相対パス(例:/ParentDirectory/SchematicSymbols/Capacitor_NonPolarized.SchLib)が存在する場合、そのライブラリファイルを使用し、該当する参照フィールドに指定されたシンボルまたはフットプリントを抽出します。ダイアログのリポジトリサーバー接続領域で指定されたリポジトリのURLは、入力したパスの前に付加され、絶対アドレスが得られます。
-
シンボルまたはフットプリントモデルのマッピングされたパスフィールドにライブラリファイル名のみが存在する場合(例:Capacitor_NonPolarized.SchLib)、リポジトリ内の指定されたモデルの場所を使用して、指定された名前と一致する最初のライブラリファイルを特定し、該当する参照フィールドに指定されたシンボルまたはフットプリントモデルと一致するものを含むファイルを見つけます。
-
データベースにライブラリファイル情報が存在しない場合は、指定されたモデルの場所を使用して、該当する参照フィールドに指定されたシンボルまたはフットプリントモデルに一致する最初のライブラリファイルを特定します。