Add function and docs for libpigpio's gpioHardwareClock

[cinderblock]

Note, there is a minor issue with getPwmFrequency() that prevents it from always reading the correct output frequency.