Documentation, name changes, debug parameter, new readPWMHigh method

Added lots of comments and renamed some variables to make the program
more clear. Also added `_debug` as a parameter to the constructor to
make it easier to turn on debug statements.
Updated README