prepare 8.3.3

* Bundles:
    * [NEW] `ll_aes_encrypt` (all bundles)
    * [NEW] `ll_get_conn_info`, `ll_get_conn_events_info` (_Experimental_ bundles)

* Library:
    * [UPD] SYSCTRL: fix wakup source detection & updates for PMU

bundles/exp/ING9187xx/meta.json

@@ -4,15 +4,15 @@
     }, 
     "ram": {
         "base": 536870912, 
-        "size": 29916
+        "size": 29924
     }, 
     "rom": {
         "base": 16384, 
-        "size": 144272
+        "size": 144232
     }, 
     "version": [
         1, 
         9, 
-        14
+        15
     ]
 }

bundles/exp/ING9188xx/meta.json

@@ -4,15 +4,15 @@
     }, 
     "ram": {
         "base": 536870912, 
-        "size": 29916
+        "size": 29924
     }, 
     "rom": {
         "base": 16384, 
-        "size": 151248
+        "size": 151176
     }, 
     "version": [
         1, 
         9, 
-        14
+        15
     ]
 }

bundles/exp/inc/gap.h

@@ -47,14 +47,15 @@ typedef enum scan_type
  * @brief set random address device
  *
  * @param address               random address
+ * @return                      0: Message is sent to controller; others: failed
  */
-void gap_set_random_device_address(const uint8_t *address);
+uint8_t gap_set_random_device_address(const uint8_t *address);
 
 /**
  * @brief Disconnect connection with handle
  *
  * @param handle                Used to identify an advertising set. Range: 0x00 to 0xEF
- * @return                      0: Message is sent out or the connection alreay release
+ * @return                      0: Message is sent out or the connection already release
  */
 uint8_t gap_disconnect(hci_con_handle_t handle);
 
@@ -67,7 +68,7 @@ void gap_disconnect_all(void);
  *
  * @param[in] address               BLE address
  * @param[in] addtype               BLE address type
- * @return                      0: Message is sent to controller
+ * @return                          0: Message is sent to controller
  */
 uint8_t gap_add_whitelist(const uint8_t *address,bd_addr_type_t  addtype);
 
@@ -1312,42 +1313,41 @@ uint8_t gap_vendor_tx_continuous_wave(uint8_t enable, uint8_t power_level_index,
 #define HCI_VENDOR_CCM  0xFC01
 
 /**
- * @brief host require controller to do AES-CCM functionality, and CCM referece to
+ * @brief Host require controller to do AES-CCM functionality, and CCM reference to
  *        the document rfc3610:Counter with CBC-MAC (CCM)
  *
- * @param type                  0: encrypt     1:decrypt
- *
- * @param mic_size              8: mic size in 8 bytes  4: mic size in 4 bytes
- *
- * @param msg_len               messge length to be encrypt or decrypt
- *
- * @param aad_len               Additional authenticated data length
- *
- * @param tag                   a value to identify a AES-CCM request.
- *
- * @param key                   128 bits long key as required by AES-CCM
- *
- * @param nonce                 random value of each AES-CCM require 13 bytes long
- *
- * @param msg                   pointer to the message input
+ * All input buffers (key, nonce, msg, aad) must be kept in memory until AES-CCM completed.
  *
- * @param aad                   Additional authenticated data
+ * `return_param` passed to `cb` is casted from `event_vendor_ccm_complete_t`.
  *
- * @param out_msg               the output buffer to store the result of the AES-CCM ,calculated by controller.
+ * @param[in]  type                  0: encrypt     1:decrypt
+ * @param[in]  mic_size              8: mic size in 8 bytes  4: mic size in 4 bytes
+ * @param[in]  msg_len               message length to be encrypt or decrypt (<= 384 bytes)
+ * @param[in]  aad_len               Additional authenticated data length (<= 16 bytes)
+ * @param[in]  tag                   a value to identify a AES-CCM request.
+ * @param[in]  key                   128 bits long key as required by AES-CCM
+ * @param[in]  nonce                 random value of each AES-CCM require 13 bytes long
+ * @param[in]  msg                   pointer to the message input
+ * @param[in]  aad                   Additional authenticated data
+ * @param[out] out_msg               the output buffer to store the result of the AES-CCM
+ * @param[in]  cb                    callback function on the corresponding command complete event
+ * @param[in]  user_data             user data for the callback function
  *
- * @return                      0: success    others: failed
+ * @return                           0: success    others: failed
  */
 uint8_t gap_start_ccm(
         uint8_t  type,          // 0: encrypt  1: decrypt
         uint8_t  mic_size,
         uint16_t msg_len,
         uint16_t aad_len,
         uint32_t tag,          // same value will be reported in event
-        uint8_t *key,
-        uint8_t *nonce,
-        uint8_t *msg,
-        uint8_t *aad,
-        uint8_t *out_msg);
+        const uint8_t *key,
+        const uint8_t *nonce,
+        const uint8_t *msg,
+        const uint8_t *aad,
+        uint8_t *out_msg,
+        gap_hci_cmd_complete_cb_t cb,
+        void *user_data);
 
 //HCI func interface
 

bundles/exp/inc/ll_api.h

@@ -781,6 +781,21 @@ void ll_dhkey_generated(int status, const uint8_t *dh_key);
  */
 void ll_install_ecc_engine(f_start_generate_p256_key_pair start_generate_p256_key_pair,
                           f_start_generate_dhkey start_generate_dhkey);
+
+/**
+ ****************************************************************************************
+ * @brief Low level AES encryption in blocking mode
+ *
+ * @param[in]  key                      key (little-endian)
+ * @param[in]  plaintext                plaintext (little-endian)
+ * @param[out] ciphertext               ciphertext (big-endian)
+ * @return                              0 if completed successfully; non-0 if hardware is not ready or busy
+ *                                      When non-0 is returned, it is possible to retry later.
+ ****************************************************************************************
+ */
+int ll_aes_encrypt(const uint8_t *key, const uint8_t *plaintext,
+                  uint8_t *ciphertext);
+
 #ifdef __cplusplus
 }
 #endif