Automatic Device onboarding - SAP Cloud Platform Internet of Things

Modeling and creation of equipment has to be followed as per the document here. Once the equipment is created and published, it is synchronized with IoT Application Enablement, subsequently it is also synchronized and objects are created in SAP Cloud Platform Internet of Things for the Cloud Foundry Environment (IoT Services).

IoT Sync Flag:

  • IoT Sync flag allows a user to enable sync to IoT Services and automatically map indicators to corresponding properties.

Behaviour:

  • By default, the flag will be visible only when an IoT Services system is configured .

  • Flag can be toggled to switch the behavior.

    If the flag is switched from Yes to No and the objects were created in external systems, they will be retained and the same can be reused by switching the flag.

    If the flag is switched from No to Yes, the manual mapping of indicators, if configured, will be invalidated.

Following points need to be considered while publishing to IoT Services:

  • Only Equipment with Model in Asset Central is synchronized with IoT Services. This means that Lean Equipment will not be synchronized with IoT Services.

  • For every Equipment a Sensor Type is created which will be associated with Capabilities corresponding to Indicator Groups – Indicators coming from both Model Template and Equipment Templates in Predictive Data Maintenance and Services.

  • Each Device will have only one Sensor created from SAP Predictive Data Maintenance and Services.

  • Since automatic mapping between a Thing and a Sensor will be established based on the matching named Property Set Types, replicated Capabilities are not reused across Sensor Types in IoT Services. Each Sensor Type will have its own set of Capabilities with names matching with the named PSTs of the thing in Application Enablement.

  • Addition of Indicator Groups and addition of Indicators in already synchronized Indicator groups in Asset Central will be considered for further synchronization with IoT Services.

  • A default capability IG_DEFAULT will be created to support update of capabilities with new properties from Asset Central and should not be removed.

  • A capability, IG_EDGE_CONFIG will be created and associated with every Sensor Type to support configuration push from asset central to the edge.

  • In 1808 SAP Predictive Data Maintenance and Service release, only connection to MQTT Cloud Gateway is supported.

  • Each indicator group can have only one indicator of type Date for a successful Sync.

The mapping between objects is as follows (AIN, ASPM):

  1. Steps to enable synchronization across IoT Application Enablement and IoT Services:

    1. Follow the steps as mentioned here.

    2. To add IoT Services system:

      1. On the SAP Fiori launchpad, choose the tile Application Settings.

      2. Choose External Systems.

      3. Choose Add.

      4. Choose the external system: SAP Cloud platform Internet of Things 4.0.

        Field

        Description

        System Name

        <Any name>

        System Status

        Active

        URL Information

        Example:

        https://<tenant details>.cp.iot.sap

        User name

        User that will be used to make API calls to the system

        Password

        <password>

        Additional Information

        As required

        Primary system?

        Use Toggle

  2. Fetching mapping information from Asset central

    A mapping API will be provided which provides information about the objects in IoT Services mapped to objects in SAP Predictive Data Maintenance and Services.

    API: Application_URL/api/v1/equipment/<equipmentId>/iot/external/map

    Sample response: