mirror of
https://github.com/RobTillaart/Arduino.git
synced 2024-09-20 00:55:58 -04:00
81 lines
2.7 KiB
Markdown
81 lines
2.7 KiB
Markdown
|
|
[](https://github.com/marketplace/actions/arduino_ci)
|
|
[](https://github.com/RobTillaart/AsyncAnalog/actions/workflows/arduino-lint.yml)
|
|
[](https://github.com/RobTillaart/AsyncAnalog/actions/workflows/jsoncheck.yml)
|
|
[](https://github.com/RobTillaart/AsyncAnalog/issues)
|
|
|
|
[](https://github.com/RobTillaart/AsyncAnalog/blob/master/LICENSE)
|
|
[](https://github.com/RobTillaart/AsyncAnalog/releases)
|
|
[](https://registry.platformio.org/libraries/robtillaart/AsyncAnalog)
|
|
|
|
|
|
# AsyncAnalog
|
|
|
|
Arduino Library for async reading of an analogue pin. **\[AVR ONLY\]**.
|
|
|
|
|
|
## Description
|
|
|
|
AsyncAnalog is a library to read the analogue port of an **AVR** in an asynchronous way.
|
|
This means that the user must explicitly **start** the ADC, check if it is **ready**
|
|
and read out its **value**.
|
|
|
|
By using this class, the user prevents the (~112 uSec) blocking of the
|
|
**analogRead()** call, and gives the user the ability to do some processing.
|
|
|
|
The library works only for AVR boards now, other platforms might be supported in the future.
|
|
|
|
**WARNING**
|
|
As the UNO has only one ADC that is multiplexed, one can only read one analogue pin
|
|
in async way simultaneously.
|
|
|
|
**Use with care**
|
|
|
|
|
|
## Interface
|
|
|
|
```cpp
|
|
#include "AsynAnalog,h"
|
|
```
|
|
|
|
- **AsyncAnalog(uint8_t pin)** constructor, defines the analogue pin to use.
|
|
- **void start()** triggers a new ADC reading.
|
|
- **bool ready()** returns true if sample is complete.
|
|
- **int value()** returns the value.
|
|
|
|
|
|
## Operation
|
|
|
|
The example **asyncAnalogTest2.ino** shows a loop of 1000 analogReads and prints
|
|
over Serial at 115200 baud.
|
|
|
|
|
|
## Future
|
|
|
|
#### Must
|
|
|
|
#### Should
|
|
|
|
- improve documentation.
|
|
|
|
#### Could
|
|
|
|
- investigate the performance gain.
|
|
- asyncAnalogTest2.ino is not a good test.
|
|
- create examples
|
|
- real world examples preferred.
|
|
- investigate other platforms
|
|
- fall back to normal analogRead for non AVR platforms ?
|
|
- better have specific code per platform.
|
|
|
|
#### Wont
|
|
|
|
## Support
|
|
|
|
If you appreciate my libraries, you can support the development and maintenance.
|
|
Improve the quality of the libraries by providing issues and Pull Requests, or
|
|
donate through PayPal or GitHub sponsors.
|
|
|
|
Thank you,
|
|
|