Skip to content

DigisparkSoftRcPulseIn

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History
 
 

DigisparkSoftRcPulseIn

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
examples
examples
 
 
Readme.md
Readme.md
 
 
SoftRcPulseIn.cpp
SoftRcPulseIn.cpp
 
 
SoftRcPulseIn.h
SoftRcPulseIn.h
 
 
keywords.txt
keywords.txt
 
 

Readme.md

SoftRcPulseIn library

SoftRcPulseIn is an asynchronous library designed to read RC pulse signals. It is a non-blocking version of arduino pulseIn() function.

Some examples of use cases:

  • RC Servo/ESC/Brushless Controller
  • Multi-switch (RC Channel to digital outputs converter) (look at RcSeq library)
  • Servo sequencer (look at RcSeq library which uses SoftRcPulseOut library)
  • RC Robot using wheels with modified Servo to support 360° rotation
  • RC pulse stretcher (in conjunction with SoftRcPulseOut library)

Supported Arduinos:

  • ATmega328 (UNO)
  • ATmega2560 (MEGA)
  • ATtiny84 (Standalone)
  • ATtiny85 (Standalone or Digispark)
  • ATtiny167 (Digispark pro)
  • ATmega32U4 (Leonardo, Micro, Pro Micro)
  • ESP8266

Tip and Tricks:

Develop your project on an arduino UNO or MEGA, and then shrink it by loading the sketch in an ATtiny or Digispark (pro).

Object constructor:

3 ways to declare a SoftRcPulseIn object:

    1. SoftRcPulseIn MyRcSignal; //Positive RC pulse expected (default behaviour)
    1. SoftRcPulseIn MyRcSignal(false); //Positive RC pulse expected (equivalent as the above)
    1. SoftRcPulseIn MyRcSignal(true); //Negative RC pulse expected

API/methods:

  • attach()

  • available()

  • width_us()

  • timeout()

  • Constants for version management:

    • SOFT_RC_PULSE_IN_VERSION: returns the library version
    • SOFT_RC_PULSE_IN_REVISION: returns the library revision

Design considerations:

The SoftRcPulseIn library relies the TinyPinChange library. This one shall be included in the sketch as well, except for the ESP8266 where TinyPinChange is not needed.

On the arduino MEGA (ATmega2560), as all the pins do not support "pin change interrupt", only the following pins are supported:

  • 10 -> 15
  • 50 -> 53
  • A8 -> A15

On the arduino Lenardo, Micro and Pro Micro (ATmega32U4), as all the pins do not support "pin change interrupt", only the following pins are supported:

  • 0 -> 3 (external INT0, INT1, INT2 and INT3 are used as emulated Pin Change Interrupt)
  • 8 -> 11 (pin 11 is not available on the headers/connectors)
  • 14 -> 17 (pin 17 is not available on the headers/connectors)

On other devices (ATmega328, ATtiny84, ATtiny85 and ATtiny167), all the pins are usable.

On ESP8266, all the GPIO are usable, except GPIO16.

Contact

If you have some ideas of enhancement, please contact me by clicking on: RC Navy.