\documentclass{scrreprt}
%\documentclass[draft]{scrreprt}
\usepackage{fontspec}
\usepackage{xunicode}
\usepackage{polyglossia}
\usepackage{csquotes}
\usepackage{caption}
\usepackage{subcaption}
\usepackage{appendix}
\usepackage{color}
\usepackage{minted}
\usepackage[singletitle=true,citestyle=verbose-trad2,bibstyle=verbose,backend=biber,citepages=omit]{biblatex}
\usepackage[hidelinks]{hyperref}
\usepackage[acronym,toc,xindy]{glossaries}
\usepackage{glossary-list}
\usepackage{glossary-long}

\setmainlanguage{french}

\title{La lumière s'éteint-elle dans le frigo~?}
\subtitle{Étude d'un bus en vue d'acquisition de données}
\author{Nathanaël Restori}
\date{\today}

\bibliography{bibliographie.bib}

\renewcommand*{\glstextformat}{\textbf}
\newglossary[slg]{symbolslist}{syi}{syg}{Symboles}
\makeglossaries
\input{glossaire.tex}

\renewcommand{\appendixname}{Annexes}
\renewcommand{\appendixtocname}{Annexes}
\renewcommand{\appendixpagename}{Annexes}

\begin{document}

\input{couverture.tex}

\chapter*{Remerciements}
\thispagestyle{empty}
Je tient à remercier M.~Salanon pour ses conseils, son aide et pour m'avoir suivi tout au long de ce TM et M.~Gelsomino pour m'avoir permis de le réaliser.

Je remercie aussi mes parents et ma sœur pour leur aide et leur relecture.

\vfill
Image de couverture par \enquote{oomlout}, sous licence \emph{Creative Commons Attribution-Share Alike 2.0 Generic (CC BY-SA 2.0)}.

\tableofcontents

\chapter{Introduction}
\section{Motivations}
J'ai décidé de faire mon travaille de maturité sur ce sujet car je suis passionné de robotique depuis tout petit. J'ai commencé en participant à un atelier de soudures à la Maison Picson\footnote{Établissement servant de cantine proposant aussi des activités à Blonay}. Je suis aussi allé à la première édition du Festival de Robotique à l'EPFL en 2008 et ai participé à deux ateliers (introduction à la programmation de microcontrôleur et soudure d'un robot DIDEL).

Je suis aussi passionné par l'informatique en général (autant au niveau matériel que logiciel), la programmation ainsi que les logiciels libres.

\section{Présentation du travail}
Pour mon travail, j'ai choisi de travailler avec de la robotique car ce sujet m'intéressait.

