Skip to Content

/wp-content/uploads/2016/03/banner_927175.png

 

UPDATE (Feb. 27, 2017): SensorPhone has been upgraded and has a new icon to show for it! First, SensorPhone has been upgraded to support all iPhone screen sizes. Yes – that means your shiny iPhone 7 Plus! Second, the IoT Services form screen has been improved. We’ve leveraged design aesthetics from the SAP Belize theme and native iOS controls. It’s now a lot easier to use and setup your iOS device to communicate with SAP Cloud Platform. Lastly, we’ve got rid of a few bugs that interfered with the microphone.

As you may already know, SAP Cloud Platform (SCP) allows anyone to go from sensor to visualization with the Internet of Things (IoT) service. SAP Cloud Platform’s IoT service provides the ability to quickly develop, deploy, and manage real-time IoT and machine-to-machine (M2M) and remote data sync applications. The possibilities are nearly endless; you can setup and manage connected remote devices, get real-time predictive analysis to improve intelligence and decision-making at the edge of the network, and optimize business processes at the core of your business.

That sounds great on paper, but how can we see the power and agility of SAP Cloud Platform without the need to build and setup extensive demos for the Internet of Things? Not everyone has access to the hardware needed to build out the desired IoT demo we all dream about (and see at SAP’s trade shows). However most of us have a smartphone. In fact, you may be reading this on that very smartphone. Our smartphones are packed with almost a dozen different sensors which we can leverage to see the power and agility of SAP Cloud Platform.

There’s a very good chance that your smartphone is an iOS device like an iPhone. With this in mind, I developed an iOS application that taps into your iOS device’s sensors (like the gyroscope, accelerometer, barometer, GPS, and audio), and neatly packages it into JSON format, then seamlessly feeds it to the IoT Service within SAP Cloud Platform. The app is called SensorPhone. I will show you how you can use your iPhone and the SensorPhone app with your own SAP Cloud Platform account.

I’ve made this extremely simple for anyone to setup and use. This blog post is broken down into three main steps. Step 1: Internet of Things Service Setup, Step 2: Adding your iOS Device in the Internet of Things Cockpit, and finally Step 3: Setup the SensorPhone app to send data to SAP Cloud Platform. Enjoy!

Before we get started, here is what you need:

  • The iOS SensorPhone client was updated to version 1.3.2 or higher in order to support an improved data model. if you setup your IoT Services within HANA Cloud Platform before April 10, 2016, then please see Step 2.1 to create a new Message Type. If you do not create a new Message Type, you will be unable to continue using SensorPhone (v1.3.2).
  • iPhone with the SensorPhone app (Requires iOS 7.0 or later, iPhone 5 and newer models. However, SensorPhone is compatible with iPad and iPod touch, 3.5″ screen+)
  • SAP Cloud Platform account (If you don’t have one, you can sign up for a trial account for free here)

 

Step 1: Internet of Things Service Setup

This is a very quick and simple walkthrough to setup your Internet of Things Service within your SAP Cloud Platform account, if you haven’t already done so. If you have, you may skip to Step 2: Adding your iOS Device in the Internet of Things Cockpit.

The IoT services in SCP is comprised of two main areas:

  1. Remote Device Management Service (RDMS) – this is used to onboard new devices, like our iPhone.
  2. Message Management Service (MMS) – this is used to manage messages between device, cloud platform and business applications. This is also where we will see the sensor data stored in SAP Cloud Platform.

 

Enabling the IoT Service for your SAP Cloud Platform Account

This will give you access to the Internet of Things Cockpit which leads you to the Remote Device Management Service.

First go to your SAP Cloud Platform Account and select Services from the side menu.

Note: Make sure you are at the account level at the top. Then on you may see the Services in the left menu.

 

Screen Shot 2016-03-28 at 8.24.13 AM.png

Scroll down until you see, Internet of Things Services and then click “Enable”.

Screen Shot 2016-03-28 at 8.24.27 AM.png

You now have enabled the IoT Services for your SCP account. The “IoT-User” role has now been assigned to you. Next we will install the Message Management Service (MMS).

 

Deploying the Message Management Service (MMS)
 

As mentioned above, this is used to manage messages between your iPhone, the platform, and business applications. This is also where we will see the sensor data stored in SAP Cloud Platform.

