App Inventor and Particle

This is set up to work with the WEB-Connected LED example app for the Particle Spark, Photon, or Electron.

App Inventor is an easy way to make Apps for the Android platform. We will go through how to use App Inventor for communicating with any Particle device.

 

The Designer

You will want to make two buttons. The button names do not matter, but we will just call them ButtonOn and ButtonOff.

Next we will add the Web component with the following attributes.

1. Check AllowCookies.
2. Enter https://api.particle.io/v1/devices/ in the Url field.

Code Blocks

Now we get into the codding. The thing to keep in mind is that a Particle function can only be called with an HTTP POST request. App Inventor makes it easy to send GET data so we will have to jump through a few hoops to get there.

Set Global Variables

First, lets set up some global variables. These can be found under Variables and initialize global. To this we will add a Text value to start with.

1. Make sure the serverURL is set to “https://api.particle.io/v1/devices/“.
2. Copy the Device ID and use that for the deviceID variable.
3. Locate the Access Token from your Particle account and use that for the accessToken.
4. 
   Fun should be set to the function name from the Particle code. For this instance, we are calling “led”.
5. Var is a placeholder for the value we will be sending to the function. It is blank.
6. HTTP_Reply can be used to get a conformation message from the Particle device.
7. PINstate can be used later to toggle the On/Off button.

The Send Procedure

In App Inventor, a Procedure is a block of code that can be called on to run at any time. This saves time and space when you need to run the same code over and over again.

1. From the Procedures blocks, add the Do block.
2. Name this procedure “SendToParticle“.
3. Add the Set Web1 block from the Web1 section to the new procedure.
4. Now we will assemble a string for the set Web1.Url by using the Join block from Text.
5. All together we will be joining the serverURL, deviceID, “/“, Fun, “?access_token=“, and accessToken.
6. Under the Set.Url block, we will add a Call.PostText block from the Web1 section.
7. To this we will add a Join block for sending to our Particle function via POST request.
8. We will join “params=” and the Var value.

When ever this procedure is called Val will be sent via POST to:

https://api.particle.io/v1/devices/your-device-id/led?access_token=your-access-token

The Button Click

For now we will just use one button for ON and one for OFF. So we want to grab the when.click from the ButtonOn and ButtonOff blocks.

1. To that we will add a Set block for the Var variable. Also add the value of “on” to this.
2. Next we will be calling on the SendToParticle Procedure.

 

 

That is it!

Once this App is loaded onto your phone it will turn the built-in LED, attached to Pin 7 on the Particle device, on or off.

What Next?

Well this is a good place to get you started. From here you can try to make the button toggle the LED on or off.

Change the button into an image to make things look a little nicer.

Add a Relay to Pin 7 on the Particle device and you can turn an actual light on or off.

The possibilities are nearly endless and this will help get you well on the road to making it easy to use the next big IOT… thing.