MAC: Implemented CCA threshold and TX power setting

Author: Jarkko Paso

nanostack/mlme.h

@@ -264,6 +264,8 @@ typedef enum {
     macAutoRequestKeyIndex = 0x7b,  /*<The index of the key used for automatic data*/
     macDefaultKeySource = 0x7c,      /*<Default key source*/
     //NON standard extension
+    macTXPower = 0xf8,              /*<TX output power*/
+    macCCAThreshold = 0xf9,         /*<CCA threshold*/
     macMultiCSMAParameters = 0xfa,  /*<Multi CSMA parameters*/
     macRfConfiguration = 0xfb,      /*<RF channel configuration parameters*/
     macAcceptByPassUnknowDevice = 0xfc,  /*< Accept data trough MAC if packet is data can be authenticated by group key nad MIC. Security enforsment point must be handled carefully these packets */

nanostack/net_interface.h

@@ -1060,6 +1060,34 @@ extern void net_get_version_information(uint8_t *ptr);
 
 extern int arm_nwk_sleepy_device_parent_buffer_size_set(int8_t interface_id, uint16_t big_packet_threshold, uint16_t small_packets_per_child_count, uint16_t big_packets_total_count);
 
+/**
+ * \brief Set CCA threshold.
+ *
+ * This function can be used to set CCA threshold to PHY layer. Threshold is given as percentage of maximum threshold.
+ * 0 is the lowest(strictest) possible threshold and 100 is the highest possible threshold.
+ *
+ * Note! Software MAC must be created and registered before using this function.
+ *
+ * \param interface_id Network interface ID.
+ * \param cca_threshold CCA threshold (%).
+ * \return 0 on success, <0 on errors.
+ */
+extern int8_t arm_nwk_set_cca_threshold(int8_t interface_id, uint8_t cca_threshold);
+
+/**
+ * \brief Set TX output power.
+ *
+ * This function can be used to set TX output power to PHY layer. TX power is given as percentage of maximum output power.
+ * 0 is the lowest possible TX power and 100 is the highest possible TX power.
+ *
+ * Note! Software MAC must be created and registered before using this function.
+ *
+ * \param interface_id Network interface ID.
+ * \param tx_power TX output power (%).
+ * \return 0 on success, <0 on errors.
+ */
+extern int8_t arm_nwk_set_tx_output_power(int8_t interface_id, uint8_t tx_power);
+
 
 #ifdef __cplusplus
 }

nanostack/platform/arm_hal_phy.h

@@ -77,7 +77,9 @@ typedef enum {
     PHY_EXTENSION_SET_CSMA_PARAMETERS, /**< CSMA parameter's are given by phy_csma_params_t structure remember type cast uint8_t pointer to structure type*/
     PHY_EXTENSION_GET_SYMBOLS_PER_SECOND, /**<  Read Symbols per seconds which will help to convert symbol time to real time  */
     PHY_EXTENSION_SET_RF_CONFIGURATION,  /**<  Set RF configuration using phy_rf_channel_parameters_s structure */
-    PHY_EXTENSION_FILTERING_SUPPORT /**<  Return filtering modes that can be supported by the PHY driver. See phy_link_filters_e */
+    PHY_EXTENSION_FILTERING_SUPPORT, /**<  Return filtering modes that can be supported by the PHY driver. See phy_link_filters_e */
+    PHY_EXTENSION_SET_TX_POWER, /**<  Set TX output power which is given as percentage of maximum. 0 is the lowest possible TX power and 100 is the highest possible TX power */
+    PHY_EXTENSION_SET_CCA_THRESHOLD /**<  Set CCA threshold which is given as percentage of maximum threshold. 0 is the lowest(strictest) possible threshold and 100 is the highest possible threshold */
 } phy_extension_type_e;
 
 /** Address types */

source/MAC/IEEE802_15_4/mac_mlme.c

@@ -738,7 +738,7 @@ int8_t mac_mlme_set_req(protocol_interface_rf_mac_setup_s *rf_mac_setup, const m
     if (!set_req || !rf_mac_setup || !rf_mac_setup->dev_driver || !rf_mac_setup->dev_driver->phy_driver) {
         return -1;
     }
-
+    uint8_t *pu8 = NULL;
     switch (set_req->attr) {
         case macAckWaitDuration:
             return mac_mlme_set_ack_wait_duration(rf_mac_setup, set_req);
@@ -758,6 +758,16 @@ int8_t mac_mlme_set_req(protocol_interface_rf_mac_setup_s *rf_mac_setup, const m
                 memcpy(rf_mac_setup->coord_long_address, set_req->value_pointer, 8);
             }
             return 0;
+        case macTXPower:
+            pu8 = (uint8_t *) set_req->value_pointer;
+            rf_mac_setup->dev_driver->phy_driver->extension(PHY_EXTENSION_SET_TX_POWER, pu8);
+            tr_debug("Set TX output power to %u%%", *pu8);
+            return 0;
+        case macCCAThreshold:
+            pu8 = (uint8_t *) set_req->value_pointer;
+            rf_mac_setup->dev_driver->phy_driver->extension(PHY_EXTENSION_SET_CCA_THRESHOLD, pu8);
+            tr_debug("Set CCA threshold to %u%%", *pu8);
+            return 0;
         case macMultiCSMAParameters:
             return mac_mlme_set_multi_csma_parameters(rf_mac_setup, set_req);
         case macRfConfiguration:

source/libNET/src/ns_net.c

@@ -1481,3 +1481,34 @@ int arm_nwk_sleepy_device_parent_buffer_size_set(int8_t interface_id, uint16_t b
     return -1;
 }
 
+int8_t arm_nwk_set_cca_threshold(int8_t interface_id, uint8_t cca_threshold)
+{
+    protocol_interface_info_entry_t *cur;
+    cur = protocol_stack_interface_info_get_by_id(interface_id);
+    if (!cur || !cur->mac_api || (cca_threshold > 100)) {
+        return -1;
+    }
+    mlme_set_t set_req;
+    set_req.attr = macCCAThreshold;
+    set_req.attr_index = 0;
+    set_req.value_pointer = &cca_threshold;
+    set_req.value_size = sizeof(cca_threshold);
+    cur->mac_api->mlme_req(cur->mac_api, MLME_SET, &set_req);
+    return 0;
+}
+
+int8_t arm_nwk_set_tx_output_power(int8_t interface_id, uint8_t tx_power)
+{
+    protocol_interface_info_entry_t *cur;
+    cur = protocol_stack_interface_info_get_by_id(interface_id);
+    if (!cur || !cur->mac_api || (tx_power > 100)) {
+        return -1;
+    }
+    mlme_set_t set_req;
+    set_req.attr = macTXPower;
+    set_req.attr_index = 0;
+    set_req.value_pointer = &tx_power;
+    set_req.value_size = sizeof(tx_power);
+    cur->mac_api->mlme_req(cur->mac_api, MLME_SET, &set_req);
+    return 0;
+}