net: doc: ieee802154_radio.h: Add more documentation

Added more doxygen comments to ieee802154 radio header file in
order to improve documentation coverage percentage.

Signed-off-by: Jukka Rissanen <jukka.rissanen@nordicsemi.no>