esphome-docs icon indicating copy to clipboard operation
esphome-docs copied to clipboard

[sen5x] Extend with SEN6X support esphome

Open mikelawrence opened this issue 5 months ago • 4 comments

Description:

Add support SEN6X sensors. Only the SEN66 is available at this time, but the SEN60, SEN63C, SEN65 and SEN68 are scheduled to be released this year.

Related issue (if applicable): fixes

Pull request in esphome with YAML changes (if applicable):

  • esphome/esphome#9254

Checklist:

  • [ ] I am merging into next because this is new documentation that has a matching pull-request in esphome as linked above.
    or

  • [x] I am merging into current because this is a fix, change and/or adjustment in the current documentation and is not for a new component or feature.

  • [ ] Link added in /components/index.rst when creating new documents for new components or cookbook.

mikelawrence avatar Jun 29 '25 00:06 mikelawrence

Deploy Preview for esphome ready!

Name Link
Latest commit d7531b0badd0b61f24c83776588995e91d8e0af7
Latest deploy log https://app.netlify.com/projects/esphome/deploys/693a5bcdfb10730008dab3ce
Deploy Preview https://deploy-preview-5041--esphome.netlify.app
Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

netlify[bot] avatar Jun 29 '25 00:06 netlify[bot]

It looks like some of the defaults may be different between the SEN5x and SEN6x devices?

In the example SEN66 config it has:

    nox:
      name: "NOx"
      algorithm_tuning:
        index_offset: 100
        ...
        gating_max_duration_minutes: 180

But under the nox description below it says:

  • index_offset (Optional, integer): NOx index representing typical (average) conditions. Allowed values are in range 1..250. The default value is 1. ...
  • gating_max_duration_minutes (Optional, integer): Maximum duration of gating in minutes (freeze of estimator during high NOx index signal). Zero disables the gating. Allowed values are in range 0..3000. The default value is 720 minutes.

Are the defaults different between these two or is the SEN66 intentionally being set to something other than the default? Just wondering about the discrepancy of 1 vs 100 for index_offset and 180 vs 720 for gating_max_duration_minutes.

chilipepperpizza avatar Aug 29 '25 21:08 chilipepperpizza

It looks like some of the defaults may be different between the SEN5x and SEN6x devices?

In the example SEN66 config it has:

    nox:
      name: "NOx"
      algorithm_tuning:
        index_offset: 100
        ...
        gating_max_duration_minutes: 180

But under the nox description below it says:

  • index_offset (Optional, integer): NOx index representing typical (average) conditions. Allowed values are in range 1..250. The default value is 1. ...
  • gating_max_duration_minutes (Optional, integer): Maximum duration of gating in minutes (freeze of estimator during high NOx index signal). Zero disables the gating. Allowed values are in range 0..3000. The default value is 720 minutes.

Are the defaults different between these two or is the SEN66 intentionally being set to something other than the default? Just wondering about the discrepancy of 1 vs 100 for index_offset and 180 vs 720 for gating_max_duration_minutes.

I think I just made a mistake. The latest documentation doesn't even have these shown in the example. I believe the SEN5X and SEN6X sensors have the same defaults. VOC defaults are different from the NOx defaults and that wasn't handled correctly in the original sen5x component. There is another PR that addresses the default issue with VOC and NOx. It was just merged so I'm updating this PR now.

There has been a significant change to the documentation format too. No more reStructuredText (rst) files. Now it is Markdown (md).

mikelawrence avatar Aug 29 '25 22:08 mikelawrence

I have updated the documentation to use the new Markdown structure and changes from PR #5176.

mikelawrence avatar Aug 30 '25 02:08 mikelawrence