"Hello world!" : Se connecter au réseau LoRaWAN et envoyer son premier message avec Wavebricks
==============================================================================================

À l'issue de ce tutoriel, vous serez capables de:

- vous connecter au  |NETWORK_FULL_NAME| en ABP ou OTAA
- envoyer un message binaire
- récupérer le dernier message envoyer par votre dispositif

Se connecter au réseau
----------------------

La connexion au réseau peut se faire de deux manières : soit ABP soit OTAA.

:samp:`ABP` (*activation by personalization*)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Pour configurer mon dispositif en :samp:`ABP`, je vais dans `l'interface Wavebricks <https://api.wavebricks.com/>`_ et je déclenche l':doc:`enregistrement d'un nouveau dispositif </ref/wavebrick/newdev>`. Je reçois alors trois éléments :

- l'adresse de dispositif (*device address*, qu'on abrège généralement en :samp:`DevAddr`),
- la clef de session de réseau (*network session key*, :samp:`NetSKey`),
- la clef de session d'application (*application session key*, :samp:`AppSKey`).

Dans le code de mon dispositif, j'insère une *activation by personalization* (ABP) qui emploit :samp:`DevAddr`, :samp:`NetSKey` et :samp:`AppSKey` :

.. literalinclude:: hello-world/abp-wb.py
  :language: python
  :lines: 3-7


:samp:`OTAA` (*over the air activation*)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Pour configurer mon dispositif en :samp:`OTAA`, je vais dans `l'interface Wavebricks <https://api.wavebricks.com/>`_ et je déclenche la :doc:`préparation d'une OTAA` </refwavebricks/otaa>`. Je renseigne :

- l'identifiant unique d'application (*application Extended Unique Identifier*, :samp:`AppEUI`),
- la clef d'application de l'appareil (*application key*, :samp:`AppKey`).

Dans le code de mon dispositif, j'insère une *over the air activation* (OTAA) qui emploit :samp:`AppEUI` et :samp:`AppKey` :

.. literalinclude:: hello-world/otaa-wb.py
  :language: python
  :lines: 3-6


Émettre un message binaire
--------------------------

Pour pouvoir émettre, il me suffit de donner le message à envoyer:.

.. literalinclude:: hello-world/otaa-wb.py
  :language: python
  :lines: 7


Consulter le message
--------------------

Une fois le message envoyé, on peut se rendre sur `l'interface Wavebricks <https://api.wavebricks.com/>`_ et, dans la page du dispositif, consulter le contenu du dernier message envoyé est disponible.


Code complet (:samp:`OTAA`)
---------------------------

.. literalinclude:: hello-world/otaa-wb.py
  :language: python
  :caption: :download:`hello-world/otaa-wb.py`


Code complet (:samp:`ABP`)
--------------------------

.. literalinclude:: hello-world/abp-wb.py
  :language: python
  :caption: :download:`hello-world/abp-wb.py`