How to Connect an Apple device to Carriots and relay

0. Introduction

This tutorial extends the following one: "How to Connect a Raspberry to Carriots and relay" where streams are sent to Carriots using an API REST Client.

This time, we have an iPhone app using iOS and an application for Apple Watch using WatchOS.

Difficulty:

Ingredients

  • 1 x Raspberry Pi. An alternative is to use an Arduino Uno
  • 1 x Tiny Breadboard
  • 2 x Resitance. Value of 330KΩ
  • 1 x Led
  • 1 x Transistor NPN
  • 1 x Relay
  • 1 x iPhonne
  • 1 x Watch

TOP

1. Project Schema

This Project is a quick way to create an alarm app and understand the basics of combining Raspberry PI, Carriots and Apple devices.

  • Overall diagram of the project

iOS and watchOS will be programmed using Swift to send a data stream to Carriots and close or open the light circuit.

All the data streams sent by iPhone or Apple WATCH are collected and stored in Carriots. Carriots is a huge database that collects all the information that your sensors send.

In addition to storing data, the true power of Carriots is to let you build Apps very quickly with few lines of Groovy code. In this scenario we are going to build a very simple Alert App that sends an email to you in case that Raspberry Pi closes the light circuit thanks to the streams sent by Aplle devices.

With Carriots you can build very complex Apps to support all the logic of your product on the cloud and integrate it with other devices and IT systems. But for now let’s keep it simple.

TOP

2. Connections

  • Connections detail

TOP

3. Carriots Project and Device Registration

Device

If youre registered in Carriots, you have a default device already created for you.
Check your control panel and see what it looks like.
Basically you need the device id_developer that might be something like defaultDevice@myusername.
But if you want, you can create a new device and use it in this example.

Apikey

Now, go to your control panel “My account menu” and check your Apikey.
Its a big alphanumeric token like:
98346673a6377ef1fde2357ebdcb0da582b150b00cabcd5a0d83045425407ab4.
You need this number to complete the example.

TOP

4. Data Transferred from Raspberry Pi to Carriots

From Raspberry Pi you have to build a HTTP request and send the data.

  • HTTP request
    POST /streams HTTP/1.1
    Host: api.carriots.com
    Accept: application/json
    User-Agent: RaspberryPi-Carriots
    Content-Type: application/json
    carriots.apikey: YOUR APIKEY HERE
    Content-Length: YOUR CONTENT LENGTH HERE
    Connection: close
  • Data
    {
    "protocol":"v2",
    "device":"YOUR DEVICEs ID_DEVELOPER HERE",
    "at":"now",
    "data":{"light":"YOUR DATA HERE"}
    }

TOP

5. Code implemented on XCode

This is the XCode code implemented in iOS and watchOS Pi. Note that some values should be replaced by your own values.

Code for send Stream. File Carriots.swift

Note: the Carriots.swift class can be reused, it's necessary to mark which targets are associated.

  • Reusing Carriots.swift
Code for App iOS. File ViewController.swift
Elements used in the application. File: Main.storyboard
  • App preview
Resulting Application
  • The App
Code for App watchOS. File InterfaceController.swift
Elements used in the application. File: Interface.storyboard
  • App preview
Resulting Application
  • The App
Configure file Info.plist

To consume requests from the API-Rest of Carriots, you need to modify the Info.plist file with the values:

  • Info.plist values

This configuration is required for the iPhone and WATCH apps.

TOP

6. Checking Data is collected in Carriots

To test our control panel and check if we have new streams go to “Data management” → “Data streams” and you will see your data.

  • Data Stream list

TOP

7. Creating an Alert with Carriots Listeners

A listener in Carriots can be associated to any hierarchy entity, from Project to Device. If you associate a listener to a project, all devices below the services of that project will be affected. If you associate a listener to service, all devices below the groups of that services will be affected. And so on.

In this example, we create a listener associated with our device. This listener waits for an event to occur in the context of the device and then evaluate the content.

To create a listener go to the control panel, then to “Rules” → “Listeners” and click on the new button. Select "Device" as "entity type" and select your device on the "Id" field.

Fill the fields with the following values and save the new listener

  • Name: The name that you prefer
  • Description: The description that you prefer
  • Entity type: Device
  • Entity id: Your id device
  • Event to listen: data_persisted
  • If expression:
    true
  • Then expression:
    import com.carriots.sdk.utils.Email;
    import com.carriots.sdk.Device;

    def email = new Email();
    def device = Device.find("YOUR DEVICE HERE");

    if (context.data.email.isEmpty()){
    def email_account = context.data.email;
    if (email_account != ""){
    email.to=email_account;
    if (context.data.light == "ON") {
    email.message = "Electric circuit closed, status of light: " + context.data.light;
    } else {
    email.message = "Electric circuit open, status of light: " + context.data.light;
    } email.send();
    }}
    device.device_properties.state = context.data.light;
    device.update();
  • Then rule:
    leave empty
  • Else expression:
    leave empty
  • Else rule:
    leave empty
  • Be sure to have your listener enabled if you want it to be executed

Its time to test our listener. Send a data stream to this device, check your control panel and your email!!!

TOP

8. From here on: Enhancing the project

Now you know how to connect a Raspberry PI and Apple device to send data to Carriots and how to create a simple App with a single Listener and some SDK programing in Groovy. But you can enhance this project in many ways:

  • Try to control the electric energy of a room no matter where you are using app for iPad or macOS.
  • Create a control panel to manage the above suggestion.
TOP