timer_hardware_alarm_claim_unused() function
cooperatively claim the use of a hardware alarm_num on the given timer instance This method attempts to claim an unused hardware alarm
Arguments
required
if true the function will panic if none are available
Return value
alarm_num the hardware alarm claimed or -1 if required was false, and none are available \sa hardware_alarm_claim_unused \sa hardware_claiming