Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dangerdev004/buzzbox

This is the code to run the project Buzzbox
https://github.com/dangerdev004/buzzbox

buzzer irsensor led nodemcu-esp8266 pir-sensor twilio-sms-api ultrasonic-sensor

Last synced: 12 days ago
JSON representation

This is the code to run the project Buzzbox

Awesome Lists containing this project

README

        

# Buzzbox

An example application that demonstrates how to send SMS or MMS messages with an ESP8266 connected to a friendly WiFi network, when IR,PIR & Ultrasonic sensors are triggered all at once

Please read [Twilio's sending messages article](https://www.twilio.com/docs/guides/send-sms-and-mms-messages-esp8266-cpp) and [Twilio's receiving and replying to messages article](https://www.twilio.com/docs/guides/receive-and-reply-sms-and-mms-messages-esp8266-c-and-ngrok) for more information.

Once this application is loaded to the ESP8266 it will:

1) Send an SMS (or MMS if you choose) to a number
2) Start a webserver with the route '/message'
3) Listen for requests to '/message' and respond with a canned response or by reacting to a command from the master number.

## Build example:

In Arduino IDE, first ensure your ESP8266 is burned with the Arduino bootloader and connected. Then, merely adjust the globals at the top of the .ino file and hit the 'Upload' button.

You'll then want to edit the following variables in twilio_esp8266_arduino_example.ino:
* ssid: Your network SSID
* password: Network's password
* fingerprint (maybe): The SHA1 Fingerprint of api.twilio.com, you
can check with a web browser
* account_sid: from twilio.com/console
* auth_token: from twilio.com/console
* to_number: A number to send the test SMS (or MMS) to
* from_number: An number from twilio.com/console authorized to send SMS and/or MMSes
* message_body: Message body to send
* master_number: 'Authorized' number for this ESP8266 example
* media_url (optional): Url to an image to send a test MMS

## Run example:

Will run automatically once uploaded to the board. If you do not get a message, enable serial debugging.

Either serial debugging or perhaps a peek at your router screen will reveal the assigned IP address of the ESP8266. :8000/message is the webhook of interest; use ngrok or another means to espose it to Twilio. Note that you'll need to provide a https endpoint!

### Fingerprint failure

The most common reason the sketch fails (assumign you correctly copied credentials) is the `api.twilio.com` certificate changes. See [this section](https://www.twilio.com/docs/sms/tutorials/how-to-send-sms-messages-esp8266-cpp#dealing-with-message-failure) of the Twilio Docs to update the fingerprint in your code.

## Motivations

Hopefully you can use this as the base of your ESP8266 project with Twilio!

## Meta & Licensing

* [MIT License](http://www.opensource.org/licenses/mit-license.html)