mpsl: rev a6eb2142530bae19b27388929bdf101f1c280856

CHANGELOG.rst contains the list of changes.

Signed-off-by: Konstantinos Sotiropoulos <[email protected]>
(cherry picked from commit 6f38908)
Signed-off-by: Joakim Andersson <[email protected]>

Author: Konstantinos Sotiropoulos

mpsl/CHANGELOG.rst

@@ -17,10 +17,10 @@ Added
 
 * Added a new signal to the MPSL timeslot: ``MPSL_TIMESLOT_SIGNAL_OVERSTAYED``.
   This signal is given to the application when a timeslot session is closed too late. (DRGN-14677)
-  
+
 * Added a new clock configuration option :c:member:`skip_wait_lfclk_started` in :c:struct:`mpsl_clock_lfclk_cfg_t`,
   which does not wait for the start of Low Frequency Clock. (DRGN-14204)
-  
+
 * Added macro MPSL_RESERVED_PPI_CHANNELS for a bit mask of (D)PPI channels
   reserved by MPSL (DRGN-13356).
 

mpsl/include/mpsl.h

@@ -81,6 +81,8 @@ int32_t mpsl_init(mpsl_clock_lfclk_cfg_t const * p_clock_config, IRQn_Type low_p
 void mpsl_uninit(void);
 
 /** @brief      Returns true if MPSL is already initialized, false otherwise.
+ *
+ *  @returns    True if initialized, false if not.
  */
 bool mpsl_is_initialized(void);
 

mpsl/include/mpsl_fem_protocol_api.h

@@ -49,10 +49,13 @@ typedef struct
     /** Implementation of the event. */
     union
     {
+        /** Parameters when type is @ref MPSL_FEM_EVENT_TYPE_TIMER. */
         struct
         {
             /** Pointer to a 1-us resolution timer instance. */
             NRF_TIMER_Type *   p_timer_instance;
+
+            /** Counter period parameters */
             struct
             {
                 /** Timer value when the Front End Module can start preparing PA/LNA. */
@@ -61,10 +64,13 @@ typedef struct
                 uint32_t       end;
               /** Time interval in which the timer should start and end. */
             } counter_period;
+
             /** Mask of the compare channels that can be used by the Front End Module to schedule its own tasks. */
             uint8_t            compare_channel_mask;
           /** Event generated by the timer, used in case of type equal to @ref mpsl_fem_event_type_t::MPSL_FEM_EVENT_TYPE_TIMER. */
         } timer;
+
+        /** Parameters when type is @ref MPSL_FEM_EVENT_TYPE_GENERIC. */
         struct
         {
             /** Address of event register. */

mpsl/include/mpsl_timeslot.h

@@ -247,11 +247,12 @@ typedef mpsl_timeslot_signal_return_param_t * (*mpsl_timeslot_callback_t) (mpsl_
  *
  * @note Resource configuration can only be performed when all timeslots are closed.
  *
- * void*   p_mem;        Pointer to a memory location for timeslot sessions.
- *                       The size of the memory block needs to be at least n_sessions * MPSL_TIMESLOT_CONTEXT_SIZE bytes.
+ * @param[in] p_mem      Pointer to a memory location for timeslot sessions.
+ *                       The size of the memory block needs to be at least
+ *                       n_sessions * @ref MPSL_TIMESLOT_CONTEXT_SIZE bytes.
  *                       The memory needs to reside in RAM.
  *                       The pointer needs to be aligned to a 4-byte boundary.
- * uint8_t n_sessions    Number of timeslot sessions.
+ * @param[in] n_sessions Number of timeslot sessions.
  *                       Maximum number of supported timeslot sessions is @ref MPSL_TIMESLOT_CONTEXT_COUNT_MAX.
  *
  * @retval  0            The configuration was applied successfully.

mpsl/include/mpsl_tx_power.h

@@ -38,7 +38,7 @@ typedef enum
     MPSL_PHY_BLE_2M,
     MPSL_PHY_BLE_LR125Kbit,
     MPSL_PHY_BLE_LR500Kbit,
-    MPSL_PHY_Ieee802154_250Kbit
+    MPSL_PHY_Ieee802154_250Kbit,
 } mpsl_phy_t;
 
 /** TX power, dBm. */
@@ -50,14 +50,19 @@ typedef struct
     mpsl_phy_t phy; /**< The PHY that this envelope applies to. */
     union
     {
+        /** Tx power per channel when @ref mpsl_tx_power_envelope_t::phy is a Bluetooth LE PHY. */
         mpsl_tx_power_t tx_power_ble[MPSL_TOTAL_NUM_OF_BLE_CHANNELS];
+
+        /** Tx power per channel when @ref mpsl_tx_power_envelope_t::phy is a 802.15.4 PHY. */
         mpsl_tx_power_t tx_power_802154[MPSL_TOTAL_NUM_OF_802154_CHANNELS];
-    } envelope; /**< Array of maximum TX power value per channel. From 11 to 26 for 802.15.4 protocol. From 0 to 40 for Bluetooth LE protocol. */
+    } envelope; /**< Array of maximum TX power value per channel. From 11 to 26 for 802.15.4 protocol.
+                     From 0 to 40 for Bluetooth LE protocol. */
 } mpsl_tx_power_envelope_t;
 
 /** @brief Sets maximum TX power envelope. If the PHY already has an envelope configured, it will be over-written.
  *
- * @note Calling this function while an envelope is being used to limit current TX Power may lead to undefined behavior.
+ * @note Calling this function while an envelope is being used to limit current TX Power
+ *       may lead to undefined behavior.
  *
  * @note The memory for the provided envelope is not copied and must be valid until it is replaced
  *       with another envelope for the same PHY.

mpsl/lib/cortex-m33+nodsp/soft-float/libmpsl.a

@@ -1,3 +1,3 @@
 description: Multi-Protocol Service Layer (MPSL)
-git_revision: 2b7721e4d01d50621f6e8585babab3a3313c9a6e
-timestamp: '2021-02-09T12:39:09Z'
+git_revision: a6eb2142530bae19b27388929bdf101f1c280856
+timestamp: '2021-02-25T17:53:33Z'

mpsl/lib/cortex-m33+nodsp/soft-float/manifest.yaml

@@ -1,3 +1,3 @@
 description: Multi-Protocol Service Layer (MPSL)
-git_revision: 2b7721e4d01d50621f6e8585babab3a3313c9a6e
-timestamp: '2021-02-09T12:37:01Z'
+git_revision: a6eb2142530bae19b27388929bdf101f1c280856
+timestamp: '2021-02-25T17:54:23Z'