====== Connection ======

  - Use the power switch on the battery box to turn the PiBot on
  - Use the following steps to connect to the PiBot from MacOS
    - Open the terminal app\\ \\ <WRAP round tip>Click the magnifying glass in the top right corner of the screen and type "terminal" to find the terminal app</WRAP>
    - Type the following command and press enter to connect to the Raspberry Pi terminal via SSH\\ \\ <WRAP round important>Replace the text "pibot##" with the label on the PiBot</WRAP> <WRAP round important>The password to enter when prompted is "DogsAndCatsAreNice2." without the quotes. The '.' at the end is important!</WRAP><code>ssh pi@pibot##.local</code>
  - Use the following steps to connect to the PiBot from Windows
    - Open the putty app from the Applications\PuTTY\<version> folder on the Flash drive\\ \\ <WRAP round tip>The <version> folder will be something like "0.75". Use the latest version available.</WRAP>
    - Type "pibot##" in the Host Name (or IP address)" box where the ## comes from the label on the PiBot.\\ \\ <WRAP box>{{ :pibot:multiplewireless:s1.png |PuTTY Configuration}}</WRAP>
    - Click the "Open" button to connect to the Raspberry Pi terminal via SSH\\ \\ <WRAP box>{{ :pibot:multiplewireless:s2.png |PuTTY Open Connection}}</WRAP>
    - If a "PuTTY Security Alert" window pops up, click the "Accept" button\ \\ <WRAP box>{{ :pibot:multiplewireless:s3.png |PuTTY Security Alert}}</WRAP>
    - Type "pi" at the "login as:" prompt and press Enter\\ \\ <WRAP round important>The password to enter when prompted is "DogsAndCatsAreNice2." without the quotes. The '.' at the end is important!</WRAP><WRAP box>{{ :pibot:multiplewireless:s4.png |PuTTY Login}}</WRAP>

====== Configuration ======

  - Type the following command and press enter to edit the wireless configuration\\ \\ <code>sudo nano /etc/wpa_supplicant/wpa_supplicant.conf</code> <WRAP round tip>If you have already configured the [[:pibot:autohotspot|Auto Hotspot]] on the PiBot then type the following command instead <code>sudo nano /etc/wpa_supplicant/wpa_supplicant-wlan0.conf</code></WRAP>
  - Add sections like one of the two below to the end of the file\\ \\ <WRAP round important>Be sure to replace the text "Your network name/SSID" with the actual SSID for your wireless network. If your SSID includes spaces then you have to use " at the beginning and the end of it</WRAP> <WRAP round important>Be sure to replace the text "Your network password" with the actual password for your wireless network. If your password includes spaces then you have to use " at the beginning and the end of it</WRAP> <WRAP round tip>If you are outside the United States then change the 'country=US' line to use the appropriate [[https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes|ISO 3166 alpha-2 country code]]</WRAP>
    - If the wireless network does **NOT** have a password use this section \\ \\ <code>network={
     ssid="Your network name/SSID"
     key_mgmt=NONE
}</code>
    - If the wireless network has a password use this section \\ \\ <code>network={
    ssid="Your network name/SSID"
    psk="Your network password"
    key_mgmt=WPA-PSK
}</code>
  - Hold down the control + O (or Ctrl + O) keys to save your changes to the file
  - Hold down the control + X (or Ctrl + X) keys to exit the editor
  - Type the following command to shutdown the PiBot\\ \\ <code>sudo shutdown -h now</code>

====== Usage ======

The wpa_supplicant.conf or wpa_supplicant-wlan0.conf file controls what wireless networks the PiBot will connect to. Each "network" section in the file defines a wireless network that it will try and connect to. There can be as many "network" sections as you need.