| rfc9100v3.txt | rfc9100.txt | |||
|---|---|---|---|---|
| Internet Engineering Task Force (IETF) C. Bormann | Internet Engineering Task Force (IETF) C. Bormann | |||
| Request for Comments: 9100 Universität Bremen TZI | Request for Comments: 9100 Universität Bremen TZI | |||
| Updates: 8428 July 2021 | Updates: 8428 August 2021 | |||
| Category: Standards Track | Category: Standards Track | |||
| ISSN: 2070-1721 | ISSN: 2070-1721 | |||
| Sensor Measurement Lists (SenML) Features and Versions | Sensor Measurement Lists (SenML) Features and Versions | |||
| Abstract | Abstract | |||
| This short document updates RFC 8428, "Sensor Measurement Lists | This short document updates RFC 8428, "Sensor Measurement Lists | |||
| (SenML)", by specifying the use of independently selectable "SenML | (SenML)", by specifying the use of independently selectable "SenML | |||
| Features" and mapping them to SenML version numbers. | Features" and mapping them to SenML version numbers. | |||
| skipping to change at line 113 ¶ | skipping to change at line 113 ¶ | |||
| The present specification defines "SenML Features", each identified | The present specification defines "SenML Features", each identified | |||
| by a "feature name" (a text string) and a "feature code" (an unsigned | by a "feature name" (a text string) and a "feature code" (an unsigned | |||
| integer less than 53). | integer less than 53). | |||
| The specific version of a SenML pack is composed of a set of | The specific version of a SenML pack is composed of a set of | |||
| features. The SenML version number ("bver" field) is then a bitmap | features. The SenML version number ("bver" field) is then a bitmap | |||
| of these features represented as an unsigned integer, specifically | of these features represented as an unsigned integer, specifically | |||
| the sum of, for each feature present, two taken to the power of the | the sum of, for each feature present, two taken to the power of the | |||
| feature code of that feature (Figure 1). | feature code of that feature (Figure 1). | |||
| __ 52 fc | __ 52 fc | |||
| version = \ present(fc) ⋅ 2 | version = \ present(fc) ⋅ 2 | |||
| /__ fc = 0 | /__ fc = 0 | |||
| Figure 1: Feature Bitmap as a Sum (Sigma Symbol) of Feature Bits | Figure 1: Feature Bitmap as a Sum (Sigma Symbol) of Feature Bits | |||
| where present(fc) is 1 if the feature with the feature code "fc" is | where present(fc) is 1 if the feature with the feature code "fc" is | |||
| present, 0 otherwise. (The expression 2^fc can be implemented as "1 | present, 0 otherwise. (The expression 2^fc can be implemented as "1 | |||
| << fc" in C and related languages.) | << fc" in C and related languages.) | |||
| 2.1. Discussion | 2.1. Discussion | |||
| skipping to change at line 319 ¶ | skipping to change at line 319 ¶ | |||
| 7.2. Informative References | 7.2. Informative References | |||
| [RFC7493] Bray, T., Ed., "The I-JSON Message Format", RFC 7493, | [RFC7493] Bray, T., Ed., "The I-JSON Message Format", RFC 7493, | |||
| DOI 10.17487/RFC7493, March 2015, | DOI 10.17487/RFC7493, March 2015, | |||
| <https://www.rfc-editor.org/info/rfc7493>. | <https://www.rfc-editor.org/info/rfc7493>. | |||
| Acknowledgements | Acknowledgements | |||
| Ari Keränen proposed to use the version number as a bitmap and | Ari Keränen proposed to use the version number as a bitmap and | |||
| provided further input on this specification. Jaime Jiménez helped | provided further input on this specification. Jaime Jiménez helped | |||
| clarify the document by providing a review. Elwyn Davies provided a | clarify the document by providing a review and acted as Document | |||
| detailed GENART review with directly implementable text suggestions | Shepherd. Elwyn Davies provided a detailed GENART review with | |||
| that now form part of this specification. Rob Wilton supplied | directly implementable text suggestions that now form part of this | |||
| comments, one of which became the last paragraph of Section 2.1; Éric | specification. Rob Wilton supplied comments, one of which became the | |||
| Vyncke helped with Section 2. Additional thanks go to the other IESG | last paragraph of Section 2.1; Éric Vyncke helped with Section 2. | |||
| reviewers. | Additional thanks go to the other IESG reviewers. | |||
| Author's Address | Author's Address | |||
| Carsten Bormann | Carsten Bormann | |||
| Universität Bremen TZI | Universität Bremen TZI | |||
| Postfach 330440 | Postfach 330440 | |||
| D-28359 Bremen | D-28359 Bremen | |||
| Germany | Germany | |||
| Phone: +49-421-218-63921 | Phone: +49-421-218-63921 | |||
| End of changes. 3 change blocks. | ||||
| 8 lines changed or deleted | 8 lines changed or added | |||
This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ | ||||