View source for Step by Step Connecting to Robot for Students Windows 7

== Step-by-step Myro Installation Manual: Windows 7 Setup for students ==
The purpose of this guide is to provide detailed, step-by-step instructions for those who like to see all of the information
together on one page with lots of details. A more condensed version is available in the [[Myro Installation Manual]]. <br> 
<p>
'''This document assumes that you have the latest version of Myro and the latest versions of the firmware on your fluke & scribbler.''' If you are a student, your instructor will probably have already taken care of that for you. However, if you need to upgrade Myro or your firmware, you can find detailed instructions at [[Step_by_Step_Installation_Windows_7]] and a more condensed version at [[Myro Installation Manual]].


=== Overview ===
To get your robot up and working for the first time, you are going to have to go through the following steps '''in the following order!!'''  Detailed instructions for each step follows:
# Confirm that you have administrative rights in [http://www.tweakwindows7.net/ windows 7 tweaks] 
# Acquire a Myro CD or download the software from the Internet
# Install the Myro Software on your computer
# Set up your robot
# Set up the bluetooth connection so that your computer can talk to your robot 
# Upgrade the Myro Software on your computer (note: do '''NOT''' attempt to do this step before the others, it can cause problems!)
# Do some testing to make sure everything is working smoothly

=== Confirming that you have administrative rights in Windows 7 ===
# <span style = "color:red">'''I'm not sure how to do this yet. I'm hoping someone will tell me ...'''</span>

=== Downloading the Myro Software to Your Computer ===
<span style = "color:red">'''HELP: can someone confirm that unzipping a file works this way in Windows 7, these are just my XP instructions</span>
'''If you have a Myro Installation CD, you can skip this step'''
# Download the latest [http://myro.roboteducation.org/download/packages/myro-all-270.zip Myro ZIP File] & save that to your hard drive (i.e. click "Save to disk"). 
# Extract all of the files from the zip file and put them into a new folder on your desktop as follows:
## Create a ''new folder'' on your desktop
## Right click on the zip file you saved, click ''Open'', and select and copy the "Myro Install Files" folder.
## Paste the "Myro Install Files" folder into the ''new folder'' you created on your desktop.
## Close the window showing you your zip file


=== Installing Myro from a zip file ===
''' If you have the Myro Installation CD, skip this step'''
<br>
If you downloaded the zip file, install Myro this way '''from the new folder you made on your desktop''':
# If it's not open already, open the new folder you created by double clicking on it, or right clicking on it and then selecting ''Open''.
# Confirm that you are looking at your new folder (and not at your zip file. The rest of the steps won't work if you try to do things from within the zip file, rather than with the copy you made)
# Open the "Myro Install Files" folder '''in the new folder you made on your desktop''' by double clicking on it, or right clicking on it and then selecting ''Open''. 
* <span style="color:green;font-size:130%">'''PROCEED VERY CAREFULLY. MESSING UP THIS NEXT STEP WILL CAUSE YOU GRIEF!!!!!!!!</span> 
* <span style="color:green;font-size:130%">RIGHT CLICK</span> on the '''install.bat''' file and select <span style="color:green;font-size:130%">"run as administrator". </span>
:::: [[Image:Myro install window.jpg]]
::* Be prepared to click on "next" and "finish" '''a lot.''' ''Some background: while most people think of Myro as a single program, there are in fact multiple programs that will get installed after you click on install.bat. So the system will regularly claim to be finished when in fact it's just finished one part of the install. Just keep hitting next and finish.''
::* always choose Python2.4 if given a choice
::* if you already have Python2.4 installed, choose the '''Repair''' option
::* always take the recommended defaults (so, for example, let it choose where to put all the files!) 
::* never select '''Remove'''
* Eventually you'll be left with a black "DOS" type window on your screen with the instructions to "Press any key to continue," so press a key to get rid of it.

