fixup! drivers/at86rf215: Add driver for the AT86RF215 radio

drivers/at86rf215/include/at86rf215_internal.h

@@ -237,14 +237,53 @@ uint8_t at86rf215_FSK_get_mod_order(at86rf215_t *dev);
  * @{
  */
 
-void at86rf215_configure_OFDM(at86rf215_t *dev, uint8_t option, uint8_t scheme);
+/**
+ * @brief   Configure the radio to make use of OFDM modulation.
+ *          There are 4 OFDM options, each with a different number of active tones.
+ *          The deivce supports BPSK, QPSK and 16-QAM modulation and coding schemes (MCS)
+ *
+ * @param[in] dev       device to configure
+ * @param[in] option    modulation option, each increment halves the data rate
+ * @param[in] mcs       modulation scheme, `BB_MCS_BPSK_REP4` … `BB_MCS_16QAM_3BY4`
+ */
+void at86rf215_configure_OFDM(at86rf215_t *dev, uint8_t option, uint8_t mcs);
 
-int at86rf215_OFDM_set_scheme(at86rf215_t *dev, uint8_t scheme);
+/**
+ * @brief   Set the current modulation and coding scheme (MCS)
+ *
+ * @param[in] dev       device to configure
+ * @param[in] mcs       modulation and coding scheme
+ *
+ * @return              0 on success, error otherwise
+ */
+int at86rf215_OFDM_set_scheme(at86rf215_t *dev, uint8_t mcs);
 
+/**
+ * @brief   Get the current modulation and coding scheme (MCS)
+ *
+ * @param[in] dev       device to read from
+ *
+ * @return              the current modulation & coding scheme
+ */
 uint8_t at86rf215_OFDM_get_scheme(at86rf215_t *dev);
 
+/**
+ * @brief   Set the current OFDM option
+ *
+ * @param[in] dev       device to configure
+ * @param[in] option    OFDM option
+ *
+ * @return              0 on success, error otherwise
+ */
 int at86rf215_OFDM_set_option(at86rf215_t *dev, uint8_t option);
 
+/**
+ * @brief   Get the current OFDM option
+ *
+ * @param[in] dev       device to read from
+ *
+ * @return              the current OFDM option
+ */
 uint8_t at86rf215_OFDM_get_option(at86rf215_t *dev);
 
 /** @} */
@@ -254,14 +293,57 @@ uint8_t at86rf215_OFDM_get_option(at86rf215_t *dev);
  * @{
  */
 
+/**
+ * @brief   Configure the radio to make use of O-QPSK modulation.
+ *          The chip rate is the number of bits per second (chips per second) used in the spreading signal.
+ *          The rate mode may be
+ *              - @ref AT86RF215_OQPSK_MODE_LEGACY for compatibility with first-gen 802.15.4 devices (250 kbit/s)
+ *              - @ref AT86RF215_OQPSK_MODE_LEGACY_HDR for compatibility with the proprietary high-data rate mode
+ *                of the at86rf233 (1000 kbit/s, 2.4 GHz) and at86rf212b (500 kbit/s, sub-GHz)
+ *              - @ref AT86RF215_MR_OQPSK_MODE for the rate modes specified in 802.15.4g-2012
+ *
+ * @param[in] dev       device to configure
+ * @param[in] chips     chip rate, `BB_FCHIP100` … `BB_FCHIP2000`
+ * @param[in] rate      rate mode, may be @ref AT86RF215_OQPSK_MODE_LEGACY or @ref AT86RF215_MR_OQPSK_MODE
+ */
 void at86rf215_configure_OQPSK(at86rf215_t *dev, uint8_t chips, uint8_t rate);
 
+/**
+ * @brief   Get the current O-QPSK chip rate
+ *
+ * @param[in] dev       device to read from
+ *
+ * @return              the current chip rate
+ */
 uint8_t at86rf215_OQPSK_get_chips(at86rf215_t *dev);
 
+/**
+ * @brief   Set the current O-QPSK chip rate
+ *
+ * @param[in] dev       device to configure
+ * @param[in] chips     chip rate in chip/s
+ *
+ * @return              0 on success, error otherwise
+ */
 int at86rf215_OQPSK_set_chips(at86rf215_t *dev, uint8_t chips);
 
+/**
+ * @brief   Get the current O-QPSK rate mode
+ *
+ * @param[in] dev       device to read from
+ *
+ * @return              the current rate mode
+ */
 uint8_t at86rf215_OQPSK_get_mode(at86rf215_t *dev);
 
+/**
+ * @brief   Set the current O-QPSK rate mode
+ *
+ * @param[in] dev       device to configure
+ * @param[in] mode      rate mode
+ *
+ * @return              0 on success, error otherwise
+ */
 int at86rf215_OQPSK_set_mode(at86rf215_t *dev, uint8_t mode);
 
 /** @} */