Vous êtes sur la page 1sur 8

fWIIne Copyright (c) 2008-2009 William Alozy and all the contributors Permission is hereby granted, free of charge,

to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all c opies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI ED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTH ORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OU T OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. The contributors (software source and or tutorial) have been listed, below : Name / reference / contribution

-------------------------------------------------------------------------------- Release 0.4 ----| | - Michal Wiedenbauer(ext)| * Thanks to all the Devkitpro's team | http://www.devkitpro.org/ - Dave Murphy(ext) | * for integration of wiiuse and WMP | - Hector Martin(ext) | * | - William Alozy | fWIIne 0.4(sourceforge.net/projects/fwiine) | http://fwiineur.blogspot.com/ | | -------------------------------------------------------------------------------- Release 0.3 ----| | - William Alozy | fWIIne 0.3(sourceforge.net/projects/fwiine) | http://fwiineur.blogspot.com/ | Especially thanks to Tzahi Menashe for beta-tests | - Michael Laforest (ext)| wiimote library wiiuse 0.12 | http://wiiuse.net/ | | -------------------------------------------------------------------------------- Release 0.2 ----| | - William Alozy | fWIIne 0.2(sourceforge.net/projects/fwiine) | http://fwiineur.blogspot.com/ - "zsbMich" (ext) | IR fixes and function computeOrientation | http://www.ziggyware.com/forum/viewthread.php?forum_id=26&thread_id=12579 |

| -------------------------------------------------------------------------------- Release 0.1 ----| | - William Alozy | fWIIne 0.1(sourceforge.net/projects/fwiine) | http://fwiineur.blogspot.com/ - Kevin Forbes (ext) | cWiimote 0.2 | http://simulatedcomicproduct.com - "PatGlynn" (ext) | fix IR sensor cwiimote 0.2 (www.wiili.org/forum/cwiimo te-fix-for-toshiba-(possibly-also-others)-t934.html) - Bryant Nichols (ext) | MatlabVS(www.codeproject.com/KB/cpp/MatlabVS.aspx) | http://bryantnichols.googlepages.com/bryantnichols.htm) (ext : the contributors helped with a publication of sources or tutorials which were not related to fWIIne, directly). License ----------------------------------------------------The following informations deals with the library fwiine and files using this library. The licenses of fwiine are inherited from wiiuse ones. Please read them carefully before choosing which one you use. You may of course at any time switch the license you are curre ntly using to the other. Briefly, the license options are: a) GNU LGPL (modified for non-commercial usage only) b) GNU GPL WARNING : Please see the licenses inside folder "wiiuse_v0.12" and also @ http://www.devkitpro.org/

Recommendation ----------------------------------------------------The program MATLAB 7.4 the program ation which was tested on Windows XP, with Service Pack 2, and WINDDK 3790.1830, (up to 7.1) installed. You may have to install these to make run. You must have, already, downloaded/installed a "wiimote" applic enables IR sensor detection.

MATLAB is a registered trademark of The MathWorks. Windows is a registered trademark of Microsoft Corporation in the United States and other countries. THIS PROGRAM IS PRIMARILY DISTRIBUTED TO INTERESTED DEVELOPERS AS SAMPLE CODE. IT IS NOT MEANT TO BE A ROBUST END-USER APPLICATION. MANY PARAMETERS ARE NOT MOD IFIABLE WITHOUT PROGRAMMING KNOWLEDGE. How to use ----------------------------------------------------1. You must first connect your wiimote to your PC via bluetooth before running

the program. You can follow this tutorial using the Widcomm Windows Driver: http://wiibrew.or g/index.php?title=Wiimote_Tutorial You can follow this tutorial using the Blue Soleil Windows Driver: http://www.wi ili.org/index.php/How_To:_BlueSoleil Some other bluetooth drivers may be available. 2. Launch "Matlab" and go to your working folder. 3. Use the "fWIIne.mexw32" library as described within "fWIIne_description.m" / Load "test_fwiine.m" / Execute the simulink model "fwiine_example.mdl" / etc... . Matlab Controls --------------------------------------1. fWIIne(0) to initialize acquisition from Wiimote to Matlab. 2. [.....] = fWIIne(5) or fWIIne(4), fWIIne(3),fWIIne(7), fWIIne(8) to get the acquisition data. fWIIne(2) to print the values of motion sensor 3. fWIIne(1) to stop communication between Wiimote and Matlab. (Communication between the Wiimote and the computer still remains active !) Release Note --------------------------------------Release : 0.4 Release Date : 26/09/2009 Stability Update : no Earlier Changes : yes fWIIne v0.4 features --------------------------------------Change : wiimote library updated : wiiuse 0.12 + re-use of integration from devkitpro fWIIne MEX function : command fWIIne(8) allows acquisition of values from Wiimote accel. sensor and ang. rate from WiiMotionPlus fWIIne v0.3 features --------------------------------------Change : new wiimote library included : wiiuse 0 .12 (solving some bug fixes with previous lib.) fWIIne MEX function : command fWIIne(7) allows acquisition of values from accel. sensor, 4 Infrared dots of A B 1 2 buttons of the Wiimote fWIIne v0.2 features --------------------------------------fWIIne MEX function : Acquisition of values of accelerometer s ensor, of InfraRed sensot, of A B 1 2 buttons from Wiimote Get orientation of the wiimote sfwiine S-function for Simulink : le) Bug fix : S-function for simulink simulation (M-fi correction of IR initialization

