# Morpion lumineux

## SAE 203

Quentin T'JAMPENS
Giovanni JOSSERAND

## Sommaire

1. Prérequis
2. Configurer le projet
3. Utiliser le projet
4. Annexe
5. Problèmes connus

### Prérequis

- Télécharger le code source via le [Gitlab officiel du projet](https://iutbg-gitlab.iutbourg.univ-lyon1.fr/SAE_203_2025/grA_21_Morpion_lumineaux/gra_21_morpion_lumineux_code)
- Installer [l'IDE Arduino](https://www.arduino.cc/en/software/)
- Avoir les composants suivants :
  - 1x Esp32
  - 9x Groove Mech Keycap
  - 1x Push Button
  - 1x Touch sensor 12 key capacitive
  - 1x OLED Display
  - 1x câble d'alimentation Esp32

### Configurer le projet

1. Télécharger la carte **esp32** By Espressif Systems **v2.0.17** via le boards manager de l'IDE Arduino
2. Installer les bibliothèques utilisées depuis l'IDE Arduino (Liste des bibliothèques en **Annexe**)
3. Brancher la carte Arduino puis compiler et téléverser le projet

### Utiliser le projet

- Une fois le code compilé et téléversé, sélectionner le mode de jeu (Local/Web) via l'écran OLED et les boutons associés
- Mode Local :
  - Choisir si on veut jouer en solo ou duo. Si le mode solo est choisi, sélectionner la difficulté du jeu, le joueur jouera ensuite contre un robot
  - Pendant une partie le joueur 1 et le joueur 2 joueront à tour de rôle (Si le mode sélectionné est Solo, le joueur 2 sera remplacé par le robot, et jouera instantanément après le joueur 1)
  - Une fois la partie terminée, tous les boutons excepté la ligne responsable de la victoire s'éteindront
  - Le bouton resetGame permet de réinitialiser la partie
- Mode Web :
  - Connecter votre appareil (téléphone, PC, ...) au réseau créé par l'esp32, le nom du réseau devra s'afficher sur l'écran OLED, le mot de passe du réseau s'affiche également à l'écran. Une fois connecté au réseau, rendez-vous ensuite sur le site web du jeu via l'IP affichée à l'écran.
  - Une fois sur le site, choisir entre mode solo/duo. Le mode solo comporte 2 difficultés, Facile et Difficile
- Le bouton reset permet de redémarrer l'esp pour par exemple changer de mode de jeu (Web/Local...)

### Annexe

#### Liens utiles
- [Gitlab du projet](https://iutbg-gitlab.iutbourg.univ-lyon1.fr/SAE_203_2025/grA_21_Morpion_lumineaux/gra_21_morpion_lumineux_code)
- [Arduino](https://www.arduino.cc/)
- [IDE Arduino](https://www.arduino.cc/en/software/)
- [Tutoriel Vidéo](https://exemple.com)

#### Photos

<img src="https://iutbg-gitlab.iutbourg.univ-lyon1.fr/SAE_203_2025/grA_21_Morpion_lumineaux/gra_21_morpion_lumineaux_images/-/raw/main/oled.png?ref_type=heads" height=200>
<img src="https://iutbg-gitlab.iutbourg.univ-lyon1.fr/SAE_203_2025/grA_21_Morpion_lumineaux/gra_21_morpion_lumineaux_images/-/raw/main/4.png?ref_type=heads" height=200>
<img src="https://iutbg-gitlab.iutbourg.univ-lyon1.fr/SAE_203_2025/grA_21_Morpion_lumineaux/gra_21_morpion_lumineaux_images/-/raw/main/ledsOff.jpg?ref_type=heads" height=200>
<img src="https://iutbg-gitlab.iutbourg.univ-lyon1.fr/SAE_203_2025/grA_21_Morpion_lumineaux/gra_21_morpion_lumineaux_images/-/raw/main/ledsOn.jpg?ref_type=heads" height=200>
<img src="https://iutbg-gitlab.iutbourg.univ-lyon1.fr/SAE_203_2025/grA_21_Morpion_lumineaux/gra_21_morpion_lumineaux_images/-/raw/main/3.jpg?ref_type=heads" height=200>
<img src="https://iutbg-gitlab.iutbourg.univ-lyon1.fr/SAE_203_2025/grA_21_Morpion_lumineaux/gra_21_morpion_lumineaux_images/-/raw/main/2.jpg?ref_type=heads" height=200>
<img src="https://iutbg-gitlab.iutbourg.univ-lyon1.fr/SAE_203_2025/grA_21_Morpion_lumineaux/gra_21_morpion_lumineaux_images/-/raw/main/1.jpg?ref_type=heads" height=200>

#### Branchement

Libellé | pin
| -- | -- |
Entrée Bouton 1 | 8 - CH0
Sortie Bouton 1 | 15
Entrée Bouton 2 | 9 - CH1
Sortie Bouton 2 | 33
Entrée Bouton 3 | 10 - CH2
Sortie Bouton 3 | 26
Entrée Bouton 4 | 11 - CH3
Sortie Bouton 4 | 25
Entrée Bouton 5 | 12 - CH4
Sortie Bouton 5 | 16
Entrée Bouton 6 | 13 - CH5
Sortie Bouton 6 | 17
Entrée Bouton 7 | 14 - CH6
Sortie Bouton 7 | 14
Entrée Bouton 8 | 15 - CH7
Sortie Bouton 8 | 32
Entrée Bouton 9 | 16 - CH8
Sortie Bouton 9 | 4
ResetGame Bouton | 26


#### Bibliothèques utilisées

- Adafruit NeoPixel v1.15.1
- TTP229
- Adafruit_MPR121
- Adafruit GFX Library
- Adafruit_SH110X


### Problèmes connus

- Après un reset, les LED restent allumées et s'éteignent lors du lancement d'une partie (web ou local). Mais parfois, une LED reste allumé malgré tout
- Il est possible qu'un bouton ne fonctionne pas correctement lorsqu'il est utilisé en mode local par le joueur (LED et interaction)