Ericsson Device and Data Management

Last modified: Mar 28, 2019 @ 06:12

Release Notes

This document describes all the new features, enhancements, and changes included in this release of the Device and Data Management (DDM) service. For detailed information about using the DDM features, see the online documentation in the DDM documentation portal.

To find out what versions you have installed, check the information in the About window in your DDM Admin dashboard.

Release Version: DDM 19A2

Release Date: w13

Note:

  • DMM 19A2 covers DDM Core 2.2, DDM Core Billing 1.0, LwM2M Gateway 1.5, LwM2M BSS 1.1, and MQTT Gateway 2.1.1.
  • This Release Note covers DDM Core 2.2, DDM Core Billing 1.0, LwM2M BSS 1.1, and MQTT Gateway 2.1.1.

Contents

Main End User Improvements

Additional information is found in section Release Details.

New Features
Send Observe on Smart Object level based on Smart Object Template.
Requirements and pricing model.

 

New Web Admin API Endpoints
Nothing for this release.

 

Other End User Improvements
Improved documentation for Certification Based Authentication, see Update the Setting Category for Authentication.
Improved documentation for MQTT infrastructure, see Overview of MQTT Gateway.
Improved IPv6 Support Test Coverage in BSS.

 

Customer Issues Solved
Issue Description ID
PSK Verification.(1) PSK verification is allowed for all roles in API. DDM-78690
Swagger document authentication.(2) Authentication is added for Swagger documentation page and API user guide. DDM-87501
Sign out option from GUI.(2) Added Sign out option in GUI. DDM-87616
Read attributes does not support Device endpoints containing special characters. Read attributes does not handle the special character in the Device endpoint.

Note: The name can consist only of characters out of the set “A” to “Z”, “a” to “z”, and “0” to “9”, the minus sign (-), the colon sign (:), and the underscore (_).  The name MUST start with a character out of the set “A” to “Z”, “a” to “z”, or “0” to “9”.

DDM-87883
Fail to create Device in BSS if server name is longer than 64 characters.(1) Allowed length of server name and Device profile name increased to 128 characters. DDM-87957 
Default Device profile values not returned in API.(1) Default Device profile values can be retrieved and updated via Device profile API by using deviceprofiles/default API endpoint. DDM-88026 
Data of a specific Resource cannot be obtained with the Measurement API. Fixed an issue where a few API endpoints did not return any values for Time and Opaque data types. DDM-88189
For the API endpoint PUT /api/v3/devicetype/{}, the Device type ID is expected in Request Body. Device Type ID is expected in Request Body, though it is present in the URL path.

Without the Device Type Id in the Request Body, the API is currently not allowing to update any attributes.

DDM-89371
  • (1) – indicates a change in the BSS API. Refer to BSS API User Guide (link available in BSS GUI).
  • (2) – indicates a change in the BSS GUI.

Release Details

Features

New Features

Details for New Features – From Web Admin API and GUI Perspective (Northbound Interface)
Feature Description Documentation
Send Observe on Smart Object level based on Smart Object Template.
New Option in Smart Object Template Configuration Model is Enable Observe, which activates Observe at Smart Object Instance level. See Smart Object in the DDM Documentation Portal.
Requirements and pricing model. Customer billing reports generated per Device Network and Instance, including API usage/metrics, Device count, and storage consumption metrics. See Usage Metrics Collected in the DDM Documentation Portal.
Details for New Features – From Device Perspective (Southbound Interface)
Nothing for this release.

Web Admin API

New API Endpoints

API documentation:

  • If you are using DDM standalone, see swagger.
  • If you are using Ericsson IoT Accelerator, see apidoc.
    Note: Open this link with Google Chrome.

For details, see Overview of APIs in the DDM documentation portal.

 

Web Admin API – New API Endpoint
Nothing for this release.

Changed API Endpoints

API documentation:

  • If you are using DDM standalone, see swagger.
  • If you are using Ericsson IoT Accelerator, see apidoc.
    Note: Open this link with Google Chrome.

For details, see Overview of APIs in the DDM documentation portal.

 

