WeatherSensor: add ability to link devices outside current bridge

common/info.yaml

@@ -1621,3 +1621,37 @@ description: |
   - **StartDownLightDimmer()**: The counterpart to *StartUpLightDimmer*
   - **StartIncreasingBrightness()**: Similar to StartDimmer, but doesn't cycle and only increases brightness.
   - **StartDecreasingBrightness()**: Similar to StartDimmer, but doesn't cycle and only decreases brightness.
+
+  ## Battery
+
+  The Battery feature is used to report the battery level of a device.
+
+  ### Properties
+
+  (none)
+
+  ### State Variables
+
+   - **battery**: (integer) value from 0 to 100, representing the battery level in percent.
+     Clients are encouraged to use the following rendering on their UIs:
+     100 = full (green or blue), 31--99 = OK (green), 11--30 = low (Yellow), 1--10 = critical (red), and 0 = empty (red or blank).
+
+  ### Actions
+
+  (none)
+
+  ## Signal
+
+  The Signal feature indicates the quality of the RF communication between the Bond Bridge and the device.
+  Depending on the device technology, it may indicate either just the downlink or
+  an aggregate of the uplink and downlink link quality.
+
+  ### Properties
+
+  (none)
+
+  ### State Variables
+
+   - **signal**: (integer) value from 0 to 100, representing the signal quality in percent.
+     Clients should render this as a 4-bar signal strength indicator, where:
+     0--20 = no bars, 21--40 = 1 bar, 41--60 = 2 bars, 61--80 = 3 bars, 81--100 = 4 bars.

weather_sensor/schemas.yaml

@@ -23,8 +23,7 @@ WeatherSensor:
       type: object
       description: |
         Object describes every link between weather events from this Weather Sensor and the
-        device, group, and scene actions which they trigger.
-        (In future will permit specifying `group` or `scene` instead of `device`.)
+        device actions to be taken in response to those events.
 
         Each weather event maps to an event number:
           - `1` = Wind event: triggered when wind speed reaches configured level
@@ -36,6 +35,12 @@ WeatherSensor:
           - `device`: which device will act in response to the weather event
           - `action`: action to call on device
           - `argument`: (optional) argument to above action, such as position percentage
+
+        [As of v4.8] You may now link to devices that are elsewhere in the network.
+        To do so, prefix the device ID with the bond ID and a colon, like so: `<bond_id>:<device_id>`.
+        The other device may even be a Smart by Bond device, as long as it also has firmware v4.8 or later.
+        This does have the consequence that if a device moves from one Bridge to another using Backup & Restore feature,
+        you will need to re-link it with the weather sensor.
     signal:
       readOnly: true
       example: 97