What's in the box

Your new Photon! Note that many components pictured will only be included if you purchased a Photon Kit.

Congratulations on being the owner of a brand new Particle Device! Go ahead and open the box. You can see the different kit addons and check out the Photon datasheet if you like!

If you have an Internet Button, read through this section to get started and connect your device, then hop over to the Internet Button tutorial for more detailed info.

Let's quickly go over what you see.

What's on it?

The Wi-Fi module

This is probably why you bought your device-- the Wi-Fi module allows your Photon to communicate with the internet. It connects your device to the internet in the same way that your smartphone might connect to a wifi network. Do not press down on the Photon's module. Doing so triggers a reset and is generally not good for the Photon.

The microcontroller

The microcontroller is the brain of your device. It runs your software and tells your prototype what to do. Unlike your computer, it can only run one application (often called firmware or an embedded application). This application can be simple (just a few lines of code), or very complex, depending on what you want to do. The microcontroller interacts with the outside world using pins.

The pins

Pins are the input and output parts of the microcontroller that are exposed on the sides of your device. GPIO pins can be hooked to sensors or buttons to listen to the world, or they can be hooked to lights and buzzers to act upon the world. There are also pins to allow you to power your device, or power motors and outputs outside of your device. There are pins for Serial/UART communication, and a pin for resetting your device.

Buttons & LEDs

There are several awesome buttons and LEDs on your Photon to make it easier to use.

The SETUP button is on the left and the RESET button is on the right. You can use these buttons to help you set your device's mode. The RGB LED is in the center of your Photon, above the module. The color of the RGB LED tells you what mode your Photon is currently in. The D7 LED is next to the D7 pin on your Photon, on the upper right quadrant. This LED will turn on when the D7 pin is set to HIGH.

  • Software
    • Particle Mobile App - iPhone | Android
    • Note: We highly recommend using the mobile app for first time setup.
  • Hardware
    • Your Particle device, brand new and out of the box!
    • USB to micro USB cable
    • Power source for USB cable (such as your computer, USB battery, or power brick)
    • Your iPhone or Android or Windows smartphone
  • Wi-Fi Settings
    • 2.4GHz capable router
    • Channels 1-11
    • WPA/WPA2 encryption
    • On a broadcast SSID network
    • Not behind a hard firewall or Enterprise network
    • Note: We do not recommend using WEP Wi-Fi settings, for security reasons.
  • Experience
    • None! This is your first project.

Connect Your Photon

In this example, we will connect your device to the internet for the very first time. Then, we will blink the D7 LED on your device by using your smartphone.

Step 1: Power On Your Device

plug in your device!

Plug the USB cable into your power source. (Your computer works perfectly for this purpose.) Your Particle device does not need your computer to connect to wifi. You could just as easily power your device with a power brick, a battery shield, or another power source wired to the VIN pin.

As soon as it is plugged in, the RGB LED on your device should begin blinking blue.

If your device is not blinking blue, hold down the SETUP button.

Step 2a: Connect your Photon to the Internet using the setup web application

  • Go to setup.particle.io
  • Click on Setup a Photon
  • After clicking on NEXT, you should be presented with a file (photonsetup.html)
  • Open the file

After opening the file:

  • Step 5 Connect your PC to the Photon, by connecting to the network named PHOTON-...
  • Step 6 Configure your Wi-Fi credentials

Note: If you mistyped your credentials, the Photon will blink dark blue or green. You have to go through the process again (by refreshing the page or clicking on the retry process part)<

  • Step 7 Rename your device. You will also see a confirmation if the device was claimed or not

Note: Make sure your Photon is not part of a product before claiming it

Why a separate file?

We care a lot about security, and we want to make sure that everything you do is safe. Downloading a local file ensures that the credentials are sent directly to the Photon, without any chance of being intercepted.

Step 2b: Connect your Photon to the Internet using your smartphone

Open the app on your phone. Log in or sign up for an account with Particle if you don't have one.

Press the plus icon and select the device you'd like to add. Then follow the instructions on the screen to connect your device to Wi-Fi. Your device remembers up to 5 wifi networks, and it will connect to these automatically if it can find them.

This may take a little while - but don't worry.

Once you have connected your device, it has learned that network. Your device can store up to five networks. To add a new network after your initial setup, you'd put your device into listening mode again and proceed as above (the claiming part can be skipped). If you feel like your device has too many networks on it, you can wipe your device's memory of any Wi-Fi networks it has learned. You can do so by continuing to hold the SETUP button for 10 seconds until the RGB LED flashes blue quickly, signaling that all profiles have been deleted.

The Particle App should now be on the TinkerWe have taken the liberty of loading some firmware onto your device for you. It is called Tinker, and it helps you talk to your device by sending power to the pins and reading power levels from the pins. More info about Tinker is available here. screen, as shown below.

Tinker on your Phone!

As you can see on your smartphone, the circles represent different pins on your device. If you tap on these circles, you can see the Tinker functions available for the associated pins.

We could use Tinker and the smartphone app to talk to any pin on your device. If you had a buzzer, an LED, a sensor, etc., you could interact with it using Tinker on your phone. But since I know you're very eager to get started, let's use an LED already provided on your device.

The D7 pin comes already wired to a small blue LED on the face of your device. When you set the power of the D7 pin to high, this LED turns on. Let's do that now.

Tap D7 then digitalWrite in the popup. Now when you tap the D7 circle the tiny blue LED should turn off or on!

Congratulations, you just blinked an LED over the internet, using your Particle device!

For more hardware examples to try, visit the hardware examples.