=== Installing Myro from the Myro Installation CD ===
''' If you don't have a CD, skip this step '''
* <span style="color:green;font-size:130%">'''PROCEED VERY CAREFULLY. MESSING UP THIS NEXT STEP WILL CAUSE YOU GRIEF!!!!!!!!</span> 
* <span style="color:green;font-size:130%">'''RIGHT CLICK'''</span> on the '''install.bat''' file and select <span style="color:green;font-size:130%">"run as administrator". </span>
:::: [[Image:Myro install window.jpg]]

** Be prepared to click on "next" and "finish" '''a lot.''' 
***''Some background: while most people think of Myro as a single program, there are in fact multiple programs that will get installed after you click on install.bat. So the system will regularly claim to be finished when in fact it's just finished one part of the install. Just keep hitting next and finish.''
** always choose Python2.4 if given a choice
** if you already have Python2.4 installed, choose the '''Repair''' option
** always take the recommended defaults (so, for example, let it choose where to put all the files!) 
** never select '''Remove'''
* Eventually you'll be left with a black "DOS" type window on your screen with the instructions to "Press any key to continue," so press a key to get rid of it.

=== Set up your Robot ===
* Insert 6 AA Batteries into the base of your Scribbler Robot. 
** Make sure these are new alkaline batteries or well-charged NiMH batteries!
** Do not mix different types of batteries
** Do not mix old batteries with new batteries
* Before plugging in your Fluke, take note of the location of the Scribbler Robot's power switch: it's right next to the serial port on your Scribbler robot, near the words "Scribbler Robot"
* Insert the IPRE Fluke into the serial port of the Scribbler Robot as shown in the picture below
::::[[Image:Ipre-fluke.jpg|400px]]

=== Set up your Bluetooth Connection ===
* Turn the scribbler power switch to on (on looks like a line '''|''' and off looks like a circle '''o'''). When you do so 
** The red power LED next to the power switch should turn on
** The green Power LED on the fluke board should turn on
** The scribbler should play a sound
* If your computer doesn't have built in bluetooth, plug your Bluetooth USB Adapter into your computer
* Add a new bluetooth device in the Control Panel as follows: From the start menu, click on the start button and then click on the words "control panel" which you should find on the funny shimmery gray area on the right. You should see a window that looks like this:
:::: [[Image:Win_7_control_panel_hardware_circled.jpg]]
* Now, click on "Hardware and Sound". 
You should see something that looks like this:
:::: [[Image:Win_7_control_panel_hardware_sound_window.jpg]]
*Click on "Add a Bluetooth device". You should see something that looks like this:
:::: [[Image:Win_7_add_a_device.jpg]]
* On your fluke board there should be a little sticker with a serial number on it. Make a note of that number
* Now look at the "add a device" window for a device that starts with IPRE and has your serial number at the end. Left click on that, and then hit next. You should see something that looks like this:
:::: [[Image:Win_7_select_pairing.jpg]]
* Select the "Enter the device's pairing code" option. You should see something like this:
:::: [[Image:Win_7_enter_pairing.jpg]]
* Type '''1234''' as the pairing code as indicated in the image above, and click on the next button. You should see something like this:
:::: [[Image:Win_7_done_adding2.jpg]]
* Note, if you didn't enter 1234 this quickly enough, you will see a window that looks like this:
:::: [[Image:Win_7_devices_try_again.jpg]]
* If you see the window above, just click on "try again" and you will be back to the "add a device" window.

* Once you see the "This device has been successfully added" message, click on the words Devices and Printers as indicated in the success window above. Note that if for some reason you have closed this window, you can also get there by selecting control panel from the start menu, then hardware & sound, then devices and printers.
::::[[Image:Win_7_control_panel_hardware_sound_devices_printers.jpg]]

* Find your device (remember, it starts with IPRE and ends with your serial number). Right click on it, and choose "properties" and you should see something like this:
:::: [[Image:win_7_device_general_properties]]
* Select the "services tab." It should look something like this:
:::: [[Image:win_7_device_services_properties]]
* Make note of the "COM" port for your robot. For example, the COM port in the window above is "COM3". Note that there are NO SPACES in this name. 
* Click on the "Cancel" button at the bottom of the window.
* If you ever forget your COM port number, you can always get to the "Devices and Printers" window by selecting control panel from the start menu, then hardware & sound, then devices and printers.




===Upgrade the Myro Software on your computer===
* If your python shell window is open, close it by selecting File->Exit
* We really mean it, close your python shell window. You can open it up again in a minute and do stuff, but things go much more smoothly if you close it once at this point!
* On your windows desktop, locate the "Start Python" icon (with the cute green snake) and double click on it. 
::::[[image:Start_python_icon.jpg]]
* You may see a black window open up briefly and then close again, ignore that, and shortly a window should open up that has the title "Python Shell"
::::[[Image:Python_shell_XP.jpg]]
* type '''from myro import *''' after the ">>>" prompt and hit enter. The result should look something like this:
 >>> from myro import *
 (c) 2006-2007 Institute for Personal Robots in Education
 [See http://www.roboteducation.org/ for more information]
 Myro version 2.7.0 is ready!
 >>>
* type '''upgrade("myro")'''
 >>> upgrade("myro")
* sit back and wait
* close your python shell window by selecting File->Exit
* We really mean it, close your python shell window. You can open it up again in a minute and do stuff, but things go much more smoothly if you close it once at this point!


===Testing===
* Turn the scribbler power switch to on (on looks like a line '''|''' and off looks like a circle '''o'''). When you do so 
** The red power LED next to the power switch should turn on
** The green Power LED on the fluke board should turn on
** The scribbler should play a sound

* Before proceeding, confirm that you remember your outgoing com port number
** If you forget your outgoing com port number, open the "Devices and Printers" window as follows:
*** From the start menu, click on the start button and then click on the words "control panel" which you should find on the funny shimmery gray area on the right. You should see a window that looks like this:
:::: [[Image:Win_7_control_panel_hardware_circled.jpg]]
*** Now, click on "Hardware and Sound". 
You should see something that looks like this:
:::: [[Image:Win_7_control_panel_hardware_sound_window_select_devices.jpg]]
*** Now, click on "Devices and Printers"
::::[[Image:Win_7_control_panel_hardware_sound_devices_printers.jpg]]
* Find your device (remember, it starts with IPRE and ends with your serial number). Right click on it, and choose "properties" and you should see something like this:
:::: [[Image:win_7_device_general_properties]]
* Select the "services tab." It should look something like this:
:::: [[Image:win_7_device_services_properties]]
* Make note of the "COM" port for your robot. For example, the COM port in the window above is "COM3". Note that there are NO SPACES in this name. 

<br>
* On your windows desktop, locate the "Start Python" icon (with the cute green snake) and double click on it. 
::::[[image:Start_python_icon.jpg]]
* You may see a black window open up briefly and then close again, ignore that, and shortly a window should open up that has the title "Python Shell"
::::[[Image:Python_shell_XP.jpg]]
* type '''from myro import *''' after the ">>>" prompt and hit enter. The result should look something like this:
 >>> from myro import *
 (c) 2006-2007 Institute for Personal Robots in Education
 [See http://www.roboteducation.org/ for more information]
 Myro version 2.7.0 is ready!
 >>>
* type init()
A window will pop up and ask you for the port number. Enter the outgoing COM port number you got when you set up your bluetooth connection (or that you checked above) and hit "OK" 
<br>
::::[[Image:Com_port_askdialog.jpg]]
<br>


* As soon as you hit OK, keep your eyes open for a small message that pops up on your taskbar (usually at the bottom of your screen) that says: "a bluetooth device is trying to connect, click to allow this". You want to click on that message. If, for some reason, you are too slow, you can click on the bluetooth logo that looks like this: [[Image:bluetoothlogo.jpg]] on the bottom right of your monitor (if you see one) and then select the "allow a device to connect" choice. If you don't see the bluetooth logo, click on the triangle pointing up on the bottom right corner of the monitor and that should reveal the bluetooth logo that you can then click on and then select the "allow a device to connect" choice. 
* Now you should see the following window:
::::[[Image:Win_7_enter_pairing.jpg‎]]
* Enter 1234 as shown above and click on the "next" button. You should see something like the following:
::::[[Image:Win_7_done_adding.jpg]]
* click on the close button
* Place your robot on the floor, or somewhere else that it won't get hurt if it drives around!
* You should see the python shell window again. Sit back and wait for some messages on the python shell. When it's completed, you'll see the >>> prompt again. 
* At the >>> prompt, type '''joyStick( )''' (note the capital S in joyStick and the open and close parenthesis after the word!)
 >>> joyStick()
* The joystick window should appear:
::::[[Image:JoyStick_interface.jpg]]]
* Use your mouse to click in the window, your robot should move around!

== Troubleshooting ==

=== Wait: My bluetooth connection isn't working!!! ===
Try the following. Eventually one should work. They are listed in order of how irritating they are going to be for you ... a higher irritation level is likely to make you more annoyed, so try the easy stuff first!

==== Bluetooth isn't working: Super-Simplest Fix (Irritation Level: 1) ====
* If you are using an external Bluetooth USB key, make sure it is plugged in!
* Confirm that the batteries in your robot are fresh & installed correctly
* If you have the Python Shell open, Choose File -> Exit from the Python Shell
* Double click on the "Start Python" icon
* Try connecting to your robot again

==== Bluetooth isn't working: Simplest Fix (Irritation Level: 2) ====
* If you are using an external Bluetooth USB key, make sure it is plugged in!
* If you have the Python Shell open, Choose File -> Exit from the Python Shell
* Turn off the power on your scribbler
* Count to 5 slowly for good luck
* Power on your scribbler
* Double click on the "Start Python" icon
* Try connecting to your robot again

==== Bluetooth isn't working: Moderate Fix (Irritation Level: 3) ====
* If you are using an external Bluetooth USB key, make sure it is plugged in!
* If you have the Python Shell open, Choose File -> Exit from the Python Shell
* Turn off the power on your scribbler
* Count to 5 slowly for good luck
* Open the "Devices and Printers" window as follows:
*** From the start menu, click on the start button and then click on the words "control panel" which you should find on the funny shimmery gray area on the right. You should see a window that looks like this:
:::: [[Image:Win_7_control_panel_hardware_circled.jpg]]
*** Now, click on "Hardware and Sound". 
You should see something that looks like this:
:::: [[Image:Win_7_control_panel_hardware_sound_window_select_devices.jpg]]
*** Now, click on "Devices and Printers"
::::[[Image:Win_7_control_panel_hardware_sound_devices_printers.jpg]]
* Find your device (remember, it starts with IPRE and ends with your serial number).
* Right click on your device and select "remove device." You should see something like the following:
::::[[Image:Win_7_confirm_remove_device]]
Select "yes" to remove the device

* If you don't see a device that starts with IPRE and ends with the serial number you just found
** look again, are you sure it's not there? If it is, go back to the previous step
** If it's genuinely not there, just continue ...
* Go back and set up your bluetooth again from scratch as described above in the [[Step_by_Step_Installation_Windows_7#Set_up_your_Bluetooth_Connection|Set up Your Bluetooth Connection]] section

==== Bluetooth isn't working: Serious Fix (Irritation Level: 4) ====
* If you are using an external Bluetooth USB key, make sure it is plugged in!
* If you have the Python Shell open, Choose File -> Exit from the Python Shell
* Turn off the power on your scribbler
* Count to 5 slowly for good luck
* Open the "Devices and Printers" window as follows:
*** From the start menu, click on the start button and then click on the words "control panel" which you should find on the funny shimmery gray area on the right. You should see a window that looks like this:
:::: [[Image:Win_7_control_panel_hardware_circled.jpg]]
*** Now, click on "Hardware and Sound". 
You should see something that looks like this:
:::: [[Image:Win_7_control_panel_hardware_sound_window_select_devices.jpg]]
*** Now, click on "Devices and Printers"
::::[[Image:Win_7_control_panel_hardware_sound_devices_printers.jpg]]
* Find your device (remember, it starts with IPRE and ends with your serial number).
* Right click on your device and select "remove device." You should see something like the following:
::::[[Image:Win_7_confirm_remove_device]]
Select "yes" to remove the device
* If you don't see a device that starts with IPRE and ends with the serial number you just found
** look again, are you sure it's not there? If it is, go back to the previous step
** If it's genuinely not there, just continue ...
* Shut down and restart your machine
* Go back and set up your bluetooth again from scratch as described above in the [[Step_by_Step_Installation_Windows_7#Set_up_your_Bluetooth_Connection|Set up Your Bluetooth Connection]] section