IoT-For-Beginners/translations/pcm/6-consumer/lessons/3-spoken-feedback/single-board-computer-set-timer.md

Set timer - Virtual IoT Hardware and Raspberry Pi

For dis part of di lesson, you go call your serverless code to sabi di speech, and set timer for your virtual IoT device or Raspberry Pi based on di result.

Set timer

Di text wey go come back from di speech to text call need to dey send go your serverless code make e process am with LUIS, wey go return di number of seconds for di timer. Dis number of seconds fit dey use to set timer.

You fit set timer using Python threading.Timer class. Dis class dey take delay time and one function, and after di delay time, di function go run.

Task - send di text go di serverless function

1. Open di smart-timer project for VS Code, and make sure say di virtual environment dey load for di terminal if you dey use virtual IoT device.

2. For di top of di process_text function, declare one function wey dem go call get_timer_time to call di REST endpoint wey you create:

   def get_timer_time(text):
   

3. Add di code wey dey below to dis function to define di URL wey you go call:

   url = '<URL>'
   

   Change <URL> to di URL of your REST endpoint wey you build for di last lesson, whether e dey for your computer or for di cloud.

4. Add di code wey dey below to set di text as property wey dem go pass as JSON for di call:

   body = {
       'text': text
   }
   
   response = requests.post(url, json=body)
   

5. For di bottom of dis, collect di seconds from di response payload, return 0 if di call no work:

   if response.status_code != 200:
       return 0
   
   payload = response.json()
   return payload['seconds']
   

   Successful HTTP calls dey return status code for di 200 range, and your serverless code dey return 200 if di text dey process and dem recognize am as di set timer intent.

Task - set timer for background thread

1. Add di import statement wey dey below for di top of di file to import di threading Python library:

   import threading
   

2. For di top of di process_text function, add one function to talk response. For now, e go just write for di console, but later for dis lesson e go talk di text.

   def say(text):
       print(text)
   

3. For di bottom of dis, add one function wey timer go call to announce say di timer don finish:

   def announce_timer(minutes, seconds):
       announcement = 'Times up on your '
       if minutes > 0:
           announcement += f'{minutes} minute '
       if seconds > 0:
           announcement += f'{seconds} second '
       announcement += 'timer.'
       say(announcement)
   

   Dis function dey take di number of minutes and seconds for di timer, and e go build one sentence to talk say di timer don finish. E go check di number of minutes and seconds, and e go only include each time unit if e get number. For example, if di number of minutes na 0, e go only include seconds for di message. Dis sentence go then dey send go di say function.

4. For di bottom of dis, add di create_timer function wey dey below to create timer:

   def create_timer(total_seconds):
       minutes, seconds = divmod(total_seconds, 60)
       threading.Timer(total_seconds, announce_timer, args=[minutes, seconds]).start()
   

   Dis function dey take di total number of seconds for di timer wey dem go send for di command, and e go convert am to minutes and seconds. E go then create and start timer object using di total number of seconds, pass di announce_timer function and one list wey get di minutes and seconds. When di timer finish, e go call di announce_timer function, and e go pass di content of dis list as di parameters - so di first item for di list go dey pass as di minutes parameter, and di second item as di seconds parameter.

5. For di end of di create_timer function, add some code to build one message wey dem go talk to di user to announce say di timer dey start:

   announcement = ''
   if minutes > 0:
       announcement += f'{minutes} minute '
   if seconds > 0:
       announcement += f'{seconds} second '    
   announcement += 'timer started.'
   say(announcement)
   

   Again, e go only include di time unit wey get value. Dis sentence go then dey send go di say function.

6. Add di code wey dey below to di end of di process_text function to collect di time for di timer from di text, then create di timer:

   seconds = get_timer_time(text)
   if seconds > 0:
       create_timer(seconds)
   

   Di timer go only dey create if di number of seconds big pass 0.

7. Run di app, and make sure say di function app dey run too. Set some timers, and di output go show say di timer dey set, and e go show when e finish:

   pi@raspberrypi:~/smart-timer $ python3 app.py 
   Set a two minute 27 second timer.
   2 minute 27 second timer started.
   Times up on your 2 minute 27 second timer.
   

💁 You fit find dis code for di code-timer/pi or code-timer/virtual-iot-device folder.

😀 Your timer program work well!

---

Disclaimer:
Dis dokyument don use AI transleshion service Co-op Translator do di transleshion. Even as we dey try make am correct, abeg make you sabi say transleshion wey machine do fit get mistake or no dey accurate well. Di original dokyument for im native language na di one wey you go take as di correct source. For important mata, e good make you use professional human transleshion. We no go fit take blame for any misunderstanding or wrong interpretation wey fit happen because you use dis transleshion.