Re: [core-parameters] NEW INTERFACE DESCRIPTION - KNX IoT Point API
Michael Critchfield <michael.critchfield@knx.org> Wed, 30 August 2023 20:43 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 BB3B6C1519B4 for <core-parameters@ietfa.amsl.com>; Wed, 30 Aug 2023 13:43:37 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -7.098
X-Spam-Level:
X-Spam-Status: No, score=-7.098 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_HI=-5, 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_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 Ygm5pR2JLrdc for <core-parameters@ietfa.amsl.com>; Wed, 30 Aug 2023 13:43:32 -0700 (PDT)
Received: from EUR02-VI1-obe.outbound.protection.outlook.com (mail-vi1eur02on2088.outbound.protection.outlook.com [40.107.241.88]) (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 8C0E8C15152B for <core-parameters@ietf.org>; Wed, 30 Aug 2023 13:43:30 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=SUcKluqJtlSkJMHPI58Weh50J/toJDquoQ6QHosCPFOpSHa/3hAACVg0pHIkOQ0o9E3AydmbvxfOaVT8tGRPfYr75o2T+pmn3Kb2h7sgxIWcqZmA8B+IFVYaybnQV3kEh3RzfGpFl7IYkyjB8a/hTuYS9HsXpjS1j5mP4+6sVRHx0u8fSjqXN4NCwuDHfuoAUJRfSKNFdWEodxKvIoNfMXRc8ZMPcMyZFhTULDPzTXTC4JB/SuMOi6cP1Wfp8WOmzLAT94tUol8Nog5qldOw53WNCC6SGS0yl+ih1nk+h0vhhblRMWrIbAcgCfTVsL+3tDwIakGPJqhm5HSrMXul9g==
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=ojC4leruLUq3JD/nk3PazKVtdnwvcwQqI8+j8NTwhmc=; b=bstNJew9atFNJyrX6dRlsIovjIujVXSf9wU2S1WPUArlUs3XVxLkKsOdD2XQV5IJNAGjxupuIE6c7G7csqebMKj9x6N6DHQVtarDF+FFM50OHqvjNHvjswjHVO30+J8U2zcjFs+avgojnu41bdCtE5bZpA+3cmjT57IBfPlWfwTpQCKcLgHgNEcEbsD7nw+KEFPoLFB+9CGfn7HOSOI126dFx/wmx9Yv0QCLW8knvAiX2athrDXFhO8qTLH8Bpi2bG+AUZMS5VhVxoQ1oLVFOD7bTYl0tmxsPwjp1lgBJtuDWwlC4+0KqdA6D6RQTbcgQIcy1r089QENpHfigdmCAA==
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=ojC4leruLUq3JD/nk3PazKVtdnwvcwQqI8+j8NTwhmc=; b=WNbc2GXiIqs3nhOOAyrC/nGIrbKjvfQ7RWo4aRLa1naKAG6otZDAmW+vLjSjNOBem8amkg8D3C1ctE4zW4mLmrsw8E5q4ss9YO07XStImxGhxivIDxX/gD2KgUXWU1HTOuRu8aA8AUYHe6oR7lxZamAxl+P+YuxLw7uRzPkwQxS/VnH4vzZKCtlRtK4aOM4Np73j7kgetfbZSaJ21j/Symw0KXBuUwWA6OTEKH96wXAzwfk80PvWmGazJwY6L688+tC/v08Ck+NKNeB2h0OHOVyFqT+QqRpADtKD42jvO6nh8eKdwFCdFWkbfoIn1/rRQQtIc5avWsdlQj+eh6hrgg==
Received: from AS8P251MB0199.EURP251.PROD.OUTLOOK.COM (2603:10a6:20b:406::12) by PAXP251MB0469.EURP251.PROD.OUTLOOK.COM (2603:10a6:102:276::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6699.34; Wed, 30 Aug 2023 20:43:26 +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.6745.021; Wed, 30 Aug 2023 20:43:26 +0000
From: Michael Critchfield <michael.critchfield@knx.org>
To: Esko Dijk <esko.dijk@iotconsultancy.nl>, "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+Ognhei3vG6QADvIxwAAoJg9A=
Date: Wed, 30 Aug 2023 20:43:26 +0000
Message-ID: <AS8P251MB0199DACAF9FD9F0A59C7023FFFE6A@AS8P251MB0199.EURP251.PROD.OUTLOOK.COM>
References: <AS8P251MB0199CD157A86EC31EF8845E7FFE6A@AS8P251MB0199.EURP251.PROD.OUTLOOK.COM> <DU0P190MB19784B616972400C29DEDEB7FDE6A@DU0P190MB1978.EURP190.PROD.OUTLOOK.COM>
In-Reply-To: <DU0P190MB19784B616972400C29DEDEB7FDE6A@DU0P190MB1978.EURP190.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_|PAXP251MB0469:EE_
x-ms-office365-filtering-correlation-id: b90e9bbe-d142-4d89-933b-08dba999c2a9
x-ms-exchange-senderadcheck: 1
x-ms-exchange-antispam-relay: 0
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: bPZx9GKYfPZu/R8LdOanxyFg+kw5BnuH2wp9iOT2GA5jgiBTjeuisOmyMVEACGgwr01gHF5ff4+0sTidatou8xoVxBTWAfscRX8/cj4KbRg62M/YpATiOWMp2c30qLO7jfTPwzOEWNZb3w2l6DcYN9U5f/uopByqodHCOc5DOunE48zU2oDL9QtZOJK9iLx4TnhJovA7zx3h4OIuIft5TGWLyecEs1btfed3zp+PpkZgdlqr6xb2WguONQ91VxsoXYjR3tCt9HF3MWeW3dwhZBF3xFJS2zb6GvobbBp4OGjPNYOQSd/A4qRntXYWKElaj+yzTWRemHnFuinOZnpRkwyMo4hEF4ECBO8bFTYOqon2QXgYqJXWJsqmzydV2nSQLHpAqRDGKADUdnccUVlZBnwDSV/+2PTKELjo3X4jqPXZJPIAd6fE4Zazfnqa4TYkOy7sFHGXAmR+TJvcqVHlXebGcRCGKSoiUoB7vusU/lhMhqd3AbTj5kBbb7OG774S8IVPEjxCuR5Uant3+n7YpIYa5uhhc5eemq8bHR7f8VF3vFaNXT4PRbqDfccyWapAc3N1IBtQ0qI0WLD7DSGIm7nqhJ93zjtHemF/IBVaGS0=
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)(346002)(136003)(39850400004)(396003)(376002)(1800799009)(186009)(451199024)(6506007)(166002)(55016003)(71200400001)(53546011)(7696005)(9686003)(2906002)(33656002)(44832011)(5660300002)(52536014)(16799955002)(38100700002)(66556008)(66446008)(66946007)(4326008)(76116006)(8936002)(86362001)(41300700001)(110136005)(64756008)(8676002)(38070700005)(316002)(19627235002)(66476007)(54906003)(122000001)(966005)(478600001)(83380400001)(99936003)(66574015)(26005); DIR:OUT; SFP:1101;
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: zU73QewbTJBEJpU3lJ2yhIyBhgsibxAHBboDZlkzrMilYfNS5YcEM7uTX+j1nNEsEWlBv4KE76Bs9FOd9qAXR5oHVMdDTdcq5UyyGFs2+CHqnAhQ5rqMw+1C3AcGYDr667t/UPaPqnTaarzdU8/5IFL4l6MjUk7O4xFVs+itTM31FnSGnMgeGMYWMLSMBFz3Evy0Wd2s/V9wLJNZNoyaaJfEWRiYniOZuaqyeSuGyCsHnnsqfHTeaeie9hDblpA6r93eYXmchLvBtaTDYtY/bHgGEuB/kGhKp84H1MnEXYbGvbdliD3StchX4LGEh0WUNMpZglIRl5Euq6CSiPTSB12124KTXSeWK1BGi/6e2DPFfh8zgrjLTkFyN61QXN+LOpgazkRyZ+6WjLlpCCUjM7OQCn1linbyCsST0kfbr0WE0Yeag/Sy+t00A2uJPY5O/m6VKX916VCPTpyRgV4fgWh8BZxIEcvIaVFCDm98ytuJaIe+FkwubGis23LmGAFBzyyABgRSYH2gMyo5MOqXbZrTsAWZ/Zqdn6eVXJqxosOvJZl52vVEPpUUBlNmR6O1gbsFxyXaj8O7fyAsPF+WmW6kE1OpM3V1fgzs49kjHwNqBz00Fb4oOaMDR6YPyuEgWT0wKtGS+cl7qoMWRY9ajmmRz45mU2OW1yTcMAI1k1+d34E0HHetGIB5DhRaTWLS/wI1VIXVp2SPY7dE4W2iNoBIuOeAg/+yV6DaxPHtPi/EQdr7ydjwWwdxtHeDk4Ax74YNQwosIptyro5HrJY7aWQdJQpYNqNMVGE1wJT70dFN1Hah6Q1scf/9EJZHRa65bQH6VuodNDW1tEvfrHCeE/FYU+5GtkL3NdmJpzaKwmOXgI4wmLiZrPGp21ufPxOVUCmpLAsAfFJ+A5AEu29qgIvS4DbdeRHnqPwivsiJx0rX6/bH7pagvToTxi9P50pcBu6HwMoeI9DroD1ZEwmwWujcisK1pWNfE7ZsNm52QcFdyDe7fy5REfuz5PZ26Tx/eVSHtnfaaBes0GkBr8z0BCdPZ/SwbEQQuFSBrKOYAEisI+nD/XkxHUnoDpcbyGtFgER0W2tRDbJjxRMcjn9LGAKtTXVrb+nvKQtvNEaE8IfWNJyeOvVM89kKPoM/mN9wU+AmGR/BvW1hC49M5cq8R0L/+058nXheURKnBApq/7ZeGFp1awl+GyI6wyRwqghGLXIOYjaFljXYXkTPbOf4u93rRFTVmTStfRtfewEleMVgA0G5UoRG+er4z02Xy4uEUQMIAaEjLQJCP8RrdLNy07W9l6f22hLrFazXvRD+tpKJvdP10b0jyvxp8Yk8aPcAHIPBNwjnvDcmmZ/TXFWV34fG/8tB+JitDJooETSSVTzMaW0pZ0hDZVOe/V85DUjvqtaVz0ACmI8bQloB1a+FriKn8gJe0eatzBfAEfw5iKMFEKdFntlqZdMQ0wSGu+UNDpOpu7Dd3T8OQN+naCwFiRPQnA7VCqC54aSeHg1VjBirWBXbRMEIQxDseJWvB5+xXQxJCtlc90M2bOQJSyc3YUzxKAzoyOy+xNfgyS6v2q1O56ImEkSWOCGQsYMhScpr
Content-Type: multipart/related; boundary="_004_AS8P251MB0199DACAF9FD9F0A59C7023FFFE6AAS8P251MB0199EURP_"; 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: b90e9bbe-d142-4d89-933b-08dba999c2a9
X-MS-Exchange-CrossTenant-originalarrivaltime: 30 Aug 2023 20:43:26.4015 (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: /VHLKOp/cntoQK/SWFefEAfZBN0fo5P8Kr/JxzJs0xFAIAoppD8c8Sv5PyI4Hs5NyKJJMx8BlZVBPiAYRNsvAg==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: PAXP251MB0469
Archived-At: <https://mailarchive.ietf.org/arch/msg/core-parameters/Havq9Rd1Whayo16Q3PxFyTZYS2Q>
Subject: Re: [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 20:43:37 -0000
Thank you Esko, we did request the URN namespace registration like you suggested as well, right after requesting the Interface registration here. But there we got feedback requesting more information (from your colleague Ted Hardie) and will discuss internally how to respond. I will get back to you here once that is clarified. Can you hold the registration request until then? Best regards, Michael Von: Esko Dijk <esko.dijk@iotconsultancy.nl> Gesendet: Mittwoch, 30. August 2023 17:59 An: Michael Critchfield <michael.critchfield@knx.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 Betreff: RE: NEW INTERFACE DESCRIPTION - KNX IoT Point API Thanks Michael, I would like to check with other list members/experts if registration is possible at all. The interface names all are URNs. RFC 6690 states for URIs (which includes all URNs) a registration MUST NOT be made in the registry. All URNs are free to use by the respective namespace owner. So what KNX would need to do , is register its (top level) URN namespace at the registry over here: https://www.iana.org/assignments/urn-namespaces/urn-namespaces.xhtml . Then KNX can define all the items in there as it wants without requiring any IETF/CoRE expert involvement. Regards Esko PS I'm noting that Table 6 shows the interface values without the URN prefix, however, the examples in the spec and normative language make clear that the "urn:knx:" needs to be preprended to all the items. From: core-parameters <core-parameters-bounces@ietf.org<mailto:core-parameters-bounces@ietf.org>> On Behalf Of Michael Critchfield Sent: Wednesday, August 30, 2023 16:04 To: core-parameters@ietf.org<mailto:core-parameters@ietf.org> Cc: Joost Demarest <joost.demarest@knx.org<mailto:joost.demarest@knx.org>>; André Hänel <ahaenel@knx.org<mailto:ahaenel@knx.org>>; Steven De Bruyne <steven.debruyne@knx.org<mailto:steven.debruyne@knx.org>>; wouter.van.der.beek@gmail.com<mailto:wouter.van.der.beek@gmail.com> Subject: [core-parameters] NEW INTERFACE DESCRIPTION - KNX IoT Point API 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@01D9DB92.B37D1ED0]<https://knxperience.knx.org/> This email comes from outside KNX organization. Do not click links (with or without explicit IP addresses) or open attachments unless it is an email you expected to receive.
- [core-parameters] NEW INTERFACE DESCRIPTION - KNX… Michael Critchfield
- Re: [core-parameters] NEW INTERFACE DESCRIPTION -… Esko Dijk
- Re: [core-parameters] NEW INTERFACE DESCRIPTION -… Michael Critchfield
- Re: [core-parameters] NEW INTERFACE DESCRIPTION -… Esko Dijk
- Re: [core-parameters] NEW INTERFACE DESCRIPTION -… Esko Dijk
- Re: [core-parameters] NEW INTERFACE DESCRIPTION -… Esko Dijk
- Re: [core-parameters] NEW INTERFACE DESCRIPTION -… wouter.van.der.beek
- Re: [core-parameters] NEW INTERFACE DESCRIPTION -… Esko Dijk
- Re: [core-parameters] NEW INTERFACE DESCRIPTION -… Esko Dijk