"Alexa, Light My Mood"

Arduino IoT Cloud

Amazon Alexa Official Arduino Skill

Voice Controlled Light Bundle

Arduino Web Editor

Note: This tutorial could be outdated, please go <a href="https://docs.arduino.cc/tutorials/projects/alexa-light-my-mood">here</a> for a more current version.<h3 >Intro: Arduino IoT Cloud</h3><a href="https://create.arduino.cc/iot/">Arduino IoT Cloud </a>is a platform that enables anyone to build IoT connected objects with ease. In order to control our MKR RGB Shield using Alexa, we'll also be using the <a href="https://www.amazon.com/Arduino-LLC/dp/B07ZT2PK2H">Official Arduino Alexa Skill.</a>If you are new to Arduino IoT Cloud, we advise to first take a look at <a href="https://create.arduino.cc/projecthub/133030/iot-cloud-getting-started-c93255">this introductory project,</a> which will give you an overview and guide you through the process of setting up one of the supported boards, IoT Cloud Things and Properties and get you onboard.<h3 >Part 1: Arduino IoT Cloud</h3>From the main <a href="https://create.arduino.cc/iot/things">IoT Cloud page,</a> we'll create a new thing and assign it a meaningful name. We'll then select the board we are going to use. If you can't see your board you might have skipped the <a href="https://create.arduino.cc/getting-started">getting started procedure:</a> look at the section above.Once done, we'll add a property to our thing that will represent the RGB shield. As a type remember to choose ColoredLight which lets us control an RGB Light, allowing us to change its brightness and colour. Set it as ReadandWrite because we'll need to control its behaviour through Alexa.Here it is what the Dashboard view of your Thing should look like at this point:<figure><img src=https://projects.arduinocontent.cc/6a55976e-2be7-4bb7-824b-21581d3cd069.png /><figcaption> </figcaption></figure>When adding properties make sure you only use types listed under the Smart Home section, otherwise they will not work with Alexa.<figure><img src=https://projects.arduinocontent.cc/73b7eaec-cba1-44a5-8b4d-888cc1aa98da.png /><figcaption>The Smart Home Section</figcaption></figure>Now go to the Web Editor by clicking the Edit Sketch button in your Thing's edit view.<h3 >Part 2: Arduino Web Editor</h3>In the Web Editor we need to add some code to the Sketch automatically generated for us.The first thing to include are the libraries which will help us to control the MKR RGB Shield:<pre ><code >#include &lt;ArduinoGraphics.h&gt; #include &lt;Arduino_MKRRGB.h&gt; </code></pre>We have to include both libraries because <a href="https://www.arduino.cc/en/Reference/ArduinoMKRRGB">Arduino_MKRRGB</a> depends on <a href="https://www.arduino.cc/en/Reference/ArduinoGraphics">ArduinoGraphics</a>.Now in the setup function we can initialize the Arduino MKR RGB Shield with:<pre ><code >if (!MATRIX.begin()) { Serial.println(&#34;Failed to initialize MKR RGB shield!&#34;); while (1); } MATRIX.brightness(10); </code></pre>This way if the shield is not installed Sketch execution will be blocked.The brightness is set to 10 for development purposes (no external power supplyneeded). You can use larger values (supported range is from 0 to 255) if you plan to use a 4 Amps 5v power supply as stated in the <a href="https://www.arduino.cc/en/guide/MKRRGBShield">getting started guide</a>.Now it's time to implement our callback function: the one responsible of setting the colour/state of the LEDs. This function will be executed every time a change in a Property's value is pulled from IoT Cloud.Let's implement <code >onMoodLightChange</code>:<pre ><code >void onMoodLightChange() { uint8_t r, g, b; moodLight.getValue().getRGB(r, g, b); MATRIX.beginDraw(); if (moodLight.getSwitch()) { Serial.println(&#34;R:&#34;+String(r)+&#34; G:&#34;+String(g)+ &#34; B:&#34;+String(b)); MATRIX.fill(r, g, b); MATRIX.rect(0, 0, MATRIX.width(), MATRIX.height()); } else{ MATRIX.clear(); } MATRIX.endDraw(); } </code></pre>With the code above we first read the rgb value from the cloud and save the representation of the RGB colour in some variables, we then verify if the light switch is on; if it is we can turn on the light, using the colour values read before. Otherwise we turn off the light.The <code >beginDraw</code> and <code >endDraw</code> functions are used to alter the state of the matrix, <code >fill</code> is used to select the colour to use, rect is a function used to specify the region to fill.Of course we can define custom colours by name in the Alexa app so we won't have to manually tell which amounts of Red, Green or Blue we want to set. <h3 >Part 3: Amazon Alexa Skill Setup</h3>We will now need the Amazon Alexa app which can be downloaded from the <a href="https://apps.apple.com/us/app/amazon-alexa/id944011620">Apple App Store </a>or the <a href="https://play.google.com/store/apps/details?id=com.amazon.dee.app">Google Play Store.</a> Once installed, login with your existing account or create a new one.Let's go through the steps necessary to install the Arduino Alexa Skill. We'll follow the sequence of images below to see all the required steps.<div id="gallery"><img id="gallery" src=https://projects.arduinocontent.cc/d724b341-40f1-4f5c-9ce8-1094a11fd987.png /><figcaption>1/9: Tap on "Devices"</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/dadfdb38-2a6e-4ed8-9b79-557ac3fc5833.png /><figcaption>2/9: Let's now enable our Smart Home Skills</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/75973a67-a30e-4982-8256-a423a825d9b3.png /><figcaption>3/9: We'll be presented with the featured ones. Time to search for what we need :)</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/c1f37947-3b93-45e6-bcd2-f59ab7039fb6.png /><figcaption>4/9: Typing "Arduino" and tapping "search" we'll obtain a list. That's the one we need!</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/e33b7e47-2836-4d7b-90d2-fceecad52c4b.png /><figcaption>5/9: Once selected, we'll have to enable it</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/cdf0a3a5-69bb-4af1-81e6-0c3e38e4fb61.png /><figcaption>6/9: Let's login with our Arduino Create account credentials</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/9bdc77c1-e0b3-405d-a2c6-b23ebf7272e6.png /><figcaption>7/9: Our Alexa and Arduino IoT Cloud can now talk to each other :)</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/25f1e23b-f86c-41e7-b70f-887c52193d4b.png /><figcaption>8/9: Time to discover our devices</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/28eaed82-84a3-4eb2-8ebe-05bbc6059b88.png /><figcaption>9/9: A little bit of patience won't hurt</figcaption></div><h3 >Part 4: Amazon Alexa devices setup</h3>After waiting a little bit, you should see that some devices have been found.Follow the sequence of images below to setup the device:<div id="gallery"><img id="gallery" src=https://projects.arduinocontent.cc/3841059e-0801-46d5-9e29-d939f9cbe119.png /><figcaption> 1/5: Now you should see that some devices have been found, click on "Set Up Device"</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/6b02267d-e1b9-4b47-b84e-01afc773cbad.png /><figcaption>2/5: If you like you can also add it to a group to keep things organized</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/ade06ea4-9d58-4e69-95d7-85c2683defb8.png /><figcaption>3/5: Choose the group you prefer and click on "Next"</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/61a1595d-ba85-4efc-9856-54e694a6f346.png /><figcaption>4/5: Finished! :)</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/685aed28-fa13-4c36-9011-c5d872d86f26.png /><figcaption>5/5: We can finally control our light's colour through Alexa!</figcaption></div>Note: The devices will be named according to how we named our properties in Arduino IoT Cloud. If you have trouble finding the devices, you might have not selected your property from the &#34;Smart Home&#34; section.We're done, it's now time to voice control our MKR RGB Shield asking things like<ul ><li >”Alexa, turn on the light in the office”</li></ul><ul ><li >”Alexa, change the colour of the mood light to red”</li></ul><ul ><li >”Alexa, set the brightness of the mood light to 50%”</li></ul>Have fun playing with Alexa and IoT Cloud. If you have questions and/or build this project let us know in the comments below.Thank you, the Arduino Team

"Alexa, Light My Mood"

Learn how to control your MKR RGB Shield using Arduino IoT Cloud and Amazon Alexa.