From your SAP Cloud Platform Cockpit, lets go back to the Internet of Things Service. We will enter the IoT Service Cockpit by clicking “Go to Service“.

Screen Shot 2016-03-28 at 8.24.27 AM.png

You will now see “Deploy Message Management Service” on the bottom left tile. Click on that.

Screen Shot 2016-03-28 at 8.25.42 AM.png 

Enter your account ID, username, and password.

Note: Your account ID is likely your (i/d/p) number or email address with the word “trial” on the end. Your User Name is likely to be your (i/d/p) number or email address itself.

Screen Shot 2016-03-28 at 8.54.36 AM.png 

We now have deployed the IoT Services application and the Message Management Service (MMS). Lastly, we need to add the IoT-MMS-User Role to our UserID.

 

Adding the IoT-MMS-User Role to your User ID

From the SAP Cloud Platform Cockpit, select Java Applications and click on iotmms. This will take us to the Java Application Overview screen.

 

Screen Shot 2016-03-28 at 8.26.13 AM.png

 

On the left hand side, select Security > Roles.

We now see the predefined IoT-MMs-User Role at the top.

 

Screen Shot 2016-03-28 at 8.26.29 AM.png
 

Verify that the IoT-MMS-Role is selected. Then below, click on “Assign

 

Add in your User ID and select “Assign“.

Note: Your User ID is not your account name. The user ID doesn’t not include the word “trial” on the end.

Screen Shot 2016-03-28 at 8.26.49 AM.png

Now we have added the Internet of Things Service, installed the MMS, and assigned our user to the IoT-MMS-User Role. Next we will add our iOS Device!

 

Step 2: Adding your iOS Device in the Internet of Things Cockpit

From your SAP Cloud Platform Cockpit, lets go back to the Internet of Things Service. We will enter the IoT Service Cockpit by clicking “Go to Service“. We are launching the Internet of Things Cockpit, within SAP Cloud Platform. The Internet of Things Services cockpit is the main interface for users to interact with the Remote Device Management Service (RDMS). It can be used to register new Devices (like our iOS device), to define the schema of messages (Device Types and Message Types) they can send and/or receive, as well as to establish the necessary trust relationship needed by devices to interact with Message Management Service (MMS).

As mentioned above, in order for our iOS device to successfully communicate with SAP Cloud Platform, there are a few prerequisites. The internet of Things Service requires a specific syntax used to register new devices in the device registry. We will need to create 3 entities:

  1. Device Type: A device type specifies a group of devices that share the same specification. In the IoT services, this specification is interpreted as the capability of sending, receiving and processing certain types of messages from our iOS Device.
  2. Message Type: A message type defines the type of data contained in a message that is sent or received by a device. Message types are specified for device types. For example, we will need to create a Message Type with the following attributes: sensor, value, and timestamp.
  3. Device: A device is a physical object that can be registered with IoT services. After successful registration it is able to send or receive messages. This is of course our iOS device itself.

So lets begin!

From your SAP Cloud Platform Cockpit, lets go back to the Internet of Things Service. We will enter the IoT Service Cockpit by clicking “Go to Service“. 

Screen Shot 2016-03-28 at 9.30.31 AM.png

2.1: Creating our Message Type

We will create a Message Type for the iOS device. Click on the “Message Types” tile. 
Screen Shot 2016-03-28 at 9.30.31 AM.png 

Click on the plus ( ➕ ) button at the bottom. Name the new Message Type (iOS Message Type) for the new device.

Screen Shot 2016-04-05 at 12.29.18 PM.png

For the Fields, click the plus (+) button to add more messages types (to have 12 in total) and data types.

timestamp: date
device: string
gyroscopex: string
gyroscopey: string
gyroscopez: string
accelerometerx: string
accelerometery: string
accelerometerz: string
altitude: string
longitude: string
latitude: string
audio: string

Then press “Create” (bottom right corner).

Screen Shot 2016-04-05 at 12.32.40 PM.png

Please note your Message Type ID. I recommend you copy/paste somewhere for easy access later on when we need it.

Screen Shot 2016-04-05 at 12.33.17 PM.png 

2.2: Creating our Device Type

Click on the “Device Types” tile. Then click on the Plus ( ➕ ) symbol at the bottom to add a new device type.

Screen Shot 2016-03-28 at 9.31.20 AM.png

