Skip to content

Commit a16f768

Browse files
committed
Rename auto reporting mode to implementation specific
Closes #136
1 parent 287db1d commit a16f768

File tree

2 files changed

+117
-112
lines changed

2 files changed

+117
-112
lines changed

index.bs

Lines changed: 13 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -436,12 +436,15 @@ or how the sensor is implemented ([=low-level=] sensors).
436436
When [=sensor readings=] are reported at regular intervals,
437437
at an ajustable frequency measured in hertz (Hz),
438438
the [=reporting mode=] is said to be periodic.
439-
When it is only reported upon measurable change,
440-
the [=sensor=] is said to be in auto [=reporting mode=].
441-
442-
[=Auto=] [=reporting mode=] can give the user agent
443-
more latitude to carry out power- or CPU-saving strategies
444-
and should generally be favored.
439+
When there is no specific requirments set on the [=reporting mode=],
440+
the [=reporting mode=] is implementation specific.
441+
442+
In [=implementation specific=] [=reporting mode=],
443+
[=sensor readings=] may be provided at regular intervals, irregularly,
444+
or only when a [=sensor readings|reading=] change is observed.
445+
The [=implementation specific=] [=reporting mode=] allows user agents
446+
more latitude to carry out power- or CPU-saving strategies,
447+
which is why it should generally be favored.
445448
[=Periodic=] [=reporting mode=], on the other hand,
446449
allows a much more fine-grained approach
447450
and is essential for use cases with, for example,
@@ -452,7 +455,7 @@ but related to,
452455
[=sensor readings=] acquisition.
453456
If [=sensors=] are polled at regular interval,
454457
as is generally the case,
455-
[=reporting mode=] can be either [=periodic=] or [=auto=].
458+
[=reporting mode=] can be either [=periodic=] or [=implementation specific=].
456459
However, when the underlying implementation itself only provides [=sensor readings=]
457460
when it measures change,
458461
perhaps because is is relying on [=smart sensors=] or a [=sensor hubs=],
@@ -477,7 +480,7 @@ A [=sensor type=] may have a default sensor.
477480

478481
A [=sensor type=] has an associated set of supported reporting modes,
479482
which cannot be empty and must be picked from the following:
480-
[=auto=] and [=periodic=].
483+
[=implementation specific=] and [=periodic=].
481484

482485
If a [=sensor type=] has more than one [=sensor=],
483486
it must have a set of associated identifying parameters
@@ -812,7 +815,7 @@ Abstract Operations {#abstract-operations}
812815
Note: there is not guarantee that the [=current polling frequency=]
813816
can be respected. The actual [=frequency=] can be calculated using
814817
{{SensorReading}} {{SensorReading/timeStamp!!attribute}} attributes.
815-
1. If the [=current reporting mode=] is set to [=auto=],
818+
1. If the [=current reporting mode=] is set to [=implementation specific=],
816819
1. the user-agent can decide on the best reporting strategy
817820
for this particular |sensor| and [=sensor type=].
818821
1. The user-agent must invoke the [=Update Current Reading=] abstract operation
@@ -830,7 +833,7 @@ Abstract Operations {#abstract-operations}
830833
: output
831834
:: |mode|, a [=reporting mode=].
832835

833-
1. let |mode| be [=auto=].
836+
1. let |mode| be [=implementation specific=].
834837
1. For each |sensor_instance| in |sensor|'s set of [=activated Sensor objects=]:
835838
1. if |sensor_instance|'s [=frequency=] is not `null`,
836839
1. set |mode| to [=periodic=]

0 commit comments

Comments
 (0)