You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

168 lines
5.7 KiB

  1. KiCad installation
  2. ==================
  3. The parts of KiCad
  4. ------------------
  5. KiCad consists of 3 components:
  6. kicad - KiCad programs and core files.
  7. kicad-doc - Documentation and interactive help (optional package).
  8. kicad-library - KiCad schematic, pcb & 3D-model libraries (optional package).
  9. This repository contains the source code for the main KiCad programs. The documentation
  10. and library sources are available at https://gitlab.com/kicad
  11. Installation from binary packages
  12. ---------------------------------
  13. Compiled KiCad binaries exist for Windows (7, 8.1, 10), Mac OS (10.12+) and several
  14. Linux distributions (Fedora, Debian, Ubuntu, Arch). These are available from the
  15. main KiCad website: https://kicad-pcb.org/download/
  16. Data files (schematic, boards, libraries) are compatible with all platforms.
  17. Installation from binary packages for Windows
  18. ---------------------------------------------
  19. KiCad can be installed anywhere on the system as long as the user has write privileges.
  20. Pre-made installers are available on the KiCad website: https://kicad-pcb.org/download/windows/
  21. Installation from binary packages for Linux
  22. -------------------------------------------
  23. KiCad comes packaged on many Linux platforms including Debian, Fedora, Ubuntu and Arch,
  24. and is available in their respective package repositories. More information can be found on
  25. the platform's page at https://kicad-pcb.org/download/
  26. Linux install tree
  27. -------------------------------------
  28. The default locations KiCad uses to install its components on Linux are:
  29. ${prefix}/bin - Binaries (executable files).
  30. ${prefix}/lib/kicad - Shared libraries
  31. ${prefix}/share/doc/kicad/ - Various documentation.
  32. ${prefix}/share/doc/kicad/help - Interactive help.
  33. ${prefix}/share/kicad/demos - Sample schematics and printed boards.
  34. ${prefix}/share/kicad/template - Template projects and sheets.
  35. ${prefix}/share/kicad/library - Symbol libraries.
  36. ${prefix}/share/kicad/modules - Module libraries for printed boards.
  37. ${prefix}/share/kicad/modules/packages3d - 3D component models (.wrl and .step format).
  38. KiCad searches for the libraries, templates, 3D models, etc. bin/../share.
  39. Warning:
  40. Do not change the KiCad tree, or the location of binary files. Otherwise
  41. KiCad may not be able to find some or all of its required files.
  42. Mac OS X KiCad tree
  43. -------------------
  44. System wide files
  45. /Library/Application Support/kicad/demos
  46. /Library/Application Support/kicad/internat
  47. /Library/Application Support/kicad/library
  48. /Library/Application Support/kicad/modules
  49. /Library/Application Support/kicad/modules/packages3d
  50. User files can be the same as the system wide files but only inside the users home directory.
  51. $HOME/Library/Application Support/kicad
  52. Warning:
  53. These paths are hardcoded into KiCad, if you put them somewhere else KiCad will not find
  54. them when a new project is created.
  55. Installation from source code
  56. -----------------------------
  57. Currently the only supported compilers are GCC on linux and windows and clang on OS X.
  58. Some dependencies must be satisfied for the correct installation of KiCad:
  59. wxWidgets >= 3.0.0 http://www.wxwidgets.org/
  60. CMake >= 3.0.2 http://www.cmake.org/
  61. Boost C++ Libraries: >= 1.59 http://www.boost.org/
  62. OpenGL >= 2.1
  63. Linux: Mesa 3D Graphics Library http://www.mesa3d.org/
  64. Windows: built-in
  65. Zlib Compression Library http://www.zlib.net/
  66. cairo >= 1.12 http://cairographics.org/
  67. GLEW http://glew.sourceforge.net/
  68. libcurl http://curl.haxx.se/
  69. OpenMP (optional) http://openmp.org/
  70. GLM >= 9.5.4 http://glm.g-truc.net/
  71. pkg-config http://pkgconfig.freedesktop.org/
  72. Doxygen (optional) http://www.doxygen.nl
  73. python >= 2.6 (optional) http://python.org/
  74. wxPython (optional) http://www.wxpython.org/
  75. SWIG >= 3.0 (optional) http://swig.org/
  76. libngspice (optional) http://ngspice.sourceforge.net/
  77. One of:
  78. OCE >= 0.16 (optional) https://github.com/tpaviot/oce
  79. OCC >= 6.8.0 (optiona) https://www.opencascade.com/content/latest-release
  80. Complete documentation for building from source can be found in the developer
  81. documentation located in Documentation/development/compiling.md
  82. Important parameters to cmake
  83. -----------------------------
  84. See Documentation/development/compiling.md for a list of all CMake options
  85. available when compiling KiCad.
  86. -DCMAKE_BUILD_TYPE=<buildtype>
  87. <buildtype> may current one of "Debug" and "Release".
  88. -DCMAKE_INSTALL_PREFIX=<prefix>
  89. Default to "/usr/local".
  90. -DwxWidgets_ROOT_DIR=<wxInstallDir>
  91. Required for Windows platform.
  92. -DwxWidgets_USE_DEBUG=ON
  93. Can be used only with -DCMAKE_BUILD_TYPE=Debug
  94. -DCMAKE_CXX_FLAGS=<some extra flags>
  95. Extra flags for the c++ compiler for your system required.
  96. -DCMAKE_VERBOSE_MAKEFILE=ON
  97. When more output is wanted use this cmake parameter or call "make VERBOSE=1".
  98. Extra CFLAGS and linker flags
  99. -----------------------------
  100. If you require extra flags for compiler and linker you may give them via
  101. environment variables
  102. "CXXFLAGS" (c++ compiler)
  103. "LDFLAGS" (for linker)
  104. "CFLAGS" (for c-compiler, not needed in kdesvn build)
  105. eg., it may usefull on 64bit systems "-m64" to CXXFLAGS and LDFLAGS.