J'ai d'abord dû trouver un sujet plus précis. Suite à une discussion avec M.~Salanon, je me suis tourné vers l'étude d'un bus de données (l'I²C) et la programmation d'une sorte de station météo.

J'ai d'abord dû choisir le matériel puis le commander depuis les États-Unis (le choix de matériel disponible en Suisse étant plus limité et pas forcément moins cher).
J'ai ensuite étudié le fonctionnement du bus en théorie, puis \enquote{assemblé} et programmé la station et aussi réalisé un programme pour tester le fonctionnement de l'I²C à l'aide d'un oscilloscope.

J'ai fini par réaliser des mesures à l'aide de la station météo dans mon frigo et vérifier le fonctionnement du bus en pratique.

\section{Les principes du logiciel libre}
Un logiciel libre est un logiciel qui respecte quatre libertés essentielles\footcite{free-sw}~:
\begin{enumerate}
    \item la liberté d'exécuter le programme, pour tous les usages (liberté 0) ;
    \item la liberté d'étudier le fonctionnement du programme, et de le modifier pour qu'il effectue vos tâches informatiques comme vous le souhaitez (liberté 1) ; l'accès au code source est une condition nécessaire ;
    \item la liberté de redistribuer des copies, donc d'aider votre voisin (liberté 2) ;
    \item la liberté de distribuer aux autres des copies de vos versions modifiées (liberté 3) ; en faisant cela, vous donnez à toute la communauté une possibilité de profiter de vos changements ; l'accès au code source est une condition nécessaire.
\end{enumerate}

On retrouve aussi le terme \enquote{\emph{open source}}. Le terme logiciel libre est définit par la \gls{FSF} tandis que le terme open source est définit par l'\gls{OSI}. En pratique, ces deux termes désignent la même chose.

Les sources du logiciels sont soumis à des licences spécifiques garantissant ces libertés. Les plus connues sont la \gls{GPL}, la \gls{BSD} ou la MIT (une copie de cette dernière est disponible à l'annexe \ref{app:mit}).

Quelques logiciels libres connus sont Firefox, LibreOffice/OpenOffice.org, Linux, Thunderbird et VLC.

Ce \gls{TM} est donc entièrement articulé autour de logiciels et matériels libres~: \LaTeX{} et vim pour l'écriture de ce rapport, Arduino comme plate-forme, CMake et gcc pour la \gls{compilation}, gnuplot pour les graphiques. Tout le code produit est donc placé sous licence MIT.

\section{Conventions d'écriture}
Les mots en \textbf{gras} sont des mots expliqués dans le glossaire ou des acronymes.

Les textes écrits avec \verb|cette police d'écriture| sont des extraits de code.

\chapter{L'I²C}
Ce chapitre est basé sur un article de Wikipédia\footcite{i2c-wikipedia} ainsi qu'un autre article\footcite{i2c-aurel32}. Toutes les images ont été faites par \enquote{Emiaille} et sont sous licence \emph{Creative Commons paternité – partage à l’identique 3.0 (non transposée)}.

\section{Le bus I²C}
Le bus I²C a été développé par Philips en 1982. La première norme (notée 1.0) a été publiée en 1992 et la dernière (noté 4.0) en 2012.

Quelques exemples d'utilisations courantes utilisations\footcite{i2c-wikipedia-en}~:
\begin{itemize}
    \item lire des données dans de la mémoire \gls{RAM}
    \item contrôler des convertisseurs de courant direct à continu et vice-versa
    \item changer le contraste, la teinte ou la balance des couleurs d'un écran
    \item changer le volume d'haut-parleurs intelligents
    \item contrôler des écran \gls{OLED} ou \gls{LCD}
    \item lire des capteurs
    \item lire une \gls{horloge temps reel}
    \item allumer ou éteindre une alimentation
\end{itemize}

\section{Les caractéristiques}
L'I²C a plusieurs caractéristiques intéressantes~:
\begin{itemize}
    \item il n'utilise que deux lignes (en réalité trois, la masse devant être commune à tous les maîtres et les esclaves)
    \item il est multi-maîtres~: plusieurs objets peuvent contrôler le bus
    \item il est multi-esclaves~: plusieurs objets peuvent répondre à un maître
    \item c'est un bus série~: chaque information est découpée en plusieurs morceaux de taille fixe
    \item c'est un bus synchrone~: possède une horloge propre (imposée par le maître qui veux parler)
    \item c'est un bus bidirectionnel half-duplex~: les informations peuvent circuler dans les deux sens mais dans un seul sens à la fois
    \item il peux communiquer à des vitesses allant de 100 kbit/s à 5 Mbit/s
\end{itemize}

\section{Topologie}
Tout d'abord, plusieurs équipements peuvent être connectés au bus en même temps (qu'ils soient maîtres ou esclaves).

Les équipement sont connectés entre eux à l'aide de deux lignes~:
\begin{itemize}
    \item SDA (Serial Data Line)~: ligne de données bidirectionnelle,
    \item SCL (Serial Clock Line)~: ligne d'horloge de synchronisation bidirectionnelle
\end{itemize}
Il faut toute fois une troisième ligne pour avoir une masse commune à tous les équipements.
Tous les équipements doivent être alimentés avec le même potentiel (pour avoir la même référence comme niveau haut) mais peuvent être alimentés par différentes sources.

Les échanges ont toujours lieu entre un maître et un esclave et sont toujours débutés par le maître. Toute fois, rien n'empêche à un équipement de passer du status de maître au status d'esclave et vice-versa.

Pour permettre à plusieurs maîtres de pouvoir imposer un niveau haut ou un niveau bas sur les lignes en même temps, des sorties à collecteur ouvert (ou à drain ouvert pour des circuits CMOS) sont utilisées. Deux résistances \enquote{pull-up} tirent les lignes au niveau haut.

L'état logique \enquote{0} ou \enquote{LOW} est l'état \enquote{dominant} tandis que l'état logique \enquote{1} ou \enquote{HIGH} est l'état \enquote{récessif}. Cela veux dire que si un équipement impose l'état \enquote{LOW} et qu'un autre impose l'état \enquote{HIGH} la ligne sera à l'état \enquote{LOW}.

\begin{figure}[H]
    \centering
    \includegraphics[width=1\textwidth]{figures/I2C/I2C_Architecture.eps}
    \caption{Architecture I²C avec plusieurs maîtres et plusieurs esclaves}
    \label{fig:I2C_Architecture}
\end{figure}

\section{Le protocole I²C}
\subsection{L'encodage}
Tout d'abord, en informatique, les informations sont envoyée sous forme de \enquote{0} et de \enquote{1}. Un \enquote{0} ou un \enquote{1} s'appelle un bit. Souvent, les informations sont envoyées sous forme de paquets de huit bits. On appelle ces huit bits un octet (ou \emph{byte} en anglais).

Pour transmettre un bit, le maître doit d'abord placer la ligne SCL au niveau \enquote{LOW} puis placer la ligne SDA au niveau voulu (\enquote{LOW} pour transmettre un \enquote{0} ou \enquote{HIGH} pour transmettre un \enquote{1}). Ensuite, il place la ligne SCL au niveau \enquote{HIGH} attend un temps défini par la vitesse et la norme utilisée puis replace la ligne SCL au niveau \enquote{LOW}. Un bit vient d'être transmis. Il recommence pour transmettre le bit suivant. Tant que la ligne SCL est au niveau \enquote{HIGH}, la ligne SDA ne doit pas changer d'état.
\begin{figure}[H]
    \centering
    \includegraphics{figures/I2C/I2C_Encodage.eps}
    \caption{Encodage d'un bit I²C}
    \label{fig:I2C_Encodage}
\end{figure}

\subsection{La commande START}
La commande START est un transgression à la règle d'encodage. Elle est utilisé pour signaler le début d'une trame.
Pour envoyer un START, la ligne SDA doit passer de l'état \enquote{HIGH} à \enquote{LOW} pendant que la ligne SCL est à l'état \enquote{HIGH}.
\begin{figure}[H]
    \centering
    \includegraphics{figures/I2C/I2C_START.eps}
    \caption{Condition de START I²C}
    \label{fig:I2C_START}
\end{figure}

\subsection{La commande STOP}
La commande STOP est un transgression à la règle d'encodage. Elle est utilisé pour signaler la fin d'une trame.
Pour envoyer un STOP, la ligne SDA doit passer de l'état \enquote{LOW} à \enquote{HIGH} pendant que la ligne SCL est à l'état \enquote{HIGH}.
\begin{figure}[H]
    \centering
    \includegraphics{figures/I2C/I2C_STOP.eps}
    \caption{Condition de STOP I²C}
    \label{fig:I2C_STOP}
\end{figure}

\subsection{La commande RESTART}
La commande RESTART est un transgression à la règle d'encodage. Elle est utilisé pour signaler le début d'une nouvelle trame sans passer par une condition STOP.
Pour envoyer un RESTART, la ligne SDA doit passer de l'état \enquote{HIGH} à \enquote{LOW} pendant que la ligne SCL est à l'état \enquote{HIGH}. En fait, il s'agit que la commande START qui est envoyée entre un START en un STOP.
\begin{figure}[H]
    \centering
    \includegraphics{figures/I2C/I2C_RESTART.eps}
    \caption{Condition de RESTART I²C}
    \label{fig:I2C_RESTART}
\end{figure}

\subsection{L'acquittement}
Quand le récepteur à reçu un octet, il envoie la commande ACK pour signaler qu'il l'a bien reçu ou la commande NACK pour signaler un problème lors de la réception.
Quand le récepteur est un maître, il peux envoyer un NACK pour demander l'arrêt de la lecture avant d'envoyer un STOP.
Pour envoyer un ACK, le récepteur envoie simplement un bit \enquote{0}. Pour envoyer un NACK, le récepteur envoie simplement un bit \enquote{1}.
\begin{figure}[H]
    \centering
    \includegraphics{figures/I2C/I2C_ACK.eps}
    \caption{Acquittement I²C}
    \label{fig:I2C_ACK}
\end{figure}

\subsection{La pause}
A tout moment, l'esclave peux bloquer la ligne SCL à \enquote{LOW} pour signaler qu'il est occupé.
Pour faire un pause, l'esclave maintient la ligne SCL au niveau \enquote{LOW} tandis que le maître maintient la ligne au niveau \enquote{HIGH}. Le maître va détecter l'écrasement et maintenir la ligne au niveau \enquote{HIGH} jusqu'à ce que l'esclave est libéré la ligne.
\begin{figure}[H]
    \centering
    \includegraphics{figures/I2C/I2C_Pause.eps}
    \caption{Pause I²C}
    \label{fig:I2C_Pause}
\end{figure}

\subsection{L'addresse}
Pour savoir à qui un maître veux parler, chaque esclave possède une adresse unique. Celle-ci peut être encodée sur 7 ou 10 bits.

\subsubsection{L'adressage sur 7 bits}
L'octet est composé de deux parties~:
\begin{enumerate}
    \item les sept premiers bits correspondent à l'adresse
    \item le dernier bit est appelé bit R/W (Read/Write)~:
    \begin{itemize}
        \item si le maître envoie un \enquote{1}, il demande une lecture et l'esclave lui envoie des données.
        \item si le maître envoie un \enquote{0}, il demande une écriture et il envoie des données à l'esclave.
    \end{itemize}
\end{enumerate}

Il y a quelques adresses \enquote{spéciales}\footnote{Les X tout à gauche correspondent au bit R/W. Les autres X, l'y et le z peuvent être soit un \enquote{1}, soit un \enquote{0}}~:
\begin{itemize}
    \item 00000000~: utilisée pour parler à tous les esclaves (appelé \emph{broadcast} en anglais)
    \item 0000001X~: utilisée pour accéder aux composants CBUS (ancêtre de l’I²C)
    \item 0000010X~: réservée pour d’autres systèmes de bus
    \item 0000011X~: réservée pour des utilisations futures
    \item 00001XXX~: utilisée pour les composants haute-vitesse
    \item 11111XXX~: réservée pour des utilisations futures
    \item 11110yzX~: utilisée pour l'adressage sur 10 bits
\end{itemize}

\subsubsection{L'adressage sur 10 bits}
Cette fois ci, deux octets sont nécessaires~:
\begin{itemize}
    \item Le premier est l'octet \enquote{11110yz0}. Les bits y et z sont les bits de poids fort de l'adresse (autrement dit, ceux le plus à gauche). Le bit R/W est toujours à \enquote{0}.
    \item Le deuxième octet contient la suite de l'adresse sur huit bits. Il n'y a donc pas de bit R/W.
\end{itemize}

\begin{figure}[H]
    \centering
    \includegraphics{figures/I2C/I2C_Adresse10bitsEcriture.eps}
    \caption{Adressage d'un esclave I²C sur 10 bits en écriture}
    \label{fig:I2C_Adresse10bitsEcriture}
\end{figure}

Plusieurs esclaves peuvent avoir une adresse qui commence par yz. Si c'est le cas, ils répondent tous par un ACK en même temps. Une fois la suite de l'adresse envoyée, un seul esclave répondra par un ACK, l'adresse étant unique.
Si le maître veux demander un lecture, il doit envoyer un RESTART à la fin du deuxième octet de l'adresse puis envoyer l'octet \enquote{11110yz1}. Cette fois ci, le bit R/W est à \enquote{1} et l'esclave saura que le maître demande une lecture.

\begin{figure}[H]
    \centering
    \includegraphics[width=1\textwidth]{figures/I2C/I2C_Adresse10bitsLecture.eps}
    \caption{Adressage d'un esclave I²C sur 10 bits en lecture}
    \label{fig:I2C_Adresse10bitsLecture}
\end{figure}

\subsection{Un échange complet}
Tout d'abord, tous les maîtres écoutent en permanence les deux lignes. S'ils détectent un START, ils savent qu'ils doivent attendre un STOP avant de tenter de parler à un esclave. Cette écoute permanente permet aussi de détecter les pauses et les conflits (plusieurs maîtres qui tentent de parler en même temps).

Voici un exemple d'échange complet~:
\begin{enumerate}
    \item le maître qui veux parler attend que le bus soit libre s'il est occupé
    \item le maître envoie la commande START
    \item le maître envoie un octet~: le sept premiers bits correspondent à l'adresse et le huitième permet de savoir si le maître demande une lecture ou une écriture (ici, une écriture)
    \item l'esclave envoie un bit d'acquittement (ici, un ACK)
    \item l'esclave peux demander une pause
    \item le maître envoie un octet qui contient une commande
    \item l'esclave envoie un bit d'acquittement (ici, un ACK)
    \item l'esclave peux demander une pause
    \item le maître envoie la commande RESTART
    \item le maître envoie un octet~: le sept premiers bits correspondent à l'adresse et le huitième permet de savoir si le maître demande une lecture ou une écriture (ici, une lecture)
    \item l'esclave envoie un premier octet qui contient le début des données
    \item le maître envoie un bit d'acquittement (ici, un ACK)
    \item l'esclave peux demander une pause
    \item l'esclave envoie un deuxième octet qui contient la suite des données
    \item le maître envoie un bit d'acquittement (ici, un NACK)
    \item l'esclave peux demander une pause
    \item le maître envoie la commande STOP pour libérer le bus
\end{enumerate}
\begin{figure}[H]
    \centering
    \includegraphics[width=1\textwidth]{figures/I2C/I2C_EchangeMaitreEsclave.eps}
    \caption{Exemple d'échange I²C entre un maître et un esclave}
    \label{fig:I2C_EchangeMaitreEsclave}
\end{figure}

\subsection{Le cas de conflit}
Si deux maîtres (ou plus) prennent le contrôle du bus en même temps ou presque, les deux START et les lignes SCL vont se superposer et aucun des deux maîtres ne va se rendre compte qu'un autre est en train de parler en même temps. Toute fois, ils écoutent tous les deux en même temps qu'ils écrivent. Tant qu'ils envoient tous les deux un bit \enquote{1} ou \enquote{0} en même temps, il n'y aura pas de conflit entre les deux. Par contre, si l'un envoie un \enquote{1} et l'autre un \enquote{0}, le \enquote{0} va écraser le \enquote{1} et le maître envoyant le \enquote{1} va détecter le conflit. Il va donc arrêter de parler et laisser l'autre continuer. Le conflit peux être détecter lors de l'écriture de l'adresse, du bit R/W ou lors de l'envoi d'un commande.
Si les deux maîtres ont envoyé exactement la même chose, il n'y aura pas de conflit et ils liront ou écriront la même chose.

\chapter{Le matériel}
\section{Le choix de la plate-forme}
Il existe de nombreuse \gls{plate-forme} en robotique~: par exemple, le Boe-Bot de Parallax, utilisé dans les cours facultatifs de robotique de M.~Gardon. J'ai fait le choix d'un Arduino car cette un plate-forme de plus en plus répandue, peu chère (20 € pour une carte programmable) et puissante. On trouve de nombreux exemples de \gls{DIY}\glsadd{DIYg}, elle est programmable en \gls{C++} (donc il est possible d'utiliser des \glspl{bibliotheque}) et c'est du \gls{materiel libre}.

\section{Les capteurs}
J'ai été décidé de faire une station météo. Nous avons donc besoin d'un thermomètre (figure \ref{fig:BMP085}), d'un hygromètre (figure \ref{fig:BMP085} aussi), d'un baromètre (figure \ref{fig:TSL2561}) et d'un capteur de luminosité (figure \ref{fig:DHT22}). J'ai ajouté une horloge (figure \ref{fig:ChronoDot}) qui nous permettra d'avoir l'heure à laquelle les mesures ont été prises. Tous les capteurs ont été commandés sur le site d'Adafruit. L'hygromètre ne se connecte malheureusement pas en I²C, aucun capteur de ce type n'étant disponible.

\begin{figure}[h]
    \centering
    \begin{subfigure}[b]{0.23\textwidth}
        \centering
        \includegraphics[width=1\textwidth]{figures/perso/BMP085.JPG}
        \caption{BMP085}
        \label{fig:BMP085}
    \end{subfigure}
    ~
    \begin{subfigure}[b]{0.23\textwidth}
        \centering
        \includegraphics[width=1\textwidth]{figures/perso/ChronoDot.JPG}
        \caption{ChronoDot}
        \label{fig:ChronoDot}
    \end{subfigure}
    ~
    \begin{subfigure}[b]{0.23\textwidth}
        \centering
        \includegraphics[width=1\textwidth]{figures/perso/DHT22.JPG}
        \caption{DHT22}
        \label{fig:DHT22}
    \end{subfigure}
    ~
    \begin{subfigure}[b]{0.23\textwidth}
        \centering
        \includegraphics[width=1\textwidth]{figures/perso/TSL2561.JPG}
        \caption{TSL2561}
        \label{fig:TSL2561}
    \end{subfigure}
    \caption{Les capteurs}
    \caption*{Photos personnelles}
\end{figure}

\section{Les limitations}
J'ai vite été confronté a quelques limitations~: la mémoire de l'Arduino ne peux contenir seulement 32256 octets de code compilé. Il ne peux donc pas contenir en même temps les \glspl{bibliotheque} pour utiliser les capteurs en I²C, utiliser le port RJ45 et utiliser la carte SD. La solution a été de couper le programme en deux~: il y a donc un code pour afficher les mesures en direct à travers un navigateur web et un code pour prendre des mesures de manière régulière et les enregistrer.

\begin{figure}[h]
    \centering
    \includegraphics[width=1\textwidth]{figures/perso/montage.JPG}
    \caption{Montage complet}
    \caption*{Photo personnelle}
    \label{fig:montage}
\end{figure}

\chapter{Le logiciel}
\section{En général}
Les deux programmes sont composés de deux fonctions principales. La fonction \verb|setup()| qui s'exécute une fois au démarrage du programme et la fonction \verb|loop()| qui est exécutée en boucle. La première sert donc à initialiser et configurer les capteurs et les puces. La deuxième sert à traiter les informations.

Plusieurs \glspl{bibliotheque} sont utilisées. Comme bibliothèques tierces, sont utilisés~: \verb|BMP085| pour le capteur de température et de pression, \verb|Chronodot| pour l'horloge, \verb|DHT| pour le capteur d'humidité, \verb|TSL2561| pour le capteur de luminosité et, pour finir, \verb|WebServer| pour servir les pages web. Comme bibliothèques internes (fournie avec l'Arduino), sont utilisés~: \verb|Ethernet| pour la puce de contrôle du port RJ45, \verb|SD| ainsi que \verb|SPI| pour la carte SD et \verb|Wire| pour l'I²C.

La partie logicielle est coupée en deux programmes~: un enregistreur et un serveur web. Les sources sont disponibles respectivement à l'annexe \ref{app:logger} et à l'annexe \ref{app:web}.

Un troisième programme sera utilisé pour tester en pratique le protocole I²C à l'aide d'un oscilloscope et vérifier si la théorie correspond à la pratique. Le code source est disponible à l'annexe \ref{app:i2cpractise}.

\section{L'enregistreur}
La fonction \verb|setup()| commence par initialiser la carte SD puis initialise les différents capteurs. Il configure ensuite le capteur de luminosité et finit par vérifier si le fichier \enquote{DATA.TSV} existe, le crée si il n'existe pas et y enregistre les en-tête (un exemple de se fichier est disponible à l'annexe \ref{app:data}).

La fonction \verb|loop()| récupère les différentes données des capteurs puis les enregistre. Elle finit en faisant une pause d'un temps définit.

\section{Le serveur web}
La fonction \verb|setup()| commence par initialiser la puce de contrôle du port RJ45 et le serveur web et configure ce dernier, puis initialise les différents capteurs. Il configure ensuite le capteur de luminosité. Elle finit par appeler \verb|sendNtpPacket()| qui va interroger un serveur \gls{NTP} pour mettre à jour l'heure de l'horloge.

La fonction \verb|loop()| se contente de demander au serveur de s'occuper des connections entrantes. Ce dernier peux appeler deux fonctions~: \verb|defaultCmd()| si la page d'index est demandée ou \verb|sensorsJsonCmd()| si c'est la page \enquote{sensors.json} qui est demandée.

La fonction \verb|defaultCmd()| se contente d'envoyer la page d'index dont le code source est disponible à l'annexe \ref{app:index}.

La fonction \verb|sensorsJsonCmd()| récupère les valeurs des capteurs puis les envoie dans le format \gls{JSON}. Un exemple est fourni à l'annexe \ref{app:sensors}. 

\subsection{La page d'index}
Une fois téléchargée par le navigateur web, du JavaScript est exécuté. Ce JavaScript va télécharger la page \enquote{sensors.json} de manière régulière, analyser son contenu puis mettre à jour le tableau qui contient les valeurs.

\section{Tentative de réunion}
J'ai essayé de réunir les deux programmes en un seul en allégeant les \glspl{bibliotheque} concernant la partie web. J'ai essayé de supprimer tous les références au \gls{DHCP}\glsadd{DHCPg} et au \gls{DNS}\glsadd{DNSg}. Cela a permis de faire passer le programme final en dessous des 32256 octets, mais il est apparu de drôles de choses~: la programme gelait au bout de quelques secondes et la fonction \verb|setup()| était appelée en boucle.

J'ai aussi cherché s'il était possible de mettre un système d'exploitation sur l'Arduino et qu'il puisse charger les programmes sur la carte SD, mais je n'ai rien trouvé.

\section{Le programme pour tester en pratique l'I²C}
La fonction \verb|setup()| se contente d'initialiser la classe \verb|Wire| pour pouvoir utiliser le bus.

La fonction \verb|loop()| va envoyer en boucle le nombre 0, 170 ou 255 à un esclave (ici, l'horloge) en mode d'écriture. L'opération est effectuée en boucle car un seul envoi est trop rapide pour être lu sur l'oscilloscope.

\chapter{Test de l'I²C en pratique}
\section{Le choix des nombres envoyé}
Les trois nombre envoyé on été choisis à cause de leur écriture en binaire\footnote{Voir tableau \ref{dec-bin}}. Ce sont un peu des cas \enquote{extrêmes} qui permettent de bien voir certaines choses sur les graphes de l'oscilloscope.

\begin{table}[h]
    \begin{center}
        \begin{tabular}{|c|c|}
            \hline
            Notation décimale & Notation binaire \\
            \hline
            0 & 00000000 \\
            \hline
            170 & 10101010 \\
            \hline
            255 & 11111111 \\
            \hline
        \end{tabular}
    \end{center}
    \caption{Équivalence décimal-binaire}
    \label{dec-bin}
\end{table}

\section{Analyse des graphes}
Pour pouvoir analyser les graphes facilement, j'ai rajouté le numéro ou le nom des bits sur la ligne d'horloge et le bit envoyé sur la ligne de données ainsi que le START et le STOP. Les originaux sont disponible à l'annexe \ref{app:oscillo}.

\subsection{Avec 0}

La figure \ref{fig:oscillo-0} montre l'écriture d'un 0 vue à l'oscilloscope. Le premier canal (en orange) montre la ligne des données (SDA) et le deuxième canal montre la ligne d'horloge (SCL).

On voit que la communication commence par l'envoi d'un START par le maître, suivi des sept bits de l'adresse (ici, \enquote{1101000}) puis du bit d'écriture (l'avant-dernier \enquote{0}). L'esclave envoie ensuite le bit d'acquittement (le dernier \enquote{0}). On remarque ensuite une crête, mais elle ne correspond pas à un RESTART. En effet~: cette crête se situe alors que la ligne d'horloge est au niveau \enquote{LOW}. Ensuite, on voit l'envoi du 0 (les huit premiers \enquote{0}) par le maître puis du bit d'acquittement par l'esclave. Le maître termine la communication par un STOP.

\begin{figure}[H]
    \centering
    \includegraphics[scale=1]{oscillo/0.png}
    \caption{Écriture d'un 0 à l'oscilloscope}
    \label{fig:oscillo-0}
\end{figure}

\subsection{Avec 255}

La figure \ref{fig:oscillo-255} montre l'écriture d'un 255 vue à l'oscilloscope.

La communication commence de la même manière~: envoi du START, de l'adresse, du bit d'écriture et pour finir, le bit d'acquittement. Pour le deuxième octet, on voit l'envoi des huit \enquote{1}, puis le bit d'acquittement. Mais cette fois ci, ce dernier est positionné à \enquote{1}. L'esclave envoie donc un NACK (autrement dit, un non-acquittement). Le maître termine la communication avec un STOP. On remarque un creux entre le deuxième octet et le STOP. C'est pour pouvoir effectuer ce dernier. En effet~: pour pouvoir effectuer le STOP, la ligne de données doit passer de bas à haut quand la ligne d'horloge est à haut. La crête est toujours présente, mais \enquote{fusionnée} avec les \enquote{1} du deuxième octet.

\begin{figure}[H]
    \centering
    \includegraphics[scale=1]{oscillo/255.png}
    \caption{Écriture d'un 255 à l'oscilloscope}
    \label{fig:oscillo-255}
\end{figure}

\subsection{Avec 170}

La figure \ref{fig:oscillo-170} montre l'écriture d'un 170 vue à l'oscilloscope.

Encore une fois, la communication commence de la même manière. Pour le deuxième octet, on voit l'envoi de \enquote{10101010}, puis le bit d'acquittement. Mais cette fois ci encore, ce dernier est positionné à \enquote{1}. L'esclave envoie à nouveau un NACK. Le maître termine la communication avec un STOP.

\begin{figure}[H]
    \centering
    \includegraphics[scale=1]{oscillo/170.png}
    \caption{Écriture d'un 170 à l'oscilloscope}
    \label{fig:oscillo-170}
\end{figure}

\subsection{Explication du NACK}
Pour expliquer les deux derniers NACK, il faut s'intéresser au fonctionnement de l'horloge\footcite{ds3231} (pas la ligne mais le périphérique).

L'horloge contient un registre qui contient des valeurs qui correspondent à l'heure, la date, la température et à deux alarmes. Ici, deux cas sont possible~: la lecture et l'écriture.

Si on veux lire une partie du registre, il faut commencer par envoyer en écriture la case à partir de laquelle on veux commencer à lire puis un STOP. Ensuite, on envoie une demande de lecture. L'horloge va réponde en envoyant un octet contenant le contenu de la case sélectionnée. Ensuite, on peux soit envoyer un ACK pour recevoir la case suivante, soit envoyer un NACK pour arrêter la lecture.

Si l'on veut écrire, après avoir sélectionné la case, il faut continuer à écrire un octet. Cet octet sera écrit à l'endroit sélectionné. Deux choix s'offrent ensuite~: soit écrire encore un octet qui sera placé dans la case suivante, soit envoyer un STOP.

Les nombres envoyés pour mes essais sont donc des sélections de case. L'horloge a donc renvoyé un NACK car la case n° 170 ou 255 n'existe pas et la sélection a donc échouée. Elle a, au contraire, renvoyé un ACK pour la case n° 0 car celle-ci existe. En effet~: en informatique, les tableaux et les registres sont numérotés à partir de 0 et non de 1.

\chapter{Le cas du frigo}
\section{Les mesures}
Pour réaliser cette expérience, la station météo a été placée dans un sachet plastique contenant du silica gel ainsi qu'une rallonge pour l'hygromètre pour qu'il puisse être exposé à l'humidité du frigo. La station météo a ensuite été placée pendant une heure au frigo. Voici les premières constatations~: premièrement, l'humidité ne dépassait jamais 70~\%, deuxièmement, la température ne descendait jamais au dessous de 8~°C (voir la figure \ref{fig:1}).

Un deuxième essais a donc été réalisé, sans sachet plastique cette fois ci. Le montage a été placé deux heures au frigo. Cette fois ci, la température s'est stabilisée à environ 5~°C mais on constate une chute de la puissance après environ une heure. Cela est probablement dû au fait que les piles ne fournissent plus d'énergie à basse température, la puissance raugmentant une fois sortie du frigo (voir la figure \ref{fig:2}).

Un autre essais a ensuite été réalisé. Cette fois-ci, les piles ont été remplacées par un adaptateur qui fournissait du 9~volts. La station météo a été placée dans le frigo, pendant une nuit. Cette fois-ci, l'expérience c'est bien déroulée~: il n'y a pas eu de perte de puissance.

\section{Les résultats}
Sur la première figure (\ref{fig:graphiques}), on remarque plusieurs choses.

Tout d'abord, la température commence par descendre de manière qui semble exponentielle (ce n'est pas très visible ici mais est clair sur un agrandissement) puis oscille de manière périodique entre 4~°C et 7.5~°C. On voit une légère augmentation de la température vers huit heure du matin.

La pression a diminué pendant la nuit, mais cela n'est pas lié au frigo.

L'humidité oscille aussi de manière périodique entre environ 40~\% d'humidité et 70~\% d'humidité après deux heures dans le frigo. On voit un grand pique vers huit heure du matin.

La luminosité est nulle tout au long de l'expérience sauf quand la station a été placée et retirée du frigo. On remarque un pique vers huit heure du matin. La porte a donc été ouverte à cette heure ci.
\begin{figure}[H]
    \centering
    \input{data/3/data.tex}
    \caption{Les quatre graphiques}
    \label{fig:graphiques}
\end{figure}

\subsection{L'humidité en fonction de la température}
La figure \ref{fig:t-h} représente l'humidité en fonction de la température entre trois heure et quart du matin et sept heure de demi du matin. D'après les cours de M.~Bonnaz, je m'attendais à voir une courbe de pente négative, symétrique à celle-ci. En effet~: plus l'air est chaud, plus il peux accueillir de l'humidité donc l'humidité relative devrait diminuer. Mais ça ne fonctionne que si l'on part du principe que l'eau ne se condense que lorsque l'humidité atteint 100~\% (ce qui était fait dans les exercices du cours).

Mais d'où peux donc venir cette différence~? Faisons un peu de calcul~:

Par définition de l'humidité absolue\footnote{Une table des symboles est disponible à la page \pageref{ref:symboles}}~:
\[H = \frac{m}{V}\]
Or, \(m = M\cdot{}n\) (cours de chimie). Nous avons donc~:
\[H = \frac{n}{V}\cdot{}M_{eau}\]
Or, \(\frac{n}{V} = \frac{P}{R\cdot{}T}\) (loi des gaz parfaits). Donc~:
\[H_{\acute{e}q} = \frac{P_{\acute{e}q}\cdot{}M_{eau}}{R\cdot{}T}\]
Par définition de l'humidité relative~:
\[H_r = \frac{H}{H_{\acute{e}q}}\]

En remaniant les formules, on trouve~:
\[m = V\cdot{}H = V\cdot{}H_r\cdot{}H_{\acute{e}q} = V\cdot{}H_r\cdot{}\frac{P_{\acute{e}q}\cdot{}M_{eau}}{R\cdot{}T}\]

\glsadd{H}\glsadd{m}\glsadd{V}\glsadd{M}\glsadd{n}\glsadd{P}\glsadd{R}\glsadd{T}\glsadd{Hr}\glsadd{Heq}\glsadd{Peq}

Sachant que le frigo fait environ 200~litres, qu'à 4~°C l'humidité relative est de 43~\% et que la pression à l'équilibre\footnote{Information que l'on trouve dans des tables} est de 813~Pa, qu'à 6.6~°C l'humidité relative est de 70~\% et que la pression à l'équilibre est de 975~Pa, on peux calculer la quantité de vapeur dans le frigo à 4 et 6.6~°C.
À~4 °C, le frigo contient environ 0.55~grammes de vapeur et à 6.6~°C, il en contient 1.06~grammes.
Si l'on part du principe que le frigo est étanche, la pente de la courbe peux donc s'expliquer par le fait que 0.51~grammes d'eau s'évaporent et se condensent à chaque cyclique, ce qui est une quantité raisonnable.

\begin{figure}[H]
    \centering
    \input{data/3/t-h.tex}
    \caption{Humidité en fonction de la température}
    \label{fig:t-h}
\end{figure}

\listoffigures

\chapter*{Bibliographie}
\addcontentsline{toc}{chapter}{Bibliographie}
\nocite{*}
\section*{Sites web}
\printbibliography[heading=none,keyword=website]
\section*{Images}
\printbibliography[heading=none,keyword=image]

\printglossary[type=\acronymtype,title=Acronymes,toctitle=Acronymes,style=altlist]
\newpage
\printglossary[type=main,title=Glossaire,toctitle=Glossaire,style=altlist]
\newpage
\label{ref:symboles}
\printglossary[type=symbolslist,style=long3col]

\appendix
\appendixpage
\addappheadtotoc

\chapter{Licence MIT}
\label{app:mit}

\inputminted{text}{input/mit.txt}

\chapter{WeatherStationLogger.ino}
\label{app:logger}
\inputminted[linenos]{cpp}{../arduino/WeatherStationLogger/WeatherStationLogger.ino}

\chapter{DATA.TSV}
\label{app:data}
\inputminted[obeytabs]{text}{input/DATA.TSV}

\chapter{WeatherStationWeb.ino}
\label{app:web}
\inputminted[linenos]{cpp}{../arduino/WeatherStationWeb/WeatherStationWeb.ino}

\chapter{index.html}
\label{app:index}
\inputminted[linenos]{html}{../arduino/WeatherStationWeb/index.html}

\chapter{sensors.json}
\label{app:sensors}
\inputminted[linenos]{json}{input/sensors.json}

\chapter{I2CPractise.ino}
\label{app:i2cpractise}
\inputminted[linenos]{cpp}{../arduino/I2CPractise/I2CPractise.ino}

\chapter{Originaux de l'oscilloscope}
\label{app:oscillo}

\begin{figure}[h]
    \centering
    \includegraphics[scale=1]{oscillo/TEK0002.png}
    \caption{Écriture d'un 0 à l'oscilloscope (original)}
\end{figure}

\begin{figure}[h]
    \centering
    \includegraphics[scale=1]{oscillo/TEK0001.png}
    \caption{Écriture d'un 255 à l'oscilloscope (original)}
\end{figure}

\begin{figure}[h]
    \centering
    \includegraphics[scale=1]{oscillo/TEK0000.png}
    \caption{Écriture d'un 170 à l'oscilloscope (original)}
\end{figure}

\chapter{Graphiques}
\label{app:graphs}

Voici les graphiques des autres essais réalisés. À cause de leur taille, le premier est à la page suivante.

\begin{figure}[h]
    \centering
    \input{data/1/data.tex}
    \caption{Premier essai dans le frigo}
    \label{fig:1}
\end{figure}

\begin{figure}[h]
    \centering
    \input{data/2/data.tex}
    \caption{Deuxième essai dans le frigo}
    \label{fig:2}
\end{figure}

\end{document}
