Add mysensors notify platform (#1736)

2025-07-19 07:17:14 +00:00 · 2017-01-15 03:53:51 +01:00 · 2017-01-15 03:53:51 +01:00 · c80d9b5e29
commit c80d9b5e29
parent b01f70083a
1 changed files with 100 additions and 0 deletions
--- a/source/_components/notify.mysensors.markdown
+++ b/source/_components/notify.mysensors.markdown
@ -0,0 +1,100 @@
+---
+layout: page
+title: "MySensors Notify"
+description: "Instructions how to integrate MySensors notifications into Home Assistant."
+date: 2017-01-07 15:00 +0100
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: mysensors.png
+ha_category: Notifications
+ha_release: 0.36
+ha_iot_class: "Local Push"
+---
+
+Integrates MySensors notifications into Home Assistant. See the [main component] for configuration instructions.
+
+Setting the `target` key in the service call will target the name of the MySensors device in Home Assistant. MySensors device names follow the notation: "[Sketch name] [Node id] [Child id]".
+
+### {% linkable_title Automation example %}
+
+```yaml
+...
+action:
+  service: notify.mysensors
+  data:
+    message: Welcome home!
+    target: 'TextSensor 254 1'
+```
+
+The following sensor types are supported:
+
+##### MySensors version 2.0 and higher
+
+S_TYPE          | V_TYPE
+----------------|--------------------------
+S_INFO          | V_TEXT
+
+For more information, visit the [api] page of MySensors.
+
+### {% linkable_title Example sketch %}
+
+```cpp
+/*
+ * Documentation: http://www.mysensors.org
+ * Support Forum: http://forum.mysensors.org
+ */
+
+ #define MY_DEBUG
+ #define MY_RADIO_NRF24
+ #define MY_REPEATER_FEATURE
+
+ #include <SPI.h>
+ #include <MySensors.h>
+
+ #define SN "TextSensor"
+ #define SV "1.0"
+ #define CHILD_ID 1
+
+ MyMessage textMsg(CHILD_ID, V_TEXT);
+ bool initialValueSent = false;
+
+ void setup(void) {
+ }
+
+ void presentation() {
+   sendSketchInfo(SN, SV);
+   present(CHILD_ID, S_INFO, "TextSensor1");
+ }
+
+ void loop() {
+   if (!initialValueSent) {
+     Serial.println("Sending initial value");
+     // Send initial values.
+     send(textMsg.set("-"));
+     Serial.println("Requesting initial value from controller");
+     request(CHILD_ID, V_TEXT);
+     wait(2000, C_SET, V_TEXT);
+   }
+ }
+
+ void receive(const MyMessage &message) {
+   if (message.type == V_TEXT) {
+     if (!initialValueSent) {
+       Serial.println("Receiving initial value from controller");
+       initialValueSent = true;
+     }
+     // Dummy print
+     Serial.print("Message: ");
+     Serial.print(message.sensor);
+     Serial.print(", Message: ");
+     Serial.println(message.getString());
+     // Send message to controller
+     send(textMsg.set(message.getString()));
+   }
+ }
+```
+
+[main component]: /components/mysensors/
+[api]: http://www.mysensors.org/download/