This is an english translation of the file LEGGIMI* written in Italian. ====================================== Mywave srl Prepare, test & connect Mywave internet keys & cellular phones version: 2009.07.28 ====================================== copyright (c) 2009 Mywave electronics www.mywave.it - info: help@mywave.it - o - This script tests Mywave internet keys and phones and detect their more frequent anomalies. If the internet key is working, SIM or USIM card is valid, and network coverage is enough, this script also connects to Internet, if user so desires. SIM card can require a PIN. This script in designed for Mywave's internet keys branded by Momodesign: MD-@ WITH mode switch: modem - USB disk; MD-@ 4GB WITH mode switch: modem - USB disk; MD-@ 1, color, WITHOUT mode switch. AND, for other modem devisec produced by Mywave: Smartphone SW006 Internet key White/orange branded Mywave without switch Internet key White/orange branded Wind without switch Internet key White/blue branded Leonardo without switch Internet key "Warrior" without switch Internet key fw2011 - fw2012 ("Robust") whit foldable USB plug, without switch Smartphone SW007 / SW2011 ( When inserted in an USB plug asks - on the thelephone screen - to choose between: modem, USB memory, installation CD. Choose "modem".) NOTE: this software has been developed and tested with Ubuntu 08.04 and 08.10. To use it with another Linux distribution, it could be necessary to allow explicitly user permission to sudoing, accessing modems and connecting to networks. In case of problems, test it first as root user. ___________________________________________________________________________ WARNING: There are two cases in wich the script does not end regularly, even with a well-working modem: - MD-@1 internet key with open diagnostic port. The software closes the port and invite to repeta the tst. Unplug the key, wait some seconds, plug it in aganin and restart the script. - fw2011 - fw2012 ("Robust") and key White/orange branded Wind, in Test Factory mode: the script put them in Full Operative mode, but in some cases the key cannot register in time with the GSM network. (This happens systematically when these models have been used previously with Windows or Mac dashboard.) In these case you can restart the scipt after few seconds, without unplugging the key. ____________________________________________________________________________ Prerequisites: ============== Needed a PC with : ***Linux with kernel 2.6.24 or later*** (verifiabile issuing from a terminal "uname -a"); common utilities (cat, chat..) and lsusb; ***usbserial must be a loadable module and accept parameters at load time***. This can be verified issuing from a terminal following commands: sudo /sbin/rmmod -f option sudo /sbin/rmmod -f usbserial sudo /sbin/modprobe usbserial vendor=0x1e0e product=0x9000 first and second commands probably will return ERROR, because modules to remove have never been loadade before; answer to third command MUST be empty (no message, just a prompt). wvdial and/or umtsmon are suggested, but not essential. Script tested on Ubuntu 08.04 e 08.10, SuSe... "Live" execution from keys ========================== Some models of keys are recognized after plugin as disks or CD; if there is a Linux" directory containig another directory with this file, in is possible to execute this software straightly from it Please take note of the password of root user or of current user, that must be enabled to sudo (In Ubuntu, main user is enabled by default) Plugin the key, wait to see the new diskìs contents and click over one of these file: RUN-NOroaming.sh RUN-roaming.sh If requested, choose "execute in a terminal". The "NOroaming..." file allows to set the modem so as it does accept to register only with the default SIM operator's network. This can be useful if you have a "special offer" contract with your operator; connetting in roaming would require the payment of full fare (or even more). "Live" execution from directory =============================== If the directory containing this file has been downloaded from internet, you can execute the software from here. Be sure that all files to be execute have the execution permission: if in doubt, from a terminal do: cd in this directory, chmod 755 * Please take note of the password of root user or of current user, that must be enabled to sudo (In Ubuntu, main user is enabled by default) Then, execute from terminal one of following commands: ./RUN-NOroaming.sh ./RUN-roaming.sh OR, fom a graphical File manager, click over one of these file: RUN-NOroaming.sh RUN-roaming.sh If requested, choose "execute in a terminal". The "NOroaming..." file allows to set the modem so as it does accept to register only with the default SIM operator's network. This can be useful if you have a "special offer" contract with your operator; connetting in roaming would require the payment of full fare (or even more). Installation: ============= Please take note of the password of root user or of current user, that must be enabled to sudo (In Ubuntu, main user is enabled by default). If this directory is still contained in a zipped file, extract all files in a temporary directory with a name at your will; Be sure that file "INSTALLA..." has the execution permission: if in doubt, from a terminal do: cd in the temporary directory, chmod 755 * click over file INSTALLA... and choose to execute it in a terminal; OR, from an open terminal: cd in the temporary directory, chmod 755 INSTALLA ./INSTALLA and follow inline instructions. Messages are in italian if 1st and 2nd character of the environmental variable LANG are "it"; in english otherwise. Complete deinstallation: ======================== delete links from Desktop delete directory .mywave in your home directory delete (as root) directory /opt/mywave/internetkeyscript/ and its contents: sudo rm -rf /opt/mywave/internetkeyscript/ Usage: ====== Please take note of the password of root user or of current user, that must be enabled to sudo (In Ubuntu, main user is enabled by default). Look on your Desktop: if you can find two Mywave launchers on it, click over one of them and if requested choose "execute in a teminal". The "NOroaming..." laucher allows to set the modem so as it does accept to register only with the default SIM operator's network. This can be useful if you have a "special offer" contract with your operator; connetting in roaming would require the payment of full fare (or even more). If you cannot find launchers on yours Desktop (could happen with Linux localisation neither italian non english), try to click from a graphical file manager over launchers that can be found in directory: /opt/mywave/internetkeyscript/ OR over one of the two files /opt/mywave/internetkeyscript/RUN-NOroaming.sh /opt/mywave/internetkeyscript/RUN-roaming.sh ***In any case*** it's always possible to execute, from an open terminal, commands: /opt/mywave/internetkeyscript/TESTmywavekeys.sh nolog roaming OR /opt/mywave/internetkeyscript/TESTmywavekeys.sh nolog noroaming (NOTE: parameter "nolog" does not avoid a session log being written, but each session's log overwrites the previous session's log on same file. Parameter "log" is needed for mass-testing of several keys, an never deletes older log. Avoid it to avoid running out of disk space.) Messages are in italian if 1st and 2nd character of the environmental variable LANG are "it"; in english otherwise. You can plug the key, with a valid SIM or USIM card, in an USB plug before or after having started the test script. Warning: sometimes you'll have to wait few seconds for next script's message. If something does not work properly, you'll obtain a clear diagnostic message. If what happens is not clear, please copy from terminal or from log file THE COMPLETE script's output and send it to help@mywave.it. Trieste, 2009.07.28