0.2.1 ACD10

Author: RobTillaart

libraries/ACD10/ACD10.cpp

@@ -2,7 +2,7 @@
 //    FILE: ACD10.cpp
 //  AUTHOR: Rob Tillaart
 //    DATE: 2023-09-25
-// VERSION: 0.2.0
+// VERSION: 0.2.1
 // PURPOSE: Arduino library for for I2C ACD10 CO2 sensor
 //     URL: https://github.com/RobTillaart/ACD10
 //          http://www.aosong.com/en/products-77.html
@@ -255,7 +255,7 @@ bool ACD10::readFactorySet()
     // Serial.print(__FUNCTION__);
     // Serial.println(": CRC error");
   // }
-  return (buf[1] == 0x01);
+  return ((buf[0] == 0x00) && (buf[1] == 0x01));
 }
 
 

libraries/ACD10/ACD10.h

@@ -3,7 +3,7 @@
 //    FILE: ACD10.h
 //  AUTHOR: Rob Tillaart
 //    DATE: 2023-09-25
-// VERSION: 0.2.0
+// VERSION: 0.2.1
 // PURPOSE: Arduino library for for I2C ACD10 CO2 sensor
 //     URL: https://github.com/RobTillaart/ACD10
 //          http://www.aosong.com/en/products-77.html
@@ -13,7 +13,7 @@
 #include "Wire.h"
 
 
-#define ACD10_LIB_VERSION         (F("0.2.0"))
+#define ACD10_LIB_VERSION         (F("0.2.1"))
 #define ACD10_DEFAULT_ADDRESS     0x2A
 
 //  ERROR CODES

libraries/ACD10/CHANGELOG.md

@@ -6,6 +6,10 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
 
