Skip to content

Commit

Permalink
Update sensor details for recent changes
Browse files Browse the repository at this point in the history
  • Loading branch information
@stephenpapierski
stephenpapierski committed Aug 23, 2024
1 parent a36e3d1 commit b8a3a9d
Showing 1 changed file with 17 additions and 15 deletions.
32 changes: 17 additions & 15 deletions static/bed-presence-mk1/sensors.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -9,27 +9,29 @@ breadcrumb_list:
url: /bed-presence-mk1
---

Learn about the details of each sensor and what they mean. Each side of the bed (Right/Left) has the following sensors, values, and calibration methods.
Learn about the details of each sensor and what they mean.

## Sensors

| Sensor Name | Type | Values | Details |
|---------------------------|---------------------|----------------|---------------------------------------------|
| `Bed Occupied` | Binary (Occupancy) | Detected/Clear | The primary sensor that indicates whether this side of the bed is occupied (**Detected**) or not (**Clear**). This sensor is slightly delayed to ensure stability and should be sufficient for most automations.|
| `Bed Occupied (Fast)` | Binary (Occupancy) | Detected/Clear | Like `Bed Occupied`, this sensor indicates whether this side of the bed is occupied or not. However, this sensor has less of a delay. If you need quick response when getting into or out of bed, and can tolerate an increased chance of false negatives, use this sensor. This sensor must be manually enabled in the Home Assistant UI.|
| `Pressure (Current)` | Number (Pressure %) | 0% -> 100% | Indicates the current pressure reading. This value ranges from 0% to 100%, indicating the full range of the sensor. Do not worry if your unoccupied pressure reading is not 0%, or even if both sides of the bed are not similar. Some beds may swing from 0% (Unoccupied) to 95% (Occupied), while others may start at 70% and only increase to 75%. The important thing is that there is a measureable difference between the bed being occupied and unoccupied.|
| Sensor Name | Type | Details |
|-----------------------------|---------------------------------------|---------------------------------------------|
| `Bed Occupied [Right/Left]` | Binary (Occupancy) [Detected/Clear] | The primary sensor that indicates whether this side of the bed is occupied (**Detected**) or not (**Clear**). This sensor is slightly delayed to ensure stability and should be sufficient for most automations. |
| `Bed Occupied Both` | Binary (Occupancy) [Detected/Clear] | Indicates if **Both** sides of the bed are occupied or not. |
| `Bed Occupied Either` | Binary (Occupancy) [Detected/Clear] | Indicates if **Either** side of the bed is occupied or not. |
| `(Fast) Sensors` | Binary (Occupancy) [Detected/Clear] | A copy of the primary occupancy sensors (Right/Left/Both/Either), with less delay. If you need quick response when getting into or out of bed, and can tolerate an increased chance of false negatives, use this sensor. `These sensors are disabled by default and must be manually enabled in the Home Assistant UI.` |
| `Pressure [Right/Left]` | Number (Pressure %) [0% -> 100%] | Indicates the current pressure reading. This value ranges from 0% to 100%, indicating the full range of the sensor. Do not worry if your unoccupied pressure reading is not 0%, or even if both sides of the bed are not similar. Some beds may swing from 0% (Unoccupied) to 95% (Occupied), while others may start at 70% and only increase to 75%. The important thing is that there is a measureable difference between the bed being occupied and unoccupied. |

## Values

| Value Name | Type | Values | Details |
|---------------------------|---------------------|----------------|---------------------------------------------|
| `Trigger Pressure` | Number (Pressure %) | 0% -> 100% | When `Pressure (Current)` is above this value, `Bed Occupied` will register **Detected**. The calibration process will set this value, but it can also be adjusted manually.|
| `Unoccupied Pressure` | Number (Pressure %) | 0% -> 100% | Indicates the sensor value when the bed is unoccupied. Used for calculating the ideal `Trigger Pressure`. The calibration process will set this value, but it can also be adjust manually. Note: this should indicate the highest possible value observed when the bed is unoccupied.|
| `Occupied Pressure` | Number (Pressure %) | 0% -> 100% | Indicates the sensor value when the bed is occupied. Used for calculating the ideal `Trigger Pressure`. The calibration process will set this value, but it can also be adjusted manually.|
| Value Name | Type | Values | Details |
|------------------------------------|---------------------|-----------------|---------------------------------------------|
| `[Right/Left] Trigger Pressure` | Number (Pressure %) [0% -> 100%] | When `[Right/Left] Pressure` is above this value, `[Right/Left] Bed Occupied` will register **Detected**. The calibration process will set this value, but it can also be adjusted manually. |
| `[Right/Left] Unoccupied Pressure` | Number (Pressure %) [0% -> 100%] | Indicates the sensor value when the bed is unoccupied. Used for calculating the ideal `[Right/Left] Trigger Pressure`. The calibration process will set this value, but it can also be adjust manually. |
| `[Right/Left] Occupied Pressure` | Number (Pressure %) [0% -> 100%] | Indicates the sensor value when the bed is occupied. Used for calculating the ideal `[Right/Left] Trigger Pressure`. The calibration process will set this value, but it can also be adjusted manually. |

## Calibration

| Method Name | Details |
|---------------------------|---------------------------------------------|
| `Calibrate Unoccupied` | Sets the `Unoccupied Pressure` using the value from `Pressure (Current)`. This should be done (or redone) once the bed has been unoccupied for an extended period.|
| `Calibrate Occupied` | Sets the `Occupied Pressure` using the value from `Pressure (Current)`.|
| Method Name | Details |
|-------------------------------------|---------------------------------------------|
| `Calibrate [Right/Left] Unoccupied` | Sets the `[Right/Left] Unoccupied Pressure` using the value from `[Right/Left] Pressure`. |
| `Calibrate [Right/Left] Occupied` | Sets the `[Right/Left] Occupied Pressure` using the value from `[Right/Left] Pressure`. |

0 comments on commit b8a3a9d

Please sign in to comment.