Reference:

• https://www.baeldung.com/spring-boot-console-app
• https://www.programcreek.com/java-api-examples/?code=aws%2Faws-iot-device-sdk-java%2Faws-iot-device-sdk-java-master%2Faws-iot-device-sdk-java-samples%2Fsrc%2Fmain%2Fjava%2Fcom%2Famazonaws%2Fservices%2Fiot%2Fclient%2Fsample%2FpubSub%2FPublishSubscribeSample.java

The Verkundenbot Device is an AWS IoT enabled device.

The messages determine the state of the physical device.

For the purposes of this project I used a RaspberryPi 2 I had laying around. Before we do anything else we should make sure we are running the latest version of Raspian.

Begin by updating the repository package list:

sudo apt update

When this is done, run the upgrade command:

sudo apt dist-upgrade

Follow any prompts, and wait for the Pi to be upgraded. When you’re done, type:

sudo apt clean

This will discard any unneeded files that have been downloaded as part of the upgrade. Finish by restarting:

sudo reboot

When your Raspberry Pi has restarted, you’ll be using the latest version of Raspbian.

• Datadog - we use Datadog as our monitoring system. Any critical alerts that are triggered should be sent to the device.
• Deployments (Jenkings or AWS CodeBuild) - When we deploy code we want to notify the device so that we get an audible alerting on what system was update and who made the change.
• Verkundenbot Web App - There is a React web app where you can interect with the device. You can control plugs A, B and C and you can send custom messages which will be converted to voice and send through the speakers.
• PagerDuty (future) - in the future we may move alerts from Datadog to PagerDuty. At which point we will want to move the webhook from Datadog to PagerDuty as well.

How will each source interact with the API and what do the requests look like?

• Datadog -
  • Sending alerts - /alarm
    • trigger the strobe for a short time
    • turn the status LED red
    • trigger an audible message
      • alarm sound once
      • "In store pixels are unstable"
  • Re-Sending alerts - /alarm
    • trigger the strobe for a short time
    • turn the status LED red
  • Sending Recovery message - /alarm
    • trigger the strobe for a short time
    • trigger audible message
      • play recover sound
      • "In store pixels have recovered"
    • turn the status LED blue
• Deployments -
  • Doing a deployment - /deployment
    • trigger the strobe for a short time
    • "<first_name> <last_name> is deploying code to "
    • once deployment completes
      • play mario bros sound
• Verkundenbot Web App - /plug/{id}/{desired-state}
  • Trigger plug A from UI - /plug/a
    • turn on plug A
  • Trigger plug B from UI - /plug/b
    • turn on plug B
  • Trigger plug C from UI - /plug/c
    • turn on plug C
  • Message - /free-speach
    • play whatever message that's submitted
• PagerDuty (future) - TDB

mvn compile

mvn package