switch: Add sample usage for mobile push notifications

Enabling CONFIG_EXAMPLE_ENABLE_TEST_NOTIFICATIONS for the switch example will
enable the test mobile notifications on push button events. Turning the switch
on would report a parameter notification like {"Switch":{"Power":true}} and
turning off would report an alert "Switch was turned off".

Note that push notifications should be used only when users need to be specifically
alerted about some event even when the app is in background, not otherwise.

Author: shahpiyushv

components/esp_rainmaker/src/core/esp_rmaker_internal.h

@@ -101,7 +101,6 @@ esp_err_t esp_rmaker_report_node_state(void);
 _esp_rmaker_device_t *esp_rmaker_node_get_first_device(const esp_rmaker_node_t *node);
 esp_rmaker_attr_t *esp_rmaker_node_get_first_attribute(const esp_rmaker_node_t *node);
 esp_err_t esp_rmaker_params_mqtt_init(void);
-esp_err_t esp_rmaker_report_param_internal(void);
 esp_err_t esp_rmaker_param_get_stored_value(_esp_rmaker_param_t *param, esp_rmaker_param_val_t *val);
 esp_err_t esp_rmaker_param_store_value(_esp_rmaker_param_t *param);
 esp_err_t esp_rmaker_node_delete(const esp_rmaker_node_t *node);

examples/switch/main/Kconfig.projbuild

@@ -8,4 +8,12 @@ menu "Example Configuration"
             GPIO number on which the "Boot" button is connected. This is generally used
             by the application for custom operations like toggling states, resetting to defaults, etc.
 
+    config EXAMPLE_ENABLE_TEST_NOTIFICATIONS
+        bool "Test Notifications"
+        default n
+        help
+            Enable this option to test mobile push notifications. When enabled, turning on the switch using
+            push button will trigger a parameter notification {"Switch":{"Power":true}} and turning off will
+            trigger an alert "Switch was turned off".
+
 endmenu

examples/switch/main/app_driver.c

@@ -51,9 +51,27 @@ static void push_btn_cb(void *arg)
 {
     bool new_state = !g_power_state;
     app_driver_set_state(new_state);
+#ifdef CONFIG_EXAMPLE_ENABLE_TEST_NOTIFICATIONS
+    /* This snippet has been added just to demonstrate how the APIs esp_rmaker_param_update_and_notify()
+     * and esp_rmaker_raise_alert() can be used to trigger push notifications on the phone apps.
+     * Normally, there should not be a need to use these APIs for such simple operations. Please check
+     * API documentation for details.
+     */
+    if (new_state) {
+        esp_rmaker_param_update_and_notify(
+                esp_rmaker_device_get_param_by_name(switch_device, ESP_RMAKER_DEF_POWER_NAME),
+                esp_rmaker_bool(new_state));
+    } else {
+        esp_rmaker_param_update_and_report(
+                esp_rmaker_device_get_param_by_name(switch_device, ESP_RMAKER_DEF_POWER_NAME),
+                esp_rmaker_bool(new_state));
+        esp_rmaker_raise_alert("Switch was turned off");
+    }
+#else
     esp_rmaker_param_update_and_report(
             esp_rmaker_device_get_param_by_name(switch_device, ESP_RMAKER_DEF_POWER_NAME),
             esp_rmaker_bool(new_state));
+#endif
 }
 
 static void set_power_state(bool target)