nrf_modem: update library

nrf_modem/include/nrf_modem_softsim.h

@@ -20,6 +20,9 @@
 extern "C" {
 #endif
 
+/* Maximum Le (length of expected data). */
+#define NRF_MODEM_SOFTSIM_MAX_LE 512
+
 /** @brief SoftSIM request command type. */
 enum nrf_modem_softsim_cmd {
 	/** @brief Initialization command.*/
@@ -36,9 +39,10 @@ enum nrf_modem_softsim_cmd {
  *
  * @details This handler lets the application process a SoftSIM request.
  *          The application must then call @ref nrf_modem_softsim_res with the response data
- *          requested.
+ *          requested, and @ref nrf_modem_softsim_free when the request is not referenced
+ *          anymore and can be freed.
  *
- * @note This handler is executed in an interrupt service routine.
+ * @note This handler is executed in an interrupt service routine (ISR).
  *       Offload any intensive operations as necessary.
  *
  * @param cmd SoftSIM request command.
@@ -52,7 +56,7 @@ typedef void (*nrf_modem_softsim_req_handler_t)(enum nrf_modem_softsim_cmd cmd,
 /**
  * @brief Set a handler function for SoftSIM requests.
  *
- * @note The handler is executed in an interrupt service routine.
+ * @note The handler is executed in an interrupt service routine (ISR).
  *	 Take care to offload any processing as appropriate.
  *
  * @param handler The SoftSIM request handler. Use @c NULL to unset handler.
@@ -67,13 +71,17 @@ int nrf_modem_softsim_req_handler_set(nrf_modem_softsim_req_handler_t handler);
  * @details This function is used to respond to the Modem with the data requested by a specific
  *          request.
  *
+ * @note This function takes care of copying @ref data to an internal buffer, so any
+ *       heap allocation for @ref data can be freed immediately after calling this function.
+ *
  * @param cmd SoftSIM response command.
  * @param req_id Request ID used to match request and response.
  * @param[in] data Pointer to the data of the SoftSIM response.
  * @param data_len Length of the data of the SoftSIM response.
  *
  * @retval 0 on success.
  * @retval -NRF_EINVAL If input data is invalid.
+ * @retval -NRF_E2BIG  If the length of @ref data exceeds @ref NRF_MODEM_SOFTSIM_MAX_LE.
  * @retval -NRF_ENOMEM If memory allocation failed.
  */
 int nrf_modem_softsim_res(enum nrf_modem_softsim_cmd cmd, uint16_t req_id, void *data,