+## [0.2.1] - 2025-02-04
+- update readme.md (some notes about #12 temperature)
+- update **readFactorySet()** return test.
+
 ## [0.2.0] - 2024-06-06
 - fix #9 bitwise and bug
 

libraries/ACD10/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023-2024 Rob Tillaart
+Copyright (c) 2023-2025 Rob Tillaart
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

libraries/ACD10/README.md

@@ -25,15 +25,26 @@ The CO2 concentration supported by the sensor has a range from 400 ~ 5000 ppm ±
 This makes the sensor applicable for outdoor and indoor measurements in
 a normal building setting. 
 The sensor is not suitable for CO2 heavy "industrial" environments. 
+See also datasheet warning below.
 
 **Warning** The temperature range the sensor can measure is **UNKNOWN**
 as there is no documentation how to convert the raw data to meaningful one.
+As far as information could tell this temperature is for Aosong internal use.
+See also #12 (closed issue). 
+If you can decode the temperature bits please let me know.
 
 The sensor can be read over I2C and over Serial.
 This library only support the I2C interface (see hardware notes below).
 
+Feedback as always is welcome.
 
-#### Pre-heat period
+### Datasheet warning
+
+_Do not apply this product to safety protection devices or emergency stop equipment, 
+and any other applications that may cause personal injury due to the product's failure._
+
+
+### Pre-heat period
 
 When the sensor starts up it has a pre-heat period of 120 seconds.
 The library provides functions to check the time since the constructor is called.
@@ -42,33 +53,29 @@ During the preheat period one can make measurements but one should use those
 carefully as these are less accurate than after the preheat period.
 
 
-#### Calibration
+### Calibration
 
 Also important is the calibration of the sensor, although done in the factory,
 a CO2 sensor needs regular calibration. See datasheet for details.
 
 
-#### Power
+### Power
 
 The sensor must be powered with 5V and uses about 225 mW.
 This implies the sensor uses 50 mA (@5V) and needs a separate power supply. 
 One must connect GND from the power supply to the GND of the MCU.
 
 
-#### Datasheet warning
-
-Do not apply this product to safety protection devices or emergency stop equipment, 
-and any other applications that may cause personal injury due to the product's failure.
-
-
-#### Operating conditions
+### Operating conditions
 
-- temperature: 0°C~ +50°C ==> keep away from freezing cold or direct sunlight.
-- humidity: 0% ~ 95% RH ==> non-condensing conditions.
-- Data refresh frequency: 2 seconds
+|  parameter          |  value        |  notes  |
+|:--------------------|:-------------:|:--------|
+|  temperature        |  0°C~ +50°C   |  keep away from freezing cold or direct sunlight.
+|  humidity           |  0% ~ 95% RH  |  keep in non-condensing conditions.
+|  Refresh frequency  |  2 seconds    |
 
 
-#### Hardware
+### Hardware
 
 ```
              TOPVIEW ACD10
@@ -96,7 +103,7 @@ If pin 5 is connected to GND (LOW), Serial / UART mode is selected.
 This latter serial mode is **NOT** supported by this library.
 
 
-#### Related
+### Related
 
 - https://emariete.com/en/sensor-co2-mh-z19b/
 - https://emariete.com/en/sensor-co2-low-consumption-mh-z1311a-winsen/
@@ -108,7 +115,7 @@ This latter serial mode is **NOT** supported by this library.
 - https://github.com/RobTillaart/Cozir
 
 
-#### Tested
+### Tested
 
 TODO: Test on Arduino UNO and ESP32
 
@@ -131,7 +138,7 @@ Every time the power is shut off the pre-heat would run again internally.
 It is unclear what effect this has on the lifetime and quality of the sensor.
 
 
-#### I2C multiplexing
+### I2C multiplexing
 
 Sometimes you need to control more devices than possible with the default
 address range the device provides.
@@ -151,7 +158,7 @@ too if they are behind the multiplexer.
 See example **TCA9548_demo_ACD10.ino**
 
 
-#### I2C Performance
+### I2C Performance
 
 Only test **readSensor()** as that is the main function.
 
@@ -166,7 +173,7 @@ Only test **readSensor()** as that is the main function.
 |   600 KHz  |             |
 
 
-TODO: run performance sketch.
+TODO: run performance sketch on hardware.
 
 
 ## Interface
@@ -175,15 +182,15 @@ TODO: run performance sketch.
 #include "ACD10.h"
 ```
 
-#### Constructor
+### Constructor
 
 - **ACD10(TwoWire \*wire = &Wire)** optional select I2C bus.
 - **bool begin()** checks if device is visible on the I2C bus.
 - **bool isConnected()** Checks if device address can be found on I2C bus.
 - **uint8_t getAddress()** Returns the fixed address 0x2A (42).
 
 
-#### PreHeat
+### PreHeat
 
 PreHeat functions assume the sensor is (and stays) connected to power.
 
@@ -192,7 +199,7 @@ PreHeat functions assume the sensor is (and stays) connected to power.
 left before preHeat is complete.
 
 
-#### Request and Read
+### Request and Read
 
 The interface of the sensor is made asynchronous as there is a delay needed
 of around 80 milliseconds between a request for new data and the availability
@@ -220,7 +227,7 @@ Use 5~10 milliseconds above the minimal value the sensor still works.
 - **uint8_t getRequestTime()** returns the current request time in milliseconds.
 
 
-#### Calibration
+### Calibration
 
 Read the datasheet about calibration process (twice).
 Incorrect calibration leads to incorrect output.
@@ -235,7 +242,7 @@ from 400 to 5000, the parameter value should be in this range.
 Note: One should wait 5 milliseconds between the calibration calls (see datasheet).
 
 
-#### Miscellaneous
+### Miscellaneous
 
 - **void factoryReset()** idem.
 - **bool readFactorySet()** Read back if factory reset was successful.
@@ -245,7 +252,7 @@ Minimum length is 11.
 Minimum length is 11.
 
 
-#### Debug
+### Debug
 
 - **uint8_t getLastError()** returns last error of low level communication.
 

libraries/ACD10/library.json

@@ -15,7 +15,7 @@
     "type": "git",
     "url": "https://github.com/RobTillaart/ACD10.git"
   },
-  "version": "0.2.0",
+  "version": "0.2.1",
   "license": "MIT",
   "frameworks": "*",
   "platforms": "*",

libraries/ACD10/library.properties

@@ -1,5 +1,5 @@
 name=ACD10
-version=0.2.0
+version=0.2.1
 author=Rob Tillaart <[email protected]>
 maintainer=Rob Tillaart <[email protected]>
 sentence=Arduino library for the ACD10 CO2 sensor.