NOTE: This is a work in progress

This page is intended to be used as a resource by your IT department to help them get everything setup for the ThinSat program.

In this section we're going to get your xChips connected to the internet so they can start sending data to the Data Dashboard. And once you have this working, your xChips will remember the configuration the next time you use them!

All you need to get going are these three things:

1. Wi-Fi Internet hotspot
2. The computer you set up at the beginning of this tutorial
3. A CW01 Wi-Fi Module that you flashed in the FlashTool Tutorial

You need a Wi-Fi internet connection that uses WPA or WPA2 security. That means you type in a password. If your internet hotspot pops up a webpage where you have to click "accept" then you're going to need to find another hotspot.

A solution that works very well is to use a cell phone as a mobile hotspot. This is especially useful during the Balloon Missions, when you might have a "chase team" driving out to recover your balloon.

Whatever internet connection you use will need to have access to two sites:

Website	Ports
mqtt.xinabox.cc	tcp 1883
link.xinabox.cc	tcp & udp 8441-8443

If you are in a school, chances are there are firewalls setup that may limit access to these sites and ports. Follow this technical troubleshooting guide to use a computer to check your connectivity. If you are having difficulty, ask your IT department about getting access. They can look at our ThinSat Internet Requirements page for reference.

NOTE: This can be a stumbling block when you are first getting started. If your internet connection isn't cooperating, we recommend using your cellphone hotspot to go through this process and complete the rest of the Quick Start Guide with that connection. Work with your IT department or contact your Leading Institution for help resolving internet connectivity issues.

Ok, now that we read through the technical details, grab your computer and a CW01 that you flashed in the previous step and follow this Configure the CW01 guide.

Once you have your CW01 connected to the internet, you're ready to move on to the last step, which is using the Data Dashboard!

The CW01 Wi-Fi Module is based on the ESP8266 Chip, which has the following Wi-Fi characteristics:

• 802.11 b/g/n protocol
• Wi-Fi 2.4 GHz, support WPA/WPA2

You will need to provide a Wi-Fi hotspot with WPA/WPA2 security. When the students use the kits, they will:

1. Connect to their xChip
2. Select the appropriate Wi-Fi SSID
3. Enter a password to configure their xChips

The CW01 Wi-Fi module does not currently support captive portals.

If your network uses captive portal authentication, and you are not able to supply a WPA/WPA2 hotspot for classroom use, whitelisting the XinaBox kits is a viable option.

Each CW01 has a MAC address that can be found in a variety of ways:

• Displayed while flashing the CW01, using the FlashTool
• Displayed in the configuration webpage on the CW01's "Setup" webpage.
  1. Power on a flashed CW01 and its status LED will illuminate blue
  2. The CW01 is broadcasting a Wi-Fi hotspot with a name like XINABOX_12345678
  3. Connect to XINABOX_12345678 with any computer or cell phone while the LED is blue (powercylce the CW01 if you miss it). The password is password
  4. You will be redirected to the setup page. (If that fails, go to 192.168.4.1)
• Displayed on the OD01 Display Module when connected to a CW01 that has been flashed.
• Displayed on the FlashTool program when flashing a CW01

The following servers and ports need to be reachable over this Wi-Fi hotspot

Server Address	Ports
mqtt.xinabox.cc	tcp 1883
link.xinabox.cc	tcp & udp 8441-8443

Note: Future versions of the XinaBox firmware will support communication on port 80, which should eliminate this issue.