[core-parameters] NEW INTERFACE DESCRIPTION - KNX IoT Point API

Michael Critchfield <michael.critchfield@knx.org> Wed, 30 August 2023 14:04 UTC

Return-Path: <michael.critchfield@knx.org>
X-Original-To: core-parameters@ietfa.amsl.com
Delivered-To: core-parameters@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 4C6E7C15153F for <core-parameters@ietfa.amsl.com>; Wed, 30 Aug 2023 07:04:04 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.097
X-Spam-Level:
X-Spam-Status: No, score=-2.097 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_PASS=-0.001, T_KAM_HTML_FONT_INVALID=0.01, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=knx.org
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id iHbwDIISaOj2 for <core-parameters@ietfa.amsl.com>; Wed, 30 Aug 2023 07:03:59 -0700 (PDT)
Received: from EUR05-AM6-obe.outbound.protection.outlook.com (mail-am6eur05on2051.outbound.protection.outlook.com [40.107.22.51]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 85E9FC14CE40 for <core-parameters@ietf.org>; Wed, 30 Aug 2023 07:03:57 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=cIBpIxLbkJ3wQ8TSJeZmtX4w4G3t+IjRqkxIMnOx0hu+PhKGbi+oP2YhoJe+gofUHcUclFgoCbHZ6ly1YlbqAvlZkMzkTTrHDHF1tmqFS9MrVmEojyRJMkHzfNfF4rSr5H86CzQED40U21dPIan4o+nveKnwOl3wxHMF9lY+jgw20B/FsMYRCkDwfxXDoYR3qU+Q2stiKQTdtSvSUgqQTv8zk/GY/fFxAPQHCKgyLVGY/mfXR8IME1NuwaNi5BfUbT9WriqbP/fW3uJK2Y7dV9Ta/BrUbnoYFGVRb6In70x6zbuH2AZlJEY1xZOP7Pgy5cU65F20uC8QwhC5LIUjdQ==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=NaLfNsT8sM0K97s/8JY3iAnoC6xYENcUPl2TkfLhl9U=; b=RKK7sECJ31lGfG0iCQHEL/5UpFAWnigr05P1x6a65N2fMCLjwvlxiURBIWBAW7w/ElWCdUNxUT19g18VdBH3o8kEv9Li+ww8nXUEqdnbS/Md3Gw40GsE6zSy3s7xtAtxvVKZauNXGzUkTugVwSkDwkktjgOLOJlErYuAM5PsSchiyvfo9i7TCLLRNgL9vojTqTzu08KDo4m6QaiR94HOCeEDgHvhAjs8nA/AwVERJzYFpc62y7g1bRKUSFI+zv3MmkGK3XjYafNePwBVB0EoaqHOyehS024qZ2gNQf0fNKgB6Jukks7bh44IbjFQOUmj8n/YAgjTsF9//+pRhyej0A==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=knx.org; dmarc=pass action=none header.from=knx.org; dkim=pass header.d=knx.org; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=knx.org; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=NaLfNsT8sM0K97s/8JY3iAnoC6xYENcUPl2TkfLhl9U=; b=BIUWJ3F7Nmxwh9vTJ84JZlbg+oesfOWiSiU3NUM/GfTAj6Wv7c8OUl6JKfidjZQQpo+iJIr1GpEC1LeCujmTSXvfySroriOMefdnM1EUEz2eYBj92a94rQ1kkByo5kw71eKMOVsIjaFAiK5zgbUXQ2p+I1zRJQu0MT4mJ4hkhtSeSal52VRZ57mUaf6lqqb7woRaZHOfL1eUxoTIIXyTgG+vYeb7+3WlQWbYSp/URMzxI6TD+EBFz5sQsE7yEl6Pb00bj0Pe7prcYGjgqg9IwXYggYY6QFywYEAYQQCJKZ4KMa2bkLx6o+Ep4LH+/SKaJ9YcDFG08rqcVVEY7ovZOw==
Received: from AS8P251MB0199.EURP251.PROD.OUTLOOK.COM (2603:10a6:20b:406::12) by AS4P251MB0585.EURP251.PROD.OUTLOOK.COM (2603:10a6:20b:4bc::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6699.36; Wed, 30 Aug 2023 14:03:52 +0000
Received: from AS8P251MB0199.EURP251.PROD.OUTLOOK.COM ([fe80::1b42:ca70:7ea1:ea06]) by AS8P251MB0199.EURP251.PROD.OUTLOOK.COM ([fe80::1b42:ca70:7ea1:ea06%4]) with mapi id 15.20.6699.035; Wed, 30 Aug 2023 14:03:52 +0000
From: Michael Critchfield <michael.critchfield@knx.org>
To: "core-parameters@ietf.org" <core-parameters@ietf.org>
CC: Joost Demarest <joost.demarest@knx.org>, André Hänel <ahaenel@knx.org>, Steven De Bruyne <steven.debruyne@knx.org>, "wouter.van.der.beek@gmail.com" <wouter.van.der.beek@gmail.com>
Thread-Topic: NEW INTERFACE DESCRIPTION - KNX IoT Point API
Thread-Index: AdnbSsp8vJjvadjkQF+Ognhei3vG6Q==
Date: Wed, 30 Aug 2023 14:03:52 +0000
Message-ID: <AS8P251MB0199CD157A86EC31EF8845E7FFE6A@AS8P251MB0199.EURP251.PROD.OUTLOOK.COM>
Accept-Language: de-DE, en-US
Content-Language: de-DE
X-MS-Has-Attach: yes
X-MS-TNEF-Correlator:
authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=knx.org;
x-ms-publictraffictype: Email
x-ms-traffictypediagnostic: AS8P251MB0199:EE_|AS4P251MB0585:EE_
x-ms-office365-filtering-correlation-id: 691b8e46-b73f-46b5-2eaa-08dba961f130
x-ms-exchange-senderadcheck: 1
x-ms-exchange-antispam-relay: 0
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: EbYBbgRuChs+C79LI2xoXxHuEdpflzfKDjeNndPSbL5wkSxLD5CfVtdfN/cPViKY9YjC0JTrn5LuTMeaPIxaBMoJq9ZTgvIat1zr4MOPQcSrrpFHSZlW8kMQwqM92BT5yuZLY57UjQOdp+ar0JUM4/ZAYshix8WlFRrzGZQtrtxBBxvkja6Kf+jFLVmN7X9q0rHcJrUoDh2P5dVxz6xWMoYVOvf+5t3zWljT79m5eMSCxg7FOaOAxXRsBUeFOl21a4OEdqVoggSma+wMbiB6m2Xgg2Qy/iXHNEbtT4KzF4NJ6jVGFxpo7RT3O3ESHLbZNBb+bfvtjSAKEP5XuovMBj4atMEULkc3TkPHP6VTYLnYADzwkh/B2LdxTjZwNSdrXmd8dpT9uQfs5xK/OYPE4WWwnIHQw1ZibK5vLCerelYbkiYJhKw3flZrGJch7KArJ9oUaiZygpLq9BVLDD19QC+MVBr3KT8YiPtFv6m0VelNhJASbRsFP060L6w24pGMo4MdVJgne+kLX/tQjTKM/W/u1h7mpL5gVhX39+h0GTAnhRRN4qayy+GorZftbydBLF0jFRbZBdS02+HHbPWV4NOdUjkEGASrrRyPuvsYUF4=
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:AS8P251MB0199.EURP251.PROD.OUTLOOK.COM; PTR:; CAT:NONE; SFS:(13230031)(366004)(39850400004)(376002)(136003)(346002)(396003)(451199024)(1800799009)(186009)(9686003)(26005)(316002)(38100700002)(6916009)(38070700005)(41300700001)(4326008)(33656002)(55016003)(2906002)(52536014)(16799955002)(86362001)(5660300002)(44832011)(8676002)(83380400001)(8936002)(99936003)(19627235002)(166002)(71200400001)(66446008)(7696005)(966005)(6506007)(64756008)(66476007)(66556008)(54906003)(76116006)(66946007)(478600001)(122000001); DIR:OUT; SFP:1101;
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: pAT/J7w+SOB9flhE8IW5kNSb0AVYjF0uddGsSqpI6Nxj0eseF48RcpcXmc+CfvD4Xun5zO1pygLP5tjfLdHBjPKT+jdV12n7biC1XpLUER8DIWjHV4G0sDBbS6f5ob/yXHf2BaiEt5X1/Pt1725zW2DwAGlXe/iqdyKA0+0fOoQmlboiDQhzLnzka+NQOyqs+76zvbWLotfRRCDtiNpGfveOoLxInJ2mwf9twDI1Avqjx2OCKuHWKgkw32TKXs3OOgeWeDVNcfaKP1p1rnh4h5ZQW3q47Cs2IA1fI3LlDEPX4y45saz8IBXRBpPr7b1qn06kqOyHVqWLcY6c0gF7+thYcLvsE4BIuNIFYV8okDKZQbz2embqfuCiyS61IX5GRLodPECzdcHHFvj8Z0o+v4zuZFBSiTW/Z4+FDa1nhxAvumc+YrotHZ/k0pgZ/OZ6NbeG6257MbIQdd2rlb0mSyj4OuupsKI5QXqqrv42Ijl/l8AG+QwEK3c+xCfTB8j16s2A/Y1bhV7gtVQNv5Ve4KuMtjugh1qe+zBrV5jbMrJBbEuZWGQVBM1u32XqjlLrlCOFzXgSlToUXycZctPLjJrkMsKPs/NFOi1bmK+JuuvKDqrIAFJo2Yf7yUQqGvFJwHb/LsgCIguZniVXlo/NPBHy9TEJEJwWuZOIQz35fV0zvRN6EpIadrkda8Q6aUo3RownJZO+LN2A+oGH5UIFeQ74I1d7qfQno7jghA6QIUr9M69TUf8+pxI0dWD3SKQ+9iTXwyEDzz1H7Lp9olZLetlyKQoyyeTRoYcuwWSFV7+smF6gOrOEcKZ437CFsAkTIV7j0z6Bb72v0kZdgB+JKbcSkR8c7veHnYlArUGIbRIcFpQc9f9ILpLE4kvUNRgkn9GDWNDwF/7q4R1QYrlLTzPXWHrgHm2Y07FZfSO8lOLd4+0EwkkeVdJGBp/Q4Ama4xTGiJVTV0TbEOMCw9STRxiUiBFrxOU8Vjs8TNQsT5GtqazgpxOy2oMi2HYPIZdZ9Bbm7nnwUwmywd5skqmcFcTDbSYrEhVmhbKp+MSj6PbU5YQFFa4rpqBbBSCK7xkHv2vLaTOlUUVN+R6KFyezxLMZawtsfSq1m5+RQ+I8uKayO+HOUy5UNPK3IGbp/5/5KmhNvLCK90OPDv6SX7ibBu6Hpi+pxW2ugUcX9qxAKeGhSwLrEGruhZNwT4U9Em0RydZqLgdTrwB/KKqnEmw3RHyVmVuJ4X4WHvZlyinYxWctx9R7G0oXob2TTeY/sTWAF5w8Y7ffm/rJzsYj8KEXFqPWe4B4uWX3t0r6oO069AeRRBkI2Als7a7dkQMrrHwwqUNNeiuB7EFBPcu/57ZFofBrvco7adDjS58UsHcsRnXX7QOyd/VWRif1llLQB+6IsJaWWjNcoPxVFbf9rDJvfb2YCiNXXEVgFetK1w/eqFR3mdJcT7V/rMpR97gbSiIAC1gYWPHl2ze9oy9TGruAPDVdlzAhoeGmjThqyimc0fIR37P3aERG1th9I4itAu6W3UbaCcyPZk8Ul//0VBzI2zweg6U2oC7w5oLZlN+OJ1iVmiwAEKqd9hDjzqsQjv3m
Content-Type: multipart/related; boundary="_004_AS8P251MB0199CD157A86EC31EF8845E7FFE6AAS8P251MB0199EURP_"; type="multipart/alternative"
MIME-Version: 1.0
X-OriginatorOrg: knx.org
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: AS8P251MB0199.EURP251.PROD.OUTLOOK.COM
X-MS-Exchange-CrossTenant-Network-Message-Id: 691b8e46-b73f-46b5-2eaa-08dba961f130
X-MS-Exchange-CrossTenant-originalarrivaltime: 30 Aug 2023 14:03:52.6276 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 974fcdbe-f44c-4d9a-b822-57d15d8ebc54
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: LNc4apYvJ21SgL4qt2aY9KNV/egV1zC9HbapOEFKqqzdSAEafsQ22Ph6QbbGYcvxInz2vdpXdUk568KNH0Sc2A==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS4P251MB0585
Archived-At: <https://mailarchive.ietf.org/arch/msg/core-parameters/LFrgZ6aXotVZBkCBZMULpBcLR4k>
X-Mailman-Approved-At: Wed, 30 Aug 2023 07:58:12 -0700
Subject: [core-parameters] NEW INTERFACE DESCRIPTION - KNX IoT Point API
X-BeenThere: core-parameters@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: "Expert review of CoAP parameters." <core-parameters.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/core-parameters>, <mailto:core-parameters-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/core-parameters/>
List-Post: <mailto:core-parameters@ietf.org>
List-Help: <mailto:core-parameters-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/core-parameters>, <mailto:core-parameters-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 30 Aug 2023 14:43:24 -0000

Dear Core Parameters Team,
As KNX Association cvba, we would like to register the following Interfaces from our KNX IoT Point API Specification with you for listing in Constrained RESTful Environments (CoRE) Parameters (iana.org)<https://www.iana.org/assignments/core-parameters/core-parameters.xhtml#if-link-target-att-value>.

Reference is our KNX IoT Point API Specification available on https://schema.knx.org.
Specifically, the KNX IoT Point API Specification is found under this link https://knxcloud.org/index.php/s/KNjAyyO0ojm5LSc/download.
The Table below refers to the KNX IoT Information Model in various places, you can find this on https://schema.knx.org and https://knxcloud.org/index.php/s/E12pxbhctLEREaO/download.
If required, Registration contact shall be Joost Demarest, CTO at KNX Association, joost.demarest@knx.org<mailto:joost.demarest@knx.org>.


Type

Interface

Method

Description

Link List

urn:knx:if.ll

GET, (OBSERVE)

Read a linked list and, in combination with if.o, subscribe to all Points of the list.

Parameter

urn:knx:if.p

GET, PUT, (OBSERVE)

Adjust parameter Point (see [03] "KNX Information Model").

Diagnostic

urn:knx:if.d

GET, (OBSERVE)

Read diagnostic Point (see [03] "KNX Information Model").

Configuration

urn:knx:if.c

GET, PUT, POST, DELETE

Configuration and programming of a device.

Logical Input

urn:knx:if.i

PUT, POST

Write and command runtime input Group Object Point (see [03] "KNX Information Model").

Logical Output

urn:knx:if.o

GET, POST, OBSERVE

Read and subscribe runtime output Group Object Point (see [03] "KNX Information Model").

Group Communication

urn:knx:if.g.s

POST, GET (OBSERVE)

Group communication (S-Mode) runtime interworking (input and output) address.

Batch

urn:knx:if.b

GET, PUT, POST

Read or write a collection (e.g., Point list).

Actuator

urn:knx:if.a

GET, PUT, POST

Hardwired actuator (see [03] "KNX Information Model").

Sensor

urn:knx:if.s

GET, PUT

Hardwired sensor (see [03] "KNX Information Model").

Security

urn:knx:if.sec

GET, PUT, POST, DELETE

Configuration (read and write) of security, incl. authorization-related data.

Software Update

urn:knx:if.swu

GET, PUT, POST, DELETE

Software update (push and pull) related data.

Programming Mode

urn:knx:if.pm

GET

Data that can be read in Programming Mode.

Manufacturer

urn:knx:if.m.{name}

Manufacturer-specific definition

Manufacturer-specific interface types.
Interface definitions and methods (from Table 6 of the KNX IoT Point API Specification on https://schema.knx.org)

In the meantime, please contact me for any registration related questions in this regard.

Many thanks in advance.
Best regards,

MICHAEL CRITCHFIELD
ETS Product Management
michael.critchfield@knx.org<mailto:michael.critchfield@knx.org> * T +49 151 50 666255

KNX Association
De Kleetlaan 5, B-1831 Brussels-Diegem * Belgium
www.knx.org<http://www.knx.org/>

[cid:image001.png@01D9DB56.BC4C07B0]<https://knxperience.knx.org/>