=========================
Premier programme : Blink
=========================

Le programme **Blink** a pour objectif de faire clignoter la LED intégrée à la carte de développement. Cette LED est connectée en interne à la broche 13.

Edition
=======

Le programme **Blink** est disponible dans les exemples du logiciel **Arduino IDE**.

Dans le menu ``Fichier > Exemples > Basics > Blink``.

.. figure:: images/Blink_01_exemples_blink.png
   :width: 780
   :height: 605
   :scale: 50 %
   :alt: Ouvrir Blink
   :align: center
   
   Ouvrir le code source du programme Blink

.. figure:: images/Blink_02_edition_blink.png
   :width: 625
   :height: 500
   :scale: 60 %
   :alt: Edition Blink
   :align: center
   
   Édition du code source du programme Blink

.. note::

   * Un programme Arduino écrit en **langage C/C++** est composé **d'une suite d'intructions**.

   * Ces instructions sont exécutées dans **l'ordre des lignes de code**.

   * Les **commentaires** en gris sont délimités par les caractères ``/*`` et ``*/`` sur plusieurs lignes ou commencent pas les caractères ``//`` sur une même ligne.

.. figure:: images/Blink_02_edition_blink_modifie.png
   :width: 557
   :height: 523
   :scale: 70 %
   :alt: Edition Blink
   :align: center
   
   Une version modifiée du code source du programme Blink

.. warning::

   Un programme Arduino respecte toujours une **structure spécifique** composée en trois parties :

      * Les déclarations : **définitions** des constantes et des variables ;
      * La fonction ``setup()`` : **configuration** de la carte (entrées, sorties, port série, ...) ;
      * La fonction ``loop()`` : **instructions du programme exécutées** dans une **boucle infinie** (sans fin).




Compilation
===========

.. warning::

   Avant de lancer la compilation, il est important de **choisir le modèle de carte Arduino utilisé**. Le programme généré est dépendant du type de microcontrôleur présent sur la carte.
   

.. figure:: images/Blink_03_compilation_choix_carte.png
   :width: 815
   :height: 600
   :scale: 50 %
   :alt: Edition Blink
   :align: center
   
   Choix du type de carte

.. figure:: images/Blink_03_compilation_ksnip.png
   :width: 500
   :height: 600
   :scale: 70 %
   :alt: Edition Blink
   :align: center

   Puis la compilation peut s'effectuée !

Téléversement
=============

.. warning::

   Pour téléverser le programme obtenu, il faut **sélectionner le port de communication série** sur lequel est connectée la carte Arduino.
   
.. figure:: images/Blink_04_televersement_choix_port.png
   :width: 855
   :height: 340
   :scale: 50 %
   :alt: Edition Blink
   :align: center
   
   Choix du port de communication

.. figure:: images/Blink_04_televersement_ksnip.png
   :width: 500
   :height: 600
   :scale: 70 %
   :alt: Edition Blink
   :align: center
   
   Téléversement du programme

Exécution
=========

Le programme s'exécute sur la carte Arduino de façon autonome (sans ordinateur).

.. figure:: images/Blink_05_execution_ksnip.png
   :width: 400
   :height: 283
   :scale: 70 %
   :alt: Edition Blink
   :align: center
   
   Exécution du programme Blink sur la carte Arduino Uno R3