Modifications

Aller à : navigation, rechercher

Atelier logiciel

7 390 octets ajoutés, 4 mai 2021 à 13:18
Unified Modeling Language (UML)
|ingrédients=logiciel,
|url=[http://fablabo.net/wiki/SCAO SCAO]
}}
==Définition==
L'atelier logiciel est l'un des [http://fablabo.net/wiki/SCAO#Les_ateliers_de_prototypage ateliers de prototypage] du SCAO.
** appliquer
** modifier panier.
===Pull-up and Pull-down resistors===
[https://www.electronics-tutorials.ws/logic/pull-up-resistor.html Pull-up and Pull-down resistors] are used to correctly bias the inputs of digital gates to stop them from floating about randomly when there is no input condition.
===Serveur de stockage en réseau (NAS)===
En référence à Planète Linux n°118, l'article intitulé "Installation d'un serveur de fichier".
Tout d'abord voici la définition de Wikipédia : "''Un [https://fr.wikipedia.org/wiki/Serveur_de_stockage_en_r%C3%A9seau serveur de stockage en réseau], également appelé stockage en réseau NAS, boîtier de stockage en réseau ou plus simplement NAS (de l'anglais Network Attached Storage), est un serveur de fichiers autonome, relié à un réseau, dont la principale fonction est le stockage de données en un volume centralisé pour des clients réseau hétérogènes.'' "
 
Ce NAS est installé au sein d'un réseau local constitué à partir de la freebox, il est constitué :
* d'un ordinateur simplifié
* du logiciel XigmaNAS.
 
=== Oscilloscope ===
L'achat est effectué sur le site en ligne Farnell pour le [https://fr.farnell.com/pico-technology/picoscope-2204a/oscilloscope-pc-10mhz-avec-awg/dp/2365425?ost=2365425 Picoscope 2204A].
 
La [http://www.farnell.com/datasheets/3162087.pdf datasheet du Picoscope 2204A].
 
[[fichier:Picoscope.png |thumb|center|upright=2 | Picoscope]]
 
==Installation logicielle==
Liste des installation et vérifications :
* [https://fablabo.net/wiki/Atelier_logiciel#Cr.C3.A9er_une_cl.C3.A9_USB_bootable_Ubuntu Créer une clé USB pour installer Ubuntu]
* booter sur la clé et installer Ubuntu
* [https://fablabo.net/wiki/Atelier_logiciel#Git_et_Git-hub Git]
* [https://fablabo.net/wiki/Atelier_logiciel#Libraries Libraries]
* [https://fablabo.net/wiki/Atelier_logiciel#Minicom Minicom]
* [https://fablabo.net/wiki/Atelier_logiciel#Les_logiciels_applicatifs Librecad]
* [https://fablabo.net/wiki/Atelier_logiciel#Les_logiciels_applicatifs Openscad]
* [https://fablabo.net/wiki/Atelier_logiciel#Les_logiciels_applicatifs Kicad]
* [https://fablabo.net/wiki/Atelier_logiciel#Les_logiciels_applicatifs Inkscape]
* [https://fablabo.net/wiki/Atelier_logiciel#Gestion_de_versions SCAO]
* [https://fablabo.net/wiki/Atelier_logiciel#Installation_de_l.27.C3.A9diteur_Atom Atom]
* [https://fablabo.net/wiki/Atelier_logiciel#Environnement_de_developpement Arduino IDE]
* [https://fablabo.net/wiki/Atelier_logiciel#Environnement_de_developpement Arduino cli]
* Créer les [https://fablabo.net/wiki/Atelier_logiciel#Cr.C3.A9er_un_alias alias]
* Vérifier les accès à fablabo et [https://fablabo.net/wiki/Atelier_logiciel#Personal_access_tokens_.28PAT.29 github].
 
==Personal access tokens (PAT)==
En référence à la version anglaise de Wikipédia, "''In computer systems, an [https://en.wikipedia.org/wiki/Access_token access token] contains the security credentials for a login session and identifies the user, the user's groups, the user's privileges, and, in some cases, a particular application. Typically one may be asked to enter the access token (e.g. 40 random characters) rather than the usual password (it therefore should be kept secret just like a password).''"
 
Pour obtenir un PAT, il faut suivre le lien suivant [https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ token-authentication-requirements-for-git-operations].
 
L'accès à Github s'effectue comme par le passé avec l'identifiant classique (Nom utilisateur + mot de passe).
 
Par contre, il faut prévoir un PAT nécessaire à l'exécution de certaine commande git comme :
* <code>'''git push origin master'''</code>
Mon PAT (Token for AIREL) est mémorisé dans un fichier personnel stocké sur une clé USB.
 
Si nécessaire, on peut effacer toutes les informations d'identification mises en cache dans git à l'aide de la commande suivante :
* <code>'''git config --global --unset credential.helper'''</code>
==Synchronisation==
* la gestion de version avec Git et Git-hub pour les fichiers du sous répertoire /home/leruste/SCAO
* la communication à partir d'un réseau local pour les fichiers personnels des autres sous-répertoires de /home/leruste.
==Développement logiciel==
===Environnement de developpement===
L'[https://fr.wikipedia.org/wiki/Environnement_de_d%C3%A9veloppement environnement de développement] '''« intégré »''' (abrégé EDI en français ou [https://en.wikipedia.org/wiki/Integrated_development_environment IDE] en anglais, pour '''integrated development environment'''). Cet [https://en.wikipedia.org/wiki/Integrated_development_environment IDE] peut être réalisé à partir soit de :
* l'[https://blog.arduino.cc/?ie=UTF-8&oe=UTF-8&s=IDE&domains=&sitesearch= arduino IDE]
* l'[https://blog.arduino.cc/2020/03/13/arduino-cli-an-introduction/ arduino CLI] qui offre la possibilité d'utiliser l'éditeur de son choix, [https://atom.io/ atom] en particulier. Pour l'installer, choisir l'option '''"use the install script"''' du tutoriel [https://arduino.github.io/arduino-cli/latest/installation/ installation], voir ensuite :
** [https://arduino.github.io/arduino-cli/ la documentation]
** [https://github.com/arduino/arduino-cli github]
** [https://arduino.github.io/arduino-cli/getting-started/ getting started].
* [https://fr.wikipedia.org/wiki/Eclipse_(projet) Eclipse].
 
===Les plateformes===
Dans le contexte de cet atelier logiciel, les [https://fr.wikipedia.org/wiki/Plate-forme_(informatique) plateformes] sont des [https://fr.wikipedia.org/wiki/Environnement_de_d%C3%A9veloppement environnements de développement] '''« intégré »''' (abrégé EDI en français ou [https://en.wikipedia.org/wiki/Integrated_development_environment IDE] en anglais, pour '''integrated development environment''').
 
Une plateforme est généralement constituée d'un ordinateur et d'un [https://fr.wikipedia.org/wiki/Microcontr%C3%B4leur microcontrôleur] raccordé par un câble USB.
 
Le [https://fr.wikipedia.org/wiki/D%C3%A9veloppement_de_logiciel développement du logiciel] dédié au [https://fr.wikipedia.org/wiki/Microcontr%C3%B4leur microcontrôleur] se réalise selon les phases suivantes :
* au sein de l'[https://en.wikipedia.org/wiki/Integrated_development_environment IDE] installé sur l'ordinateur :
** saisie du programme
** vérification
** téléversement de l'ordinateur vers le [https://fr.wikipedia.org/wiki/Microcontr%C3%B4leur microcontrôleur]
* au sein du [https://fr.wikipedia.org/wiki/Microcontr%C3%B4leur microcontrôleur] exécution du programme.
Les phases décrites ci-dessus peuvent être exécutées autant de fois que nécessaire jusqu'à obtention du fonctionnement souhaité.
 
A partir du moment où le câble USB est déconnecté, le [https://fr.wikipedia.org/wiki/Microcontr%C3%B4leur microcontrôleur], si son alimentation est autonome (batterie), va exécuter en permanence le dernier programme téléversé.
 
====Plateformes Arduino et Teensy====
Les deux plateformes sont constituées à partir du même ordinateur complété, soit d'un [https://fr.wikipedia.org/wiki/Microcontr%C3%B4leur microcontrôleur] de la famille [https://fr.wikipedia.org/wiki/Arduino Arduino], soit d'un [https://fr.wikipedia.org/wiki/Microcontr%C3%B4leur microcontrôleur] [https://www.pjrc.com/teensy/ Teensy]. Les deux plateformes utilisent le même [https://en.wikipedia.org/wiki/Integrated_development_environment IDE].
L'[https://en.wikipedia.org/wiki/Integrated_development_environment IDE] est :
* soit l'Arduino web editor (disponible uniquement pour Linux 64 bits en date du 14/03/2018)
* soit l'Arduino IDE (Linux '''32 bits''' et 64 bits)
les deux sont accessibles par ce [https://www.arduino.cc/en/Main/Software lien].
 
La [http://playground.arduino.cc/uploads/Main/arduino_notebook_v1-1.pdf documentation].
 
Dans le cas du [https://www.pjrc.com/teensy/ Teensy], il est complété de [https://en.m.wikipedia.org/wiki/Library_(computing) librairies spécifiques].
 
Prenons l'exemple de l'installation de l'IDE arduino-1.8.8
*sur le site arduino, télécharger l’archive arduino-1.8.8-linux64.tar.xz
*la décompresser puis installer avec les commandes :
**tar Jxvf arduino-1.8.8-linux64.tar.xz
**./arduino-1.8.8-linux-setup.sh $USER
**reboot
**lancement arduino.
 
====Plateforme Microchip====
Elle est traitée en un projet séparé accessible par le lien [http://fablabo.net/wiki/PIC PIC].
 
===Organisation des fichiers Arduino===
En référence à l'article [http://www.didel.com/coursera/GererFichiers.pdf Gérer vos fichiers Arduino] et selon l'exemple du fichier volumineux [https://github.com/AIREL46/SCAO/blob/master/Arduino/e-p-wifi/e-p-wifi.ino e-p-wifi.ino], une organisation en plusieurs fichiers devient nécessaire. Le principe est de mettre les définitions, fonctions, modules dans des fichiers [https://en.wikipedia.org/wiki/Include_directive "header"] séparés, par exemple '''a.h''', et de l'appeler avec l'ordre :
 
<code>#include a.h</code>.
 
Le programme Arduino peuta être divisé en 5 paragraphes :
# Introduction
# Initiation des paramètres
# Fonctions spécifiques
# Fonction setup
# Fonction loop
Supposons que nous voulions organiser notre fichier .ino en 2 fichiers séparés, la procédure est la suivante :
* créer dans le même répertoire un nouveau fichier, par exemple a.h
* concernant les paragraphes 1, 2 et 3 :
** dans le fichier .ino sélectionner puis couper les lignes que vous souhaitez transférer dans le fichier a.h
** coller ces lignes dans le fichier a.h
** répéter l'opération pour chaque paragraphe
* au paragraphe 2 le déclarer par <code>#include a.h</code>
* concernant le paragraphe 4 setup :
** procéder au transfert des lignes de code comme précédemment (couper puis coller)
** dans le fichier .ino appeler le fonction <code>setup_a ();</code>
** dans le fichier a.h créer la fonction void setup_a () {lignes de code précédemment copier}
* concernant le paragraphe 5 loop limiter au strict minimum le nombre de lignes de code en appelant les fonctions spécifiques qui se trouvent au paragraphe 3.
===Arduino forum===
Avant d'utiliser le forum, il est prudent de prendre connaissance du [https://forum.arduino.cc/index.php?topic=148850.0 How to use Arduino forum].
 
Ce document comporte 16 rubriques, les 5 premières sont essentielles, elles sont rappeler ci-dessous :
* 1. Register and '''sign in''' (en français connection, tandis que '''sign out''' veut dire déconnexion)
* 2. Choose an appropriate forum section - '''Attention''' cette étape est '''indispensable''' pour avoir accès au '''New Topic button''' [5] qui permet l'édition d'une requête.
* 3. Choose the correct language
* 4. Do some research before posting
* 5. Click on the New Topic button
* 8. You can add attachments (images should be no more than a couple of hundred K bytes
* 9. You can insert images.
 
===Gestion de versions ===
Un [https://fr.wikipedia.org/wiki/Logiciel_de_gestion_de_versions logiciel de gestion de versions] est un logiciel qui permet de stocker un ensemble de fichiers en conservant la chronologie de toutes les modifications qui ont été effectuées dessus. Il permet notamment de retrouver les différentes versions d'un lot de fichiers connexes.
====Git et Git-hub====
Il en existe de nombreux, [https://fr.wikipedia.org/wiki/Git Git] est le logiciel créé par Linus Torvald, auteur du Kernel Linux. Il utilise des commandes comme commit, branches, merge... L'hébergement des fichiers sources s'effectue sur [https://fr.wikipedia.org/wiki/GitHub GitHub], ce qui permet de collaborer facilement sur des projets qui utilisent des logiciels libres.
 
La formation recommandée est [https://openclassrooms.com/courses/gerer-son-code-avec-git-et-github Gérer son code avec git et github sur Openclassroom].
 
Pour installer git taper dans un terminal :
* <code>sudo apt install git</code>
 
Pour créer une copie du projet SCAO en provenance du site github, taper dans un terminal la commande :
* <code>git clone https://github.com/AIREL46/SCAO</code>.
 
====Git-lfs====
Un message de warning est affiché :
 
'''File Plan-de-management/plan de management.odt is 53.71 MB; this is larger than GitHub's recommended maximum file size of 50.00 MB'''
 
La préconisation est :
 
'''You may want to try Git Large File Storage - https://git-lfs.github.com.'''
 
Après l'installation du paquet, lors de l'exécution de la commande :
 
*sudo git lfs install
 
une erreur survient :
 
/usr/local/bin/git-lfs: 1: /usr/local/bin/git-lfs: Syntax error: '''Unterminated quoted string'''
 
Malgré l'erreur, je teste :
*sudo git add Plan-de-management/plan-de-management.odt
*sudo git commit "Ajouter fichier > 50MO plan-de-management.odt"
*sudo git push origin master
 
Dans Github, je retouve le fichier avec les commentaires :
<big>View raw</big>
(Sorry about that, but we can’t show files that are this big right now.)
 
Je clique sur View raw, la fenêtre suivante s'ouvre :
[[fichier:Git-lfs-sup-50MO.png |thumb|center|upright=2 | Ouvrir en lecture seule un fichier de plus de 50MO]]
Si :
*je choisis ''Ouvrir avec LibreOffice Writer'', le fichier est visualisé.
*je choisis ''Enregistrer le fichier'', le fichier est téléchargé et disponible dans le répertoire '''Téléchargements'''.
 
Je fais le même test avec le fichier plan de management_old.doc qui n'a pas fait l'objet d'un nouveau "push", le résultat est le même.
Conclusion : les fichiers de plus de 50 MO sont mémorisés, par contre, ils sont visualisables qu'après un téléchargement. Donc, le paquet git-lfs n'est pas opérationnel.
 
Je laisse tomber git-lfs et j'en profite pour faire un peu de nettoyage.
 
Je supprime des fichiers inutiles, le premier :
 
Plan-de-management/plan de management.odt avec la commande :
*sudo git rm Plan-de-management/plan de management.odt
ça ne marche pas parce que Ubuntu n'aime pas les espaces, je contourne la difficulté avec :
*sudo git rm Plan-de-management/'''<big>"</big>'''plan de management.odt'''<big>"</big>'''
Les suivants :
*Plan-de-management/plan de management_old.doc
*BOINC/BOINC.odt.
 
====Synchronisation des 2 ordinateurs====
Pour les 2 ordinateurs, le fixe et le portable, l'objet est d'assurer la conformité des contenus de leur répertoire SCAO respectif selon la règle de [https://fr.wikipedia.org/wiki/Synchronisation_de_fichiers synchronisation de fichiers].
 
Une fois par semaine, sur l''''ordinateur fixe''', dans le répertoire SCAO :
* sudo git status
* En fonction du résultat, effectuer l'ajout des nouveaux fichiers et terminer par :
** sudo git commit -a, cette commande va ouvrir fichier SCAO/.git/COMMIT_EDITMSG, dans ce fichier indiquer la raison du commit
** ctrl x
** sauver l'espace modifié ? Oui
* sudo git push origin master
* sur l''''ordinateur portable''' :
** sudo git pull origin master.
 
===Compacter des fichiers avec la commande zip===
Pour regrouper le contenu d'un répertoire en vue de l'envoyer à un correspondant.
 
'''zip - package and compress (archive) files'''
 
Ouvrir un terminal et taper la commande (exemple) :
* zip quiet-cook.zip tp_quiet-cook
===Libraries===
En bon français, il faut dire [https://fr.wikipedia.org/wiki/Biblioth%C3%A8que_logicielle bibliothèque logicielle].
 
En anglais [https://en.wikipedia.org/wiki/Library_(computing) Library_(computing)].
 
Une bibliothèque logicielle est une collection de routines, qui peuvent être déjà compilées et prêtes à être utilisées par des programmes.
 
Pour éviter toute confusion linguistique, l'appellation utilisée par la suite sera celle issue de l'anglais : '''"library"'''.
 
Au fur et à mesure des besoins ces libraries, installées sur le disque dur de l'ordinateur, se multiplient.
 
Sur l'ordinateur fixe ASUS, ces libraries sont présentent dans les répertoires :
* /home/leruste/Téléchargements/teensy/avr/libraries
* /home/leruste/Téléchargements/arduino-1.6.9/libraries
* /root/Arduino/libraries.
====Installation des libraries====
La plupart des librairies se trouve sur le site github, un exemple :
 
la librarie [https://github.com/PaulStoffregen/Time '''Time''' publié par Paul Stoffregen].
 
Pour trouver une librarie sur le site github, il convient d'utiliser le [https://github.com moteur de recherche] à gauche du logo. En tapant "Chrono" on trouve :
 
[https://github.com/SofaPirate/Chrono Chrono publié par Sofian Audry and Thomas Ouellet Fredericks]
 
Pour installer ces libraries sur un ordinateur, dans notre exemple, sur l' '''ASUS''', [https://github.com Github] propose deux méthodes :
# le [https://fr.wikipedia.org/wiki/Clonage_(programmation) clonage]
# le [https://fr.wikipedia.org/wiki/Clonage_(programmation) téléchargement].
 
D'autre part, le répertoire privilégié par le compilateur de l'arduino IDE est :
 
'''/root/Arduino/libraries'''
 
Dans le cas du clonage et dans l'exemple de la library '''Chrono''', dans un terminal, tapez successivement :
* cd /root/Arduino/libraries
* Sudo git clone https://github.com/SofaPirate/Chrono
 
Dans le cas du téléchargement, sur le site Github, effectuer le téléchargement, sur l'ordinateur, il en résulte le fichier '''~Téléchargements/Chrono-master.zip''', 2 méthodes d'installation s'offrent à vous :
* Pour [https://www.arduino.cc/en/Guide/Libraries installer des nouvelles libraries sous l'Arduino IDE].
La copie d'écran ci-dessous donne l'exemple de la sélection du fichier '''Chrono-master.zip''' :
[[Fichier:librarie-download.png|vignette|centré|upright=2 | Sélection du fichier .zip]]
 
* Décompresser les fichiers puis les déplacer dans le répertoire /root/Arduino/libraries.
 
====Arduino Wrapper library====
J'ai rencontré pour la première fois cette terminologie de
[https://en.wikipedia.org/wiki/Wrapper_library "wrapper library"] en installant la librairie
[https://github.com/Overdrivr/Telemetry-arduino Telemetry Arduino].
 
===Pytelemetry Command Line Interface===
Le [https://github.com/Overdrivr/pytelemetrycli "Pytelemetry Command Line Interface"] est complémentaire de la fonction réalisée par [https://github.com/Overdrivr/Telemetry-arduino "Telemetry"].
 
Il permet, à partir de l'ordinateur, la réception des données envoyées par le microcontrôleur ainsi que leur visualisation.
Pour installer ce module, il faut disposer de :
* du langage de programmation [https://www.python.org/ Python] '''3.3''' + PyQt4 and numpy
* du [https://fr.wikipedia.org/wiki/Gestionnaire_de_paquets gestionnaire de paquets][https://pypi.org/project/pip/ pip] spécifique à [https://www.python.org/ Python].
* le paquet [https://pypi.org/project/pytelemetrycli/1.1.0/ Pytelemetry Command Line Interface]
Une installation de ce module a été entreprise, 2 problèmes ont été rencontrés :
* Ubuntu 16.04 LTS permet l'installation de python des versions '''2.7.x''' (2.7.12 sur l'ordinateur ASUS) mais pas au delà
* le [https://fr.wikipedia.org/wiki/Gestionnaire_de_paquets gestionnaire de paquets][https://pypi.org/project/pip/ pip] génère une erreur : cannot import name main.
 
'''Conclusion''' : ce module [https://github.com/Overdrivr/pytelemetrycli "Pytelemetry Command Line Interface"] semble avoir été développé pour le monde de Windows sans préoccupation de sa compatibilité au monde de Linux.
 
Néanmoins, cette expérience aura permis d'explorer le langage de programmation [https://www.python.org/ Python] qui semble être, en complément du langage BASH, un langage adapté pour développer des programmes dédiés au PC qui pourraient dialoguer avec le microcontrôleur.
==Les logiciels==
Le besoin initial est le [https://plantuml.com/fr/activity-diagram-legacy diagramme d'activité] pour :représenter les fonctions logicielles.
Les logiciels sont nombreux et le plus souvent payants. Dans le cadre de ce projet:* le site [https://www.predictiveanalyticstoday.com/open-source-free-unified-modeling-language-uml-tools/ 40 open source, je mfree and top UML tools] permet d'oriente vers :orienter le choix* [https://app.lucidchart.com/documents#/dashboard lucidchart]qui est un logiciel propriétaire et accessible en ligne. Attention, il est gratuit mais dès que vous avez besoin d'une fonctionnalité particulière, c'est payant, bravo !* une alternative est [https://plantuml.com/fr/ plantuml]. 
Ce logiciel est disponible sous la forme d'un fichier [https://fr.wikipedia.org/wiki/JAR_(format_de_fichier) .jar (java archive)] qu'il faut [https://plantuml.com/fr/download télécharger].
En complément, il faut installer [https://www.graphviz.org/download/ Graphviz] :
* <code>'''sudo apt install graphviz'''</code>
 
Une autre alternative est [https://fr.wikipedia.org/wiki/Dia_(logiciel) Dia (wikipedia)] accessible sur le site [https://wiki.gnome.org/Apps/Dia Dia]. Dia est un logiciel libre de création de diagramme développé en tant que partie du projet GNOME.
 
Dia fait appel à des bibliothèques de symboles spécifiques à de nombreux domaines. Ces domaines sont principalement : électricité, électronique, circuits logiques, logiciel (graphes de flux), réseau, ordinateur, téléphone, UML, etc...
===Le langage de programmation===
Ce programme permet de remplacer le moniteur série de l'Arduino IDE.
Il est documenté sur Pour installer le paquet minicom :* voir [https://doc.ubuntu-fr.org/minicom le wiki ubuntu.fr]. Pour initialiser le port ttyACM0 (par exemple) et éviter l'erreur ''"ne peut ouvrir /dev/modem"'' :* <code>'''sudo minicom -D /dev/ttyACM0 -b 9600'''</code>
Pour le configurer :
* $ sudo apt-get install openscad
Pour obtenir une '''<big>version plus récente d'openscad</big>''', à partir du site [https://www.openscad.org/downloads.html#linux openscad] choisir, dans le paragraphe, ''"Other Linux"'' le téléchargement de ''The [https://appimage.org/ AppImage package''], 2 versions selon l'architecture sont proposées, prendre la '''X86(64bits)'''. Puis récupérer le fichier dans le répertoire Téléchargements et enfin le rendre exécutable (voir la [https://doc.ubuntu-fr.org/tutoriel/script_shell documentation Ubuntu]).
Prenons l'exemple de l'installation de l'IDE arduino-1.8.8
**reboot
**lancement arduino.
====Installation de l'éditeur Atom====
* Sur le site [https://atom.io/ atom] télécharger atom.amd64.deb
* Extraire les fichiers
* Installer atom en suivant la procédure du [https://flight-manual.atom.io/getting-started/sections/installing-atom/ flight manual]
* lancer atom en ligne de commande.
===Les logiciels applicatifs===
En compléments :
*Les schémas de la documentation sont réalisées à l'aide du logiciel '''[https://inkscape.org/fr/ Inkscape]''', qui fait l'objet de 2 sous-paragraphes (ci-dessous) :* le premier donne un exemple de son utilisation est traité ci-dessous* le second aborde les particularités des opérations booléene.
*La retouche des photos et les animations sont réalisés à l'aide du logiciel '''[https://www.gimp.org/ Gimp]''', par exemple pour réduire la taille du fichier d'une photo suivre la procédure :
**Lancer GIMP puis ouvrir le fichier .JPG et sélectionner le menu image,
** fichier - export - Export as PDF (ne pas utiliser "as image" car la qualité est mauvaise)
* inkscape : voir a)
====Inkscape - Opérations booléennes====
Les opérations booléennes (union, différence, intersection, exclusion et division) sont expliquées par un [http://write.flossmanuals.net/start-with-inkscape/boolean-operations/ tutoriel]. Elles sont accessibles à l'aide du menu '''"chemin (path)"'''.
 
Leur utilisation est délicate et demande une préparation correcte des 2 objets qui vont faire l'objet de l'opération booléenne. Dans le cas de l'opération différence, elle est effectuée selon le principe '''"dessous moins dessus"''' :
* le dessous est aussi appelé l'arrière plan
* le dessus est aussi appelé le premier plan.
Pour pouvoir gérer ces 2 plans sans ambiguïté, il est préférable de prévoir deux calques différents, chaque objet ayant son propre calque. Ainsi, il est possible à partir du menu '''"calque"''' de gérer le positionnement de l'objet :
* calque au premier plan
* calque à l'arrière plan.
Avant d'appliquer l'opération booléennes, il faut sélectionné les deux objet à l'aide d'une fenêtre.
===Les captures d'écran===
* '''impr-écr''' : copie de l'écran entier
* '''alt+impr-écr''' : copie de la fenêtre active
* '''ctrl+maj+impr''' : initie une capture d'une zone rectangulaire à tracer.
Pour plus de détails utiliser le lien [https://doc.ubuntu-fr.org/capture_d_ecran capture d'écran].
 
===Raccourcis clavier personnalisés===
Pour créer vos propres raccourcis clavier :
===Logiciel de téléassistance et réunions en ligne===
[https://www.teamviewer.com/fr/ Team Viewer]
===L'environnement de développement===
L'[https://fr.wikipedia.org/wiki/Environnement_de_d%C3%A9veloppement environnement de développement] '''« intégré »''' (abrégé EDI en français ou [https://en.wikipedia.org/wiki/Integrated_development_environment IDE] en anglais, pour '''integrated development environment'''). Cet [https://en.wikipedia.org/wiki/Integrated_development_environment IDE] peut être réalisé à partir soit de :
* l'[https://blog.arduino.cc/?ie=UTF-8&oe=UTF-8&s=IDE&domains=&sitesearch= arduino IDE]
* l'[https://blog.arduino.cc/2020/03/13/arduino-cli-an-introduction/ arduino CLI] qui offre la possibilité d'utiliser l'éditeur de son choix, celui d'Eclipse en particulier. Après son [https://arduino.github.io/arduino-cli/latest/installation/ installation], voir le :
** [https://arduino.github.io/arduino-cli/ la documentation]
** [https://github.com/arduino/arduino-cli github]
** [https://arduino.github.io/arduino-cli/getting-started/ getting started].
* [https://fr.wikipedia.org/wiki/Eclipse_(projet) Eclipse].
 
===Les plateformes===
Dans le contexte de cet atelier logiciel, les [https://fr.wikipedia.org/wiki/Plate-forme_(informatique) plateformes] sont des [https://fr.wikipedia.org/wiki/Environnement_de_d%C3%A9veloppement environnements de développement] '''« intégré »''' (abrégé EDI en français ou [https://en.wikipedia.org/wiki/Integrated_development_environment IDE] en anglais, pour '''integrated development environment''').
 
Une plateforme est généralement constituée d'un ordinateur et d'un [https://fr.wikipedia.org/wiki/Microcontr%C3%B4leur microcontrôleur] raccordé par un câble USB.
 
Le [https://fr.wikipedia.org/wiki/D%C3%A9veloppement_de_logiciel développement du logiciel] dédié au [https://fr.wikipedia.org/wiki/Microcontr%C3%B4leur microcontrôleur] se réalise selon les phases suivantes :
* au sein de l'[https://en.wikipedia.org/wiki/Integrated_development_environment IDE] installé sur l'ordinateur :
** saisie du programme
** vérification
** téléversement de l'ordinateur vers le [https://fr.wikipedia.org/wiki/Microcontr%C3%B4leur microcontrôleur]
* au sein du [https://fr.wikipedia.org/wiki/Microcontr%C3%B4leur microcontrôleur] exécution du programme.
Les phases décrites ci-dessus peuvent être exécutées autant de fois que nécessaire jusqu'à obtention du fonctionnement souhaité.
 
A partir du moment où le câble USB est déconnecté, le [https://fr.wikipedia.org/wiki/Microcontr%C3%B4leur microcontrôleur], si son alimentation est autonome (batterie), va exécuter en permanence le dernier programme téléversé.
 
====Plateformes Arduino et Teensy====
Les deux plateformes sont constituées à partir du même ordinateur complété, soit d'un [https://fr.wikipedia.org/wiki/Microcontr%C3%B4leur microcontrôleur] de la famille [https://fr.wikipedia.org/wiki/Arduino Arduino], soit d'un [https://fr.wikipedia.org/wiki/Microcontr%C3%B4leur microcontrôleur] [https://www.pjrc.com/teensy/ Teensy]. Les deux plateformes utilisent le même [https://en.wikipedia.org/wiki/Integrated_development_environment IDE].
L'[https://en.wikipedia.org/wiki/Integrated_development_environment IDE] est :
* soit l'Arduino web editor (disponible uniquement pour Linux 64 bits en date du 14/03/2018)
* soit l'Arduino IDE (Linux '''32 bits''' et 64 bits)
les deux sont accessibles par ce [https://www.arduino.cc/en/Main/Software lien].
 
La [http://playground.arduino.cc/uploads/Main/arduino_notebook_v1-1.pdf documentation].
 
Dans le cas du [https://www.pjrc.com/teensy/ Teensy], il est complété de [https://en.m.wikipedia.org/wiki/Library_(computing) librairies spécifiques].
 
Prenons l'exemple de l'installation de l'IDE arduino-1.8.8
*sur le site arduino, télécharger l’archive arduino-1.8.8-linux64.tar.xz
*la décompresser puis installer avec les commandes :
**tar Jxvf arduino-1.8.8-linux64.tar.xz
**./arduino-1.8.8-linux-setup.sh $USER
**reboot
**lancement arduino.
 
====Plateforme Microchip====
Elle est traitée en un projet séparé accessible par le lien [http://fablabo.net/wiki/PIC PIC].
 
===Organisation des fichiers Arduino===
En référence à l'article [http://www.didel.com/coursera/GererFichiers.pdf Gérer vos fichiers Arduino] et selon l'exemple du fichier volumineux [https://github.com/AIREL46/SCAO/blob/master/Arduino/e-p-wifi/e-p-wifi.ino e-p-wifi.ino], une organisation en plusieurs fichiers devient nécessaire. Le principe est de mettre les définitions, fonctions, modules dans des fichiers [https://en.wikipedia.org/wiki/Include_directive "header"] séparés, par exemple '''a.h''', et de l'appeler avec l'ordre :
 
<code>#include a.h</code>.
 
Le programme Arduino peuta être divisé en 5 paragraphes :
# Introduction
# Initiation des paramètres
# Fonctions spécifiques
# Fonction setup
# Fonction loop
Supposons que nous voulions organiser notre fichier .ino en 2 fichiers séparés, la procédure est la suivante :
* créer dans le même répertoire un nouveau fichier, par exemple a.h
* concernant les paragraphes 1, 2 et 3 :
** dans le fichier .ino sélectionner puis couper les lignes que vous souhaitez transférer dans le fichier a.h
** coller ces lignes dans le fichier a.h
** répéter l'opération pour chaque paragraphe
* au paragraphe 2 le déclarer par <code>#include a.h</code>
* concernant le paragraphe 4 setup :
** procéder au transfert des lignes de code comme précédemment (couper puis coller)
** dans le fichier .ino appeler le fonction <code>setup_a ();</code>
** dans le fichier a.h créer la fonction void setup_a () {lignes de code précédemment copier}
* concernant le paragraphe 5 loop limiter au strict minimum le nombre de lignes de code en appelant les fonctions spécifiques qui se trouvent au paragraphe 3.
 
===Gestion de versions ===
Un [https://fr.wikipedia.org/wiki/Logiciel_de_gestion_de_versions logiciel de gestion de versions] est un logiciel qui permet de stocker un ensemble de fichiers en conservant la chronologie de toutes les modifications qui ont été effectuées dessus. Il permet notamment de retrouver les différentes versions d'un lot de fichiers connexes.
====Git et Git-hub====
Il en existe de nombreux, [https://fr.wikipedia.org/wiki/Git Git] est le logiciel créé par Linus Torvald, auteur du Kernel Linux. Il utilise des commandes comme commit, branches, merge... L'hébergement des fichiers sources s'effectue sur [https://fr.wikipedia.org/wiki/GitHub GitHub], ce qui permet de collaborer facilement sur des projets qui utilisent des logiciels libres.
 
La formation recommandée est [https://openclassrooms.com/courses/gerer-son-code-avec-git-et-github Gérer son code avec git et github sur Openclassroom].
 
Pour installer git taper dans un terminal :
* <code>sudo apt install git</code>
 
Pour créer une copie du projet SCAO en provenance du site github, taper dans un terminal la commande :
* <code>git clone https://github.com/AIREL46/SCAO</code>.
 
====Git-lfs====
Un message de warning est affiché :
 
'''File Plan-de-management/plan de management.odt is 53.71 MB; this is larger than GitHub's recommended maximum file size of 50.00 MB'''
 
La préconisation est :
 
'''You may want to try Git Large File Storage - https://git-lfs.github.com.'''
 
Après l'installation du paquet, lors de l'exécution de la commande :
 
*sudo git lfs install
 
une erreur survient :
 
/usr/local/bin/git-lfs: 1: /usr/local/bin/git-lfs: Syntax error: '''Unterminated quoted string'''
 
Malgré l'erreur, je teste :
*sudo git add Plan-de-management/plan-de-management.odt
*sudo git commit "Ajouter fichier > 50MO plan-de-management.odt"
*sudo git push origin master
 
Dans Github, je retouve le fichier avec les commentaires :
<big>View raw</big>
(Sorry about that, but we can’t show files that are this big right now.)
 
Je clique sur View raw, la fenêtre suivante s'ouvre :
[[fichier:Git-lfs-sup-50MO.png |thumb|center|upright=2 | Ouvrir en lecture seule un fichier de plus de 50MO]]
Si :
*je choisis ''Ouvrir avec LibreOffice Writer'', le fichier est visualisé.
*je choisis ''Enregistrer le fichier'', le fichier est téléchargé et disponible dans le répertoire '''Téléchargements'''.
 
Je fais le même test avec le fichier plan de management_old.doc qui n'a pas fait l'objet d'un nouveau "push", le résultat est le même.
Conclusion : les fichiers de plus de 50 MO sont mémorisés, par contre, ils sont visualisables qu'après un téléchargement. Donc, le paquet git-lfs n'est pas opérationnel.
 
Je laisse tomber git-lfs et j'en profite pour faire un peu de nettoyage.
 
Je supprime des fichiers inutiles, le premier :
 
Plan-de-management/plan de management.odt avec la commande :
*sudo git rm Plan-de-management/plan de management.odt
ça ne marche pas parce que Ubuntu n'aime pas les espaces, je contourne la difficulté avec :
*sudo git rm Plan-de-management/'''<big>"</big>'''plan de management.odt'''<big>"</big>'''
Les suivants :
*Plan-de-management/plan de management_old.doc
*BOINC/BOINC.odt.
 
====Synchronisation des 2 ordinateurs====
Pour les 2 ordinateurs, le fixe et le portable, l'objet est d'assurer la conformité des contenus de leur répertoire SCAO respectif selon la règle de [https://fr.wikipedia.org/wiki/Synchronisation_de_fichiers synchronisation de fichiers].
 
Une fois par semaine, sur l''''ordinateur fixe''', dans le répertoire SCAO :
* sudo git status
* En fonction du résultat, effectuer l'ajout des nouveaux fichiers et terminer par :
** sudo git commit -a, cette commande va ouvrir fichier SCAO/.git/COMMIT_EDITMSG, dans ce fichier indiquer la raison du commit
** ctrl x
** sauver l'espace modifié ? Oui
* sudo git push origin master
* sur l''''ordinateur portable''' :
** sudo git pull origin master.
 
===Compacter des fichiers avec la commande zip===
Pour regrouper le contenu d'un répertoire en vue de l'envoyer à un correspondant.
 
'''zip - package and compress (archive) files'''
 
Ouvrir un terminal et taper la commande (exemple) :
* zip quiet-cook.zip tp_quiet-cook
===Libraries===
En bon français, il faut dire [https://fr.wikipedia.org/wiki/Biblioth%C3%A8que_logicielle bibliothèque logicielle].
 
En anglais [https://en.wikipedia.org/wiki/Library_(computing) Library_(computing)].
 
Une bibliothèque logicielle est une collection de routines, qui peuvent être déjà compilées et prêtes à être utilisées par des programmes.
 
Pour éviter toute confusion linguistique, l'appellation utilisée par la suite sera celle issue de l'anglais : '''"library"'''.
 
Au fur et à mesure des besoins ces libraries, installées sur le disque dur de l'ordinateur, se multiplient.
 
Sur l'ordinateur fixe ASUS, ces libraries sont présentent dans les répertoires :
* /home/leruste/Téléchargements/teensy/avr/libraries
* /home/leruste/Téléchargements/arduino-1.6.9/libraries
* /root/Arduino/libraries.
====Installation des libraries====
La plupart des librairies se trouve sur le site github, un exemple :
 
la librarie [https://github.com/PaulStoffregen/Time '''Time''' publié par Paul Stoffregen].
 
Pour trouver une librarie sur le site github, il convient d'utiliser le [https://github.com moteur de recherche] à gauche du logo. En tapant "Chrono" on trouve :
 
[https://github.com/SofaPirate/Chrono Chrono publié par Sofian Audry and Thomas Ouellet Fredericks]
 
Pour installer ces libraries sur un ordinateur, dans notre exemple, sur l' '''ASUS''', [https://github.com Github] propose deux méthodes :
# le [https://fr.wikipedia.org/wiki/Clonage_(programmation) clonage]
# le [https://fr.wikipedia.org/wiki/Clonage_(programmation) téléchargement].
 
D'autre part, le répertoire privilégié par le compilateur de l'arduino IDE est :
 
'''/root/Arduino/libraries'''
 
Dans le cas du clonage et dans l'exemple de la library '''Chrono''', dans un terminal, tapez successivement :
* cd /root/Arduino/libraries
* Sudo git clone https://github.com/SofaPirate/Chrono
 
Dans le cas du téléchargement, sur le site Github, effectuer le téléchargement, sur l'ordinateur, il en résulte le fichier '''~Téléchargements/Chrono-master.zip''', 2 méthodes d'installation s'offrent à vous :
* Pour [https://www.arduino.cc/en/Guide/Libraries installer des nouvelles libraries sous l'Arduino IDE].
La copie d'écran ci-dessous donne l'exemple de la sélection du fichier '''Chrono-master.zip''' :
[[Fichier:librarie-download.png|vignette|centré|upright=2 | Sélection du fichier .zip]]
 
* Décompresser les fichiers puis les déplacer dans le répertoire /root/Arduino/libraries.
 
====Arduino Wrapper library====
J'ai rencontré pour la première fois cette terminologie de
[https://en.wikipedia.org/wiki/Wrapper_library "wrapper library"] en installant la librairie
[https://github.com/Overdrivr/Telemetry-arduino Telemetry Arduino].
 
===Pytelemetry Command Line Interface===
Le [https://github.com/Overdrivr/pytelemetrycli "Pytelemetry Command Line Interface"] est complémentaire de la fonction réalisée par [https://github.com/Overdrivr/Telemetry-arduino "Telemetry"].
 
Il permet, à partir de l'ordinateur, la réception des données envoyées par le microcontrôleur ainsi que leur visualisation.
Pour installer ce module, il faut disposer de :
* du langage de programmation [https://www.python.org/ Python] '''3.3''' + PyQt4 and numpy
* du [https://fr.wikipedia.org/wiki/Gestionnaire_de_paquets gestionnaire de paquets][https://pypi.org/project/pip/ pip] spécifique à [https://www.python.org/ Python].
* le paquet [https://pypi.org/project/pytelemetrycli/1.1.0/ Pytelemetry Command Line Interface]
Une installation de ce module a été entreprise, 2 problèmes ont été rencontrés :
* Ubuntu 16.04 LTS permet l'installation de python des versions '''2.7.x''' (2.7.12 sur l'ordinateur ASUS) mais pas au delà
* le [https://fr.wikipedia.org/wiki/Gestionnaire_de_paquets gestionnaire de paquets][https://pypi.org/project/pip/ pip] génère une erreur : cannot import name main.
 
'''Conclusion''' : ce module [https://github.com/Overdrivr/pytelemetrycli "Pytelemetry Command Line Interface"] semble avoir été développé pour le monde de Windows sans préoccupation de sa compatibilité au monde de Linux.
 
Néanmoins, cette expérience aura permis d'explorer le langage de programmation [https://www.python.org/ Python] qui semble être, en complément du langage BASH, un langage adapté pour développer des programmes dédiés au PC qui pourraient dialoguer avec le microcontrôleur.
=== Iphone 5 ===
Voir le paragraphe "matériel" pour les généralités.
1 991
modifications

Menu de navigation