Name your device type (iOS Device), assign it (by clicking Add Message Type) with the Message Type we just created, and chose From Device for the direction. press “Create”.

Screen Shot 2016-03-28 at 9.31.29 AM.png

 

2.3: Creating our Device

Press the back arrow (top left) to return to the IoT Sevices Cockpit. Then press the “Devices” tiles.

Screen Shot 2016-03-28 at 9.30.31 AM.png

Once again, press the plus button on the bottom to create a new device. Give it a name (iOS Device), select the Device Type we created earlier (iOS Device Type) and the press “Create” (bottom right).
Screen Shot 2016-03-28 at 9.33.57 AM.png

Important: After you create the device, a pop up will appear with a token value. Copy/Paste this as well because we need this to input into our SensorPhone app. If you lose it, click into the Authentication tab and you may generate a new token. 

Screen Shot 2016-03-28 at 9.34.03 AM.png

Also, please note your Device ID after you click “Close”. You will see the “ID” listed under your “Device Type” on your “Device Page”.I recommend you copy/paste somewhere for easy access later on when we need it. This will be needed to build your URL endpoint in the next step.

 

Screen Shot 2016-03-29 at 10.31.48 AM.png 

We now have everything setup to use our SensorPhone app with SAP Cloud Platform!

 

Step 3: Setup your SensorPhone app to send sensor data to SAP Cloud Platform

Now that all of the heaving lifting is out of the way, lets have fun with the SensorPhone app. SensorPhone is an iOS client that allows you to visualize your iPhone’s sensor data in real-time. SensorPhone allows you to stream this sensor data to the Internet of Things service within SAP Cloud Platform (via HTTP POST). If you haven’t already, download the app here from the App Store.

Once you download and open SensorPhone, it is extremely important that you Allow all the permissions (as shown below). This is vital to access and send the sensor data.

/wp-content/uploads/2016/03/permissions_916772.png

/wp-content/uploads/2016/03/sidebyside_927207.png

SensorPhone app is comprised of two different screens. The first screen is on the “Live” tab. The Live tab visualizes your iOS’ sensor data in real-time. It displays the movements of the accelerometer and the gyroscope. It displays your GPS coordinate, and your magnetic heading along with your altitude. SensorPhone also displays your audio levels around your iOS device, as fed from the primary microphone.

 

The second screen is the “IoT Service” tab. This tab is the most important because it allows you to enter your SAP Cloud Platform/IoT Service credentials into the provided form to seamlessly stream your sensor data in real-time. The form is comprised of URL, mode, messageType, and messages. You will also notice header values with two fields: Content-Type and Authorization. This is needed to send data to the IoT service from an external source like our iOS device, outside of the authorized network. I’ve also added a drop down menu that allows you to constantly send your updated sensor data in intervals of Just Once, Every 2 Seconds, Every 5 Seconds, and/or Every 10 Seconds. Let’s dig deeper into the form below.

 

What to enter in the “IoT Service” Form

 

/wp-content/uploads/2016/03/form_about_1_916806.png

/wp-content/uploads/2016/03/form_about_2_927205.png

/wp-content/uploads/2016/03/form_about_3_916808.png

Your form’s inputs should look something similar to mine below. At the moment you have to enter this manually so I suggest you put your information into an email and send it to your iOS device. This will allow you to easily copy/paste the information to the appropriate fields.

 

URL: https://iotmmsi840337trial.hanatrial.ondemand.com/com.sap.iotservices.mms/v1/api/http/data/74b90c1d-3492-499c-9757-505ce4756bff

mode: sync

messageType: 4c0781b3ff1e7506f77b

messages: *automatically generated*

Header

Content-Type: application/JSON;charset=utf-8

Authorization: Bearer *insert authorization token here*

 

Note: It is extremely important to add the word “Bearer” and a space before your device’s authorization token.

 

Watch the data stream!

 

After you have successfully setup your SensorPhone app, tap POST and you will see a response from HANA that looks something like this:

 

/wp-content/uploads/2016/03/phone_form_response_927206.png

 

If you’d like to see the raw data in a table, you can easily do so from the IoT Service Cockpit. From your SAP Cloud Platform Cockpit, lets go back to Services, and select the Internet of Things Service. We will enter the IoT Service Cockpit by clicking “Go to Service“. You will now see the IoT Services Cockpit.

 

