Working with the Variant Manager

Variant Manager — это интерфейс на основе документа, который позволяет просматривать, создавать и управлять вариантами проекта вашей печатной платы. Чтобы открыть Variant Manager, щелкните правой кнопкой мыши по записи проекта в панели Projects и выберите Variants либо выберите Project » Variants в главном меню редактора схемы или PCB.

Работа с вариантами

Создание нового варианта

Чтобы добавить новый вариант, используйте кнопку Add Variant , расположенную в левом верхнем углу Variant Manager, когда активна вкладка Variants. В области таблицы появится дополнительный столбец варианта с названием по умолчанию, как показано на изображении ниже. Все ячейки нового столбца будут пустыми; пустая ячейка означает, что данный компонент установлен (Fitted) и не изменён относительно базового проекта.

Новый вариант добавляется так, что по умолчанию все компоненты имеют состояние Fitted.

Вы можете отфильтровать варианты, отображаемые в Variant Manager, с помощью диалога Variants Filter, который открывается щелчком по в правом верхнем углу. Чтобы отфильтровать отображаемые варианты, установите флажок(и), соответствующие вариантам, которые нужно показывать. После нажатия OK в диалоге варианты будут отфильтрованы согласно включённым флажкам. Когда фильтр применён, кнопка фильтра отображается как . Чтобы убрать или изменить фильтрацию, нажмите кнопку фильтра, чтобы снова открыть диалог Variants Filter, затем обновите флажки. Когда включён флажок Project Variants , отображаются все варианты проекта. 

Настройка свойств варианта

Чтобы изменить параметры варианта, используйте панель Properties в режиме Variant, который можно открыть, щелкнув правой кнопкой мыши по заголовку столбца нужного варианта и выбрав Properties.

Откройте панель Properties в режиме Variant, чтобы изменить параметры варианта.

• Задайте осмысленное имя варианта в поле Name.

  Имя варианта также можно изменить с помощью диалога Rename Variant , который открывается так: щелкните заголовок столбца варианта, чтобы выделить его, затем нажмите  в левом верхнем углу Variant Manager, либо щелкните правой кнопкой мыши по заголовку столбца варианта и выберите Rename Variant.

• Вы можете указать, нужно ли для альтернативной детали менять её символ на схеме или добавлять её посадочное место на PCB, с помощью следующих опций:

  • Do not overwrite schematic symbol – если включено, для компонентов, для которых в варианте выбраны альтернативные детали, будут использоваться неизменяемые (non-varied) символы.

    Обратите внимание: эта опция влияет только на отображение символа на листе схемы. Символ альтернативной детали учитывается при построении модели связности (connectivity) проекта. Поэтому базовый и альтернативный компоненты должны быть совместимы по выводам (pin-compatible), даже если опция включена. Подробнее о совместимости по выводам см. в разделе Defining Component Variations.

  • Do not overwrite PCB footprint – если включено, для компонентов, для которых в варианте выбраны альтернативные детали, будут использоваться неизменяемые (non-varied) посадочные места. Посадочное место альтернативной детали, применённой к варианту, не будет перенесено на PCB в рамках обновления PCB (ECO на добавление посадочного места на PCB не будет сформирован).

  Независимо от того, включены эти два параметра или нет, параметры выбранной альтернативы корректно отображаются в ActiveBOM.

• Если из проекта нужно формировать производственные (fabrication) варианты, включите опцию Allow variation of fabrication outputs. Если в output job для производственного вывода назначен вариант, и у этого варианта опция not не включена, имя варианта в job будет отображаться красным. Учтите, что красное имя варианта — это лишь предупреждение; файлы вывода, специфичные для варианта, всё равно будут сгенерированы.

  Если нужно формировать выходные данные для паяльной пасты (paste mask) для проекта, включающего варианты с компонентами в состоянии 'Not Fitted', включите опцию Allow variation for paste mask . Для этих компонентов паста больше не будет включаться на их площадках.

  Информацию о том, как добавлять и просматривать варианты в файле Output Job, см. на странице Preparing Manufacturing Data with Output Jobs.

