Tighten frequency.type docs and document budget attribute

Drop the speculative even/odd type values that aren't verified against
the B-hyve API, list interval alongside days (which the user's payload
confirms), and add the program budget attribute to the Program Switch
attributes table.

Author: sebr

README.md

@@ -164,8 +164,10 @@ A **program** `switch` entity is created for each program attached to each zone.
 | `is_smart_program`     | `boolean`      | True if this is a _Smart Watering_ program.                       |
 | `start_times`          | `string`       | Configured start time for the program.<sup>†</sup>                |
 | `frequency`            | `object`       | Watering schedule configuration.<sup>†</sup>                      |
-| `frequency.type`       | `string`       | Type of configuration. `days` is the only known value.            |
-| `frequency.days`       | `list[int]`    | Configured days for watering. `0` is Sunday, `1` is Monday etc... |
+| `frequency.type`       | `string`       | Type of schedule. Known values: `days`, `interval`.               |
+| `frequency.days`       | `list[int]`    | Configured days for watering (when `type` is `days`). `0` is Sunday, `1` is Monday etc... |
+| `frequency.interval`   | `int`          | Number of days between watering (when `type` is `interval`).      |
+| `budget`               | `int`          | Watering budget as a percentage. Scales each zone's run time.<sup>†</sup> |
 | `run_times`            | `list[object]` | Configured watering run times.<sup>†</sup>                        |
 | `run_times[].run_time` | `int`          | Minutes of watering.                                              |
 | `run_times[].station`  | `int`          | Zone id to water.                                                 |
@@ -185,7 +187,7 @@ This integration provides the following services:
 | `bhyve.set_manual_preset_runtime` | `entity_id` - zone(s) entity to set the preset runtime. This should be a reference to a zone switch entity <br/> `minutes` - number of minutes to water for | Set the default time a switch is activated for when enabled. Support for this service appears to be patchy, and it has been difficult to identify the devices or under which conditions it works      |
 | `bhyve.set_smart_watering_soil_moisture` | `entity_id` - zone(s) entity to set the moisture level for. This should be a reference to a zone switch entity <br/> `percentage` - soil moisture level between 0 - 100 | Set Smart Watering soil moisture level for a zone     |
 | `bhyve.start_program` | `entity_id` - program entity to start. This should be a reference to a program switch entity | Starts a pre-configured watering program. Watering programs cannot be created via this integration and must first be set up in the B-Hyve app |
-| `bhyve.update_program` | `entity_id` - program switch to update <br/> `start_times` - _(optional)_ list of watering start times in `HH:MM` format <br/> `frequency` - _(optional)_ frequency configuration object (must include a `type`, e.g. `days`, `interval`, `even`, `odd`) <br/> `budget` - _(optional)_ watering budget as a percentage (0-200) | Update the configuration of an existing non-smart program. At least one of `start_times`, `frequency` or `budget` must be provided |
+| `bhyve.update_program` | `entity_id` - program switch to update <br/> `start_times` - _(optional)_ list of watering start times in `HH:MM` format <br/> `frequency` - _(optional)_ frequency configuration object (must include a `type`, known values: `days`, `interval`) <br/> `budget` - _(optional)_ watering budget as a percentage (0-200) | Update the configuration of an existing non-smart program. At least one of `start_times`, `frequency` or `budget` must be provided |
 
 ### `bhyve.update_program` example
 
@@ -204,11 +206,10 @@ data:
   budget: 75
 ```
 
-The `frequency` object mirrors the B-Hyve API structure. Common `type` values:
+The `frequency` object mirrors the B-Hyve API structure. Known `type` values:
 
-- `days` with `days: [0-6]` (where 0 is Sunday) to water on specific weekdays
+- `days` with `days: [0-6]` (where `0` is Sunday, `1` is Monday etc.) to water on specific weekdays
 - `interval` with `interval: N` to water every N days
-- `even` / `odd` to water on even or odd calendar days
 
 The `budget` is a percentage that scales each zone's run time. `100` means unchanged, `50` halves every run time, `200` doubles it. Valid range is 0&ndash;200.
 

custom_components/bhyve/services.yaml

@@ -69,7 +69,7 @@ update_program:
       description: List of watering start times in HH:MM format
       example: '["06:00", "18:00"]'
     frequency:
-      description: Frequency configuration. `type` is required (e.g. days, interval, even, odd)
+      description: Frequency configuration. `type` is required (known values: days, interval)
       example: '{"type": "days", "days": [1, 3, 5], "interval": 1, "interval_hours": 0}'
     budget:
       description: Watering budget as a percentage (0-200). Scales run times up or down

custom_components/bhyve/strings.json

@@ -148,7 +148,7 @@
         },
         "frequency": {
           "name": "Frequency",
-          "description": "Frequency configuration object. Must include a 'type' key (e.g. days, interval, even, odd)"
+          "description": "Frequency configuration object. Must include a 'type' key (known values: days, interval)"
         },
         "budget": {
           "name": "Budget",

custom_components/bhyve/translations/en.json

@@ -148,7 +148,7 @@
         },
         "frequency": {
           "name": "Frequency",
-          "description": "Frequency configuration object. Must include a 'type' key (e.g. days, interval, even, odd)"
+          "description": "Frequency configuration object. Must include a 'type' key (known values: days, interval)"
         },
         "budget": {
           "name": "Budget",