Oracle Cloud What's New for Oracle Internet of Things Cloud Service Release 17.4.5 E70360-16 December 2017 What s New for Oracle Internet of Things Cloud Service As soon as new and changed features become available, Oracle Internet of Things (IoT) Cloud Service instances are upgraded in the data centers where Oracle Cloud services are hosted. You don t need to request an upgrade to be able to use the new features they come to you automatically. To obtain the latest version of the Oracle IoT Cloud Service Client Software, go to the Oracle IoT Cloud Service Client Software Downloads page (see below for more details). Here s an overview of new features and enhancements added recently to improve your Oracle IoT Cloud Service experience. Topics: Release 17.3.3 - August 2017 Release 17.2.5 - June 2017 Release 17.2.1 - April 2017 Release 17.1.5 - March 2017 Release 17.1.3 - February 2017 Release 16.4.1.0.2 - December 2016 Release 16.4.1.0.1 - November 2016 Release 16.4.1 - October 2016 Release 16.3.3.1.1 - September 2016 Release 16.3.3 - August 2016 Release 16.2.3.1 - July 2016 Release 16.2.3 - May 2016 Release 16.1.5 - March 2016 Release 17.3.3 - August 2017 1
IoT Device Simulator for Simulating Devices and Device Activities Provision the Gateway with Information on Indirectly Connected Devices IDE Support for Developing Analytics Applications The IoT device simulator lets you create simulated devices for your environment without the need to connect and set up hardware. You can generate configurable live data, alerts, and events for these simulated devices. Indirectly connected devices that use controlled roaming can connect through a gateway only if the gateway has the shared secret credentials to activate the device. You can now provision a gateway with the shared secret credentials of indirectly-connected devices at the time of provisioning the credentials for the gateway itself. IDE support in Oracle IoT Cloud Service lets you export your analytics project to an external IDE tool for development. guides to accommodate for new features and bug fixes. user guide, reference documentation, and OBE tutorials to accommodate for bug fixes and changes in the client software libraries. Service has been updated. See REST API Release 17.2.5 - June 2017 Network Provisioning Support in Client Libraries Custom Certificates for Integrations Network provisioning enables your IoT application to dynamically provide provisioning information over the network for your devices. IoT applications can use network provisioning for seamless onboarding and activation of trusted assets. If your external application requires a custom certificate to securely connect to the application from Oracle IoT Cloud Service, you can specify the root certificate to be used on the Connection tab of the Integration. 2
Support for Oracle Application Builder Cloud Service Integration Controlled Roaming for Devices Gateway Supports Device I/O v1.1 Release 17.2.1 - April 2017 Oracle IoT Cloud Service supports integration with Oracle Application Builder Cloud Service (ABCS) applications. This enables you to create web and mobile applications that leverage data from IoT. IoT applications expose BOPs (Business Object Providers) that can be downloaded and imported into Oracle Application Builder Cloud Service (ABCS) to provide access to IoT application data as business objects. Business objects can include devices, device models, messages, etc. Use these objects in Oracle Application Builder Cloud Service (ABCS) to create dashboards and mashups. You can optionally pass the shared secret key when calling the registerdevice method to register an indirectly connected device with Oracle IoT Cloud Service. When the device is activated, the shared secret must match the shared secret in the device record. Any subsequent activation request must have a matching shared secret key. The Oracle IoT Cloud Service Gateway now supports version 1.1 of the Device I/O API. guides to accommodate for various bug fixes. user guide, reference documentation, and OBE tutorials to accommodate for bug fixes and changes in the client software libraries. Service has been updated. See REST API Analytics Oracle IoT Analytics enables you to develop streaming and batch analytics applications, and deploy them on an integrated big data infrastructure. These applications can process, learn, and analyze large volumes of constantly changing data collected from sensors, and contextualized with data from enterprise applications and other data sources. You can model your IoT data, define fast/batch functions to process data, define application services, and manage the data ingestion process. You can also define multiple data sources, run ad-hoc queries, package and deploy application, and monitor live applications. 3
The User s Guide now includes a section on working with Analytics. See Developing Analytics in Oracle IoT Cloud Service. New Oracle By Example (OBE) tutorials are now available: Saving Data to a NoSQL Database Using Analytics in Oracle IoT Cloud Service Creating an Alert Summary Using Analytics in Oracle IoT Cloud Service Creating a Batch Processor Using Analytics in Oracle IoT Cloud Service guides to accommodate for various bug fixes. user guide, reference documentation, and OBE tutorials to accommodate for bug fixes and changes in the client software libraries. Service has been updated. See REST API Release 17.1.5 - March 2017 guides to accommodate for various bug fixes. user guide, reference documentation, and OBE tutorials to accommodate for bug fixes and changes in the client software libraries. Service has been updated. See REST API Release 17.1.3 - February 2017 4
New Oracle By Example (OBE) tutorials are now available: Connecting Devices Using the ios Client Software Library Quick Start Tutorial Using the Apache Felix Framework Sending Notifications to a Mobile Device with Oracle Mobile Cloud Service Service v2 has been updated. See REST API User Guide and OBE tutorials to accommodate for bug fixes and changes in the client software libraries. Release 16.4.1.0.2 - December 2016 ios client software libraries C porting layer client software library A device virtualization client software libraries is now available for ios. For more information, see ios Device Virtualization API A porting layer client software library is now available. This porting layer enables you to port the C clients to different operating systems and CPU architectures. For more information, see C Porting Layer API Reference. Service v2 has been updated. See REST API New Oracle By Example (OBE) tutorials are now available: Connect a Device with ios New reference documentation is now available: ios Device Virtualization API Reference C Porting Layer API Reference User Guide and OBE tutorials to accommodate for bug fixes and changes in the client software libraries. 5
Release 16.4.1.0.1 - November 2016 Storage cleanup Test connection for integrations Beacon gateway sample You can delete the messages stored in the IoT Cloud Service instance to make space for new messages. You can view the percentage of internal storage that is already used. You can chose to delete the messages for a certain period of time, for all the IoT applications or for a specific application. You can configure multiple clean up processes for specific applications to run simultaneously. You can now check the status of the connection for an integration. This feature checks the connectivity with the integration server and if the messages are able to reach the server. A beacon gateway sample was added and is distributed with the JavaScript, Java, and Android client software libraries. Service v2 has been updated. See REST API New Oracle By Example (OBE) tutorials are now available: Connecting Devices to Oracle Internet of Things Cloud Service Using the mbed Client Software Library Connecting Devices Using the Java SE Client Software Library Sending a Configuration Change to a Device Using Device Virtualization Quick Start Tutorial for Oracle Internet of Things Cloud Service Using the Gateway on a Host System Configuring Long Polling in Oracle Internet of Things Cloud Service User Guide and OBE tutorials to accommodate for bug fixes and changes in the client software libraries. Release 16.4.1 - October 2016 Windows client software library A C-based client software library is now available for Windows Systems. 6
Unified Provisioning Client software libraries support long polling Logging API for C client software libraries Gateway supports long polling Stream Explorer reference support Provisioning is now handled from the Management console user interface. After you register your device, you download an encrypted file with the provisioning configuration that you must copy to your devices. The JavaScript, Java, Android, C Posix and C Windows client software libraries now support long polling. You can now push messages from Oracle IoT Cloud Service without your devices having to poll for messages. This feature significantly reduces the latency between Oracle IoT Cloud Service and your devices. This feature is enabled by default. Added a new API for the C (Posix, Windows, and mbed) client software libraries that enables you to configure and control the logging functionality. The gateway now supports long polling. Messages can be pushed from Oracle IoT Cloud Service without the gateway having to poll for messages. This feature is enabled by default. You can now add references to static data as exploration source when you configure your explorations. This enables you to enrich the messages coming from devices with static data from a database table stored in Oracle Database Cloud Service (DBaaS). Service v2 has been updated. See REST API New Oracle By Example (OBE) tutorials are now available: Connect a Device with C Windows Connecting Devices Using the Java Client Software Library Quick Start Tutorial Using the IoT Asset Monitoring Application User Guide and OBE tutorials to accommodate for bug fixes and changes in the client software libraries. Release 16.3.3.1.1 - September 2016 MQTT support for JavaScript client software library The JavaScript client software library now supports secure MQTT as a messaging protocol between devices and Oracle IoT Cloud Service, in addition to HTTPs. See Connecting Devices Using MQTT. 7
mbed client software library A new IoT Cloud Service client software library for devices running the mbed operating system has been added. This native (C) device library supports HTTPs and secure MQTT protocols. You can configure it for use with directly connected devices and gateway devices (indirect activation support). The mbed Client Software Library shares the same set of APIs as the Posix client software libraries. ARM mbed OS is an open source embedded operating system targeted at devices based on the ARM CPU architecture. For more information on mbed OS, see http://www.mbed.com. Service v2 has been updated. See REST API New Oracle By Example (OBE) tutorials are now available: Generating Alerts and Events Using Patterns Connecting Devices Using the mbed Client Software Library. Streaming Data to an Enterprise Application HTTP Endpoint Subscribing to Attribute Updates from an Enterprise Application New videos for the Asset Monitoring application. See Oracle IoT Cloud Service Videos. User Guide and OBE tutorials to accommodate for bug fixes and changes in the client software libraries. Release 16.3.3 - August 2016 Management Console user interface modified The Oracle IoT Cloud Service Management Console UI has been modified. The tabs for Home, Applications, Devices, and Settings are now accessible by clicking the main menu icon located at the top left corner in the Management Console UI. 8
New integration with Oracle Storage Cloud Service New features available for working with explorations Interactive provisioner tool for the Gateway software MQTT support The Integration tab found under Applications in the Oracle IoT Cloud Service Management Console now includes an option to integrate with your existing Oracle Storage Cloud Service instance. This integration allows you to store, manage, and consume large amounts of data received by Oracle IoT Cloud Service from your devices. See About Oracle Storage Cloud Service Integration with Oracle IoT Cloud Service. Additional features, such as using maps, filters, business rules, expressions, or functions, are available when working with Explorations. See Editing Explorations and Working with Maps. The provisioner tool that is available for the Client Software Libraries is now also available for the Oracle IoT Cloud Service Gateway software. MQTT is a publish/subscribe "lightweight" messaging protocol to connect with remote locations. MQTT was designed for cases where a "small code footprint" is required, or the network bandwidth is limited. You can now use MQTT over SSL as an alternative to HTTPs, to connect devices to Oracle IoT Cloud Service. MQTT support (based on the MQTT v3.1.1 specification) is available in the Oracle IoT Cloud Service Gateway software and Client Software Libraries for Android, C Posix and Java SE. Service v2 has been updated. See REST API New Oracle By Example (OBE) tutorials are now available: Connecting Devices Using MQTT Managing Messages and Alerts New solution blueprint is now available. User Guide and OBE tutorials to accommodate for bug fixes and changes in the Client Software Libraries. Release 16.2.3.1 - July 2016 9
Interactive Provisioner Tool Updates to the Java SE Client Software Library The Provisioner tool is available for all platforms supported by the Oracle IoT Cloud Service Client Software Libraries. It is a shell script or batch file that prompts you for input and then runs the commands to create the trusted assets store. The tool simplifies creating the trusted assets store by gathering the necessary server certificates and invoking the commands to create the trusted assets store. The tool can be run interactively or with command line arguments. In interactive mode, the tool prompts for the required information. With command-line arguments, all the information is given at the command line, but the tool will prompt you for any missing information. See the Quick Start tutorials for examples of how to use the Provisioner tool. Go to Oracle IoT Cloud Service Client Software Downloads to obtain the latest version of the Client Software Libraries, which includes the Provisioner tool. Go to Oracle IoT Cloud Service Client Software Downloads to obtain the latest version. Listed below is a summary of the changes: The Oracle IoT Cloud Service Client Library for the Java SE platform now uses the org.json API library instead of the com.oracle.json API library. If you have an existing application that uses the Messaging API library, you ll need to modify it to use the org.json API library instead. Time is automatically adjusted to match the Oracle IoT Cloud Service instance time if the time difference is the cause for authentication failure. You can now specify the path to the trusted store file when creating a Directly Connect Device or Enterprise Client instance. Error messages are now more userfriendly. The provisioner tool has the showusage option to list usage, which includes the - list and the-update options. 10
Improved C POSIX Client Software Library See Oracle IoT Cloud Service Client Software Downloads to obtain the latest library version. The following are the C POSIX Client Software Library changes introduced in this release: The json writer library, which consumes less resources, is used instead of the third-party json-builder library. The third-party jsmn library is now used instead of the third-party json-parser library. The jsmn library is a light-weight json tokenizer that doesn't use dynamic memory allocation. Static heap support has been added by using the third-party umm_malloc library. Reduced dynamic allocation usage Each dynamic allocation call is now wrapped with special intermediate call so it could be redirected and better observed. Flow control for incoming messages has been added in the device client library. Time is automatically adjusted to match the Oracle IoT Cloud Service instance time if the time difference is the cause for authentication failure. Changes were made to the public headers: TAM header is removed, and the message dispatcher and messaging header are joined together. Several API changes have been made: The iotcs_init() method now accepts two arguments: path to the truststore and the truststore password. The iotcs_ prefix has been added to the names of all the public APIs. A link to the iotcs_request_message from iotcs_response_ message has been added, so that when the response is sent, the corresponding request can be deallocated. See Oracle IoT Cloud Service Client Software API References for details in the C POSIX Client Software Library API Reference documentation. 11
Updates to the JavaScript Client Library New and Updated Documentation The following are the JavaScript Client Software Library changes introduced in this release: You can now specify the path to the trusted store file when creating a Directly Connect Device instance. Flow control for incoming messages has been added in the device client library Time is automatically adjusted to match the Oracle IoT Cloud Service instance time if the time difference is the cause for authentication failure. Go to Oracle IoT Cloud Service Client Software Downloads to obtain the latest version. The following new and updated documents are available The Client Software API References documents have been updated to reflect changes made to the Client Software Libraries. See more details described earlier in this document. The following new tutorials are available under the Tutorials tab: Quick Start Tutorial Using an Android Application Controlling and Monitoring Devices Using the Android Client Software Library Miscellaneous updates were made to the existing User Guide and OBE tutorials to accommodate for bug fixes and changes in the Client Software Libraries. Release 16.2.3 - May 2016 New Client Software Library tutorials Quick Start tutorials for the Client Software Libraries have been released for the Java and C POSIX platforms. New Oracle By Example (OBE) tutorials for the JavaScript, C POSIX, and Android platforms of the Client Software Libraries are also now available. 12
Updated Client Software Library API What s New and Known Issues documents The Oracle IoT Cloud Service Client Software Library for the C POSIX has been updated. It is now comprised of both the Device Library and the Enterprise Library. To download the latest version, go to Oracle IoT Cloud Service Client Software Downloads. An updated version of the C POSIX Client API documentation is also available. See Oracle IoT Cloud Service Client Software API References. The What s New and Known Issues documents are now available from the Oracle IoT Cloud Service Help Center. Release 16.1.5 - March 2016 Device Models IoT Applications New Built-in Enterprise Integrations Device Models are introduced. They capture the virtualized capabilities of devices and inform Oracle IoT Cloud Service about how devices can interact. They enable parallel implementation of device and enterprise solution components. See About Device Models in Oracle IoT Cloud Service. IoT Applications are introduced. They allow you to easily create and manage applications by enabling you to configure the device models, analytics, integrations, and devices that will part of your IoT solution. See Understanding an IoT Application in Oracle IoT Cloud Service. Enterprise Integration Enhancements provide greater configurability for HTTP-connected enterprise applications, including insertion of additional HTTP headers in outgoing POST operations, user defined header names, and static header values set in connector definition. The Integration tab in the Oracle IoT Cloud Service Management Console now includes an option to integrate with your JD Edwards EnterpriseOne instance, retrieve the available orchestrations, and send data from Oracle IoT Cloud Service. See About Oracle IoT Cloud Service Integration with JD Edwards EnterpriseOne Internet of Things Orchestrator. Also added to the Integration tab is the option to integrate with your Oracle Mobile Cloud Service instance and send data and alert messages to it. See About Oracle Mobile Cloud Service Integration with Oracle IoT Cloud Service. 13
Enhanced Client Software Support New Client Software Libraries are available for the Android, C POSIX, JavaScript, and Java SE platforms. The Client Software Libraries for the Android, JavaScript, and Java SE platforms include a Device Library and an Enterprise Library. The C POSIX Client Software Library is only available as a Device Library. Device Libraries enable device activation and bidirectional messaging, and can be configured to provide gateway functionality. Enterprise Libraries are used to monitor and control client devices through the Oracle IoT Cloud Service. Download the latest versions from Oracle IoT Cloud Service Client Software Downloads. Two new sets of APIs are available for all the Client Software Libraries: The new Device Virtualization API is a simplified API that exposes device properties as virtual objects. The Messaging API is a lower-level API that enables more fine-grained control for experienced embedded developers. See Oracle IoT Cloud Service Client Software API References for the corresponding API Reference documentation for each supported platform. See Overview of the Oracle IoT Cloud Service Client Software Libraries. Documentation Accessibility For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup? ctx=acc&id=docacc. Access to Oracle Support Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/ lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired. Oracle Cloud What's New for Oracle Internet of Things Cloud Service, Release 17.4.5 E70360-16 Copyright 2016, 2017, Oracle and/or its affiliates. All rights reserved. This document describes new features and other notable changes for Oracle Internet of Things Cloud Service. 14
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable: U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government. This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of thirdparty content, products, or services, except as set forth in an applicable agreement between you and Oracle. 15