Screen Shot 2016-03-28 at 9.30.31 AM.png

 

Select the “Select and view messages, or perform other actions” tile (in the bottom right-hand side).

 

Screen Shot 2016-03-28 at 11.32.18 AM.png

 

Select the “Display Stored Messages” tile (in the top left-hand corner).

 

Screen Shot 2016-04-11 at 8.11.58 AM.png

 

Locate the newly created table by looking for your Message Type (Example: The table would look something like T_IOT_4C0781B3FF1E7506F77B. The long part after the second underscore would be your message type). Then select your table and you will see the messages being sent! Refresh the page to see the new data being fed in.

 

Screen Shot 2016-04-11 at 8.14.11 AM.png


Final Thoughts

 

Now you’re able to see the power and agility of the Internet of Things services within SAP Cloud Platform. But most importantly, you’re able to leverage this generic demo to build your own personalized demonstration around a particular use case. Your iOS device can a send large amount of data in real-time to your SCP account, the possibilities are endless.

I have a few more updates on the way for SensorPhone that will make the setup easier and the sensors configurable. Take a look at Visualizing iPhone Sensor Data with SAPUI5 by my colleague in Toronto, Anthony McLeod, that illustrates how to consume this sensor data using SAP Cloud Platform and SAPUI5. Stay tuned and thank you for playing with SensorPhone!

Follow me on Twitter and LinkedIn!

 

Patrick Colucci

Technology Solution Consultant

SAP Canada

To report this post you need to login first.

153 Comments

