XML identifiers: device_id and #var:DeviceName# as values of key/values HBL/HBV 01-25. This particular pair is per default placed in HBL04/HBV04. Please see example (below).
Purpose: The #var:DeviceName# is the replacement parameter replaced during heartbeat with the identity given to the device, per default using the device_id as label. The identity will be transferred to the heartbeat logging server. Note! This is NOT the actual ID of the device, since this can not be read per Apples privacy rules, and must be set using the alternative ID function. So, first transfer an alternative device ID to the device via the configuration, and then read it back (using the #var:DeviceName# replacement parameter).
Status: Currently in use.
Category: Heartbeat keys (labels and value).
Usage: Transfers the device name/id to the logging server. If another label is wanted, for instance DEVNAM, either change the string following the HBK04 key, or add a pair of device_id and #var:DeviceName# as in a spare key/value pair of HBL/HBV 01-25.
Default: Defaults to the pair of HBK04 = device_id, and HBV04 = #var:DeviceName# with the replacement identifier #var:battCharge# being replaced during actual operation with the percentage of remaining battery power.
Development: Stable, with no current plans for change.
Example:
Choosing to use the WAL HeartBeat Configuration Label 24 and Value 24 pair to transfer heartbeats to logging server, informing about charge level, using a custom defined name battery_level label of DEVNAM:
…
<key>HBK25</key>
<string>DEVNAM</string>
…
<key>HBV25</key>
<string>#var:DeviceName#</string>
..
Document Revision: December, 2019. February, 2020. March, 2020. Nov. 2024. Rev. 1.0