| title | description | author | manager | ms.service | services | ms.topic | ms.tgt_pltfrm | ms.date | ms.author |
|---|---|---|---|---|---|---|---|---|---|
Receive an email when door is opened using SendGrid service and Azure Functions | Microsoft Docs |
Monitor the magnetic sensor to detect when a door is opened and use Azure Functions to send an email notification. |
liydu |
jeffya |
iot-hub |
iot-hub |
conceptual |
arduino |
03/19/2018 |
liydu |
The MXChip IoT DevKit contains a built-in magnetic sensor. In this project, you detect the presence or absence of a nearby strong magnetic field -- in this case, coming from a small, permanent magnet.
In this project, you learn:
- How to use the MXChip IoT DevKit's magnetic sensor to detect the movement of a nearby magnet.
- How to use the SendGrid service to send a notification to your email address.
Note
For a practical use of this project, perform the following tasks:
- Mount a magnet to the edge of a door.
- Mount the DevKit on the door jamb close to the magnet. Opening or closing the door will trigger the sensor, resulting in your receiving an email notification of the event.
Finish the Getting Started Guide to:
- Have your DevKit connected to Wi-Fi
- Prepare the development environment
An active Azure subscription. If you do not have one, you can register via one of these methods:
- Activate a free 30-day trial Microsoft Azure account.
- Claim your Azure credit if you are an MSDN or Visual Studio subscriber.
SendGrid is a cloud-based email delivery platform. This service will be used to send email notifications.
Note
If you have already deployed a SendGrid service, you may proceed directly to Deploy IoT Hub in Azure.
To provision Azure services, use the Deploy to Azure button. This button enables quick and easy deployment of your open-source projects to Microsoft Azure.
Click the Deploy to Azure button below.
If you are not already signed into your Azure account, sign in now.
You now see the SendGrid sign-up form.
Complete the sign-up form:
-
Resource group: Create a resource group to host the SendGrid service, or use an existing one. See Using resource groups to manage your Azure resources.
-
Name: The name for your SendGrid service. Choose a unique name, differing from other services you may have.
-
Password: The service requires a password, which will not be used for anything in this project.
-
Email: The SendGrid service will send verification to this email address.
Check the Pin to dashboard option to make this application easier to find in the future, then click Purchase to submit the sign-in form.
After the deployment completes, click it and then click the Manage button. Your SendGrid account page appears, where you need to verify your email address.
On the SendGrid page, click Settings > API Keys > Create API Key.
On the Create API Key page, input the API Key Name and click Create & View.
Your API key is displayed only one time. Be sure to copy and store it safely, as it is used in the next step.
The following steps will provision other Azure IoT related services and deploy Azure Functions for this project.
Click the Deploy to Azure button below.
The sign-up form appears.
Fill in the fields on the sign-up form.
-
Resource group: Create a resource group to host the SendGrid service, or use an existing one. See Using resource groups to manage your Azure resources.
-
Iot Hub Name: The name for your IoT hub. Choose a unique name, differing from other services you may have.
-
Iot Hub Sku: F1 (limited to one per subscription) is free. You can see more pricing information on the pricing page.
-
From Email: This field should be the same email address you used when setting up the SendGrid service.
Check the Pin to dashboard option to make this application easier to find in the future, then click Purchase when you're ready to continue to the next step.
Next, load the sample code in VS Code and provision the necessary Azure services.
- Make sure your DevKit is not connected to your computer.
- Start VS Code.
- Connect the DevKit to your computer.
Note
When you launch VS Code, you may receive an error message stating that it cannot find the Arduino IDE or related board package. If you receive this error, close VS Code, launch the Arduino IDE again, and VS Code should locate the Arduino IDE path correctly.
Expand the left side ARDUINO EXAMPLES section, browse to Examples for MXCHIP AZ3166 > AzureIoT, and select DoorMonitor. This action opens a new VS Code window with a project folder in it.
You can also open the example app from the command palette. Use Ctrl+Shift+P (macOS: Cmd+Shift+P) to open the command palette, type Arduino, and then find and select Arduino: Examples.
In the solution window, run the cloud provisioning task:
- Type
Ctrl+P(macOS:Cmd+P). - Enter
task cloud-provisionin the provided text box.
In the VS Code terminal, an interactive command line guides you through provisioning the required Azure services. Select all of the same items from the prompted list that you previously provisioned in Deploy IoT Hub in Azure.
Note
If the page hangs in the loading status when trying to sign in to Azure, refer to the "page hanges when logging in" section of the IoT DevKit FAQ to resolve this issue.
Next, upload the code for the device.
-
Use
Ctrl+Pto runtask device-upload. -
The terminal prompts you to enter configuration mode. To do so, hold down button A, then push and release the reset button. The screen displays the DevKit identification number and the word Configuration.
-
Put the DevKit into configuration mode: Hold down button A, then push and release the reset button. The screen displays 'Configuration'.
-
Click
Cmd+Pto runtask device-upload.
The connection string that is retrieved from the Provision Azure services step is now set.
VS Code then starts verifying and uploading the Arduino sketch to the DevKit.
The DevKit reboots and starts running the code.
Note
Occasionally, you may receive an "Error: AZ3166: Unknown package" error message. This error occurs when the board package index is not refreshed correctly. To resolve this error, refer to the development section of the IoT DevKit FAQ.
The program first initializes when the DevKit is in the presence of a stable magnetic field.
After initialization, Door closed is displayed on the screen. When there is a change in the magnetic field, the state changes to Door opened. Each time the door state changes, you receive an email notification. (These email messages may take up to five minutes to be received.)
If you encounter problems, refer to the IoT DevKit FAQ or connect using the following channels:
You have learned how to connect a DevKit device to your Azure IoT Remote Monitoring solution accelerator and used the SendGrid service to send an email. Here are the suggested next steps: