#particlephoton

"Episode 019: Internet Arcade Clock Thing?!"

In this episode I walk through the process of building the hardware for an internet connected rgb matrix arcade clock!

If you would like to support DIY Engineering, please head over to: http://www.diy.engineering/sponsor

*You make the difference, please Like/Comment/Subscribe to support the channel.

FOLLOW ME: http://www.diy.engineering https://www.instagram.com/david.g.johnson/ https://www.facebook.com/doityourselfengineering/ https://twitter.com/DIY_Engineering https://www.youtube.com/channel/UCkgxMWPImqt1VxMaI9d79LA https://www.thingiverse.com/DavidJohnson https://www.linkedin.com/in/david-johnson-69a2972 https://github.com/dgjohnson

Circuits.io Schematic: https://circuits.io/circuits/2962119-8bitclock

RGB Matrix 8x32 (WS2812b): https://goo.gl/ScdmZM

MP3 DF Player Mini: https://goo.gl/nm6FJ9

Photon: https://goo.gl/g5SCXt

Voltage Regulator: https://goo.gl/VRfxyu

Resistors: https://goo.gl/27bY1n

Before you begin.

Read about the particle and how to dump code into the device here https://docs.particle.io/guide/getting-started/intro/photon/

Particle function 

These are a simple cloud functions which control the device based on the instructions written.

Write the particle functions using Spark.function('function_name', callback)

Below is a sample 'lights' function. This will on/off the default LED on particle based on the commands given by particle API over the internet.

// ----------------------------------- // Controlling LEDs over the Internet // ----------------------------------- // First, let's create our "shorthand" for the pins // Same as in the Blink an LED example: // led1 is D0, led2 is D7 int led1 = D0; int led2 = D7; // Last time, we only needed to declare pins in the setup function. // This time, we are also going to register our Spark function void setup() {   // Here's the pin configuration, same as last time   pinMode(led1, OUTPUT);   pinMode(led2, OUTPUT);   // We are also going to declare a Spark.function so that we can turn the LED on and off from the cloud.   Spark.function("lights",ledToggle);   // This is saying that when we ask the cloud for the function "led", it will employ the function ledToggle() from this app.   // For good measure, let's also make sure both LEDs are off when we start:   digitalWrite(led1, LOW);   digitalWrite(led2, LOW); } // Last time, we wanted to continously blink the LED on and off // Since we're waiting for input through the cloud this time, // we don't actually need to put anything in the loop void loop() {   // Nothing to do here } // We're going to have a super cool function now that gets called when a matching API request is sent // This is the ledToggle function we registered to the "led" Spark.function earlier. int ledToggle(String command) {    /* Spark.functions always take a string as an argument and return an integer.    Since we can pass a string, it means that we can give the program commands on how the function should be used.    In this case, telling the function "on" will turn the LED on and telling it "off" will turn the LED off.    Then, the function returns a value to us to let us know what happened.    In this case, it will return 1 for the LEDs turning on, 0 for the LEDs turning off,    and -1 if we received a totally bogus command that didn't do anything to the LEDs.    */    if (command=="on") {        digitalWrite(led1,HIGH);        digitalWrite(led2,HIGH);        return 'light-on';    }    else if (command=="off") {        digitalWrite(led1,LOW);        digitalWrite(led2,LOW);        return 0;    }    else {        return -1;    } }

** Code is taken from Particle cloud IDE examples.

Details of your particle device? 🔌

Do curl -X GET https://api.particle.io/v1/devices/xxxxxDEVICE-IDxxxxxxxxxx?access_token=xxxxxxxxxxxxxa642c8c9bd7cec32dbexxx

This will also give the list of all the functions which are loaded onto your particle.

Run the above function with an argument (on/off)?

To ON the LED do, 🌕 curl -X POST https://api.particle.io/v1/devices/xxxxxDEVICE-IDxxxxxxxxxx/function_name -d "value=on" -d access_token=xxxxxxxxxxxxxa642c8c9bd7cec32dbexxx

To OFF the LED do, 🌚 curl -X POST https://api.particle.io/v1/devices/xxxxxDEVICE-IDxxxxxxxxxx/function_name -d "value=off" -d access_token=xxxxxxxxxxxxxa642c8c9bd7cec32dbexxx