Create a Function to Automate the Process
Functions provide the capability to execute the custom business rules.
For example, one of the NodeMCU property’s is "humidity", capturing the humidity level. We want to monitor the humidity level and if it drops below certain level then send an email notification.
-
To create a Function, click
.
Figure 1.
- Click New Function.
- Add the Function name as low-humidity-event.
-
Select the Python 3 template.
Figure 2.
-
Enter the following code. In the provided code, complete with
the information required at the beginning. Also, complete the PATH with your own
values.
import time import requests import json from swx.auth.token import get_token, revoke_token API_HOST = 'https://api.swx.altairone.com' PATH = "/spaces/EnterYourSpaceID/categories/EnterYourCategoryName/things/EnterYourThingUID/properties/humidity_status" CLIENT_ID = "Add your client ID from the Interface tab inside the Thing" CLIENT_SECRET = "Add your client secret from the Interface tab inside the Thing" def handle(req): token = get_token(CLIENT_ID_APP, CLIENT_SECRET_APP, ["thing"]) body = req.body.decode("utf-8") body = json.loads(body) humidity = body['humidity'] if humidity >= 50: humidity = "High Humidity" elif 10 < humidity < 49: humidity = "Normal Humidity" else: humidity = "Low Humidity" headers = {"Authorization": "Bearer " + token.access_token} response = requests.request("PUT", API_HOST + PATH, headers=headers, json={"humidity_status": humidity}) revoke_token(token.access_token, CLIENT_ID, CLIENT_SECRET) return { "body": response.json(), "status_code": response.status_code }
-
Add an Event trigger as follows:
status/your-space_name/categories/your_categories_name/things/your_thing_id/properties/
humidity
When using this method, the function will be invoked whenever there is a change on the Property
humidity
on the Thing you have created. -
Deploy your Function by clicking Save.
The Function is created. This could take a few minutes. The status of your Function will be updated to a Building status and, eventually, it will become Running. At this point, your Function is ready to be called.
-
You can edit the code in the Code tab as necessary.
Figure 3.