CvPcb

Глобальная таблица библиотек посадочных мест содержит перечень библиотек, которые доступны всегда, независимо от параметров загруженного в данный момент проекта. Эта таблица хранится в домашнем каталоге пользователя в файле fp-lib-table. Точное расположение данного файла зависит от используемой операционной системы.

Каждый проект может иметь свою собственную таблицу библиотек посадочных мест. Эту таблицу можно редактировать только при загруженном файле списка цепей проекта. Если файл проекта не загружен или отсутствует файл таблицы библиотек посадочных мест в каталоге проекта, то будет создана пустая таблица, которую можно редактировать и потом сохранить вместе с назначенными посадочными местами.

При первом запуске Pcbnew или CvPcb и отсутствии файла общей таблицы библиотек посадочных мест fp-lib-table в домашнем каталоге пользователя, Pcbnew или CvPcb попытается копировать туда таблицу библиотек по умолчанию из системного каталога шаблонов KiCad.

Если стандартная fp-lib-table не найдётся, то будет создана пустая таблица библиотек посадочных мест в домашнем каталоге пользователя. В таком случае, пользователь может самостоятельно скопировать нужный файл fp-lib-table или отредактировать его вручную.

Таблица библиотек посадочных мест включает множество стандартных библиотек, которые устанавливаются вместе с KiCad.

Разумеется, в первую очередь нужно подготовить её (добавить/удалить элементы) и указать библиотеки, которые нужны для всех проектов.

(Загрузка большого количества библиотек может занять некоторое время)

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

Каждому элементу таблицы должно быть присвоено уникальное имя.

Это имя не обязательно должно соответствовать имени файла библиотеки или каталога, в которой она расположена. В уникальном имени нельзя использовать символ двоеточия «:». Для каждой библиотеки нужно указать верный путь и/или имя файла, в зависимости от её типа. Пути могут быть абсолютными, относительными или построенными с применением переменных окружения (об этом будет рассказано далее).

Тип подключаемой библиотеки нужно указать в соответствующей колонке таблицы, для корректного считывания. На данный момент KiCad может считывать библиотеки посадочных мест следующих типов: KiCad legacy (обычный), KiCad Pretty (новый), Eagle и GEDA.

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

Одно из самых мощных свойств таблицы библиотек посадочных мест - это применение переменных окружения. Можно определить путь к своим библиотекам в виде переменной окружения. Переменные окружения указываются в пути библиотеки посадочных мест с применением синтаксиса ${ENV_VAR_NAME}.

По умолчанию при запуске KiCad определяются две переменные окружения:

Вы можете переопределить KISYSMOD самостоятельно, выбрав в меню Настройки → Настройка путей и указав путь к своим собственным библиотекам посадочных мест вместо стандартных библиотек KiCad.

Если загружен файл списка цепей, CvPcb определяет KIPRJMOD на основе пути к этому файлу (путь к проекту).

Pcbnew таким же образом определяет переменные окружения при загрузке файла печатной платы.

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

GitHub - это специальный плагин, который предоставляет интерфейс для получения доступа (только для чтения) к удалённому GitHub репозиторию с посадочными местами в pretty формате и, опционально, предоставляет возможность «Копировать при записи» (COW - Copy On Write) сохраняя посадочные места на компьютере для возможности их дальнейшего редактирования. Следовательно, «Git Hub» плагин используется только для чтения библиотек посадочных мест из удалённых репозиториев https://github.com. Чтобы добавить в таблицу библиотеку использующую GitHub нужно в колонке Путь библиотеки указать правильный URL адресс GitHub репозитория.

Например:

https://github.com/liftoff-sr/pretty_footprints

или

https://github.com/KiCad

Обычно адреса репозиториев GitHub строятся таким образом:

https://github.com/user_name/repo_name

В колонке «Тип плагина» нужно выбрать «GitHub». Чтобы включить опцию «Копировать при записи» (COW), нужно ввести allow_pretty_writing_to_this_dir в колонке «Параметры». Этот параметр служит эквивалентом «Пути библиотеки» для сохранения локальных копий изменённых посадочных мест, загруженных из репозитория GitHub. Сохранённые в этой директории посадочные места будут совмещаться с остальными элементами репозитория GitHub, доступными только для чтения, образуя единственную библиотеку посадочных мест. Если же данная опция отсутствует - все посадочные места из GitHub репозитория будут доступны только для чтения. Но, если эта опция присутствует в свойствах GitHub библиотеки, то все изменённые посадочные места будут сохранятся в локальный *.pretty каталог на компьютере. Заметьте, в удалённой части библиотеки данного типа, расположенной на github.com, невозможно напрямую удалить или изменить ни одно посадочное место. В целом, тип библиотек «GitHub» состоит из двух частей, локальной, доступной как для записи так и для чтения, и удалённой, доступной только для чтения.

Ниже показана таблица библиотек посадочных мест с отсутствующим параметром allow_pretty_writing_to_this_dir:

Ниже показана таблица посадочных мест с заданным параметром «Копировать при записи» (COW). Нужно заметить, что переменная окружения ${HOME} указана лишь для примера. Каталог github.pretty расположен в каталоге ${HOME}/pretty/. При использовании параметра allow_pretty_writing_to_this_dir, нужно заранее вручную создать каталог с суффиксом .pretty в конце.

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

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

Также, не стоит указывать один и тот же *.pretty каталог в параметрах для нескольких GitHub библиотек, в таблице библиотек посадочных мест. Это вскоре приведёт к путанице.

В значении параметра allow_pretty_writing_to_this_dir можно применять переменные окружения, используя обозначение ${}, также как и для «Пути библиотеки».

Какая цель в использовании параметра «Копировать при записи» (COW)? Прежде всего, упростить процесс распространения посадочных мест.

Вы можете помочь в обновлении GitHub репозитория, если время от времени будете отправлять исправленные посадочные места по электронной почте управляющему репозиторием. Просто создайте электронное письмо с отдельным *.kicad_mod-файлом из локального каталога и небольшим комментарием. После того как получите подтверждение об обновлении этого посадочного места в репозитории, можете смело удалять его из локального каталога и использовать исправленную версию прямо из GitHub репозитория. Нужно стараться хранить как можно меньше локальных копий посадочных мест и как можно скорее отправлять исправленные посадочные места в https://github.com.

Библиотеки посадочных мест можно задать глобально (общие таблицы) или для отдельного проекта (таблицы проекта). Глобальные библиотеки посадочных мест из общей таблицы доступны всегда и хранятся в файле fp-lib-table в домашнем каталоге пользователя.

Глобальные библиотеки посадочных мест доступны всегда, даже если не загружен файл списка цепей из текущего проекта.

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

Таблица библиотек посадочных мест проекта хранится в файле fp-lib-table в том же каталоге, что и загруженный файл списка цепей. Управление библиотеками доступно в любой из этих таблиц.

У каждого метода есть свои преимущества и недостатки. Можно определить все свои библиотеки в общей таблице и они будут доступны всегда и везде. Недостатком в данном случае является то, что придётся искать нужное посадочное место среди большого количества доступных посадочных мест. В ином случае, можно определить только необходимые библиотеки в таблице отдельного проекта.

Преимущество этого способа в сокращении количества посадочных мест, что облегчает поиск.

А недостатком является то, что для каждого нового проекта необходимо заново определять нужные библиотеки. Также, можно определять библиотеки одновременно в обоих таблицах, общей и для проекта.

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

Строка состояния расположена в нижней части основного окна CvPcb и предоставляет пользователю полезную информацию. В следующей таблице определено содержимое каждой панели в строке состояния.

Отображается при нажатии правой кнопки мыши: