Skip to content

Commit

Permalink
Revert trigger_percentile change, update calibration instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
stephenpapierski committed Aug 20, 2024
1 parent 9e50341 commit 2da3be7
Show file tree
Hide file tree
Showing 4 changed files with 13 additions and 13 deletions.
2 changes: 1 addition & 1 deletion bed-presence-mk1.factory.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ packages:
esphome:
project:
name: ElevatedSensors.BedPresenceMk1
version: 2024.8.1
version: 2024.8.0

# Allow ESPHome Adoption
dashboard_import:
Expand Down
6 changes: 3 additions & 3 deletions bed-presence-mk1.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,10 @@ substitutions:
# This controls how the trigger threshold is set during calibration. During calibration, the unoccupied and occupied
# pressure values are determined. This is the percentage of the difference between those values required to trigger
# the "occupied" state.
# - 0.625 Requires 5/8 of the occupied pressure to trigger (Default)
# - 0.75 Requires 75% of the occupied pressure to trigger (Default)
# - 0.50 Set trigger exactly in the middle of unoccupied and occupied pressures
# - 0.375 More sensitive, likely to be triggered by partner
trigger_percentile: '0.625'
# - 0.25 More sensitive, likely to be triggered by partner
trigger_percentile: '0.75'

# Fast Sensor Delay
# This controls how long the "Fast" sensor must register its value before updating. Without any delay, the sensor
Expand Down
15 changes: 9 additions & 6 deletions static/bed-presence-mk1/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,12 +60,15 @@ Welcome to Bed Presence for ESPHome! This page contains everything you need to g

## Automatic Sensor Calibration

1. The calibration process requires you to get into and our of your bed. It records the sensor readings while the bed is both occupied and unoccupied and automatically calculates the best trigger pressure. This process is best performed when the bed has settled in the unoccupied state. For some beds, this is instant. For others, the unoccupied pressure may increase slowly over several hours. NOTE: you can always go back and update the unoccupied pressure at a later time when it's more convenient (e.g. you're at work and the bed has been unoccupied for several hours).
2. Navigate to the device under Home Assistant Devices. Find the `Configuration` section.
3. Press `Calibrate Unoccupied` for the desired side of the bed.
4. Have the person you are calibrating for gently lay on their side of the bed.
5. Let the sensor settle for a few seconds and press `Calibrate Occupied` for the desired side of the bed.
6. The goal of the automatic calibration is to get the value close to optimal. If you find that you are getting false triggers, want to increase/decrease sensitivity, etc, continue to `Manual Sensor Calibration`.
The calibration process requires you to get into and our of your bed. It records the sensor readings while the bed is both occupied and unoccupied and automatically calculates the best trigger pressure.

1. Navigate to the device under Home Assistant Devices. Find the `Configuration` section.
2. Have the person you are calibration for gently lay on their side of the bed.
3. Let the sensor settle for a few seconds and press `Calibrate Occupied` for the desired side of the bed.
4. Get out of bed.
5. Leave the entire bed unoccupied for a couple minutes, then press `Calibrate Unoccupied` for the desired side of the bed.
6. Repeat for other side of bed.
7. The goal of the automatic calibration is to get the value close to optimal. If you find that you are getting false triggers, want to increase/decrease sensitivity, etc, continue to `Manual Sensor Calibration`.

## Manual Sensor Calibration
1. Alternatively, you can manually set the `Trigger Pressure`. Viewing the graph of the sensor pressure can help guide your desired pressure.
Expand Down
3 changes: 0 additions & 3 deletions static/bed-presence-mk1/release.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,3 @@ breadcrumb_list:

## 2024.8.0
- Initial Release

## 2024.8.1
- Update trigger_percentile to 0.625 (5/8)

0 comments on commit 2da3be7

Please sign in to comment.