[FL-1906] Documentation: add Doxyfile, prepare sources for doxygen. (#741)

* Documentation: add Doxyfile, prepare sources for doxygen.

* Update ReadMe and remove obsolete CLA

* Add contribution guide

* Contributing: update text

* Correct spelling

firmware/targets/furi-hal-include/furi-hal-nfc.h

@@ -1,3 +1,8 @@
+/**
+ * @file furi-hal-nfc.h
+ * NFC HAL API
+ */
+
 #pragma once
 
 #include <rfal_nfc.h>
@@ -11,58 +16,78 @@ extern "C" {
 
 #define FURI_HAL_NFC_UID_MAX_LEN 10
 
-/**
- * Init nfc
+/** Init nfc
  */
 void furi_hal_nfc_init();
 
-/**
- * Check if nfc worker is busy
+/** Check if nfc worker is busy
+ *
+ * @return     true if busy
  */
 bool furi_hal_nfc_is_busy();
 
-/**
- * NFC field on
+/** NFC field on
  */
 void furi_hal_nfc_field_on();
 
-/**
- * NFC field off
+/** NFC field off
  */
 void furi_hal_nfc_field_off();
 
-/**
- * NFC start sleep
+/** NFC start sleep
  */
 void furi_hal_nfc_start_sleep();
 
-/**
- * NFC stop sleep
+/** NFC stop sleep
  */
 void furi_hal_nfc_exit_sleep();
 
-/**
- * NFC poll
+/** NFC poll
+ *
+ * @param      dev_list    pointer to rfalNfcDevice buffer
+ * @param      dev_cnt     pointer device count
+ * @param      timeout     timeout in ms
+ * @param      deactivate  deactivate flag
+ *
+ * @return     true on success
  */
 bool furi_hal_nfc_detect(rfalNfcDevice** dev_list, uint8_t* dev_cnt, uint32_t timeout, bool deactivate);
 
-/**
- * NFC listen
+/** NFC listen
+ *
+ * @param      uid                 pointer to uid buffer
+ * @param      uid_len             uid length
+ * @param      atqa                pointer to atqa
+ * @param      sak                 sak
+ * @param      activate_after_sak  activate after sak flag
+ * @param      timeout             timeout in ms
+ *
+ * @return     true on success
  */
 bool furi_hal_nfc_listen(uint8_t* uid, uint8_t uid_len, uint8_t* atqa, uint8_t sak, bool activate_after_sak, uint32_t timeout);
 
-/**
- * Get first command from reader after activation in emulation mode
+/** Get first command from reader after activation in emulation mode
+ *
+ * @param      rx_buff  pointer to receive buffer
+ * @param      rx_len   receive buffer length
+ *
+ * @return     true on success
  */
 bool furi_hal_nfc_get_first_frame(uint8_t** rx_buff, uint16_t** rx_len);
 
-/**
- * NFC data exchange
+/** NFC data exchange
+ *
+ * @param      tx_buff     transmit buffer
+ * @param      tx_len      transmit buffer length
+ * @param      rx_buff     receive buffer
+ * @param      rx_len      receive buffer length
+ * @param      deactivate  deactivate flag
+ *
+ * @return     ST ReturnCode
  */
 ReturnCode furi_hal_nfc_data_exchange(uint8_t* tx_buff, uint16_t tx_len, uint8_t** rx_buff, uint16_t** rx_len, bool deactivate);
 
-/**
- * NFC deactivate and start sleep
+/** NFC deactivate and start sleep
  */
 void furi_hal_nfc_deactivate();