インストール - KiCADのソースを表示

== 概要 ==

<br><br>

== KiCADのインストール ==
==== パッケージ管理システムからインストール ====
 # RHEL
 sudo dnf install kicad kicad-packages3d kicad-doc
 
 # SUSE
 sudo zypper install kicad kicad-symbols kicad-footprints kicad-packages3D kicad-doc-ja kicad-doc-en kicad-templates
<br>

==== リポジトリを追加してインストール ====
RHELにおいて、KiCadには3つのCoprリポジトリがあり、代替バージョンを提供している。<br>
複数のCoprリポジトリを有効にすることは問題ないが、安定版Coprとテスト版Coprの両方を有効にした場合、これらは効果的に結合される。<br>
通常、これはtesting coprになる。<br>
 # RHEL
 sudo dnf install dnf-plugins-core
 sudo dnf copr enable @kicad/kicad-stable
 sudo dnf install kicad kicad-packages3d kicad-doc
 
 # SUSE
 sudo zypper addrepo 'https://download.opensuse.org/repositories/electronics/$releasever/' Electronics
 sudo zypper refresh
 sudo zypper install kicad
<br>

==== ソースコードからインストール ====
===== Open Cascadeのインストール =====
Open CASCADE Technology (OCCT)は、3次元CAD、CAM、CAE用のオープンソースソフトウェア開発プラットフォームである。<br>
<br>
もし、パッケージ管理システムにあるOpen Cascadeのバージョンが古い場合、ソースコードからインストールする。<br>
まず、[https://github.com/Open-Cascade-SAS/OCCT Open CascadeのGithub]にアクセスして、ソースコードをダウンロードする。<br>
ダウンロードしたファイルを解凍する。<br>
 tar xf OCCT-<バージョン>.tar.gz
 cd OCCT-<バージョン>
<br>
Open Cascadeをビルドおよびインストールする。<br>
 mkdir build && cd build
 
 cmake -DBUILD_LIBRARY_TYPE=Shared \
       -DCMAKE_BUILD_TYPE=Release \
       -DCMAKE_INSTALL_PREFIX=<Open Cascadeのインストールディレクトリ> \
       ..
 make -j $(nproc)
 make install
<br>

===== SWIGのインストール =====
SWIGは、CおよびC++で書かれたプログラムをさまざまな高級プログラミング言語と接続するソフトウェア開発ツールである。<br>
<br>
もし、パッケージ管理システムにあるSWIGのバージョンが古い場合、ソースコードからインストールする。<br>
まず、SWIGのビルドに必要なライブラリをインストールする。<br>
 # SUSE
 sudo zypper install bison pcre2-devel 
<br>
[https://www.swig.org SWIGの公式Webサイト]、または、[https://github.com/swig/swig SWIGのGithub]にアクセスして、ソースコードをダウンロードする。<br>
ダウンロードしたファイルを解凍する。<br>
 tar xf swig-<バージョン>.tar.gz
 cd swig-<バージョン>
<br>
SWIGをビルドおよびインストールする。<br>
 mkdir build && cd build
 
 cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=<SWIGのインストールディレクトリ>
 make -j $(nproc)
 make install
<br>
===== wxWidget =====
wxWidgetsは、1992年にエジンバラ大学のJulian Smartにより開発が始まった。<br>
当初は、UnixとWindows間でポータブルなアプリケーションを作成するためのプロジェクトとして始まったが、現在では、MacOS、GTK+、その他多くのツールキットやプラットフォームをサポートしている。<br>
<br>
wxWidgetsは他のクロスプラットフォームGUIツールキットと比較して、ネイティブプラットフォームのコントロールとユーティリティを利用しながら、<br>
複数のプラットフォーム上でGUIアプリケーションを開発するための単一の使用しやすいAPIを提供している。<br>
<br>
また、wxWidgetsはGUI機能に加えて、ネットワークプログラミング、ストリーム、クリップボード、ドラッグ&ドロップ、マルチスレッド、Webページの表示と印刷等の多くの機能を提供している。<br>
<br>
wxWidgetsはC++で記述されているが、Python、Perl、C#等の様々な言語で使用することができる。<br>
例えば、C++でwxWidgetsを使用する場合、各プラットフォームで異なるバージョンのライブラリにコードをリンクし、ネイティブツールキットと同等のスループットを得ることができる。<br>
<br>
もし、パッケージ管理システムにあるwxWidgetのバージョンが古い場合、ソースコードからインストールする。<br>
まず、wxWidgetのビルドに必要なライブラリをインストールする。<br>
 # SUSE
 sudo zypper install pkg-config make gcc gcc-c++ gtk3-devel libcurl-devel libexpat-devel readline-devel zlib-devel libbz2-devel xz-devel gnome-vfs2-devel \
                     pcre2-devel libsecret-devel libedit-devel SDL2-devel libSDL-devel libnotify-devel libmspack-devel gspell-devel libSM-devel valgrind-devel \
                     libjbig-devel libtiff-devel libXxf86vm-devel libxkbcommon-devel libxkbcommon-x11-devel webkit2gtk4-devel \
                     wayland-devel Mesa-devel Mesa-libGL-devel Mesa-libEGL-devel glu-devel \
                     gstreamer-devel gstreamer-devtools-devel
<br>
[https://wxwidgets.org/downloads/ wxWidgetの公式Webサイト]にアクセスして、ソースコードをダウンロードする。<br>
ダウンロードしたファイルを解凍する。<br>
 tar xf wxWidgets-<バージョン>.tar.bz2
 cd wxWidgets-<バージョン>
<br>
wxWidgetをビルドおよびインストールする。<br>
 mkdir wxbuild && cd wxbuild
 
 ../configure --prefix=<wxWidgetのインストールディレクトリ> --with-gtk 
 make -j $(nproc)
 make install 
<br>

===== Ngspiceのインストール =====
[https://ngspice.sourceforge.io/download.html NGSpiceの公式Webサイト]にアクセスして、ソースコードをダウンロードする。<br>
ダウンロードしたファイルを解凍する。<br>
 tar xf ngspice-<バージョン>.tar.gz
 cd ngspice-<バージョン>
<br>
Ngspiceをビルドおよびインストールする。<br>
 mkdir build && cd build
 
 ../configure --prefix=<Ngspiceのインストールディレクトリ> \
              --with-ngshared \
              --enable-cider  \
              --with-x        \
              --enable-xspice
 
 make -j $(nproc)
 make install
<br>

===== KiCADのインストール =====
KiCADのビルドに必要なライブラリをインストールする。<br>
<br>
<u>KiCAD 8.0の場合、G++ 8以降、Boost 1.71以降、wxGTK 3.2.4以降が必要となることに注意する。</u><br>
 # RHEL
 sudo dnf install make cmake gettext boost-devel gcc-c++ gtk3-devel wxGTK-devel python3-devel python3-wxpython4 \
                  libcurl-devel libgit2-devel libsecret-devel zlib-devel unixODBC-devel \
                  libngspice-devel glew-devel glm-devel opencascade-devel \
                  shared-mime-info desktop-file-utils libappstream-glib swig
 
 # SUSE
 sudo zypper install pkg-config make cmake gcc-c++ gcc11-c++ gcc11-PIE ninja libbz2-devel zlib-devel libzip-devel \
                     python3-devel python3-wxPython python3-pybind11-devel python3-CairoSVG python3-pytest        \
                     wxGTK3-3_2-devel fdupes memory-constraints hicolor-icon-theme gettext update-desktop-files   \
                     cairo-devel libcurl-devel unixODBC-devel libopenssl-devel libgit2-devel libsecret-devel      \
                     nng-devel glu-devel glm-devel glew-devel libGLw-devel libappstream-glib8
 
                     # OpenSSL 1を使用する場合
                     libopenssl-1_1-devel
 
                     # OpenSSL 3を使用する場合
                     libopenssl-3-devel
 
                     # パッケージ管理システムからOCCTをインストールする場合
                     occt-devel
 
                     # パッケージ管理システムからSwigをインストールする場合
                     swig
 
                     # パッケージ管理システムからBoostライブラリをインストールする場合
                     libboost_headers1_75_0-devel libboost_filesystem-devel-impl libboost_system-devel-impl          \
                     libboost_locale1_75_0-devel libboost_test1_75_0-devel libboost_test-devel-impl
 
                     # パッケージ管理システムからNgspiceをインストールする場合
                     libngspice-devel
 
                     # 下記のパッケージは不要の可能性あり
                     ffmpeg-4-libavcodec-devel ffmpeg-4-libavdevice-devel   \
                     ffmpeg-4-libavfilter-devel ffmpeg-4-libavformat-devel  \
                     ffmpeg-4-libavresample-devel ffmpeg-4-libavutil-devel  \
                     ffmpeg-4-libswresample-devel ffmpeg-4-libswscale-devel \
                     ffmpeg-4-libpostproc-devel

<br>
[https://gitlab.com/kicad/code/kicad KiCADのGitLab]にアクセスして、KiCADのソースコードをダウンロードする。<br>
または、<code>git clone</code>コマンドを実行して、ソースコードをダウンロードする。<br>
 git clone https://gitlab.com/kicad/code/kicad.git -b <ブランチ名>
 cd kicad
 
 # 実行例
 git clone https://gitlab.com/kicad/code/kicad.git -b 7.0 KiCAD
<br>
CMakeファイルを、以下に示すように修正する。<br>
 <syntaxhighlight lang="sh">
 sed -i -e '/cmake_minimum_required/ s/3.21/3.16/' CMakeLists.txt
 sed -i -e '/SWIG/ s/4.0/3.0/' CMakeLists.txt
 sed -i -e '/SWIG_OPTS/ { s/ -O/ -py3/ ; s/ -fastdispatch//}' pcbnew/CMakeLists.txt
 </syntaxhighlight>
<br>
KiCADをビルドおよびインストールする。<br>
 mkdir build && cd build
 
 cmake -G Ninja .. \
       -DCMAKE_C_COMPILER=<GCC 8以降のコンパイラのパス>   \
       -DCMAKE_CXX_COMPILER=<G++ 8以降のコンパイラのパス> \
       -DCMAKE_BUILD_TYPE=Release                         \
       -DCMAKE_INSTALL_PREFIX=<KiCADのインストールディレクトリ>            \
       -DKICAD_DOCS=/<KiCADのインストールディレクトリ>/docs/kicad          \
       -DPYTHON_SITE_PACKAGE_PATH=/<KiCADのインストールディレクトリ>/lib64 \
       -DKICAD_INSTALL_DEMOS=ON                                 \
       -DKICAD_SPICE=ON                                         \
       -DKICAD_PCM=ON                                           \
       -DKICAD_BUILD_I18N=ON -DKICAD_I18N_UNIX_STRICT_PATH=ON   \
       -DKICAD_USE_OCC=ON                                       \
       -DKICAD_SCRIPTING_WXPYTHON=ON
 
 ninja -C .
 ninja -C . install
<br>
KiCADのデスクトップエントリファイルを作成する。<br>
 vi ~/.local/share/applications/KiCAD.desktop
<br>
 <syntaxhighlight lang="ini">
 # ~/.local/share/applications/KiCAD.desktopファイル
 
 [Desktop Entry]
 Version=1.0
 Type=Application
 Name=KiCad
 Name[ja]=KiCad
 GenericName=EDA Suite
 GenericName[ja]=EDAスイート
 Comment=Suite of tools for schematic design and circuit board layout
 Comment[ja]=回路図設計と基板レイアウトのためのツール群
 Exec=/<KiCADのインストールディレクトリ>/bin/kicad %f
 Icon=/<KiCADのインストールディレクトリ>/share/icons/hicolor/128x128/apps/kicad.png
 Categories=Science;Electronics;
 MimeType=application/x-kicad-project;
 StartupWMClass=kicad
 Terminal=false
 X-Desktop-File-Install-Version=0.22
 </syntaxhighlight>
<br>
KiCADの実行に必要なライブラリをインストールする。<br>
 # RHEL
 sudo dnf install electronics-menu libgit2 libsecret unixODBC python3-wxpython4 libngspice ngspice-codemodel \
                  fmt potrace libdxflib　polyclipping　shared-mime-info
 
 # SUSE
 sudo zypper install python3-wxPython unixODBC libngspice0 libGLEW2_2 \
                     libopencascade-applicationframework7_7 libopencascade-draw7_7 libopencascade-dataexchange7_7 \
                     libopencascade-foundationclasses7_7 libopencascade-modelingdata7_7 libopencascade-modelingalgorithms7_7 \
                     libopencascade-visualization7_7
<br>
KiCADのフットプリントライブラリをインストールする。<br>
 git clone https://gitlab.com/kicad/libraries/kicad-footprints.git -b <ブランチ名>
 例: git clone https://gitlab.com/kicad/libraries/kicad-footprints.git -b 7.0.10
 
 cd kicad-footprints
 
 mkdir build && cd build
 
 cmake -G Ninja .. \
       -DCMAKE_C_COMPILER=<GCC 8以降のgcc> -DCMAKE_CXX_COMPILER=<G++ 8以降のg++> \
       -DCMAKE_BUILD_TYPE=Release                                              \
       -DCMAKE_INSTALL_PREFIX=<KiCADのインストールディレクトリ>                        \
       -DKICAD_DATA=/<KiCADのインストールディレクトリ>/share/kicad
 
 ninja -C .
 ninja -C . install
<br>
KiCADのシンボルライブラリをインストールする。<br>
 git clone https://gitlab.com/kicad/libraries/kicad-symbols.git -b <ブランチ名>
 例: git clone https://gitlab.com/kicad/libraries/kicad-symbols.git -b 7.0.10
 
 cd kicad-symbols
 
 mkdir build && cd build
 
 cmake -G Ninja .. \
       -DCMAKE_C_COMPILER=<GCC 8以降のgcc> -DCMAKE_CXX_COMPILER=<G++ 8以降のg++> \
       -DCMAKE_BUILD_TYPE=Release                                              \
       -DCMAKE_INSTALL_PREFIX=<KiCADのインストールディレクトリ>                        \
       -DKICAD_DATA=/<KiCADのインストールディレクトリ>/share/kicad
 
 ninja -C .
 ninja -C . install
<br>
KiCADのテンプレート群をインストールする。<br>
 git clone https://gitlab.com/kicad/libraries/kicad-templates.git -b <ブランチ名>
 例: git clone https://gitlab.com/kicad/libraries/kicad-templates.git -b 7.0
 
 cd kicad-templates
 
 mkdir build && cd build
 
 cmake -G Ninja .. \
       -DCMAKE_C_COMPILER=<GCC 8以降のgcc> -DCMAKE_CXX_COMPILER=<G++ 8以降のg++> \
       -DCMAKE_BUILD_TYPE=Release                                              \
       -DCMAKE_INSTALL_PREFIX=<KiCADのインストールディレクトリ>                        \
       -DKICAD_DATA=/<KiCADのインストールディレクトリ>/share/kicad
 
 ninja -C .
 ninja -C . install
<br>
KiCADのPCB向け3Dパッケージ群をインストールする。<br>
 git clone https://gitlab.com/kicad/libraries/kicad-packages3D.git -b <ブランチ名>
 例: git clone https://gitlab.com/kicad/libraries/kicad-packages3D.git -b 7.0.10
 
 cd kicad-packages3D
 
 mkdir build && cd build
 
 cmake -G Ninja .. \
       -DCMAKE_BUILD_TYPE=Release                                              \
       -DCMAKE_INSTALL_PREFIX=<KiCADのインストールディレクトリ>                        \
       -DKICAD_DATA=/<KiCADのインストールディレクトリ>/share/kicad
 
 ninja -C .
 ninja -C . install
<br>
KiCADのビルドの詳細を知りたい場合は、[https://dev-docs.kicad.org/en/build/ KiCADの公式Webサイト]を参照すること。<br>
<br><br>

== LTSpiceとの連携 ==
まず、回路図エディタを起動して、[ファイル]メニューバー - [エクスポート] - [ネットリスト...]を選択する。<br>
[ネットリストをエクスポート]画面にある[Spice]タブ - [外部シミュレータのコマンド:]項目にLTSpiceの実行ファイルのパスを指定する。<br>
 /<LTSpiceの実行ファイルのパス> "%I"
 
 例:
 /home/<ユーザ名>/.cxoffice/LTSpice_XVII/desktopdata/cxmenu/StartMenu.C^5E3A_users_crossover_AppData_Roaming_Microsoft_Windows_Start^2BMenu/LTspice+XVII.lnk "%I"
<br>
次に、[ネットリストをエクスポート]ボタンを押下する時、回路図からネットリストが生成されて、LTSpiceが実行される。<br>
<br><br>


__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:電子回路]][[カテゴリ:PCB]]