Skip to content

Commit d17fbda

Browse files
author
ietf-corpus-bot
committed
auto-ingest: ietf-elements backfill — 187 new elements (2026-07-06)
1 parent c9dc24e commit d17fbda

187 files changed

Lines changed: 1715 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
document: rfc-8798
2+
kind: design-rationale
3+
summary: Joule per meter (J/m) and its scaled derivative Wh/km are registered to describe energy expended for achieving motion over a given distance, serving as an equivalent of inverse mileage for electric vehicles. This is not a traditional electromagnetic unit but fills a practical need.
4+
section: "2.1"
5+
extracted_by: claude-sonnet-4-6
6+
extracted_at: "2026-07-06"
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
document: rfc-8798
2+
kind: design-rationale
3+
summary: Secondary units are placed in a separate subregistry rather than the main SenML Units registry because they are derived by linear transformation from existing primary units. This separation preserves the direct-comparison property of primary units while still providing a standardized mapping for convenience units like ms, kW, and km/h.
4+
section: "3"
5+
extracted_by: claude-sonnet-4-6
6+
extracted_at: "2026-07-06"
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
document: rfc-8798
2+
kind: design-rationale
3+
summary: SenML normally requires unscaled SI units (following the Celsius/Kelvin precedent), but this document extends that exception to volt-ampere (VA), volt-ampere reactive (var), joule per meter (J/m), kilogram per cubic meter (kg/m3), and degree (deg) because these are in wide use across SDOs and engineering practice.
4+
section: "2.1"
5+
extracted_by: claude-sonnet-4-6
6+
extracted_at: "2026-07-06"
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
document: rfc-8798
2+
kind: design-rationale
3+
summary: The percent symbol '%' is not used as the secondary unit name for percent (1/100 of unity); instead '/100' is registered. The name '%' was already taken in RFC 8428 as a NOT RECOMMENDED synonym for '/' (unity) for legacy reasons, and using it with a different meaning would create confusion.
4+
section: "3"
5+
extracted_by: claude-sonnet-4-6
6+
extracted_at: "2026-07-06"
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
document: rfc-8798
2+
kind: design-rationale
3+
summary: The symbol B is registered for Byte despite B being taken in SI for bel, because RFC 8428 already registered dB for logarithmic relative power, leaving B free. The octet symbol 'o' is in wide use only in French-speaking countries, while B is globally dominant in engineering circles.
4+
section: "2.1"
5+
extracted_by: claude-sonnet-4-6
6+
extracted_at: "2026-07-06"
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
document: rfc-8798
2+
kind: design-rationale
3+
summary: The unit 'var' (volt-ampere reactive) is registered as a separate primary unit from VA because there is strong interest in using it specifically for the imaginary content of complex power (reactive power) per IEEE 1459, making the distinction between apparent and reactive power explicit in the unit symbol.
4+
section: "2.1"
5+
extracted_by: claude-sonnet-4-6
6+
extracted_at: "2026-07-06"
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
document: rfc-8798
2+
kind: interoperability-note
3+
summary: Secondary units cannot be used directly in SenML version 10 'u' fields; their use requires either a must-understand field (label ending in '_') or a new SenML version indicator that explicitly permits secondary units, as defined outside the scope of RFC 8798.
4+
section: "3"
5+
extracted_by: claude-sonnet-4-6
6+
extracted_at: "2026-07-06"
Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
document: rfc-8798
2+
kind: normative-requirement
3+
summary: As of SenML version 10 (RFC 8428), SenML packs are limited to using primary units in 'u' fields. The use of primary units enables direct comparison of measurements from different sources and simplifies implementations that trigger on the presence of a quantity in a certain unit.
4+
section: "3"
5+
rfc2119_level: MUST
6+
extracted_by: claude-sonnet-4-6
7+
extracted_at: "2026-07-06"
Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
document: rfc-8798
2+
kind: normative-requirement
3+
summary: Instead of pulling the IANA registry in each individual instance of the code, the software update mechanism (or a similar mechanism leading to less frequent IANA visits) SHOULD be used to disseminate updated units registries obtained from IANA towards the instances via common repositories, to avoid high load at IANA and a potential single point of failure.
4+
section: "4"
5+
rfc2119_level: SHOULD
6+
extracted_by: claude-sonnet-4-6
7+
extracted_at: "2026-07-06"
Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
document: rfc-8798
2+
kind: normative-requirement
3+
summary: Where the benefits of directly using a secondary unit in a SenML pack outweigh the above considerations, the use of secondary units in 'u' fields MAY be enabled by indicating a new SenML version that specifically allows this and/or by using a must-understand field (label ending in '_') whose definition specifically allows this.
4+
section: "3"
5+
rfc2119_level: MAY
6+
extracted_by: claude-sonnet-4-6
7+
extracted_at: "2026-07-06"

0 commit comments

Comments
 (0)