• Используйте область Variant's Parameters панели, чтобы задать список параметров уровня варианта.

  Параметр варианта можно вывести в документе схемы или PCB, разместив специальную строку. Подробнее см. Special Strings on a Schematic и Special Strings on a PCB.

  Altium Designer поддерживает параметры на разных уровнях проекта: проект, документ схемы и вариант. Параметры, заданные на разных уровнях проекта, образуют иерархию, то есть вы действительно можете создать параметр с одинаковым именем на разных уровнях проекта, при этом у каждого будет своё значение. Altium Designer разрешает такую ситуацию, используя приоритеты следующим образом:

  1. Вариант (наивысший приоритет)
  2. Документ схемы
  3. Проект

  Это означает, что значение параметра, заданное в документе схемы, переопределяет значение, заданное в параметрах проекта, а значение параметра, заданное в варианте, переопределяет значение, заданное в документе схемы.

Свойства варианта

Щелкните правой кнопкой мыши по ячейке, затем выберите Properties , чтобы открыть панель Properties , отображающую сведения о выбранном Component/Group. Component Parameters варианта можно при необходимости отредактировать. 

Параметры также можно просматривать и редактировать, выбрав компонент в таблице и затем развернув область Parameter , которая появляется внизу таблицы.

Определение вариаций компонентов

Каждый компонент в базовом проекте можно настроить так, чтобы он был:

• Fitted – настройка по умолчанию при создании нового варианта.
• Not Fitted – исходный компонент, используемый в базовом проекте, не устанавливается/не используется в этом варианте проекта.
• Установлен (Fitted) с изменёнными параметрами компонента, например со значением (value) компонента.
• Alternate Part – полная замена одного компонента другим.

Изменить состояние компонента в варианте проекта можно, щелкнув по ячейке компонента в столбце варианта и открыв выпадающий список ячейки, где доступны три варианта:

• (Fitted) – исходный компонент, используемый в базовом проекте, также установлен/используется в этом варианте проекта. Обратите внимание: для установленного компонента также можно варьировать отдельные параметры — см. ниже.

• Not Fitted – исходный компонент, используемый в базовом проекте, не установлен/не используется в этом варианте проекта.

• Alternate Part – эта опция позволяет выбрать другую (альтернативную) деталь. Используйте диалог Replace (это модальная версия панели Components ), чтобы выбрать нужную альтернативную деталь. После выбора ячейка отображает ID альтернативной детали.

  После выбора альтернативной детали программа проверяет совместимость по выводам между выбранным альтернативным компонентом и исходным компонентом базового проекта. Чтобы быть совместимым по выводам, альтернативный компонент должен иметь то же количество выводов, что и исходный, и эти выводы должны совпадать по расположению и электрическому типу. Графические примитивы, используемые в символах двух компонентов, не обязаны совпадать. Если программа обнаружит, что альтернативный компонент не совместим по выводам, перед тем как замена будет принята, потребуется закрыть диалог Confirm . В этом случае следует учитывать возможное влияние на соединения.

Вы можете выбрать альтернативную деталь без изменений символа на схеме и/или без необходимости добавлять посадочное место на PCB. В панели Properties  при необходимости включите опции Do not overwrite schematic symbol  и/или Do not overwrite PCB footprint. Когда включена последняя, посадочное место альтернативного компонента, применённого к варианту, не будет перенесено на PCB в рамках обновления PCB (ECO на добавление посадочного места на PCB не будет сформирован). Параметры выбранной альтернативы корректно отображаются в ActiveBOM.

Перечисленные выше состояния компонентов также можно выбрать, щелкнув правой кнопкой мыши в таблице, выбрав Set Selected As, а затем выбрав нужное состояние в соответствующем меню, как показано ниже.

Определите вариацию компонента с помощью раскрывающегося списка в ячейке требуемого столбца варианта. При выборе параметра Alternate Part используйте диалог Replace, чтобы выбрать альтернативную деталь.

