A Starter Kit for working with the SAP Cloud Platform Internet of Things for Neo Environment
The document and the code snippets will provide a complete end to end example of how to use the SAP Cloud Platform Internet of Things. You will learn how to enable it for your account as well as how to send messages and how to receive push messages. Moreover, the samples for data consumption are provided.
- Overview
- Getting started in the Cloud
- Sending messages from the device
- Consuming the messages sent from the device
- Pushing messages to the device
- Receiving the messages sent to the device
- Integrated examples for IoT Devices
- Security Aspects
- Revision history and related advice
- What comes next
SAP Cloud Platform Internet of Things is designed to facilitate and support the implementation of Internet of Things applications. It provides interfaces for registering devices and their specific data types, sending data to a data base running in SAP Cloud Platform in a secure and efficient manner, storing the data in SAP Cloud Platform as well as provide easy access to the data stored.
The respective APIs are distributed across two main components: Remote Device Management Service (RDMS) and Message Management Service (MMS). Moreover, there is a web-based interface called Internet of Things Cockpit which provides easy access to the various functionalities.
MMS provides various APIs that can be used by devices to send data to the SAP Cloud Platform. It processes the data and persists the data in the attached databases. There may be other use cases, though, which require forwarding the data to other Message Brokers or Event Stream Processors.
The Internet of Things Cockpit is the main interface for users to interact with the Remote Device Management Service (RDMS). It can be used to register new devices, to define the schema of messages (devices types and message types) they can send and/or receive, as well as to establish the necessary trust relationship devices need to interact with MMS. The Internet of Things Cockpit and RDMS are provided on a subscription base in the Cloud.
IoT Business Applications can be built using either the HANA XS, the Java or HTML5 mechanisms provided by the SAP Cloud Platform infrastructure.
- Get SAP Cloud Platform Developer Account
- Enable Internet of Things
- Create Device Information in Internet of Things Cockpit
- Deploy the Message Management Service (MMS)
- Send messages with MMS built-in sample client using HTTP API
- Send messages with MMS built-in sample client using MQTT TCP/SSL API
- Send messages with MMS built-in sample client using WebSocket API
- Send messages with MMS built-in sample client using MQTT WebSocket API
- Send messages with Python client using HTTP API
- Send messages with Python client using WebSocket API
- Register a device and send messages using HTTP API with Certificate based authentication
- Flexible ingest from an external MQTT broker using MQTT over WebSocket Data Service API
- Consume the messages with MMS built-in client
- Consume the messages with Web Application based on Java and UI5 using SAP Cloud Platform Persistence Service
- Consume the messages with UI5 using the built-in MMS OData API
- Consume the messages with UI5 using the built-in MMS OData API with advanced chart configuration and live data updates
- Consume the messages with HANA XS using XSODATA and XSJS
- Consume the messages with Python using PyHDB
- Consume the messages with Node.js using NodeHDB
- Push messages with MMS built-in sample client using HTTP and WebSocket API
- Push messages with Web Application based on Java and UI5 using HTTP API
In order to get you up and running fast we provide examples that you may use both with or without specific IoT Device hardware.
If you want to take a quick start with a device simulation that runs on your desktop you can use two Python programs with a graphical user interface. In order to run the programs on your desktop (Windows and OSX have been tested) you need a Python installation and the urllib3 module installed. Please refer to the these instructions for guidance on how to meet these preconditions.
With the usage of
- the device simulation that you can start with
python iot_starterkit_desktop.pyand that produces the User Interface shown below
- a program to send messages to the simulated device and switch its LED on or off that you start with
python iot_starterkit_push_ui.pyand that produces the User Interface shown below
you can already experience the functionality of an end-to-end scenario.
We provide instructions and code for usage with a Raspberry Pi and a GrovePi shield that lets you attach various input and output peripherals. In the example we use a Slide Potentiometer for the input of values that can be changed by the user as well as an LED and an OLED graphical display for visible output. You should be able to comfortably purchase these components and assemble them without having to solder.
Please follow these steps to setup and use the Raspberry Pi with the shown peripherals and the example application.
In addition to the Raspberry Pi we have already used the SAP Cloud Platform Internet of Things with a variety of other hardware.
Security plays a very important role for the deployment of IoT scenarios in productive environments. The Starter Kit examples concentrate of the aspect of demonstrating basic IoT Services mechanisms. Inherently, specific usable security mechanisms differ for different programming languages, frameworks or hardware platforms. Thus, before making use of code snippets or integrated examples in productive scenarios please pay additional attention on hardening against potential attacks. We will continuously provide further guidance on potential attack vectors and how to harden your solution on the dedicated Security aspects page.
The SAP Cloud Platform Internet of Things is continuously developed further. Please pay attention to the dedicated page Revision history and related advice to ensure you get specific information about potentially necessary modifications to your older usage examples.
The initial version of the IoT Starter Kit for SAP Cloud Platform Internet of Things as first published at SAPPHIRE 2015 intentionally tries to provide a simple and easy to reproduce example. We welcome feedback on the adaptation of the HCP IoT Services and your own usage examples via the SCN page "Try out the SAP Cloud Platform Internet of Things".