Heartbeats section added (home-assistant#1730)

brahmafear · MartinHjelmare · commit f45e9829a43d · 2017-01-07T15:48:42.000+01:00
* Heartbeats section added

Added basic documentation of smartSleep functionality within HA based on receiving a heartbeat signal form MySensor node.

* Heartbeat info clarified.

Heartbeat section updated based on comments.

* MyS library api link updated

Single link to access all versions of MySensors code and API reference.
diff --git a/source/_components/mysensors.markdown b/source/_components/mysensors.markdown
@@ -171,6 +171,11 @@ void receive(const MyMessage &message) {
 }
 ```
 
+### {% linkable_title Heartbeats %}
+
+Sending a heartbeat from the MySensors device to Home Assistant activates the SmartSleep functionality in Home Assistant. This means that messages are buffered and only sent to the device upon receiving a heartbeat from the device. State changes are stored so that only the last requested state change is sent to the device. Other types of messages are queued in a FIFO queue. SmartSleep is useful for battery powered actuators that are waiting for commands.  See the MySensors library API for information on how to send heartbeats and sleep device.  
+
+
 Visit the [library api] of MySensors for more information.
 
-[library api]: https://www.mysensors.org/download/sensor_api_15
+[MySensors library api]: http://www.mysensors.org/download
