C++ API for Grove TP401 Air Quality Sensor. More...

Detailed Description

ID: tp401
Name: Grove Air Quality Sensor
Other Names: TP401
Category: gaseous
Manufacturer: seeed
Connection: analog

The Grove TP401 Air Quality Sensor module is useful for monitoring air purity indoors. It can detect CO and a wide range of other harmful gases, but due to limited sensing range should be used only when qualitative results are needed. Example applications are air recirculation, ventilation systems, and refreshing sprayers. The sensor is linear and should be roughly sensitive to 0 ~ 20 ppm CO from 0 ~ 4V. Also note that the sensor requires 2-3 minutes to warm up initially and 48 hours of operation to stabilize completely.

// Give a qualitative meaning to the value from the sensor
std::string
airQuality(uint16_t value)
{
    if(value < 50) return "Fresh Air";
    if(value < 200) return "Normal Indoor Air";
    if(value < 400) return "Low Pollution";
    if(value < 600) return "High Pollution - Action Recommended";
    return "Very High Pollution - Take Action Immediately";
}
int main ()
{
    upm::TP401* airSensor = new upm::TP401(0); // Instantiate new grove air quality sensor on analog pin A0
    cout << airSensor->name() << endl;
    fprintf(stdout, "Heating sensor for 3 minutes...\n");
    // wait 3 minutes for sensor to warm up
    for(int i = 0; i < 3; i++) {
        if(i) {
            fprintf(stdout, "Please wait, %d minute(s) passed..\n", i);
        }
        sleep(60);
    }
    fprintf(stdout, "Sensor ready!\n");
    while(true) {
        uint16_t value = airSensor->getSample(); // Read raw value
        float ppm = airSensor->getPPM();    // Read CO ppm (can vary slightly from previous read)
        fprintf(stdout, "raw: %4d ppm: %5.2f   %s\n", value, ppm, airQuality(value).c_str());
        usleep(2500000);    // Sleep for 2.5s
    }
    delete airSensor;
    return 0;
}

Public Member Functions
	TP401 (int gasPin)

	~TP401 ()

std::string	name ()

float	getPPM ()

Public Member Functions inherited from Gas
	Gas (int gasPin)

	~Gas ()

virtual int	getSampledWindow (unsigned int freqMS, unsigned int numberOfSamples, uint16_t *buffer)

virtual int	findThreshold (thresholdContext ctx, unsigned int threshold, uint16_t buffer, unsigned int len)

virtual int	getSampledData (thresholdContext *ctx)

virtual int	getSample ()

virtual void	printGraph (thresholdContext *ctx, uint8_t resolution)