Update SEN5x library - no functional change

lib/lib_i2c/arduino-i2c-sen5x/.clang-format

@@ -0,0 +1,14 @@
+---
+Language: Cpp
+BasedOnStyle: LLVM
+IndentWidth: 4
+AlignAfterOpenBracket: Align
+AllowShortBlocksOnASingleLine: false
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: false
+IndentCaseLabels: true
+SpacesBeforeTrailingComments: 2
+PointerAlignment: Left
+AlignEscapedNewlines: Left
+ForEachMacros: ['TEST_GROUP', 'TEST']
+...

lib/lib_i2c/arduino-i2c-sen5x/.gitignore

@@ -0,0 +1,70 @@
+app/bin/
+app/pde.jar
+build/macosx/work/
+arduino-core/bin/
+arduino-core/arduino-core.jar
+hardware/arduino/bootloaders/caterina_LUFA/Descriptors.o
+hardware/arduino/bootloaders/caterina_LUFA/Descriptors.lst
+hardware/arduino/bootloaders/caterina_LUFA/Caterina.sym
+hardware/arduino/bootloaders/caterina_LUFA/Caterina.o
+hardware/arduino/bootloaders/caterina_LUFA/Caterina.map
+hardware/arduino/bootloaders/caterina_LUFA/Caterina.lst
+hardware/arduino/bootloaders/caterina_LUFA/Caterina.lss
+hardware/arduino/bootloaders/caterina_LUFA/Caterina.elf
+hardware/arduino/bootloaders/caterina_LUFA/Caterina.eep
+hardware/arduino/bootloaders/caterina_LUFA/.dep/
+build/*.zip
+build/*.tar.bz2
+build/windows/work/
+build/windows/*.zip
+build/windows/*.tgz
+build/windows/*.tar.bz2
+build/windows/libastylej*
+build/windows/liblistSerials*
+build/windows/arduino-*.zip
+build/windows/dist/*.tar.gz
+build/windows/dist/*.tar.bz2
+build/windows/launch4j-*.tgz
+build/windows/launch4j-*.zip
+build/windows/launcher/launch4j
+build/windows/WinAVR-*.zip
+build/macosx/arduino-*.zip
+build/macosx/dist/*.tar.gz
+build/macosx/dist/*.tar.bz2
+build/macosx/*.tar.bz2
+build/macosx/libastylej*
+build/macosx/appbundler*.jar
+build/macosx/appbundler*.zip
+build/macosx/appbundler
+build/macosx/appbundler-1.0ea-arduino?
+build/macosx/appbundler-1.0ea-arduino*.zip
+build/macosx/appbundler-1.0ea-upstream*.zip
+build/linux/work/
+build/linux/dist/*.tar.gz
+build/linux/dist/*.tar.bz2
+build/linux/*.tgz
+build/linux/*.tar.xz
+build/linux/*.tar.bz2
+build/linux/*.zip
+build/linux/libastylej*
+build/linux/liblistSerials*
+build/shared/arduino-examples*
+build/shared/reference*.zip
+build/shared/Edison*.zip
+build/shared/Galileo*.zip
+build/shared/WiFi101-Updater-ArduinoIDE-Plugin*.zip
+test-bin
+*.iml
+.idea
+.DS_Store
+.directory
+hardware/arduino/avr/libraries/Bridge/examples/XivelyClient/passwords.h
+avr-toolchain-*.zip
+/app/nbproject/private/
+/arduino-core/nbproject/private/
+/app/build/
+/arduino-core/build/
+
+manifest.mf
+nbbuild.xml
+nbproject

lib/lib_i2c/arduino-i2c-sen5x/CHANGELOG.md

@@ -6,6 +6,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2023-01-19
+
+Fix scaling of typicalParticleSize for readMeasuredPmValues
+Fix comments for readMeasuredPmValuesAsIntegers
 
 ## [0.2.0] - 2022-03-30
 
@@ -15,6 +19,7 @@ Add support for SEN50
 
 Initial release
 
+[0.3.0]: https://github.com/Sensirion/embedded-i2c-sen5x/compare/0.2.0...0.3.0
 [0.2.0]: https://github.com/Sensirion/embedded-i2c-sen5x/compare/0.1.0...0.2.0
 [0.1.0]: https://github.com/Sensirion/arduino-i2c-sen5x/releases/tag/0.1.0
 

lib/lib_i2c/arduino-i2c-sen5x/README.md

@@ -1,5 +1,3 @@
-<!-- Downloaded from https://github.com/Sensirion/arduino-i2c-sen5x
-on 10/01/2023 at commit d7a73c86073cca34b84cde83814f5c17b87aad6d -->
 # Sensirion I2C SEN5X Arduino Library
 
 This is the Sensirion SEN5X library for Arduino using the

lib/lib_i2c/arduino-i2c-sen5x/library.properties

@@ -1,5 +1,5 @@
 name=Sensirion I2C SEN5X
-version=0.2.0
+version=0.3.0
 author=Sensirion
 maintainer=Sensirion
 sentence=Library for the SEN5X sensor family by Sensirion

lib/lib_i2c/arduino-i2c-sen5x/src/SensirionI2CSen5x.h

@@ -50,7 +50,7 @@ class SensirionI2CSen5x {
     /**
      * begin() - Initializes the SensirionI2CSen5x class.
      *
-     * @param serial Arduino stream object to be communicated with.
+     * @param i2cBus Arduino stream object to use for communication.
      *
      */
     void begin(TwoWire& i2cBus);