Known issues -------------------------------------------fWIIne.mexw32 : - WiiMotionPlus is not handled, automatically (it requires to plug WMP and then to press button 1) - A little delay (invalid data) can occur on the first 50 ms. - No acquisition from Buttons "up", "Down", "Left", "Right" - settings Led are not available - 2 wiimotes and the Nunchuck are not supported sfwiine.m : - Compilation is not available with RealTimeWorkShop (because the implementation of a C S-function is planned for next release) sfwiine.mdl : - No realtime Data acquisition . - The pseudo realtime simulation can only be done by a statistical determination of real sampling time (By measuring simulation time) Trouble Shooting -------------------------------------------a quick sampling time may slow simulation [0.01s .. 0.024s]. It is recommended t o set the sampling value to higher values [0.024s..1s] ---------------------------------------------------------------------------------------------------------------------------------fWIIne Copyright (c) 2008-2009 William Alozy et tous les contributeurs L'autorisation est accordee par la presente, a titre gratuit, a toute personne a yant obtenu une copie de ce logiciel et des fichiers de documentation associes ( le "Logiciel"), pour diffuser le Logiciel, sans restriction, y compris, sans s'y limiter, le droit d'utiliser, de copier, de modifier, de fusionner, de publier, de distribuer, de sous-licence et / ou de vendre des copies du Logiciel, et d'a utoriser les personnes auxquelles le Logiciel est fourni a le faire, sous reserv e des conditions suivantes: La notice de copyright et la presente autorisation doivent etre inclus dans tout es les copies ou parties substantielles du Logiciel. Le logiciel est fourni "tel quel", sans garantie d'aucune sorte, expresse ou imp licite, y compris, sans contrainte de garanties de qualite marchande ni a l'adeq uation a un usage particulier. En aucun cas, les auteurs ou les titulaires de droit d'auteur ne peuvent etre te nus responsable pour toute reclamation, dommages ou autre responsabilite, que ce soit dans une action contractuelle, delictuelle ou autre, resultant de, hors de ou en rapport avec le logiciel ou l'utilisation ou dans d 'autres transactions diffusant le logiciel Les contributeurs (source et les logiciels ou tutoriel) ont ete enumerees ci-des

sous: Name / contribution / reference -------------------------------------------------------------------------------- Release 0.4 ----| | - Michal Wiedenbauer(ext)| * Remerciements e toute l'equipe Devkitpro | http://www.devkitpro.org/ - Dave Murphy(ext) | * pour son integration de Wiiuse et du WMP | - Hector Martin(ext) | * | - William Alozy | fWIIne 0.4(sourceforge.net/projects/fwiine) | http://fwiineur.blogspot.com/ | | -------------------------------------------------------------------------------- Release 0.3 ----| | - William Alozy | fWIIne 0.3(sourceforge.net/projects/fwiine) | http://fwiineur.blogspot.com/ | Remerciements tous particulier a | | Tzahi Menashe pour les beta-tests realises | - Michael Laforest (ext)| wiimote library wiiuse 0.12 | http://wiiuse.net/ | | -------------------------------------------------------------------------------- Release 0.2 ----| | - William Alozy | fWIIne 0.2(sourceforge.net/projects/fwiine) | http://fwiineur.blogspot.com/ - "zsbMich" (ext) | correction IR et fonction computeOrientation | http://www.ziggyware.com/forum/viewthread.php?forum_id=26&thread_id=12579 | | -------------------------------------------------------------------------------- Release 0.1 ----| | - William Alozy | fWIIne 0.1(sourceforge.net/projects) | http://fwiineur.blogspot.com/ - Kevin Forbes (ext) | cWiimote 0.2 | http://simulatedcomicproduct.com - "PatGlynn" (ext) | fix IR sensor cwiimote 0.2 (www.wiili.org/forum/cwiimo te-fix-for-toshiba-(possibly-also-others)-t934.html) - Bryant Nichols (ext) | MatlabVS(www.codeproject.com/KB/cpp/MatlabVS.aspx) | http://bryantnichols.googlepages.com/bryantnichols.htm) (ext : les contributeurs ont fourni une aide en publiant des sources ou des tuto riaux sans lien direct avec fWIIne.). License

----------------------------------------------------Les informations suivantes portent sur la bibliotheque fwiine et les fic hiers utilisant la bibliotheque fwiine. Les licenses citees ci-dessous sont heritees de celles de la bibliothequ e wiiuse. Lisez les attentivement avant de choisir celle que vous allez utiliser. De meme, vous pourrez basculer d'une license a l'autre. Brievement, les options de license sont les suivantes : a) GNU LGPL (modifiee pour un usage non-commercial seulement) b) GNU GPL ATTENTION : Veuillez lire les licenses situees dans le repertoire "wiiu se_v0.12" et sur le site http://www.devkitpro.org/ Recommandation -------------------------------------------------- --Le programme a ete teste sur Windows XP avec Service Pack 2, et WINDDK 3790,1830 , MATLAB 7.4 (7.1 et au-dela) installe. Vous pourriez avoir a installer ceux-ci afin que le programme tourne. Vous devez avoir deja telecharge / installe une ap plication "wiimote" qui permet la detection du capteur infrarouge. MATLAB est une marque deposee de The MathWorks. Windows est une marque deposee de Microsoft Corporation aux Etats-Unis et d'autr es pays. Ce programme est principalement distribue aux developpeurs interesses comme exem ple de code. Il n'est pas cense etre une demande robuste de l'utilisateur final. De nombreux parametres ne sont pas modifiables sans connaissances en programmat ion. Comment utiliser -------------------------------------------------- --1. Vous devez tout d'abord connecter votre wiimote a votre PC via bluetooth avan t de lancer le programme. Vous pouvez suivre ce didacticiel en utilisant le driver Windows Widcomm: http:/ /www.playeradvance.org/forum/printthread.php?t=5011&pp=25 Vous pouvez suivre ce didacticiel en utilisant le driver Windows BlueSoleil: htt p://www.wiili.org/index.php/How_To:_BlueSoleil D'autres drivers bluetooth peuvent etre disponibles. 2. Lancez "Matlab" et accedez a votre dossier de travail. 3. Utilisez la lib. "fWIIne.mexw32" comme decrit dans "fWIIne_description.m" / L oad "test_fwiine.m" / Executer le modele simulink "fwiine_example.mdl" / etc ... Commandes Matlab --------------------------------------1. fWIIne (0) pour initialiser l'acquisition de Wiimote avec Matlab. 2. [.....] = fWIIne (5) ou fWIIne (4), fWIIne (3) ou fWIIne(6) fWIIne(7) fWIIne( 8) pour obtenir de l'acquisition de donnees. fWIIne (2) pour imprimer les valeur s du capteur de mouvement 3. fWIIne (1) pour arreter la communication entre Wiimote et Matlab. (la communi cation entre le Wiimote et l'ordinateur reste active!)

Note de publication --------------------------------------Livraison : 0.4 Date de publication: 26/09/2009 Mise a jour de stabilite: non Evolutions precedentes : oui fWIIne v0.4 features --------------------------------------Change : mise a jour basee sur : wiiuse 0.12 + r e-utilisation de l'integration sur devkitpro fWIIne MEX function : commande fWIIne(8) autorisant l'acquisi tion de la Wiimote (accel.) et derivee angulaire du Motion Plus fWIIne v0.3 - caracteristiques --------------------------------------Change : nouvelle bibliotheque : wiiuse 0.12 (r esolvant des bugs de l'autre bib.) fWIIne MEX function : commande fWIIne(7) autorisant l'acquisi tion : accel. sensor, 4 points IR et boutons A B 1 2 buttons

FWIIne v0.2 fonctionnalites --------------------------------------FWIIne MEX fonction: Acquisition des valeurs de l'acceleromet re, du capteur infrarouge, des boutons A B 1 2 de la Wiimote valeurs d'inclinaison Sfwiine S-fonction pour Simulink: Correction de bug : S-fonction de simulation (M-file) Correction de l'initialisation IR

Problemes connus -------------------------------------------fWIIne.mexw32: - Le WiiMotionPlus n'est pas detecte automatiquement (durant une sequence branch er le WMP et presser le bouton 1) - Un temps de latence (informations non valides) est susceptible d'apparaitre le s 50 premieres millisecondes. - Pas d'acquisition de boutons "up", "Down", "Gauche", "Droite" - Les parametres d'allumage des Led ne sont pas disponibles - 2 wiimotes et le Nunchuck ne sont pas supportees sfwiine.m: - La compilation RTW n'est pas disponible avec RealTimeWorkShop (la mise en oeuv re d'un C-S fonction est prevue pour la prochaine release) sfwiine.mdl: - Pas d'acquisition de donnees en temps reel.

- Une simulation en pseudo-temps reel ne peut se faire que par une determination statistique de l'echantillonnage temps reel (En mesurant le temps de simulation avec un chronometre) Perturbation, non-conformite -------------------------------------------Un temps d'echantillonnage proche de la limite bluetooth (de 0.01s) peut ralenti r la simulation [0.01s .. 0.024s]. Il est recommande de fixer la valeur de l'ech antillonnage a des valeurs superieures a l'intervalle [0.024s .. 1s]