Отдельные параметры для установленного или альтернативного компонента можно изменять, вводя новое значение параметра на панели Properties. Щёлкните ячейку компонента в требуемом столбце варианта и используйте столбец выбранного варианта в области Component Parameters панели Properties в её режиме Component for variant, чтобы ввести изменённое значение параметра. Для параметра Footprint щёлкните раскрывающийся список в ячейке, чтобы выбрать посадочное место, если к компоненту назначено несколько моделей посадочных мест. Значение параметра, отличающееся от базового проекта, будет показано жёлтым цветом, а ячейка компонента в области сетки будет отображать имя компонента.

Пример задания альтернативного параметра для установленного компонента. Введите новое значение параметра, как показано на изображении. Наведите курсор на изображение, чтобы увидеть ячейку компонента после задания нового значения параметра.

Обновление параметра альтернативной детали

Если у библиотечного компонента, используемого как Alternate Part, в библиотеке были изменены параметры, вы можете перенести эти изменения напрямую в определения вариантов в вашем проекте. Выберите команду Update Values from Library в контекстном меню (правый клик) области Parameter в нижней части Variant Manager или в области Component Parameters панели Properties, когда требуемый альтернативный компонент выбран в основной области сетки, чтобы подтянуть любые изменения параметров, внесённые в библиотечный компонент.

Доступ к команде Update Values from Library в Variant Manager. Здесь показан доступ из контекстного меню области Parameter при выбранной записи требуемого компонента. Наведите курсор на изображение, чтобы увидеть доступ с панели Properties, когда выбрана запись альтернативной детали.

Найдите компонент в исходной библиотеке через диалог Replace и нажмите OK, чтобы открыть диалог Update Project Variants From Library. Все параметры перечислены слева в диалоге Update Project Variants From Library — при необходимости любой параметр можно снять, чтобы исключить его из процесса обновления. Справа в диалоге можно изменить целевой вариант проекта (Project Variant) (Project Variant To Update). По умолчанию будет выбран вариант, который был активен при запуске команды Update Values from Library. Нажмите OK, чтобы завершить процесс обновления.

Копирование варианта

Вы можете скопировать вариант с помощью команды Make a copy . Щёлкните правой кнопкой мыши в заголовке столбца имени варианта и затем выберите параметр Make a copy . Будет добавлен новый столбец с теми же данными и именем (с добавлением «Copy»). Вы можете использовать параметр Rename, чтобы задать новому столбцу подходящее имя.

Удаление варианта

Чтобы удалить вариант, выберите его заголовок, затем используйте значок . Возможность удалить этот вариант или все варианты также доступна в контекстном меню, как показано ниже. Перед удалением откроется диалог подтверждения.

Работа с группами

Чтобы упростить управление большим количеством вариантов проекта, Variant Manager также позволяет создавать группы компонентов на основе выбранного листа схемы, листов, на которые ссылается выбранный символ листа, или выбранного класса компонентов, с функционально-ориентированным представлением вариаций компонентов. Для каждой группы можно определить один или несколько «options», которые по сути отражают некоторую вариацию одного или нескольких компонентов в группе. Затем на основе этих определённых групп и options можно создавать варианты, с поддержкой построения иерархии вариантов. Когда требуется изменение, редактирование значения внутри option группы мгновенно отражается во всех вариантах, использующих этот option группы.

Рабочий процесс работы с группами следующий:

1. Переключитесь на вкладку Groups с помощью элемента управления в верхней части Variant Manager.

2. В раскрывающемся меню кнопки Add Group выберите документ схемы, символ листа или класс компонентов, для которых нужно создать группу.

   
   Добавьте группу, чтобы упростить дальнейшее управление вариантами на основе этой группы.

3. Новая группа будет отображаться в левой панели Variant Manager, а компоненты выбранной группы — справа.

   По умолчанию новой группе будет присвоено имя выбранного листа схемы, символа листа или класса компонентов. При необходимости переименуйте группу с помощью кнопки Rename в нижней части области списка групп.

   Используйте кнопку Add Option, чтобы добавить option для текущей выбранной группы. В области сетки появится дополнительный столбец option с заголовком по умолчанию. Все ячейки нового столбца будут пустыми; пустая ячейка означает, что компонент установлен (Fitted) и не изменён относительно базового проекта.

   
   Добавьте option для выбранной группы, как показано на изображении. Наведите курсор на изображение, чтобы увидеть столбец option по умолчанию.

