Skip to main content

Semantic Definition Format (SDF) Extension for Non-Affordance Information
draft-hong-asdf-sdf-nonaffordance-00

Document Type Active Internet-Draft (individual)
Authors Jungha Hong , Hyunjeong Lee
Last updated 2025-04-08
RFC stream (None)
Intended RFC status (None)
Formats
Stream Stream state (No stream defined)
Consensus boilerplate Unknown
RFC Editor Note (None)
IESG IESG state I-D Exists
Telechat date (None)
Responsible AD (None)
Send notices to (None)
draft-hong-asdf-sdf-nonaffordance-00
ASDF                                                        J. Hong, Ed.
Internet-Draft                                                    H. Lee
Intended status: Standards Track                                    ETRI
Expires: 10 October 2025                                    8 April 2025

     Semantic Definition Format (SDF) Extension for Non-Affordance
                              Information
                  draft-hong-asdf-sdf-nonaffordance-00

Abstract

   This document describes an extension to the Semantic Definition
   Format (SDF) for representing non-affordance information of Things,
   such as physical, contextual, and descriptive metadata.  This
   extension introduces a new class, sdfNonAffordance, that enables
   comprehensive modeling of Things and improves semantic clarity.

Status of This Memo

   This Internet-Draft is submitted in full conformance with the
   provisions of BCP 78 and BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF).  Note that other groups may also distribute
   working documents as Internet-Drafts.  The list of current Internet-
   Drafts is at https://datatracker.ietf.org/drafts/current/.

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet-Drafts as reference
   material or to cite them other than as "work in progress."

   This Internet-Draft will expire on 10 October 2025.

Copyright Notice

   Copyright (c) 2025 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents (https://trustee.ietf.org/
   license-info) in effect on the date of publication of this document.
   Please review these documents carefully, as they describe your rights
   and restrictions with respect to this document.  Code Components
   extracted from this document must include Revised BSD License text as
   described in Section 4.e of the Trust Legal Provisions and are
   provided without warranty as described in the Revised BSD License.

Hong & Lee               Expires 10 October 2025                [Page 1]
Internet-Draft    SDF Extension for Non-Affordance Info       April 2025

Table of Contents

   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   2
   2.  Terminology and Conventions . . . . . . . . . . . . . . . . .   2
   3.  Motivation and Use Cases  . . . . . . . . . . . . . . . . . .   3
     3.1.  Motivation  . . . . . . . . . . . . . . . . . . . . . . .   3
     3.2.  Use Cases . . . . . . . . . . . . . . . . . . . . . . . .   3
   4.  SDF Extension for Non-Affordance Information  . . . . . . . .   4
     4.1.  Concept . . . . . . . . . . . . . . . . . . . . . . . . .   4
     4.2.  Syntax and Semantics  . . . . . . . . . . . . . . . . . .   4
     4.3.  Examples  . . . . . . . . . . . . . . . . . . . . . . . .   5
   5.  Security Considerations . . . . . . . . . . . . . . . . . . .   6
   6.  IANA Considerations . . . . . . . . . . . . . . . . . . . . .   6
   7.  Normative References  . . . . . . . . . . . . . . . . . . . .   6
   Authors' Addresses  . . . . . . . . . . . . . . . . . . . . . . .   6

1.  Introduction

   The Semantic Definition Format (SDF) has been instrumental in
   standardizing the representation of affordances - properties,
   actions, and events - of Things [I-D.ietf-asdf-sdf].  However, there
   exists a gap in representing non-affordance information, such as
   location, contextual metadata, and other descriptive elements that do
   not directly pertain to device interactions.  Addressing this gap is
   crucial for comprehensive device modeling, especially in applications
   like digital twins where holistic representations are essential.

   This document describes a framework to extend the SDF by
   incorporating non-affordance information.  Integrating these
   extensions allows SDF to provide a more comprehensive representation
   of Things, thereby enhancing semantic descriptions.

2.  Terminology and Conventions

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
   "OPTIONAL" in this document are to be interpreted as described in
   BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all
   capitals, as shown here.

   *  Non-Affordance: attributes of a Thing that are not directly
      related to its interactive capabilities.  This includes
      descriptive metadata such as location, manufacturer details, and
      other contextual information.

Hong & Lee               Expires 10 October 2025                [Page 2]
Internet-Draft    SDF Extension for Non-Affordance Info       April 2025

3.  Motivation and Use Cases

   The integration of non-affordance information into the Semantic
   Definition Format (SDF) addresses several critical needs in the
   modeling of Internet of Things (IoT) devices.  The key motivations
   and corresponding use cases in the following subsections illustrate
   the importance of this extension:

3.1.  Motivation

   In the current SDF framework, the primary focus is on defining
   affordances - interactive elements such as Properties, Actions, and
   Events.  While this approach effectively captures the interactive
   capabilities of a Thing, it overlooks essential non-interactive
   attributes that are vital for a comprehensive device representation.
   These non-affordance attributes encompass contextual information and
   descriptive metadata, including dimensions, weight, location,
   manufacturer details, and operational constraints.  The absence of
   standardized representation for such information can lead to
   fragmented device models, hindering interoperability and the seamless
   integration of devices across diverse IoT ecosystems.

3.2.  Use Cases

   3.2.1.  Asset Management and Tracking

   *  Scenario: A logistics company utilizes IoT-enabled containers
      equipped with sensors to monitor shipments.

   *  Requirement: To effectively manage and track these assets, it's
      crucial to have standardized data on each container's physical
      dimensions, weight capacity, and current location.

   *  Solution: Incorporating non-affordance information into SDF allows
      for the uniform representation of these attributes, facilitating
      efficient asset tracking, optimizing load planning, and ensuring
      compliance with transportation regulations.

   3.2.2.  Environmental Context Awareness

   *  Scenario: A smart building management system integrates various
      sensors and devices to monitor and control environmental
      conditions.

   *  Requirement: Understanding the installation environment of each
      device, such as room location, mounting position, and surrounding
      materials, is essential for accurate data interpretation and
      optimal system performance.

Hong & Lee               Expires 10 October 2025                [Page 3]
Internet-Draft    SDF Extension for Non-Affordance Info       April 2025

   *  Solution: By extending SDF to include environmental context as
      non-affordance information, the system can dynamically adjust
      operations based on device placement and environmental factors,
      enhancing occupant comfort and energy efficiency.

   3.2.3.  Regulatory Compliance and Certification

   *  Scenario: Medical devices deployed in healthcare facilities must
      adhere to stringent regulatory standards and certifications.

   *  Requirement: Detailed documentation of each device's manufacturer,
      model number, serial number, and certification information is
      necessary for compliance audits and maintenance schedules.

   *  Solution: Embedding this non-affordance information within SDF
      ensures that all relevant metadata is consistently available,
      simplifying compliance reporting and facilitating timely
      maintenance and recalls when necessary.

   By integrating non-affordance information into SDF, these use cases
   demonstrate how a more holistic device model enhances
   interoperability, operational efficiency, and compliance across
   various IoT applications.

4.  SDF Extension for Non-Affordance Information

4.1.  Concept

   In the SDF, the primary focus has been on defining affordances -
   interactive elements such as Properties, Actions, and Events - that
   specify how external entities can interact with a Thing.  However, to
   achieve a more comprehensive representation of a Thing, it's
   essential to include non-affordance information, which encompasses
   attributes not directly related to interaction but crucial for
   understanding the Thing's context and characteristics.

   To address this need, we propose introducing a new class named
   sdfNonAffordance within the SDF architecture.  This class allows for
   the inclusion of metadata such as physical dimensions, location,
   environmental context, and manufacturer details.

4.2.  Syntax and Semantics

   The sdfNonAffordance is defined with attributes such as:

   *  name: Identifier for the non-affordance attribute.

   *  description: Textual explanation of the attribute.

Hong & Lee               Expires 10 October 2025                [Page 4]
Internet-Draft    SDF Extension for Non-Affordance Info       April 2025

   *  type: Data type (e.g., string, number, object, boolean, array) of
      the attribute value.

   *  unit: Applicable measurement unit, if relevant.

             {
              "sdfObject": {
                 "device": {
                     "sdfNonAffordance": {
                         "attribute-name": {
                             "description": "Attribute description",
                             "type": "data type",
                             "unit": "unit if applicable"
                     }
                   }
                 }
               }
             }

               Figure 1: Structure of sdfNonAffordance in SDF

   This structure ensures clarity and consistency in representing non-
   affordance information.

4.3.  Examples

   4.3.1.  Geospatial information

             {
              "sdfObject": {
                 "tracker-device": {
                     "sdfNonAffordance": {
                         "location": {
                             "description": "Geographical coordinates",
                             "type": "object",
                             "wgs84": {
                                 "latitude": 60.1676,
                                 "longitude": 24.9514
                       }
                     }
                   }
                 }
               }
             }

                Figure 2: Example of geospatial information

   4.3.2.  TBD

Hong & Lee               Expires 10 October 2025                [Page 5]
Internet-Draft    SDF Extension for Non-Affordance Info       April 2025

   4.3.3.  TBD

5.  Security Considerations

   TBD

6.  IANA Considerations

   TBD

7.  Normative References

   [I-D.ietf-asdf-sdf]
              Koster, M., Bormann, C., and A. Keränen, "Semantic
              Definition Format (SDF) for Data and Interactions of
              Things", Work in Progress, Internet-Draft, draft-ietf-
              asdf-sdf-23, 17 March 2025,
              <https://datatracker.ietf.org/doc/html/draft-ietf-asdf-
              sdf-23>.

   [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
              Requirement Levels", BCP 14, RFC 2119,
              DOI 10.17487/RFC2119, March 1997,
              <https://www.rfc-editor.org/rfc/rfc2119>.

   [RFC8174]  Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC
              2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174,
              May 2017, <https://www.rfc-editor.org/rfc/rfc8174>.

Authors' Addresses

   Jungha Hong (editor)
   Electronics and Telecommunications Research Institute
   218 Gajeong-ro, Yuseong-gu
   Daejeon
   34129
   South Korea
   Phone: +82 42 860 0926
   Email: jhong@etri.re.kr

   Hyunjeong Lee
   Electronics and Telecommunications Research Institute
   218 Gajeong-ro, Yuseong-gu
   Daejeon
   34129
   South Korea
   Phone: +82 42 860 1213

Hong & Lee               Expires 10 October 2025                [Page 6]
Internet-Draft    SDF Extension for Non-Affordance Info       April 2025

   Email: hjlee294@etri.re.kr

Hong & Lee               Expires 10 October 2025                [Page 7]