Pavlov's Cat

Telegram

Arduino MKR IoT Bundle

Note: This tutorial could be outdated, please go <a href="https://docs.arduino.cc/tutorials/projects/pavlov-s-cat">here</a> for a more current version.If you ever tried to train a cat, you know how hard it is. Cats are their own masters, but now you have the chance to let the cats do your bidding using this IoT-enabled device.<h3 >Welcome to Pavlov's Cat Experiment! </h3>In this project, you will learn how to teach your cat when it is (and isn't) dinner time using nothing but the components in the MKR IoT Bundle and some cardboard.And we all know that cats already love cardboard boxes! Every time the cat hears a certain melody, it receive food. A light sensor detects the presence of a cat. Another melody does nothing. See how this will work?You will be able to monitor your cat's progression over time, and set the food dispensing rate from your phone. Once you have reached satisfying statistics, it is time to repurpose the sensor into a wearable. Your cat should from then on follow you if you make that beeping sound.Disclaimer: No cats were hurt in the development of this experiment. Also, no guarantee that the cat will eat the food, but you get the picture, right?<h3 >In a Nutshell</h3>You will be able to build your own food dispenser by following these simple step-by-step instructions. The dispenser is basically just some cardboard and a servo motor with some added Arduino magic.Using a messaging service called Telegram, you can set the amount of food to be dispensed and trigger the melodies played with the buzzer.A light sensor is used to detect if the cat reacted to the melody and got to the food.Pro Tip: You can host a webpage on the MKR1000 and display the collected data in a handy table.<h3 >Components</h3><ul ><li >Servo motor</li></ul><ul ><li >Phototransistor</li></ul><ul ><li >220 ohm resistor</li></ul><ul ><li >Buzzer</li></ul><figure><img src=https://projects.arduinocontent.cc/9545cfc6-04a1-453c-a232-e13d5a247289.gif /><figcaption> </figcaption></figure><h3 >Learning Goals</h3>In this experiment you will learn how to:<ul ><li >Manage Telegram Bots with a custom keyboard </li></ul><ul ><li >Set up and manage web server functionality from the MKR1000 itself. #ProTip </li></ul>Pro Tips are useful but not strictly necessary steps that add a layer of complexity to the project.<h3 >Want to Know More?</h3>This tutorial is part of a series of experiments that familiarise you with the MKR1000 and IoT. All experiments can be built using the components contained in the MKR IoT Bundle.<ul ><li ><a href="https://create.arduino.cc/projecthub/arduino/love-you-pillow-f08931">I Love You Pillow</a></li></ul><ul ><li ><a href="https://create.arduino.cc/projecthub/arduino/puzzlebox-c1f374">Puzzle Box</a></li></ul><ul ><li >Pavlov's Cat</li></ul><ul ><li ><a href="https://create.arduino.cc/projecthub/arduino/the-nerd-0144f9">The Nerd</a></li></ul><ul ><li ><a href="https://create.arduino.cc/projecthub/arduino/plant-communicator-7ea06f">Plant Communicator</a></li></ul><h3 >Telegram and Arduino</h3><a href="https://telegram.org/">Telegram </a>is a popular messaging app for both mobile and desktop. Besides letting us chat with our friends it also allows us to create handy and powerful chat-bots!The <a href="https://github.com/CasaJasmina/TelegramBot-Library">TelegramBot library </a>for Arduino gives us an easy way to implement the logic behind the chat-bot.To learn how to create a Bot and manage basic functionalities take a look at the <a href="https://create.arduino.cc/projecthub/arduino/love-you-pillow-f08931">I Love You Pillow</a> tutorial.<h3 >Create Your Custom Keyboard</h3>Telegram allows us to create a custom keyboard for fast replies. It means that when you talk to a bot a certain selection of buttons will be displayed instead of the default keyboard. You can easily customize those buttons and improve the user experience of your device.Our custom keyboard looks like this: <figure><img src=https://projects.arduinocontent.cc/65385427-639e-4017-b55a-9a8a5f5da8a9.png /><figcaption>Custom keyboard</figcaption></figure>We will use the first row of buttons to play the melody and dispense food, while the second row of buttons will be used to set the speed of the servo motor and therefore the amount of food to be dispensed.To create a custom keyboard we first need to declare it:<pre ><code >TelegramKeyboard keyboard_one; </code></pre>Then define the rows:<pre ><code > const char* row_one[] = {MusicAndFood, MusicNoFood}; const char* row_two[] = {OnePortion, TwoPortion, ThreePortion}; </code></pre>And finally assign the rows to the keyboard:<pre ><code >keyboard_one.addRow(row_one, 2); // assign a row to one or more keyboards keyboard_one.addRow(row_two, 3); // second argument is the length of the row </code></pre>Remember that an emoji needs to be sent using UNICODE. For instance to send an heart emoji we will use: <code >\\U00002764</code>You can see the full list of unicode emoji codes <a href="https://unicode.org/emoji/charts/full-emoji-list.html">here.</a> It means that to define our buttons we will use this:<pre ><code > const char* MusicAndFood = &#34;\\U0001F3B6 + \\U0001F36A&#34;; // Note + Cookie const char* MusicNoFood = &#34;\\U0001F3B6 NO \\U0001F36A&#34;; // Note NO Cookie const char* OnePortion = &#34;\\U0001F408&#34;; // CAT const char* TwoPortion = &#34;\\U0001F408 \\U0001F408&#34;; // 2 CATS const char* ThreePortion = &#34;\\U0001F408 \\U0001F408 \\U0001F408&#34;; // 3 CATS </code></pre><h3 >Here is the full sketch:</h3><pre ><code >#include &lt;WiFi101.h&gt; #include &lt;SPI.h&gt; #include &lt;TelegramBot.h&gt; const char* ssid = SECRET_SSID; // your network SSID (name) const char* password = SECRET_PSWD; // your network password const char BotToken[] = SECRET_BOT_TOKEN; WiFiSSLClient client; TelegramBot bot (BotToken, client); TelegramKeyboard keyboard_one; String OldChatId = &#34;&#34;; void setup() { Serial.begin(115200); delay(3000); // attempt to connect to Wifi network: Serial.print(&#34;Connecting Wifi: &#34;); Serial.println(ssid); while (WiFi.begin(ssid, password) != WL_CONNECTED) { Serial.print(&#34;.&#34;); delay(500); } Serial.println(&#34;&#34;); Serial.println(&#34;WiFi connected&#34;); // choose the emoji you like using UNICODE // here's the list https://unicode.org/emoji/charts/full-emoji-list.html const char* MusicAndFood = &#34;\\U0001F3B6 + \\U0001F36A&#34;; // Note + Cookie const char* MusicNoFood = &#34;\\U0001F3B6 NO \\U0001F36A&#34;; // Note NO Cookie const char* OnePortion = &#34;\\U0001F408&#34;; // CAT const char* TwoPortion = &#34;\\U0001F408 \\U0001F408&#34;; // 2 CATS const char* ThreePortion = &#34;\\U0001F408 \\U0001F408 \\U0001F408&#34;; // 3 CATS // define your row's const char* row_one[] = {MusicAndFood, MusicNoFood}; const char* row_two[] = {OnePortion, TwoPortion, ThreePortion}; keyboard_one.addRow(row_one, 2); // assing a row to one or more keyboards keyboard_one.addRow(row_two, 3); // second argument is the length of the row bot.begin(); } void loop() { message m = bot.getUpdates(); // Read new messages if ( m.chat_id != 0 ) { // Checks if there are some updates OldChatId = m.chat_id; Serial.println(m.text); bot.sendMessage(m.chat_id, &#34;Hello !&#34;, keyboard_one); } delay(1000); } </code></pre>Unfortunately the way the bot sends the emojis is not the same used to receive them. Using the EchoBot example is an easy way to see how bots receive emoji.For instance the emoji we will use are received like this:<pre ><code >ud83cudfb6 // Melody ud83cudf6a // Cookie ud83dudc08 // Cat </code></pre><h3 >Detect the Cat!</h3>In order to detect the presence of the cat we will use a phototransistor, which is able to measure the light intensity and therefore if someone has passed close to it.<figure><img src=https://projects.arduinocontent.cc/ce528985-8247-46c1-b7d3-be43b26780a2.png /><figcaption>Phototransistor wiring</figcaption></figure>Note that we used a 220 ohm resistor.To read values from the sensor we will only need a <code >analogRead(A6).</code> Since we are interested in detecting the cat presence only after the melody, and just for a certain amount of time we can use the following logic:<pre ><code >unsigned long timer; bool startDetecting = true; int threshold=200; // arbitrary value void setup(){ timer=millis() Serial.begin(9600); } void loop(){ if (startDetecting) { int value = analogRead(A6); if (value &lt; threshold) { Serial.println(&#34;cat detected!&#34;); startDetecting = false; } else if (millis() - timer &gt; 120000) { Serial.println(&#34;no cat detected in the past two minutes&#34;); startDetecting = false; } } } </code></pre>Note that we use the <code >millis()</code> function to set a timer. <code >Millis()</code> gives us the time in milliseconds since the board was up and running. We can use it to set timers and trigger events after a certain amount of time.We also use a threshold to determine if the cat was detected. That threshold is arbitrary, you can set it accordingly to your light condition.<h3 >Play the Song</h3>To play the song we will use the buzzer and the <code >tone() </code> function.<figure><img src=https://projects.arduinocontent.cc/7f76ea1f-0060-4e4a-a1ee-fe5dd58172f7.png /><figcaption>Buzzer Wiring</figcaption></figure>We will use a slightly modified version of the standard example toneMelody. You can find it in the dropdown menu: <pre ><code >examples &gt; digital &gt; toneMelody. </code></pre><h3 >Add the Servo Motor</h3>The servo is used to open the box and deliver food.Note that we use a variable <code >int PortionAmount = 1;</code> to set the amount of time the servo has to remain turned 90 degrees. We will be able to change its value through Telegram.Attach the servo to pin 7 and upload the this sketch to see it working.<pre ><code >#include &lt;Servo.h&gt; Servo myservo; // create servo object to control a servo int pos = 0; // variable to store the servo position int PortionAmount = 1; // Set default amount of food to 1 portion void setup() { myservo.attach(7); // attaches the servo on pin 6 to the servo object } void loop() { moveServo(); delay(2000); } void moveServo() { Serial.println(&#34;moving servo&#34;); for (pos = 0; pos &lt;= 90; pos += 1) { // goes from 0 degrees to 90 degrees myservo.write(pos); // tell servo to go to position in variable 'pos' delay(15); // waits 15ms for the servo to reach the position } delay(PortionAmount * 300); // keep the box open for a time interval based on the amount of food you want to deliver for (pos = 90; pos &gt;= 0; pos -= 1) { // goes from 90 degrees to 0 degrees myservo.write(pos); / tell servo to go to position in variable 'pos' delay(15); // waits 15ms for the servo to reach the position } } </code></pre><h3 >#ProTip: Add a Web Server</h3>One of the most powerful functionalities of the MKR1000 is the Access Point Mode.It allow us to host a web page on the MKR1000 that we can access to by using the board IP address and being connected to the same network.We will use this tool to print the data collected by the food dispenser.<figure><img src=https://projects.arduinocontent.cc/dea0b13e-8e5b-4d25-a61b-d333dd23f6aa.png /><figcaption>Web page hosted on the mkr1000</figcaption></figure>This step requires basic knowledge of HTML and CSS (or a lot of trust in the example sketch. You can check the basic web sever example at:<pre ><code >&gt; example &gt; WiFi101 &gt; AP_SimpleWebServer </code></pre>We will trigger the access point mode by sending a specific word to our Telegram Bot, which will reply with the link to reach the web page. Then the telegram client will be disconnected and the web-server is started.<pre ><code >else if(m.text == &#34;Server&#34;){ IPAddress ip = WiFi.localIP(); web_server_mode=true; String message = &#34;To see the webpage go to http://&#34;+IpToString(ip); bot.sendMessage(m.chat_id, message , keyboard_one); telegram_client.stop(); delay(1000); server.begin(); // start the web server on port 80 } </code></pre>The web page includes a button that will turn off the web server mode and go back as a telegram client:<pre ><code >if (currentLine.endsWith(&#34;GET /BACKBUTTON&#34;)) { // if button pressed web_server_mode=false; client.stop(); delay(1000); bot.begin(); bot.sendMessage(OldChatId, &#34;Back online !&#34;, keyboard_one); } </code></pre>Each time the cat detection is ends a new cell of the table is added with the gathered data: if food was delivered, if the cat showed up within two minutes and how long did it take to reach the dispenser.<pre ><code >AddTableCell(food/noFood, Yes/No, TimeValue); </code></pre>Then the String containing all the table cells is updated and integrated in the rest of the main html.<pre ><code > table_cells+=cell; // add new cell html = html_1 + table_cells + html_2; // add cells to main html </code></pre>Check at the final Pro example to see how to integrate all of these new functionalities!Tip: if you want your data to survive a reset of the board have a look at the <a href="https://github.com/cmaglie/FlashStorage">Flash Storage</a> library or check the <a href="https://create.arduino.cc/projecthub/67621/the-nerd-0144f9">Nerd</a> project!

Pavlov's Cat

Time to get Pavlovian on your cat!