4. Задайте осмысленное имя для вновь созданного option, изменив имя по умолчанию. Щёлкните заголовок столбца option, чтобы выбрать его, затем нажмите кнопку Rename в нижней части области сетки или щёлкните правой кнопкой по заголовку и выберите Rename, чтобы открыть диалог ввода нового имени.

   
   Задайте осмысленное имя для option.

5. Используя ячейки компонентов в столбце требуемого option, настройте вариации компонентов. Процесс такой же, как при определении вариаций компонентов для варианта.

   
   Настройте вариации компонентов для выбранного option.

   Не рекомендуется вручную изменять параметры компонентов. Кроме того, настоятельно рекомендуется использовать альтернативные компоненты. Чтобы использовать альтернативные посадочные места, при работе с группами используйте отдельный компонент.
   Содержимое ячеек options групп вариантов можно копировать, вставлять или вырезать с помощью соответствующих команд контекстного меню (правый клик) или с помощью соответствующих сочетаний клавиш (Ctrl+C, Ctrl+V, Ctrl+X соответственно).

6. Добавляйте дополнительные options для выбранной группы, щёлкнув правой кнопкой мыши в области сетки и выбрав Add Option. Настройте новый option по необходимости.

   
   Добавляйте и настраивайте дополнительные options по мере необходимости.

7. На вкладке Variants в Variant Manager компоненты, для которых была создана группа, будут показаны под соответствующей записью в области сетки. Используя раскрывающийся список ячейки записи группы, выберите option, созданный для этой группы на вкладке Groups. Будут применены вариации, настроенные для компонентов в этой группе.

   
   Добавьте option для выбранной группы, как показано на изображении. Наведите курсор на изображение, чтобы увидеть столбец option по умолчанию.

Копирование option группы

Чтобы скопировать option группы вариантов, на вкладке Groups щёлкните правой кнопкой мыши по заголовку столбца <New Option>, затем выберите Make a copy. Будет добавлен новый столбец с теми же данными и именем (с добавлением «Copy»). Вы можете использовать параметр Rename, чтобы задать новому столбцу подходящее имя.

Примечания

• При настройке вариантов параметры сохраняются в файле проекта. Это включает состояние Not Fitted, локальные вариации параметров для компонента Fitted и значения параметров Alternate Parts. Alternate Parts хранятся в файле <ProjectName>.PrjPcbVariants.
• Столбцы вариантов можно закреплять, чтобы они отображались первыми — слева от незакреплённых столбцов. Чтобы закрепить столбец варианта, наведите курсор на его заголовок и нажмите .
• Дважды щёлкните по компоненту или щёлкните правой кнопкой мыши и выберите параметр Cross Probe, чтобы перейти к этому компоненту на схеме.
• Используйте команду Select All в контекстном меню области сетки на вкладке Variants или в области Parameter , чтобы быстро выделить всё содержимое сетки.
• Используйте команду Invert Selection в контекстном меню области сетки на вкладке Variants или в области Parameter , чтобы быстро выделить невыделенные и снять выделение с выделенных записей.
• Нажмите кнопку View Report в нижнем левом углу Variant Manager, чтобы сформировать подробный отчёт по вариантам в формате HTML с помощью открывшегося диалога Variants Report.
• Щелкните правой кнопкой мыши в области таблицы на вкладке Variants или в области Parameter  и используйте следующие команды контекстного меню для формирования файлов отчетов:
  • Report – нажмите, чтобы открыть диалог Report Preview для создания распечатки таблицы.
  • Save All – нажмите, чтобы открыть диалог сохранения списка всех компонентов / всех параметров для выбранного компонента в текстовый файл с табуляцией (*.txt).
  • Save Selected – нажмите, чтобы открыть диалог сохранения списка выбранных компонентов / выбранных параметров в виде текстового файла с табуляцией (*.txt).
• При изменении схемы в верхней части Variant Manager отображается соответствующее уведомление. Нажмите элемент управления Refresh рядом с уведомлением, чтобы обновить данные в Variant Manager.
• Параметр Delete, доступный при щелчке правой кнопкой мыши по ячейке, можно использовать для удаления варианта, группы или опции.