pms_series 软件包是 攀藤 pm2.5系列的驱动软件包，是基于激光散射原理的数字式通用颗粒物浓度传感器，可连续采集并计算单位体积内空气中不同粒径的悬浮颗粒物个数，即颗粒物浓度分布，进而换算成为质量浓度，并以通用数字接口形式输出。可嵌入各种与空气中悬浮颗粒物浓度相关的仪器仪表或环境改善设备，为其提供及时准确的浓度数据。
本软件包支持uart接口，目前仅支持主动式传输协议，支持的具体型号为下表：
| 名称 | 说明 | 测试 |
|---|---|---|
| PMS5003ST | PM2.5、PM10、温度、湿度、甲醛 | √ |
| PMS5003S | PM2.5、PM10、甲醛 | |
| PMS5003T | PM2.5、PM10、温度、湿度 | √ |
| PMS5003 | PM2.5、PM10 | |
| PMS7003 | PM2.5、PM10 | |
| PMS7003M | PM2.5、PM10 | |
| PMS3003 | PM2.5、PM10 | |
| PMS1003 | PM2.5、PM10 | |
| PMSA003 | PM2.5、PM10 |
手头只有PMS5003ST，所以只测试了这个，其他的型号协议大同小异，有条件的可以测测。
| 名称 | 说明 |
|---|---|
| docs | 文档目录 |
| examples | 例子目录，并有相应的一些说明 |
| inc | 头文件目录 |
| src | 源代码目录 |
pms_series 遵循 MIT许可，详见 LICENSE 文件。
- RT-Thread 4.0.1+
- 使用串口DMA需要开启相关接口
使用 pms_series package 需要在 RT-Thread 的包管理器中选择它，具体路径如下：
RT-Thread online packages --->
peripheral libraries and drivers --->
[*] pms_series: Digital universal particle concentration ...
Model (PMS5003ST) --->
[*] Enable pms series sample
[*] Enable pms series sample dma
Enable pms series sample uart (UART2)
Version (v1.0.0) --->
Model: 选择PMS系列的型号，总共包含段落1中的表格的型号；
**Enable pms series sample **: 使用例程代码
**Enable pms series sample dma **：使用例程中串口DMA
**Enable pms series sample uart **：选择例程中使用的串口
然后让 RT-Thread 的包管理器自动更新，或者使用 pkgs --update 命令更新包到 BSP 中。
| 版本 | 说明 |
|---|---|
| v1.0.0 | 支持多种PMS系列传感器，支持主动式传输 |
| latest | 进一步优化 |
初始化传感器
初始化传感器
pms_device_t pms_init(const char *uart_name);
| 参数 | 描述 |
|---|---|
| uart_name | 串口名称 |
| 返回 | —— |
| pms_device_t | 传感器对象句柄 |
协议解析
rt_err_t frame_check(pms_device_t dev,rt_uint8_t *buf,rt_uint16_t len);
协议解析函数，整包解析，直接应用在DMA接收上
| 参数 | 描述 |
|---|---|
| dev | 传感器对象结构体 |
| buf | 解析数据的缓存 |
| len | 解析数据的长度 |
| 返回 | —— |
| RT_EOK | 解析成功 |
| RT_ERROR | 解析失败 |
按字节解析
rt_err_t pms_get_byte(pms_device_t dev, char data);
按字节解析函数，可用于串口字节接收上，接收到一帧数据后，会调用frame_check进行整包解析
| 参数 | 描述 |
|---|---|
| dev | 传感器对象结构体 |
| data | 接收的一个字节数据 |
| 返回 | —— |
| RT_EOK | 解析成功 |
| RT_ERROR | 正在解析 |
失能传感器
void pms_deinit(pms_device_t dev);
释放申请的内存
- 例程中，有两种采集方式一种是字节解析，使用信号量，收到特定一帧后解析，另外一种是DMA，收到一帧数据然后进行解析。
- 协议解析出来的数据统一为 uint16 方便用户用作其他处理，数据具体的单位以及转换请参考/doc文件夹下的手册。