@@ -62,8 +62,11 @@ class SensirionI2CSen5x {
      * measurement results are available. You could poll with the command
      * 0x0202 \"Read Data Ready\" to check when the results are ready to read.
      *
-     * This command is only available in idle mode. If the device is already
-     * in any measure mode, this command has no effect.
+     * If the device is in measure mode without particulate matter (low-power)
+     * and the firmware version is at least 2.0, this command enables PM
+     * measurement without affecting the already running RH/T/VOC/NOx
+     * measurements (except that the \"data ready\"-flag will be cleared). In
+     * previous firmware versions, this command is supported only in idle mode.
      *
      * @return 0 on success, an error code otherwise
      */
@@ -78,8 +81,11 @@ class SensirionI2CSen5x {
      * measurement results are available. You could poll with the command
      * 0x0202 \"Read Data Ready\" to check when the results are ready to read.
      *
-     * This command is only available in idle mode. If the device is already
-     * in any measure mode, this command has no effect.
+     * If the device is in measure mode with particulate matter (normal measure
+     * mode) and the firmware version is at least 2.0, this command disables PM
+     * measurement without affecting the already running RH/T/VOC/NOx
+     * measurements (except that the \"data ready\"-flag will be cleared). In
+     * previous firmware versions, this command is supported only in idle mode.
      *
      * Supported sensors: SEN54, SEN55
      *
@@ -238,8 +244,8 @@ class SensirionI2CSen5x {
      *
      * @param rawNox Raw measured NOx ticks without scale factor.
      * Note: If this value is unknown, which is the case for SEN54,
-     * 0x7FFF is returned. During the first 10..11 seconds after power-on
-     * or device reset, this value will be 0x7FFF as well.*
+     * 0xFFFF is returned. During the first 10..11 seconds after power-on
+     * or device reset, this value will be 0xFFFF as well.*
      *
      * @return 0 on success, an error code otherwise
      */
@@ -334,35 +340,35 @@ class SensirionI2CSen5x {
      * second), all values will be 0xFFFF.
      *
      * @param massConcentrationPm1p0 Value is scaled with factor 10:
-     *                               PM1.0 [µg/m³] = value / 1
+     *                               PM1.0 [µg/m³] = value / 10
      * Note: If this value is unknown, 0xFFFF is returned.*
      *
      * @param massConcentrationPm2p5 Value is scaled with factor 10:
-     *                               PM2.5 [µg/m³] = value / 1
+     *                               PM2.5 [µg/m³] = value / 10
      * Note: If this value is unknown, 0xFFFF is returned.*
      *
      * @param massConcentrationPm4p0 Value is scaled with factor 10:
-     *                               PM4.0 [µg/m³] = value / 1
+     *                               PM4.0 [µg/m³] = value / 10
      * Note: If this value is unknown, 0xFFFF is returned.*
      *
      * @param massConcentrationPm10p0 Value is scaled with factor 10:
-     *                                PM10.0 [µg/m³] = value / 1
+     *                                PM10.0 [µg/m³] = value / 10
      * Note: If this value is unknown, 0xFFFF is returned.*
      *
      * @param numberConcentrationPm0p5 Value is scaled with factor 10:
-     *                                 PM0.5 [#/cm³] = value / 1
+     *                                 PM0.5 [#/cm³] = value / 10
      * Note: If this value is unknown, 0xFFFF is returned.*
      *
      * @param numberConcentrationPm1p0 Value is scaled with factor 10:
-     *                                 PM1.0 [#/cm³] = value / 1
+     *                                 PM1.0 [#/cm³] = value / 10
      * Note: If this value is unknown, 0xFFFF is returned.*
      *
      * @param numberConcentrationPm2p5 Value is scaled with factor 10:
-     *                                 PM2.5 [#/cm³] = value / 1
+     *                                 PM2.5 [#/cm³] = value / 10
      * Note: If this value is unknown, 0xFFFF is returned.*
      *
      * @param numberConcentrationPm4p0 Value is scaled with factor 10:
-     *                                 PM4.0 [#/cm³] = value / 1
+     *                                 PM4.0 [#/cm³] = value / 10
      * Note: If this value is unknown, 0xFFFF is returned.*
      *
      * @param numberConcentrationPm10p0 Value is scaled with factor 10: