docs/projects/boite_agb.md

@@ -0,0 +1,82 @@
+# Boîte COF de l'AGB
+
+_Maurice, Sel, Catvayor. Octobre 2024_
+
+
+Pour l'AG budget d'octobre 2024, HackENS a produit un contrôleur
+de projecteur pour [le site de l'AGB](http://agb.hackens.org)
+à mettre entre les mains (responsables, voyons) du COF.
+
+Le COF avait donc accès à la configuration d'un projecteur (motorisation,
+luminosité, couleur) et à un effet "color bump".
+
+![Boîte en octobre 2024](boite_oct24.jpg)
+
+
+## Réalisation
+
+L'idée de départ est la suivante : un panneau de contrôle sans fil pour le COF,
+relié via l'API de Maurice aux projecteurs de l'AGB. Maurice a fourni une
+batterie (108 Wh !!) et via BiBi HackENS a récupéré des Raspberry Pi Micro,
+qui sont idéales pour ce genre de projet.
+
+On a identifié 3 domaines lors du développement (on était 3, quel hasard) :
+
+- la mécanique/électronique : une boîte qui tient, avec joystick
+et boutons;
+
+- le software sur le contrôleur : comment programmer la Raspi et comment on
+communique avec l'API de l'AGB;
+
+- les hooks dans l'API de l'AGB, notamment rajouter le contrôle du projecteur
+dans les services offerts, ainsi que le système d'autorisation.
+
+La distinction n'était pas toujours très claire toutefois : est-ce que la soudure,
+la détermination des pinout relève du point 1 ou 2 ? Est-ce que la trigo pour
+contrôler le projecteur de manière intuitive relève du contrôleur local ou de
+l'API ? On a travaillé principalement sur ces 3 points séparément
+mais on s'est entraidé donc les frontières floues entre ces points n'ont pas
+posé de problèmes.
+
+### Mécanique (Sel)
+
+L'aspect le plus important de la boîte est son haut, avec le panneau de
+contrôle. Avec des pièces d'arcade qui traînaient, on était sûrs au début de
+mettre un joystick et deux boutons. Aussi, un potentiomètre semblait une
+option tentante. Mais installer un potentiomètre peut introduire de la
+complexité : _a priori_ la Raspi Pico ne peut pas lire la résistance du
+potentiomètre directement car elle n'a que des entrées numériques...
+
+La boîte fait environ 20cm x 20cm x 11cm, les dimensions étant choisies
+surtout pour contenir la (grosse) batterie de Maurice tout en ayant assez de
+hauteur pour installer les contrôles.
+
+Initialement j'ai voulu réaliser une boîte beaucoup trop ambitieuse à la CNC,
+où les "murs" sont biseautés à 45° chacun avant d'être collés. Un étrange
+bug de soft limit sur la CNC a empêché l'usinage des pièces. Avec un peu trop
+d'enthousiasme, j'ai alors essayé d'usiner cela à la défonceuse. C'était une
+__très__ mauvaise idée, comme en témoignent 4 pauvres chutes de bois encore
+à hackENS.
+
+J'ai donc dû tout reprendre de 0 le dimanche pour le mardi, avec un design plus
+simple : 4 murs rectangulaires, avec deux paires égales car découpées ensemble.
+Les murs sont collés ensemble, et une planche de contreplaqué usinée à la CNC
+(bouton par bouton, pour éviter partiellement le bug) tient les contrôles :
+les 2 boutons, le joystick, un commutateur ON/OFF et un encodeur.
+
+En effet, après avoir trouvé un encodeur numérique, qui donne par l'état de 8
+interrupteurs l'angle de son axe, on a décidé de l'ajouter à la place du
+potentiomètre.
+
+Le fond de la boîte a un rebord pour s'aligner sans jeu en dessous
+des murs, mais la boîte est fermée par 2 équerres dans tous les cas. Des pieds
+en caoutchouc s'assurent que la boîte ne glisse pas, même maltraitée, et permet
+aux équerres de ne pas racler le sol.
+
+![la boîte, ouverte](boite_ouverte_oct24.jpg)
+
+### Software embarqué
+
+### API de l'AGB
+
+## Installation