node-red-contrib-pmsa003i

A Node-RED node for reading particle concentration data from Plantower PMSA003I sensors over I2C.

Installation

cd ~/.node-red
npm install @thehighestbit/node-red-contrib-pmsa003i

Configuration

| Property | Description | |----------|-------------| | I2C Address | Sensor address: 0x12 | | I2C Bus | I2C bus number (default: 1) | | Read Interval | Polling interval in ms (minimum 1000ms). Leave blank to disable polling. |

Usage

The node outputs particle concentration readings as a JSON payload:

{
    "payload": {
        "pm1_0_standard": 5,
        "pm2_5_standard": 8,
        "pm10_standard": 10,
        "pm1_0_env": 5,
        "pm2_5_env": 8,
        "pm10_env": 10,
        "particles_0_3": 1200,
        "particles_0_5": 350,
        "particles_1_0": 48,
        "particles_2_5": 6,
        "particles_5_0": 2,
        "particles_10": 0,
        "version": 17,
        "errorCode": 0
    },
    "topic": "pmsa003i/0x12"
}

Payload Fields

| Field | Unit | Description | |-------|------|-------------| | pm1_0_standard | ug/m3 | PM1.0 concentration (CF=1, standard particle) | | pm2_5_standard | ug/m3 | PM2.5 concentration (CF=1, standard particle) | | pm10_standard | ug/m3 | PM10 concentration (CF=1, standard particle) | | pm1_0_env | ug/m3 | PM1.0 concentration (atmospheric environment) | | pm2_5_env | ug/m3 | PM2.5 concentration (atmospheric environment) | | pm10_env | ug/m3 | PM10 concentration (atmospheric environment) | | particles_0_3 | per 0.1L | Particles with diameter beyond 0.3 um | | particles_0_5 | per 0.1L | Particles with diameter beyond 0.5 um | | particles_1_0 | per 0.1L | Particles with diameter beyond 1.0 um | | particles_2_5 | per 0.1L | Particles with diameter beyond 2.5 um | | particles_5_0 | per 0.1L | Particles with diameter beyond 5.0 um | | particles_10 | per 0.1L | Particles with diameter beyond 10 um | | version | - | Sensor firmware version | | errorCode | - | Sensor error code (0 = no error) |

Triggering Reads

• Automatic polling: Set a read interval to poll the sensor automatically
• Manual trigger: Send any message to the node input to trigger an immediate read