Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/zetiti10/lance-missile

Ce programme gère le lance missile en permettant un contrôle via UART.
https://github.com/zetiti10/lance-missile

arduino missile-launcher platformio uart

Last synced: 16 days ago
JSON representation

Ce programme gère le lance missile en permettant un contrôle via UART.

Host: GitHub
URL: https://github.com/zetiti10/lance-missile
Owner: zetiti10
Created: 2023-12-22T08:02:39.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2024-11-09T17:48:06.000Z (3 months ago)
Last Synced: 2024-11-18T22:32:12.039Z (3 months ago)
Topics: arduino, missile-launcher, platformio, uart
Language: C++
Homepage:
Size: 40 KB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 1
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# Lance missile

Ce programme permet la gestion complète d'un lance-missile. Il est exécuté par un Arduino Nano Every qui remplace le micro-contrôleur d'origine. Le but est de pouvoir contrôler facilement le lance-missile depuis un ordinateur (en USB) ou tout autre appareil comme un Arduino connecté en UART à celui-ci. La conversion consiste dans un premier temps à remplacer l'ancienne électronique par les nouveaux composants, puis à programmer l'Arduino pour permettre le contrôle du lance-missile.

> [!NOTE]
> Le lance-missile en question est un ancien appareil (aujourd'hui retiré de la vente) produit par Satzuma.

Ce programme a été écrit en C++ pour l'Arduino Nano Every à l'aide de PlatformIO.

> [!WARNING]
> Les informations renseignées ici ne suffisent pas à reproduire le projet. Si vous êtes intéressés, vous pouvez me contacter par mail : .

Une bibliothèque Arduino est disponible sur [ce dépôt](https://github.com/zetiti10/Bibliotheque-Arduino-lance-missile), elle permet de contrôler le lance-missile depuis un autre Arduino en UART.

Un logiciel de contrôle du lance-missile est disponible sur [ce dépôt](https://github.com/zetiti10/Kadeau). Il présente une interface graphique, et permet le contrôle d'un lance-missile connecté en USB.

## Modifications du lance-missile original

Les moteurs et les capteurs du lance-missile ont été conservés, cependant, le reste de l'électronique a été retirée. Des connecteurs Dupont ont été utilisés pour rendre la maintenance plus facile.

Le boîtier des piles a été retiré car il ne sert plus et deux trous ont été percés : l'un pour un connecteur USB-C et l'autre pour un connecteur Dupont 4 broches femelle.

Un circuit imprimé de prototypage (quadrillage de trous) héberge l'Arduino Nano Every, tous les connecteurs pour les câbles et les deux L293D (ponts en H pour les moteurs).

## Connexions à l'Arduino Nano Every

| Broche | Périphérique connecté | Nom dans le programme |
| ------- | ------------------------------------- | --------------------------- |
| A1 / 15 | Capteur de l'orientation de la base 1 | `PIN_BASE_SENSOR_1` |
| A0 / 14 | Capteur de l'orientation de la base 2 | `PIN_BASE_SENSOR_2` |
| A2 / 16 | Capteur du missile 1 | `PIN_MISSILE_1_SENSOR` |
| A3 / 17 | Capteur du missile 2 | `PIN_MISSILE_2_SENSOR` |
| A4 / 18 | Capteur du missile 3 | `PIN_MISSILE_3_SENSOR` |
| A5 / 19 | Capteur de l'état du lanceur | `PIN_LAUNCHER_MOTOR_SENSOR` |
| 8 | Capteur de l'inclinaison de la tête 1 | `PIN_ANGLE_SENSOR_1` |
| 9 | Capteur de l'inclinaison de la tête 2 | `PIN_ANGLE_SENSOR_2` |
| 3 | Moteur de la base 1 | `PIN_BASE_MOTOR_1` |
| 2 | Moteur de la base 2 | `PIN_BASE_MOTOR_2` |
| 4 | Moteur de l'inclinaison 1 | `PIN_ANGLE_MOTOR_1` |
| 5 | Moteur de l'inclinaison 2 | `PIN_ANGLE_MOTOR_2` |
| 6 | Moteur du lanceur 1 | `PIN_LAUNCHER_MOTOR_1` |
| 7 | Moteur du lanceur 2 | `PIN_LAUNCHER_MOTOR_2` |

Le port UART (connecteur Dupont 4 broches femelle) est relié au RX/TX de l'Arduino Nano Every.

## Fonctionnement du programme

Le programme commence par initialiser le lance-missile : si aucune valeur stockée dans la mémoire persistante (EEPROM) n'est trouvée, une calibration est lancée. Le programme calcule les vitesses angulaires des deux axes puis retourne au point initial. Les valeurs sont enregistrées dans la mémoire persistante. Cette opération prend un certain temps. C'est pour cela que si les valeurs ont déjà été calculées, le lance-missile retourne simplement à l'origine pour retrouver sa position précédente.

> [!TIP]
> Pendant cette phase de démarrage, seule la commande `52` (connaître l'état du lance-missile) est opérationnelle.

Une fois l'initialisation terminée, le lance-missile est parfaitement opérationnel. Il attend de reçevoir un ordre depuis un ordinateur ou un Arduino (voir la partie communication en UART).

## Communication en UART

Le lance-missile est contrôlable de la même manière pour les deux moyens (USB et UART). Voici un tableau présentant le protocole utilisé pour effectuer des action et récupérer des informations :

| Position | 0 | 1 | Positions suivantes / valeurs retournées |
| -------- | -------------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| | 0 : déplacer la tête pendant une durée | 0 : inclinaison vers le haut | `00001` à `99999` : temps en milliseconde |
| | | 1 : inclinaison vers le bas | `00001` à `99999` : temps en milliseconde |
| | | 2 : rotation vers la gauche | `00001` à `99999` : temps en milliseconde |
| | | 3 : rotation vers la droite | `00001` à `99999` : temps en milliseconde |
| | 1 : déplacer la tête pour un angle | 0 : rotation horizontale | `-180` à `+180` : angle |
| | | 1 : inclinaison verticale | `-040` à `+040` : angle |
| | 2 : déplacer la tête à un angle | 0 : rotation horizontale | `000` à `180` : angle |
| | | 1 : inclinaison verticale | `000` à `040` : angle |
| | 3 : action | 0 : commencer à déplacer un axe dans un sens | `0` : vers le haut |
| | | | `1` : vers le bas |
| | | | `2` : vers la gauche |
| | | | `3` : vers la droite |
| | | 1 : arrêter le déplacement d'un axe | `0` : axe horizontal |
| | | | `1` : axe vertical |
| | | 2 : calibrer le lance-missile | |
| | 4 : lancer des missiles | 1 à 3 : nombre de missiles à envoyer | |
| | 5 : récupérer des informations | 0 : récupérer la position de la tête | Renvoie la position des deux axes (par exemple : `090/180,015/040`) |
| | | 1 : récupérer l’état des trois missiles | Renvoie l’état de chaque missile (par exemple `001`) |
| | | 2 : permet de savoir si le lance-missile est opérationnel | Renvoie true (`1`) si le lance-missile est initialisé et calibré, false (`0`) si ce n’est pas le cas et ne renvoie rien si le lance-missile n’est pas connecté |
| | | 3 : récupérer les actions actuelles du lance-missile | Renvoie une chaîne de caractères : position 1 = déplacement vertical, position 2 = déplacement horizontal, position 3 = le nombre de missiles en cours de lancement |
| | 6 : réglage de la connexion | 0 : défini l'intervale de mise à jour des états | 00000 à 99999 : intervalle en milliseconde de mise à jour des états. Pour ne pas recevoir de mises à jour, envoyer `00000` (valeur par défaut). La mise à jour est envoyée uniquement si un état a changé depuis la dernière mise à jour. Les messages sont envoyés sous la forme `001` pour les missiles, et `090/180,015/040` pour la position. |

Il faut ajouter à la fin de tout message envoyé le caractère de retour chariot "\n" afin d'indiquer au programme que la commande est terminée. De son côté, le lance-missile renverra lui-aussi un retour chariot "\n" à la fin de chacun de ses messages.

Pendant le démarrage (calibration ou initialisation), seule la commande `52` (connaître l'état du lance-missile) est opérationnelle.

> [!IMPORTANT]
> Il est important de bien ajouter des zéros, par exemple, il ne faut pas envoyer `0210` : il faut envoyer `0200010`.

Exemples de message :

- Incliner la tête à 20° : `21020`
- Lancer deux missiles : `42`
- Récupérer l'état des trois missiles : `51`