Polytech CAO

h1. Ressources Proteus

{{toc}}

h2. Gestion des versions des librairies

Les librairies de Proteus sont versionnées. Un serveur centralise et conserve l'ensemble des librairies, il conserve aussi un historique des modifications.

La gestion des versions est assurée par SVN. La gestion des versions est effectuée en utilisant des scripts clients, spécifiques à quelques client Svn tel que Tortoise Svn.

bq. *Les détails données ici imposent que "tortoise Svn soit intallé":http://tortoisesvn.net/downloads.html sur la machine de l'utilisateur.*

L'adresse du dépot est : https://forge.clermont-universite.fr/svn/cao/trunk/proteus

bq. *Un librairie est constitué d'un couple [fichier.LIB / répertoire] le fichier et le répertoire doivent avoir le meme non. Les deux doivent IMPÉRATIVEMENT être envoyé au serveur en même temps.*

h2. Mise en place des librairies

Lors de la première utilisation des librairies il faut copier celles ci sur la machine locale et assurer le lien avec le Dépôt.

Choisir un répertoire ou les librairies seront installées par exemple _c:\users\ge\cao_

Note: Sur les machines de travaux pratiques de Cao les librairies sont installées dans _e:\CAO\proteus\_ 

Avec le menu contextuel (bouton droit de la souris) choisir SVN CheckOut pour "descendre" une copie de travail des librairies depuis le serveur.

L'adresse du repository (dépôt) étant : *https://forge.clermont-universite.fr/svn/cao/trunk/proteus*, choisissez +proteus+ comme répertoire local.

Vous avez alors sur votre machine la dernière version des librairies.

Les librairies doivent être dans un état "normal" c'est a dire non modifiées par rapport au serveur. Les icônes sont donc toutes vertes.

h2. Configuration de Proteus

Dans Système -> Réglages Systèmes

* Ajouter _c:\users\ge\cao\Proteus\Librairies\Template_ à la liste des Dossiers de Gabarits

* Ajouter _c;\users\ge\cao\Proteus\Librairies_ à la liste des Dossiers Bibliothèques

Dans l'onglet Réglage du Simulateur

* Ajouter _c:\users\ge\CAO\Proteus\Librairies\Models_ à la liste des chemins des Modules et Modèles de Simulation

h2. Librairie de Travail Enseignants et étudiants

Vous pouvez dès lors travailler. Attention cependant à sauvegarder vos composants et empreintes dans la bonne librairie.

* Librairie etudiant_sch/pcb.LIB : Librairie versionnée et destinée aux étudiants. Attention à ne pas modifier les composants de vos collègues et à ne pas faire de modifications qui risqueraient de compromettre les cartes d'autres utilisateurs.

* Librairie ge_sch/pcb.LIB : Librairie de référence de l'école. Les composants dans cette librairie sont fiables et ont étés validés. Aucune modification ne doit être apportée à cette librairie sans validation.

* Librairies nominatives_sch/pcb.LIB : Equivalent de la librairie etudiant mais spécifique à un enseignant, ou un utilisateur particulier. Ne pas toucher au contenu de ces librairies sauf avec l'aval du propriétaire.

h2. Librairies de Test, Librairies Locales

Il est possible de créer de nouvelles librairies locales avec l'outil Proteus. 

Pour créer une bibliothèque Dans le Menu Bibliothèque -> Gestionnaire de Bibliothèques -> Create Library

Attention a bien créer votre librairie dans le bon répertoire _c:\users\cao\proteus\Librairies_ par exemple.

Attention tant que la librairie n'a pas été ajouté au système de contrôle de version, elle ne sera pas versionnée et n'existera que sur la machine ou elle a été crée. 

Si le contenu de la librairie devient indispensable il faudra:

- Copier son contenu dans la librairie etudiant / ge / ...

- Demander la prise en compte de cette librairie par le système de versionnage (add / ajout dans tortoise svn).

bq. *Dans la mesure du possible essayez de travailler dans la librairie etudiants_sch/pcb.LIB*

Les composants crées et corrects seront ensuite déplacés dans la librairie ge_sch.lib et ge_pcb.lib par un enseignant, si et seulement si le composant a été correctement validé.

h2. Librairie de Travail Etudiants

Les étudiants travaillent en priorité sur la librairie _etudiants_sch.lib_ et _etudiants_pcb.lib_.

> Attention lors de la création d'un symbole, d'un boîtier, ou d'un package à bien sauvegarder dans la bonne librairie (etudiands_sch/pcb.LIB), en général le choix par défaut n'est pas le bon.

h2. Mise a jour des librairies

Après la mise en place, des modifications et des corrections peuvent être apportées sur le serveur. 

Pour mettre à jour votre copie locale de librairies utilisez la commande update (mise à jour) de tortoise SVN.

Cette opération ne peut être effectuée que si Proteus est complètement fermé.

> Un script de décomposition et un script de reconstruction seront exécutés lors de cette opération. Une boite de dialogue risque d’apparaître. Autorisez l’exécution de ces deux scripts.

Il faut réaliser cette opération régulièrement ( en début de séance), ou bien dès qu'une modification importante a été faite.

