Add new GPIO APIs for adding shared GPIO handlers, and improve docs (#850)

src/rp2_common/hardware_gpio/CMakeLists.txt

src/rp2_common/hardware_gpio/gpio.c

src/rp2_common/hardware_gpio/include/hardware/gpio.h