6.13.3 Файл интерфейса (Ifspec.ifs)

Файл интерфейса задает выходные и входные таблицы (out, in tables) имена, используемые моделью, электрические соединения с устройством (ports) и определенные пользователем переменные (parameters), которые поддерживают лучшее управление поведением модели. Таблицы поясняются в этом разделе с примерами, приведенными для каждой из них. Пример файла интерфейса показан в «Пример файла интерфейса». Файл интерфейса, вместе с файлом реализации (implementation) нуждаются в компиляции в DLL для завершения построения код-модели.

6.13.3.1 Таблица имен

Имя модели, текст описания и имя реализации функции на Си определены в таблице имен. Имя модели должно быть тем же, что и поддиректория, содержащая файлы код-модели. Рекомендуется, чтобы имя модели было восьми символьным.

Таблица имен имеет следующий синтаксис:

NAME_TABLE:

C_Function_Name: function_name Spice_ModelName: model_name Description: “text”

где:

function_name это действительный Си идентификатор, являющийся именем основной точки входа (функции) для код-модели. Он может быть, а может не быть, таким же, как имя SPICE модели. Для избежания конфликта имен мы рекомендуем вам использовать префикс «UCM_» для использования с код-моделью или пользоваться префиксом на ваш выбор. Следующие префиксы используются ядром XSPICE симулятора и не должны использоваться пользовательскими код-моделями:

model_name это действительный SPICE идентификатор, который будет использован в SPICE deck .model записи для ссылки на эту кодмодель. Может быть, а может не быть, с тем же именем, что и Си

Например:

NAME_TABLE:

Spice_Model_Name: capacitor C_Function_Name: cm_capacitor

Description: “Capacitor with voltage initial condition”

6.13.3.2 Таблицы портов

Порты устройства определены в таблице портов. Таблица портов имеет следующий синтаксис:

PORT_TABLE:

Port_Name: name Description: text Default_Type: default Allowed_Type: [type type type] Vector: vector Vector_Bounds: size

Direction: dataflow Null_Allowed: null

где:

name это действительный SPICE идентификатор, дающий имя порту.

text это строка, описывающая назначение и функционирование порта.

default задает тип, используемый для порта, когда тип явно не задан. Должен

быть одним из пунктов списка «type».

vector задает будет или нет порт вектором и может считаться шиной. Выбор из:

*yes — этот порт вектор

*no — этот порт не вектор

dataflow задает направление потока (dataflow) через порт. Выбор из:

*in

*out

*inout

6.13.3.3 Таблица параметров

Параметры устройства определены в таблице параметров. Таблица параметров имеет следующий синтаксис:

PARAMETER_TABLE:

Parameter_Name: name Description: text Data_Type: type Vector: vector Vector_Bounds: size Default_Value: default Limits: range Null_Allowed: null

где:

name это действительный SPICE идентификатор, который будет использован в SPICE deck .model карте для ссылки на этот параметр.

textстрока, описывающая назначение и функционирование параметра.

type тип данных параметра. Относится к основному типу данных Си (то есть, «double»), не к концептуальному типу параметра (то есть, «voltage». Выбор из:

*boolean (если тип данных Си “Boolean_t” с правильными значениями MIF_TRUE и MIF_FALSE)

*complex (если тип данных Си “Complex_t” с двумя частями: действительной и мнимой)

*int (если тип данных Си “int”)

*real (если тип данных Си “double”)

*string (если тип данных Си “char*”)

*pointer (если тип данных Си “void*”)

vector: определяет, будет ли параметр вектором или скаляром. Выбор из: * yes — параметр вектор

* no — параметр скаляр

Например:

PARAMETER_TABLE: