Documentation POB-TOOLS
Transcription
Documentation POB-TOOLS
Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS ! "## $ % () * + ,- . ( #- # ' / & ' &' # ' # Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS 5 5 5 .* * .* * 8 . 9: + 6 * + /0 1 0 0 ) /0 1 0 0 ) 7 (8 & & ! " 5 5 5 5 5 5 " 7 6 # : * /0 1 0 0 ) + * + ; 6 .* +< 6 2 .+ * . 4 * * 2 4 * * , ,# ,, , /0 1 ) = ,' $ # % & ' ( ) 5 5 5 5 > > > > 6 6 6 6 , ' # ', ', '' '' ! )) /0 1 23 2 *. . 4 + / 2 2 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS Gestion du document Nom de fichier Date de création Auteur Modification / ? .@ ( + ' A A' & 1 * .* 1 . , * 4 . ' /0 1 0 0 ) 4# , A,'A' & Contacter POB-Technology Adresse Adresse mail Téléphone Fax POB-TECHNOLOGY 4, rue nicéphore Niépce 69 680 CHASSIEU, FRANCE * *B ? * 23 6 +33 (0)4 72 43 02 36 +33 (0)4 72 66 18 99 /0 1 23 2 *. . 4 + / 2 3 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS 1 Introduction POB-TOOLS est un outil pour programmer, charger et débuguer le module POB-EYE. Vous pouvez créer un dictionnaire de forme, créer des images pour le POB-LCD128, gérer un projet, compiler votre code source C et flasher votre application dans le POB-EYE. /0 1 23 2 *. . 4 + / 2 4 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS 2 Installer POB-TOOLS Sur le CD livré avec le module POB-EYE, vous trouverez deux fichiers. Installation du compilateur GNUARM Le premier fichier « bu-2.15_gcc-3.4.1-c-c++-java_nl-1.12.0_gi-6.0.exe » est le compilateur. L’outil POB-TOOLS utilise le compilateur GNUARM pour créer votre application. Pour installer GNUARM, cliquez sur ce fichier. *+ *+ ,- .+/- , 0 67 /0 1 - ) - 1 / ,/ .+ 1 * / 1 2 31 * / 1 1 4 .8,9- 11 - , - 7- ,9 1 * / 11 9 31 99 : - +- / /; 23 2 *. . 4 + 5 5 / 2 5 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS *+ ) ,+ 6 - 7- ,9 2 6/ /; : 8 *+ /0 1 - . 9<- 7 / ,8 - 1 99 = ,9- 11 >*? , 9$ 69+ 6 . 18,9- 11 - , - .64+- . 18,9- 11 - , 23 2 *. . 4 + / 2 6 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS Installation de POB-TOOLS Cliquez sur "pobtools_setup.exe" pour lancer l' installation de POB-Tools. Suivez les instructions pour installer POB-Tools sur votre ordinateur. Mise à jour POB-TOOLS Vous pouvez trouver des mises à jour de l' outil POB-TOOLS dans la section " Téléchargement " du site www.pob-technology.com. /0 1 23 2 *. . 4 + / 2 7 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS 3 Configurer Lors du premier lancement de l' outil POB-TOOLS, il faut configurer le logiciel pour un fonctionnement optimal. - Sélectionnez le répertoire par défaut où vos projets seront crées. - Sélectionnez le chemin vers le compilateur GNUARM. Si vous avez installé GNUARM avec les paramètres par défaut, le chemin est : C:\Program Files\GNUARM\bin. - Choisissez le port série de votre ordinateur sur lequel le POB-EYE est connecté. - Sélectionnez la langue de l’interface. - Activez l’aide contextuelle (ou non). /0 1 23 2 *. . 4 + / 2 8 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS 4 Développer avec le POB-TOOLS Gérer un projet POB-TOOLS Le bouton « Nouveau » permet de créer un nouveau projet (extension .pobtools). Remarque : Si vous sélectionnez un projet existant, le contenu de ce projet sera perdu. - Le bouton « Ouvrir » permet d’ouvrir un projet. Le bouton « Enregistrer » permet de sauvegarder votre travail en cours dans le projet. Le bouton « Enregistrer sous… » permet d’enregistrer votre travail dans un nouveau projet. /0 1 23 2 *. . 4 + / 2 9 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS Créer un dictionnaire de forme POB-Pattern permet de créer un dictionnaire de formes. Ce dictionnaire permet de retrouver des formes dans une image capturée par POB-EYE. POB-Pattern va générer un fichier à inclure dans votre code par la commande " #include nom_fichier.h ". Ce fichier " .h " contient le tableau des formes reconnues par le module POBEYE. Le principe de ce fichier est le même que celui du POB-Bitmap. La reconnaissance de forme est ensuite effectué à l' aide des fonctions de la librairie fournit avec l' outil POB-TOOLS. La reconnaissance de forme s' effectue à l' aide de la fonction « IdentifyForm ». Cette fonction utilise l' image de la caméra et le dictionnaire de formes pour reconnaître une image. La fonction remplit un tableau des différentes formes reconnues dans l' image et retourne le nombre de formes reconnues. Pour plus de clarté dans votre code, vous pouvez utiliser les " #define " du fichier " .h " au lieu de numéro pour identifier les formes reconnues. Dans l' exemple précédent, la forme 3 devient IDP_TRIANGLE. /0 1 23 2 *. . 4 + / 2 10 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS La création du dictionnaire de formes s' effectue en quatre étapes : 1 – Ouvrir la fenêtre POB-Pattern. 2 – Nommer le dictionnaire : Sélectionner un nouveau dictionnaire de formes. 3 – Sélectionner les fichiers bitmap à ajouter. 4 – Créer le dictionnaire de forme. Remarque : Les images ajoutées doivent respecter le format suivant : Bitmap 256 couleurs, d’une taille de 100 par 100 pixels. Les formes doivent être noir sur fond rouge. /0 1 23 2 *. . 4 + / 2 11 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS Pour obtenir un dictionnaire correct, il faut respecter les conditions suivantes : - La forme doit prendre le maximum de place dans le cadre de 100 par 100 pixels. Le dessin n'est pas assez étendu - La place est totalement utilisée La forme doit éviter les petits détails. Détail trop petit - Le détail est assez grand La forme ne doit avoir aucun vide. La forme a un vide! /0 1 La forme n’a pas de vide 23 2 *. . 4 + / 2 12 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS Créer une liste d’image pour le POB-LCD128 L’onglet POB-Bitmap génère des ressources graphiques pour POB-LCD128 (l' écran LCD vendu par POB-Technology). POB-LCD128 permet, par exemple, de visualiser en temps réel ce que voit la caméra ou de créer une interface graphique. POB-Bitmap va générer un fichier à inclure dans votre code par la commande « #include nom_de_votre_fichier.h ». Ce fichier « .h » contient un tableau d’images, dans lequel l’utilisateur vient chercher les bitmaps dont il a besoin pour son affichage. Les ressources graphiques sont affichées dans votre application à l' aide de la librairie, incluse dans l' outil de compilation POB-COMPILER. Les fonctions graphiques de cette librairie permettent de gérer la transparence des images et de réaliser la superposition d' image sur l' écran LCD. Les images sont affichées à l' aide de la fonction " DrawBitmap " : Cette fonction utilise un numéro pour afficher l' image voulue. Pour plus de clarté dans votre code, POB-Bitmap génère dans le " .h " une série de " #define " à partir du nom des images. L' appel à "DrawBimap" peut ainsi devenir (si le nom du fichier est cross.bmp) : DrawBitmap(X, Y, IDB_CROSS, Tableau); DrawBitmap(X, Y, 1, Tableau); /0 1 23 2 *. . 4 + / 2 13 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS La génération du fichier " .h " se déroule en quatre étapes. 1 – Ouvrir la fenêtre POB-Bitmap. 2 – Nommer la liste d’images (extension .h) 3 – Ajouter des images bitmaps. Remarque : Les images ajoutées doivent respecter le format suivant : Bitmap 256 couleurs, d' une taille maximum de 256 par 256 pixels. POB-Bitmap utilise trois couleurs pour gérer l' affichage des ressources graphiques : Noir : un pixel noir est affiché sur l' écran LCD. Blanc : un pixel blanc est affiché sur l' écran LCD. Vert (Rouge 0, Vert 255, Bleu 0) : couleur de transparence (cela permet de superposer des images). /0 1 23 2 *. . 4 + / 2 14 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS 4 – Créer le fichier d’images. A propos de la transparence Définition de la couleur de transparence : Cette couleur permet de donner à un pixel la possibilité de ne pas se dessiner. Par ce moyen, on conserve ce qui est déjà dessiné sur un écran. Par exemple avec les deux images suivantes : Sans la gestion de la couleur de transparence, l' affichage des deux images va donner le résultat suivant (le cercle est affiché en premier puis le triangle en second) : Le cadre du triangle efface le cercle. Avec la gestion de la transparence, la superposition d' image est possible. Le résultat obtenu est celui-ci : La gestion de la transparence permet de conserver le morceau du cercle. /0 1 23 2 *. . 4 + / 2 15 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS Compiler votre application Le module POB-EYE se programme en langage C. L' onglet POB-Compiler permet de créer une application écrite en C pour le module POB-EYE. Pour créer l' application, il suffit de suivre les quatre étapes suivantes : 1 – Ouvrir la fenêtre “POB-Compiler". 2 – Sélectionner le fichier de sortie: extension .hex. 3 – Ajouter les fichiers sources C (extension .c) Si vous avez besoin d’aide sur les fonctions POB-EYE, le bouton “POB-EYE API” permet d’avoir l’aide en ligne. /0 1 23 2 *. . 4 + / 2 16 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS 4 – Créer l’application. Cliquez sur le bouton " Compile " pour lancer la compilation de votre application. Lors de la compilation, des messages s' afficheront dans la fenêtre appelée "Message des outils". Ces messages sont ceux du compilateur GNUARM. La réussite de la compilation est donnée par la dernière ligne de la console. Si le message " … is successfuly created !!! " apparaît, votre application s' est correctement compilée. Lorsque la compilation échoue, le message " …is not created " apparaît. Il vous faudra alors corriger votre application en fonction des messages du compilateur. /0 1 23 2 *. . 4 + / 2 17 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS Télécharger votre application Remarque : Avant de charger le programme, le module POB-EYE doit être allumé, en mode " programmation " et relié à votre ordinateur par le câble série. Configurer le module POB-EYE : Le POB-EYE doit être relié à votre ordinateur par un câble série. Le POB-EYE doit être en mode “programmation” : il suffit de placer correctement l’interrupteur de « programmation/exécution ». Le port série doit être sélectionné dans la fenêtre « Options » du programme POBTOOLS. Pour charger votre programme, cliquez sur le bouton "Télécharger". Vous devriez voir la barre de progression évoluer. Si un message d' erreur apparaît, il suffit de suivre les indications données pour corriger le problème. Si ce dernier persiste, n' hésitez pas à contacter le support de POB-Technology : [email protected]. Remarque : si le module est déjà alimenté, il suffit de positionner l' interrupteur "Programmation/Exécution" en mode "Programmation" et d' appuyer sur le bouton "reset". /0 1 23 2 *. . 4 + / 2 18 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS 5 Aide sur l’API POB-EYE Pour obtenir l’aide sur les fonctions du POB-EYE, vous pouvez ouvrir dans votre navigateur Web le fichier « POB_Documentation.html » dans le répertoire POB-TOOLS ou ouvrir le lien suivant à partir du menu démarrer de Windows : “Menu démarrer\Programmes\PobTools\API Documentation” ou cliquez sur le bouton « Aide » : Votre navigateur Web doit ouvrir la page suivante : /0 1 23 2 *. . 4 + / 2 19 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS 6 Outils additionnels Le POB-TOOLS est fourni avec des outils pour vous aider à configurer, développer ou tester votre programme. Actuellement, le POB-TOOLS dispose de 3 outils : Pob.BluetoothSettings, permet de configurer la carte POB-Tooth. Pob.RgbAndServo, permet de récupérer les images du POB-EYE sur votre ordinateur ou de tester votre POB-BOT. Pob.ServoManager, permet de créer des séquences pour vos servomoteurs. Pour activer ces outils, vous pouvez aller dans le menu « Outils » ou cliquez droit sur le bouton « Outils » : /0 1 23 2 *. . 4 + / 2 20 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS 7 Exemples Vous pouvez retrouver le code source et des exemples simples sur la reconnaissance de forme, l’affichage sur le POB-LCD128 dans le répertoire « Examples » du POB-TOOLS. Vous pouvez aussi ouvrir le répertoire d’exemples à partir du menu Démarrer de Windows : « Menu Démarrer\Programme\Programmes\PobTools\Examples ». Example1 L’exemple 1 reconnaît des formes et affiche les coordonnées des formes reconnues dans le POB-Terminal. Example2 Cet exemple affiche des images sur l’écran LCD et utilise les fonctions d’affichage pour dessiner ligne, point et bitmap. /0 1 23 2 *. . 4 + / 2 21 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS Example3 Ce programme affiche en temps réel l’image de la caméra sur le POB-LCD128. Example4 Le dernier programme utilise 2 écrans virtuels sur le POB-LCD128 : l’un des écran affiche la vidéo temps réel, le second affiche des informations sur les formes reconnues par le POB-EYE. /0 1 23 2 *. . 4 + / 2 22 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS 8 POB-Tools en ligne de commande Dans le répertoire POB-Tools, vous pouvez trouver un programme nommé pobc.exe. pobc.exe est un outil en ligne de commande pour compiler, créer et télécharger votre programme dans le POB-EYE. Vous pouvez utiliser cet outil dans des outils externes comme des IDE, éditeurs de texte avancé … Vous pouvez quelques exemples d’utilisation de pobc.exe dans le répertoire « Examples » (dans les répertoires example_pobc1 et example_pobc2). Les commandes sont les suivantes : -version: Récupère la version de pobc.exe -hex hexfile: compile une application POB-EYE (le nom du programme est hexfile). -buildlib libraryfile.a: compile une librairie POB-EYE (le nom de la librairie est libraryfile.a). -lib <list of library files>: Ajoute des librairies lors de la compilation (suivi de la liste des librairies). -c <list of your c files>: Ajoute des fichiers source C pour compiler (suivi de vos fichiers C). -gcc path-to-gnuarm: Chemin vers le compilateur gcc. -build path-to-build: Chemin vers le répertoire temporaire pour la compilation. -inc include-path: Ajoute un répertoire d’inclusion C lors de la compilation. -pattern <list of pattern files>: Créer le dictionnaire de forme (suivi de la liste des bitmaps à ajouter). -bitmap <list of bitmap files>: Créer la liste d’images (suivi de la liste des bitmaps à ajouter). -upload comport: Télécharger l’application en utilisant le port série spécifié. /0 1 23 2 *. . 4 + / 2 23 / 24 Constructeur de Robots Pour les Loisirs Innovants et Pour l’Enseignement Documentation POB-TOOLS Contact POB-Technology POB-TECHNOLOGY 4, rue Nicéphore Niépce 69 680 CHASSIEU FRANCE Web: www.pob-technology.com Mail: [email protected] Phone: +33 (0)4 72 43 02 36 Fax: +33 (0)4 72 66 18 99 /0 1 23 2 *. . 4 + / 2 24 / 24