Attention si un composant sur lequel vous avez travaillé a dans la même période été modifié sur le serveur, il y aura un conflit. Le format des fichiers Proteus ne permet pas la résolution du conflit.

Il faudra alors perdre vos modifications locales (resolve using theirs), et les appliquer de nouveau sur le composant mis à jour. Ceci ne devrait pas se produire souvent si les librairies locales sont mis à jour régulièrement.

h2. Prise en compte de vos modifications

Lorsque qu'un composant a été modifié, crée ou supprimé, il faut mettre à jour le serveur.

Les librairies modifiés sont marquées en rouge par tortoise SVN.

Normalement seule la librairie etudiants et eventuellement vos librairies personnelles devraient être modifiées. Si ce n'est pas le cas se reporter à l'annulation de modifications.

Pour cela utiliser la fonction commit (livrer) de tortoise SVN. Cette opération est cependant un peu complexe.

> Un script de décomposition et un script de reconstruction seront exécutés lors de cette opération. Une boite de dialogue risque d’apparaître. Autorisez l’exécution de ces deux scripts.

Si lors d'une opération de Commit, seul le fichier .LIB ou seul le repertoire apparait, ne pas continuer l'operation.

ATTENTION: Lors d'un commit vous modifiez les fichiers sur le Serveur, TOUT les utilisateurs seront impactés par vos modifications. Faites donc extrèment attention lors d'un Commit:

# Vérifiez que les fichiers proposés par l’outil sont bien ceux que vous avez modifié,

# Si d'autres fichiers apparaissent dé sélectionnez les,

# Chaque Commit doit contenir un commentaire, expliquant succinctement quelles modifications vous avez fait et pourquoi

# Chaque Commit doit être élémentaire. Si vous avez fait de nombreuses modifications essayez de faire un commit à chaque fin de modification.

h2. Annulation de modifications

Si des modifications apparaissent par erreur sur les librairies / fichiers, il est possible de les annuler.

ATTENTION: Cette annulation entraînera la perte de tout travail effectué sur le fichier ! Il peut être judicieux de faire une sauvegarde du fichier à titre conservatoire.

Avec tortoise svn utiliser l'option REVERT pour annuler les modifications. Pour les librairies Proteus l'operation REVERT doit forcement être faite en même temps sur la librairie et sur le répertoire.

h3. Modèles 3D

Pour ajouter un modèle 3D à un Composant.

Chercher sur internet le modèle, il existe quelques site regroupant de nombreux modèles 3D:

* http://www.tracepartsonline.net/

* http://www.3dcontentcentral.com/

Des sites de ventes qui proposent les modèles à télécharger:

* http://katalog.we-online.de/en/

* RadioSpare

* Farnell

Sauver le composant dans le format *stl* si possible, sinon *iges* ou *step*, mais il faudra le convertir.

Pour convertir un modèle Iges/Stp en Stl utiliser "FreeCad":http://sourceforge.net/projects/free-cad/.

Pour convertir le modèle stl en 3ds utiliser "Blender":http://www.blender.org/download/get-blender/

* Importer le modèle stl dans Blender,

* Faire les rotation nécessaire pour que le modèle se présente axe Z vertical,

* L’échelle est en millimètre. Une distance de 1 est égale à 1mm,

* Positionner la broche 1 sur l'origine. 

** Dans le symbole Ares, Placer l'origine du composant sur la broche 1.

* En Z positionner la base du composant (hors broches) sur l'origine,

* Pour Ajouter des couleurs, utiliser l'onglet matériaux. Créer autant de matériaux que nécessaire et les affecter aux faces correspondantes,

* Donner un nom à l'objet qui corresponde à la représentation,

* Sauvegarder le fichier blender dans le répertoire fichiers blender, (_c:\users\ge\cao\proteus\3D\blender_")

* exporter au format 3d dans le répertoire 3D des librairies (_c:\users\ge\cao\proteus\3D\blender_")

> Un seul  fichier peut contenir plusieurs modèles 3D. Tous les modèles doivent être aligné avec l'origine. Pour travailler avec un modèle particulier cacher les autres (touche 'H'), ne pas oublier de les rendre visibles avant la sauvegarde et l'export (Ctrl + 'H').

Sous Ares:

* Sélectionner l'emprunte et dans le menu contextuel choisir créer package,

* Dans l'onglet 3D entrer:

@Type=Model

File=fichier.3ds

Name=objet@

avec :

@File= nom du fichier 3ds exporté avec l'extension, par exemple File=omron.3ds

Name= nom de l'objet dans le fichier. par exemple Name=b3f

Optionnel:

Scale= 1mm, 1in pour changer l’échelle

Angle= 90 pour faire une rotation

X=0.78

Y=0.34

@

h3. Fin de projet / carte / travaux

Il faut impérativement penser à nettoyer la librairie etudiant en fin de projet. Penser à corriger les erreurs rencontrées dans vos composants pour éviter que la même erreur apparaissent de nouveau.

Si certains composants sont validés, vous pouvez demander à ce qu'ils soient placés dans la librairie ge_sch/pcb.LIB, ceci est un honneur ! Pensez à renseigner votre nom dans les proprités du composant, les générations d’étudiants vous en seront reconnaissantes !

[[Proteus Archive1]]