Smart Object

Last modified: Jul 9, 2019 @ 14:27

Contents

Smart Object Types

Introduction

Smart Object Types determine the properties used when creating Smart Objects.

Access Smart Object Types

Navigation: Settings -> Hardware Types -> Smart Object Types tab

The Smart Object Types page has a list of all Smart Object Types in the Device Network.

Create/Edit Smart Object Type

Navigation: Settings -> Hardware Types -> Smart Object Types tab: +Create or click a Smart Object Type.

  1. Name: Enter a name for the Smart Object Type.
  2. Type ID: Enter a unique numerical value for the smart object type. Accepted values are less than 100 000 (< 100000). This field is mandatory.
    Note: All => 100000 is considered internal and filtered from the Smart Object Type selection view.
  3. Object URN: The path to the Device Type as defined by the OMA standard. It ends with the Type ID.
  4. Multiple Instances: Click to turn On/Off. Allows multiple occurrences of this Smart Object Type in the same Device.
  5. Description: Enter a description for the Smart Object Type.
  6. Add reusable resource: Use this to add a previously defined Resource Type to the Smart Object Type. See section Add Reusable Resource Type to a Smart Object Type
  7. Create resource: Use this to create a new non-reusable Resource Type. See Create/Edit Resource Type.
  8. Save: Click save to create the Smart Object Type.

Add Reusable Resource Type to a Smart Object Type

In the Resource Types section select +Add reusable resource. This option will add a reusable Resource for the selected Resource Type.

Select the required reusable Resource in the Choose field and click the Add button to get the required reusable Resource.

Note: Multiple reusable Resources can be selected from the Choose field.

Add Multiple Instances of a Resource Type to a Smart Object Type

In the Resource Types section, select an applicable Resource Type and click the + option. This adds a new instance for the selected Resource Type.

Note: The Resource Types must have multiple instances activated. See page Resources under section Create/Edit Resource.

The Resource Types section with new instance appears in the list and an automatically assigned Index number is displayed.

The automatically assigned Index number is the Resource Instance ID, which should be the same id as configured in the physical device.

The Index number can also be edited manually.

Note: The Index number must be unique for each instances of a Resource Type.

Smart Object Templates

Introduction

Smart Object Templates can be used to create different implementations of a Smart Object Type.

Access Smart Object Templates

Navigation: Settings -> Hardware Templates -> Smart Object Templates tab

The Smart Object Templates page has a list of all Smart Object Templates in the Device Network.

Create/Edit Smart Object Template

Navigation: Settings -> Hardware Templates -> Smart Object Templates tab: +Create or select a Smart Object Template from the list.

  1. Smart Object Type: Choose the Smart Object Type to be used as the basis for the template.
  2. Enable Observe: Turning on will observe all readable Resources at Smart Object Instance level.
    • Regardless the status of the Enable Observe option, Observe operation can be enabled/disabled at each Resource level.
  3. Resource Attributes: Determined by the Smart Object Type selected, though the Write field can be edited.
  4. Resources: Determined by the Smart Object Type selected.
    • Turning on Observe at more than one instance of a Multi-Instance Resources would create redundant Observe on Resource Level. Hence it is sufficient to turn on Observe for the first instance.
    • Turning off Observe on any instance would remove the Observe function on all instances of the Multi-Instance Resources.

Smart Objects

Introduction

Smart Objects are analogues of the hardware sensors that perform measurements and are connected to hardware devices. Accordingly, Smart Objects in DDM belong to a software Device.

Sensors measure things like temperature, humidity, location, motion etc. Smart Objects represent these types of sensors, but they can also be abstract entities such as Firmware Upgrade, which do not measure anything and do not exist in as hardware.

OMA LwM2M Standard

The OMA LwM2M standard has a list of Smart Objects with predefined names, unique IDs, and specific Resource Types. Certain ID ranges are reserved by the standard, whereas others are open for use when defining your own Smart Objects; see ObjectID Classes on the OMA website.

Access Smart Object

Navigation: Device Network ->Location->Device.

The Smart Objects panel has two fields: Device Management and Data Management:

Click on the > option to expand the Resources for a Smart Object. See the below example for Smart Object Lock and Wipe (0) and Temperature (0).

Note: The number in the parentheses is the Smart Object Instance ID.

  1. Name: List of Resources.
  2. Latest value: List of latest values read from the Resource.
  3. Latest value time: List of time when the latest values are read from the Resource.
  4. Read All: An action to read all values of the Resources.

The availability status of a Resource with multiple instances will always show green regardless of its actual state. Single Resource within the same Smart Object still indicates the actual state.

Write Value to resource

Note:

  • Read operation on any one of a Multi-Instance Resources reads the value for all instances of the Resource.
  • The size of the Firmware package file that you upload during the Write operation should be less than 1 MB.

Click on the applicable resource instance to display its details and to activate the Observe function.

Information Panel

  1. URL – Single Resource Type Instance is addressed using three part URL XXXX/0/XXXX. An instance of a Multi-instances Resource Type is addressed using four part URL XXXX/0/XXXX/0.
  2. Request Observe – Choose interval period to observe. Observe can be requested for various intervals from 1 min to 60 min.
  3. Observe toggle button– Click to Request/Cancel the observe option. For Multiple Resource Instance, Observe would be triggered for all resource instances.

Even though the Observe action is canceled by using the Observe toggle button, the Observe could be triggered when the device reregisters, if it is enabled in the Smart Object template.