====== Installation de bCNC ======

===== Prérequis =====

==== Dépendances générales ====

  * **python** : une v2 récente de python devrait fonctionner (2.7.13 sur Debian stretch), la v3 de python n'est pas supportée par bCNC pour l'instant (20170923).
 
  * **tkinter** la boîte à outils graphique pour python.
    * Selon votre système et/ou la version de python tkinter devrait avoir été installé avec python, soit par default soit comme un module.
 
  * le module **pyserial**... pour la communication série.
    * Sur Debian stretch il s'appelle python-serial, sur d'autre systèmes il peut s'appeller python-pyserial.

==== Dépendances optionnelles ====

=== Autolevel color map ===

  * **PIL** (pillow library) est nécessaire pour afficher les différences d'élévation sous forme de carte colorée.
    * pour la plupart des OS Linux, on peut trouver ce paquet sous le nom : **python-imaging-tk** (c'est le cas sous Debian stretch). Pour OpenBSD ce sera graphics/py-Pillow.
  * Et enfin, **python-numpy** (fonction mathématiques sophistiquées pour python).

=== Alignement avec image video ===

//cf: [[https://github.com/vlachoudis/bCNC/wiki/Probe-Camera-Alignment]]//

  * OpenCV, **python-opencv** (sur Debian stretch) est utilisé pour la capture et le streaming d'images video. Pour OpenBSD, ce sera graphics/opencv.

\\
\\

===== Linux =====

==== Téléchargement avec git ====


Pour les moustachu(e)s sous windows et sous linux : //Curieusement c'est la méthode la moins fatiguante//

=== Il vous faut git ===

  * pour linux (debian style ici) :

  moi@mon_pc:~$ sudo apt-get install git

  * et sous les autres plateformes, installez la bonne version depuis cette page : [[https://git-scm.com/downloads]] 

Vous comprendrez plus tard, au moment des mises à jour, pourquoi avec git c'est mieux qu'un simple download de zip.

=== récupérez l'adresse du répertoire git ===

Allez d'abord sur la page bCNC du site GitHub : **[[https://github.com/vlachoudis/bCNC]]**

\\

{{:softs:bcnc:bcnc-install-github.png}}

\\
\\


=== créez un clone dans votre système de fichier ===

  moi@mon_pc:~$ mkdir bcnc  
  moi@mon_pc:~$ cd bcnc 
  moi@mon_pc:~/bcnc$ git clone https://github.com/vlachoudis/bCNC.git
  
    ...ici plein de blabla de git qui clone (sorte de download) bCNC...
  
  moi@mon_pc:~/bcnc$ ls -l
  total 4
  drwxr-xr-x 8 moi moi 4096 sept. 23 16:23 bCNC
  moi@mon_pc:~/bcnc$ cd bCNC
  moi@mon_pc:~/bcnc/bCNC$ ./bCNC

... Et si vous avez tout bien suivi, l'appli se lance !

==== Téléchargement tout classique ====

Si vous avez bien regardé la copie d'écran au dessus, vous aurez remarqué un lien "Download ZIP", go ahead !

===== Windows =====

**PS : nous cherchons des volontaires pour documenter plus en détail pour Windows...**