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/