Manuel utilisateur

_images/logo.JPG
Auteur

J.Soranzo et Gilles

Societe

VoRoBoTics 2

Entity

VoLAB 2

Dépôts Bitbucket

Source de la doc, code ARDUINO, serveur et la doc en html 1

Création

05/2023

Vue d’ensemble

_images/architecture.JPG

Dans le cadre du fonctionnement avec serveur web, les différentes étapes à réalisées sont:

- Programmer l'Arduino
- Préparer le serveur

  • installer Python

  • cloner le dépôt

  • installer les dépendances

  • adapter les valeurs min, max au bras utilisé

Dans le cadre du fonctionnement avec Smartphone ou tablette, sous Android:

L’application bras_andrtoid.apk est modifiable en ligne avec ai2.appinventor.mit.edu 3 et le fichier source: bras_android.aia

_images/brasAndroidAppInventor.JPG

  1. Charger le fichier : robot_moustaches.apk sur votre téléphone ou tablette.

  2. Lancer l’installation en acceptant les consignes.

Pour de plus amples informations sur la version Android du projet suivre ce lien 4

Câblage

Concernant les 2 versions de bras utilisés: on s’inspire des plans de câblage suivant:

Bras Robot Educatif Schéma électrique 5 (dans le présent projet on utilise pas le clavier et le Joystick)

Bras manipulateur 6

Adaption avec une carte 2560

L’avantage de cette carte est qu’elle possède plusieurs ports série matériels dont un port pour le début et un port pour la communication avec le serveur.

Carte ARDUINO MEGA 2560: carte ADAFRUIT PWM câblée sur SDL et SCA broches dédiée de la 2560.

_images/2560_sclSdaPinout.JPG

Ajout du Bluetooth

Pour faire fonctionner le bras en BT, il convient de câbler un module BT sur la liaison série n°1

BT : id Bras2023_HC05 pass 1234, le BT sera câblé sur la serial1 de la carte 2560.

Polarité RX/TX à priori croisé.

HC-05 : Ce module peut être « maître » (celui qui a le bouton poussoir - on en a un autre sans BP qui s’identifie comme HC-05 en commande AT)

HC-06 : Ce module ne peut être qu’esclave.

Appairage de BT

Pour utiliser le Bluetooth (BT), il convient d’appairer la machine qui fait tourner le serveur avec le module BT utilisé. Cette opération peut s’avérer très délicate…

Avant de pouvoir utiliser le serveur et le bras robot, il vaut mieux s’assurer de la communication complète entre un device BT(genre un téléphone et la carte ARDUINO).

2 étapes peuvent être conduites pour cela:

  1. Vérification de la la liaison entre l’ARDUINO et le module BT : utilisation des commandes AT

  2. Puis vérification de la liaison complète device<=>module HC-05<=>ARDUINO

Dans le dépôt Bitbucket se trouve des outils ARDUINO comme bt2560.ino pour tester les commandes AT

Pour vérifier la chaîne complète, on peut laisser le programme bt2560 dans l’ARDUINO et sur un téléphone ANDROID utiliser l’application suivante:

_images/serialBluetoothTerminalIcon.JPG _images/serial_bluetooth_terminal.jpg _images/serialBluetoothTerminalInstall.JPG

Relever les valeurs caractéristiques des servo

Les valeurs des différents servomoteurs sont dans le document Bras Manipulateur Original

Afin de vérifier le fonctionnement de chaque servo individuellement et d’effectuer les différents relevés min, max, init, rangement… on pourra utiliser le programme du dépôt bras2023arduinocodestestsServocommandes

Commandes:

<H> : help
<A angle>

Pour utiliser ce programme on relie directement chaque servo individuellement (broche signal) à la broche 2 de la carte ARDUINO.

Ces valeurs sont à reporter dans le fichier \parametres_robot.h

Mise en place du serveur

Il faut avoir préalablement installer Python v3.8 ou plus. Ensuite on utilise un environnement virtuel grâce à la commande Python venv, on install alors l’ensemble des packets nécessaires dans l’environnement virtuel.

Voir le différentes commandes ici, fichier req.txt disponible dans le dépôt brasrobot2023Serveur 7

Lancement du serveur : dans une fenêtre de commande windows taper : server (fichier server.bat disponible également dans le dépôt)

Au lancement, le serveur essaie de se connecter à chaque port série de la machine hôte. Lorsqu’il détecte le firmware de la carte ARDUINO2560, le serveur est connecté au bras et est donc prêt à recevoir des connections web.

_images/lancementDuServeur.JPG

A ce stade, il ne reste plus qu’à ce connecter au serveur via un navigateur internet soit à l’adresse ip indiqué par le serveur sur le port 8300 (exemple 192.168.1.94:8300) soit sur la même machine avec localhost:8300.

La connexion au serveur peut se faire soit depuis le serveur lui-même soit depuis une autre machine connectée (PC, Mac ou Android) au même réseau WIFI que le serveur…

Interface

_images/interfaceBras2024.JPG

Le design original de cette interface est de phpoc_man 8 à laquelle nous avons ajouté 2 boutons pour l’initialisation et le rangement…