Skip to content

NovaFitness sensors

Warning

This sensors are 3.3V devices. They require 5V power to operate the laser and fan. However, the I/O pins are not 5V tolerant and the sensor will be damaged by 5V logic.

Sensor --sensor-model PM2.5 PM10 PM100
SDS011 SDS01x
SDS018 SDS01x
SDS021 SDS01x
SDS198 SDS198
Sensor Datasheet Dimensions Connector
SDS011 en 70x70x25 mm³ 7 Pin
SDS018 en 60x46x20 mm³ 7 Pin
SDS021 en 43x32x24 mm³ 5 Pin
SDS198 en 70x70x25 mm³ 7 Pin

Connector

5 pin ????, comes with sensor

Pin Name Voltage Function
1 5V 4.7-5.3V >1W, ripple < 20 mV
2 NC not connected
3 GND 0V
4 R 3.3V TTL RX serial port
5 T 3.3V TTL TX serial port

7 pin JST XH (2.5mm pitch), comes with sensor

Pin Name Voltage Function
1 NC not connected
2 1μm 3.3V PWM PM2.5 0-999 μg/m³; reserved on SDS198
3 5V 4.7-5.3V >1W, ripple < 20 mV
4 2.5μm 3.3V PWM PM10 0-999 μg/m³; reserved on SDS198
5 GND 0V
6 R 3.3V TTL RX serial port
7 T 3.3V TTL TX serial port

Protocol

Serial protocol is UART 9600 8N1 3.3V TTL.

All the NovaFitness PM sensors can be fully controlled with serial commands:

Command Description message
active_mode continuous operation aa b4 02 01 00 00 00 00 00 00 00 00 00 00 00 ff ff 01 ab
passive_mode single-shot operation aa b4 02 01 01 00 00 00 00 00 00 00 00 00 00 ff ff 02 ab
passive_read trigger single-shot measurement aa b4 04 00 00 00 00 00 00 00 00 00 00 00 00 ff ff 02 ab
sleep sleep mode aa b4 06 01 00 00 00 00 00 00 00 00 00 00 00 ff ff 05 ab
wake wake up from sleep mode aa b4 06 01 01 00 00 00 00 00 00 00 00 00 00 ff ff 06 ab

Messages containing measurements consist of unsigned short integers. The second to last bit of the message should contain sum(message[2:-2])%0x100.

message SDS01x SDS198
10 bits 10 bits
header 2 bits 2 bits
aa c0 aa cf
body 6 bits 6 bits
2 values, 1 ID 1 reserved, 1 value, 1 ID
checksum 1 bit 1 bit
tail 1 bit 1 bit
ab ab

The message body (message[2:6]) contains 2 values:

  • pm25, pm10: PM2.5, PM10 [μg/m³] (raw values [0.1 μg/m³])

The message body (message[4:6]) contains 1 value:

  • pm100: PM100 [μg/m³]

SDS01x

About the sensors supported by the SDS01x protocol (-m SDS01x)

pms -m SDS01x info

NovaFitness SDS011, SDS018 and SDS021 sensor observations

time                                    measurement time [seconds since epoch]
pm25, pm10                              PM2.5, PM10 [μg/m3]

String formats: pm (default), csv and header

Read 10 samples (-n 10), one sample every 10 seconds (-i 10)

pms -m SDS01x -n 10 -i 10 serial

2020-09-27 20:11:20: PM2.5 0.6, PM10 0.6 μg/m3
2020-09-27 20:11:30: PM2.5 0.9, PM10 0.9 μg/m3
2020-09-27 20:11:40: PM2.5 0.9, PM10 0.9 μg/m3
2020-09-27 20:11:50: PM2.5 0.9, PM10 0.9 μg/m3
2020-09-27 20:12:00: PM2.5 0.9, PM10 0.9 μg/m3
2020-09-27 20:12:10: PM2.5 0.9, PM10 0.9 μg/m3
2020-09-27 20:12:20: PM2.5 0.9, PM10 0.9 μg/m3
2020-09-27 20:12:30: PM2.5 0.8, PM10 0.8 μg/m3
2020-09-27 20:12:40: PM2.5 0.8, PM10 0.8 μg/m3
2020-09-27 20:12:50: PM2.5 0.8, PM10 0.8 μg/m3

Print on CSV format (-f csv)

pms -m SDS01x -n 10 -i 10 serial -f csv

time, pm25, pm10
1601230280, 0.6, 0.6
1601230290, 0.9, 0.9
1601230300, 0.9, 0.9
1601230310, 0.9, 0.9
1601230320, 0.9, 0.9
1601230330, 0.9, 0.9
1601230340, 0.9, 0.9
1601230350, 0.8, 0.8
1601230360, 0.8, 0.8
1601230370, 0.8, 0.8

Print on hexdump format (-f hexdump)

pms -m SDS01x -n 10 -i 10 serial -f hexdump

00000000: aa c0 06 00 06 00 58 d9 3d ab  ......X.=.
0000000a: aa c0 09 00 09 00 58 d9 43 ab  ......X.C.
00000014: aa c0 09 00 09 00 58 d9 43 ab  ......X.C.
0000001e: aa c0 09 00 09 00 58 d9 43 ab  ......X.C.
00000028: aa c0 09 00 09 00 58 d9 43 ab  ......X.C.
00000032: aa c0 09 00 09 00 58 d9 43 ab  ......X.C.
0000003c: aa c0 09 00 09 00 58 d9 43 ab  ......X.C.
00000046: aa c0 08 00 08 00 58 d9 41 ab  ......X.A.
00000050: aa c0 08 00 08 00 58 d9 41 ab  ......X.A.
0000005a: aa c0 08 00 08 00 58 d9 41 ab  ......X.A.

SDS198

About the SDS198 sensor (-m SDS198)

pms -m SDS198 info

NovaFitness SDS198 sensor observations

time                                    measurement time [seconds since epoch]
pm100                                   PM100 [μg/m3]

String formats: pm (default), csv and header

Read 6 samples (-n 6), one sample every 10 seconds (-i 10)

pms -m SDS198 -n 6 -i 10 serial

2020-09-09 14:58:30: PM100 16.0 μg/m3
2020-09-09 14:58:40: PM100 19.0 μg/m3
2020-09-09 14:58:50: PM100 22.0 μg/m3
2020-09-09 14:59:00: PM100 26.0 μg/m3
2020-09-09 14:59:10: PM100 20.0 μg/m3
2020-09-09 14:59:20: PM100 1.0 μg/m3

Print on CSV format (-f csv)

pms -m SDS198 -n 6 -i 10 serial -f csv

time, pm100
1599656310, 16.0
1599656320, 19.0
1599656330, 22.0
1599656340, 26.0
1599656350, 20.0
1599656360, 1.0

Print on hexdump format (-f hexdump)

pms -m SDS198 -n 6 -i 10 serial -f hexdump

00000000: aa cf 0e 00 10 00 e9 05 0c ab  ..........
0000000a: aa cf 0e 00 13 00 e9 05 0f ab  ..........
00000014: aa cf 0c 00 16 00 e9 05 10 ab  ..........
0000001e: aa cf 0c 00 1a 00 e9 05 14 ab  ..........
00000028: aa cf 0b 00 14 00 e9 05 0d ab  ..........
00000032: aa cf 06 01 01 00 e9 05 f6 ab  ..........