You must be Logged on to comment or reply to a post.

    1. Patrick Colucci Post author

      Hi Vicky,

      I am unable to view the photo. Could you upload the photo directly to your comment? Since HCP is a cloud platform, many minor things have changed since I last updated the blog. The steps still work, however, the UI layout on some screens may appear different.

      Best,

      Pat

      (0) 
      1. Vicky Dev

        Hey Patrick, I am not able to upload the image on this forum, as its giving me some authorization issues. So, uploaded the image to a diff server online.

        Here is another link :http://pasteboard.co/dMUt8JpIa.png

        Note: You may need to copy/paste the URL on your browser separately.

        Yes, though the UI has changed, its pretty much the same. Not sure why am not able to see the fields in the application data screen page.

        (0) 
          1. Vicky Dev

            Hi Patrick , not sure if you can help, but was trying to follow up to see if you can share your inputs, enabling me to complete this cool exercise.

            (0) 
            1. Patrick Colucci Post author

              Hi Vicky, sorry for the delay. I saw your image and from what is visible, everything looks good. Some of the sensors on the iPhone are very sensitive and is a common source of this type of problem. Please be sure you do not have any headphones plugged into your iOS device, you’re not on a phone call, and allow up to 10 seconds for the SensorPhone app to retrieve the audio sensor data before your tap “POST”. Let me know if that helps.

              (0) 
              1. Vicky Dev

                Patrick, first of all, thanks for the response.

                Secondly, I am not sure what those msgs are, that are reflecting on my screen.

                I know there are several msgs being updated every second and am not sure what those are. Also, the fields that I created during the config stage, did not reflect anywhere.

                I only see that the msgs are being posted with a msg, and some msgs are being updated in diff table, which doesnt show the fields that I have created during the config..

                Something is wrong for sure.. even if there is no posting of msgs from the smartphone, i should still be able to look into the fields that I have created in some table format, right?

                If so, not sure where that would be..

                (0) 
                    1. Patrick Colucci Post author

                      Thanks Vicky, after you hit POST, there is a message that appears at the top of your screen briefly until it disappears. Can you send me a screenshot of that please?

                      (0) 
                      1. Vicky Dev

                        U mean the black colored msg/ kind of command prompt type msg that appears every time when a msg is being posted? if so, i am not getting it now.

                        I got it yesterday, and later i changed the authorization code to “iOS device token authorization code” instead of device registration token..

                        I just checked it again by changing it to the registration token, and no luck again..

                        (0) 
                              1. Vicky Dev

                                in that case, no msg is being generated, which means HCP is not sending in any msgs back to the iot sensor app. any clue? if the services got shutdown/stopped etc?

                                (0) 
                                1. Vicky Dev

                                  am in the IoT cockpit and wondering if I need to do anything explicitly to make the msgs display again in the iot sensor app.. 

                                  (0) 
                                    1. Patrick Colucci Post author

                                      That error tells me that your service is unavailable, so I assume it is off. The MMS turns off in a trial account after a specific time of inactivity.

                                      To turn it on go to your HCP cockpit (https://account.hanatrial.ondemand.com/cockpit) > JAVA Applications > turn on “iotmms” by pressing the play button. After that turns on, your SensorPhone app will work if set up correctly.

                                      (0) 
                                      1. Vicky Dev

                                        Ok, I noticed that the IoTmms is in “started status with green. However, I stopped the service now ( as clicking on the play button throws me a msg

                                        “Could not start additional process for application iotmms: Application ‘iotmms’ is started. The application is deployed in a trial account, which provides a single process. If you need to start additional processes, deploy the application in a productive account. If you need to restart, execute restart.”

                                        ,) and restarted the services again. and now its started..

                                        Now, after restarting, the status went back to green/started- and I invoked the IoT sensor app and tried to post the msgs, but still no black msg/ displaying the log.

                                        (0) 
  1. Eberhard Reiner

    Hi Patrick,

    I tried with my IPad2 to send data but there is no information after post and no data on the IoT table.

    It works with test data from the IoT browser http client so settings are ok. Are there information if it works with IPad2?

    (0) 
    1. Patrick Colucci Post author

      Hi Eberhard, when sending data from an external source (like your iOS device) vs. the test IoT browser client is slightly different. Please verify that your authorization field is filled out correctly. The most recent update to SensorPhone was to support the iPad 2 and up, so there shouldn’t be too much of an issue.

      (0) 
  2. Aaron Long

    Great blog!
    it would be nice if the device name is as the input field. now it is always ‘iOS Device’ if I used ‘ Every x Seconds ‘.

    (1) 
  3. Sarabjeet Singh

    Great Blog Patrick!

    It was so easy to follow the instructions and test this first IOT app, i was able to successfully post the msgs and reviewed the posted data successfully as well. Just one questions i have is how the message content area gets updated, what i am noticing is that same values are appearing all the time. Is the Data in Message section dynamically getting updated for all the parameters?

    Thank you so much all the information so far and i will continue to explore more on IOT.

    Kind Regards,

    Saby

     

     

     

    (0) 
  4. Jari Jussila

    Hi,

    I was able to complete the setup using the instructions, however, I do not get a table like T_IOT_4C0781B3FF1E7506FF77B, instead I get two tables:

    • T_IOT_CONFIG
    • T_IOT_MONITOR_LOG

    Neither of these two tables contain the fields (variables) that I have defined. What could be the issue?

    I am using iPhone 7.

    Kind regards,

    Jari

    (1) 
  5. Sivakumar Thamaram Mohanram

    Hi Patrick,

    I was able to complete the setup using the instructions, however there is no new Table created in the Display stored messages and in Iphone  in the sensor app there is no response from either success (200 Ok ) or error . I have updated the iOS to the latest version 10.3.1 …will this be a issue can you tell me after upgrade is there any issue with the Sensorphone app

     

    Thanks,

    Siva

     

    (0) 
  6. Gregor Wolf

    Hi Patrick,

    thank you for this great walkthrough. I was able to complete in within a short time. The great thing is that the current version of the Message Management Service Cockpit has now also an option to show the Application Data with a nice graph. Perhaps you want to update your Blog post:

    Best regards
    Gregor

    (0) 
  7. Volkan Gökkaya

    Thanks for this blog. But i have a problem. 2 weeks ago i have done all these steps and everything was fine. I got my data into the iot-Table.

    But now it doesn´t write any data anymore. I have changed nothing. I got a timeout and a msg like this: “…. retryAfterHeaderValue”:”60″

     

    Can you help me?

    (0) 
  8. Young Wong

    Thanks for the blog.

    On first try I could not get any data from the WebIDE client , although I saw new data populating the table in the massage cockpit. It seems sOEM people had similar problem here but no real solution.

     

    Then I went back to the Destination screen and found under authentication it was using lower case ‘i” so I change it to upper case ‘I’ for my HCP login name.

     

    Once i did that the demo worked as it should be and I can see data streaming into the WebIDE client , as well as the graph.

     

     

    (0) 

Leave a Reply