Skip to content

Commit cd8b487

Browse files
committed
More information on device vitals
- ch76830
1 parent f5ad0ad commit cd8b487

File tree

1 file changed

+11
-1
lines changed

1 file changed

+11
-1
lines changed

src/content/reference/device-os/firmware.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -767,11 +767,21 @@ You can also specify a value using [chrono literals](#chrono-literals), for exam
767767

768768
Sending device vitals does not consume Data Operations from your monthly or yearly quota. However, for cellular devices they do use cellular data, so unnecessary vitals transmission can lead to increased data usage, which could result in hitting the monthly data limit for your account.
769769

770-
771770
>_**NOTE:** Diagnostic messages can be viewed in the [Console](https://console.particle.io/devices). Select the device in question, and view the messages under the "EVENTS" tab._
772771

773772
<div style="margin-left:35px;"><img src="/assets/images/diagnostic-events.png"/></div>
774773

774+
Device vitals are sent:
775+
776+
- On handshake (at most every three days, but can be more frequent if waking from some sleep modes)
777+
- Before an OTA firmware flash if last vitals were sent more than 5 minutes ago
778+
- Under user control from device firmware when using `Particle.publishVitals()`
779+
- From the cloud side (API or console) when requested
780+
781+
The actual device vitals are communicated to the cloud in a concise binary CoAP payload. The large JSON event you see in the event stream is a synthetic event. It looks like it's coming from the device but that format is not transmitted over the network connection.
782+
783+
It is not possible to disable the device vitals messages, however they do not count as a data operation.
784+
775785
### Particle.connect()
776786

777787
`Particle.connect()` connects the device to the Cloud. This will automatically activate the {{network-type}} connection and attempt to connect to the Particle cloud if the device is not already connected to the cloud.

0 commit comments

Comments
 (0)