Read me updated

The readme no includes how to properly setup these files with an
existing project.

I also refactored some code in the Pins.c/h files to use more magic
numbers and more generic variable names. No functionality changed.