Skip to content

Commit

Permalink
library.properties
Browse files Browse the repository at this point in the history
  • Loading branch information
jbanaszczyk committed Apr 23, 2018
1 parent 972ae06 commit 5c5ceb6
Show file tree
Hide file tree
Showing 4 changed files with 50 additions and 14 deletions.
50 changes: 43 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,56 @@
# Before

Current version is under development, may be not stable enough. Please refer to the latest release: https://github.com/jbanaszczyk/pms5003/releases

# pms5003

I'm proud to present my Arduino library supporting PMS5003 Air Quality Sensor.

## Status

### Current revision: 2.00 RC

Not released yet as a release

Code in repository (branch: master) is 2.00 RC
* It looks stable - development is finished
* README have to be updated
* There are some TODOs for next revisions

### Good, stable revision: 1.00

Previous releases are available here: https://github.com/jbanaszczyk/pms5003/releases

There is one interesting fork supporting ESP8266: https://github.com/riverscn/pmsx003

## Other boards

Probably my library supports Plantover PMS700x, PMS300x without any problems.

If you are interested in support of your sensor: feel free to ask.

## Features

* Supports all Plantover PMS5003 features (sleep/wake up, passive/active modes),
* Supports all Plantover PMS5003 features (sleep/wake up, passive/active modes, hardware pins),
* Probably works fine with PMS7003 and PMS3003,
* Highly customizable:
* Uses any serial communication library,
* You have a choice to use or not to use: global variables or class instances.
* Written from scratch,
* Written in modern C++.
* Written in modern C++11.

## TODO

* Some checks: API
* checkResetPin - check if declared reset pin works fine (if it resets the sensor)
* checkSleepPin - check if declared sleep/wake up pin works fine
* Support for platforms
* Library should support Arduino itself (not checked yet :)
* More platforms:
* PlatformIO
* CLion
* ...
* Support for boards:
* planning ESP8266 support
* Add unit tests
* I'm sorry, there are no unit tests :(


## Preparation

Expand All @@ -25,7 +61,7 @@ Let's use [DrDiettrich' fork of AltSoftSerial Library](https://github.com/DrDiet

Make some connections:
* **Important**: pms5003 uses 3.3V logic. Make sure your Arduino board uses 3.3V logic too, use converters if required.
* PMS5003 Pin 1: Vcc
* PMS5003 Pin 1: VCC
* PMS5003 Pin 2: GND
* PMS5003 Pin 4: Digital pin 9 (there is no choice, forced by AltSerial)
* PMS5003 Pin 5: Digital pin 8 (there is no choice)
Expand Down
2 changes: 1 addition & 1 deletion examples/Simple01/Simple01.vcxproj
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@
<FunctionLevelLinking>true</FunctionLevelLinking>
<IntrinsicFunctions>true</IntrinsicFunctions>
<SDLCheck>true</SDLCheck>
<AdditionalIncludeDirectories>$(ProjectDir)..\Simple01;$(ProjectDir)..\..\src;$(ProjectDir)..\..\..\AltSoftSerial;C:\Program Files (x86)\Arduino\libraries;$(ProjectDir)..\..\..\..\libraries;C:\Program Files (x86)\Arduino\hardware\arduino\avr\libraries;C:\Program Files (x86)\Arduino\hardware\arduino\avr\cores\arduino;C:\Program Files (x86)\Arduino\hardware\arduino\avr\variants\standard;C:\Program Files (x86)\Arduino\hardware\tools\avr\avr\include\;C:\Program Files (x86)\Arduino\hardware\tools\avr\avr\include\avr\;C:\Program Files (x86)\Arduino\hardware\tools\avr\lib\gcc\avr\4.8.1\include;C:\Program Files (x86)\Arduino\hardware\tools\avr\lib\gcc\avr\4.9.2\include;C:\Program Files (x86)\Arduino\hardware\tools\avr\lib\gcc\avr\4.9.3\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
<AdditionalIncludeDirectories>$(ProjectDir)..\Simple01;$(ProjectDir)..\..\src;C:\Program Files (x86)\Arduino\libraries;$(ProjectDir)..\..\..\..\libraries;C:\Program Files (x86)\Arduino\hardware\arduino\avr\libraries;C:\Program Files (x86)\Arduino\hardware\arduino\avr\cores\arduino;C:\Program Files (x86)\Arduino\hardware\arduino\avr\variants\standard;C:\Program Files (x86)\Arduino\hardware\tools\avr\avr\include\;C:\Program Files (x86)\Arduino\hardware\tools\avr\avr\include\avr\;C:\Program Files (x86)\Arduino\hardware\tools\avr\lib\gcc\avr\4.8.1\include;C:\Program Files (x86)\Arduino\hardware\tools\avr\lib\gcc\avr\4.9.2\include;C:\Program Files (x86)\Arduino\hardware\tools\avr\lib\gcc\avr\4.9.3\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
<ForcedIncludeFiles>$(ProjectDir)__vm\.Simple01.vsarduino.h;%(ForcedIncludeFiles)</ForcedIncludeFiles>
<WholeProgramOptimization>false</WholeProgramOptimization>
<PreprocessorDefinitions>__AVR_ATmega328p__;__AVR_ATmega328P__;F_CPU=16000000L;ARDUINO=10805;ARDUINO_AVR_UNO;ARDUINO_ARCH_AVR;__cplusplus=201103L;_VMICRO_INTELLISENSE;%(PreprocessorDefinitions)</PreprocessorDefinitions>
Expand Down
12 changes: 6 additions & 6 deletions library.properties
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
name=pms
version=1.0.0
author=Jacek Banaszczyk
maintainer=Jacek Banaszczyk<[email protected]>
name=pms5003
version=2.0.0
author=Jacek Banaszczyk <[email protected]>
maintainer=Jacek Banaszczyk <[email protected]>
sentence=PMS5003 Air Quality Sensor library.
paragraph=PMS 5003 and similar are Particulate Matter from Plantover.
category=Uncategorized
paragraph=PMS 5003 and similar are Particulate Sensor from Plantover.
category=Sensors
url=https://github.com/jbanaszczyk/pms5003
architectures=*
Empty file removed src/pms.cpp
Empty file.

0 comments on commit 5c5ceb6

Please sign in to comment.