Web Admin API – Changed API Endpoint
Description Change Description
GET /api/v3/dataCollectors/{id}/log
Get log posts written by the Data Collector or SensationBackend. Deprecated, will be removed after March 2019. Added a clarification that this endpoint is already marked as deprecated,  and it is replaced by GET /api/v3/dataCollectors/{id}/logfiles.
POST /api/v3/smartobjecttemplates
POST Creates a SmartObjectTemplate. Added new attribute smartObjectTemplate.IsRequestObserve

This attribute specifies, if Observe requests should be automatically sent to all readable Resources of a Smart Object when the Device registers.

PUT /api/v3/smartobjecttemplates{}
PUT updates a SmartObjectTemplate. Added new attribute smartObjectTemplate.IsRequestObserve

This attribute specifies, if Observe requests should be automatically sent to all readable Resources of a Smart Object when the Device registers.

GET /api/v3/smartobjecttemplates{}
GET a specific instance of a SmartObjectTemplate. Added new attribute smartObjectTemplate.IsRequestObserve

This attribute specifies, if Observe requests should be automatically sent to all readable Resources of a Smart Object when the Device registers.

GET /api/v3/devicetemplates/list
Returns a paged list of DeviceTemplates. Deprecated will be removed after March 2019. Added a clarification that this endpoint is already marked as deprecated, and it is replaced by GET api/v3/devicetemplates, Returns a list of DeviceTemplates.

Added new attribute smartObjectTemplate.IsRequestObserve

This attribute specifies, if Observe requests should be automatically sent to all readable Resources of a Smart Object when the Device registers.

GET /api/v3/devicetemplates/{}
Returns a single DeviceTemplate. Added new attribute smartObjectTemplate.IsRequestObserve

This attribute specifies, if Observe requests should be automatically sent to all readable Resources of a Smart Object when the Device registers.

GET/api/v3/devicetypes/list/{}/templates 
Returns a list of templates for a DeviceType. Added new attribute smartObjectTemplate.IsRequestObserve

This attribute specifies, if Observe requests should be automatically sent to all readable Resources of a Smart Object when the Device registers.

GET /api/v3/devicetypes/{}
Returns a single DeviceType. Added new attribute smartObjectTemplate.IsRequestObserve

This attribute specifies, if Observe requests should be automatically sent to all readable Resources of a Smart Object when the Device registers.

GET /api/v3/smartobjecttypes/{}
Returns a single SmartObjectType. Added new attribute smartObjectTemplate.IsRequestObserve

This attribute specifies, if Observe requests should be automatically sent to all readable Resources of a Smart Object when the Device registers.

GET api/v3/activitylogs
Returns a paged list of ActivityLogs. Added filter key parentid.

Removed API Endpoints

API documentation:

  • If you are using DDM standalone, see swagger.
  • If you are using Ericsson IoT Accelerator, see apidoc.
    Note: Open this link with Google Chrome.

For details, see Overview of APIs in the DDM documentation portal.

Web Admin API – Removed API Endpoints
Nothing for this release.

Known Limitations

Known Limitations
It is not possible to import hardware types and templates that were exported from a version earlier than AppIoT_2018_35.
The Resource Attributes and their values on the Smart Object Template cannot be exported/imported between Device Networks.
Modifications to default templates included in export will be ignored when importing.
Maximum length of server name and Device profile name is 128 characters in BSS API’s.
Enabling Observe at Smart Object Instance level is currently supported only through Smart Object Template configuration. It is not supported through Web API or manually through GUI from the Device Panel.
Large values (greater than 2 billion) are not getting accepted by resource attribute fields in Smart Object Template.

Known Issues

Known Issue
Issue with paging of Firmware packages when a Device Type has more than 20 Firmware packages.
TransformerDevice does not transform.
When changing one of the Smart Object Templates in a Device Template where it has more than one Smart Object Type, ResourceWriteAttributeRequest should only be sent to the Smart Object Type for which the template is changed.
Using special characters in the API Key name field will cause text overlap in the GUI.
 If there is an error in the Resource attribute, it will be discarded when creating the Smart Object Template.
When setting permissions for a Responsibility in the Tenant Admin menu, the checkboxes are working in the opposite way when checking and unchecking.
The API Key field is allowing the user to enter an Expiration Date prior to the current date.