Add README.md

Moves the register map documentation to README.md and add an overview.
Add CAL and new counter code

This implements the calibration routine and a new algorithm for decoding
the quadrature signals. It has not been tested!

TODO: Amalgamate the status flags for irq and cal hanlding into a single
variable.